backend-type-bridger

Backend Type Bridger

When to use

• Frontend agent needs accurate API payload shapes
• Local openapi.json (or another OpenAPI file under the project root)
• Firestore rules or schema file exists for Firebase projects

Instructions

1. Ensure a local OpenAPI file at openapi.json (project root). Prefer the scaffolded file. If the API is running and the file is missing/stale, export to disk first (do not pass a URL into this skill):

   curl -fsS http://127.0.0.1:8090/openapi.json -o openapi.json
   

2. FastAPI types: python scripts/sync_openapi.py --project-root <root>: writes src/types/api.ts from local openapi.json only (optional --openapi path/rel.json).

3. Firebase: python scripts/fetch_firestore_schema.py --project-root <root>

1. Import generated types in composables: never guess field names. Refine generated interfaces if OpenAPI uses $ref heavily.