NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
modern OpenAPI parser written in TypeScript
Last release 2 days ago
12 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Most releases are documented
notes for 37 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
141 releases · first in 2024
### Patch Changes #### Updated Dependencies - @scalar/openapi-upgrader@0.1.7 - #7739: fix: upgrade form to multipart/form - #7694: feat: migrate x-exa
### Patch Changes - #7719: fix: self-referencing causes infinite loop in dereference
dereferenceOne column per month.
### Patch Changes #### Updated Dependencies - @scalar/json-magic@0.8.10 - @scalar/openapi-upgrader@0.1.6
@scalar/json-magic@0.8.10
@scalar/openapi-upgrader@0.1.6
### Patch Changes #### Updated Dependencies - @scalar/json-magic@0.8.9 - @scalar/openapi-upgrader@0.1.6
@scalar/json-magic@0.8.9
@scalar/openapi-upgrader@0.1.6
### Patch Changes - #7581: fix: npm publish job #### Updated Dependencies - @scalar/json-magic@0.8.8 - #7581: fix: npm publish job - @scalar/openapi-u
### Patch Changes - Updated dependencies []: - @scalar/json-magic@0.8.6
Updated dependencies [`72cd82f`, `72cd82f`]:
#7506 72cd82f Thanks @marcalexiei! - fix: use caret version for yaml
Updated dependencies [72cd82f, 72cd82f]:
### Patch Changes - Updated dependencies []: - @scalar/json-magic@0.8.4
Updated dependencies [`e04879c`, `a164d76`, `bfd814a`, `af54a80`]:
Updated dependencies [`d86f1d6`]:
d86f1d6]:
### Patch Changes - Updated dependencies []: - @scalar/json-magic@0.8.1
Updated dependencies [`c1ecd0c`, `fddf294`]:
#7235 c1ecd0c Thanks @marcalexiei! - fix(openapi-parser): use node:path instead of polyfill
#7241 2377b76 Thanks @hanspagel! - chore: use "current" not "latest" scalar registry url
Updated dependencies [c1ecd0c, fddf294]:
Updated dependencies [`11a6e64`, `2239843`, `134ff5f`, `6ca835e`, `43bc5e8`]:
#7121 9661e81 Thanks @marcalexiei! - feat(oas-utils): make dereference synchronous
#7092 134ff5f Thanks @baywet! - feat - parser - adds support for OpenAPI 3.2.0
#7116 2239843 Thanks @baywet! - docs adds a mention that OpenAPI 3.2.0 is now supported
#7092 134ff5f Thanks @baywet! - feat: update OpenAPI 3.0 and 3.1 JSON schemas for validation
#7182 c84b7c5 Thanks @baywet! - [fix] adds missing dereference options export in parser
#7094 eba18d0 Thanks @geoffgscott! - Migrate to workspace store as primary source of truth.
#7196 a821986 Thanks @marcalexiei! - fix(openapi-parser): remove internal unneeded async logic without changing the public API
#7149 e23229d Thanks @baywet! - [docs] updates readme to bundle method and adds migration from load guidance
Updated dependencies [11a6e64, 2239843, 134ff5f, 6ca835e, 43bc5e8]:
### Patch Changes - Updated dependencies [2089748] - Updated dependencies [8a7fb2a] - Updated dependencies [f69e7cc] - @scalar/json-magic@0.6.1 - @sca
### Patch Changes - Updated dependencies [15c4240] - @scalar/openapi-types@0.4.1 - @scalar/openapi-upgrader@0.1.2
### Patch Changes - Updated dependencies [008a0f3] - @scalar/openapi-types@0.4.0 - @scalar/openapi-upgrader@0.1.1
### Patch Changes - Updated dependencies [6462733] - @scalar/json-magic@0.5.2
e1cdd00: fix: update import statement within deprecation message
a1f865c: refactor: move upgrade() to @scalar/openapi-upgrader
### Patch Changes - @scalar/json-magic@0.4.3
39bbc0e: fix: correctly reflect the changes to parameters on the refs
### Patch Changes - @scalar/json-magic@0.4.1
b8c4b61: fix: migrate global and path item parameters from Swagger 2.0 to OpenAPI 3.0
### Patch Changes - Updated dependencies [06a46f0] - Updated dependencies [63283aa] - Updated dependencies [99894bc] - @scalar/json-magic@0.4.0
### Patch Changes - Updated dependencies [88385b1] - @scalar/json-magic@0.3.1
c418e92: feat(openapi-parser): join multiple openapi documents
952bde2: feat(json-magic): move json tooling to the new package
c345d2c: fix: added dependency on @scalar/openapi-types
1c2b9f3: feat: add application and accessCode to swagger 2 upgrader
2d7f995: refactor: use more common straight apostrophe ' instead of the real apostrophe ’
291f09d: feat(openapi-parser): ensure unique hashes and support custom compression
f823d45: feat(openapi-parser): introduce parseJson and parseYaml plugins for bundler
11fabae: fix(openapi-parser): webpack bundle errors because of the barrel files
b9dacba: fix(openapi-parser): multi entry build for bundler plugins
ee3eb77: feat(openapi-parser): bundle openapi documents
1e87feb: fix: normalize doesn’t handle empty documents well
edf694b: feat: remove wildcard exports
ea20eb4: fix: swagger upgrade fails if you pass something that is not an object
bd602d3: chore: mark pipeline syntax as deprecated
8c7bad8: chore: move build tooling to esbuild
c5047ee: fix: hotfix to revert the external reference commit
4abe4f8: feat: add resolveInternalRefs to bundle documents
cf5bf65: fix: migrate file type, basic auth, parameters and responses headers correctly
d5a687f: fix: byte format is ignored when upgrading from OpenAPI 3.0 to OpenAPI 3.1
cbc1d08: fix: swagger 2.0 basePath is ignored, if there’s no host
0f13162: chore: enable more Biome flags, apply linter fixes
0d8a24f: chore: remove Swagger 2.0 upgrade warning
### Patch Changes - c10bbf5: chore: code style
### Patch Changes - e350f23: chore: code style
### Patch Changes - 1223c1f: chore: code style
4de3124: feat: make 'null' the second type in an array when upgrading
a30e7cc: fix: package doesn’t work with moduleResolution: NodeNext
moduleResolution: NodeNext64df4fc: fix: example arrays are transformed to objects
8dce84f: Call onDereference after dereference process
onDereference after dereference process3791738: fix(openapi-parser): correct schema upgrade for "format: binary"
c263aaf: feat: better deal with empty OpenAPI documents
fbef0c3: fix(openapi-parser): improve performance
6fef2f3: feat(openapi-parser): support onDereference option on dereference
onDereference option on dereference98e9cb2: feat: new sanitize utility to make documents OpenAPI-compliant
sanitize utility to make documents OpenAPI-compliant757fade: fix: when migrating example to example objects, the example should be inside the value attribute
Your coding agent can read these notes before it upgrades. Set up the MCP server →