@fedify/vocab-runtime 2.1.24 → 2.1.25

package/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.1.24",
+  "version": "2.1.25",
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts",

package/dist/mod.cjs

@@ -6,6 +6,7 @@ let _opentelemetry_api = require("@opentelemetry/api");
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
 let node_dns_promises = require("node:dns/promises");
+node_dns_promises = require_chunk.__toESM(node_dns_promises);
 let node_net = require("node:net");
 let asn1js = require("asn1js");
 let byte_encodings_base64 = require("byte-encodings/base64");
@@ -599,6 +600,30 @@ var fep_5711_default = { "@context": {
 	}
 } };
 //#endregion
+//#region src/contexts/fep-7aa9.json
+var fep_7aa9_default = { "@context": {
+	"FeaturedCollection": "https://w3id.org/fep/7aa9#FeaturedCollection",
+	"FeaturedItem": "https://w3id.org/fep/7aa9#FeaturedItem",
+	"FeatureRequest": "https://w3id.org/fep/7aa9#FeatureRequest",
+	"FeatureAuthorization": "https://w3id.org/fep/7aa9#FeatureAuthorization",
+	"topic": {
+		"@id": "https://w3id.org/fep/7aa9#topic",
+		"@type": "@id"
+	},
+	"featuredObject": {
+		"@id": "https://w3id.org/fep/7aa9#featuredObject",
+		"@type": "@id"
+	},
+	"canFeature": {
+		"@id": "https://w3id.org/fep/7aa9#canFeature",
+		"@type": "@id"
+	},
+	"featureAuthorization": {
+		"@id": "https://w3id.org/fep/7aa9#featureAuthorization",
+		"@type": "@id"
+	}
+} };
+//#endregion
 //#region src/contexts/fep-ef61.json
 var fep_ef61_default = { "@context": {
 	"gateways": {
@@ -4516,6 +4541,7 @@ const preloadedContexts = {
 	"https://w3id.org/fep/5711": fep_5711_default,
 	"https://www.w3.org/ns/cid/v1": cid_v1_default,
 	"https://w3id.org/fep/ef61": fep_ef61_default,
+	"https://w3id.org/fep/7aa9": fep_7aa9_default,
 	"https://join-lemmy.org/context.json": join_lemmy_default,
 	"http://joinmastodon.org/ns": joinmastodon_default,
 	"https://purl.archive.org/miscellany": miscellany_default
@@ -4523,7 +4549,7 @@ const preloadedContexts = {
 //#endregion
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.1.24";
+var version = "2.1.25";
 //#endregion
 //#region src/request.ts
 /**
@@ -4852,9 +4878,16 @@ var HttpHeaderLink = class HttpHeaderLink {
 //#endregion
 //#region src/url.ts
 var UrlError = class extends Error {
+	/**
+	* The failure category. Defaults to `"disallowed"`.
+	* `"dns"` includes lookup errors and results with no usable IP addresses.
+	* @since 2.0.29
+	*/
+	reason;
 	constructor(message, options) {
 		super(message, options);
 		this.name = "UrlError";
+		this.reason = options?.reason ?? "disallowed";
 	}
 };
 /**
@@ -4880,9 +4913,12 @@ async function validatePublicUrl(url) {
 	}
 	let addresses;
 	try {
-		addresses = await (0, node_dns_promises.lookup)(hostname, { all: true });
+		addresses = await node_dns_promises.default.lookup(hostname, { all: true });
 	} catch (error) {
-		throw new UrlError("DNS lookup failed", { cause: error });
+		throw new UrlError("DNS lookup failed", {
+			cause: error,
+			reason: "dns"
+		});
 	}
 	validateLookupAddresses(addresses);
 }
@@ -4911,7 +4947,7 @@ function validateLookupAddresses(addresses) {
 		ipAddressCount++;
 		validatePublicIpAddress(address, family);
 	}
-	if (ipAddressCount === 0) throw new UrlError("DNS lookup did not return any IP address");
+	if (ipAddressCount === 0) throw new UrlError("DNS lookup did not return any IP address", { reason: "dns" });
 }
 function validatePublicIpAddress(address, family) {
 	if (family === 4 && isValidPublicIPv4Address(address) || family === 6 && isValidPublicIPv6Address(address)) return;
@@ -5147,6 +5183,8 @@ async function getRemoteDocument(url, response, fetch) {
 }
 /**
 * Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
+* At most 20 HTTP redirects and alternate document links are followed in total
+* per call.  Revisiting a URL within that chain throws a {@link FetchError}.
 *
 * The created loader preloads the below frequently used contexts by default
 * (unless `options.skipPreloadedContexts` is set to `true`):
@@ -5158,6 +5196,7 @@ async function getRemoteDocument(url, response, fetch) {
 * - <https://www.w3.org/ns/cid/v1>
 * - <https://w3id.org/security/multikey/v1>
 * - <https://w3id.org/fep/ef61>
+* - <https://w3id.org/fep/7aa9>
 * - <https://purl.archive.org/socialweb/webfinger>
 * - <http://schema.org/>
 * @param options Options for the document loader.
@@ -5180,7 +5219,11 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 		if (!allowPrivateAddress) try {
 			await validatePublicUrl(currentUrl);
 		} catch (error) {
-			if (error instanceof UrlError) logger.error("Disallowed private URL: {url}", {
+			if (error instanceof UrlError) if (error.reason === "dns") logger.debug("DNS lookup failed for {url}", {
+				url: currentUrl,
+				error
+			});
+			else logger.error("Disallowed private URL: {url}", {
 				url: currentUrl,
 				error
 			});
@@ -5218,7 +5261,12 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 					}
 					return await load(redirectUrl, options, redirected + 1, visited);
 				}
-				const result = await getRemoteDocument(currentUrl, response, load);
+				const result = await getRemoteDocument(currentUrl, response, async (alternateUrl) => {
+					options?.signal?.throwIfAborted();
+					if (redirected >= DEFAULT_MAX_REDIRECTION) throw new FetchError(currentUrl, `Too many redirections (${redirected + 1})`);
+					if (visited.has(alternateUrl)) throw new FetchError(currentUrl, `Redirect loop detected: ${alternateUrl}`);
+					return await load(alternateUrl, options, redirected + 1, visited);
+				});
 				span.setAttribute("docloader.document_url", result.documentUrl);
 				if (result.contextUrl != null) span.setAttribute("docloader.context_url", result.contextUrl);
 				return result;
@@ -5234,7 +5282,7 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 			}
 		});
 	}
-	return load;
+	return (url, options) => load(url, options);
 }
 //#endregion
 //#region src/internal/multicodec.ts

package/dist/mod.d.cts

@@ -174,6 +174,8 @@ interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
 }
 /**
 * Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
+* At most 20 HTTP redirects and alternate document links are followed in total
+* per call.  Revisiting a URL within that chain throws a {@link FetchError}.
 *
 * The created loader preloads the below frequently used contexts by default
 * (unless `options.skipPreloadedContexts` is set to `true`):
@@ -185,6 +187,7 @@ interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
 * - <https://www.w3.org/ns/cid/v1>
 * - <https://w3id.org/security/multikey/v1>
 * - <https://w3id.org/fep/ef61>
+* - <https://w3id.org/fep/7aa9>
 * - <https://purl.archive.org/socialweb/webfinger>
 * - <http://schema.org/>
 * @param options Options for the document loader.
@@ -419,8 +422,15 @@ declare function encodingFromBaseData(data: string | Uint8Array): Base;
 //#endregion
 //#region src/url.d.ts
 declare class UrlError extends Error {
+  /**
+  * The failure category. Defaults to `"disallowed"`.
+  * `"dns"` includes lookup errors and results with no usable IP addresses.
+  * @since 2.0.29
+  */
+  readonly reason: "dns" | "disallowed";
   constructor(message: string, options?: {
     cause?: unknown;
+    reason?: "dns" | "disallowed";
   });
 }
 /**

package/dist/mod.d.ts

@@ -173,6 +173,8 @@ interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
 }
 /**
 * Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
+* At most 20 HTTP redirects and alternate document links are followed in total
+* per call.  Revisiting a URL within that chain throws a {@link FetchError}.
 *
 * The created loader preloads the below frequently used contexts by default
 * (unless `options.skipPreloadedContexts` is set to `true`):
@@ -184,6 +186,7 @@ interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
 * - <https://www.w3.org/ns/cid/v1>
 * - <https://w3id.org/security/multikey/v1>
 * - <https://w3id.org/fep/ef61>
+* - <https://w3id.org/fep/7aa9>
 * - <https://purl.archive.org/socialweb/webfinger>
 * - <http://schema.org/>
 * @param options Options for the document loader.
@@ -418,8 +421,15 @@ declare function encodingFromBaseData(data: string | Uint8Array): Base;
 //#endregion
 //#region src/url.d.ts
 declare class UrlError extends Error {
+  /**
+  * The failure category. Defaults to `"disallowed"`.
+  * `"dns"` includes lookup errors and results with no usable IP addresses.
+  * @since 2.0.29
+  */
+  readonly reason: "dns" | "disallowed";
   constructor(message: string, options?: {
     cause?: unknown;
+    reason?: "dns" | "disallowed";
   });
 }
 /**

package/dist/mod.js

@@ -2,7 +2,7 @@
 import { getLogger } from "@logtape/logtape";
 import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 import process from "node:process";
-import { lookup } from "node:dns/promises";
+import dns from "node:dns/promises";
 import { isIP } from "node:net";
 import { Integer, Sequence } from "asn1js";
 import { decodeBase64, encodeBase64 } from "byte-encodings/base64";
@@ -595,6 +595,30 @@ var fep_5711_default = { "@context": {
 	}
 } };
 //#endregion
+//#region src/contexts/fep-7aa9.json
+var fep_7aa9_default = { "@context": {
+	"FeaturedCollection": "https://w3id.org/fep/7aa9#FeaturedCollection",
+	"FeaturedItem": "https://w3id.org/fep/7aa9#FeaturedItem",
+	"FeatureRequest": "https://w3id.org/fep/7aa9#FeatureRequest",
+	"FeatureAuthorization": "https://w3id.org/fep/7aa9#FeatureAuthorization",
+	"topic": {
+		"@id": "https://w3id.org/fep/7aa9#topic",
+		"@type": "@id"
+	},
+	"featuredObject": {
+		"@id": "https://w3id.org/fep/7aa9#featuredObject",
+		"@type": "@id"
+	},
+	"canFeature": {
+		"@id": "https://w3id.org/fep/7aa9#canFeature",
+		"@type": "@id"
+	},
+	"featureAuthorization": {
+		"@id": "https://w3id.org/fep/7aa9#featureAuthorization",
+		"@type": "@id"
+	}
+} };
+//#endregion
 //#region src/contexts/fep-ef61.json
 var fep_ef61_default = { "@context": {
 	"gateways": {
@@ -4512,6 +4536,7 @@ const preloadedContexts = {
 	"https://w3id.org/fep/5711": fep_5711_default,
 	"https://www.w3.org/ns/cid/v1": cid_v1_default,
 	"https://w3id.org/fep/ef61": fep_ef61_default,
+	"https://w3id.org/fep/7aa9": fep_7aa9_default,
 	"https://join-lemmy.org/context.json": join_lemmy_default,
 	"http://joinmastodon.org/ns": joinmastodon_default,
 	"https://purl.archive.org/miscellany": miscellany_default
@@ -4519,7 +4544,7 @@ const preloadedContexts = {
 //#endregion
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.1.24";
+var version = "2.1.25";
 //#endregion
 //#region src/request.ts
 /**
@@ -4848,9 +4873,16 @@ var HttpHeaderLink = class HttpHeaderLink {
 //#endregion
 //#region src/url.ts
 var UrlError = class extends Error {
+	/**
+	* The failure category. Defaults to `"disallowed"`.
+	* `"dns"` includes lookup errors and results with no usable IP addresses.
+	* @since 2.0.29
+	*/
+	reason;
 	constructor(message, options) {
 		super(message, options);
 		this.name = "UrlError";
+		this.reason = options?.reason ?? "disallowed";
 	}
 };
 /**
@@ -4876,9 +4908,12 @@ async function validatePublicUrl(url) {
 	}
 	let addresses;
 	try {
-		addresses = await lookup(hostname, { all: true });
+		addresses = await dns.lookup(hostname, { all: true });
 	} catch (error) {
-		throw new UrlError("DNS lookup failed", { cause: error });
+		throw new UrlError("DNS lookup failed", {
+			cause: error,
+			reason: "dns"
+		});
 	}
 	validateLookupAddresses(addresses);
 }
@@ -4907,7 +4942,7 @@ function validateLookupAddresses(addresses) {
 		ipAddressCount++;
 		validatePublicIpAddress(address, family);
 	}
-	if (ipAddressCount === 0) throw new UrlError("DNS lookup did not return any IP address");
+	if (ipAddressCount === 0) throw new UrlError("DNS lookup did not return any IP address", { reason: "dns" });
 }
 function validatePublicIpAddress(address, family) {
 	if (family === 4 && isValidPublicIPv4Address(address) || family === 6 && isValidPublicIPv6Address(address)) return;
@@ -5143,6 +5178,8 @@ async function getRemoteDocument(url, response, fetch) {
 }
 /**
 * Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
+* At most 20 HTTP redirects and alternate document links are followed in total
+* per call.  Revisiting a URL within that chain throws a {@link FetchError}.
 *
 * The created loader preloads the below frequently used contexts by default
 * (unless `options.skipPreloadedContexts` is set to `true`):
@@ -5154,6 +5191,7 @@ async function getRemoteDocument(url, response, fetch) {
 * - <https://www.w3.org/ns/cid/v1>
 * - <https://w3id.org/security/multikey/v1>
 * - <https://w3id.org/fep/ef61>
+* - <https://w3id.org/fep/7aa9>
 * - <https://purl.archive.org/socialweb/webfinger>
 * - <http://schema.org/>
 * @param options Options for the document loader.
@@ -5176,7 +5214,11 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 		if (!allowPrivateAddress) try {
 			await validatePublicUrl(currentUrl);
 		} catch (error) {
-			if (error instanceof UrlError) logger.error("Disallowed private URL: {url}", {
+			if (error instanceof UrlError) if (error.reason === "dns") logger.debug("DNS lookup failed for {url}", {
+				url: currentUrl,
+				error
+			});
+			else logger.error("Disallowed private URL: {url}", {
 				url: currentUrl,
 				error
 			});
@@ -5214,7 +5256,12 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 					}
 					return await load(redirectUrl, options, redirected + 1, visited);
 				}
-				const result = await getRemoteDocument(currentUrl, response, load);
+				const result = await getRemoteDocument(currentUrl, response, async (alternateUrl) => {
+					options?.signal?.throwIfAborted();
+					if (redirected >= DEFAULT_MAX_REDIRECTION) throw new FetchError(currentUrl, `Too many redirections (${redirected + 1})`);
+					if (visited.has(alternateUrl)) throw new FetchError(currentUrl, `Redirect loop detected: ${alternateUrl}`);
+					return await load(alternateUrl, options, redirected + 1, visited);
+				});
 				span.setAttribute("docloader.document_url", result.documentUrl);
 				if (result.contextUrl != null) span.setAttribute("docloader.context_url", result.contextUrl);
 				return result;
@@ -5230,7 +5277,7 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 			}
 		});
 	}
-	return load;
+	return (url, options) => load(url, options);
 }
 //#endregion
 //#region src/internal/multicodec.ts

package/dist/tests/{body-BWNGF5gy.cjs → body-D-gC5vdl.cjs}

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

package/dist/tests/{body-D_GduSEt.mjs → body-DBqFojnW.mjs}

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

package/dist/tests/body.test.cjs

@@ -1,5 +1,5 @@
 require("./chunk-Do9eywBl.cjs");
-const require_body = require("./body-BWNGF5gy.cjs");
+const require_body = require("./body-D-gC5vdl.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 { r as readBoundedText, t as BodyTooLargeError } from "./body-D_GduSEt.mjs";
+import { r as readBoundedText, t as BodyTooLargeError } from "./body-DBqFojnW.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,6 +1,6 @@
 require("./chunk-Do9eywBl.cjs");
-require("./docloader-CrsmzPTc.cjs");
-require("./url-CnyF489g.cjs");
+require("./docloader-fn4ICzFS.cjs");
+require("./url-vZTgkIZg.cjs");
 require("./key-BarKGLQz.cjs");
 require("./multibase-8zhYPa7o.cjs");
 require("./langstr-BOQHfJDr.cjs");

package/dist/tests/decimal.test.mjs

@@ -1,5 +1,5 @@
-import "./docloader-BBEZYcQU.mjs";
-import "./url-BBfduh6o.mjs";
+import "./docloader-Beoc8qTH.mjs";
+import "./url-3fyJuqC0.mjs";
 import "./key-BDIsC6hV.mjs";
 import "./multibase-Ds75BvXs.mjs";
 import "./langstr-DDLc4833.mjs";

package/dist/tests/{docloader-BBEZYcQU.mjs → docloader-Beoc8qTH.mjs}

@@ -1,7 +1,7 @@
-import { a as name, i as logRequest, n as createActivityPubRequest, o as version, t as FetchError } from "./request-CbVzw-Ce.mjs";
-import { n as MAX_BODY_SIZE, r as readBoundedText } from "./body-D_GduSEt.mjs";
+import { a as name, i as logRequest, n as createActivityPubRequest, o as version, t as FetchError } from "./request-DxeGyJVh.mjs";
+import { n as MAX_BODY_SIZE, r as readBoundedText } from "./body-DBqFojnW.mjs";
 import { t as HttpHeaderLink } from "./link-CYszIegt.mjs";
-import { o as validatePublicUrl, t as UrlError } from "./url-BBfduh6o.mjs";
+import { o as validatePublicUrl, t as UrlError } from "./url-3fyJuqC0.mjs";
 import { getLogger } from "@logtape/logtape";
 import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 //#region src/contexts/activitystreams.json
@@ -589,6 +589,30 @@ var fep_5711_default = { "@context": {
 	}
 } };
 //#endregion
+//#region src/contexts/fep-7aa9.json
+var fep_7aa9_default = { "@context": {
+	"FeaturedCollection": "https://w3id.org/fep/7aa9#FeaturedCollection",
+	"FeaturedItem": "https://w3id.org/fep/7aa9#FeaturedItem",
+	"FeatureRequest": "https://w3id.org/fep/7aa9#FeatureRequest",
+	"FeatureAuthorization": "https://w3id.org/fep/7aa9#FeatureAuthorization",
+	"topic": {
+		"@id": "https://w3id.org/fep/7aa9#topic",
+		"@type": "@id"
+	},
+	"featuredObject": {
+		"@id": "https://w3id.org/fep/7aa9#featuredObject",
+		"@type": "@id"
+	},
+	"canFeature": {
+		"@id": "https://w3id.org/fep/7aa9#canFeature",
+		"@type": "@id"
+	},
+	"featureAuthorization": {
+		"@id": "https://w3id.org/fep/7aa9#featureAuthorization",
+		"@type": "@id"
+	}
+} };
+//#endregion
 //#region src/contexts/fep-ef61.json
 var fep_ef61_default = { "@context": {
 	"gateways": {
@@ -4506,6 +4530,7 @@ const preloadedContexts = {
 	"https://w3id.org/fep/5711": fep_5711_default,
 	"https://www.w3.org/ns/cid/v1": cid_v1_default,
 	"https://w3id.org/fep/ef61": fep_ef61_default,
+	"https://w3id.org/fep/7aa9": fep_7aa9_default,
 	"https://join-lemmy.org/context.json": join_lemmy_default,
 	"http://joinmastodon.org/ns": joinmastodon_default,
 	"https://purl.archive.org/miscellany": miscellany_default
@@ -4608,6 +4633,8 @@ async function getRemoteDocument(url, response, fetch) {
 }
 /**
 * Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
+* At most 20 HTTP redirects and alternate document links are followed in total
+* per call.  Revisiting a URL within that chain throws a {@link FetchError}.
 *
 * The created loader preloads the below frequently used contexts by default
 * (unless `options.skipPreloadedContexts` is set to `true`):
@@ -4619,6 +4646,7 @@ async function getRemoteDocument(url, response, fetch) {
 * - <https://www.w3.org/ns/cid/v1>
 * - <https://w3id.org/security/multikey/v1>
 * - <https://w3id.org/fep/ef61>
+* - <https://w3id.org/fep/7aa9>
 * - <https://purl.archive.org/socialweb/webfinger>
 * - <http://schema.org/>
 * @param options Options for the document loader.
@@ -4641,7 +4669,11 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 		if (!allowPrivateAddress) try {
 			await validatePublicUrl(currentUrl);
 		} catch (error) {
-			if (error instanceof UrlError) logger.error("Disallowed private URL: {url}", {
+			if (error instanceof UrlError) if (error.reason === "dns") logger.debug("DNS lookup failed for {url}", {
+				url: currentUrl,
+				error
+			});
+			else logger.error("Disallowed private URL: {url}", {
 				url: currentUrl,
 				error
 			});
@@ -4679,7 +4711,12 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 					}
 					return await load(redirectUrl, options, redirected + 1, visited);
 				}
-				const result = await getRemoteDocument(currentUrl, response, load);
+				const result = await getRemoteDocument(currentUrl, response, async (alternateUrl) => {
+					options?.signal?.throwIfAborted();
+					if (redirected >= DEFAULT_MAX_REDIRECTION) throw new FetchError(currentUrl, `Too many redirections (${redirected + 1})`);
+					if (visited.has(alternateUrl)) throw new FetchError(currentUrl, `Redirect loop detected: ${alternateUrl}`);
+					return await load(alternateUrl, options, redirected + 1, visited);
+				});
 				span.setAttribute("docloader.document_url", result.documentUrl);
 				if (result.contextUrl != null) span.setAttribute("docloader.context_url", result.contextUrl);
 				return result;
@@ -4695,7 +4732,7 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 			}
 		});
 	}
-	return load;
+	return (url, options) => load(url, options);
 }
 //#endregion
 export { cid_v1_default as i, getRemoteDocument as n, preloadedContexts as r, getDocumentLoader as t };

package/dist/tests/{docloader-CrsmzPTc.cjs → docloader-fn4ICzFS.cjs}

@@ -1,8 +1,8 @@
 require("./chunk-Do9eywBl.cjs");
-const require_request = require("./request-xQEQeUO1.cjs");
-const require_body = require("./body-BWNGF5gy.cjs");
+const require_request = require("./request-DrO5xzev.cjs");
+const require_body = require("./body-D-gC5vdl.cjs");
 const require_link = require("./link-qDTmjPw_.cjs");
-const require_url = require("./url-CnyF489g.cjs");
+const require_url = require("./url-vZTgkIZg.cjs");
 let _logtape_logtape = require("@logtape/logtape");
 let _opentelemetry_api = require("@opentelemetry/api");
 //#region src/contexts/activitystreams.json
@@ -590,6 +590,30 @@ var fep_5711_default = { "@context": {
 	}
 } };
 //#endregion
+//#region src/contexts/fep-7aa9.json
+var fep_7aa9_default = { "@context": {
+	"FeaturedCollection": "https://w3id.org/fep/7aa9#FeaturedCollection",
+	"FeaturedItem": "https://w3id.org/fep/7aa9#FeaturedItem",
+	"FeatureRequest": "https://w3id.org/fep/7aa9#FeatureRequest",
+	"FeatureAuthorization": "https://w3id.org/fep/7aa9#FeatureAuthorization",
+	"topic": {
+		"@id": "https://w3id.org/fep/7aa9#topic",
+		"@type": "@id"
+	},
+	"featuredObject": {
+		"@id": "https://w3id.org/fep/7aa9#featuredObject",
+		"@type": "@id"
+	},
+	"canFeature": {
+		"@id": "https://w3id.org/fep/7aa9#canFeature",
+		"@type": "@id"
+	},
+	"featureAuthorization": {
+		"@id": "https://w3id.org/fep/7aa9#featureAuthorization",
+		"@type": "@id"
+	}
+} };
+//#endregion
 //#region src/contexts/fep-ef61.json
 var fep_ef61_default = { "@context": {
 	"gateways": {
@@ -4507,6 +4531,7 @@ const preloadedContexts = {
 	"https://w3id.org/fep/5711": fep_5711_default,
 	"https://www.w3.org/ns/cid/v1": cid_v1_default,
 	"https://w3id.org/fep/ef61": fep_ef61_default,
+	"https://w3id.org/fep/7aa9": fep_7aa9_default,
 	"https://join-lemmy.org/context.json": join_lemmy_default,
 	"http://joinmastodon.org/ns": joinmastodon_default,
 	"https://purl.archive.org/miscellany": miscellany_default
@@ -4609,6 +4634,8 @@ async function getRemoteDocument(url, response, fetch) {
 }
 /**
 * Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
+* At most 20 HTTP redirects and alternate document links are followed in total
+* per call.  Revisiting a URL within that chain throws a {@link FetchError}.
 *
 * The created loader preloads the below frequently used contexts by default
 * (unless `options.skipPreloadedContexts` is set to `true`):
@@ -4620,6 +4647,7 @@ async function getRemoteDocument(url, response, fetch) {
 * - <https://www.w3.org/ns/cid/v1>
 * - <https://w3id.org/security/multikey/v1>
 * - <https://w3id.org/fep/ef61>
+* - <https://w3id.org/fep/7aa9>
 * - <https://purl.archive.org/socialweb/webfinger>
 * - <http://schema.org/>
 * @param options Options for the document loader.
@@ -4642,7 +4670,11 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 		if (!allowPrivateAddress) try {
 			await require_url.validatePublicUrl(currentUrl);
 		} catch (error) {
-			if (error instanceof require_url.UrlError) logger.error("Disallowed private URL: {url}", {
+			if (error instanceof require_url.UrlError) if (error.reason === "dns") logger.debug("DNS lookup failed for {url}", {
+				url: currentUrl,
+				error
+			});
+			else logger.error("Disallowed private URL: {url}", {
 				url: currentUrl,
 				error
 			});
@@ -4680,7 +4712,12 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 					}
 					return await load(redirectUrl, options, redirected + 1, visited);
 				}
-				const result = await getRemoteDocument(currentUrl, response, load);
+				const result = await getRemoteDocument(currentUrl, response, async (alternateUrl) => {
+					options?.signal?.throwIfAborted();
+					if (redirected >= DEFAULT_MAX_REDIRECTION) throw new require_request.FetchError(currentUrl, `Too many redirections (${redirected + 1})`);
+					if (visited.has(alternateUrl)) throw new require_request.FetchError(currentUrl, `Redirect loop detected: ${alternateUrl}`);
+					return await load(alternateUrl, options, redirected + 1, visited);
+				});
 				span.setAttribute("docloader.document_url", result.documentUrl);
 				if (result.contextUrl != null) span.setAttribute("docloader.context_url", result.contextUrl);
 				return result;
@@ -4696,7 +4733,7 @@ function getDocumentLoader({ allowPrivateAddress, skipPreloadedContexts, userAge
 			}
 		});
 	}
-	return load;
+	return (url, options) => load(url, options);
 }
 //#endregion
 Object.defineProperty(exports, "cid_v1_default", {