@fedify/vocab-runtime 2.4.0-dev.2247 → 2.4.0-dev.2256

package/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.4.0-dev.2247+4fe1b8c3",
+  "version": "2.4.0-dev.2256+683c50ba",
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts",

package/dist/internal/jsonld-cache.cjs

@@ -3,6 +3,24 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_url = require("../url-DKA6dTWV.cjs");
 const require_jsonld = require("../jsonld.cjs");
 //#region src/internal/jsonld-cache.ts
+/**
+* Reads expanded gateways, including an unmapped term on portable actors.
+* The original values and their order are preserved for URL validation by
+* the caller.  An explicitly mapped FEP-ef61 property always takes precedence.
+* @internal Used by generated vocabulary classes and portable proof checks.
+*/
+function getPortableActorGateways(node, allowUnmapped = true) {
+	const property = "https://w3id.org/fep/ef61/gateways";
+	if (globalThis.Object.hasOwn(node, property)) return Array.isArray(node[property]) ? node[property] : void 0;
+	if (!allowUnmapped || typeof node["@id"] !== "string" || !("http://www.w3.org/ns/ldp#inbox" in node) || !("https://www.w3.org/ns/activitystreams#outbox" in node)) return void 0;
+	try {
+		if (!require_url.getFe34Origin(require_url.parseIri(require_url.fromCompatibleEf61Id(node["@id"]) ?? node["@id"])).startsWith("did:")) return void 0;
+	} catch (error) {
+		if (error instanceof TypeError) return void 0;
+		throw error;
+	}
+	return Array.isArray(node["_:gateways"]) ? node["_:gateways"] : void 0;
+}
 const noJsonLdContext = Symbol("noJsonLdContext");
 const documentLoaderWrappers = /* @__PURE__ */ new WeakMap();
 /**
@@ -323,6 +341,7 @@ function combineContexts(inheritedContext, ownContext) {
 exports.compactJsonLdCache = compactJsonLdCache;
 exports.createScopedContextLoader = createScopedContextLoader;
 exports.getJsonLdContext = getJsonLdContext;
+exports.getPortableActorGateways = getPortableActorGateways;
 exports.isTrustedIriOrigin = isTrustedIriOrigin;
 exports.normalizeJsonLdIris = normalizeJsonLdIris;
 exports.registerDocumentLoaderWrapper = registerDocumentLoaderWrapper;

package/dist/internal/jsonld-cache.d.cts

@@ -3,6 +3,13 @@ import { n as DocumentLoader } from "../docloader-C63enuyr.cjs";
 
 //#region src/internal/jsonld-cache.d.ts
 /**
+* Reads expanded gateways, including an unmapped term on portable actors.
+* The original values and their order are preserved for URL validation by
+* the caller.  An explicitly mapped FEP-ef61 property always takes precedence.
+* @internal Used by generated vocabulary classes and portable proof checks.
+*/
+declare function getPortableActorGateways(node: Record<string, unknown>, allowUnmapped?: boolean): unknown[] | undefined;
+/**
 * Registers a loader wrapper with the shared released-wrapper registry.
 * Both suppression and snapshot wrappers must use this registry so mixed
 * chains can be unwrapped.  The caller updates the state on release.
@@ -71,4 +78,4 @@ declare function getJsonLdContext(value: unknown, depth?: number): unknown;
 */
 declare function compactJsonLdCache(normalized: unknown, original: unknown, documentLoader?: DocumentLoader, depth?: number, inheritedContext?: unknown): Promise<unknown>;
 //#endregion
-export { IriTrustOptions, compactJsonLdCache, createScopedContextLoader, getJsonLdContext, isTrustedIriOrigin, normalizeJsonLdIris, registerDocumentLoaderWrapper, unwrapReleasedDocumentLoader };
+export { IriTrustOptions, compactJsonLdCache, createScopedContextLoader, getJsonLdContext, getPortableActorGateways, isTrustedIriOrigin, normalizeJsonLdIris, registerDocumentLoaderWrapper, unwrapReleasedDocumentLoader };

package/dist/internal/jsonld-cache.d.ts

@@ -3,6 +3,13 @@ import { n as DocumentLoader } from "../docloader-C63enuyr.js";
 
 //#region src/internal/jsonld-cache.d.ts
 /**
+* Reads expanded gateways, including an unmapped term on portable actors.
+* The original values and their order are preserved for URL validation by
+* the caller.  An explicitly mapped FEP-ef61 property always takes precedence.
+* @internal Used by generated vocabulary classes and portable proof checks.
+*/
+declare function getPortableActorGateways(node: Record<string, unknown>, allowUnmapped?: boolean): unknown[] | undefined;
+/**
 * Registers a loader wrapper with the shared released-wrapper registry.
 * Both suppression and snapshot wrappers must use this registry so mixed
 * chains can be unwrapped.  The caller updates the state on release.
@@ -71,4 +78,4 @@ declare function getJsonLdContext(value: unknown, depth?: number): unknown;
 */
 declare function compactJsonLdCache(normalized: unknown, original: unknown, documentLoader?: DocumentLoader, depth?: number, inheritedContext?: unknown): Promise<unknown>;
 //#endregion
-export { IriTrustOptions, compactJsonLdCache, createScopedContextLoader, getJsonLdContext, isTrustedIriOrigin, normalizeJsonLdIris, registerDocumentLoaderWrapper, unwrapReleasedDocumentLoader };
+export { IriTrustOptions, compactJsonLdCache, createScopedContextLoader, getJsonLdContext, getPortableActorGateways, isTrustedIriOrigin, normalizeJsonLdIris, registerDocumentLoaderWrapper, unwrapReleasedDocumentLoader };

package/dist/internal/jsonld-cache.js

@@ -1,7 +1,25 @@
 
-import { d as haveSameIriOrigin, o as formatIri, u as haveSameFe34Origin } from "../url-Cr9lJ6cD.js";
+import { _ as parseIri, c as getFe34Origin, d as haveSameIriOrigin, o as formatIri, s as fromCompatibleEf61Id, u as haveSameFe34Origin } from "../url-Cr9lJ6cD.js";
 import jsonld_default from "../jsonld.js";
 //#region src/internal/jsonld-cache.ts
+/**
+* Reads expanded gateways, including an unmapped term on portable actors.
+* The original values and their order are preserved for URL validation by
+* the caller.  An explicitly mapped FEP-ef61 property always takes precedence.
+* @internal Used by generated vocabulary classes and portable proof checks.
+*/
+function getPortableActorGateways(node, allowUnmapped = true) {
+	const property = "https://w3id.org/fep/ef61/gateways";
+	if (globalThis.Object.hasOwn(node, property)) return Array.isArray(node[property]) ? node[property] : void 0;
+	if (!allowUnmapped || typeof node["@id"] !== "string" || !("http://www.w3.org/ns/ldp#inbox" in node) || !("https://www.w3.org/ns/activitystreams#outbox" in node)) return void 0;
+	try {
+		if (!getFe34Origin(parseIri(fromCompatibleEf61Id(node["@id"]) ?? node["@id"])).startsWith("did:")) return void 0;
+	} catch (error) {
+		if (error instanceof TypeError) return void 0;
+		throw error;
+	}
+	return Array.isArray(node["_:gateways"]) ? node["_:gateways"] : void 0;
+}
 const noJsonLdContext = Symbol("noJsonLdContext");
 const documentLoaderWrappers = /* @__PURE__ */ new WeakMap();
 /**
@@ -319,4 +337,4 @@ function combineContexts(inheritedContext, ownContext) {
 	return [...inherited, ...own];
 }
 //#endregion
-export { compactJsonLdCache, createScopedContextLoader, getJsonLdContext, isTrustedIriOrigin, normalizeJsonLdIris, registerDocumentLoaderWrapper, unwrapReleasedDocumentLoader };
+export { compactJsonLdCache, createScopedContextLoader, getJsonLdContext, getPortableActorGateways, isTrustedIriOrigin, normalizeJsonLdIris, registerDocumentLoaderWrapper, unwrapReleasedDocumentLoader };

package/dist/mod.cjs

@@ -16,7 +16,7 @@ let _multiformats_base_x = require("@multiformats/base-x");
 _multiformats_base_x = require_rolldown_runtime.__toESM(_multiformats_base_x, 1);
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.4.0-dev.2247+4fe1b8c3";
+var version = "2.4.0-dev.2256+683c50ba";
 //#endregion
 //#region src/request.ts
 /**

package/dist/mod.js

@@ -12,7 +12,7 @@ import { PublicKeyInfo } from "pkijs";
 import baseX from "@multiformats/base-x";
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.4.0-dev.2247+4fe1b8c3";
+var version = "2.4.0-dev.2256+683c50ba";
 //#endregion
 //#region src/request.ts
 /**

package/dist/tests/{body-EkRcWtjc.cjs → body-ILOzDJe-.cjs}

@@ -1,4 +1,4 @@
-const require_request = require("./request-Cemb1TON.cjs");
+const require_request = require("./request-BE3wHjK4.cjs");
 let _logtape_logtape = require("@logtape/logtape");
 //#region src/body.ts
 /** Decoded JSON body limit: 16 MiB.  @internal */

package/dist/tests/{body-CVAgeOnY.mjs → body-NALc-7u_.mjs}

@@ -1,4 +1,4 @@
-import { t as FetchError } from "./request-D9hlYelF.mjs";
+import { t as FetchError } from "./request-DkiHcgVt.mjs";
 import { getLogger } from "@logtape/logtape";
 //#region src/body.ts
 /** Decoded JSON body limit: 16 MiB.  @internal */

package/dist/tests/body.test.cjs

@@ -1,4 +1,4 @@
-const require_body = require("./body-EkRcWtjc.cjs");
+const require_body = require("./body-ILOzDJe-.cjs");
 let node_assert_strict = require("node:assert/strict");
 let node_test = require("node:test");
 let node_zlib = require("node:zlib");

package/dist/tests/body.test.mjs

@@ -1,4 +1,4 @@
-import { i as readBoundedText, t as BodyTooLargeError } from "./body-CVAgeOnY.mjs";
+import { i as readBoundedText, t as BodyTooLargeError } from "./body-NALc-7u_.mjs";
 import { deepStrictEqual, ok, rejects } from "node:assert/strict";
 import { test } from "node:test";
 import { gunzipSync, gzipSync } from "node:zlib";

package/dist/tests/decimal.test.cjs

@@ -1,10 +1,10 @@
 require("./url-Ddeuv0sE.cjs");
-require("./docloader-Dqn63h7z.cjs");
+require("./docloader-CZ-W5dIM.cjs");
 require("./key-C-AYkdJJ.cjs");
 require("./multibase-B5Mea7Ip.cjs");
 require("./digest-3FeH2Y-Q.cjs");
 require("./langstr-C4Fl80ae.cjs");
-require("./portable-media-CJz3xZPL.cjs");
+require("./portable-media-HeXeBuyd.cjs");
 let node_test = require("node:test");
 let node_assert = require("node:assert");
 //#region src/decimal.ts

package/dist/tests/decimal.test.mjs

@@ -1,10 +1,10 @@
 import "./url-ClVBNQup.mjs";
-import "./docloader-Dh5FI5cc.mjs";
+import "./docloader-PCF1uReU.mjs";
 import "./key-C2Db_TAJ.mjs";
 import "./multibase-BPnF_L4e.mjs";
 import "./digest-COC7xDiQ.mjs";
 import "./langstr-CQ26J_L7.mjs";
-import "./portable-media-Ch4q22fg.mjs";
+import "./portable-media-SWj7DacP.mjs";
 import { test } from "node:test";
 import { deepStrictEqual, throws } from "node:assert";
 //#region src/decimal.ts

package/dist/tests/{docloader-Dqn63h7z.cjs → docloader-CZ-W5dIM.cjs}

@@ -1,5 +1,5 @@
-const require_request = require("./request-Cemb1TON.cjs");
-const require_body = require("./body-EkRcWtjc.cjs");
+const require_request = require("./request-BE3wHjK4.cjs");
+const require_body = require("./body-ILOzDJe-.cjs");
 const require_contexts = require("./contexts-DizzBjz4.cjs");
 const require_link = require("./link-DlKm8bEr.cjs");
 const require_url = require("./url-Ddeuv0sE.cjs");

package/dist/tests/{docloader-Dh5FI5cc.mjs → docloader-PCF1uReU.mjs}

@@ -1,5 +1,5 @@
-import { a as name, i as logRequest, n as createActivityPubRequest, o as version, t as FetchError } from "./request-D9hlYelF.mjs";
-import { i as readBoundedText, n as MAX_BODY_SIZE, r as readBoundedBytes, t as BodyTooLargeError } from "./body-CVAgeOnY.mjs";
+import { a as name, i as logRequest, n as createActivityPubRequest, o as version, t as FetchError } from "./request-DkiHcgVt.mjs";
+import { i as readBoundedText, n as MAX_BODY_SIZE, r as readBoundedBytes, t as BodyTooLargeError } from "./body-NALc-7u_.mjs";
 import { t as preloadedContexts } from "./contexts-CIKsin4e.mjs";
 import { t as HttpHeaderLink } from "./link-Cevmc87v.mjs";
 import { n as UrlError, x as validatePublicUrl } from "./url-ClVBNQup.mjs";

package/dist/tests/docloader.test.cjs

@@ -1,8 +1,8 @@
 const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
-const require_request = require("./request-Cemb1TON.cjs");
+const require_request = require("./request-BE3wHjK4.cjs");
 const require_contexts = require("./contexts-DizzBjz4.cjs");
 const require_url = require("./url-Ddeuv0sE.cjs");
-const require_docloader = require("./docloader-Dqn63h7z.cjs");
+const require_docloader = require("./docloader-CZ-W5dIM.cjs");
 let node_zlib = require("node:zlib");
 let _logtape_logtape = require("@logtape/logtape");
 let node_assert = require("node:assert");

package/dist/tests/docloader.test.mjs

@@ -1,7 +1,7 @@
-import { t as FetchError } from "./request-D9hlYelF.mjs";
+import { t as FetchError } from "./request-DkiHcgVt.mjs";
 import { n as cid_v1_default, t as preloadedContexts } from "./contexts-CIKsin4e.mjs";
 import { n as UrlError } from "./url-ClVBNQup.mjs";
-import { i as withDocumentLoaderTimeout, n as getRemoteDocument, r as resolveDocumentLoaderTimeout, t as getDocumentLoader } from "./docloader-Dh5FI5cc.mjs";
+import { i as withDocumentLoaderTimeout, n as getRemoteDocument, r as resolveDocumentLoaderTimeout, t as getDocumentLoader } from "./docloader-PCF1uReU.mjs";
 import { gzipSync } from "node:zlib";
 import { configure, reset } from "@logtape/logtape";
 import { deepStrictEqual, ok, rejects, throws } from "node:assert";

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

@@ -1,6 +1,6 @@
 const require_url = require("../url-Ddeuv0sE.cjs");
-const require_jsonld_cache = require("../jsonld-cache-ChlXnADf.cjs");
-const require_portable_dereference = require("../portable-dereference-CmEBkIwk.cjs");
+const require_jsonld_cache = require("../jsonld-cache-CMzevnnN.cjs");
+const require_portable_dereference = require("../portable-dereference-BCfSQoXP.cjs");
 let node_assert_strict = require("node:assert/strict");
 let node_test = require("node:test");
 //#region src/internal/portable-dereference.test.ts

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

@@ -1,6 +1,6 @@
 import { S as withGatewayHints, _ as parseIri } from "../url-ClVBNQup.mjs";
-import { n as createScopedContextLoader } from "../jsonld-cache-Clt08GtO.mjs";
-import { n as getPortableGatewayCandidates, r as isPortableIri, t as createSnapshotContextLoader } from "../portable-dereference-BPUyWeZd.mjs";
+import { n as createScopedContextLoader } from "../jsonld-cache-DCh2kTs6.mjs";
+import { n as getPortableGatewayCandidates, r as isPortableIri, t as createSnapshotContextLoader } from "../portable-dereference-EAbEhAJ4.mjs";
 import { deepStrictEqual, ok, throws } from "node:assert/strict";
 import { test } from "node:test";
 //#region src/internal/portable-dereference.test.ts

package/dist/tests/{jsonld-cache-ChlXnADf.cjs → jsonld-cache-CMzevnnN.cjs}

@@ -6,6 +6,24 @@ jsonld_dist_jsonld_esm_js = require_rolldown_runtime.__toESM(jsonld_dist_jsonld_
 var jsonld_default = jsonld_dist_jsonld_esm_js.default;
 //#endregion
 //#region src/internal/jsonld-cache.ts
+/**
+* Reads expanded gateways, including an unmapped term on portable actors.
+* The original values and their order are preserved for URL validation by
+* the caller.  An explicitly mapped FEP-ef61 property always takes precedence.
+* @internal Used by generated vocabulary classes and portable proof checks.
+*/
+function getPortableActorGateways(node, allowUnmapped = true) {
+	const property = "https://w3id.org/fep/ef61/gateways";
+	if (globalThis.Object.hasOwn(node, property)) return Array.isArray(node[property]) ? node[property] : void 0;
+	if (!allowUnmapped || typeof node["@id"] !== "string" || !("http://www.w3.org/ns/ldp#inbox" in node) || !("https://www.w3.org/ns/activitystreams#outbox" in node)) return void 0;
+	try {
+		if (!require_url.getFe34Origin(require_url.parseIri(require_url.fromCompatibleEf61Id(node["@id"]) ?? node["@id"])).startsWith("did:")) return void 0;
+	} catch (error) {
+		if (error instanceof TypeError) return void 0;
+		throw error;
+	}
+	return Array.isArray(node["_:gateways"]) ? node["_:gateways"] : void 0;
+}
 const noJsonLdContext = Symbol("noJsonLdContext");
 const documentLoaderWrappers = /* @__PURE__ */ new WeakMap();
 /**
@@ -341,6 +359,12 @@ Object.defineProperty(exports, "getJsonLdContext", {
 		return getJsonLdContext;
 	}
 });
+Object.defineProperty(exports, "getPortableActorGateways", {
+	enumerable: true,
+	get: function() {
+		return getPortableActorGateways;
+	}
+});
 Object.defineProperty(exports, "isTrustedIriOrigin", {
 	enumerable: true,
 	get: function() {

package/dist/tests/{jsonld-cache-Clt08GtO.mjs → jsonld-cache-DCh2kTs6.mjs}

@@ -1,9 +1,27 @@
-import { d as haveSameIriOrigin, o as formatIri, u as haveSameFe34Origin } from "./url-ClVBNQup.mjs";
+import { _ as parseIri, c as getFe34Origin, d as haveSameIriOrigin, o as formatIri, s as fromCompatibleEf61Id, u as haveSameFe34Origin } from "./url-ClVBNQup.mjs";
 import jsonld from "jsonld/dist/jsonld.esm.js";
 //#region src/jsonld.ts
 var jsonld_default = jsonld;
 //#endregion
 //#region src/internal/jsonld-cache.ts
+/**
+* Reads expanded gateways, including an unmapped term on portable actors.
+* The original values and their order are preserved for URL validation by
+* the caller.  An explicitly mapped FEP-ef61 property always takes precedence.
+* @internal Used by generated vocabulary classes and portable proof checks.
+*/
+function getPortableActorGateways(node, allowUnmapped = true) {
+	const property = "https://w3id.org/fep/ef61/gateways";
+	if (globalThis.Object.hasOwn(node, property)) return Array.isArray(node[property]) ? node[property] : void 0;
+	if (!allowUnmapped || typeof node["@id"] !== "string" || !("http://www.w3.org/ns/ldp#inbox" in node) || !("https://www.w3.org/ns/activitystreams#outbox" in node)) return void 0;
+	try {
+		if (!getFe34Origin(parseIri(fromCompatibleEf61Id(node["@id"]) ?? node["@id"])).startsWith("did:")) return void 0;
+	} catch (error) {
+		if (error instanceof TypeError) return void 0;
+		throw error;
+	}
+	return Array.isArray(node["_:gateways"]) ? node["_:gateways"] : void 0;
+}
 const noJsonLdContext = Symbol("noJsonLdContext");
 const documentLoaderWrappers = /* @__PURE__ */ new WeakMap();
 /**
@@ -321,4 +339,4 @@ function combineContexts(inheritedContext, ownContext) {
 	return [...inherited, ...own];
 }
 //#endregion
-export { normalizeJsonLdIris as a, jsonld_default as c, isTrustedIriOrigin as i, createScopedContextLoader as n, registerDocumentLoaderWrapper as o, getJsonLdContext as r, unwrapReleasedDocumentLoader as s, compactJsonLdCache as t };
+export { isTrustedIriOrigin as a, unwrapReleasedDocumentLoader as c, getPortableActorGateways as i, jsonld_default as l, createScopedContextLoader as n, normalizeJsonLdIris as o, getJsonLdContext as r, registerDocumentLoaderWrapper as s, compactJsonLdCache as t };

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

@@ -1,8 +1,87 @@
 const require_url = require("./url-Ddeuv0sE.cjs");
-const require_jsonld_cache = require("./jsonld-cache-ChlXnADf.cjs");
+const require_jsonld_cache = require("./jsonld-cache-CMzevnnN.cjs");
 let node_test = require("node:test");
 let node_assert = require("node:assert");
 //#region src/jsonld-cache.test.ts
+(0, node_test.test)("getPortableActorGateways() preserves unmapped portable actor gateways", () => {
+	const gateways = [
+		{ "@value": "https://second.example" },
+		{ "@value": "https://first.example" },
+		{ "@value": "not a valid gateway" }
+	];
+	for (const id of [
+		"ap://did:key:z6Mkabc/actor",
+		"ap+ef61://did:key:z6Mkabc/actor",
+		"https://gateway.example/.well-known/apgateway/did:key:z6Mkabc/actor"
+	]) {
+		const node = {
+			"@id": id,
+			"http://www.w3.org/ns/ldp#inbox": [{ "@id": `${id}/inbox` }],
+			"https://www.w3.org/ns/activitystreams#outbox": [{ "@id": `${id}/outbox` }],
+			"_:gateways": gateways
+		};
+		const original = structuredClone(node);
+		(0, node_assert.strictEqual)(require_jsonld_cache.getPortableActorGateways(node), gateways, id);
+		(0, node_assert.strictEqual)(require_jsonld_cache.getPortableActorGateways(node, false), void 0, id);
+		(0, node_assert.deepStrictEqual)(node, original);
+	}
+});
+(0, node_test.test)("getPortableActorGateways() gives mapped gateways precedence", () => {
+	const canonical = "https://w3id.org/fep/ef61/gateways";
+	const gateways = [{ "@list": [{ "@id": "https://gateway.example" }] }];
+	const node = {
+		"@id": "ap://did:key:z6Mkabc/actor",
+		"http://www.w3.org/ns/ldp#inbox": [],
+		"https://www.w3.org/ns/activitystreams#outbox": [],
+		"_:gateways": [{ "@value": "https://other.example" }],
+		[canonical]: gateways
+	};
+	(0, node_assert.strictEqual)(require_jsonld_cache.getPortableActorGateways(node), gateways);
+	(0, node_assert.strictEqual)(require_jsonld_cache.getPortableActorGateways(node, false), gateways);
+	for (const value of [
+		void 0,
+		null,
+		{},
+		"https://gateway.example",
+		[]
+	]) {
+		node[canonical] = value;
+		(0, node_assert.strictEqual)(require_jsonld_cache.getPortableActorGateways(node), Array.isArray(value) ? value : void 0);
+	}
+});
+(0, node_test.test)("getPortableActorGateways() limits unmapped terms to portable actors", () => {
+	const node = {
+		"@id": "ap://did:key:z6Mkabc/actor",
+		"http://www.w3.org/ns/ldp#inbox": [],
+		"https://www.w3.org/ns/activitystreams#outbox": [],
+		"_:gateways": [{ "@value": "https://gateway.example" }]
+	};
+	for (const id of [
+		void 0,
+		1,
+		"not an IRI",
+		"https://ordinary.example/actor",
+		"https://gateway.example/.well-known/apgateway/not-a-did/actor",
+		"https://user@gateway.example/.well-known/apgateway/did:key:z6Mkabc/actor"
+	]) (0, node_assert.strictEqual)(require_jsonld_cache.getPortableActorGateways({
+		...node,
+		"@id": id
+	}), void 0);
+	for (const property of ["http://www.w3.org/ns/ldp#inbox", "https://www.w3.org/ns/activitystreams#outbox"]) {
+		const nonActor = { ...node };
+		delete nonActor[property];
+		(0, node_assert.strictEqual)(require_jsonld_cache.getPortableActorGateways(nonActor), void 0);
+	}
+	(0, node_assert.strictEqual)(require_jsonld_cache.getPortableActorGateways({
+		...node,
+		"_:gateways": null
+	}), void 0);
+	const empty = [];
+	(0, node_assert.strictEqual)(require_jsonld_cache.getPortableActorGateways({
+		...node,
+		"_:gateways": empty
+	}), empty);
+});
 (0, node_test.test)("isTrustedIriOrigin() trusts same portable IRI origins", () => {
 	(0, node_assert.ok)(require_jsonld_cache.isTrustedIriOrigin({}, require_url.parseIri("ap://did:key:z6Mkabc/actor"), require_url.parseIri("ap+ef61://did:key:z6Mkabc/outbox")));
 	(0, node_assert.ok)(!require_jsonld_cache.isTrustedIriOrigin({}, require_url.parseIri("ap://did:key:z6Mkabc/actor"), require_url.parseIri("ap://did:key:z6Mkdef/outbox")));

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

@@ -1,8 +1,87 @@
 import { _ as parseIri } from "./url-ClVBNQup.mjs";
-import { a as normalizeJsonLdIris, c as jsonld_default, i as isTrustedIriOrigin, r as getJsonLdContext, t as compactJsonLdCache } from "./jsonld-cache-Clt08GtO.mjs";
+import { a as isTrustedIriOrigin, i as getPortableActorGateways, l as jsonld_default, o as normalizeJsonLdIris, r as getJsonLdContext, t as compactJsonLdCache } from "./jsonld-cache-DCh2kTs6.mjs";
 import { test } from "node:test";
 import { deepStrictEqual, ok, strictEqual } from "node:assert";
 //#region src/jsonld-cache.test.ts
+test("getPortableActorGateways() preserves unmapped portable actor gateways", () => {
+	const gateways = [
+		{ "@value": "https://second.example" },
+		{ "@value": "https://first.example" },
+		{ "@value": "not a valid gateway" }
+	];
+	for (const id of [
+		"ap://did:key:z6Mkabc/actor",
+		"ap+ef61://did:key:z6Mkabc/actor",
+		"https://gateway.example/.well-known/apgateway/did:key:z6Mkabc/actor"
+	]) {
+		const node = {
+			"@id": id,
+			"http://www.w3.org/ns/ldp#inbox": [{ "@id": `${id}/inbox` }],
+			"https://www.w3.org/ns/activitystreams#outbox": [{ "@id": `${id}/outbox` }],
+			"_:gateways": gateways
+		};
+		const original = structuredClone(node);
+		strictEqual(getPortableActorGateways(node), gateways, id);
+		strictEqual(getPortableActorGateways(node, false), void 0, id);
+		deepStrictEqual(node, original);
+	}
+});
+test("getPortableActorGateways() gives mapped gateways precedence", () => {
+	const canonical = "https://w3id.org/fep/ef61/gateways";
+	const gateways = [{ "@list": [{ "@id": "https://gateway.example" }] }];
+	const node = {
+		"@id": "ap://did:key:z6Mkabc/actor",
+		"http://www.w3.org/ns/ldp#inbox": [],
+		"https://www.w3.org/ns/activitystreams#outbox": [],
+		"_:gateways": [{ "@value": "https://other.example" }],
+		[canonical]: gateways
+	};
+	strictEqual(getPortableActorGateways(node), gateways);
+	strictEqual(getPortableActorGateways(node, false), gateways);
+	for (const value of [
+		void 0,
+		null,
+		{},
+		"https://gateway.example",
+		[]
+	]) {
+		node[canonical] = value;
+		strictEqual(getPortableActorGateways(node), Array.isArray(value) ? value : void 0);
+	}
+});
+test("getPortableActorGateways() limits unmapped terms to portable actors", () => {
+	const node = {
+		"@id": "ap://did:key:z6Mkabc/actor",
+		"http://www.w3.org/ns/ldp#inbox": [],
+		"https://www.w3.org/ns/activitystreams#outbox": [],
+		"_:gateways": [{ "@value": "https://gateway.example" }]
+	};
+	for (const id of [
+		void 0,
+		1,
+		"not an IRI",
+		"https://ordinary.example/actor",
+		"https://gateway.example/.well-known/apgateway/not-a-did/actor",
+		"https://user@gateway.example/.well-known/apgateway/did:key:z6Mkabc/actor"
+	]) strictEqual(getPortableActorGateways({
+		...node,
+		"@id": id
+	}), void 0);
+	for (const property of ["http://www.w3.org/ns/ldp#inbox", "https://www.w3.org/ns/activitystreams#outbox"]) {
+		const nonActor = { ...node };
+		delete nonActor[property];
+		strictEqual(getPortableActorGateways(nonActor), void 0);
+	}
+	strictEqual(getPortableActorGateways({
+		...node,
+		"_:gateways": null
+	}), void 0);
+	const empty = [];
+	strictEqual(getPortableActorGateways({
+		...node,
+		"_:gateways": empty
+	}), empty);
+});
 test("isTrustedIriOrigin() trusts same portable IRI origins", () => {
 	ok(isTrustedIriOrigin({}, parseIri("ap://did:key:z6Mkabc/actor"), parseIri("ap+ef61://did:key:z6Mkabc/outbox")));
 	ok(!isTrustedIriOrigin({}, parseIri("ap://did:key:z6Mkabc/actor"), parseIri("ap://did:key:z6Mkdef/outbox")));

package/dist/tests/{portable-dereference-CmEBkIwk.cjs → portable-dereference-BCfSQoXP.cjs}

@@ -1,6 +1,6 @@
 const require_contexts = require("./contexts-DizzBjz4.cjs");
 const require_url = require("./url-Ddeuv0sE.cjs");
-const require_jsonld_cache = require("./jsonld-cache-ChlXnADf.cjs");
+const require_jsonld_cache = require("./jsonld-cache-CMzevnnN.cjs");
 let _logtape_logtape = require("@logtape/logtape");
 require("@opentelemetry/api");
 //#region src/internal/portable-dereference.ts

package/dist/tests/{portable-dereference-BPUyWeZd.mjs → portable-dereference-EAbEhAJ4.mjs}

@@ -1,6 +1,6 @@
 import { t as preloadedContexts } from "./contexts-CIKsin4e.mjs";
 import { h as parseGatewayOrigin, o as formatIri, t as GATEWAY_HINT_PARAMETER } from "./url-ClVBNQup.mjs";
-import { o as registerDocumentLoaderWrapper, s as unwrapReleasedDocumentLoader } from "./jsonld-cache-Clt08GtO.mjs";
+import { c as unwrapReleasedDocumentLoader, s as registerDocumentLoaderWrapper } from "./jsonld-cache-DCh2kTs6.mjs";
 import { getLogger } from "@logtape/logtape";
 import "@opentelemetry/api";
 //#region src/internal/portable-dereference.ts

package/dist/tests/{portable-media-CJz3xZPL.cjs → portable-media-HeXeBuyd.cjs}

@@ -1,5 +1,5 @@
-const require_request = require("./request-Cemb1TON.cjs");
-const require_body = require("./body-EkRcWtjc.cjs");
+const require_request = require("./request-BE3wHjK4.cjs");
+const require_body = require("./body-ILOzDJe-.cjs");
 const require_url = require("./url-Ddeuv0sE.cjs");
 const require_digest = require("./digest-3FeH2Y-Q.cjs");
 //#region src/portable-media.ts

package/dist/tests/{portable-media-Ch4q22fg.mjs → portable-media-SWj7DacP.mjs}

@@ -1,5 +1,5 @@
-import { r as getUserAgent } from "./request-D9hlYelF.mjs";
-import { r as readBoundedBytes } from "./body-CVAgeOnY.mjs";
+import { r as getUserAgent } from "./request-DkiHcgVt.mjs";
+import { r as readBoundedBytes } from "./body-NALc-7u_.mjs";
 import { g as parseGatewayUrl, x as validatePublicUrl } from "./url-ClVBNQup.mjs";
 import { a as verifyDigestMultibase, i as parseHashlink, r as parseDigestMultibase } from "./digest-COC7xDiQ.mjs";
 //#region src/portable-media.ts

package/dist/tests/portable-media.test.cjs

@@ -1,5 +1,5 @@
 const require_digest = require("./digest-3FeH2Y-Q.cjs");
-const require_portable_media = require("./portable-media-CJz3xZPL.cjs");
+const require_portable_media = require("./portable-media-HeXeBuyd.cjs");
 let node_assert_strict = require("node:assert/strict");
 let node_test = require("node:test");
 let node_http = require("node:http");

package/dist/tests/portable-media.test.mjs

@@ -1,5 +1,5 @@
 import { n as createHashlink, t as computeDigestMultibase } from "./digest-COC7xDiQ.mjs";
-import { t as fetchPortableMedia } from "./portable-media-Ch4q22fg.mjs";
+import { t as fetchPortableMedia } from "./portable-media-SWj7DacP.mjs";
 import { deepStrictEqual, equal, rejects } from "node:assert/strict";
 import { test } from "node:test";
 import { createServer } from "node:http";

package/dist/tests/portable-workers.test.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_url = require("./url-Ddeuv0sE.cjs");
 const require_key = require("./key-C-AYkdJJ.cjs");
 const require_digest = require("./digest-3FeH2Y-Q.cjs");
-const require_portable_dereference = require("./portable-dereference-CmEBkIwk.cjs");
+const require_portable_dereference = require("./portable-dereference-BCfSQoXP.cjs");
 let node_assert_strict = require("node:assert/strict");
 let _fedify_fixture = require("@fedify/fixture");
 //#region src/portable-workers.test.ts

package/dist/tests/portable-workers.test.mjs

@@ -1,7 +1,7 @@
 import { _ as parseIri, i as canonicalizePortableUri, o as formatIri, s as fromCompatibleEf61Id, y as toCompatibleEf61Id } from "./url-ClVBNQup.mjs";
 import { i as importDidKey, t as exportDidKey } from "./key-C2Db_TAJ.mjs";
 import { n as createHashlink, o as verifyHashlink, t as computeDigestMultibase } from "./digest-COC7xDiQ.mjs";
-import { n as getPortableGatewayCandidates } from "./portable-dereference-BPUyWeZd.mjs";
+import { n as getPortableGatewayCandidates } from "./portable-dereference-EAbEhAJ4.mjs";
 import { deepStrictEqual, equal } from "node:assert/strict";
 import { test, testDefinitions } from "@fedify/fixture";
 //#region src/portable-workers.test.ts

package/dist/tests/{request-Cemb1TON.cjs → request-BE3wHjK4.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.2247+4fe1b8c3";
+var version = "2.4.0-dev.2256+683c50ba";
 //#endregion
 //#region src/request.ts
 /**

package/dist/tests/{request-D9hlYelF.mjs → request-DkiHcgVt.mjs}

@@ -1,7 +1,7 @@
 import process from "node:process";
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.4.0-dev.2247+4fe1b8c3";
+var version = "2.4.0-dev.2256+683c50ba";
 //#endregion
 //#region src/request.ts
 /**

package/dist/tests/request.test.cjs

@@ -1,5 +1,5 @@
 const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
-const require_request = require("./request-Cemb1TON.cjs");
+const require_request = require("./request-BE3wHjK4.cjs");
 let node_test = require("node:test");
 let node_process = require("node:process");
 node_process = require_rolldown_runtime.__toESM(node_process, 1);

package/dist/tests/request.test.mjs

@@ -1,4 +1,4 @@
-import { n as createActivityPubRequest, o as version, r as getUserAgent } from "./request-D9hlYelF.mjs";
+import { n as createActivityPubRequest, o as version, r as getUserAgent } from "./request-DkiHcgVt.mjs";
 import { test } from "node:test";
 import process from "node:process";
 import { deepStrictEqual } from "node:assert";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.4.0-dev.2247+4fe1b8c3",
+  "version": "2.4.0-dev.2256+683c50ba",
   "homepage": "https://fedify.dev/",
   "repository": {
     "type": "git",

package/src/internal/jsonld-cache.ts

@@ -1,6 +1,42 @@
 import type { DocumentLoader } from "../docloader.ts";
 import jsonld from "../jsonld.ts";
-import { formatIri, haveSameFe34Origin, haveSameIriOrigin } from "../url.ts";
+import {
+  formatIri,
+  fromCompatibleEf61Id,
+  getFe34Origin,
+  haveSameFe34Origin,
+  haveSameIriOrigin,
+  parseIri,
+} from "../url.ts";
+
+/**
+ * Reads expanded gateways, including an unmapped term on portable actors.
+ * The original values and their order are preserved for URL validation by
+ * the caller.  An explicitly mapped FEP-ef61 property always takes precedence.
+ * @internal Used by generated vocabulary classes and portable proof checks.
+ */
+export function getPortableActorGateways(
+  node: Record<string, unknown>,
+  allowUnmapped = true,
+): unknown[] | undefined {
+  const property = "https://w3id.org/fep/ef61/gateways";
+  if (globalThis.Object.hasOwn(node, property)) {
+    return Array.isArray(node[property]) ? node[property] : undefined;
+  }
+  if (
+    !allowUnmapped || typeof node["@id"] !== "string" ||
+    !("http://www.w3.org/ns/ldp#inbox" in node) ||
+    !("https://www.w3.org/ns/activitystreams#outbox" in node)
+  ) return undefined;
+  try {
+    const id = fromCompatibleEf61Id(node["@id"]) ?? node["@id"];
+    if (!getFe34Origin(parseIri(id)).startsWith("did:")) return undefined;
+  } catch (error) {
+    if (error instanceof TypeError) return undefined;
+    throw error;
+  }
+  return Array.isArray(node["_:gateways"]) ? node["_:gateways"] : undefined;
+}
 
 const noJsonLdContext = Symbol("noJsonLdContext");
 

package/src/jsonld-cache.test.ts

@@ -3,12 +3,101 @@ import { test } from "node:test";
 import {
   compactJsonLdCache,
   getJsonLdContext,
+  getPortableActorGateways,
   isTrustedIriOrigin,
   normalizeJsonLdIris,
 } from "./internal/jsonld-cache.ts";
 import jsonld from "./jsonld.ts";
 import { parseIri } from "./url.ts";
 
+test("getPortableActorGateways() preserves unmapped portable actor gateways", () => {
+  const gateways = [
+    { "@value": "https://second.example" },
+    { "@value": "https://first.example" },
+    { "@value": "not a valid gateway" },
+  ];
+  const ids = [
+    "ap://did:key:z6Mkabc/actor",
+    "ap+ef61://did:key:z6Mkabc/actor",
+    "https://gateway.example/.well-known/apgateway/did:key:z6Mkabc/actor",
+  ];
+  for (const id of ids) {
+    const node = {
+      "@id": id,
+      "http://www.w3.org/ns/ldp#inbox": [{ "@id": `${id}/inbox` }],
+      "https://www.w3.org/ns/activitystreams#outbox": [
+        { "@id": `${id}/outbox` },
+      ],
+      "_:gateways": gateways,
+    };
+    const original = structuredClone(node);
+    strictEqual(getPortableActorGateways(node), gateways, id);
+    strictEqual(getPortableActorGateways(node, false), undefined, id);
+    deepStrictEqual(node, original);
+  }
+});
+
+test("getPortableActorGateways() gives mapped gateways precedence", () => {
+  const canonical = "https://w3id.org/fep/ef61/gateways";
+  const gateways = [{ "@list": [{ "@id": "https://gateway.example" }] }];
+  const node: Record<string, unknown> = {
+    "@id": "ap://did:key:z6Mkabc/actor",
+    "http://www.w3.org/ns/ldp#inbox": [],
+    "https://www.w3.org/ns/activitystreams#outbox": [],
+    "_:gateways": [{ "@value": "https://other.example" }],
+    [canonical]: gateways,
+  };
+  strictEqual(getPortableActorGateways(node), gateways);
+  strictEqual(getPortableActorGateways(node, false), gateways);
+  for (const value of [undefined, null, {}, "https://gateway.example", []]) {
+    node[canonical] = value;
+    strictEqual(
+      getPortableActorGateways(node),
+      Array.isArray(value) ? value : undefined,
+    );
+  }
+});
+
+test("getPortableActorGateways() limits unmapped terms to portable actors", () => {
+  const node: Record<string, unknown> = {
+    "@id": "ap://did:key:z6Mkabc/actor",
+    "http://www.w3.org/ns/ldp#inbox": [],
+    "https://www.w3.org/ns/activitystreams#outbox": [],
+    "_:gateways": [{ "@value": "https://gateway.example" }],
+  };
+  for (
+    const id of [
+      undefined,
+      1,
+      "not an IRI",
+      "https://ordinary.example/actor",
+      "https://gateway.example/.well-known/apgateway/not-a-did/actor",
+      "https://user@gateway.example/.well-known/apgateway/did:key:z6Mkabc/actor",
+    ]
+  ) {
+    strictEqual(getPortableActorGateways({ ...node, "@id": id }), undefined);
+  }
+  for (
+    const property of [
+      "http://www.w3.org/ns/ldp#inbox",
+      "https://www.w3.org/ns/activitystreams#outbox",
+    ]
+  ) {
+    const nonActor = { ...node };
+    delete nonActor[property];
+    strictEqual(getPortableActorGateways(nonActor), undefined);
+  }
+  strictEqual(
+    getPortableActorGateways({ ...node, "_:gateways": null }),
+    undefined,
+  );
+  const empty: unknown[] = [];
+  strictEqual(
+    getPortableActorGateways({ ...node, "_:gateways": empty }),
+    empty,
+  );
+});
+
 test("isTrustedIriOrigin() trusts same portable IRI origins", () => {
   ok(isTrustedIriOrigin(
     {},