A JavaScript library that resolves and dereferences references inside JSON Schemas, making it useful for preparing OpenAPI or Swagger-style schemas that use `$ref`. It lets you add schemas by id, list discovered references and dependencies, and produce a dereferenced schema via the `RefResolver` API.
Project status
- Actively maintained, the upstream repo was pushed on 2026-10-10 and the latest published update v3.0.1 was also dated 2026-10-10.
- Apparent update cadence is low-frequency, with the last two versioned updates spanning from v3.0.0 (2025-03-08) to v3.0.1 (2026-10-10), roughly 19 months, and earlier updates also showing multi-month to multi-year gaps.
AI summary generated
Recent updates
v3.0.1
v3.0.1 primarily updates developer tooling and CI workflows, including workflow permission hardening and additional automation workflows. It also migrates the TypeScript type-testing setup from tsd to tstyche and bumps several dev tooling dependencies. The runtime library code is not shown in the provided diff, but the deref schema tests were modified, suggesting a possible behavioral edge-case change around circular references.
Featuresv3.0.0
v3.0.0 release notes describe repository automation updates: Dependabot update cadence, CI trigger branch support, and CI job permissions and node version coverage. The accompanying code diff confirms these changes, and shows a package.json version bump to 3.0.0.
v2.0.1
v2.0.1 primarily updates development and CI tooling (Node 22 in CI, neostandard and eslint configuration, c8 and neostandard version bumps, dependabot, funding/bugs metadata). It also tweaks error message wording and related documentation/test expectations.
v2.0.0
v2.0.0 modernizes the resolver implementation by switching equality logic from fast-deep-equal to dequal and adjusting schema dereferencing to handle cases where the root schema lacks a non-anchor $id. The release also declares explicit CommonJS module type in package.json and includes some workflow automation changes.
v1.0.1
v1.0.1 improves ref resolution error handling by throwing errors in cases where the target schema is missing or a ref cannot be resolved. It also enhances the error messages to be more informative for debugging resolution failures.
BreakingFeatures