astahmer/openapi-zod-client
Openapi Zod Client
This project is a command-line tool that automates the creation of type-safe TypeScript HTTP clients directly from OpenAPI specifications. By transforming service definitions into structured source code, it ensures end-to-end type synchronization and enforces runtime data integrity across network boundaries.
The generator distinguishes itself by mapping OpenAPI data structures into Zod validation schemas, allowing for consistent schema-driven type mapping and response validation. It supports deduplicated source synthesis to minimize redundancy in the generated output and provides template customization options, enabling users to modify the structure and formatting of the resulting code through defined rendering rules.
The tool handles the entire lifecycle of client creation, from parsing heterogeneous API specifications into a unified internal model to rendering executable request handlers. It is designed to integrate into development workflows by producing ready-to-use modules that maintain strict data contracts between services.
Features
- OpenAPI Client SDK Generators - Automates the creation of type-safe TypeScript HTTP clients directly from OpenAPI specifications.
- End-to-End - Synchronizes API contracts with frontend code to prevent runtime errors by enforcing strict data types across the communication stack.
- Type-Safe Client Generators - Generates type-safe TypeScript HTTP clients from OpenAPI specifications to ensure consistent data structures across network boundaries.
- Schema Generators from OpenAPI - Generates Zod validation schemas for request parameters, bodies, and responses from OpenAPI specifications.
- Zod Schema Type Inferences - Translates OpenAPI data structures into Zod validation schemas to enforce runtime data integrity.
- API Code Generators - Provides a command-line interface that automates the creation of structured network request handlers and response validation logic.
- API-Driven Development Workflows - Streamlines backend service integration by automating the transformation of specifications into ready-to-use source code.
- Compile-Time Code Generation - Transforms static API specification files into executable TypeScript source code during the build process.
- Zod Response Validators - Validates API response bodies against generated Zod schemas at runtime to catch data shape mismatches.
- OpenAPI to TypeScript Converters - Transforms OpenAPI specifications into type-safe HTTP clients and Zod validation schemas for consistent network communication.
