NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #4542 most downloaded on npm
Convert OpenAPI 3.0 & 3.1 schemas to TypeScript
Last release 7 months ago
11 Feb 2026
Release timing varies
gaps range from 2 weeks to 4 months
Most releases are documented
notes for 53 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
156 releases · first in 2020
One column per quarter.
### Patch Changes - #1324 `0357325` Thanks @drwpow! - Fix accidental quote appearing in components/responses with $refs
### Patch Changes - #1320 `3cf78b9` Thanks @duncanbeevers! - Wrap nested readonly types in parentheses, allowing for nested immutable arrays
3cf78b9 Thanks @duncanbeevers! - Wrap nested readonly types in parentheses, allowing for nested immutable arrays### Patch Changes - #1308 `ebb73b6` Thanks @drwpow! - Fix bugs with remote $refs, add cwd option for JSON schema parsing
### Minor Changes - #1295 `99a1648` Thanks @pvanagtmaal! - Avoid adding a undefined union to additionProperties
99a1648 Thanks @pvanagtmaal! - Avoid adding a undefined union to additionProperties### Patch Changes - #1280 `50441d0` Thanks @pvanagtmaal! - Fix invalid typescript for empty request bodies, fix headers being left out when response b
#1280 50441d0 Thanks @pvanagtmaal! - Fix invalid typescript for empty request bodies, fix headers being left out when response body is omitted
#1289 7f452fa Thanks @adamschoenemann! - Fixed a bug where references to types with discriminators with implicit mappings would generate incorrect types
### Patch Changes - #1281 `ebd31ff` Thanks @pvanagtmaal! - Refactor CLI path handling, fixing several bugs
ebd31ff Thanks @pvanagtmaal! - Refactor CLI path handling, fixing several bugs### Patch Changes - #1287 `8a9d8ed` Thanks @drwpow! - Fix oneOf handling with empty object parent type
### Patch Changes - #1278 `d7420e3` Thanks @pvanagtmaal! - Fix externalizing external refs
d7420e3 Thanks @pvanagtmaal! - Fix externalizing external refs### Patch Changes - #1269 `e735ff2` Thanks @pimveldhuisen! - Stop trimming whitespace other than linebreaks in string values
e735ff2 Thanks @pimveldhuisen! - Stop trimming whitespace other than linebreaks in string values### Minor Changes - #1263 `1bf2d4d` Thanks @drwpow! - Ship CJS bundle
### Patch Changes - #1248 `c145f5f` Thanks @drwpow! - Fix Record appearing in union - #1248 `c145f5f` Thanks @drwpow! - Improve oneOf generated types
### Patch Changes - #1246 `17a375e` Thanks @drwpow! - Fix remote path item object $refs
### Patch Changes - #1236 `95a4c8c` Thanks @drwpow! - Improve oneOf and enum handling
### Patch Changes - #1231 `e1ce2d6` Thanks @tkrotoff! - Do not append trailing spaces to JSDoc tags - #1232 `31c030d` Thanks @tkrotoff! - Remove unnec
### Patch Changes - #1228 `3107f1e` Thanks @m-ronchi! - Fix boolean JSON Schemas
### Patch Changes - #1221 `4e96e9d` Thanks @drwpow! - Remove OneOf<> helper for simple type comparisons - #1221 `4e96e9d` Thanks @drwpow! - Fix 3.1 nu
### Patch Changes - #1200 `4fc8c20` Thanks @toomuchdesign! - Remove unexpected empty string in generated nullable polymophic enum types (["string", "n
4fc8c20 Thanks @toomuchdesign! - Remove unexpected empty string in generated nullable polymophic enum types (["string", "null"])### Patch Changes - #1212 `e173ccf` Thanks @drwpow! - Fix bug with remote schema $refs
### Patch Changes - #1207 `914e049` Thanks @drwpow! - Fall back to TypeScript unions for long oneOf lists
### Minor Changes - #1205 `c753f7b` Thanks @drwpow! - Add prefixItems support ### Patch Changes - #1203 `902fde1` Thanks @drwpow! - Fix mutating $refs
### Patch Changes - #1193 `64decb7` Thanks @psychedelicious! - Add example for Blob type transforms
64decb7 Thanks @psychedelicious! - Add example for Blob type transforms### Patch Changes - #1166 `db37f3c` Thanks @pvanagtmaal! - Fix property escaping for discriminators
db37f3c Thanks @pvanagtmaal! - Fix property escaping for discriminators### Patch Changes - #1149 `b82cffb` Thanks @duncanbeevers! - Stringify const values with no specified type - #1156 `ad017a9` Thanks @horaklukas! - Avo
#1149 b82cffb Thanks @duncanbeevers! - Stringify const values with no specified type
#1156 ad017a9 Thanks @horaklukas! - Avoid index signature TS error for paths with empty params
### Patch Changes - #1146 `12aa721` Thanks @drwpow! - Fix js-yaml $refs
7d09c3b: Support nested path parameters in --path-params-as-types (#1130). Thanks, barakalon!
--path-params-as-types (#1130). Thanks, barakalon!Fix remote $refs to complete schemas
$refs to complete schemas (#1087)Fix tuples type generation by @liangskyli
If no type is specified, type as unknown by @mitchell-merry
unknown by @mitchell-merry (#1049)Fix oneOf number const (#1056) by @qnp
$ref’d parameters missing (#1061)oneOf number const (#1056) by @qnpNew --empty-objects-unknown flag for better control over unspecified object types’ default shape by @duncanbeevers
--empty-objects-unknown flag for better control over unspecified object types’ default shape by @duncanbeevers (#1032)Fix response key for HTTP ranges (#1010) @stefanmaric
Adds webhook typings by @yacinehmito
webhook typings by @yacinehmito (#1001)fetch() instead of request() which can be overridden locally by @yacinehmito (#1002)### Patch changes - Fixed nullable: true (#983) - Fixed additionalProperties bug
nullable: true (#983)additionalProperties bug (#983)Fixes #975 where #/components/examples were being parsed as schema objects
#/components/examples were being parsed as schema objectsRemove postinstall hook only meant for dev
postinstall hook only meant for devNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
New --content-never flag forces never response body by @duncanbeevers
--content-never flag forces never response body by @duncanbeevers (#905)@default by @duncanbeevers (#906)--prettier-config path by @duncanbeevers (#909)@default by @duncanbeevers (#910)enum export of operation paths by @duncanbeevers (#912)New --make-paths-enum CLI flag by @berzi
--make-paths-enum CLI flag by @berzi (#883)--path-params-as-types CLI flag by @Powell-v2 (#891)/** @constant */ JSDoc comments by @PhilipTrauner (#896)The --export-type flag was added to generate type instead of interface by @dominikdosoudil
--export-type flag was added to generate type instead of interface by @dominikdosoudil (#868)Patches security vulnerability with node-fetch (by replacing with undici)
openapi-typescript@4). Version 5 switched to ESM as default anyway, and since tests are now testing ESM, the reliability of CJS was dubious (and there were TypeScript problems as well)Adds constants support by @sadfsdfdsa
oneOf by @sadfsdfdsa (#830)Adds missing types for CJS build
5.x drops support for Node 12. If you’re still on Node 12, be sure to lock your version to 4.x.
URL() as input to make ESM usage easier (see example)Significantly-enhanced JSDoc output by @sadfsdfdsa
Adds TypeScript @deprecated comment to deprecated schema objects by @bunkscene
@deprecated comment to deprecated schema objects by @bunksceneIn many areas, changed out any with unknown (#769). See #554 for more explanation / context
any with unknown (#769). See #554 for more explanation / context{ [key: string]: unknown } for a type when it may have been a string or number. Now it will generate a more generic unknown type, unless it knows it’s dealing with an object for sure.Reference arbitrary data on generated types via the properties key by @Peteck
properties key by @Peteck (#626)Fixes the remote schema URL cache being too long-lived by @mbelsky
New --headersObject and --headers CLI flags by @ericzorn93
--headersObject and --headers CLI flags by @ericzorn93 (#764)"type": "file" no longer generates unexpected results (#766)Loading in-memory schemas through the JS API resulted in broken $refs
$refs (#689)Fixes properties + anyOf with only required properties by @gr2m
properties + anyOf with only required properties by @gr2m (#643)Other than that, there are no other breaking changes. CLI users are unaffected, and the types generated are backwards-compatible with previous version…
$ref: "remote.yaml#/components/schemas/User) 🎉 (#602)!Nothing published for this version
Fix glob accidentally generating empty folders alongside single-file schemas
Adds glob support thanks to @sharmarajdaksh
--default-non-nullable flag (#631)Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →