@fedify/vocab-runtime 2.4.0-pr.934.40 → 2.4.0

package/dist/tests/internal/multicodec.test.cjs

@@ -1,7 +1,6 @@
-require("../chunk-C2EiDwsr.cjs");
-const require_multicodec = require("../multicodec-CxGVGa91.cjs");
-let node_assert = require("node:assert");
+const require_multicodec = require("../multicodec-CLRPeW4N.cjs");
 let node_test = require("node:test");
+let node_assert = require("node:assert");
 //#region src/internal/multicodec.test.ts
 (0, node_test.test)("getMulticodecPrefix() decodes supported multicodec prefixes", () => {
 	(0, node_assert.deepStrictEqual)(require_multicodec.getMulticodecPrefix(Uint8Array.from([

package/dist/tests/internal/multicodec.test.mjs

@@ -1,6 +1,6 @@
-import { n as getMulticodecPrefix, r as removeMulticodecPrefix, t as addMulticodecPrefix } from "../multicodec-CyFp54fI.mjs";
-import { deepStrictEqual, throws } from "node:assert";
+import { n as getMulticodecPrefix, r as removeMulticodecPrefix, t as addMulticodecPrefix } from "../multicodec-CRIj_05H.mjs";
 import { test } from "node:test";
+import { deepStrictEqual, throws } from "node:assert";
 //#region src/internal/multicodec.test.ts
 test("getMulticodecPrefix() decodes supported multicodec prefixes", () => {
 	deepStrictEqual(getMulticodecPrefix(Uint8Array.from([

package/dist/tests/internal/portable-dereference.test.cjs

@@ -0,0 +1,172 @@
+const require_url = require("../url-BNakuZ8k.cjs");
+const require_jsonld_cache = require("../jsonld-cache-C07AyNOY.cjs");
+const require_portable_dereference = require("../portable-dereference-BNXtgg5U.cjs");
+let node_assert_strict = require("node:assert/strict");
+let node_test = require("node:test");
+//#region src/internal/portable-dereference.test.ts
+const hrefs = (urls) => urls.map((url) => url.href);
+(0, node_test.test)("isPortableIri()", () => {
+	(0, node_assert_strict.ok)(require_portable_dereference.isPortableIri(require_url.parseIri("ap://did:key:z6Mkabc/actor")));
+	(0, node_assert_strict.ok)(require_portable_dereference.isPortableIri(require_url.parseIri("ap+ef61://did:key:z6Mkabc/actor")));
+	(0, node_assert_strict.ok)(require_portable_dereference.isPortableIri(new URL("ap://did%3Akey%3Az6Mkabc/actor")));
+	(0, node_assert_strict.ok)(!require_portable_dereference.isPortableIri(new URL("https://example.com/actor")));
+	(0, node_assert_strict.ok)(!require_portable_dereference.isPortableIri(new URL("did:key:z6Mkabc")));
+});
+(0, node_test.test)("getPortableGatewayCandidates() uses explicit gateways", () => {
+	const url = require_url.parseIri("ap://did:key:z6Mkabc/actor?@gateway=https%3A%2F%2Fhint.example");
+	(0, node_assert_strict.deepStrictEqual)(hrefs(require_portable_dereference.getPortableGatewayCandidates(url, [
+		"https://b.example",
+		new URL("https://a.example/"),
+		"https://b.example/",
+		"http://c.example:8080"
+	])), [
+		"https://b.example/",
+		"https://a.example/",
+		"http://c.example:8080/"
+	]);
+	(0, node_assert_strict.deepStrictEqual)(require_portable_dereference.getPortableGatewayCandidates(url, []), []);
+	for (const gateway of [
+		"https://a.example/path",
+		"https://a.example/?",
+		"https://a.example/#",
+		"https://user:pass@a.example",
+		"ftp://a.example",
+		"a.example"
+	]) (0, node_assert_strict.throws)(() => require_portable_dereference.getPortableGatewayCandidates(url, [gateway]), TypeError);
+});
+(0, node_test.test)("getPortableGatewayCandidates() reads @gateway hints", () => {
+	(0, node_assert_strict.deepStrictEqual)(hrefs(require_portable_dereference.getPortableGatewayCandidates(require_url.parseIri("ap://did:key:z6Mkabc/actor?page=1&@gateway=https%3A%2F%2Fa.example&gateways=https%3A%2F%2Flegacy.example&@gateway=not%20a%20URL&@gateway=https%3A%2F%2Fb.example%2Fpath&@gateway=https%3A%2F%2Fquery.example%2F%3F&@gateway=https%3A%2F%2Ffragment.example%2F%23&%40gateway=https%3A%2F%2Fb.example&@gateway=https%3A%2F%2Fa.example%2F"))), ["https://a.example/", "https://b.example/"]);
+	(0, node_assert_strict.deepStrictEqual)(require_portable_dereference.getPortableGatewayCandidates(require_url.parseIri("ap://did:key:z6Mkabc/actor")), []);
+	const hints = Array.from({ length: 7 }, (_, i) => `@gateway=https%3A%2F%2Fg${i}.example`);
+	(0, node_assert_strict.deepStrictEqual)(hrefs(require_portable_dereference.getPortableGatewayCandidates(require_url.parseIri(`ap://did:key:z6Mkabc/actor?${hints.join("&")}`))), [
+		0,
+		1,
+		2,
+		3,
+		4
+	].map((i) => `https://g${i}.example/`));
+});
+(0, node_test.test)("getPortableGatewayCandidates() reads hints from withGatewayHints()", () => {
+	const gateways = Array.from({ length: 7 }, (_, i) => `https://g${i}.example`);
+	(0, node_assert_strict.deepStrictEqual)(hrefs(require_portable_dereference.getPortableGatewayCandidates(require_url.withGatewayHints("ap://did:key:z6Mkabc/actor?page=1", gateways))), [
+		0,
+		1,
+		2,
+		3,
+		4
+	].map((i) => `https://g${i}.example/`));
+});
+(0, node_test.test)("getReferrerGateways() takes gateways from the owner", () => {
+	const actor = {
+		id: require_url.parseIri("ap://did:key:z6Mkabc/actor"),
+		gateways: [
+			new URL("https://a.example"),
+			new URL("https://a.example/"),
+			new URL("https://b.example/path"),
+			new URL("https://c.example")
+		]
+	};
+	const outbox = { id: require_url.parseIri("ap://did:key:z6Mkabc/actor/outbox") };
+	require_portable_dereference.recordPortableReferrer(actor, outbox, "outbox");
+	const page = require_url.parseIri("ap://did:key:z6Mkabc/actor/outbox?cursor=1");
+	(0, node_assert_strict.deepStrictEqual)(hrefs(require_portable_dereference.getReferrerGateways(actor, outbox.id) ?? []), ["https://a.example/", "https://c.example/"]);
+	(0, node_assert_strict.deepStrictEqual)(hrefs(require_portable_dereference.getReferrerGateways(outbox, page) ?? []), ["https://a.example/", "https://c.example/"]);
+	(0, node_assert_strict.deepStrictEqual)(require_portable_dereference.getReferrerGateways(outbox, require_url.withGatewayHints(page, [new URL("https://hint.example")])), void 0);
+	(0, node_assert_strict.deepStrictEqual)(require_portable_dereference.getReferrerGateways(outbox, require_url.parseIri("ap://did:key:z6Mkdef/notes/1")), void 0);
+	const compatible = {
+		id: new URL("https://a.example/.well-known/apgateway/did:key:z6Mkabc/actor"),
+		gateways: [new URL("https://a.example")]
+	};
+	(0, node_assert_strict.deepStrictEqual)(hrefs(require_portable_dereference.getReferrerGateways(compatible, outbox.id) ?? []), ["https://a.example/"]);
+	(0, node_assert_strict.deepStrictEqual)(require_portable_dereference.getReferrerGateways({}, page), void 0);
+	(0, node_assert_strict.deepStrictEqual)(require_portable_dereference.getReferrerGateways({
+		id: actor.id,
+		gateways: []
+	}, page), void 0);
+});
+(0, node_test.test)("createSnapshotContextLoader() does not nest released snapshots", async () => {
+	const calls = [];
+	const base = (url) => {
+		calls.push(url);
+		return Promise.resolve({
+			contextUrl: null,
+			documentUrl: url,
+			document: { "@context": {} }
+		});
+	};
+	let loader = base;
+	for (let i = 0; i < 1e4; i++) {
+		const snapshot = require_portable_dereference.createSnapshotContextLoader(loader);
+		snapshot.release();
+		loader = snapshot.loader;
+	}
+	await loader("https://example.com/context");
+	(0, node_assert_strict.deepStrictEqual)(calls, ["https://example.com/context"]);
+	const outer = require_portable_dereference.createSnapshotContextLoader(base);
+	await outer.loader("https://example.com/context");
+	const inner = require_portable_dereference.createSnapshotContextLoader(outer.loader);
+	await inner.loader("https://example.com/context");
+	(0, node_assert_strict.deepStrictEqual)(calls.length, 2);
+	inner.release();
+	outer.release();
+});
+(0, node_test.test)("context loaders unwrap mixed released wrappers", async () => {
+	const calls = [];
+	const base = (url) => {
+		calls.push(url);
+		return Promise.resolve({
+			contextUrl: null,
+			documentUrl: url,
+			document: { "@context": {} }
+		});
+	};
+	for (const snapshotFirst of [false, true]) {
+		let loader = base;
+		for (let i = 0; i < 1e4; i++) {
+			const wrapper = i % 2 === 0 === snapshotFirst ? require_portable_dereference.createSnapshotContextLoader(loader, true) : require_jsonld_cache.createScopedContextLoader(loader, true);
+			wrapper.release();
+			loader = wrapper.loader;
+		}
+		const unwrapped = require_jsonld_cache.createScopedContextLoader(loader, false).loader;
+		(0, node_assert_strict.deepStrictEqual)(unwrapped, base);
+		await unwrapped("https://example.com/context");
+	}
+	(0, node_assert_strict.deepStrictEqual)(calls, ["https://example.com/context", "https://example.com/context"]);
+});
+(0, node_test.test)("mixed context wrappers preserve active suppression and snapshots", async () => {
+	for (const activeSnapshot of [false, true]) {
+		const calls = [];
+		const base = (url, options) => {
+			calls.push(options);
+			return Promise.resolve({
+				contextUrl: null,
+				documentUrl: url,
+				document: { "@context": {} }
+			});
+		};
+		const active = activeSnapshot ? require_portable_dereference.createSnapshotContextLoader(base, true) : require_jsonld_cache.createScopedContextLoader(base, true);
+		let loader = active.loader;
+		for (let i = 0; i < 4; i++) {
+			const wrapper = i % 2 === 0 ? require_jsonld_cache.createScopedContextLoader(loader, true) : require_portable_dereference.createSnapshotContextLoader(loader, true);
+			wrapper.release();
+			loader = wrapper.loader;
+		}
+		const unwrapped = require_jsonld_cache.createScopedContextLoader(loader, false).loader;
+		(0, node_assert_strict.deepStrictEqual)(unwrapped, active.loader);
+		const options = { signal: new AbortController().signal };
+		const first = await unwrapped("https://example.com/context", options);
+		(0, node_assert_strict.ok)(first.document != null && typeof first.document === "object");
+		Reflect.set(first.document, "changed", true);
+		(0, node_assert_strict.deepStrictEqual)((await unwrapped("https://example.com/context", options)).document, { "@context": {} });
+		(0, node_assert_strict.deepStrictEqual)(calls.length, activeSnapshot ? 1 : 2);
+		for (const call of calls) (0, node_assert_strict.deepStrictEqual)(call, {
+			...options,
+			suppressError: true
+		});
+		active.release();
+		(0, node_assert_strict.deepStrictEqual)(require_jsonld_cache.createScopedContextLoader(loader, false).loader, base);
+		await unwrapped("https://example.com/context", options);
+		(0, node_assert_strict.deepStrictEqual)(calls.at(-1), options);
+	}
+});
+//#endregion

package/dist/tests/internal/portable-dereference.test.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/tests/internal/portable-dereference.test.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/tests/internal/portable-dereference.test.mjs

@@ -0,0 +1,173 @@
+import { S as withGatewayHints, _ as parseIri } from "../url-DMxmp7ZG.mjs";
+import { n as createScopedContextLoader } from "../jsonld-cache-BPQmOZWD.mjs";
+import { a as recordPortableReferrer, i as isPortableIri, n as getPortableGatewayCandidates, r as getReferrerGateways, t as createSnapshotContextLoader } from "../portable-dereference-DRE5bz-l.mjs";
+import { deepStrictEqual, ok, throws } from "node:assert/strict";
+import { test } from "node:test";
+//#region src/internal/portable-dereference.test.ts
+const hrefs = (urls) => urls.map((url) => url.href);
+test("isPortableIri()", () => {
+	ok(isPortableIri(parseIri("ap://did:key:z6Mkabc/actor")));
+	ok(isPortableIri(parseIri("ap+ef61://did:key:z6Mkabc/actor")));
+	ok(isPortableIri(new URL("ap://did%3Akey%3Az6Mkabc/actor")));
+	ok(!isPortableIri(new URL("https://example.com/actor")));
+	ok(!isPortableIri(new URL("did:key:z6Mkabc")));
+});
+test("getPortableGatewayCandidates() uses explicit gateways", () => {
+	const url = parseIri("ap://did:key:z6Mkabc/actor?@gateway=https%3A%2F%2Fhint.example");
+	deepStrictEqual(hrefs(getPortableGatewayCandidates(url, [
+		"https://b.example",
+		new URL("https://a.example/"),
+		"https://b.example/",
+		"http://c.example:8080"
+	])), [
+		"https://b.example/",
+		"https://a.example/",
+		"http://c.example:8080/"
+	]);
+	deepStrictEqual(getPortableGatewayCandidates(url, []), []);
+	for (const gateway of [
+		"https://a.example/path",
+		"https://a.example/?",
+		"https://a.example/#",
+		"https://user:pass@a.example",
+		"ftp://a.example",
+		"a.example"
+	]) throws(() => getPortableGatewayCandidates(url, [gateway]), TypeError);
+});
+test("getPortableGatewayCandidates() reads @gateway hints", () => {
+	deepStrictEqual(hrefs(getPortableGatewayCandidates(parseIri("ap://did:key:z6Mkabc/actor?page=1&@gateway=https%3A%2F%2Fa.example&gateways=https%3A%2F%2Flegacy.example&@gateway=not%20a%20URL&@gateway=https%3A%2F%2Fb.example%2Fpath&@gateway=https%3A%2F%2Fquery.example%2F%3F&@gateway=https%3A%2F%2Ffragment.example%2F%23&%40gateway=https%3A%2F%2Fb.example&@gateway=https%3A%2F%2Fa.example%2F"))), ["https://a.example/", "https://b.example/"]);
+	deepStrictEqual(getPortableGatewayCandidates(parseIri("ap://did:key:z6Mkabc/actor")), []);
+	const hints = Array.from({ length: 7 }, (_, i) => `@gateway=https%3A%2F%2Fg${i}.example`);
+	deepStrictEqual(hrefs(getPortableGatewayCandidates(parseIri(`ap://did:key:z6Mkabc/actor?${hints.join("&")}`))), [
+		0,
+		1,
+		2,
+		3,
+		4
+	].map((i) => `https://g${i}.example/`));
+});
+test("getPortableGatewayCandidates() reads hints from withGatewayHints()", () => {
+	const gateways = Array.from({ length: 7 }, (_, i) => `https://g${i}.example`);
+	deepStrictEqual(hrefs(getPortableGatewayCandidates(withGatewayHints("ap://did:key:z6Mkabc/actor?page=1", gateways))), [
+		0,
+		1,
+		2,
+		3,
+		4
+	].map((i) => `https://g${i}.example/`));
+});
+test("getReferrerGateways() takes gateways from the owner", () => {
+	const actor = {
+		id: parseIri("ap://did:key:z6Mkabc/actor"),
+		gateways: [
+			new URL("https://a.example"),
+			new URL("https://a.example/"),
+			new URL("https://b.example/path"),
+			new URL("https://c.example")
+		]
+	};
+	const outbox = { id: parseIri("ap://did:key:z6Mkabc/actor/outbox") };
+	recordPortableReferrer(actor, outbox, "outbox");
+	const page = parseIri("ap://did:key:z6Mkabc/actor/outbox?cursor=1");
+	deepStrictEqual(hrefs(getReferrerGateways(actor, outbox.id) ?? []), ["https://a.example/", "https://c.example/"]);
+	deepStrictEqual(hrefs(getReferrerGateways(outbox, page) ?? []), ["https://a.example/", "https://c.example/"]);
+	deepStrictEqual(getReferrerGateways(outbox, withGatewayHints(page, [new URL("https://hint.example")])), void 0);
+	deepStrictEqual(getReferrerGateways(outbox, parseIri("ap://did:key:z6Mkdef/notes/1")), void 0);
+	const compatible = {
+		id: new URL("https://a.example/.well-known/apgateway/did:key:z6Mkabc/actor"),
+		gateways: [new URL("https://a.example")]
+	};
+	deepStrictEqual(hrefs(getReferrerGateways(compatible, outbox.id) ?? []), ["https://a.example/"]);
+	deepStrictEqual(getReferrerGateways({}, page), void 0);
+	deepStrictEqual(getReferrerGateways({
+		id: actor.id,
+		gateways: []
+	}, page), void 0);
+});
+test("createSnapshotContextLoader() does not nest released snapshots", async () => {
+	const calls = [];
+	const base = (url) => {
+		calls.push(url);
+		return Promise.resolve({
+			contextUrl: null,
+			documentUrl: url,
+			document: { "@context": {} }
+		});
+	};
+	let loader = base;
+	for (let i = 0; i < 1e4; i++) {
+		const snapshot = createSnapshotContextLoader(loader);
+		snapshot.release();
+		loader = snapshot.loader;
+	}
+	await loader("https://example.com/context");
+	deepStrictEqual(calls, ["https://example.com/context"]);
+	const outer = createSnapshotContextLoader(base);
+	await outer.loader("https://example.com/context");
+	const inner = createSnapshotContextLoader(outer.loader);
+	await inner.loader("https://example.com/context");
+	deepStrictEqual(calls.length, 2);
+	inner.release();
+	outer.release();
+});
+test("context loaders unwrap mixed released wrappers", async () => {
+	const calls = [];
+	const base = (url) => {
+		calls.push(url);
+		return Promise.resolve({
+			contextUrl: null,
+			documentUrl: url,
+			document: { "@context": {} }
+		});
+	};
+	for (const snapshotFirst of [false, true]) {
+		let loader = base;
+		for (let i = 0; i < 1e4; i++) {
+			const wrapper = i % 2 === 0 === snapshotFirst ? createSnapshotContextLoader(loader, true) : createScopedContextLoader(loader, true);
+			wrapper.release();
+			loader = wrapper.loader;
+		}
+		const unwrapped = createScopedContextLoader(loader, false).loader;
+		deepStrictEqual(unwrapped, base);
+		await unwrapped("https://example.com/context");
+	}
+	deepStrictEqual(calls, ["https://example.com/context", "https://example.com/context"]);
+});
+test("mixed context wrappers preserve active suppression and snapshots", async () => {
+	for (const activeSnapshot of [false, true]) {
+		const calls = [];
+		const base = (url, options) => {
+			calls.push(options);
+			return Promise.resolve({
+				contextUrl: null,
+				documentUrl: url,
+				document: { "@context": {} }
+			});
+		};
+		const active = activeSnapshot ? createSnapshotContextLoader(base, true) : createScopedContextLoader(base, true);
+		let loader = active.loader;
+		for (let i = 0; i < 4; i++) {
+			const wrapper = i % 2 === 0 ? createScopedContextLoader(loader, true) : createSnapshotContextLoader(loader, true);
+			wrapper.release();
+			loader = wrapper.loader;
+		}
+		const unwrapped = createScopedContextLoader(loader, false).loader;
+		deepStrictEqual(unwrapped, active.loader);
+		const options = { signal: new AbortController().signal };
+		const first = await unwrapped("https://example.com/context", options);
+		ok(first.document != null && typeof first.document === "object");
+		Reflect.set(first.document, "changed", true);
+		deepStrictEqual((await unwrapped("https://example.com/context", options)).document, { "@context": {} });
+		deepStrictEqual(calls.length, activeSnapshot ? 1 : 2);
+		for (const call of calls) deepStrictEqual(call, {
+			...options,
+			suppressError: true
+		});
+		active.release();
+		deepStrictEqual(createScopedContextLoader(loader, false).loader, base);
+		await unwrapped("https://example.com/context", options);
+		deepStrictEqual(calls.at(-1), options);
+	}
+});
+//#endregion
+export {};