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
- The repository appears to have ongoing activity (GitHub shows a recent upstream push on 2026-08-01), but the most recent tagged update in the provided history is v3.0.0 from 2025-01-18, so there is a long gap since the last published updates.
- Update cadence looks slow relative to today (more than 1.5 years between v3.0.0 and the previous tagged updates, with earlier releases also spaced years apart), suggesting maintenance with infrequent releases rather than rapid iteration.
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