Resolves JSON Schema `$ref` references by inlining external schemas you provide, returning a single combined schema that no longer depends on external schema files. Useful for turning referenced schemas into a self-contained schema, and it will not error if a reference is missing.
Project status
- Maintenance/active status: The most recently published updates in the provided history are v3.0.0 (2025-01-18), but GitHub also shows an upstream push on 2026-08-01, so there appears to be continued activity even though no newer published update is reflected in the supplied release summaries.
- Update cadence: Compared to today (2026-08-13), there is a long gap since the last documented published update (about 19 months), with earlier history showing multi-year gaps between major updates.
AI summary generated
Recent updates
v3.0.0
v3.0.0 replaces the URI parsing/serialization dependency used by the resolver (uri-js) with fast-uri, and updates CI and development tooling. The release notes mention dropping uri-js and adding tests, but the diff also shows a Node.js engine requirement bump and some behavioral changes in how internal metadata is attached to schema objects.
Breakingv2.0.0
The release notes only mention a single PR described as a major change to bump the Node.js CI configuration. The code diff, however, shows additional changes to the npm test script, development dependency versions, and multiple GitHub workflow settings beyond what is documented.
v1.3.0
v1.3.0 adds the ability to override how the resolver generates local definition keys for inlined `$ref` targets. The code introduces a new `buildLocalReference` option and wires it into the `$ref` resolution flow so callers can change the generated `#/definitions/<key>` mapping.
Featuresv1.2.2
Release v1.2.2 bumps the package version and adds the missing npm dependency `debug`. The release notes only mention this fix, and the code diff is consistent with that change.
v1.2.1
v1.2.1 bumps the json-schema-resolver package version and includes changes aimed at reducing published package size via a new .npmignore file. It also adjusts $ref resolution behavior to properly handle absolute URI references, with added test coverage for absolute $ref cases.
v1.2.0
The v1.2.0 release notes only mention "exit from beta". The actual code diff shows a single change in package.json: the package version was updated from 1.1.1-0 to 1.2.0.
v1.1.1-0
Release v1.1.1-0 updates json-schema-resolver to preserve the fragment portion of $ref values when resolving external schemas into internal definitions. The release notes mention only this change, and the code diff shows the implementation and a new test that validates it.
v1.1.0-0
Release v1.1.0-0 introduces support for sharing a single generated definitions namespace across multiple root schema resolutions. It adds resolver-level configuration for external schemas and a new way to retrieve the shared definitions after resolving one or more root schemas.
Featuresv1.0.1-0
This release focuses on resolving an issue when the root JSON schema is missing a $id value. The code change prevents failures during URI parsing and adjusts how the resolver computes the base URI for resolving relative $refs.
v1.0.0-0
This release is the very first commit and first implemented version of the project (v1.0.0-0). The release notes do not document any specific APIs, configuration changes, bug fixes, or breaking changes beyond stating that an initial implementation was added.
Features