@fedify/vocab-runtime 2.4.0-pr.936.41 → 2.4.1

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

@@ -1,282 +1,88 @@
-import { a as formatIri, c as haveSameIriOrigin, p as parseIri, s as haveSameFe34Origin } from "./url-Du7RQQgP.mjs";
-import { deepStrictEqual, ok, strictEqual } from "node:assert";
+import { _ as parseIri } from "./url-DMxmp7ZG.mjs";
+import { t as jsonld_default } from "./jsonld-DweIJ07b.mjs";
+import { a as isTrustedIriOrigin, i as getPortableActorGateways, o as normalizeJsonLdIris, r as getJsonLdContext, t as compactJsonLdCache } from "./jsonld-cache-DFnWsLuZ.mjs";
 import { test } from "node:test";
-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");
-/**
-* Checks whether an IRI is trusted relative to another 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 isTrustedIriOrigin(options, left, right) {
-	return options.crossOrigin === "trust" || left == null || right != null && (haveSameIriOrigin(left, right) || haveSameFe34Origin(left, right));
-}
-/**
-* Normalizes portable IRIs in JSON-LD cache data.
-*
-* @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 normalizeJsonLdIris(value, iriKeys, iriPattern = /^ap(?:\+ef61)?:\/\//i) {
-	return normalize(value, void 0, 0, void 0);
-	function isIriPosition(key, parentKey) {
-		return iriKeys.has(key) || (key === "@value" || key === "@list" || key === "@set") && parentKey != null && iriKeys.has(parentKey);
-	}
-	function arrayItemParentKey(key, parentKey) {
-		return key === "@list" || key === "@set" ? parentKey : key;
-	}
-	function entryParentKey(entryKey, key, parentKey) {
-		if (entryKey === "@list" || entryKey === "@set") return parentKey ?? key;
-		return key === "@list" || key === "@set" ? parentKey : key;
-	}
-	function normalize(value, key, depth = 0, parentKey) {
-		if (depth > 32 || key === "@context") return value;
-		if (typeof value === "string") {
-			if (key != null && isIriPosition(key, parentKey) && iriPattern.test(value)) try {
-				return formatIri(value);
-			} catch {
-				return value;
-			}
-			return value;
-		}
-		if (Array.isArray(value)) {
-			let clone;
-			const itemParentKey = arrayItemParentKey(key, parentKey);
-			for (let i = 0; i < value.length; i++) {
-				const result = normalize(value[i], key, depth + 1, itemParentKey);
-				if (result !== value[i]) {
-					clone ??= value.slice(0, i);
-					clone.push(result);
-				} else if (clone != null) clone.push(value[i]);
-			}
-			return clone ?? value;
-		}
-		if (value == null || typeof value !== "object") return value;
-		const object = value;
-		let clone;
-		for (const entryKey of globalThis.Object.keys(object)) {
-			const result = normalize(object[entryKey], entryKey, depth + 1, entryParentKey(entryKey, key, parentKey));
-			if (result !== object[entryKey]) {
-				clone ??= { ...object };
-				defineJsonLdProperty(clone, entryKey, result);
-			}
-		}
-		return clone ?? object;
-	}
-}
-/**
-* Finds the first JSON-LD context in a value.
-*
-* @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 getJsonLdContext(value, depth = 0) {
-	if (depth > 32) return void 0;
-	if (Array.isArray(value)) {
-		for (const item of value) {
-			const context = getJsonLdContext(item, depth + 1);
-			if (context !== void 0) return context;
-		}
-		return;
-	}
-	if (value == null || typeof value !== "object" || !("@context" in value)) return;
-	return value["@context"];
-}
-function getOwnJsonLdContext(value) {
-	if (value == null || typeof value !== "object" || Array.isArray(value) || !("@context" in value)) return noJsonLdContext;
-	return value["@context"];
-}
-/**
-* Recompacts normalized JSON-LD cache data against the original context.
-*
-* @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.
-*/
-async function compactJsonLdCache(normalized, original, documentLoader, depth = 0, inheritedContext) {
-	if (depth > 32) return normalized;
-	if (Array.isArray(original)) {
-		const normalizedArray = Array.isArray(normalized) ? normalized : normalized != null && typeof normalized === "object" && "@graph" in normalized && Array.isArray(normalized["@graph"]) ? normalized["@graph"] : void 0;
-		if (normalizedArray == null) return normalized;
-		let clone;
-		for (let i = 0; i < normalizedArray.length; i++) {
-			const item = await compactJsonLdCache(normalizedArray[i], original[i], documentLoader, depth + 1, inheritedContext);
-			if (item !== normalizedArray[i]) {
-				clone ??= normalizedArray.slice(0, i);
-				clone.push(item);
-			} else if (clone != null) clone.push(normalizedArray[i]);
-		}
-		return clone ?? (Array.isArray(normalized) ? normalized : normalizedArray);
-	}
-	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);
-}
-function preserveNoContextJsonLdShape(normalized, original, depth = 0) {
-	if (depth > 32) return normalized;
-	if (original == null || typeof original !== "object" || Array.isArray(original)) return normalized;
-	const normalizedObject = Array.isArray(normalized) && normalized.length === 1 ? normalized[0] : normalized;
-	if (normalizedObject == null || typeof normalizedObject !== "object" || Array.isArray(normalizedObject)) return normalized;
-	const source = normalizedObject;
-	const originalObject = original;
-	let clone;
-	for (const key of globalThis.Object.keys(originalObject)) {
-		if (!globalThis.Object.prototype.hasOwnProperty.call(source, key)) continue;
-		const value = preserveNoContextValue(source[key], originalObject[key], depth + 1);
-		if (value !== originalObject[key]) {
-			clone ??= { ...originalObject };
-			defineJsonLdProperty(clone, key, value);
-		}
-	}
-	return clone ?? original;
-}
-function preserveNoContextValue(normalized, original, depth) {
-	if (depth > 32) return normalized;
-	if (Array.isArray(original)) {
-		const normalizedArray = Array.isArray(normalized) ? normalized : [normalized];
-		let clone;
-		for (let i = 0; i < original.length; i++) {
-			const value = preserveNoContextValue(normalizedArray[i], original[i], depth + 1);
-			if (value !== original[i]) {
-				clone ??= original.slice(0, i);
-				clone.push(value);
-			} else if (clone != null) clone.push(original[i]);
-		}
-		return clone ?? original;
-	}
-	const normalizedValue = Array.isArray(normalized) ? normalized[0] : normalized;
-	if (normalizedValue == null || typeof normalizedValue !== "object" || Array.isArray(normalizedValue)) return normalizedValue;
-	const normalizedObject = normalizedValue;
-	if (original != null && typeof original === "object" && !Array.isArray(original)) return preserveNoContextJsonLdShape(normalizedObject, original, depth + 1);
-	if (typeof normalizedObject["@id"] === "string") return normalizedObject["@id"];
-	if ("@value" in normalizedObject) return normalizedObject["@value"];
-	return normalizedValue;
-}
-function getTopLevelTerms(value) {
-	const terms = /* @__PURE__ */ new Set();
-	const nodes = Array.isArray(value) ? value : [value];
-	for (const node of nodes) {
-		if (node == null || typeof node !== "object" || Array.isArray(node)) continue;
-		for (const key of globalThis.Object.keys(node)) {
-			if (key.startsWith("@")) continue;
-			terms.add(key);
-		}
-	}
-	return terms;
-}
-async function mergeUnmappedTerms(compacted, original, context, documentLoader) {
-	if (original == null || typeof original !== "object" || Array.isArray(original) || compacted == null || typeof compacted !== "object" || Array.isArray(compacted)) return compacted;
-	const unmappedKeys = globalThis.Object.keys(original).filter((key) => key !== "@context" && !globalThis.Object.prototype.hasOwnProperty.call(compacted, key));
-	if (unmappedKeys.length < 1) return compacted;
-	const result = { ...compacted };
-	const compactedWithContext = compacted != null && typeof compacted === "object" && !Array.isArray(compacted) && !("@context" in compacted) ? {
-		"@context": context,
-		...compacted
-	} : compacted;
-	const compactedTerms = getTopLevelTerms(await 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 representedKeys = /* @__PURE__ */ new Set();
-	const nodes = Array.isArray(expanded) ? expanded : [expanded];
-	for (const node of nodes) {
-		if (node == null || typeof node !== "object" || Array.isArray(node)) continue;
-		for (const [term, termValue] of globalThis.Object.entries(node)) {
-			if (!compactedTerms.has(term)) continue;
-			for (let i = 0; i < unmappedKeys.length; i++) if (containsValue(termValue, `${dummyPrefix}${i}`)) representedKeys.add(unmappedKeys[i]);
-		}
-	}
-	for (const key of unmappedKeys) if (!representedKeys.has(key)) defineJsonLdProperty(result, key, original[key]);
-	return result;
-}
-function defineJsonLdProperty(object, key, value) {
-	globalThis.Object.defineProperty(object, key, {
-		value,
-		enumerable: true,
-		configurable: true,
-		writable: true
-	});
-}
-function containsValue(value, expected, depth = 0) {
-	if (depth > 32) return false;
-	if (value === expected) return true;
-	if (Array.isArray(value)) return value.some((item) => containsValue(item, expected, depth + 1));
-	if (value == null || typeof value !== "object") return false;
-	return globalThis.Object.entries(value).some(([key, item]) => key !== "@context" && containsValue(item, expected, depth + 1));
-}
-async function preserveJsonLdShape(compacted, original, context, documentLoader, depth = 0) {
-	if (depth > 32) return compacted;
-	if (compacted === original) return compacted;
-	if (original == null || typeof original !== "object" || compacted == null || typeof compacted !== "object") return compacted;
-	if (Array.isArray(original)) {
-		const compactedArray = Array.isArray(compacted) ? compacted : "@graph" in compacted && Array.isArray(compacted["@graph"]) ? compacted["@graph"] : void 0;
-		if (compactedArray == null) return compacted;
-		let clone;
-		for (let i = 0; i < compactedArray.length; i++) {
-			const value = await preserveJsonLdShape(compactedArray[i], original[i], context, documentLoader, depth + 1);
-			const originalContext = original[i] != null && typeof original[i] === "object" && !Array.isArray(original[i]) && "@context" in original[i] ? original[i]["@context"] : void 0;
-			const shaped = originalContext !== void 0 && value != null && typeof value === "object" && !Array.isArray(value) && !("@context" in value) ? {
-				"@context": originalContext,
-				...value
-			} : value;
-			if (shaped !== compactedArray[i]) {
-				clone ??= compactedArray.slice(0, i);
-				clone.push(shaped);
-			} else if (clone != null) clone.push(compactedArray[i]);
-		}
-		return clone ?? (Array.isArray(compacted) ? compacted : compactedArray);
+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);
 	}
-	if (Array.isArray(compacted)) return compacted;
-	let clone;
-	const ownContext = getOwnJsonLdContext(original);
-	const objectContext = combineContexts(context, ownContext);
-	const objectCompacted = depth > 0 && ownContext === null ? await compactWithEmptyContext(compacted, context, documentLoader) : compacted;
-	const compactedObject = depth > 0 ? await mergeUnmappedTerms(objectCompacted, original, objectContext, documentLoader) : objectCompacted;
-	const originalObject = original;
-	for (const key of globalThis.Object.keys(compactedObject)) {
-		if (key === "@context") continue;
-		const value = await preserveJsonLdShape(compactedObject[key], originalObject[key], objectContext, documentLoader, depth + 1);
-		const shaped = Array.isArray(originalObject[key]) && !Array.isArray(value) ? [value] : value;
-		if (shaped !== compactedObject[key]) {
-			clone ??= { ...compactedObject };
-			defineJsonLdProperty(clone, key, shaped);
-		}
+});
+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);
 	}
-	if (depth > 0) {
-		if ("@context" in originalObject && !("@context" in compactedObject)) {
-			clone ??= { ...compactedObject };
-			clone["@context"] = originalObject["@context"];
-		}
+});
+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);
 	}
-	return clone ?? compactedObject;
-}
-async function compactWithEmptyContext(compacted, context, documentLoader) {
-	const compactedWithContext = compacted != null && typeof compacted === "object" && !Array.isArray(compacted) && !("@context" in compacted) ? {
-		"@context": context,
-		...compacted
-	} : compacted;
-	const expanded = await jsonld_default.expand(compactedWithContext, { documentLoader });
-	return await jsonld_default.compact(expanded, {}, { documentLoader });
-}
-function combineContexts(inheritedContext, ownContext) {
-	if (ownContext === noJsonLdContext || ownContext === inheritedContext) return inheritedContext;
-	if (ownContext == null) return ownContext;
-	const inherited = Array.isArray(inheritedContext) ? inheritedContext : [inheritedContext];
-	const own = Array.isArray(ownContext) ? ownContext : [ownContext];
-	return [...inherited, ...own];
-}
-//#endregion
-//#region src/jsonld-cache.test.ts
+	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")));
@@ -287,17 +93,17 @@ test("normalizeJsonLdIris() normalizes selected JSON-LD IRI positions", () => {
 		"@id": "ap://did:key:z6Mkabc/object",
 		"https://example.com/ns#ref": [{ "@value": "ap://did:key:z6Mkabc/ref" }],
 		"https://example.com/ns#text": [{ "@value": "ap://did:key:z6Mkabc/not-an-iri-position" }]
-	}, new Set(["@id", "https://example.com/ns#ref"])), {
+	}, /* @__PURE__ */ new Set(["@id", "https://example.com/ns#ref"])), {
 		"@id": "ap+ef61://did:key:z6Mkabc/object",
 		"https://example.com/ns#ref": [{ "@value": "ap+ef61://did:key:z6Mkabc/ref" }],
 		"https://example.com/ns#text": [{ "@value": "ap://did:key:z6Mkabc/not-an-iri-position" }]
 	});
 });
 test("normalizeJsonLdIris() preserves IRI context in list/set wrappers", () => {
-	deepStrictEqual(normalizeJsonLdIris({ "https://example.com/ns#ref": [{ "@list": [{ "@value": "ap://did:key:z6Mkabc/listed" }] }, { "@set": [{ "@value": "ap://did:key:z6Mkabc/set" }] }] }, new Set(["https://example.com/ns#ref"])), { "https://example.com/ns#ref": [{ "@list": [{ "@value": "ap+ef61://did:key:z6Mkabc/listed" }] }, { "@set": [{ "@value": "ap+ef61://did:key:z6Mkabc/set" }] }] });
+	deepStrictEqual(normalizeJsonLdIris({ "https://example.com/ns#ref": [{ "@list": [{ "@value": "ap://did:key:z6Mkabc/listed" }] }, { "@set": [{ "@value": "ap://did:key:z6Mkabc/set" }] }] }, /* @__PURE__ */ new Set(["https://example.com/ns#ref"])), { "https://example.com/ns#ref": [{ "@list": [{ "@value": "ap+ef61://did:key:z6Mkabc/listed" }] }, { "@set": [{ "@value": "ap+ef61://did:key:z6Mkabc/set" }] }] });
 });
 test("normalizeJsonLdIris() defines prototype-like keys safely", () => {
-	const iriKeys = new Set(["__proto__"]);
+	const iriKeys = /* @__PURE__ */ new Set(["__proto__"]);
 	const value = {};
 	globalThis.Object.defineProperty(value, "__proto__", {
 		value: "ap://did:key:z6Mkabc/object",
@@ -320,7 +126,7 @@ test("compactJsonLdCache() preserves no-context object shape", async () => {
 		"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." }]
 	};
-	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id", "https://www.w3.org/ns/activitystreams#attributedTo"])), original), {
+	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await 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" }],
@@ -341,7 +147,7 @@ test("compactJsonLdCache() ignores nested contexts for no-context parents", asyn
 			name: "Nested object"
 		}]
 	};
-	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id"])), original), {
+	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await 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": [{
@@ -388,7 +194,7 @@ test("compactJsonLdCache() preserves nested unmapped terms", async () => {
 			extra: "This nested unmapped property should stay cached."
 		}
 	};
-	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id"])), original), {
+	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@context": context,
 		type: "as:Note",
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
@@ -420,7 +226,7 @@ test("compactJsonLdCache() reuses unchanged unmapped values", async () => {
 			extra
 		}
 	};
-	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id"])), original);
+	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original);
 	strictEqual(compacted.rootExtra, rootExtra);
 	strictEqual(compacted.attachment.extra, extra);
 });
@@ -441,7 +247,7 @@ test("compactJsonLdCache() defines prototype-like unmapped keys safely", async (
 		configurable: true,
 		writable: true
 	});
-	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id"])), original);
+	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original);
 	strictEqual(globalThis.Object.getOwnPropertyDescriptor(compacted, "__proto__")?.value, protoValue);
 	strictEqual(globalThis.Object.getPrototypeOf(compacted), Object.prototype);
 });
@@ -468,7 +274,7 @@ test("compactJsonLdCache() checks prototype-like aliases safely", async () => {
 		configurable: true,
 		writable: true
 	});
-	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id"])), original);
+	const compacted = await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original);
 	const protoDescriptor = globalThis.Object.getOwnPropertyDescriptor(compacted, "__proto__");
 	ok(protoDescriptor?.value === "Alias represented by the compacted term." || Array.isArray(protoDescriptor?.value) && protoDescriptor.value.includes("Alias represented by the compacted term."));
 	strictEqual(protoDescriptor?.enumerable, true);
@@ -498,7 +304,7 @@ test("compactJsonLdCache() preserves nested contexts", async () => {
 			title: "Nested title."
 		}
 	};
-	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id"])), original), {
+	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@context": context,
 		type: "as:Note",
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
@@ -530,7 +336,7 @@ test("compactJsonLdCache() preserves nested array contexts", async () => {
 			title: "Nested title."
 		}
 	};
-	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id"])), original), {
+	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@context": context,
 		type: "as:Note",
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
@@ -558,7 +364,7 @@ test("compactJsonLdCache() preserves nested null contexts", async () => {
 			"https://example.com/ns#title": "Absolute title."
 		}
 	};
-	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id"])), original), {
+	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), /* @__PURE__ */ new Set(["@id"])), original), {
 		"@context": context,
 		type: "as:Note",
 		id: "ap+ef61://did:key:z6Mkabc/objects/1",
@@ -597,7 +403,7 @@ test("compactJsonLdCache() does not re-add represented nested aliases", async ()
 			actorRef: "ap://did:key:z6Mkabc/actor"
 		}
 	};
-	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id", "https://www.w3.org/ns/activitystreams#actor"])), original), {
+	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await 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",
@@ -631,7 +437,7 @@ test("compactJsonLdCache() does not confuse dummy marker prefixes", async () =>
 		key9: "Extension 9",
 		key10: "Alias represented by the compacted term."
 	};
-	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await jsonld_default.expand(original), new Set(["@id"])), original), {
+	deepStrictEqual(await compactJsonLdCache(normalizeJsonLdIris(await 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/{key-_wXwomh_.cjs → key-C-AYkdJJ.cjs}

@@ -1,6 +1,5 @@
-require("./chunk-C2EiDwsr.cjs");
-const require_multicodec = require("./multicodec-CxGVGa91.cjs");
-const require_multibase = require("./multibase-Bz_UUDtL.cjs");
+const require_multicodec = require("./multicodec-CLRPeW4N.cjs");
+const require_multibase = require("./multibase-B5Mea7Ip.cjs");
 let asn1js = require("asn1js");
 let byte_encodings_base64 = require("byte-encodings/base64");
 let byte_encodings_base64url = require("byte-encodings/base64url");
@@ -143,12 +142,20 @@ async function importDidKey(did) {
 /**
 * Exports an Ed25519 public key as a `did:key` DID.
 *
+* The DID is encoded in base58-btc with the Ed25519 multicodec prefix, e.g.,
+* `did:key:z6Mk...`, as [FEP-ef61] requires for the DIDs of portable
+* objects.
+*
+* [FEP-ef61]: https://w3id.org/fep/ef61
+*
 * @param key The Ed25519 public key.
 * @returns The `did:key` DID.
-* @throws {TypeError} If the key is invalid or unsupported.
+* @throws {TypeError} If the key is invalid or unsupported, or it is not
+*                     a public key.
 * @since 2.4.0
 */
 async function exportDidKey(key) {
+	if (key.type !== "public") throw new TypeError("The key must be a public key.");
 	if (key.algorithm.name !== "Ed25519") throw new TypeError("Unsupported key type: " + JSON.stringify(key.algorithm));
 	return DID_KEY_PREFIX + await exportMultibaseKey(key);
 }

package/dist/tests/{key-CDGDH_vC.mjs → key-C2Db_TAJ.mjs}

@@ -1,5 +1,5 @@
-import { n as getMulticodecPrefix, r as removeMulticodecPrefix, t as addMulticodecPrefix } from "./multicodec-CyFp54fI.mjs";
-import { n as encodeMultibase, t as decodeMultibase } from "./multibase-B4bvakyA.mjs";
+import { n as getMulticodecPrefix, r as removeMulticodecPrefix, t as addMulticodecPrefix } from "./multicodec-CRIj_05H.mjs";
+import { n as encodeMultibase, t as decodeMultibase } from "./multibase-BPnF_L4e.mjs";
 import { Integer, Sequence } from "asn1js";
 import { decodeBase64, encodeBase64 } from "byte-encodings/base64";
 import { decodeBase64Url } from "byte-encodings/base64url";
@@ -142,12 +142,20 @@ async function importDidKey(did) {
 /**
 * Exports an Ed25519 public key as a `did:key` DID.
 *
+* The DID is encoded in base58-btc with the Ed25519 multicodec prefix, e.g.,
+* `did:key:z6Mk...`, as [FEP-ef61] requires for the DIDs of portable
+* objects.
+*
+* [FEP-ef61]: https://w3id.org/fep/ef61
+*
 * @param key The Ed25519 public key.
 * @returns The `did:key` DID.
-* @throws {TypeError} If the key is invalid or unsupported.
+* @throws {TypeError} If the key is invalid or unsupported, or it is not
+*                     a public key.
 * @since 2.4.0
 */
 async function exportDidKey(key) {
+	if (key.type !== "public") throw new TypeError("The key must be a public key.");
 	if (key.algorithm.name !== "Ed25519") throw new TypeError("Unsupported key type: " + JSON.stringify(key.algorithm));
 	return DID_KEY_PREFIX + await exportMultibaseKey(key);
 }

package/dist/tests/key.test.cjs

@@ -1,9 +1,8 @@
-require("./chunk-C2EiDwsr.cjs");
-const require_multicodec = require("./multicodec-CxGVGa91.cjs");
-const require_key = require("./key-_wXwomh_.cjs");
-const require_multibase = require("./multibase-Bz_UUDtL.cjs");
-let node_assert = require("node:assert");
+const require_multicodec = require("./multicodec-CLRPeW4N.cjs");
+const require_key = require("./key-C-AYkdJJ.cjs");
+const require_multibase = require("./multibase-B5Mea7Ip.cjs");
 let node_test = require("node:test");
+let node_assert = require("node:assert");
 //#region src/key.test.ts
 const rsaSpki = "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxsRuvCkgJtflBTl4OVsm\nnt/J1mQfZasfJtN33dcZ3d1lJroxmgmMu69zjGEAwkNbMQaWNLqC4eogkJaeJ4RR\n5MHYXkL9nNilVoTkjX5BVit3puzs7XJ7WQnKQgQMI+ezn24GHsZ/v1JIo77lerX5\nk4HNwTNVt+yaZVQWaOMR3+6FwziQR6kd0VuG9/a9dgAnz2cEoORRC1i4W7IZaB1s\nZnh1WbHbevlGd72HSXll5rocPIHn8gq6xpBgpHwRphlRsgn4KHaJ6brXDIJjrnQh\nIe/YUBOGj/ImSEXhRwlFerKsoAVnZ0Hwbfa46qk44TAt8CyoPMWmpK6pt0ng4pQ2\nuwIDAQAB\n-----END PUBLIC KEY-----\n";
 const rsaPkcs1 = "-----BEGIN RSA PUBLIC KEY-----\nMIIBCgKCAQEAxsRuvCkgJtflBTl4OVsmnt/J1mQfZasfJtN33dcZ3d1lJroxmgmM\nu69zjGEAwkNbMQaWNLqC4eogkJaeJ4RR5MHYXkL9nNilVoTkjX5BVit3puzs7XJ7\nWQnKQgQMI+ezn24GHsZ/v1JIo77lerX5k4HNwTNVt+yaZVQWaOMR3+6FwziQR6kd\n0VuG9/a9dgAnz2cEoORRC1i4W7IZaB1sZnh1WbHbevlGd72HSXll5rocPIHn8gq6\nxpBgpHwRphlRsgn4KHaJ6brXDIJjrnQhIe/YUBOGj/ImSEXhRwlFerKsoAVnZ0Hw\nbfa46qk44TAt8CyoPMWmpK6pt0ng4pQ2uwIDAQAB\n-----END RSA PUBLIC KEY-----\n";
@@ -79,6 +78,8 @@ const ed25519Multibase = "z6MksHj1MJnidCtDiyYW9ugNFftoX9fLK4bornTxmMZ6X7vq";
 	(0, node_assert.deepStrictEqual)(await require_key.exportJwk(await require_key.importDidKey(new URL(did))), ed25519Jwk);
 	const rsaKey = await require_key.importJwk(rsaJwk, "public");
 	await (0, node_assert.rejects)(() => require_key.exportDidKey(rsaKey), TypeError);
+	const { privateKey } = await crypto.subtle.generateKey("Ed25519", true, ["sign", "verify"]);
+	await (0, node_assert.rejects)(() => require_key.exportDidKey(privateKey), /* @__PURE__ */ new TypeError("The key must be a public key."));
 	await (0, node_assert.rejects)(() => require_key.importDidKey(`did:key:${rsaMultibase}`), /* @__PURE__ */ new TypeError("Unsupported did:key type: 0x1205"));
 });
 (0, node_test.test)("parseDidKeyVerificationMethod()", async () => {

package/dist/tests/key.test.mjs

@@ -1,8 +1,8 @@
-import { t as addMulticodecPrefix } from "./multicodec-CyFp54fI.mjs";
-import { a as importMultibaseKey, c as importSpki, d as importJwk, i as importDidKey, l as parseDidKeyVerificationMethod, n as exportMultibaseKey, o as importPem, r as exportSpki, s as importPkcs1, t as exportDidKey, u as exportJwk } from "./key-CDGDH_vC.mjs";
-import { n as encodeMultibase } from "./multibase-B4bvakyA.mjs";
-import { deepStrictEqual, rejects } from "node:assert";
+import { t as addMulticodecPrefix } from "./multicodec-CRIj_05H.mjs";
+import { a as importMultibaseKey, c as importSpki, d as importJwk, i as importDidKey, l as parseDidKeyVerificationMethod, n as exportMultibaseKey, o as importPem, r as exportSpki, s as importPkcs1, t as exportDidKey, u as exportJwk } from "./key-C2Db_TAJ.mjs";
+import { n as encodeMultibase } from "./multibase-BPnF_L4e.mjs";
 import { test } from "node:test";
+import { deepStrictEqual, rejects } from "node:assert";
 //#region src/key.test.ts
 const rsaSpki = "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxsRuvCkgJtflBTl4OVsm\nnt/J1mQfZasfJtN33dcZ3d1lJroxmgmMu69zjGEAwkNbMQaWNLqC4eogkJaeJ4RR\n5MHYXkL9nNilVoTkjX5BVit3puzs7XJ7WQnKQgQMI+ezn24GHsZ/v1JIo77lerX5\nk4HNwTNVt+yaZVQWaOMR3+6FwziQR6kd0VuG9/a9dgAnz2cEoORRC1i4W7IZaB1s\nZnh1WbHbevlGd72HSXll5rocPIHn8gq6xpBgpHwRphlRsgn4KHaJ6brXDIJjrnQh\nIe/YUBOGj/ImSEXhRwlFerKsoAVnZ0Hwbfa46qk44TAt8CyoPMWmpK6pt0ng4pQ2\nuwIDAQAB\n-----END PUBLIC KEY-----\n";
 const rsaPkcs1 = "-----BEGIN RSA PUBLIC KEY-----\nMIIBCgKCAQEAxsRuvCkgJtflBTl4OVsmnt/J1mQfZasfJtN33dcZ3d1lJroxmgmM\nu69zjGEAwkNbMQaWNLqC4eogkJaeJ4RR5MHYXkL9nNilVoTkjX5BVit3puzs7XJ7\nWQnKQgQMI+ezn24GHsZ/v1JIo77lerX5k4HNwTNVt+yaZVQWaOMR3+6FwziQR6kd\n0VuG9/a9dgAnz2cEoORRC1i4W7IZaB1sZnh1WbHbevlGd72HSXll5rocPIHn8gq6\nxpBgpHwRphlRsgn4KHaJ6brXDIJjrnQhIe/YUBOGj/ImSEXhRwlFerKsoAVnZ0Hw\nbfa46qk44TAt8CyoPMWmpK6pt0ng4pQ2uwIDAQAB\n-----END RSA PUBLIC KEY-----\n";
@@ -78,6 +78,8 @@ test("exportDidKey() and importDidKey()", async () => {
 	deepStrictEqual(await exportJwk(await importDidKey(new URL(did))), ed25519Jwk);
 	const rsaKey = await importJwk(rsaJwk, "public");
 	await rejects(() => exportDidKey(rsaKey), TypeError);
+	const { privateKey } = await crypto.subtle.generateKey("Ed25519", true, ["sign", "verify"]);
+	await rejects(() => exportDidKey(privateKey), /* @__PURE__ */ new TypeError("The key must be a public key."));
 	await rejects(() => importDidKey(`did:key:${rsaMultibase}`), /* @__PURE__ */ new TypeError("Unsupported did:key type: 0x1205"));
 });
 test("parseDidKeyVerificationMethod()", async () => {

package/dist/tests/{langstr-Di5AvKpB.mjs → langstr-DYRmJqFn.mjs}

@@ -1,3 +1,4 @@
+import { t as normalizeLanguageTag } from "./langtag-CUppHs_s.mjs";
 //#region src/langstr.ts
 /**
 * A language-tagged string which corresponds to the `rdf:langString` type.
@@ -12,11 +13,13 @@ var LanguageString = class extends String {
 	* Constructs a new `LanguageString`.
 	* @param value A string value written in the given language.
 	* @param language The language of the string.  If a string is given, it will
-	*                 be parsed as a `Intl.Locale` object.
+	*                 be parsed as a `Intl.Locale` object.  Extended language
+	*                 subtags are normalized first, e.g., `zh-yue` is parsed as
+	*                 `yue`.
 	*/
 	constructor(value, language) {
 		super(value);
-		this.locale = typeof language === "string" ? new Intl.Locale(language) : language;
+		this.locale = typeof language === "string" ? new Intl.Locale(normalizeLanguageTag(language)) : language;
 	}
 };
 LanguageString.prototype[Symbol.for("Deno.customInspect")] = function(inspect, options) {

package/dist/tests/{langstr-CbAxaeEZ.cjs → langstr-_PqsL1ae.cjs}

@@ -1,3 +1,4 @@
+const require_langtag = require("./langtag-Czjvxfzx.cjs");
 //#region src/langstr.ts
 /**
 * A language-tagged string which corresponds to the `rdf:langString` type.
@@ -12,11 +13,13 @@ var LanguageString = class extends String {
 	* Constructs a new `LanguageString`.
 	* @param value A string value written in the given language.
 	* @param language The language of the string.  If a string is given, it will
-	*                 be parsed as a `Intl.Locale` object.
+	*                 be parsed as a `Intl.Locale` object.  Extended language
+	*                 subtags are normalized first, e.g., `zh-yue` is parsed as
+	*                 `yue`.
 	*/
 	constructor(value, language) {
 		super(value);
-		this.locale = typeof language === "string" ? new Intl.Locale(language) : language;
+		this.locale = typeof language === "string" ? new Intl.Locale(require_langtag.normalizeLanguageTag(language)) : language;
 	}
 };
 LanguageString.prototype[Symbol.for("Deno.customInspect")] = function(inspect, options) {