Add distribution API integration tests and consistent error responses

[pragmaticAweds]

Context

Campaign and donation code now have focused service and validation tests, but the distribution API still has controller/service behavior that returns raw 500 responses for several expected cases and has no matching regression coverage in src/__tests__. The distribution endpoints should have predictable validation, not-found, and database-not-ready responses before more clients depend on them.

Scope

• Add tests for POST /v1/distributions, PATCH /v1/distributions/:id, and GET /v1/distributions
• Cover validation failures from policyMiddleware
• Cover not-found updates with a 404 response
• Cover database-not-initialized behavior with a stable error payload
• Align distribution controller responses with shared API response helpers where practical
• Replace broad console.error handling with project logger or shared error handling conventions

Out of Scope

• Changing the distribution entity schema
• Adding authentication requirements unless a separate product decision exists
• Implementing indexer distribution persistence

Acceptance Criteria

• Distribution endpoint tests cover success and expected failure paths
• Expected client errors do not return generic 500 responses
• Response payload shape is consistent with existing API conventions
• Tests run under bun run test with coverage thresholds intact
• bun run type-check passes
• bun run test passes
• bun run lint passes

Dependencies

• Existing distribution endpoints from Implement POST /distributions Endpoint for Creating a Distribution #2 and Implement PATCH /distributions/:id Endpoint for Updating a Distribution #3

Suggested Files or Packages

• src/components/v1/distribution/
• src/__tests__/
• src/utils/apiResponse.ts
• src/utils/errorHandler.ts

[attyolu]

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

Good evening Maintainer. I would love to work on this issue quickly. Please assign to me. Thank you

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

[jethrojohn739-max]

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

I will love to work on this issue,pls 🙏 give me

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

[Abba073]

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

I would like to work on this.

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

[D-Lord-15]

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

Hello maintainer, i would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @D-Lord-15 to this issue.

[vickydve]

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

Hi i'd like to work on this

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

[intelliDean]

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

I'd like to work on this issue

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

[Caneryy]

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

Hi, may I work on this issue please?

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

[drips-wave]

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

🧑‍💻 @vickydve: 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 🌊

[drips-wave]

This issue has been completed by @vickydve as part of the Stellar Wave Program's 6th Wave 🥳

😎 @vickydve: You earned 400 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.