api-documenter

To generate OpenAPI 3.0 specifications from TypeScript, this tool analyzes your handlers.ts, validators.ts, and schema.ts files to extract endpoints, schemas, and contracts, then merges them into your openapi.yaml.

Schema extraction for Drizzle and Zod in API documentation works by deriving request and response contracts directly from validators.ts and Drizzle schema definitions to produce accurate OpenAPI schemas.

Yes, you can update existing OpenAPI docs without losing previous content, because the tool merges newly generated paths into apps/server/docs/openapi.yaml while preserving existing documentation.

Yes, you need a TypeScript runtime to analyze handlers and generate API docs, as the tool requires this environment to parse your feature modules and extract routing logic.

The best way to maintain API docs alongside Drizzle schema changes is to automate the process by analyzing updated schema.ts and validators.ts files to regenerate corresponding OpenAPI paths.