@fedify/vocab-runtime 2.4.0-dev.1583 → 2.4.0-dev.1618

package/dist/tests/{url-YWJbnRlf.mjs → url-a2D8NAgh.mjs}

@@ -9,6 +9,7 @@ var UrlError = class extends Error {
 };
 const PORTABLE_IRI_PATTERN = /^(ap|ap\+ef61):\/\/([^/?#]*)([^?#]*)(\?[^#]*)?(#.*)?$/i;
 const INVALID_PERCENT_ENCODING_PATTERN = /%(?![0-9A-Fa-f]{2})/;
+const PERCENT_ENCODING_PATTERN = /%[0-9A-Fa-f]{2}/g;
 const DID_SCHEME_PATTERN = /^did:/i;
 const DID_PATTERN = /^did:[a-z0-9]+:[-A-Za-z0-9._%]+(?::[-A-Za-z0-9._%]+)*$/i;
 /**
@@ -43,6 +44,88 @@ function formatIri(iri) {
 	return `ap+ef61://${decodePortableAuthority(parsed.host)}${parsed.pathname}${parsed.search}${parsed.hash}`;
 }
 /**
+* Canonicalizes a FEP-ef61 portable ActivityPub URI for comparison.
+*
+* This accepts both `ap:` and `ap+ef61:` URI strings with decoded or
+* percent-encoded DID authorities.  The returned value uses the `ap+ef61:`
+* scheme, a decoded DID authority, and no query component.  Pass the raw URI
+* string, not a `URL` object, because JavaScript `URL` normalizes opaque path
+* segments before Fedify can compare them.
+*
+* @param input The raw portable ActivityPub URI string to canonicalize.
+* @returns The canonical portable ActivityPub URI string.
+* @throws {TypeError} If the input is not a valid portable ActivityPub IRI.
+* @since 2.4.0
+*/
+function canonicalizePortableUri(input) {
+	if (typeof input !== "string") throw new TypeError("Invalid portable ActivityPub IRI.");
+	const parsed = parsePortableIri(input);
+	if (parsed == null) throw new TypeError("Invalid portable ActivityPub IRI.");
+	const match = input.match(PORTABLE_IRI_PATTERN);
+	return `ap+ef61://${normalizePortableAuthority(getDidUrlOrigin(decodePortableAuthority(parsed.host)))}${normalizePortableComponent(match[3])}${match[5] == null ? "" : normalizePortableComponent(match[5])}`;
+}
+/**
+* Checks whether two FEP-ef61 portable ActivityPub URIs identify the same
+* portable object.
+*
+* Non-string inputs return `false`.  Non-portable URI strings use strict string
+* equality.  Portable URI strings are compared through
+* {@link canonicalizePortableUri}; malformed portable URI strings return
+* `false` unless they are exactly equal.
+*
+* @since 2.4.0
+*/
+function arePortableUrisEqual(left, right) {
+	if (typeof left !== "string" || typeof right !== "string") return false;
+	if (left === right) return true;
+	if (!PORTABLE_IRI_PATTERN.test(left) || !PORTABLE_IRI_PATTERN.test(right)) return false;
+	try {
+		return canonicalizePortableUri(left) === canonicalizePortableUri(right);
+	} catch (error) {
+		if (error instanceof TypeError) return false;
+		throw error;
+	}
+}
+/**
+* Computes an IRI's FEP-fe34 origin.
+*
+* HTTP(S) IRIs use their web origin.  FEP-ef61 portable ActivityPub IRIs and
+* DID URLs use their DID as a cryptographic origin.
+*
+* @throws {TypeError} If the IRI does not have a supported FEP-fe34 origin.
+* @since 2.4.0
+*/
+function getFe34Origin(input) {
+	if (input instanceof URL) {
+		const portable = normalizePortableUrl(input);
+		if (portable != null) return getPortableCryptographicOrigin(portable);
+		if (input.protocol === "did:") return getDidUrlOrigin(input.href);
+		if (input.protocol === "http:" || input.protocol === "https:") return input.origin;
+		throw new TypeError("Unsupported FEP-fe34 origin IRI.");
+	}
+	const portable = parsePortableIri(input);
+	if (portable != null) return getPortableCryptographicOrigin(portable);
+	if (DID_SCHEME_PATTERN.test(input)) return getDidUrlOrigin(input);
+	const parsed = new URL(input);
+	if (parsed.protocol === "http:" || parsed.protocol === "https:") return parsed.origin;
+	throw new TypeError("Unsupported FEP-fe34 origin IRI.");
+}
+/**
+* Checks whether two IRIs have the same FEP-fe34 origin.
+*
+* Malformed or unsupported IRIs are treated as non-matching.
+*
+* @since 2.4.0
+*/
+function haveSameFe34Origin(left, right) {
+	try {
+		return getFe34Origin(left) === getFe34Origin(right);
+	} catch (error) {
+		if (error instanceof TypeError) return false;
+		throw error;
+	}
+}
+/**
 * Checks whether two IRIs have the same origin.
 */
 function haveSameIriOrigin(left, right) {
@@ -52,15 +135,25 @@ function getComparableIriOrigin(iri) {
 	iri = normalizePortableUrl(iri) ?? iri;
 	if (iri.origin !== "null") return iri.origin;
 	if (iri.host !== "") {
-		const host = iri.protocol === "ap+ef61:" ? encodeURIComponent(decodePortableAuthority(iri.host).replace(DID_SCHEME_PATTERN, "did:")) : iri.host;
+		const host = iri.protocol === "ap+ef61:" ? encodeURIComponent(getDidUrlOrigin(decodePortableAuthority(iri.host))) : iri.host;
 		return `${iri.protocol}//${host}`;
 	}
 	return iri.href;
 }
+function getPortableCryptographicOrigin(iri) {
+	return getDidUrlOrigin(decodePortableAuthority(iri.host));
+}
+function getDidUrlOrigin(iri) {
+	const did = iri.split(/[/?#]/, 1)[0].replace(DID_SCHEME_PATTERN, "did:");
+	if (!DID_PATTERN.test(did)) throw new TypeError("Invalid DID URL.");
+	const parts = did.split(":");
+	parts[1] = parts[1].toLowerCase();
+	return normalizePortableAuthority(parts.join(":"));
+}
 function parsePortableIri(iri) {
 	const match = iri.match(PORTABLE_IRI_PATTERN);
 	if (match == null) return null;
-	const authority = decodePortableAuthority(match[2]);
+	const authority = getDidUrlOrigin(decodePortableAuthority(match[2]));
 	if (!DID_PATTERN.test(authority)) throw new TypeError("Invalid portable ActivityPub IRI authority.");
 	if (match[3] === "") throw new TypeError("Invalid portable ActivityPub IRI path.");
 	return new URL(`ap+ef61://${encodeURIComponent(authority)}${match[3]}${match[4] ?? ""}${match[5] ?? ""}`);
@@ -85,6 +178,31 @@ function decodePortableAuthority(authority) {
 	if (INVALID_PERCENT_ENCODING_PATTERN.test(decoded)) throw new TypeError("Invalid portable ActivityPub IRI authority.");
 	return decoded;
 }
+function normalizePercentEncoding(value) {
+	return value.replace(PERCENT_ENCODING_PATTERN, (match) => match.toUpperCase());
+}
+function normalizePortableAuthority(authority) {
+	return normalizePercentEncoding(authority).replace(PERCENT_ENCODING_PATTERN, (match) => {
+		const decoded = String.fromCharCode(Number.parseInt(match.slice(1), 16));
+		return /[A-Za-z0-9._~-]/.test(decoded) ? decoded : match;
+	});
+}
+function normalizePortableComponent(value) {
+	if (INVALID_PERCENT_ENCODING_PATTERN.test(value)) throw new TypeError("Invalid portable ActivityPub IRI component.");
+	return value.replace(/%[0-9A-Fa-f]{2}|[^%]+/g, (match) => {
+		if (match.startsWith("%")) {
+			const upper = match.toUpperCase();
+			const decoded = String.fromCharCode(Number.parseInt(upper.slice(1), 16));
+			return /[A-Za-z0-9._~-]/.test(decoded) ? decoded : upper;
+		}
+		try {
+			return encodeURI(match);
+		} catch (error) {
+			if (error instanceof URIError) throw new TypeError("Invalid portable ActivityPub IRI component.");
+			throw error;
+		}
+	});
+}
 function parseAtUri(uri) {
 	const index = uri.indexOf("/", 5);
 	const authority = index >= 0 ? uri.slice(5, index) : uri.slice(5);
@@ -257,4 +375,4 @@ function matchesIPv6Prefix(address, prefixWords, prefixLength) {
 	return true;
 }
 //#endregion
-export { isValidPublicIPv4Address as a, parseJsonLdId as c, haveSameIriOrigin as i, validatePublicUrl as l, expandIPv6Address as n, isValidPublicIPv6Address as o, formatIri as r, parseIri as s, UrlError as t };
+export { formatIri as a, haveSameIriOrigin as c, parseIri as d, parseJsonLdId as f, expandIPv6Address as i, isValidPublicIPv4Address as l, arePortableUrisEqual as n, getFe34Origin as o, validatePublicUrl as p, canonicalizePortableUri as r, haveSameFe34Origin as s, UrlError as t, isValidPublicIPv6Address as u };

package/dist/tests/url.test.cjs

@@ -1,5 +1,5 @@
 require("./chunk-C2EiDwsr.cjs");
-const require_url = require("./url-2XwVbUS_.cjs");
+const require_url = require("./url-BvjYQdxL.cjs");
 let node_assert = require("node:assert");
 let node_test = require("node:test");
 //#region src/url.test.ts
@@ -12,8 +12,12 @@ let node_test = require("node:test");
 		"AP+EF61://did:key:z6Mkabc/actor"
 	]) (0, node_assert.deepStrictEqual)(require_url.parseIri(iri), new URL("ap+ef61://did%3Akey%3Az6Mkabc/actor"));
 });
-(0, node_test.test)("parseIri() accepts DID schemes case-insensitively", () => {
-	for (const iri of ["ap://DID:key:z6Mkabc/actor", "ap://DID%3Akey%3Az6Mkabc/actor"]) (0, node_assert.deepStrictEqual)(require_url.parseIri(iri), new URL("ap+ef61://DID%3Akey%3Az6Mkabc/actor"));
+(0, node_test.test)("parseIri() normalizes DID scheme and method casing", () => {
+	for (const iri of [
+		"ap://DID:key:z6Mkabc/actor",
+		"ap://DID%3Akey%3Az6Mkabc/actor",
+		"ap://did:KEY:z6Mkabc/actor"
+	]) (0, node_assert.deepStrictEqual)(require_url.parseIri(iri), new URL("ap+ef61://did%3Akey%3Az6Mkabc/actor"));
 });
 (0, node_test.test)("parseIri() accepts DID method names that start with digits", () => {
 	(0, node_assert.deepStrictEqual)(require_url.parseIri("ap://did:3:abc/actor"), new URL("ap+ef61://did%3A3%3Aabc/actor"));
@@ -60,12 +64,50 @@ let node_test = require("node:test");
 	]) (0, node_assert.throws)(() => require_url.parseIri(iri), TypeError);
 });
 (0, node_test.test)("haveSameIriOrigin() compares portable IRI authorities", () => {
+	(0, node_assert.ok)(require_url.haveSameIriOrigin(new URL("ftp://example.com/pub/1"), new URL("ftp://example.com/pub/2")));
+	(0, node_assert.ok)(require_url.haveSameIriOrigin(new URL("mailto:alice@example.com"), new URL("mailto:alice@example.com")));
 	(0, node_assert.ok)(require_url.haveSameIriOrigin(require_url.parseIri("ap://did:key:z6Mkabc/actor"), require_url.parseIri("ap://did:key:z6Mkabc/outbox")));
 	(0, node_assert.ok)(require_url.haveSameIriOrigin(new URL("ap://did%3Akey%3Az6Mkabc/actor"), new URL("ap+ef61://did%3Akey%3Az6Mkabc/outbox")));
 	(0, node_assert.ok)(require_url.haveSameIriOrigin(require_url.parseIri("ap://DID:key:z6Mkabc/actor"), require_url.parseIri("ap://did:key:z6Mkabc/outbox")));
 	(0, node_assert.ok)(require_url.haveSameIriOrigin(new URL("ap+ef61://DID%3Akey%3Az6Mkabc/actor"), new URL("ap+ef61://did%3Akey%3Az6Mkabc/outbox")));
 	(0, node_assert.ok)(!require_url.haveSameIriOrigin(require_url.parseIri("ap://did:key:z6Mkabc/actor"), require_url.parseIri("ap://did:key:z6Mkdef/actor")));
 });
+(0, node_test.test)("getFe34Origin() computes web and cryptographic origins", () => {
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin("https://Example.COM:443/users/alice"), "https://example.com");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin(new URL("http://example.com:8080/notes/1")), "http://example.com:8080");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin("ap://did:key:z6Mkabc/actor?gateways=https%3A%2F%2Fa.example"), "did:key:z6Mkabc");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin("ap+ef61://did%3Akey%3Az6Mkabc/objects/1#fragment"), "did:key:z6Mkabc");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin(new URL("ap+ef61://did%3Akey%3Az6Mkabc/actor")), "did:key:z6Mkabc");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin("did:key:z6Mkabc#z6Mkabc"), "did:key:z6Mkabc");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin(new URL("did:key:z6Mkabc?service=activitypub#key")), "did:key:z6Mkabc");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin("did:key:z6Mkabc/path/to/resource?service=activitypub#key"), "did:key:z6Mkabc");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin("did:KEY:z6Mkabc#z6Mkabc"), "did:key:z6Mkabc");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin("ap://did%3Aweb%3Afoo%2Dbar.example/actor"), "did:web:foo-bar.example");
+	(0, node_assert.deepStrictEqual)(require_url.getFe34Origin("did:web:foo%2dbar.example#key"), "did:web:foo-bar.example");
+});
+(0, node_test.test)("getFe34Origin() rejects unsupported or malformed identifiers", () => {
+	for (const iri of [
+		"mailto:alice@example.com",
+		"ap://not-a-did/actor",
+		"ap://did:key/actor",
+		"did:key",
+		"did:key:",
+		"did:"
+	]) (0, node_assert.throws)(() => require_url.getFe34Origin(iri), TypeError);
+});
+(0, node_test.test)("haveSameFe34Origin() compares web and cryptographic origins", () => {
+	(0, node_assert.ok)(require_url.haveSameFe34Origin("https://example.com/users/alice", "https://example.com/notes/1"));
+	(0, node_assert.ok)(!require_url.haveSameFe34Origin("https://example.com/users/alice", "http://example.com/users/alice"));
+	(0, node_assert.ok)(!require_url.haveSameFe34Origin("https://example.com/users/alice", "https://example.com:8443/users/alice"));
+	(0, node_assert.ok)(require_url.haveSameFe34Origin("ap://did:key:z6Mkabc/actor", "ap+ef61://did%3Akey%3Az6Mkabc/objects/1"));
+	(0, node_assert.ok)(require_url.haveSameFe34Origin("ap+ef61://did:key:z6Mkabc/actor", "did:key:z6Mkabc#z6Mkabc"));
+	(0, node_assert.ok)(require_url.haveSameFe34Origin("ap://did:KEY:z6Mkabc/actor", "did:key:z6Mkabc#z6Mkabc"));
+	(0, node_assert.ok)(require_url.haveSameFe34Origin("ap://did%3Aweb%3Afoo%2Dbar.example/actor", "ap://did:web:foo-bar.example/note"));
+	(0, node_assert.ok)(require_url.haveSameFe34Origin("ap://did%3Aexample%3Aabc%252fdef/actor", "did:example:abc%2Fdef#key"));
+	(0, node_assert.ok)(!require_url.haveSameFe34Origin("ap+ef61://did:key:z6Mkabc/actor", "did:key:z6Mkdef#z6Mkdef"));
+	(0, node_assert.ok)(!require_url.haveSameFe34Origin("ap+ef61://did:key:z6Mkabc/actor", "https://example.com/actor"));
+	(0, node_assert.ok)(!require_url.haveSameFe34Origin("ap://not-a-did/actor", "ap://not-a-did/actor"));
+});
 (0, node_test.test)("parseIri() normalizes portable URL instances", () => {
 	(0, node_assert.deepStrictEqual)(require_url.parseIri(new URL("ap+ef61://did%3Aexample%3Aabc%2Fdef/actor")), new URL("ap+ef61://did%3Aexample%3Aabc%252Fdef/actor"));
 	(0, node_assert.throws)(() => require_url.parseIri("ap+ef61://not-a-did/actor"), TypeError);
@@ -76,6 +118,86 @@ let node_test = require("node:test");
 	(0, node_assert.deepStrictEqual)(require_url.formatIri(new URL("https://example.com/actor")), "https://example.com/actor");
 	(0, node_assert.deepStrictEqual)(require_url.formatIri("/actor"), "/actor");
 });
+(0, node_test.test)("canonicalizePortableUri() emits comparison forms", () => {
+	for (const iri of [
+		"ap://did:key:z6Mkabc/actor",
+		"ap://did%3Akey%3Az6Mkabc/actor",
+		"ap://did:key:z6Mkabc/actor?gateways=https%3A%2F%2Fa.example",
+		"ap+ef61://did:key:z6Mkabc/actor",
+		"ap+ef61://did%3Akey%3Az6Mkabc/actor?gateways=https%3A%2F%2Fa.example"
+	]) (0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri(iri), "ap+ef61://did:key:z6Mkabc/actor");
+});
+(0, node_test.test)("canonicalizePortableUri() preserves paths and fragments", () => {
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/objects/1/attachments/2?gateways=https%3A%2F%2Fa.example#image"), "ap+ef61://did:key:z6Mkabc/objects/1/attachments/2#image");
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/objects/1#reply"), "ap+ef61://did:key:z6Mkabc/objects/1#reply");
+});
+(0, node_test.test)("canonicalizePortableUri() preserves DID-internal pct-encoded characters", () => {
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:example:abc%2Fdef/actor?x=1"), "ap+ef61://did:example:abc%2Fdef/actor");
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did%3Aweb%3Aexample.com%253A3000/u/1"), "ap+ef61://did:web:example.com%3A3000/u/1");
+});
+(0, node_test.test)("canonicalizePortableUri() normalizes authority pct-encoding casing", () => {
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:example:abc%2fdef/actor"), "ap+ef61://did:example:abc%2Fdef/actor");
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:example:abc%2fdef%3abar/actor"), "ap+ef61://did:example:abc%2Fdef%3Abar/actor");
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did%3Aexample%3Aabc%252fdef/actor"), "ap+ef61://did:example:abc%2Fdef/actor");
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did%3Akey%3Az6Mk%2Dabc/actor"), "ap+ef61://did:key:z6Mk-abc/actor");
+	(0, node_assert.ok)(require_url.arePortableUrisEqual("ap://did:example:abc%2fdef/actor", "ap://did:example:abc%2Fdef/actor"));
+	(0, node_assert.ok)(require_url.arePortableUrisEqual("ap://did%3Akey%3Az6Mk%2Dabc/actor", "ap://did:key:z6Mk-abc/actor"));
+});
+(0, node_test.test)("canonicalizePortableUri() normalizes path and fragment pct-encoding casing", () => {
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/actor%2fprofile#part%2ftwo"), "ap+ef61://did:key:z6Mkabc/actor%2Fprofile#part%2Ftwo");
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/actor%2fprofile%3aimage"), "ap+ef61://did:key:z6Mkabc/actor%2Fprofile%3Aimage");
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/actor%2Dprofile#part%7Etwo"), "ap+ef61://did:key:z6Mkabc/actor-profile#part~two");
+	(0, node_assert.ok)(require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/actor%2fprofile#part%2ftwo", "ap://did:key:z6Mkabc/actor%2Fprofile#part%2Ftwo"));
+	(0, node_assert.ok)(require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/actor%2Dprofile#part%7Etwo", "ap://did:key:z6Mkabc/actor-profile#part~two"));
+});
+(0, node_test.test)("canonicalizePortableUri() encodes raw path and fragment characters", () => {
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/é#é"), "ap+ef61://did:key:z6Mkabc/%C3%A9#%C3%A9");
+	(0, node_assert.ok)(require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/é#é", "ap://did:key:z6Mkabc/%C3%A9#%C3%A9"));
+});
+(0, node_test.test)("canonicalizePortableUri() normalizes DID scheme casing", () => {
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://DID:key:z6Mkabc/actor"), "ap+ef61://did:key:z6Mkabc/actor");
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://DID%3Akey%3Az6Mkabc/actor"), "ap+ef61://did:key:z6Mkabc/actor");
+});
+(0, node_test.test)("canonicalizePortableUri() preserves opaque path segments", () => {
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/a/../b?gateways=x"), "ap+ef61://did:key:z6Mkabc/a/../b");
+	(0, node_assert.deepStrictEqual)(require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/a/%2e%2e/b"), "ap+ef61://did:key:z6Mkabc/a/../b");
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/a/../b", "ap://did:key:z6Mkabc/b"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/a/%2e%2e/b", "ap://did:key:z6Mkabc/b"));
+});
+(0, node_test.test)("canonicalizePortableUri() rejects non-portable URIs", () => {
+	for (const iri of [
+		"https://example.com/actor",
+		"at://did:plc:example/record",
+		"/actor",
+		"ap://not-a-did/actor",
+		"ap://did:key:z6Mkabc"
+	]) (0, node_assert.throws)(() => require_url.canonicalizePortableUri(iri), TypeError);
+	(0, node_assert.throws)(() => require_url.canonicalizePortableUri(new URL("ap+ef61://did%3Akey%3Az6Mkabc/actor")), TypeError);
+});
+(0, node_test.test)("canonicalizePortableUri() rejects invalid path and fragment pct-encoding", () => {
+	(0, node_assert.throws)(() => require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/a%zz"), TypeError);
+	(0, node_assert.throws)(() => require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/actor#part%zz"), TypeError);
+	(0, node_assert.throws)(() => require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/\ud800"), TypeError);
+	(0, node_assert.throws)(() => require_url.canonicalizePortableUri("ap://did:key:z6Mkabc/actor#\ud800"), TypeError);
+});
+(0, node_test.test)("arePortableUrisEqual() compares canonical portable URI forms", () => {
+	(0, node_assert.ok)(require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/actor", "ap+ef61://did%3Akey%3Az6Mkabc/actor?gateways=https%3A%2F%2Fa.example"));
+	(0, node_assert.ok)(require_url.arePortableUrisEqual("ap://DID:key:z6Mkabc/actor", "ap://did:key:z6Mkabc/actor"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/actor", "ap://did:key:z6Mkdef/actor"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/actor", "ap://did:key:z6Mkabc/outbox"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/actor#one", "ap://did:key:z6Mkabc/actor#two"));
+});
+(0, node_test.test)("arePortableUrisEqual() handles non-portable URI strings", () => {
+	(0, node_assert.ok)(require_url.arePortableUrisEqual("https://example.com/actor", "https://example.com/actor"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("https://example.com/actor", "https://example.com/outbox"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/actor", "https://example.com/actor"));
+	(0, node_assert.ok)(require_url.arePortableUrisEqual("ap://not-a-did/actor", "ap://not-a-did/actor"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://not-a-did/actor", "ap://not-a-did/outbox"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://not-a-did/actor", "ap://did:key:z6Mkabc/actor"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/a%zz", "ap://did:key:z6Mkabc/a%25zz"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/\ud800", "ap://did:key:z6Mkabc/%EF%BF%BD"));
+	(0, node_assert.ok)(!require_url.arePortableUrisEqual("ap://did:key:z6Mkabc/actor#\ud800", "ap://did:key:z6Mkabc/actor#%EF%BF%BD"));
+});
 (0, node_test.test)("formatIri() preserves DID authority pct-encoded delimiters", () => {
 	const parsed = require_url.parseIri("ap://did:example:abc%2Fdef/actor");
 	(0, node_assert.deepStrictEqual)(parsed, new URL("ap+ef61://did%3Aexample%3Aabc%252Fdef/actor"));

package/dist/tests/url.test.mjs

@@ -1,4 +1,4 @@
-import { a as isValidPublicIPv4Address, c as parseJsonLdId, i as haveSameIriOrigin, l as validatePublicUrl, n as expandIPv6Address, o as isValidPublicIPv6Address, r as formatIri, s as parseIri, t as UrlError } from "./url-YWJbnRlf.mjs";
+import { a as formatIri, c as haveSameIriOrigin, d as parseIri, f as parseJsonLdId, i as expandIPv6Address, l as isValidPublicIPv4Address, n as arePortableUrisEqual, o as getFe34Origin, p as validatePublicUrl, r as canonicalizePortableUri, s as haveSameFe34Origin, t as UrlError, u as isValidPublicIPv6Address } from "./url-a2D8NAgh.mjs";
 import { deepStrictEqual, ok, rejects, throws } from "node:assert";
 import { test } from "node:test";
 //#region src/url.test.ts
@@ -11,8 +11,12 @@ test("parseIri() accepts portable ActivityPub URI schemes", () => {
 		"AP+EF61://did:key:z6Mkabc/actor"
 	]) deepStrictEqual(parseIri(iri), new URL("ap+ef61://did%3Akey%3Az6Mkabc/actor"));
 });
-test("parseIri() accepts DID schemes case-insensitively", () => {
-	for (const iri of ["ap://DID:key:z6Mkabc/actor", "ap://DID%3Akey%3Az6Mkabc/actor"]) deepStrictEqual(parseIri(iri), new URL("ap+ef61://DID%3Akey%3Az6Mkabc/actor"));
+test("parseIri() normalizes DID scheme and method casing", () => {
+	for (const iri of [
+		"ap://DID:key:z6Mkabc/actor",
+		"ap://DID%3Akey%3Az6Mkabc/actor",
+		"ap://did:KEY:z6Mkabc/actor"
+	]) deepStrictEqual(parseIri(iri), new URL("ap+ef61://did%3Akey%3Az6Mkabc/actor"));
 });
 test("parseIri() accepts DID method names that start with digits", () => {
 	deepStrictEqual(parseIri("ap://did:3:abc/actor"), new URL("ap+ef61://did%3A3%3Aabc/actor"));
@@ -59,12 +63,50 @@ test("parseIri() rejects malformed portable DID authorities", () => {
 	]) throws(() => parseIri(iri), TypeError);
 });
 test("haveSameIriOrigin() compares portable IRI authorities", () => {
+	ok(haveSameIriOrigin(new URL("ftp://example.com/pub/1"), new URL("ftp://example.com/pub/2")));
+	ok(haveSameIriOrigin(new URL("mailto:alice@example.com"), new URL("mailto:alice@example.com")));
 	ok(haveSameIriOrigin(parseIri("ap://did:key:z6Mkabc/actor"), parseIri("ap://did:key:z6Mkabc/outbox")));
 	ok(haveSameIriOrigin(new URL("ap://did%3Akey%3Az6Mkabc/actor"), new URL("ap+ef61://did%3Akey%3Az6Mkabc/outbox")));
 	ok(haveSameIriOrigin(parseIri("ap://DID:key:z6Mkabc/actor"), parseIri("ap://did:key:z6Mkabc/outbox")));
 	ok(haveSameIriOrigin(new URL("ap+ef61://DID%3Akey%3Az6Mkabc/actor"), new URL("ap+ef61://did%3Akey%3Az6Mkabc/outbox")));
 	ok(!haveSameIriOrigin(parseIri("ap://did:key:z6Mkabc/actor"), parseIri("ap://did:key:z6Mkdef/actor")));
 });
+test("getFe34Origin() computes web and cryptographic origins", () => {
+	deepStrictEqual(getFe34Origin("https://Example.COM:443/users/alice"), "https://example.com");
+	deepStrictEqual(getFe34Origin(new URL("http://example.com:8080/notes/1")), "http://example.com:8080");
+	deepStrictEqual(getFe34Origin("ap://did:key:z6Mkabc/actor?gateways=https%3A%2F%2Fa.example"), "did:key:z6Mkabc");
+	deepStrictEqual(getFe34Origin("ap+ef61://did%3Akey%3Az6Mkabc/objects/1#fragment"), "did:key:z6Mkabc");
+	deepStrictEqual(getFe34Origin(new URL("ap+ef61://did%3Akey%3Az6Mkabc/actor")), "did:key:z6Mkabc");
+	deepStrictEqual(getFe34Origin("did:key:z6Mkabc#z6Mkabc"), "did:key:z6Mkabc");
+	deepStrictEqual(getFe34Origin(new URL("did:key:z6Mkabc?service=activitypub#key")), "did:key:z6Mkabc");
+	deepStrictEqual(getFe34Origin("did:key:z6Mkabc/path/to/resource?service=activitypub#key"), "did:key:z6Mkabc");
+	deepStrictEqual(getFe34Origin("did:KEY:z6Mkabc#z6Mkabc"), "did:key:z6Mkabc");
+	deepStrictEqual(getFe34Origin("ap://did%3Aweb%3Afoo%2Dbar.example/actor"), "did:web:foo-bar.example");
+	deepStrictEqual(getFe34Origin("did:web:foo%2dbar.example#key"), "did:web:foo-bar.example");
+});
+test("getFe34Origin() rejects unsupported or malformed identifiers", () => {
+	for (const iri of [
+		"mailto:alice@example.com",
+		"ap://not-a-did/actor",
+		"ap://did:key/actor",
+		"did:key",
+		"did:key:",
+		"did:"
+	]) throws(() => getFe34Origin(iri), TypeError);
+});
+test("haveSameFe34Origin() compares web and cryptographic origins", () => {
+	ok(haveSameFe34Origin("https://example.com/users/alice", "https://example.com/notes/1"));
+	ok(!haveSameFe34Origin("https://example.com/users/alice", "http://example.com/users/alice"));
+	ok(!haveSameFe34Origin("https://example.com/users/alice", "https://example.com:8443/users/alice"));
+	ok(haveSameFe34Origin("ap://did:key:z6Mkabc/actor", "ap+ef61://did%3Akey%3Az6Mkabc/objects/1"));
+	ok(haveSameFe34Origin("ap+ef61://did:key:z6Mkabc/actor", "did:key:z6Mkabc#z6Mkabc"));
+	ok(haveSameFe34Origin("ap://did:KEY:z6Mkabc/actor", "did:key:z6Mkabc#z6Mkabc"));
+	ok(haveSameFe34Origin("ap://did%3Aweb%3Afoo%2Dbar.example/actor", "ap://did:web:foo-bar.example/note"));
+	ok(haveSameFe34Origin("ap://did%3Aexample%3Aabc%252fdef/actor", "did:example:abc%2Fdef#key"));
+	ok(!haveSameFe34Origin("ap+ef61://did:key:z6Mkabc/actor", "did:key:z6Mkdef#z6Mkdef"));
+	ok(!haveSameFe34Origin("ap+ef61://did:key:z6Mkabc/actor", "https://example.com/actor"));
+	ok(!haveSameFe34Origin("ap://not-a-did/actor", "ap://not-a-did/actor"));
+});
 test("parseIri() normalizes portable URL instances", () => {
 	deepStrictEqual(parseIri(new URL("ap+ef61://did%3Aexample%3Aabc%2Fdef/actor")), new URL("ap+ef61://did%3Aexample%3Aabc%252Fdef/actor"));
 	throws(() => parseIri("ap+ef61://not-a-did/actor"), TypeError);
@@ -75,6 +117,86 @@ test("formatIri() emits canonical portable ActivityPub URI syntax", () => {
 	deepStrictEqual(formatIri(new URL("https://example.com/actor")), "https://example.com/actor");
 	deepStrictEqual(formatIri("/actor"), "/actor");
 });
+test("canonicalizePortableUri() emits comparison forms", () => {
+	for (const iri of [
+		"ap://did:key:z6Mkabc/actor",
+		"ap://did%3Akey%3Az6Mkabc/actor",
+		"ap://did:key:z6Mkabc/actor?gateways=https%3A%2F%2Fa.example",
+		"ap+ef61://did:key:z6Mkabc/actor",
+		"ap+ef61://did%3Akey%3Az6Mkabc/actor?gateways=https%3A%2F%2Fa.example"
+	]) deepStrictEqual(canonicalizePortableUri(iri), "ap+ef61://did:key:z6Mkabc/actor");
+});
+test("canonicalizePortableUri() preserves paths and fragments", () => {
+	deepStrictEqual(canonicalizePortableUri("ap://did:key:z6Mkabc/objects/1/attachments/2?gateways=https%3A%2F%2Fa.example#image"), "ap+ef61://did:key:z6Mkabc/objects/1/attachments/2#image");
+	deepStrictEqual(canonicalizePortableUri("ap://did:key:z6Mkabc/objects/1#reply"), "ap+ef61://did:key:z6Mkabc/objects/1#reply");
+});
+test("canonicalizePortableUri() preserves DID-internal pct-encoded characters", () => {
+	deepStrictEqual(canonicalizePortableUri("ap://did:example:abc%2Fdef/actor?x=1"), "ap+ef61://did:example:abc%2Fdef/actor");
+	deepStrictEqual(canonicalizePortableUri("ap://did%3Aweb%3Aexample.com%253A3000/u/1"), "ap+ef61://did:web:example.com%3A3000/u/1");
+});
+test("canonicalizePortableUri() normalizes authority pct-encoding casing", () => {
+	deepStrictEqual(canonicalizePortableUri("ap://did:example:abc%2fdef/actor"), "ap+ef61://did:example:abc%2Fdef/actor");
+	deepStrictEqual(canonicalizePortableUri("ap://did:example:abc%2fdef%3abar/actor"), "ap+ef61://did:example:abc%2Fdef%3Abar/actor");
+	deepStrictEqual(canonicalizePortableUri("ap://did%3Aexample%3Aabc%252fdef/actor"), "ap+ef61://did:example:abc%2Fdef/actor");
+	deepStrictEqual(canonicalizePortableUri("ap://did%3Akey%3Az6Mk%2Dabc/actor"), "ap+ef61://did:key:z6Mk-abc/actor");
+	ok(arePortableUrisEqual("ap://did:example:abc%2fdef/actor", "ap://did:example:abc%2Fdef/actor"));
+	ok(arePortableUrisEqual("ap://did%3Akey%3Az6Mk%2Dabc/actor", "ap://did:key:z6Mk-abc/actor"));
+});
+test("canonicalizePortableUri() normalizes path and fragment pct-encoding casing", () => {
+	deepStrictEqual(canonicalizePortableUri("ap://did:key:z6Mkabc/actor%2fprofile#part%2ftwo"), "ap+ef61://did:key:z6Mkabc/actor%2Fprofile#part%2Ftwo");
+	deepStrictEqual(canonicalizePortableUri("ap://did:key:z6Mkabc/actor%2fprofile%3aimage"), "ap+ef61://did:key:z6Mkabc/actor%2Fprofile%3Aimage");
+	deepStrictEqual(canonicalizePortableUri("ap://did:key:z6Mkabc/actor%2Dprofile#part%7Etwo"), "ap+ef61://did:key:z6Mkabc/actor-profile#part~two");
+	ok(arePortableUrisEqual("ap://did:key:z6Mkabc/actor%2fprofile#part%2ftwo", "ap://did:key:z6Mkabc/actor%2Fprofile#part%2Ftwo"));
+	ok(arePortableUrisEqual("ap://did:key:z6Mkabc/actor%2Dprofile#part%7Etwo", "ap://did:key:z6Mkabc/actor-profile#part~two"));
+});
+test("canonicalizePortableUri() encodes raw path and fragment characters", () => {
+	deepStrictEqual(canonicalizePortableUri("ap://did:key:z6Mkabc/é#é"), "ap+ef61://did:key:z6Mkabc/%C3%A9#%C3%A9");
+	ok(arePortableUrisEqual("ap://did:key:z6Mkabc/é#é", "ap://did:key:z6Mkabc/%C3%A9#%C3%A9"));
+});
+test("canonicalizePortableUri() normalizes DID scheme casing", () => {
+	deepStrictEqual(canonicalizePortableUri("ap://DID:key:z6Mkabc/actor"), "ap+ef61://did:key:z6Mkabc/actor");
+	deepStrictEqual(canonicalizePortableUri("ap://DID%3Akey%3Az6Mkabc/actor"), "ap+ef61://did:key:z6Mkabc/actor");
+});
+test("canonicalizePortableUri() preserves opaque path segments", () => {
+	deepStrictEqual(canonicalizePortableUri("ap://did:key:z6Mkabc/a/../b?gateways=x"), "ap+ef61://did:key:z6Mkabc/a/../b");
+	deepStrictEqual(canonicalizePortableUri("ap://did:key:z6Mkabc/a/%2e%2e/b"), "ap+ef61://did:key:z6Mkabc/a/../b");
+	ok(!arePortableUrisEqual("ap://did:key:z6Mkabc/a/../b", "ap://did:key:z6Mkabc/b"));
+	ok(!arePortableUrisEqual("ap://did:key:z6Mkabc/a/%2e%2e/b", "ap://did:key:z6Mkabc/b"));
+});
+test("canonicalizePortableUri() rejects non-portable URIs", () => {
+	for (const iri of [
+		"https://example.com/actor",
+		"at://did:plc:example/record",
+		"/actor",
+		"ap://not-a-did/actor",
+		"ap://did:key:z6Mkabc"
+	]) throws(() => canonicalizePortableUri(iri), TypeError);
+	throws(() => canonicalizePortableUri(new URL("ap+ef61://did%3Akey%3Az6Mkabc/actor")), TypeError);
+});
+test("canonicalizePortableUri() rejects invalid path and fragment pct-encoding", () => {
+	throws(() => canonicalizePortableUri("ap://did:key:z6Mkabc/a%zz"), TypeError);
+	throws(() => canonicalizePortableUri("ap://did:key:z6Mkabc/actor#part%zz"), TypeError);
+	throws(() => canonicalizePortableUri("ap://did:key:z6Mkabc/\ud800"), TypeError);
+	throws(() => canonicalizePortableUri("ap://did:key:z6Mkabc/actor#\ud800"), TypeError);
+});
+test("arePortableUrisEqual() compares canonical portable URI forms", () => {
+	ok(arePortableUrisEqual("ap://did:key:z6Mkabc/actor", "ap+ef61://did%3Akey%3Az6Mkabc/actor?gateways=https%3A%2F%2Fa.example"));
+	ok(arePortableUrisEqual("ap://DID:key:z6Mkabc/actor", "ap://did:key:z6Mkabc/actor"));
+	ok(!arePortableUrisEqual("ap://did:key:z6Mkabc/actor", "ap://did:key:z6Mkdef/actor"));
+	ok(!arePortableUrisEqual("ap://did:key:z6Mkabc/actor", "ap://did:key:z6Mkabc/outbox"));
+	ok(!arePortableUrisEqual("ap://did:key:z6Mkabc/actor#one", "ap://did:key:z6Mkabc/actor#two"));
+});
+test("arePortableUrisEqual() handles non-portable URI strings", () => {
+	ok(arePortableUrisEqual("https://example.com/actor", "https://example.com/actor"));
+	ok(!arePortableUrisEqual("https://example.com/actor", "https://example.com/outbox"));
+	ok(!arePortableUrisEqual("ap://did:key:z6Mkabc/actor", "https://example.com/actor"));
+	ok(arePortableUrisEqual("ap://not-a-did/actor", "ap://not-a-did/actor"));
+	ok(!arePortableUrisEqual("ap://not-a-did/actor", "ap://not-a-did/outbox"));
+	ok(!arePortableUrisEqual("ap://not-a-did/actor", "ap://did:key:z6Mkabc/actor"));
+	ok(!arePortableUrisEqual("ap://did:key:z6Mkabc/a%zz", "ap://did:key:z6Mkabc/a%25zz"));
+	ok(!arePortableUrisEqual("ap://did:key:z6Mkabc/\ud800", "ap://did:key:z6Mkabc/%EF%BF%BD"));
+	ok(!arePortableUrisEqual("ap://did:key:z6Mkabc/actor#\ud800", "ap://did:key:z6Mkabc/actor#%EF%BF%BD"));
+});
 test("formatIri() preserves DID authority pct-encoded delimiters", () => {
 	const parsed = parseIri("ap://did:example:abc%2Fdef/actor");
 	deepStrictEqual(parsed, new URL("ap+ef61://did%3Aexample%3Aabc%252Fdef/actor"));