@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
- Maintenance status: Evidence suggests the repo is not actively maintained in a typical release-cadence sense, with the last listed
v1.xupdate in 2021-02-15, despite a more recent upstream push on 2025-01-23. - Update cadence: Based on the provided update history (2020-01, 2020-07, 2021-02) and the absence of newer versioned updates in the list, updates appear infrequent and spaced by years rather than ongoing.
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