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

package/dist/tests/docloader.test.cjs

@@ -1,11 +1,17 @@
-const require_chunk = require("./chunk-C2EiDwsr.cjs");
-const require_docloader = require("./docloader-BFedvemb.cjs");
-const require_request = require("./request-cCPgOxYG.cjs");
-const require_url = require("./url-BvjYQdxL.cjs");
+const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
+const require_request = require("./request-8vPWtV1-.cjs");
+const require_contexts = require("./contexts-DizzBjz4.cjs");
+const require_url = require("./url-BNakuZ8k.cjs");
+const require_docloader = require("./docloader-C3YFl6y4.cjs");
+let node_zlib = require("node:zlib");
+let _logtape_logtape = require("@logtape/logtape");
 let node_assert = require("node:assert");
-let node_test = require("node:test");
+let node_dns_promises = require("node:dns/promises");
+node_dns_promises = require_rolldown_runtime.__toESM(node_dns_promises, 1);
+let _fedify_fixture = require("@fedify/fixture");
+let node_http = require("node:http");
 //#region ../../node_modules/.pnpm/glob-to-regexp@0.4.1/node_modules/glob-to-regexp/index.js
-var require_glob_to_regexp = /* @__PURE__ */ require_chunk.__commonJSMin(((exports, module) => {
+var require_glob_to_regexp = /* @__PURE__ */ require_rolldown_runtime.__commonJSMin(((exports, module) => {
 	module.exports = function(glob, opts) {
 		if (typeof glob !== "string") throw new TypeError("Expected a string");
 		var str = String(glob);
@@ -79,7 +85,7 @@ var require_glob_to_regexp = /* @__PURE__ */ require_chunk.__commonJSMin(((expor
 }));
 //#endregion
 //#region ../../node_modules/.pnpm/regexparam@3.0.0/node_modules/regexparam/dist/index.mjs
-var import_glob_to_regexp = /* @__PURE__ */ require_chunk.__toESM(require_glob_to_regexp(), 1);
+var import_glob_to_regexp = /* @__PURE__ */ require_rolldown_runtime.__toESM(require_glob_to_regexp(), 1);
 /**
 * @param {string|RegExp} input The route pattern
 * @param {boolean} [loose] Allow open-ended matching. Ignored with `RegExp` input.
@@ -111,27 +117,27 @@ function parse(input, loose) {
 }
 //#endregion
 //#region ../../node_modules/.pnpm/fetch-mock@12.6.0/node_modules/fetch-mock/dist/esm/TypeDescriptor.js
-const valueTypes = new Set([
+const valueTypes = /* @__PURE__ */ new Set([
 	"boolean",
 	"number",
 	"null",
 	"string",
 	"undefined"
 ]);
-const referenceTypes = new Set([
+const referenceTypes = /* @__PURE__ */ new Set([
 	"array",
 	"function",
 	"object",
 	"symbol"
 ]);
-const detectableTypes = new Set([
+const detectableTypes = /* @__PURE__ */ new Set([
 	"boolean",
 	"function",
 	"number",
 	"string",
 	"symbol"
 ]);
-const typeConstructors = new Set([
+const typeConstructors = /* @__PURE__ */ new Set([
 	Boolean,
 	Number,
 	String
@@ -202,7 +208,7 @@ var TypeDescriptor = class TypeDescriptor {
 };
 //#endregion
 //#region ../../node_modules/.pnpm/fetch-mock@12.6.0/node_modules/fetch-mock/dist/esm/IsSubsetOf.js
-const allowedTypes = new Set([
+const allowedTypes = /* @__PURE__ */ new Set([
 	"array",
 	"object",
 	"function",
@@ -694,7 +700,14 @@ var __classPrivateFieldGet = function(receiver, state, kind, f) {
 	if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
 	return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _Route_instances, _a, _Route_responseSubscriptions, _Route_validate, _Route_sanitize, _Route_generateMatcher, _Route_limit, _Route_delayResponse;
+var _Route_instances;
+var _a;
+var _Route_responseSubscriptions;
+var _Route_validate;
+var _Route_sanitize;
+var _Route_generateMatcher;
+var _Route_limit;
+var _Route_delayResponse;
 var RouteConfigWrapper = class {
 	constructor(config) {
 		Object.assign(this, config);
@@ -1206,7 +1219,53 @@ var esm_default = new class FetchMock {
 }({ ...defaultFetchMockConfig });
 //#endregion
 //#region src/docloader.test.ts
-(0, node_test.test)("new FetchError()", () => {
+(0, _fedify_fixture.test)("getRemoteDocument() forwards options to alternate documents", async () => {
+	const records = [];
+	await (0, _logtape_logtape.reset)();
+	await (0, _logtape_logtape.configure)({
+		sinks: { capture: (record) => records.push(record) },
+		loggers: [{
+			category: ["fedify"],
+			lowestLevel: "debug",
+			sinks: ["capture"]
+		}]
+	});
+	try {
+		for (const linkHeader of [true, false]) for (const suppressError of [
+			true,
+			false,
+			void 0
+		]) {
+			records.length = 0;
+			const url = "https://example.com/alternate-source";
+			const alternateUrl = "https://example.com/missing-alternate";
+			const options = {
+				suppressError,
+				signal: new AbortController().signal
+			};
+			const response = new Response(`<link rel="alternate" type="application/activity+json" href="${alternateUrl}">`, { headers: {
+				"Content-Type": "text/html",
+				...linkHeader ? { Link: `<${alternateUrl}>; rel="alternate"; type="application/activity+json"` } : {}
+			} });
+			let alternateRequests = 0;
+			await (0, node_assert.rejects)(() => require_docloader.getRemoteDocument(url, response, async (requestedUrl, forwarded) => {
+				alternateRequests++;
+				(0, node_assert.deepStrictEqual)(requestedUrl, alternateUrl);
+				(0, node_assert.deepStrictEqual)(forwarded, options);
+				return await require_docloader.getRemoteDocument(requestedUrl, new Response(null, { status: 404 }), () => {
+					throw new Error("Unexpected additional alternate");
+				}, forwarded);
+			}, options), require_request.FetchError);
+			(0, node_assert.deepStrictEqual)(alternateRequests, 1);
+			const failures = records.filter((record) => record.rawMessage === "Failed to fetch document: {status} {url} {headers}");
+			(0, node_assert.deepStrictEqual)(failures.length, 1);
+			(0, node_assert.deepStrictEqual)(failures[0].level, suppressError ? "warning" : "error");
+		}
+	} finally {
+		await (0, _logtape_logtape.reset)();
+	}
+});
+(0, _fedify_fixture.test)("new FetchError()", () => {
 	const e = new require_request.FetchError("https://example.com/", "An error message.");
 	(0, node_assert.deepStrictEqual)(e.name, "FetchError");
 	(0, node_assert.deepStrictEqual)(e.url, new URL("https://example.com/"));
@@ -1219,7 +1278,7 @@ var esm_default = new class FetchMock {
 	(0, node_assert.ok)(e2.response != null);
 	(0, node_assert.deepStrictEqual)(e2.response.status, 410);
 });
-(0, node_test.test)("getDocumentLoader()", async (t) => {
+(0, _fedify_fixture.test)("getDocumentLoader()", async (t) => {
 	const fetchDocumentLoader = require_docloader.getDocumentLoader();
 	esm_default.spyGlobal();
 	esm_default.get("https://example.com/object", { body: {
@@ -1228,7 +1287,7 @@ var esm_default = new class FetchMock {
 		name: "Fetched object",
 		type: "Object"
 	} });
-	await t.test("ok", async () => {
+	await t.step("ok", async () => {
 		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader("https://example.com/object"), {
 			contextUrl: null,
 			documentUrl: "https://example.com/object",
@@ -1271,7 +1330,7 @@ var esm_default = new class FetchMock {
 			Link: "<https://example.com/object>; rel=\"alternate\"; type=\"application/ld+json; profile=\"https://www.w3.org/ns/activitystreams\"\""
 		}
 	});
-	await t.test("Link header", async () => {
+	await t.step("Link header", async () => {
 		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader("https://example.com/link-ctx"), {
 			contextUrl: "https://www.w3.org/ns/activitystreams",
 			documentUrl: "https://example.com/link-ctx",
@@ -1292,7 +1351,7 @@ var esm_default = new class FetchMock {
 			}
 		});
 	});
-	await t.test("Link header relative url", async () => {
+	await t.step("Link header relative url", async () => {
 		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader("https://example.com/link-ctx"), {
 			contextUrl: "https://www.w3.org/ns/activitystreams",
 			documentUrl: "https://example.com/link-ctx",
@@ -1313,7 +1372,7 @@ var esm_default = new class FetchMock {
 			}
 		});
 	});
-	await t.test("wrong Link header syntax", async () => {
+	await t.step("wrong Link header syntax", async () => {
 		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader("https://example.com/obj-w-wrong-link"), {
 			contextUrl: null,
 			documentUrl: "https://example.com/obj-w-wrong-link",
@@ -1337,7 +1396,7 @@ var esm_default = new class FetchMock {
       </html>`,
 		headers: { "Content-Type": "text/html; charset=utf-8" }
 	});
-	await t.test("HTML <link>", async () => {
+	await t.step("HTML <link>", async () => {
 		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader("https://example.com/html-link"), {
 			contextUrl: null,
 			documentUrl: "https://example.com/object",
@@ -1361,7 +1420,7 @@ var esm_default = new class FetchMock {
       </html>`,
 		headers: { "Content-Type": "application/xhtml+xml; charset=utf-8" }
 	});
-	await t.test("XHTML <link>", async () => {
+	await t.step("XHTML <link>", async () => {
 		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader("https://example.com/xhtml-link"), {
 			contextUrl: null,
 			documentUrl: "https://example.com/object",
@@ -1387,7 +1446,7 @@ var esm_default = new class FetchMock {
       </html>`,
 		headers: { "Content-Type": "text/html; charset=utf-8" }
 	});
-	await t.test("HTML <a>", async () => {
+	await t.step("HTML <a>", async () => {
 		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader("https://example.com/html-a"), {
 			contextUrl: null,
 			documentUrl: "https://example.com/object",
@@ -1409,7 +1468,7 @@ var esm_default = new class FetchMock {
       </html>`,
 		headers: { "Content-Type": "text/html; charset=utf-8" }
 	});
-	await t.test("HTML without ActivityPub alternate link", async () => {
+	await t.step("HTML without ActivityPub alternate link", async () => {
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://example.com/html-no-alternate"), (error) => {
 			(0, node_assert.ok)(error instanceof require_request.FetchError);
 			(0, node_assert.ok)(error.message.includes("HTML document has no ActivityPub alternate link"));
@@ -1429,7 +1488,7 @@ var esm_default = new class FetchMock {
 		},
 		headers: { "Content-Type": "text/html; charset=utf-8" }
 	});
-	await t.test("wrong Content-Type with JSON body", async () => {
+	await t.step("wrong Content-Type with JSON body", async () => {
 		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader("https://example.com/wrong-content-type"), {
 			contextUrl: null,
 			documentUrl: "https://example.com/wrong-content-type",
@@ -1448,7 +1507,7 @@ var esm_default = new class FetchMock {
 			"Content-Type": "text/html; charset=utf-8"
 		}
 	});
-	await t.test("HTML Content-Length over limit", async () => {
+	await t.step("HTML Content-Length over limit", async () => {
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://example.com/large-html"), (error) => {
 			(0, node_assert.ok)(error instanceof require_request.FetchError);
 			(0, node_assert.ok)(error.message.includes("HTML document is too large to scan for an ActivityPub alternate link"));
@@ -1458,32 +1517,88 @@ var esm_default = new class FetchMock {
 			return true;
 		});
 	});
-	await t.test("HTML Content-Length over limit cancels body", async () => {
+	await t.step("HTML Content-Length over limit cancels body", async () => {
 		let canceled = false;
 		const response = new Response("<!DOCTYPE html>", { headers: {
 			"Content-Length": String(1048577),
 			"Content-Type": "text/html; charset=utf-8"
 		} });
-		Object.defineProperty(response, "body", { value: { cancel: () => {
+		Object.defineProperty(response, "body", { value: new ReadableStream({ cancel() {
 			canceled = true;
-		} } });
+		} }) });
 		await (0, node_assert.rejects)(() => require_docloader.getRemoteDocument("https://example.com/large-html-cancel", response, () => {
 			throw new Error("unexpected alternate fetch");
 		}), require_request.FetchError);
 		(0, node_assert.deepStrictEqual)(canceled, true);
 	});
 	esm_default.get("https://example.com/404", { status: 404 });
-	await t.test("not ok", async () => {
+	await t.step("not ok", async () => {
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://example.com/404"), require_request.FetchError, "HTTP 404: https://example.com/404");
 	});
-	await t.test("preloaded contexts", async () => {
-		for (const [url, document] of Object.entries(require_docloader.preloadedContexts)) (0, node_assert.deepStrictEqual)(await fetchDocumentLoader(url), {
+	await t.step("preloaded contexts", async () => {
+		for (const [url, document] of Object.entries(require_contexts.preloadedContexts)) (0, node_assert.deepStrictEqual)(await fetchDocumentLoader(url), {
 			contextUrl: null,
 			documentUrl: url,
 			document
 		});
 	});
-	await t.test("deny non-HTTP/HTTPS", async () => {
+	esm_default.get("https://www.w3.org/ns/cid/v1", { status: 503 });
+	await t.step("preloaded CID v1 context", async () => {
+		const url = "https://www.w3.org/ns/cid/v1";
+		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader(url), {
+			contextUrl: null,
+			documentUrl: url,
+			document: require_contexts.cid_v1_default
+		});
+	});
+	await t.step("preloaded FEP-ef61 context", async () => {
+		const url = "https://w3id.org/fep/ef61";
+		(0, node_assert.ok)(url in require_contexts.preloadedContexts);
+		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader(url), {
+			contextUrl: null,
+			documentUrl: url,
+			document: { "@context": {
+				gateways: {
+					"@id": "https://w3id.org/fep/ef61/gateways",
+					"@type": "@id",
+					"@container": "@list"
+				},
+				digestMultibase: "https://www.w3.org/ns/credentials/v2#digestMultibase"
+			} }
+		});
+	});
+	esm_default.get("https://w3id.org/fep/7aa9", { status: 502 });
+	await t.step("preloaded FEP-7aa9 context", async () => {
+		const url = "https://w3id.org/fep/7aa9";
+		(0, node_assert.deepStrictEqual)(await fetchDocumentLoader(url), {
+			contextUrl: null,
+			documentUrl: url,
+			document: { "@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"
+				}
+			} }
+		});
+		(0, node_assert.deepStrictEqual)(esm_default.callHistory.calls(url).length, 0);
+	});
+	await t.step("deny non-HTTP/HTTPS", async () => {
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("ftp://localhost"), require_url.UrlError);
 	});
 	esm_default.get("https://example.com/localhost-redirect", {
@@ -1508,13 +1623,13 @@ var esm_default = new class FetchMock {
 		name: "Fetched object",
 		type: "Object"
 	} });
-	await t.test("allowPrivateAddress: false", async () => {
+	await t.step("allowPrivateAddress: false", async () => {
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://localhost/object"), require_url.UrlError);
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://example.com/localhost-redirect"), require_url.UrlError);
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://example.com/localhost-link"), require_url.UrlError);
 	});
 	const fetchDocumentLoader2 = require_docloader.getDocumentLoader({ allowPrivateAddress: true });
-	await t.test("allowPrivateAddress: true", async () => {
+	await t.step("allowPrivateAddress: true", async () => {
 		const expected = {
 			contextUrl: null,
 			documentUrl: "https://localhost/object",
@@ -1537,12 +1652,12 @@ var esm_default = new class FetchMock {
 			headers: { Location: `https://example.com/too-many-redirects/${Number(cl.url.split("/").at(-1)) + 1}` }
 		};
 	});
-	await t.test("too many redirects", async () => {
+	await t.step("too many redirects", async () => {
 		redirectAttempts = 0;
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://example.com/too-many-redirects/0"), require_request.FetchError, "Too many redirections");
 		(0, node_assert.deepStrictEqual)(redirectAttempts, 21);
 	});
-	await t.test("custom max redirection", async () => {
+	await t.step("custom max redirection", async () => {
 		redirectAttempts = 0;
 		const loader = require_docloader.getDocumentLoader({ maxRedirection: 1 });
 		await (0, node_assert.rejects)(() => loader("https://example.com/too-many-redirects/0"), require_request.FetchError, "Too many redirections");
@@ -1563,7 +1678,7 @@ var esm_default = new class FetchMock {
 			headers: { Location: "https://example.com/redirect-loop-a" }
 		};
 	});
-	await t.test("redirect loop", async () => {
+	await t.step("redirect loop", async () => {
 		loopAttempts = 0;
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://example.com/redirect-loop-a"), require_request.FetchError, "Redirect loop detected");
 		(0, node_assert.deepStrictEqual)(loopAttempts, 2);
@@ -1576,7 +1691,7 @@ var esm_default = new class FetchMock {
 			headers: { Location: "/redirect-loop-relative" }
 		};
 	});
-	await t.test("redirect loop with relative location", async () => {
+	await t.step("redirect loop with relative location", async () => {
 		relativeLoopAttempts = 0;
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://example.com/redirect-loop-relative"), require_request.FetchError, "Redirect loop detected");
 		(0, node_assert.deepStrictEqual)(relativeLoopAttempts, 1);
@@ -1586,7 +1701,7 @@ var esm_default = new class FetchMock {
 		body: maliciousPayload,
 		headers: { "Content-Type": "text/html; charset=utf-8" }
 	});
-	await t.test("ReDoS resistance (CVE-2025-68475)", async () => {
+	await t.step("ReDoS resistance (CVE-2025-68475)", async () => {
 		const start = performance.now();
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("https://example.com/redos"), require_request.FetchError);
 		const elapsed = performance.now() - start;
@@ -1594,4 +1709,542 @@ var esm_default = new class FetchMock {
 	});
 	esm_default.hardReset();
 });
+(0, _fedify_fixture.test)("getDocumentLoader() bounds JSON, HTML, and alternate documents", async () => {
+	const url = "https://example.com/bounded";
+	esm_default.mockGlobal();
+	let oversized = true;
+	try {
+		esm_default.get(url, () => new Response("{\"name\":\"hello\"}", { headers: {
+			"Content-Type": "application/activity+json",
+			...oversized ? { "Content-Length": String(16777217) } : {}
+		} }));
+		const loader = require_docloader.getDocumentLoader({ allowPrivateAddress: true });
+		await (0, node_assert.rejects)(loader(url), require_request.FetchError);
+		oversized = false;
+		(0, node_assert.deepStrictEqual)((await loader(url)).document, { name: "hello" });
+		oversized = true;
+		esm_default.get(`${url}/html`, () => new Response(" ".repeat(1048577), { headers: { "Content-Type": "text/html" } }));
+		await (0, node_assert.rejects)(require_docloader.getDocumentLoader({ allowPrivateAddress: true })(`${url}/html`), require_request.FetchError);
+		esm_default.get(`${url}/alternate`, () => new Response("", { headers: {
+			"Content-Type": "text/html",
+			Link: `<${url}>; rel="alternate"; type="application/activity+json"`
+		} }));
+		await (0, node_assert.rejects)(loader(`${url}/alternate`), require_request.FetchError);
+		esm_default.get(`${url}/redirect`, {
+			status: 302,
+			headers: { Location: url }
+		});
+		await (0, node_assert.rejects)(loader(`${url}/redirect`), require_request.FetchError);
+	} finally {
+		esm_default.hardReset();
+	}
+});
+(0, _fedify_fixture.test)("getDocumentLoader() rejects oversized gzip responses from fetch", async () => {
+	const document = { name: "a".repeat(16 * 1024 * 1024) };
+	const compressed = (0, node_zlib.gzipSync)(JSON.stringify(document));
+	(0, node_assert.ok)(compressed.byteLength < 64 * 1024);
+	const server = (0, node_http.createServer)((request, response) => {
+		const body = request.url === "/small" ? (0, node_zlib.gzipSync)("{\"name\":\"hello\"}") : compressed;
+		response.writeHead(200, {
+			"Content-Type": "application/activity+json",
+			"Content-Encoding": "gzip",
+			"Content-Length": body.byteLength
+		});
+		response.end(body);
+	});
+	await new Promise((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(0, "127.0.0.1", resolve);
+	});
+	try {
+		const address = server.address();
+		(0, node_assert.ok)(address != null && typeof address !== "string");
+		const url = `http://127.0.0.1:${address.port}/document`;
+		await (0, node_assert.rejects)(require_docloader.getDocumentLoader({ allowPrivateAddress: true })(url), require_request.FetchError);
+		(0, node_assert.deepStrictEqual)((await require_docloader.getDocumentLoader({ allowPrivateAddress: true })(new URL("/small", url).href)).document, { name: "hello" });
+	} finally {
+		await new Promise((resolve, reject) => {
+			server.close((error) => error == null ? resolve() : reject(error));
+			server.closeAllConnections();
+		});
+	}
+});
+(0, _fedify_fixture.test)("getRemoteDocument() bounds JSON by default", async () => {
+	let canceled = false;
+	let pulls = 0;
+	await (0, node_assert.rejects)(require_docloader.getRemoteDocument("https://example.com/document", new Response(new ReadableStream({
+		pull(controller) {
+			pulls++;
+			controller.enqueue(new Uint8Array(64 * 1024).fill(32));
+		},
+		cancel() {
+			canceled = true;
+		}
+	}, { highWaterMark: 0 })), () => {
+		throw new Error("Unexpected alternate document");
+	}), require_request.FetchError);
+	(0, node_assert.deepStrictEqual)(canceled, true);
+	(0, node_assert.deepStrictEqual)(pulls, 257);
+});
+(0, _fedify_fixture.test)("getDocumentLoader() logs DNS failures as such", async (t) => {
+	if ("Deno" in globalThis && (await Deno.permissions.query({ name: "net" })).state !== "granted") throw new Error("This DNS test requires Deno network permission (--allow-net).");
+	const loader = require_docloader.getDocumentLoader();
+	for (const result of [
+		"throws",
+		"empty",
+		"private"
+	]) await t.step(result, async () => {
+		const originalLookup = node_dns_promises.default.lookup;
+		node_dns_promises.default.lookup = (() => result === "throws" ? Promise.reject(/* @__PURE__ */ new Error("Resolver unavailable")) : Promise.resolve(result === "empty" ? [] : [{
+			address: "127.0.0.1",
+			family: 4
+		}]));
+		const records = [];
+		await (0, _logtape_logtape.configure)({
+			sinks: { buffer: (record) => records.push(record) },
+			loggers: [{
+				category: "fedify",
+				sinks: ["buffer"],
+				lowestLevel: "debug"
+			}, {
+				category: ["logtape", "meta"],
+				sinks: []
+			}],
+			reset: true
+		});
+		try {
+			const url = "https://dns-failure.invalid/object";
+			let error;
+			await (0, node_assert.rejects)(() => loader(url), (e) => {
+				error = e;
+				return true;
+			});
+			(0, node_assert.ok)(error instanceof require_url.UrlError);
+			(0, node_assert.deepStrictEqual)(error.reason, result === "private" ? "disallowed" : "dns");
+			(0, node_assert.deepStrictEqual)(records.map((r) => [
+				r.level,
+				r.rawMessage,
+				r.properties.url
+			]), [result === "private" ? [
+				"error",
+				"Disallowed private URL: {url}",
+				url
+			] : [
+				"debug",
+				"DNS lookup failed for {url}",
+				url
+			]]);
+			(0, node_assert.ok)(records[0].properties.error === error);
+		} finally {
+			await (0, _logtape_logtape.reset)();
+			node_dns_promises.default.lookup = originalLookup;
+		}
+	});
+});
+(0, _fedify_fixture.test)("getDocumentLoader() bounds alternate document chains", async (t) => {
+	const base = "https://example.com/alternate-chain/";
+	const loader = require_docloader.getDocumentLoader({ allowPrivateAddress: true });
+	for (const mode of [
+		"header",
+		"html",
+		"mixed"
+	]) for (const hops of [20, 21]) await t.step(`${mode}: ${hops} hops`, async () => {
+		esm_default.mockGlobal();
+		let requests = 0;
+		esm_default.get(`begin:${base}`, ({ url }) => {
+			requests++;
+			const index = Number(new URL(url).pathname.split("/").at(-1));
+			if (index === hops || requests > 30) return Response.json({ done: true });
+			const next = `${base}${index + 1}`;
+			if (mode === "mixed" && index % 2 === 1) return Response.redirect(next, 302);
+			return alternate(next, mode === "html");
+		});
+		try {
+			if (hops === 20) (0, node_assert.deepStrictEqual)((await loader(`${base}0`)).document, { done: true });
+			else await (0, node_assert.rejects)(loader(`${base}0`), (error) => {
+				(0, node_assert.ok)(error instanceof require_request.FetchError);
+				(0, node_assert.ok)(error.message.includes("Too many redirections (21)"));
+				return true;
+			});
+			(0, node_assert.deepStrictEqual)(requests, 21);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	for (const mode of [
+		"header",
+		"html",
+		"alternate-redirect",
+		"redirect-alternate",
+		"redirect-intermediate"
+	]) await t.step(`${mode}: cycle`, async () => {
+		esm_default.mockGlobal();
+		let requests = 0;
+		esm_default.get(`begin:${base}`, ({ url }) => {
+			requests++;
+			if (requests > 30) return Response.json({ stopped: true });
+			const index = Number(new URL(url).pathname.split("/").at(-1));
+			const next = `${base}${mode === "redirect-intermediate" ? index === 0 ? 1 : index === 1 ? 2 : 1 : 1 - index}`;
+			if (mode === "alternate-redirect" && index === 1 || (mode === "redirect-alternate" || mode === "redirect-intermediate") && index === 0) return Response.redirect(next, 302);
+			return alternate(next, mode === "html");
+		});
+		try {
+			await (0, node_assert.rejects)(loader(`${base}0`), (error) => {
+				(0, node_assert.ok)(error instanceof require_request.FetchError);
+				(0, node_assert.ok)(error.message.includes("Redirect loop detected:"));
+				return true;
+			});
+			(0, node_assert.deepStrictEqual)(requests, mode === "redirect-intermediate" ? 3 : 2);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	await t.step("alternate followed by 20 redirects shares the limit", async () => {
+		esm_default.mockGlobal();
+		let requests = 0;
+		esm_default.get(`begin:${base}`, ({ url }) => {
+			requests++;
+			const index = Number(new URL(url).pathname.split("/").at(-1));
+			if (index === 21) return Response.json({ done: true });
+			return index === 0 ? alternate(`${base}1`, false) : Response.redirect(`${base}${index + 1}`, 302);
+		});
+		try {
+			await (0, node_assert.rejects)(loader(`${base}0`), (error) => {
+				(0, node_assert.ok)(error instanceof require_request.FetchError);
+				(0, node_assert.ok)(error.message.includes("Too many redirections (21)"));
+				return true;
+			});
+			(0, node_assert.deepStrictEqual)(requests, 21);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	await t.step("relative alternate after redirect and isolated calls", async () => {
+		esm_default.mockGlobal();
+		esm_default.get(`${base}start`, Response.redirect(`${base}html`, 302));
+		esm_default.get(`${base}html`, alternate("./document", true));
+		esm_default.get(`${base}document`, Response.json({ done: true }));
+		try {
+			for (let i = 0; i < 2; i++) {
+				const results = await Promise.all([loader(`${base}start`), loader(`${base}start`)]);
+				for (const result of results) {
+					(0, node_assert.deepStrictEqual)(result.document, { done: true });
+					(0, node_assert.deepStrictEqual)(result.documentUrl, `${base}document`);
+				}
+			}
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	function alternate(next, html) {
+		return html ? new Response(`<link rel="alternate" type="application/activity+json" href="${next}">`, { headers: { "Content-Type": "text/html" } }) : new Response("not JSON", { headers: {
+			"Content-Type": "text/plain",
+			Link: `<${next}>; rel="alternate"; type="application/activity+json"`
+		} });
+	}
+});
+(0, _fedify_fixture.test)("getDocumentLoader() preserves cancellation across alternates", async (t) => {
+	const base = "https://example.com/alternate-abort/";
+	const loader = require_docloader.getDocumentLoader({ allowPrivateAddress: true });
+	for (const html of [false, true]) await t.step(html ? "HTML" : "Link header", async () => {
+		esm_default.mockGlobal();
+		const controller = new AbortController();
+		let requests = 0;
+		esm_default.get(`begin:${base}`, ({ url }) => {
+			requests++;
+			const index = Number(new URL(url).pathname.split("/").at(-1));
+			if (index === 2) return Response.json({ done: true });
+			if (index === 1) controller.abort();
+			const next = `${base}${index + 1}`;
+			return new Response(html ? `<link rel="alternate" type="application/activity+json" href="${next}">` : "not JSON", { headers: html ? { "Content-Type": "text/html" } : {
+				"Content-Type": "text/plain",
+				Link: `<${next}>; rel="alternate"; type="application/activity+json"`
+			} });
+		});
+		try {
+			await (0, node_assert.rejects)(loader(`${base}0`, { signal: controller.signal }), { name: "AbortError" });
+			(0, node_assert.deepStrictEqual)(requests, 2);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+});
+(0, _fedify_fixture.test)("getDocumentLoader() rejects cancellation before fetching", async () => {
+	esm_default.mockGlobal();
+	let requests = 0;
+	const url = "https://example.com/pre-aborted-alternate";
+	esm_default.get(url, () => {
+		requests++;
+		return Response.json({ done: true });
+	});
+	try {
+		const loader = require_docloader.getDocumentLoader({ allowPrivateAddress: true });
+		const controller = new AbortController();
+		controller.abort();
+		await (0, node_assert.rejects)(loader(url, { signal: controller.signal }), { name: "AbortError" });
+		(0, node_assert.deepStrictEqual)(requests, 0);
+	} finally {
+		esm_default.hardReset();
+	}
+});
+async function withServer(handler, callback) {
+	const server = (0, node_http.createServer)(handler);
+	await new Promise((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(0, "127.0.0.1", resolve);
+	});
+	try {
+		const address = server.address();
+		(0, node_assert.ok)(address != null && typeof address !== "string");
+		return await callback(`http://127.0.0.1:${address.port}`);
+	} finally {
+		await new Promise((resolve, reject) => {
+			server.close((error) => error == null ? resolve() : reject(error));
+			server.closeAllConnections();
+		});
+	}
+}
+function isTimeoutFetchError(error, url) {
+	(0, node_assert.ok)(error instanceof require_request.FetchError, String(error));
+	(0, node_assert.deepStrictEqual)(error.url.href, url);
+	(0, node_assert.deepStrictEqual)(error.response, void 0);
+	(0, node_assert.ok)(error.cause instanceof DOMException);
+	(0, node_assert.deepStrictEqual)(error.cause.name, "TimeoutError");
+	return true;
+}
+(0, _fedify_fixture.test)("resolveDocumentLoaderTimeout() validates timeouts", () => {
+	(0, node_assert.deepStrictEqual)(require_docloader.resolveDocumentLoaderTimeout(void 0), 1e4);
+	(0, node_assert.deepStrictEqual)(require_docloader.resolveDocumentLoaderTimeout(null), null);
+	(0, node_assert.deepStrictEqual)(require_docloader.resolveDocumentLoaderTimeout(1500), 1500);
+	(0, node_assert.deepStrictEqual)(require_docloader.resolveDocumentLoaderTimeout(.5), 1);
+	(0, node_assert.deepStrictEqual)(require_docloader.resolveDocumentLoaderTimeout(2147483647), 2147483647);
+	for (const invalid of [
+		0,
+		-1,
+		NaN,
+		Infinity,
+		2147483648
+	]) (0, node_assert.throws)(() => require_docloader.resolveDocumentLoaderTimeout(invalid), RangeError);
+	(0, node_assert.throws)(() => require_docloader.getDocumentLoader({ timeout: 0 }), RangeError);
+});
+(0, _fedify_fixture.test)("getDocumentLoader() times out a request without a response", async () => {
+	await withServer(() => {}, async (baseUrl) => {
+		const url = `${baseUrl}/hang`;
+		await (0, node_assert.rejects)(require_docloader.getDocumentLoader({
+			allowPrivateAddress: true,
+			timeout: 100
+		})(url), (e) => isTimeoutFetchError(e, url));
+	});
+});
+(0, _fedify_fixture.test)("getDocumentLoader() times out a stalled response body", async () => {
+	for (const status of [200, 404]) await withServer((_, response) => {
+		response.writeHead(status, { "Content-Type": "application/activity+json" });
+		response.write("{\"id\":");
+	}, async (baseUrl) => {
+		const url = `${baseUrl}/stalled`;
+		await (0, node_assert.rejects)(require_docloader.getDocumentLoader({
+			allowPrivateAddress: true,
+			timeout: 200
+		})(url), (e) => isTimeoutFetchError(e, url));
+	});
+});
+(0, _fedify_fixture.test)("getDocumentLoader() shares the timeout across redirects", async () => {
+	let requests = 0;
+	await withServer((request, response) => {
+		requests++;
+		const index = Number(request.url?.split("/").at(-1));
+		setTimeout(() => {
+			if (index >= 15) {
+				response.writeHead(200, { "Content-Type": "application/activity+json" });
+				response.end("{\"done\":true}");
+				return;
+			}
+			response.writeHead(302, { Location: `/redirect/${index + 1}` });
+			response.end();
+		}, 50);
+	}, async (baseUrl) => {
+		const url = `${baseUrl}/redirect/0`;
+		await (0, node_assert.rejects)(require_docloader.getDocumentLoader({
+			allowPrivateAddress: true,
+			timeout: 300
+		})(url), (e) => isTimeoutFetchError(e, url));
+		(0, node_assert.ok)(requests < 16, `requests: ${requests}`);
+		(0, node_assert.deepStrictEqual)((await require_docloader.getDocumentLoader({
+			allowPrivateAddress: true,
+			timeout: null
+		})(url)).document, { done: true });
+	});
+});
+(0, _fedify_fixture.test)("getDocumentLoader() shares the timeout across alternates", async (t) => {
+	for (const html of [false, true]) await t.step(html ? "HTML" : "Link header", async () => {
+		await withServer((request, response) => {
+			const index = Number(request.url?.split("/").at(-1));
+			setTimeout(() => {
+				if (index >= 15) {
+					response.writeHead(200, { "Content-Type": "application/activity+json" });
+					response.end("{\"done\":true}");
+					return;
+				}
+				const next = `/alternate/${index + 1}`;
+				response.writeHead(200, html ? { "Content-Type": "text/html" } : {
+					"Content-Type": "text/plain",
+					Link: `<${next}>; rel="alternate"; type="application/activity+json"`
+				});
+				response.end(html ? `<link rel="alternate" type="application/activity+json" href="${next}">` : "not JSON");
+			}, 50);
+		}, async (baseUrl) => {
+			const url = `${baseUrl}/alternate/0`;
+			await (0, node_assert.rejects)(require_docloader.getDocumentLoader({
+				allowPrivateAddress: true,
+				timeout: 300
+			})(url), (e) => isTimeoutFetchError(e, url));
+		});
+	});
+});
+(0, _fedify_fixture.test)("getDocumentLoader() lets the caller's signal abort a request", async () => {
+	await withServer(() => {}, async (baseUrl) => {
+		const url = `${baseUrl}/hang`;
+		for (const timeout of [
+			void 0,
+			6e4,
+			null
+		]) {
+			const loader = require_docloader.getDocumentLoader({
+				allowPrivateAddress: true,
+				timeout
+			});
+			const controller = new AbortController();
+			const reason = /* @__PURE__ */ new Error("Canceled by the caller");
+			setTimeout(() => controller.abort(reason), 50);
+			await (0, node_assert.rejects)(loader(url, { signal: controller.signal }), (e) => {
+				(0, node_assert.deepStrictEqual)(e, reason);
+				return true;
+			});
+		}
+		const loader = require_docloader.getDocumentLoader({
+			allowPrivateAddress: true,
+			timeout: 50
+		});
+		const controller = new AbortController();
+		const reason = /* @__PURE__ */ new Error("Canceled by the caller");
+		controller.abort(reason);
+		await (0, node_assert.rejects)(loader(url, { signal: controller.signal }), (e) => {
+			(0, node_assert.deepStrictEqual)(e, reason);
+			return true;
+		});
+	});
+});
+(0, _fedify_fixture.test)("getDocumentLoader() bounds DNS lookups that ignore the timeout", async () => {
+	if ("Deno" in globalThis && (await Deno.permissions.query({ name: "net" })).state !== "granted") throw new Error("This DNS test requires Deno network permission (--allow-net).");
+	esm_default.mockGlobal();
+	let requests = 0;
+	const url = "https://slow-dns.example/object";
+	esm_default.get(url, () => {
+		requests++;
+		return Response.json({ id: url });
+	});
+	const originalLookup = node_dns_promises.default.lookup;
+	let resolveLookup = () => {};
+	const lookedUp = new Promise((resolve) => resolveLookup = resolve);
+	node_dns_promises.default.lookup = (() => new Promise((resolve) => setTimeout(() => {
+		resolve([{
+			address: "93.184.215.14",
+			family: 4
+		}]);
+		resolveLookup();
+	}, 200)));
+	try {
+		await (0, node_assert.rejects)(require_docloader.getDocumentLoader({ timeout: 50 })(url), (e) => isTimeoutFetchError(e, url));
+		await lookedUp;
+		await new Promise((resolve) => setTimeout(resolve, 10));
+		(0, node_assert.deepStrictEqual)(requests, 0);
+	} finally {
+		node_dns_promises.default.lookup = originalLookup;
+		esm_default.hardReset();
+	}
+});
+(0, _fedify_fixture.test)("withDocumentLoaderTimeout() cleans up after each call", async () => {
+	const signals = [];
+	const loader = require_docloader.withDocumentLoaderTimeout((url, options) => {
+		signals.push(options.signal);
+		return Promise.resolve({
+			contextUrl: null,
+			document: {},
+			documentUrl: url
+		});
+	}, 50);
+	(0, node_assert.deepStrictEqual)((await Promise.all([loader("https://example.com/a"), loader("https://example.com/b")])).map((r) => r.documentUrl), ["https://example.com/a", "https://example.com/b"]);
+	(0, node_assert.ok)(signals[0] !== signals[1]);
+	await new Promise((resolve) => setTimeout(resolve, 100));
+	(0, node_assert.ok)(signals.every((signal) => !signal.aborted));
+	const inner = () => Promise.reject(/* @__PURE__ */ new Error("unused"));
+	(0, node_assert.ok)(require_docloader.withDocumentLoaderTimeout(inner, null) === inner);
+});
+(0, _fedify_fixture.test)("getRemoteDocument() keeps error bodies byte for byte", async () => {
+	const bytes = new Uint8Array([
+		239,
+		187,
+		191,
+		78,
+		111,
+		255,
+		254
+	]);
+	const url = "https://example.com/error";
+	let error;
+	await (0, node_assert.rejects)(require_docloader.getRemoteDocument(url, new Response(bytes, { status: 404 }), () => Promise.reject(/* @__PURE__ */ new Error("unused"))), (e) => {
+		error = e;
+		return true;
+	});
+	(0, node_assert.ok)(error instanceof require_request.FetchError);
+	(0, node_assert.ok)(error.response != null);
+	(0, node_assert.deepStrictEqual)(error.response.status, 404);
+	(0, node_assert.deepStrictEqual)(new Uint8Array(await error.response.arrayBuffer()), bytes);
+});
+(0, _fedify_fixture.test)("getRemoteDocument() keeps metadata of bodiless or large errors", async () => {
+	const url = "https://example.com/error";
+	for (const response of [new Response(null, {
+		status: 304,
+		headers: { ETag: "\"a\"" }
+	}), new Response(/* @__PURE__ */ new Uint8Array(1048577), {
+		status: 500,
+		headers: { ETag: "\"a\"" }
+	})]) await (0, node_assert.rejects)(require_docloader.getRemoteDocument(url, response, () => Promise.reject(/* @__PURE__ */ new Error("unused"))), (e) => {
+		(0, node_assert.ok)(e instanceof require_request.FetchError);
+		(0, node_assert.ok)(e.response != null);
+		(0, node_assert.deepStrictEqual)(e.response.status, response.status);
+		(0, node_assert.deepStrictEqual)(e.response.headers.get("ETag"), "\"a\"");
+		(0, node_assert.deepStrictEqual)(e.response.body, null);
+		return true;
+	});
+});
+(0, _fedify_fixture.test)("getDocumentLoader() reports statuses that Response cannot hold", async () => {
+	await withServer((_, response) => {
+		response.writeHead(999);
+		response.end("Request denied");
+	}, async (baseUrl) => {
+		const url = `${baseUrl}/denied`;
+		const loader = require_docloader.getDocumentLoader({ allowPrivateAddress: true });
+		let error;
+		await (0, node_assert.rejects)(loader(url), (e) => {
+			error = e;
+			return true;
+		});
+		(0, node_assert.ok)(error instanceof require_request.FetchError, String(error));
+		(0, node_assert.deepStrictEqual)(error.response?.status, 999);
+		(0, node_assert.deepStrictEqual)(await error.response.text(), "Request denied");
+	});
+});
+(0, _fedify_fixture.test)("getDocumentLoader() times out a stalled body of such a status", async () => {
+	await withServer((_, response) => {
+		response.writeHead(999);
+		response.write("Request");
+	}, async (baseUrl) => {
+		const url = `${baseUrl}/stalled-denied`;
+		await (0, node_assert.rejects)(require_docloader.getDocumentLoader({
+			allowPrivateAddress: true,
+			timeout: 200
+		})(url), (e) => isTimeoutFetchError(e, url));
+	});
+});
 //#endregion