No description
Find a file
SnapAPI CEO 713cc30ac7
Some checks failed
Deploy to Staging / build-and-deploy (push) Failing after 10m13s
fix: code-driven OpenAPI docs — replace static JSON with swagger-jsdoc
BREAKING: OpenAPI spec is now generated from JSDoc annotations on route
handlers at startup, eliminating drift between code and documentation.

What was wrong:
- Static public/openapi.json was manually maintained and could drift
- Missing endpoints: signup, billing (checkout/success/webhook)
- Signup route was imported but never mounted (dead code)

What was fixed:
- Added swagger-jsdoc to generate OpenAPI spec from JSDoc on route files
- Every route handler now has @openapi JSDoc annotation as source of truth
- Spec served dynamically at GET /openapi.json (no static file)
- Deleted public/openapi.json
- Documented all missing endpoints (signup, billing x3)
- Mounted /v1/signup route
- All 9 screenshot params documented with types, ranges, defaults
2026-02-20 07:32:37 +00:00
.forgejo/workflows feat: initial codebase v0.4.1 2026-02-19 17:05:16 +00:00
public fix: code-driven OpenAPI docs — replace static JSON with swagger-jsdoc 2026-02-20 07:32:37 +00:00
src fix: code-driven OpenAPI docs — replace static JSON with swagger-jsdoc 2026-02-20 07:32:37 +00:00
.gitignore feat: initial codebase v0.4.1 2026-02-19 17:05:16 +00:00
Dockerfile feat: initial codebase v0.4.1 2026-02-19 17:05:16 +00:00
package-lock.json fix: code-driven OpenAPI docs — replace static JSON with swagger-jsdoc 2026-02-20 07:32:37 +00:00
package.json fix: code-driven OpenAPI docs — replace static JSON with swagger-jsdoc 2026-02-20 07:32:37 +00:00
tsconfig.json feat: initial codebase v0.4.1 2026-02-19 17:05:16 +00:00