@fedify/vocab-runtime 2.4.0-dev.2035 → 2.4.0-dev.2054

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

@@ -0,0 +1,123 @@
+const require_url = require("../url-BqlldzT8.cjs");
+require("../jsonld-CmDhHNTx.cjs");
+let node_assert_strict = require("node:assert/strict");
+let node_test = require("node:test");
+let _logtape_logtape = require("@logtape/logtape");
+require("@opentelemetry/api");
+//#region src/internal/portable-dereference.ts
+const logger = (0, _logtape_logtape.getLogger)([
+	"fedify",
+	"vocab",
+	"gateway"
+]);
+/**
+* The maximum number of `@gateway` location hints to try for one reference.
+* Hints come from possibly untrusted documents, so they are bounded to keep
+* a single accessor call from fanning out to many servers.
+*/
+const MAX_GATEWAY_HINTS = 5;
+const LOCATION_HINT_PARAMETER = "@gateway";
+/**
+* Checks whether a URL is an FEP-ef61 portable ActivityPub IRI.
+*
+* @internal Technically exported for generated vocabulary classes, but not
+* part of the public API contract.  This is not considered public API for
+* Semantic Versioning decisions.
+*/
+function isPortableIri(url) {
+	return url.protocol === "ap+ef61:" || url.protocol === "ap:";
+}
+/**
+* Picks the ordered list of FEP-ef61 gateways to fetch a portable IRI from.
+*
+* If `gateways` is given, it is used as is (even when empty), and `@gateway`
+* location hints in the IRI are ignored.  Otherwise, up to
+* {@link MAX_GATEWAY_HINTS} valid `@gateway` hints are used.  Duplicate
+* gateways are dropped in both cases.
+*
+* @throws {TypeError} If an explicit gateway is not an HTTP(S) origin.
+* @internal
+*/
+function getPortableGatewayCandidates(url, gateways) {
+	const candidates = [];
+	const seen = /* @__PURE__ */ new Set();
+	const add = (gateway) => {
+		if (seen.has(gateway.href)) return;
+		seen.add(gateway.href);
+		candidates.push(gateway);
+	};
+	if (gateways != null) {
+		for (const gateway of gateways) {
+			const parsed = parseGatewayOrigin(gateway);
+			if (parsed == null) throw new TypeError("FEP-ef61 gateways must be HTTP(S) origins with no credentials, path, query, or fragment: " + String(gateway));
+			add(parsed);
+		}
+		return candidates;
+	}
+	for (const hint of new URLSearchParams(url.search).getAll(LOCATION_HINT_PARAMETER)) {
+		if (candidates.length >= MAX_GATEWAY_HINTS) break;
+		const parsed = parseGatewayOrigin(hint);
+		if (parsed == null) {
+			logger.debug("Ignoring an invalid FEP-ef61 gateway hint {hint} in {url}.", {
+				hint,
+				url: require_url.formatIri(url)
+			});
+			continue;
+		}
+		add(parsed);
+	}
+	return candidates;
+}
+function parseGatewayOrigin(gateway) {
+	let url;
+	if (gateway instanceof URL) url = new URL(gateway.href);
+	else if (typeof gateway === "string" && URL.canParse(gateway)) url = new URL(gateway);
+	else return null;
+	if (url.protocol !== "http:" && url.protocol !== "https:" || url.href !== `${url.origin}/`) return null;
+	return url;
+}
+//#endregion
+//#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)(isPortableIri(require_url.parseIri("ap://did:key:z6Mkabc/actor")));
+	(0, node_assert_strict.ok)(isPortableIri(require_url.parseIri("ap+ef61://did:key:z6Mkabc/actor")));
+	(0, node_assert_strict.ok)(isPortableIri(new URL("ap://did%3Akey%3Az6Mkabc/actor")));
+	(0, node_assert_strict.ok)(!isPortableIri(new URL("https://example.com/actor")));
+	(0, node_assert_strict.ok)(!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(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)(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)(() => getPortableGatewayCandidates(url, [gateway]), TypeError);
+});
+(0, node_test.test)("getPortableGatewayCandidates() reads @gateway hints", () => {
+	(0, node_assert_strict.deepStrictEqual)(hrefs(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&%40gateway=https%3A%2F%2Fb.example&@gateway=https%3A%2F%2Fa.example%2F"))), ["https://a.example/", "https://b.example/"]);
+	(0, node_assert_strict.deepStrictEqual)(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(getPortableGatewayCandidates(require_url.parseIri(`ap://did:key:z6Mkabc/actor?${hints.join("&")}`))), [
+		0,
+		1,
+		2,
+		3,
+		4
+	].map((i) => `https://g${i}.example/`));
+});
+//#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,124 @@
+import { a as formatIri, m as parseIri } from "../url-DgJM9WJn.mjs";
+import "../jsonld-DweIJ07b.mjs";
+import { deepStrictEqual, ok, throws } from "node:assert/strict";
+import { test } from "node:test";
+import { getLogger } from "@logtape/logtape";
+import "@opentelemetry/api";
+//#region src/internal/portable-dereference.ts
+const logger = getLogger([
+	"fedify",
+	"vocab",
+	"gateway"
+]);
+/**
+* The maximum number of `@gateway` location hints to try for one reference.
+* Hints come from possibly untrusted documents, so they are bounded to keep
+* a single accessor call from fanning out to many servers.
+*/
+const MAX_GATEWAY_HINTS = 5;
+const LOCATION_HINT_PARAMETER = "@gateway";
+/**
+* Checks whether a URL is an FEP-ef61 portable ActivityPub IRI.
+*
+* @internal Technically exported for generated vocabulary classes, but not
+* part of the public API contract.  This is not considered public API for
+* Semantic Versioning decisions.
+*/
+function isPortableIri(url) {
+	return url.protocol === "ap+ef61:" || url.protocol === "ap:";
+}
+/**
+* Picks the ordered list of FEP-ef61 gateways to fetch a portable IRI from.
+*
+* If `gateways` is given, it is used as is (even when empty), and `@gateway`
+* location hints in the IRI are ignored.  Otherwise, up to
+* {@link MAX_GATEWAY_HINTS} valid `@gateway` hints are used.  Duplicate
+* gateways are dropped in both cases.
+*
+* @throws {TypeError} If an explicit gateway is not an HTTP(S) origin.
+* @internal
+*/
+function getPortableGatewayCandidates(url, gateways) {
+	const candidates = [];
+	const seen = /* @__PURE__ */ new Set();
+	const add = (gateway) => {
+		if (seen.has(gateway.href)) return;
+		seen.add(gateway.href);
+		candidates.push(gateway);
+	};
+	if (gateways != null) {
+		for (const gateway of gateways) {
+			const parsed = parseGatewayOrigin(gateway);
+			if (parsed == null) throw new TypeError("FEP-ef61 gateways must be HTTP(S) origins with no credentials, path, query, or fragment: " + String(gateway));
+			add(parsed);
+		}
+		return candidates;
+	}
+	for (const hint of new URLSearchParams(url.search).getAll(LOCATION_HINT_PARAMETER)) {
+		if (candidates.length >= MAX_GATEWAY_HINTS) break;
+		const parsed = parseGatewayOrigin(hint);
+		if (parsed == null) {
+			logger.debug("Ignoring an invalid FEP-ef61 gateway hint {hint} in {url}.", {
+				hint,
+				url: formatIri(url)
+			});
+			continue;
+		}
+		add(parsed);
+	}
+	return candidates;
+}
+function parseGatewayOrigin(gateway) {
+	let url;
+	if (gateway instanceof URL) url = new URL(gateway.href);
+	else if (typeof gateway === "string" && URL.canParse(gateway)) url = new URL(gateway);
+	else return null;
+	if (url.protocol !== "http:" && url.protocol !== "https:" || url.href !== `${url.origin}/`) return null;
+	return url;
+}
+//#endregion
+//#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&%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/`));
+});
+//#endregion
+export {};

package/dist/tests/jsonld-CmDhHNTx.cjs

@@ -0,0 +1,12 @@
+const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
+let jsonld_dist_jsonld_esm_js = require("jsonld/dist/jsonld.esm.js");
+jsonld_dist_jsonld_esm_js = require_rolldown_runtime.__toESM(jsonld_dist_jsonld_esm_js, 1);
+//#region src/jsonld.ts
+var jsonld_default = jsonld_dist_jsonld_esm_js.default;
+//#endregion
+Object.defineProperty(exports, "jsonld_default", {
+	enumerable: true,
+	get: function() {
+		return jsonld_default;
+	}
+});

package/dist/tests/jsonld-DweIJ07b.mjs

@@ -0,0 +1,5 @@
+import jsonld from "jsonld/dist/jsonld.esm.js";
+//#region src/jsonld.ts
+var jsonld_default = jsonld;
+//#endregion
+export { jsonld_default as t };

package/dist/tests/jsonld-cache.test.cjs

@@ -1,12 +1,7 @@
-const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
 const require_url = require("./url-BqlldzT8.cjs");
+const require_jsonld = require("./jsonld-CmDhHNTx.cjs");
 let node_test = require("node:test");
 let node_assert = require("node:assert");
-let jsonld_dist_jsonld_esm_js = require("jsonld/dist/jsonld.esm.js");
-jsonld_dist_jsonld_esm_js = require_rolldown_runtime.__toESM(jsonld_dist_jsonld_esm_js, 1);
-//#region src/jsonld.ts
-var jsonld_default = jsonld_dist_jsonld_esm_js.default;
-//#endregion
 //#region src/internal/jsonld-cache.ts
 const noJsonLdContext = Symbol("noJsonLdContext");
 /**
@@ -121,7 +116,7 @@ async function compactJsonLdCache(normalized, original, documentLoader, depth =
 	const ownContext = getOwnJsonLdContext(original);
 	const context = ownContext === noJsonLdContext ? inheritedContext : ownContext;
 	if (context == null) return preserveNoContextJsonLdShape(normalized, original, depth);
-	return await preserveJsonLdShape(await mergeUnmappedTerms(await jsonld_default.compact(Array.isArray(normalized) && normalized.length === 1 ? normalized[0] : normalized, context, { documentLoader }), original, context, documentLoader), original, context, documentLoader, depth);
+	return await preserveJsonLdShape(await mergeUnmappedTerms(await require_jsonld.jsonld_default.compact(Array.isArray(normalized) && normalized.length === 1 ? normalized[0] : normalized, context, { documentLoader }), original, context, documentLoader), original, context, documentLoader, depth);
 }
 function preserveNoContextJsonLdShape(normalized, original, depth = 0) {
 	if (depth > 32) return normalized;
@@ -184,11 +179,11 @@ async function mergeUnmappedTerms(compacted, original, context, documentLoader)
 		"@context": context,
 		...compacted
 	} : compacted;
-	const compactedTerms = getTopLevelTerms(await jsonld_default.expand(compactedWithContext, { documentLoader }));
+	const compactedTerms = getTopLevelTerms(await require_jsonld.jsonld_default.expand(compactedWithContext, { documentLoader }));
 	const dummyPrefix = "urn:fedify:dummy:";
 	const dummy = { "@context": context };
 	for (let i = 0; i < unmappedKeys.length; i++) defineJsonLdProperty(dummy, unmappedKeys[i], `${dummyPrefix}${i}`);
-	const expanded = await jsonld_default.expand(dummy, { documentLoader });
+	const expanded = await require_jsonld.jsonld_default.expand(dummy, { documentLoader });
 	const representedKeys = /* @__PURE__ */ new Set();
 	const nodes = Array.isArray(expanded) ? expanded : [expanded];
 	for (const node of nodes) {
@@ -267,8 +262,8 @@ async function compactWithEmptyContext(compacted, context, documentLoader) {
 		"@context": context,
 		...compacted
 	} : compacted;
-	const expanded = await jsonld_default.expand(compactedWithContext, { documentLoader });
-	return await jsonld_default.compact(expanded, {}, { documentLoader });
+	const expanded = await require_jsonld.jsonld_default.expand(compactedWithContext, { documentLoader });
+	return await require_jsonld.jsonld_default.compact(expanded, {}, { documentLoader });
 }
 function combineContexts(inheritedContext, ownContext) {
 	if (ownContext === noJsonLdContext || ownContext === inheritedContext) return inheritedContext;
@@ -322,7 +317,7 @@ function combineContexts(inheritedContext, ownContext) {
 		"https://www.w3.org/ns/activitystreams#attributedTo": [{ "@id": "ap://did:key:z6Mkabc/actor" }],
 		"https://www.w3.org/ns/activitystreams#content": [{ "@value": "No-context object shape should stay cached." }]
 	};
-	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id", "https://www.w3.org/ns/activitystreams#attributedTo"])), original), {
+	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id", "https://www.w3.org/ns/activitystreams#attributedTo"])), original), {
 		"@id": "ap+ef61://did:key:z6Mkabc/objects/1",
 		"@type": ["https://www.w3.org/ns/activitystreams#Note"],
 		"https://www.w3.org/ns/activitystreams#attributedTo": [{ "@id": "ap+ef61://did:key:z6Mkabc/actor" }],
@@ -343,7 +338,7 @@ function combineContexts(inheritedContext, ownContext) {
 			name: "Nested object"
 		}]
 	};
-	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
+	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@id": "ap+ef61://did:key:z6Mkabc/objects/1",
 		"@type": ["https://www.w3.org/ns/activitystreams#Note"],
 		"https://www.w3.org/ns/activitystreams#attachment": [{
@@ -390,7 +385,7 @@ function combineContexts(inheritedContext, ownContext) {
 			extra: "This nested unmapped property should stay cached."
 		}
 	};
-	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
+	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@context": context,
 		type: "as:Note",
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
@@ -422,7 +417,7 @@ function combineContexts(inheritedContext, ownContext) {
 			extra
 		}
 	};
-	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original);
+	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original);
 	(0, node_assert.strictEqual)(compacted.rootExtra, rootExtra);
 	(0, node_assert.strictEqual)(compacted.attachment.extra, extra);
 });
@@ -443,7 +438,7 @@ function combineContexts(inheritedContext, ownContext) {
 		configurable: true,
 		writable: true
 	});
-	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original);
+	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original);
 	(0, node_assert.strictEqual)(globalThis.Object.getOwnPropertyDescriptor(compacted, "__proto__")?.value, protoValue);
 	(0, node_assert.strictEqual)(globalThis.Object.getPrototypeOf(compacted), Object.prototype);
 });
@@ -470,7 +465,7 @@ function combineContexts(inheritedContext, ownContext) {
 		configurable: true,
 		writable: true
 	});
-	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original);
+	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original);
 	const protoDescriptor = globalThis.Object.getOwnPropertyDescriptor(compacted, "__proto__");
 	(0, node_assert.ok)(protoDescriptor?.value === "Alias represented by the compacted term." || Array.isArray(protoDescriptor?.value) && protoDescriptor.value.includes("Alias represented by the compacted term."));
 	(0, node_assert.strictEqual)(protoDescriptor?.enumerable, true);
@@ -500,7 +495,7 @@ function combineContexts(inheritedContext, ownContext) {
 			title: "Nested title."
 		}
 	};
-	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
+	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@context": context,
 		type: "as:Note",
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
@@ -532,7 +527,7 @@ function combineContexts(inheritedContext, ownContext) {
 			title: "Nested title."
 		}
 	};
-	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
+	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@context": context,
 		type: "as:Note",
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
@@ -560,7 +555,7 @@ function combineContexts(inheritedContext, ownContext) {
 			"https://example.com/ns#title": "Absolute title."
 		}
 	};
-	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
+	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@context": context,
 		type: "as:Note",
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
@@ -599,7 +594,7 @@ function combineContexts(inheritedContext, ownContext) {
 			actorRef: "ap://did:key:z6Mkabc/actor"
 		}
 	};
-	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id", "https://www.w3.org/ns/activitystreams#actor"])), original), {
+	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id", "https://www.w3.org/ns/activitystreams#actor"])), original), {
 		"@context": context,
 		type: "as:Note",
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
@@ -633,7 +628,7 @@ function combineContexts(inheritedContext, ownContext) {
 		key9: "Extension 9",
 		key10: "Alias represented by the compacted term."
 	};
-	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
+	(0, node_assert.deepStrictEqual)(await compactJsonLdCache(normalizeJsonLdIris(await require_jsonld.jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@context": context,
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
 		key0: "Extension 0",

package/dist/tests/jsonld-cache.test.mjs

@@ -1,10 +1,7 @@
 import { a as formatIri, c as haveSameFe34Origin, l as haveSameIriOrigin, m as parseIri } from "./url-DgJM9WJn.mjs";
+import { t as jsonld_default } from "./jsonld-DweIJ07b.mjs";
 import { test } from "node:test";
 import { deepStrictEqual, ok, strictEqual } from "node:assert";
-import jsonld from "jsonld/dist/jsonld.esm.js";
-//#region src/jsonld.ts
-var jsonld_default = jsonld;
-//#endregion
 //#region src/internal/jsonld-cache.ts
 const noJsonLdContext = Symbol("noJsonLdContext");
 /**

package/dist/tests/{request-eP_YLVjb.mjs → request-Bbg1-1C3.mjs}

@@ -1,7 +1,7 @@
 import process from "node:process";
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.4.0-dev.2035+d1f8f8e2";
+var version = "2.4.0-dev.2054+1756e190";
 //#endregion
 //#region src/request.ts
 /**
@@ -31,6 +31,12 @@ var FetchError = class extends Error {
 	}
 };
 /**
+* The `Accept` header value for fetching ActivityPub objects.  ActivityPub
+* and FEP-ef61 gateways require the ActivityStreams profile on the JSON-LD
+* media type.
+*/
+const ACTIVITYPUB_ACCEPT = "application/activity+json, application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"";
+/**
 * Creates a request for the given URL.
 * @param url The URL to create the request for.
 * @param options The options for the request.
@@ -40,7 +46,7 @@ var FetchError = class extends Error {
 function createActivityPubRequest(url, options = {}) {
 	return new Request(url, {
 		headers: {
-			Accept: "application/activity+json, application/ld+json",
+			Accept: ACTIVITYPUB_ACCEPT,
 			"User-Agent": typeof options.userAgent === "string" ? options.userAgent : getUserAgent(options.userAgent)
 		},
 		redirect: "manual"

package/dist/tests/{request-BbczASfn.cjs → request-CcifKcqU.cjs}

@@ -3,7 +3,7 @@ let node_process = require("node:process");
 node_process = require_rolldown_runtime.__toESM(node_process, 1);
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.4.0-dev.2035+d1f8f8e2";
+var version = "2.4.0-dev.2054+1756e190";
 //#endregion
 //#region src/request.ts
 /**
@@ -33,6 +33,12 @@ var FetchError = class extends Error {
 	}
 };
 /**
+* The `Accept` header value for fetching ActivityPub objects.  ActivityPub
+* and FEP-ef61 gateways require the ActivityStreams profile on the JSON-LD
+* media type.
+*/
+const ACTIVITYPUB_ACCEPT = "application/activity+json, application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"";
+/**
 * Creates a request for the given URL.
 * @param url The URL to create the request for.
 * @param options The options for the request.
@@ -42,7 +48,7 @@ var FetchError = class extends Error {
 function createActivityPubRequest(url, options = {}) {
 	return new Request(url, {
 		headers: {
-			Accept: "application/activity+json, application/ld+json",
+			Accept: ACTIVITYPUB_ACCEPT,
 			"User-Agent": typeof options.userAgent === "string" ? options.userAgent : getUserAgent(options.userAgent)
 		},
 		redirect: "manual"

package/dist/tests/request.test.cjs

@@ -1,5 +1,5 @@
 const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
-const require_request = require("./request-BbczASfn.cjs");
+const require_request = require("./request-CcifKcqU.cjs");
 let node_test = require("node:test");
 let node_process = require("node:process");
 node_process = require_rolldown_runtime.__toESM(node_process, 1);
@@ -40,4 +40,7 @@ let node_assert = require("node:assert");
 		}), `MyApp/1.0.0 (Fedify/${require_request.version}; Node.js/${node_process.default.versions.node}; +https://example.com/)`);
 	}
 });
+(0, node_test.test)("createActivityPubRequest() asks for the ActivityStreams profile", () => {
+	(0, node_assert.deepStrictEqual)(require_request.createActivityPubRequest("https://example.com/object").headers.get("Accept"), "application/activity+json, application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"");
+});
 //#endregion

package/dist/tests/request.test.mjs

@@ -1,4 +1,4 @@
-import { o as version, r as getUserAgent } from "./request-eP_YLVjb.mjs";
+import { n as createActivityPubRequest, o as version, r as getUserAgent } from "./request-Bbg1-1C3.mjs";
 import { test } from "node:test";
 import process from "node:process";
 import { deepStrictEqual } from "node:assert";
@@ -38,5 +38,8 @@ test("getUserAgent()", () => {
 		}), `MyApp/1.0.0 (Fedify/${version}; Node.js/${process.versions.node}; +https://example.com/)`);
 	}
 });
+test("createActivityPubRequest() asks for the ActivityStreams profile", () => {
+	deepStrictEqual(createActivityPubRequest("https://example.com/object").headers.get("Accept"), "application/activity+json, application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"");
+});
 //#endregion
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.4.0-dev.2035+d1f8f8e2",
+  "version": "2.4.0-dev.2054+1756e190",
   "homepage": "https://fedify.dev/",
   "repository": {
     "type": "git",
@@ -52,6 +52,16 @@
       "require": "./dist/internal/jsonld-cache.cjs",
       "default": "./dist/internal/jsonld-cache.js"
     },
+    "./internal/portable-dereference": {
+      "types": {
+        "import": "./dist/internal/portable-dereference.d.ts",
+        "require": "./dist/internal/portable-dereference.d.cts",
+        "default": "./dist/internal/portable-dereference.d.ts"
+      },
+      "import": "./dist/internal/portable-dereference.js",
+      "require": "./dist/internal/portable-dereference.cjs",
+      "default": "./dist/internal/portable-dereference.js"
+    },
     "./internal/signed-representation": {
       "types": {
         "import": "./dist/internal/signed-representation.d.ts",

package/src/internal/portable-dereference.test.ts

@@ -0,0 +1,74 @@
+import { deepStrictEqual, ok, throws } from "node:assert/strict";
+import { test } from "node:test";
+import { parseIri } from "../url.ts";
+import {
+  getPortableGatewayCandidates,
+  isPortableIri,
+} from "./portable-dereference.ts";
+
+const hrefs = (urls: URL[]) => 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" +
+        "&%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/`),
+  );
+});