npm

@hyperjump/uri

A small and fast library for validating, parsing, and resolving URIs and IRIs

hyperjump-io/uriNew releases in your daily digest, changelog included.

Latest stable

2.0.2

Last release today
14 Nov 2026
Ships unpredictably
gaps range from 2 weeks to 1.4 years
Rarely documented
notes for 3 of 20 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
20 releases · first in 2023

Releases on this page

Drag across the ruler to compare, or tap a release to open it.

2.0.214 Nov 2026
Rewrote the readme, with an example, what the package offers, and a link to each page of the documentation at https://hyperjump.io/uri/ .
No code changes.

Rewrote the readme, with an example, what the package offers, and a link to each page of the documentation at https://hyperjump.io/uri/.

Full changelog: v2.0.1...v2.0.2
Open source →
2.0.114 Nov 2026
The readme and the package's homepage point to the documentation at https://hyperjump.io/uri/ .
No code changes.

The readme and the package's homepage point to the documentation at https://hyperjump.io/uri/.

Full changelog: v2.0.0...v2.0.1
Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →

Release timeline

20 releases since 2023

20232024

A rewrite of @hyperjump/uri . The documentation is now at https://hyperjump.io/uri/ .

A rewrite of @hyperjump/uri. The documentation is now at https://hyperjump.io/uri/.

What's new

Scheme rules. The validation functions check the rules of http, https, file, urn, tag, did, and data, as well as the generic syntax. Other schemes are checked with the generic syntax only. See Schemes.
Checked once. Only the validation functions check their input. The other functions trust what they're given, and TypeScript types like Iri and AbsoluteIri mark the strings that were checked. See Validate and parse.
Scheme normalization. normalizeIri and normalizeUri apply the scheme's normalization too. See Normalize.
assert functions and error classes. assertIri and the other assert functions throw an InvalidUriError or an InvalidIriError that says what's wrong and where.
New functions. parseUrn, getScheme, hasScheme, getPath, getQuery, getFragment, and urlToIri, which makes a URL an IRI. See Convert URLs.

Breaking changes

The validation functions apply scheme rules, so some identifiers that v1 accepted aren't valid.
Functions other than the validation functions don't check their arguments. Check identifiers with an is or assert function first.
resolveIri, toAbsoluteIri, and toRelativeIri don't normalize their results.
toRelativeIri takes the target first and the base second, and both have to be normalized.
The functions that work the same for URIs and IRIs have only their IRI names: parseIri, resolveIri, toRelativeIri, and toAbsoluteIri.
resolveIri doesn't take "" as a base.
A component that isn't in an identifier isn't a property of the parsed result.
Future IP literals, like [v1.fe80::a+en1], are valid instead of throwing.
It needs Node.js 22.1 or later, or a browser released since 2024.

See Migrate from v1 for each change and what to do about it.

Open source →

Additional notes

This project publishes no release notes. Between v1.4.1 and v2.0.0 there were 70 commits, 69 of them substantive:

Set up the v2 project
Decide the v2 design
Implement the v2 API, with tests
Write the website docs, and point the README at them
Validate without captures, then split at delimiters
Reject an ASCII check before validating IRIs
Reject the v flag
Write the grammar rule for rule from the RFCs
Explain why the URI pattern is slower than the IRI pattern
Benchmark against other implementations
Normalize components in toRelative instead of parsing twice
Note the Node.js version of the v1 comparison
Design scheme-specific validation
Design error messages that say what's wrong and where
Always check the base when resolving
Check scheme rules when resolving, relativizing, and normalizing
Design scheme-based normalization
Design scheme normalization as a function per component
Decide not to check domain names
Measure RFC 5952 IPv6 form for coap

…and 49 more.

1.4.113 Nov 2026

This project publishes no release notes. Between v1.4.0 and v1.4.1 there were 3 commits, 2 of them substantive:

This project publishes no release notes. Between v1.4.0 and v1.4.1 there were 3 commits, 2 of them substantive:

Ignore scratch and TODO
Fix resolving against a base with an empty authority

1.4.030 Oct 2026

This project publishes no release notes. Between v1.3.9 and v1.4.0 there were 7 commits, 6 of them substantive:

This project publishes no release notes. Between v1.3.9 and v1.4.0 there were 7 commits, 6 of them substantive:

Remove dot segments correctly in paths that don't start with a slash
Keep paths starting with "//" from being parsed as an authority
Make toRelative results resolve back to the target
Add normalize tests for rootless paths
Simplify removeDotSegments with one pattern per RFC 3986 rule
Add fragment encoding functions

1.3.98 Oct 2026

This project publishes no release notes. Between v1.3.8 and v1.3.9 there were 2 commits, 1 of them substantive:

This project publishes no release notes. Between v1.3.8 and v1.3.9 there were 2 commits, 1 of them substantive:

Decode percent-encoded UTF-8 as characters when normalizing IRIs

1.3.83 Oct 2026

This project publishes no release notes. Between v1.3.7 and v1.3.8 there were 2 commits, 1 of them substantive:

This project publishes no release notes. Between v1.3.7 and v1.3.8 there were 2 commits, 1 of them substantive:

Normalize percent-encoding before removing dot segments

1.3.73 Oct 2026

This project publishes no release notes. Between v1.3.6 and v1.3.7 there were 2 commits, 1 of them substantive:

This project publishes no release notes. Between v1.3.6 and v1.3.7 there were 2 commits, 1 of them substantive:

Improve performance

1.3.630 Aug 2026

This project publishes no release notes. Between v1.3.5 and v1.3.6 there were 2 commits, 1 of them substantive:

This project publishes no release notes. Between v1.3.5 and v1.3.6 there were 2 commits, 1 of them substantive:

Throw on validating ipvfuture

1.3.514 Aug 2026

This project publishes no release notes. Between v1.3.4 and v1.3.5 there were 3 commits, 2 of them substantive:

This project publishes no release notes. Between v1.3.4 and v1.3.5 there were 3 commits, 2 of them substantive:

Ignore type error in eslint config
Fix for uri-reference that looks like a scheme

1.3.46 May 2026

This project publishes no release notes. Between v1.3.3 and v1.3.4 there were 2 commits, 1 of them substantive:

This project publishes no release notes. Between v1.3.3 and v1.3.4 there were 2 commits, 1 of them substantive:

The "v" is the IPvFuture production is case insenstive

1.3.35 Mar 2026

This project publishes no release notes. Between v1.3.2 and v1.3.3 there were 3 commits, 2 of them substantive:

This project publishes no release notes. Between v1.3.2 and v1.3.3 there were 3 commits, 2 of them substantive:

fix authority normalization (#7)
Refine URI and IRI parsing documentation (#10)

1.3.223 Sep 2025

This project publishes no release notes. Between v1.3.1 and v1.3.2 there were 4 commits, 3 of them substantive:

This project publishes no release notes. Between v1.3.1 and v1.3.2 there were 4 commits, 3 of them substantive:

Fix unicode regex patterns
Path of a URI/IRI without an authority component cannot begin with //
Update infrastructure

1.3.13 Feb 2025

This project publishes no release notes. Between v1.3.0 and v1.3.1 there were 3 commits, 2 of them substantive:

This project publishes no release notes. Between v1.3.0 and v1.3.1 there were 3 commits, 2 of them substantive:

Fix automation
Fix type generation

1.3.03 Feb 2025

This project publishes no release notes. Between v1.2.2 and v1.3.0 there were 8 commits, 6 of them substantive:

This project publishes no release notes. Between v1.2.2 and v1.3.0 there were 8 commits, 6 of them substantive:

Fix npmignore after switching to typescript tests
README updates for normalization rules
fix(docs): typo and a broken relative reference
Add license and sponsorship meta-data
Update project: vitest, eslint9, jsdoc, automation
Add toRelative functions

1.2.214 Sep 2023

This project publishes no release notes. Between v1.2.1 and v1.2.2 there were 4 commits, 3 of them substantive:

This project publishes no release notes. Between v1.2.1 and v1.2.2 there were 4 commits, 3 of them substantive:

Switch to using TypeScript for tests
Normalize authority
Add keywords to package json

1.2.11 Sep 2023

This project publishes no release notes. Between v1.2.0 and v1.2.1 there were 2 commits, 1 of them substantive:

This project publishes no release notes. Between v1.2.0 and v1.2.1 there were 2 commits, 1 of them substantive:

Normalize scheme casing

1.2.04 May 2023

This project publishes no release notes. Between v1.1.0 and v1.2.0 there were 3 commits, 2 of them substantive:

This project publishes no release notes. Between v1.1.0 and v1.2.0 there were 3 commits, 2 of them substantive:

Fix README typo
Add normalization functionality

1.1.013 Jan 2023

Nothing published for this version

1.0.013 Jan 2023

Nothing published for this version

One column per quarter.