JSON Ref Resolver (deprecated) resolves `$ref` values by following JSON pointers and (optionally) remote URIs for JSON Schema and OpenAPI, returning a new object with references dereferenced. Useful for dereferencing inline references by default, and for resolving remote refs when you provide URI-specific readers or resolvers (for example, HTTP or file).
Project status
- Marked as deprecated and the upstream is archived, so it appears not to be actively developed going forward.
- updates are sporadic, with the most recent upstream push in 2023-07-13 and earlier updates in 2022 (about a year or more between update points), indicating a long period without change as of 2026-08-12.
AI summary generated
Recent updates
v3.1.6
Release v3.1.6 is presented as a dependency-only update, specifically bumping @stoplight/json. The actual diff also includes substantial development tooling and CI configuration changes, plus test snapshot adjustments and a TypeScript typing tweak in a benchmark test.
v3.1.5
Release v3.1.5 is a small bug fix release focused on resolving direct circular file $refs without producing errors. The change is validated by adding a dedicated circular reference fixture and a new resolver test.
v3.1.4
Release v3.1.4 is presented as a set of bug fixes focused on dependency updates, including a security-motivated bump of urijs, and a change related to how leading whitespace is handled. It also adjusts lodash usage by switching to lodash-based helpers.
Securityv3.1.3
Release v3.1.3 contains only dependency upgrades, with no application source code changes shown in the provided diff. The release notes are limited to a single bullet stating that dependencies were upgraded.
v3.1.2
Release v3.1.2 contains a fix intended to stop the resolver from skipping empty $ref values. The code changes implement this by changing how falsy $ref values are detected, and by adding special-case URI handling for empty strings.
v3.1.1
Release v3.1.1 is presented as a dependency-only bug fix release. The release notes only mention bumping production dependencies, but the code diff shows at least one behavioral change in the resolver logic in addition to dependency/import adjustments.
Breakingv3.1.0
v3.1.0 adds a new purge capability to the resolver cache. The release notes only mention that the ICache interface now exposes a purge() function.
Featuresv3.0.9
v3.0.9 is primarily described as a bug fix related to the `urijs` type. The code changes, however, show broader TypeScript type refactors (switching from the `uri` namespace type to an explicit `URI` import) plus dependency upgrades that could indirectly affect resolution behavior.
v3.0.8
v3.0.8 release notes only mention a README typo fix. The actual diff shows no library/runtime source changes, but it does include documentation example text edits plus several development toolchain and lockfile dependency updates (TypeScript, TSLint configs, and other transitive packages).
v3.0.7
Release v3.0.7 contains a small performance-related change to uriToJSONPointer. The main behavioral change is in how JSON pointers are produced from URIs when there is no fragment.