[ENHANCEMENT] Generate TypeScript API client from OpenAPI/Swagger spec for frontend

[kilodesodiq-arch]

Engineering Gap

Swagger/OpenAPI spec available at /api/docs but not used for client generation. Frontend has hand-written API calls with duplicate endpoint strings and request patterns.

Codebase Evidence

• app/backend/src/main.ts lines 74-141: Full Swagger/OpenAPI configuration
• app/frontend/src/lib/verification-api.ts, verification-inbox-api.ts: Hand-written API clients
• Multiple files hardcode API_URL from env with duplicated fetch logic

Risk Profile

API contract drift between frontend and backend. Duplicated boilerplate.

Remediation Strategy

Generate TypeScript client from OpenAPI spec using openapi-generator or openapi-typescript. Replace hand-written API calls. Add to CI to detect drift.

Success Conditions

• API client generated from spec
• Hand-written API calls replaced
• CI detects contract drift

Change Surface

Files: app/frontend/src/lib/, CI pipeline

Security Review

Generated client should handle auth consistently.

Completion Checklist

• Implementation completed
• Peer reviewed
• Tests passing
• Ready for merge

[Lansa-18]

Hi @kilodesodiq-arch, I'd like to work on this.

I'll set up openapi-typescript (or openapi-generator if it turns out to be a better fit for this codebase) to generate a typed client from the /api/docs spec, then replace the hand-written clients like verification-api.ts and verification-inbox-api.ts with calls through the generated client. I'll make sure auth headers are handled consistently across all generated calls, then add a CI step that regenerates the client and fails the build if it drifts from the current spec.

[grantfox-oss]

🦊 GrantFox — @Lansa-18 has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #118)
2. Your PR will be reviewed by the ChainForgee maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign campaign!

@Lansa-18's PR #180 was approved and merged by @kilodesodiq-arch.

🏆 @Lansa-18: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (818 total points). Track your full progress on GrantFox.

👏 Great work, @Lansa-18! Keep contributing to ChainForgee.