Add donation API integration tests and stable error mapping

[pragmaticAweds]

Context

Donation service and validation tests exist, but the route/controller layer has several public endpoints with authentication, admin checks, query validation, and not-found behavior. Controller errors currently collapse most failures into INTERNAL_ERROR, including database-not-ready paths, so clients do not have a fully tested response contract.

Scope

• Add route/controller tests for donation creation, list, detail, campaign donations, user donations, my donations, and stats
• Cover auth-required and admin-required responses
• Cover validation failures from policyMiddleware
• Cover donation not found with a 404 response
• Map database-not-initialized errors to a stable API error code
• Ensure response payloads use shared API response helpers consistently

Out of Scope

• Changing donation schema fields
• Adding new donation endpoints
• External payment or chain confirmation logic

Acceptance Criteria

• Donation API tests cover success and expected failure paths
• Expected client/auth errors do not return generic 500 responses
• Database-not-ready behavior has a stable error code and test
• bun run type-check passes
• bun run test passes
• bun run lint passes

Suggested Files or Packages

• src/components/v1/Donation/
• src/__tests__/
• src/utils/apiResponse.ts
• src/appMiddlewares/jwtAuth.api.ts

[OluRemiFour]

@OluRemiFour has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I've reviewed the task and have a clear implementation plan. Looking forward to contributing with a quality PR.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @OluRemiFour to this issue.

[Joyyyb]

@Joyyyb has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Joyyyb to this issue.

[Caneryy]

@Caneryy has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello, may I work on this issue?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Caneryy to this issue.

[drips-wave]

Congratulations, @Joyyyb! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @Joyyyb: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊