@stoplight/json-ref-readers provides utilities for reading and resolving external JSON references referenced via $ref content. It includes helpers to load references from HTTP(S) URLs and local files, typically used together with a resolver package to fetch the referenced resource as a string.
Project status
- The repo appears to be inactive on the public update/release channel: the last tagged update in the provided history is v1.2.2 (2021-02-15), and there are no newer update entries shown up to today (2026-08-13). A GitHub push was recorded at 2025-01-23, but no corresponding versioned updates are evidenced here.
- Update cadence looks like an initial burst in 2019-2021 (multiple updates), followed by a long gap where no new versioned updates are shown after early 2021. Based on the evidence provided, cadence since then is effectively quiet/dormant.
AI summary generated
Recent updates
v1.2.2
Release v1.2.2 adds tslib to dependencies and extends CI to run tests on Windows. The code change appears focused on how file paths are derived from URI inputs (used by resolveFile), plus corresponding test and fixture updates.
v1.2.1
v1.2.1 is a small release focused on a TypeScript typing fix related to the `urijs` types. The code diff shows minor signature type adjustments in the reader functions and several packaging/build pipeline changes in the repository configuration.
v1.2.0
Release 1.2.0 updates HTTP reference resolution to reject requests instead of always returning the response body. The release notes mention throwing on network errors, but the code shows more specific HTTP status handling and API behavior changes.
BreakingFeaturesv1.1.1
Release v1.1.1 contains no documented functional changes in the release notes beyond a generic “trigger release” entry. However, the code diff shows the package and documentation branding were renamed from @stoplight/ref-resolvers to @stoplight/json-ref-readers, including package metadata and README installation/import instructions.
Breakingv1.1.0
v1.1.0 adds support for supplying custom fetch RequestInit options when resolving HTTP references. It introduces a new helper that can bind default RequestInit, and updates the HTTP resolver to forward RequestInit to node-fetch.
Featuresv1.0.2
Release v1.0.2 contains a small change intended to produce CommonJS build outputs. The only code change is an update to the TypeScript compiler configuration (tsconfig.json).
v1.0.1
v1.0.1 updates the package entrypoint configuration so consumers load the built JavaScript output from the dist directory instead of referencing the TypeScript source. The release notes describe this as switching from .ts to .js and exporting the dist file.
Breakingv1.0.0
v1.0.0 is the first public release, introducing the initial implementation of this package. The release notes also mention build and environment-related adjustments, including linting updates, removal of a build-specific tsconfig file, and an updated Node.js version requirement.
Features