Esquema OpenAPI

openUBL expone una especificación OpenAPI 3.1.0 generada automáticamente por FastAPI. El archivo openapi.json en la raíz es la fuente única de verdad para el SDK TypeScript.

Exportar el esquema

uv run python scripts/export_openapi.py

Generar el SDK TypeScript

cd sdk/typescript
npm install
npm run generate
npm run build

El comando npm run generate ejecuta @hey-api/openapi-ts sobre openapi.json y produce los tipos, el cliente fetch y los schemas Zod en src/.

Mantener la documentación alineada

Después de regenerar el esquema, ejecuta:

npm run generate:docs

Esto actualiza docs/src/content/docs/api/referencia.mdx y docs/src/content/docs/sdk/typescript.mdx desde openapi.json y sdk/typescript/README.md.