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
Latest stable
7.13.0
Last release 9 months ago
11 Feb 2026
Release timing varies
gaps range from 2 weeks to 4 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
156 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
### 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 arraysYour coding agent can read these notes before it upgrades. Set up the MCP server →
### Patch Changes - #1317 `5e054db` Thanks @drwpow! - Fix JSONSchema $defs - #1317 `5e054db` Thanks @drwpow! - Improve remote $ref parsing
### 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<string, never> appearing in union - #1248 `c145f5f` Thanks @drwpow! - Improve oneOf g
### 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
🐛 Bugfixes
$refs to complete schemas (#1087)Fix tuples type generation bug, and unit test bug by @liangskyli
🐛 Bugfixes
If no type is specified, type as unknown by @mitchell-merry
🐛 Bugfixes
unknown by @mitchell-merry (#1049)unknown by @mitchell-merry (#1049)Fix oneOf number const (#1056) by @qnp
🐛 Bugfixes
$ref’d parameters missing (#1061)$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
✨ New Features
--empty-objects-unknown flag for better control over unspecified object types’ default shape by @duncanbeevers (#1032)🐛 Bugfixes
--empty-objects-unknown flag for better control over unspecified object types’ default shape by @duncanbeevers (#1032)Fix response key for HTTP ranges (#1010) @stefanmaric
🐛 Bug fixes
allOf + required properties (#1027) @SwiftworkAdds webhook typings by @yacinehmito
✨ New Features
fetch() instead of request() which can be overridden locally by @yacinehmito (https://github.com/drwpow/openapi-typescript/pull/1002)🐛 Bug fixes
webhook typings by @yacinehmito (#1001)fetch() instead of request() which can be overridden locally by @yacinehmito (#1002)🐛 Bugfixes - Fixes #979 - Fixes #981
🐛 Bugfixes
nullable: true (#983)additionalProperties bug (#983)Fixes #975 where #/components/examples were being parsed as schema objects
🐛 Bugfixes
#/components/examples were being parsed as schema objects#/components/examples were being parsed as schema objectsRemove postinstall hook only meant for dev
🐛 Bugfixes
postinstall hook only meant for devOpenAPI 3.1 support for discriminator and polymorphic types
✨ New Features
discriminator and polymorphic typestransform() and postTransform() hooks give you more control in overriding/extending generated types--immutable-types has a new -t aliaspath.default types🚀 Improvements
oneOf / anyOf / allOf (#894)ESNext code rather than ES2018🐛 Bugfixes
$refs now work🔨 Breaking Changes
--version was changed to return the version of this library (also by dropping Swagger 2.0 support the old usage was no longer needed)--raw-schema. Your entry schema MUST be valid and complete (however, your $refs to subschemas may be partials).--make-paths-enum because it was incompatible with --path-params-as-types-it and -ap (specify the full --immutable-types or --additional-properties flag){} now returns never. Dropped the --content-never flag as this is now the default behavior.formatter() function to transform() and postTransform(). It’s an overall improvement on the original concept with even more power than before.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
✨ New features
--content-never flag forces never response body by @duncanbeevers (#905)🐛 Bugfixes
@default by @duncanbeevers (#906)--prettier-config path by @duncanbeevers (#909)@default by @duncanbeevers (#910)enum export of operation paths by @duncanbeevers (#912)--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
✨ New features
--make-paths-enum CLI flag by @berzi (#883)--path-params-as-types CLI flag by @Powell-v2 (#891)/** @constant */ JSDoc comments by @PhilipTrauner (#896)🐛 Bugfixes
--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
✨ New features
--export-type flag was added to generate type instead of interface by @dominikdosoudil (https://github.com/drwpow/openapi-typescript/pull/868)🐛 Bugfixes
🐣 Minor changes
--export-type flag was added to generate type instead of interface by @dominikdosoudil (#868)Patches security vulnerability with node-fetch (by replacing with undici)
⚠️ Changes
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)🐛 Bugfixes
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
✨ New Features
🐛 Bugfixes
oneOf by @sadfsdfdsa (#830)oneOf by @sadfsdfdsa (#830)Adds missing types for CJS build
🐛 Bugfixes
Updates this library to full ESM! ✨ This is the future of JavaScript, and is now natively supported in Node 14+.
🦍 Major changes
🐥 Minor changes
URL() as input to make ESM usage easier (see example)⚠️ Breaking changes
Significantly-enhanced JSDoc output by @sadfsdfdsa
✨ New features
Adds TypeScript @deprecated comment to deprecated schema objects by @bunkscene
✨ New Features
@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
🐣 Minor changes
any with unknown (#769). See #554 for more explanation / context🐛 Bugfixes
openapi-typescript would incorrectly generate { [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
✨ New Features
properties key by @Peteck (#626)properties key by @Peteck (#626)Fixes the remote schema URL cache being too long-lived by @mbelsky
🐛 Bugfixes
New --headersObject and --headers CLI flags by @ericzorn93
✨ New features
--headersObject and --headers CLI flags by @ericzorn93 (#764)🐛 Bugfixes
"type": "file" no longer generates unexpected results (#766)--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
🐛 Bugfixes
$refs (#689)$refs (#689)Fixes properties + anyOf with only required properties by @gr2m
🐛 Bugfixes
properties + anyOf with only required properties by @gr2m (#643)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…
✨ New Features
$ref: "remote.yaml#/components/schemas/User) 🎉 (#602)!⚠️ Breaking Changes
$ref: "remote.yaml#/components/schemas/User) 🎉 (#602)!Nothing published for this version
v3.4.0 would accidentally generate empty folders alongside single-file schemas. This fixes that (#633).
🐛 Bugfixes
v3.4.0 would accidentally generate empty folders alongside single-file schemas. This fixes that (#633).Features glob support thanks to @sharmarajdaksh
✨ New Features
🐥 Minor changes
--default-non-nullable flag (#631)--default-non-nullable flag (#631)Nothing published for this version
One column per quarter.