acacode/swagger-typescript-api
Swagger Typescript Api
swagger-typescript-api is a utility that parses OpenAPI definitions to generate strongly typed data models and service wrappers for web applications. It transforms OpenAPI specifications into type-safe TypeScript API clients, removing the need for manual request and response boilerplate.
The generator produces interchangeable client logic via pluggable transport adapters, allowing users to switch between Fetch and Axios for network requests. It uses template-based source emission to inject generated types and methods into a consistent client structure.
The project handles the mapping of OpenAPI data types and JSON schemas into TypeScript interfaces and type aliases. It provides static type inference to ensure compile-time safety for request and response payloads across the network layer.
Features
- OpenAPI Client SDK Generators - Generates type-safe TypeScript client SDKs and data models directly from OpenAPI specifications.
- OpenAPI Specification Parsers - Parses OpenAPI JSON and YAML definitions into internal representations to drive code generation.
- Schema-Driven Code Generators - Produces TypeScript source code by parsing OpenAPI specification files and mapping schemas to language constructs.
- Type-Safe Client Generators - Generates type-safe network request wrappers from API schemas to eliminate manual boilerplate.
- OpenAPI to TypeScript Converters - Transforms OpenAPI data types and JSON schemas into corresponding TypeScript interfaces and type aliases.
- Type-Safe API Integrations - Develops type-safe interfaces for external APIs in TypeScript to ensure data consistency between the server and client.
- API Client Generators - Automates the generation of ready-to-use Axios network layers derived from API schemas.
- Pluggable Transport Layers - Provides pluggable transport interfaces allowing users to switch between Fetch and Axios for network requests.
- Request - Creates hard-coded type definitions from API specs to ensure compile-time safety for request and response payloads.
- Typed Data Fetching - Adds strong TypeScript typing to native Fetch requests based on shared OpenAPI documents.
