@nahkies/openapi-code-generator

@nahkies/openapi-code-generator

@nahkies/openapi-code-generator is a CLI tool that aims to generate high quality typescript client SDK's, and API server scaffolding (routing, validation, serialization) from OpenAPI 3 specifications.

Currently, OpenAPI 3.0, OpenAPI 3.1, and TypeSpec are supported an input specifications.

• Documentation
• Changelog
• Stability
• More information / contributing

Documentation

Visit https://openapi-code-generator.nahkies.co.nz/ for detailed documentation including quick start guides and reference material.

Changelog

Please see the Github releases for handwritten release notes, or CHANGELOG.md for release notes generated by lerna.

Stability

This project is still in beta, and breaking changes are still likely to be made before moving to v1. However, these are considered thoughtfully and we aim to minimise disruption.

In general what is implemented works well, but there are still parts of the OpenAPI specification that haven't been implemented, so YMMV.

More information / contributing

Refer to top level README.md / CONTRIBUTING.md

Changelog

0.18.0 (2024-12-22)

Bug Fixes

• client-sdks: handle 204 empty responses with runtime validation (#288) (d3be20e), closes #285

• intersected union schemas (#283) (2a610c5), closes #282

• typescript-fetch: runtime validation works (#287) (cead53a), closes #286

• fix(joi)!: switch from @hapi/joi to joi (#284) (6693e1d), closes #284

• fix(typescript-axios)!: remove unused exports (#281) (7b34fd4), closes #281

• feat(typescript-fetch)!: simplify response types (#280) (4340caf), closes #280

BREAKING CHANGES

• peerDependency changed to joi for users of --schema-builder joi
• unused symbols Res and StatusCode dropped from typescript-axios-runtime
• TypedFetchResponse is removed, use Res directly if needed