Building an OpenAPI from Typescript
summary
A team moves from ~40 JavaScript microservice repos into a TypeScript monorepo and builds a small framework that composes micro handlers, traces file dependencies, and starts only affected services. It uses AJV + json-schema-to-ts for validated, typed inputs, a static analyzer from TypeScript AST to extract routes/params/responses, and emits an OpenAPI spec generated per-service. CI posts GitHub comments on breaking changes, generates docs and clients (saving thousands of lines), and integrates with Vercel for incremental deploys.
AI-written summary · about
chapters (11)
- 0:00Introduction
- 1:57API Challenges
- 2:55OpenAPI Specification
- 5:32Pain Points
- 8:59Building the Ideal System
- 10:26Monorepo Adoption
- 13:38Minimalist Routing
- 17:12Tooling and Framework
- 21:40Validation and Types
- 25:03Generated Documentation
- 28:38CI/CD and Conclusion
related talks
34mGenerating Types without climbing a tree
45mType-Safe APIs - Syncing Back & Front End Types w/ Code Generation
33mTypeScript for APIs
24mReliable I/O with the TypeScript Compiler API
30mPowerful REST in a GraphQL world
29mCrafting Reliable and Testable Code with TypeScript
33mEnd-to-End Type Safety with Swagger and TypeScript
35mThe Art of Building Node.js Projects at Scale