@fedify/vocab-runtime 2.1.23 → 2.1.25

package/dist/tests/docloader.test.cjs

@@ -1,9 +1,14 @@
 const require_chunk = require("./chunk-Do9eywBl.cjs");
-const require_docloader = require("./docloader-BcWmxXdo.cjs");
-const require_request = require("./request-CdMLb0ba.cjs");
-const require_url = require("./url-CWU5HT3Y.cjs");
-let node_assert = require("node:assert");
+const require_request = require("./request-DrO5xzev.cjs");
+const require_docloader = require("./docloader-fn4ICzFS.cjs");
+const require_url = require("./url-vZTgkIZg.cjs");
 let node_test = require("node:test");
+let node_zlib = require("node:zlib");
+let _logtape_logtape = require("@logtape/logtape");
+let node_assert = require("node:assert");
+let node_dns_promises = require("node:dns/promises");
+node_dns_promises = require_chunk.__toESM(node_dns_promises);
+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) => {
 	module.exports = function(glob, opts) {
@@ -1456,6 +1461,37 @@ var esm_default = new class FetchMock {
 			} }
 		});
 	});
+	esm_default.get("https://w3id.org/fep/7aa9", { status: 502 });
+	await t.test("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.test("deny non-HTTP/HTTPS", async () => {
 		await (0, node_assert.rejects)(() => fetchDocumentLoader("ftp://localhost"), require_url.UrlError);
 	});
@@ -1561,4 +1597,285 @@ var esm_default = new class FetchMock {
 	});
 	esm_default.hardReset();
 });
+(0, node_test.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, node_test.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, node_test.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, node_test.test)("getDocumentLoader() logs DNS failures as such", async (t) => {
+	if ("Deno" in globalThis && (await Deno.permissions.query({ name: "net" })).state !== "granted") {
+		t.skip("requires the net permission");
+		return;
+	}
+	const loader = require_docloader.getDocumentLoader();
+	for (const result of [
+		"throws",
+		"empty",
+		"private"
+	]) await t.test(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, node_test.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.test(`${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.test(`${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.test("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.test("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, node_test.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.test(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, node_test.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();
+	}
+});
 //#endregion

package/dist/tests/docloader.test.mjs

@@ -1,8 +1,12 @@
-import { n as preloadedContexts, r as cid_v1_default, t as getDocumentLoader } from "./docloader-D-CBVlrJ.mjs";
-import { t as FetchError } from "./request-DqsgdBUH.mjs";
-import { t as UrlError } from "./url-o0e-aXQY.mjs";
-import { deepStrictEqual, ok, rejects } from "node:assert";
+import { t as FetchError } from "./request-DxeGyJVh.mjs";
+import { i as cid_v1_default, n as getRemoteDocument, r as preloadedContexts, t as getDocumentLoader } from "./docloader-Beoc8qTH.mjs";
+import { t as UrlError } from "./url-3fyJuqC0.mjs";
 import { test } from "node:test";
+import { gzipSync } from "node:zlib";
+import { configure, reset } from "@logtape/logtape";
+import { deepStrictEqual, ok, rejects } from "node:assert";
+import dns from "node:dns/promises";
+import { createServer } from "node:http";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -1475,6 +1479,37 @@ test("getDocumentLoader()", async (t) => {
 			} }
 		});
 	});
+	esm_default.get("https://w3id.org/fep/7aa9", { status: 502 });
+	await t.test("preloaded FEP-7aa9 context", async () => {
+		const url = "https://w3id.org/fep/7aa9";
+		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"
+				}
+			} }
+		});
+		deepStrictEqual(esm_default.callHistory.calls(url).length, 0);
+	});
 	await t.test("deny non-HTTP/HTTPS", async () => {
 		await rejects(() => fetchDocumentLoader("ftp://localhost"), UrlError);
 	});
@@ -1580,5 +1615,286 @@ test("getDocumentLoader()", async (t) => {
 	});
 	esm_default.hardReset();
 });
+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 = getDocumentLoader({ allowPrivateAddress: true });
+		await rejects(loader(url), FetchError);
+		oversized = false;
+		deepStrictEqual((await loader(url)).document, { name: "hello" });
+		oversized = true;
+		esm_default.get(`${url}/html`, () => new Response(" ".repeat(1048577), { headers: { "Content-Type": "text/html" } }));
+		await rejects(getDocumentLoader({ allowPrivateAddress: true })(`${url}/html`), FetchError);
+		esm_default.get(`${url}/alternate`, () => new Response("", { headers: {
+			"Content-Type": "text/html",
+			Link: `<${url}>; rel="alternate"; type="application/activity+json"`
+		} }));
+		await rejects(loader(`${url}/alternate`), FetchError);
+		esm_default.get(`${url}/redirect`, {
+			status: 302,
+			headers: { Location: url }
+		});
+		await rejects(loader(`${url}/redirect`), FetchError);
+	} finally {
+		esm_default.hardReset();
+	}
+});
+test("getDocumentLoader() rejects oversized gzip responses from fetch", async () => {
+	const document = { name: "a".repeat(16 * 1024 * 1024) };
+	const compressed = gzipSync(JSON.stringify(document));
+	ok(compressed.byteLength < 64 * 1024);
+	const server = createServer((request, response) => {
+		const body = request.url === "/small" ? 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();
+		ok(address != null && typeof address !== "string");
+		const url = `http://127.0.0.1:${address.port}/document`;
+		await rejects(getDocumentLoader({ allowPrivateAddress: true })(url), FetchError);
+		deepStrictEqual((await 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();
+		});
+	}
+});
+test("getRemoteDocument() bounds JSON by default", async () => {
+	let canceled = false;
+	let pulls = 0;
+	await rejects(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");
+	}), FetchError);
+	deepStrictEqual(canceled, true);
+	deepStrictEqual(pulls, 257);
+});
+test("getDocumentLoader() logs DNS failures as such", async (t) => {
+	if ("Deno" in globalThis && (await Deno.permissions.query({ name: "net" })).state !== "granted") {
+		t.skip("requires the net permission");
+		return;
+	}
+	const loader = getDocumentLoader();
+	for (const result of [
+		"throws",
+		"empty",
+		"private"
+	]) await t.test(result, async () => {
+		const originalLookup = dns.lookup;
+		dns.lookup = (() => result === "throws" ? Promise.reject(/* @__PURE__ */ new Error("Resolver unavailable")) : Promise.resolve(result === "empty" ? [] : [{
+			address: "127.0.0.1",
+			family: 4
+		}]));
+		const records = [];
+		await 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 rejects(() => loader(url), (e) => {
+				error = e;
+				return true;
+			});
+			ok(error instanceof UrlError);
+			deepStrictEqual(error.reason, result === "private" ? "disallowed" : "dns");
+			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
+			]]);
+			ok(records[0].properties.error === error);
+		} finally {
+			await reset();
+			dns.lookup = originalLookup;
+		}
+	});
+});
+test("getDocumentLoader() bounds alternate document chains", async (t) => {
+	const base = "https://example.com/alternate-chain/";
+	const loader = getDocumentLoader({ allowPrivateAddress: true });
+	for (const mode of [
+		"header",
+		"html",
+		"mixed"
+	]) for (const hops of [20, 21]) await t.test(`${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) deepStrictEqual((await loader(`${base}0`)).document, { done: true });
+			else await rejects(loader(`${base}0`), (error) => {
+				ok(error instanceof FetchError);
+				ok(error.message.includes("Too many redirections (21)"));
+				return true;
+			});
+			deepStrictEqual(requests, 21);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	for (const mode of [
+		"header",
+		"html",
+		"alternate-redirect",
+		"redirect-alternate",
+		"redirect-intermediate"
+	]) await t.test(`${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 rejects(loader(`${base}0`), (error) => {
+				ok(error instanceof FetchError);
+				ok(error.message.includes("Redirect loop detected:"));
+				return true;
+			});
+			deepStrictEqual(requests, mode === "redirect-intermediate" ? 3 : 2);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	await t.test("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 rejects(loader(`${base}0`), (error) => {
+				ok(error instanceof FetchError);
+				ok(error.message.includes("Too many redirections (21)"));
+				return true;
+			});
+			deepStrictEqual(requests, 21);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	await t.test("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) {
+					deepStrictEqual(result.document, { done: true });
+					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"`
+		} });
+	}
+});
+test("getDocumentLoader() preserves cancellation across alternates", async (t) => {
+	const base = "https://example.com/alternate-abort/";
+	const loader = getDocumentLoader({ allowPrivateAddress: true });
+	for (const html of [false, true]) await t.test(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 rejects(loader(`${base}0`, { signal: controller.signal }), { name: "AbortError" });
+			deepStrictEqual(requests, 2);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+});
+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 = getDocumentLoader({ allowPrivateAddress: true });
+		const controller = new AbortController();
+		controller.abort();
+		await rejects(loader(url, { signal: controller.signal }), { name: "AbortError" });
+		deepStrictEqual(requests, 0);
+	} finally {
+		esm_default.hardReset();
+	}
+});
 //#endregion
 export {};