@fedify/fedify 2.4.0-dev.2164 → 2.4.0-dev.2190

package/dist/sig/owner.test.mjs

@@ -6,7 +6,7 @@ import { t as assertFalse } from "../assert_false-CPdRnc3E.mjs";
 import "../std__assert-DvMDRPes.mjs";
 import { t as assert } from "../assert-D1Eafmd_.mjs";
 import { o as rsaPublicKey1, s as rsaPublicKey2 } from "../keys-DIJNHW-Y.mjs";
-import { n as getKeyOwner, t as doesActorOwnKey } from "../owner-DKdtsrEq.mjs";
+import { n as getKeyOwner, t as doesActorOwnKey } from "../owner-Dem4fbwc.mjs";
 import { Create, CryptographicKey, lookupObject } from "@fedify/vocab";
 import { createTestTracerProvider, mockDocumentLoader, test } from "@fedify/fixture";
 //#region src/sig/owner.test.ts

package/dist/sig/portable-collection.test.mjs

@@ -2,7 +2,7 @@ import "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 import { n as ed25519PrivateKey, r as ed25519PublicKey } from "../keys-DIJNHW-Y.mjs";
-import { t as verifyPortableObject } from "../portable-collection-Cb5cdPIU.mjs";
+import { t as verifyPortableObject } from "../portable-collection-BL6aZlQ0.mjs";
 import { Collection, CollectionPage, Note, OrderedCollection, Person, traverseCollection } from "@fedify/vocab";
 import { test } from "@fedify/fixture";
 import { FetchError, encodeMultibase, exportDidKey, preloadedContexts } from "@fedify/vocab-runtime";

package/dist/sig/portable-key-id.test.d.mts

@@ -0,0 +1,2 @@
+import { Temporal } from "temporal-polyfill";
+import { URLPattern } from "urlpattern-polyfill";

package/dist/sig/portable-key-id.test.mjs

@@ -0,0 +1,67 @@
+import "temporal-polyfill";
+import "urlpattern-polyfill";
+globalThis.addEventListener = () => {};
+import { t as assertEquals } from "../assert_equals-Z6IcEbWU.mjs";
+import { t as assertFalse } from "../assert_false-CPdRnc3E.mjs";
+import "../std__assert-DvMDRPes.mjs";
+import { t as assert } from "../assert-D1Eafmd_.mjs";
+import { f as isSameObjectId, t as getAuthenticationOrigin } from "../portable-key-id-Ca30-hOa.mjs";
+import { r as ed25519PublicKey } from "../keys-DIJNHW-Y.mjs";
+import { test } from "@fedify/fixture";
+import { exportDidKey, parseIri } from "@fedify/vocab-runtime";
+//#region src/sig/portable-key-id.test.ts
+const did = await exportDidKey(ed25519PublicKey.publicKey);
+const otherDid = await exportDidKey((await crypto.subtle.generateKey("Ed25519", true, ["sign", "verify"])).publicKey);
+test("getAuthenticationOrigin()", () => {
+	for (const id of [
+		parseIri(`ap://${did}/actor`),
+		parseIri(`ap+ef61://${did}/actor`),
+		parseIri(`ap+ef61://${encodeURIComponent(did)}/actor#main-key`),
+		parseIri(`ap://${did}/actor?@gateway=https%3A%2F%2Fgw.example`),
+		new URL(`https://gw.example/.well-known/apgateway/${did}/actor`),
+		new URL(`https://gw2.example/.well-known/apgateway/${did}/objects/1`),
+		new URL(`${did}#${did.slice(8)}`)
+	]) assertEquals(getAuthenticationOrigin(id), did, id.href);
+	assertEquals(getAuthenticationOrigin(parseIri(`ap+ef61://${otherDid}/actor`)), otherDid);
+	assertEquals(getAuthenticationOrigin(new URL("https://example.com:443/users/alice")), "https://example.com");
+	assertEquals(getAuthenticationOrigin(new URL("http://example.com:8080/users/alice")), "http://example.com:8080");
+	for (const id of [
+		new URL(`https://gw.example/.well-known/apgateway/${did}/actor?@gateway=https%3A%2F%2Fgw.example`),
+		new URL("https://gw.example/.well-known/apgateway/did:key:invalid!/a"),
+		new URL(`https://gw.example/.well-known/apgateway/${did}`),
+		new URL(`https://gw.example/.well-known/apgateway/${did}/actor%ZZ`),
+		new URL("urn:uuid:3d6f4c1e-2f8b-4d1a-9c6e-7b8a9d0e1f2a"),
+		new URL("tag:example.com,2026:actor")
+	]) assertEquals(getAuthenticationOrigin(id), null, id.href);
+});
+test("isSameObjectId()", () => {
+	const portable = parseIri(`ap+ef61://${did}/activities/1`);
+	for (const id of [
+		parseIri(`ap://${did}/activities/1`),
+		parseIri(`ap+ef61://${encodeURIComponent(did)}/activities/1`),
+		parseIri(`ap://${did}/activities/1?@gateway=https%3A%2F%2Fgw.example`),
+		new URL(`https://gw.example/.well-known/apgateway/${did}/activities/1`),
+		new URL(`https://gw2.example/.well-known/apgateway/${did}/activities/1`)
+	]) {
+		assert(isSameObjectId(portable, id), id.href);
+		assert(isSameObjectId(id, portable), id.href);
+	}
+	for (const id of [
+		parseIri(`ap+ef61://${otherDid}/activities/1`),
+		parseIri(`ap+ef61://${did}/activities/2`),
+		parseIri(`ap+ef61://${did}/activities/1#fragment`),
+		new URL(`https://gw.example/.well-known/apgateway/${did}/activities/1%ZZ`),
+		new URL("https://gw.example/activities/1")
+	]) {
+		assertFalse(isSameObjectId(portable, id), id.href);
+		assertFalse(isSameObjectId(id, portable), id.href);
+	}
+	const malformed = new URL(`https://gw.example/.well-known/apgateway/${did}/activities/1%ZZ`);
+	assertFalse(isSameObjectId(malformed, malformed));
+	const http = new URL("https://example.com/activities/1");
+	assert(isSameObjectId(http, new URL("https://example.com/activities/1")));
+	assertFalse(isSameObjectId(http, new URL("https://example.com/activities/1#a")));
+	assertFalse(isSameObjectId(http, new URL("https://example.com/activities/1?a")));
+});
+//#endregion
+export {};

package/dist/sig/portable-key.test.mjs

@@ -2,13 +2,14 @@ import { Temporal } from "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 import { t as MemoryKvStore } from "../kv-DCHkaJ9-.mjs";
-import { i as fetchKey } from "../key-D5awqp7u.mjs";
-import { h as verifyJsonLd, p as signJsonLd } from "../ld-CyliEU48.mjs";
-import { d as verifyProof, r as createProof } from "../proof-CRTPWbVh.mjs";
-import { d as verifyRequest, f as verifyRequestDetailed, l as signRequest } from "../http-DRH0n8TD.mjs";
+import { a as fetchKeyDetailed, i as fetchKey } from "../key-DyXf88bq.mjs";
+import { h as verifyJsonLd, p as signJsonLd } from "../ld-oQj6j_hP.mjs";
+import { d as verifyProof, r as createProof } from "../proof-C9115DX_.mjs";
+import { n as resolvePortableActorKey } from "../portable-key-Duue9Y2Y.mjs";
+import { f as verifyRequest, l as signRequest, p as verifyRequestDetailed } from "../http-Y1ObT1A8.mjs";
 import { a as rsaPrivateKey3, c as rsaPublicKey3, i as rsaPrivateKey2, n as ed25519PrivateKey, r as ed25519PublicKey, s as rsaPublicKey2 } from "../keys-DIJNHW-Y.mjs";
-import { n as getKeyOwner, t as doesActorOwnKey } from "../owner-DKdtsrEq.mjs";
-import { t as KvKeyCache } from "../keycache-PiOM9pM0.mjs";
+import { n as getKeyOwner, t as doesActorOwnKey } from "../owner-Dem4fbwc.mjs";
+import { t as KvKeyCache } from "../keycache-Da8A8mZa.mjs";
 import { Create, CryptographicKey, Multikey, Note, Person } from "@fedify/vocab";
 import { test } from "@fedify/fixture";
 import { FetchError, encodeMultibase, exportDidKey, exportSpki, parseIri, preloadedContexts } from "@fedify/vocab-runtime";
@@ -965,7 +966,21 @@ test("verifyRequest() tries the gateways of ap: key IDs in order", async () => {
 		documentLoader: many,
 		contextLoader
 	})).verified);
-	deepStrictEqual(many.fetched, gateways.slice(0, 5).map((g) => compatibleId(g)));
+	deepStrictEqual(many.fetched, gateways.slice(0, 3).map((g) => compatibleId(g)));
+	for (const [index, expected] of [[2, true], [3, false]]) {
+		const documentLoader = createLoader({ [compatibleId(gateways[index])]: signed });
+		strictEqual(await verifyRequest(await signedRequest(void 0, hinted(...gateways)), {
+			documentLoader,
+			contextLoader
+		}) != null, expected, `gateway ${index + 1}`);
+		deepStrictEqual(documentLoader.fetched, gateways.slice(0, 3).map((g) => compatibleId(g)), `gateway ${index + 1}`);
+	}
+	const sparse = createLoader({ [compatibleId(gateways[2])]: signed });
+	ok(await verifyRequest(await signedRequest(void 0, hinted("not a gateway", gateways[0], gateways[0].toUpperCase(), "https://gw.example/path", gateways[1], gateways[2])), {
+		documentLoader: sparse,
+		contextLoader
+	}) != null);
+	deepStrictEqual(sparse.fetched, gateways.slice(0, 3).map((g) => compatibleId(g)));
 });
 function failingLoader(responses) {
 	const fetched = [];
@@ -1189,5 +1204,236 @@ test("verifyRequest() does not cache keys at ap: key IDs it could not process",
 	strictEqual((await verifyRequest(await signedRequest(void 0, hintedKeyId), options))?.ownerId?.href, parseIri(actorId).href);
 	strictEqual(documentLoader.fetched.length, 2);
 });
+/**
+* A loader that serves the given responses, and never responds for the URLs
+* in `hanging`.  A hanging response is given up when its signal aborts,
+* unless `ignoreSignal` is set.
+*/
+function controlledLoader(responses, hanging, { ignoreSignal = false, delays = {} } = {}) {
+	const fetched = [];
+	const signals = [];
+	const respond = failingLoader(responses);
+	const loader = async (url, options) => {
+		fetched.push(url);
+		signals.push(options?.signal);
+		const signal = ignoreSignal ? void 0 : options?.signal;
+		const delay = delays[url];
+		if (delay != null) await new Promise((resolve) => setTimeout(resolve, delay));
+		if (hanging.includes(url)) return await new Promise((_, reject) => {
+			signal?.addEventListener("abort", () => reject(signal.reason));
+		});
+		return await respond(url);
+	};
+	return Object.assign(loader, {
+		fetched,
+		signals
+	});
+}
+function isTimeoutError(error) {
+	return error instanceof DOMException && error.name === "TimeoutError";
+}
+test("resolvePortableActorKey() gives up gateways that do not respond in time", async () => {
+	const signed = await sign(await apActorJson());
+	for (const ignoreSignal of [false, true]) {
+		const documentLoader = controlledLoader({ [compatibleId(gw2)]: signed }, [compatibleId(gw1)], { ignoreSignal });
+		const resolution = await resolvePortableActorKey(hinted(gw1, gw2), {
+			documentLoader,
+			contextLoader,
+			lookupTimeout: 50
+		});
+		strictEqual(resolution.type, "unavailable", `ignoreSignal: ${ignoreSignal}`);
+		if (resolution.type === "unavailable") strictEqual(resolution.cacheable, false);
+		deepStrictEqual(documentLoader.fetched, [compatibleId(gw1)]);
+		const [signal] = documentLoader.signals;
+		ok(signal?.aborted);
+		ok(isTimeoutError(signal.reason));
+	}
+});
+test("resolvePortableActorKey() caches timeouts only as failures to fetch", async () => {
+	const invalid = await apActorJson();
+	const cases = [
+		{
+			name: "the only gateway times out",
+			responses: {},
+			hanging: [compatibleId(gw1)],
+			hints: [gw1],
+			cacheable: true
+		},
+		{
+			name: "a gateway responds with 404, and the last one times out",
+			responses: { [compatibleId(gw1)]: 404 },
+			hanging: [compatibleId(gw2)],
+			hints: [gw1, gw2],
+			cacheable: true
+		},
+		{
+			name: "a gateway serves an invalid document, and the last one times out",
+			responses: { [compatibleId(gw1)]: invalid },
+			hanging: [compatibleId(gw2)],
+			hints: [gw1, gw2],
+			cacheable: false
+		},
+		{
+			name: "the document loader cannot resolve the ap: URI in time",
+			responses: {},
+			hanging: [actorId],
+			hints: [],
+			cacheable: true
+		}
+	];
+	for (const { name, responses, hanging, hints, cacheable } of cases) {
+		const documentLoader = controlledLoader(responses, hanging);
+		const resolution = await resolvePortableActorKey(hinted(...hints), {
+			documentLoader,
+			contextLoader,
+			lookupTimeout: 50
+		});
+		strictEqual(resolution.type, "unavailable", name);
+		if (resolution.type !== "unavailable") continue;
+		strictEqual(resolution.cacheable, cacheable, name);
+		ok(!(resolution.error instanceof FetchError), name);
+		if (hanging.length === 1 && hints.length < 2) ok(isTimeoutError(resolution.error), name);
+	}
+});
+test("resolvePortableActorKey() shares one timeout among all gateways", async () => {
+	const documentLoader = controlledLoader({ [compatibleId(gw1)]: 404 }, [compatibleId(gw2)], { delays: { [compatibleId(gw1)]: 250 } });
+	const started = Date.now();
+	const resolution = await resolvePortableActorKey(hinted(gw1, gw2), {
+		documentLoader,
+		contextLoader,
+		lookupTimeout: 300
+	});
+	const elapsed = Date.now() - started;
+	ok(elapsed < 500, `took ${elapsed} ms`);
+	strictEqual(resolution.type, "unavailable");
+	deepStrictEqual(documentLoader.fetched, [compatibleId(gw1), compatibleId(gw2)]);
+	ok(documentLoader.signals[1]?.aborted);
+});
+test("resolvePortableActorKey() bounds loading the contexts of actor documents", async () => {
+	const documentLoader = controlledLoader({ [compatibleId(gw1)]: await sign(await apActorJson()) }, []);
+	const hangingContextLoader = (_url, options) => new Promise((_, reject) => {
+		options?.signal?.addEventListener("abort", () => reject(options.signal.reason));
+	});
+	const resolution = await resolvePortableActorKey(hinted(gw1, gw2), {
+		documentLoader,
+		contextLoader: hangingContextLoader,
+		lookupTimeout: 50
+	});
+	strictEqual(resolution.type, "unavailable");
+	if (resolution.type === "unavailable") strictEqual(resolution.cacheable, false);
+	deepStrictEqual(documentLoader.fetched, [compatibleId(gw1)]);
+});
+test("resolvePortableActorKey() ignores what is resolved after the timeout", async () => {
+	let verifiedLate = () => {};
+	const late = new Promise((resolve) => verifiedLate = resolve);
+	let lookupDone = () => {};
+	const done = new Promise((resolve) => lookupDone = resolve);
+	const slowKeyCache = {
+		async get() {
+			await done;
+		},
+		set() {
+			verifiedLate();
+			return Promise.resolve();
+		}
+	};
+	const documentLoader = controlledLoader({ [compatibleId(gw1)]: await sign(await apActorJson()) }, []);
+	const resolution = await resolvePortableActorKey(hinted(gw1), {
+		documentLoader,
+		contextLoader,
+		keyCache: slowKeyCache,
+		lookupTimeout: 300
+	});
+	lookupDone();
+	strictEqual(resolution.type, "unavailable");
+	if (resolution.type === "unavailable") strictEqual(resolution.cacheable, false);
+	await late;
+	const lateRejection = controlledLoader({}, [], { delays: { [compatibleId(gw1)]: 60 } });
+	strictEqual((await resolvePortableActorKey(hinted(gw1), {
+		documentLoader: lateRejection,
+		contextLoader,
+		lookupTimeout: 20
+	})).type, "unavailable");
+	await new Promise((resolve) => setTimeout(resolve, 80));
+});
+test("resolvePortableActorKey() validates the lookup timeout", async () => {
+	const documentLoader = controlledLoader({}, []);
+	for (const lookupTimeout of [
+		-1,
+		NaN,
+		Infinity,
+		2 ** 31
+	]) {
+		let error;
+		try {
+			await resolvePortableActorKey(hinted(gw1), {
+				documentLoader,
+				contextLoader,
+				lookupTimeout
+			});
+		} catch (e) {
+			error = e;
+		}
+		ok(error instanceof RangeError, String(lookupTimeout));
+	}
+	const resolution = await resolvePortableActorKey(hinted(gw1), {
+		documentLoader,
+		contextLoader,
+		lookupTimeout: 0
+	});
+	strictEqual(resolution.type, "unavailable");
+	if (resolution.type === "unavailable") strictEqual(resolution.cacheable, false);
+	deepStrictEqual(documentLoader.fetched, []);
+});
+test("fetchKeyDetailed() caches keys at ap: key IDs that time out as fetch failures", async () => {
+	const cases = [{
+		responses: { [compatibleId(gw1)]: 404 },
+		hanging: [compatibleId(gw2)],
+		cached: true
+	}, {
+		responses: {},
+		hanging: [compatibleId(gw1)],
+		cached: false
+	}];
+	for (const { responses, hanging, cached } of cases) {
+		const documentLoader = controlledLoader(responses, hanging);
+		const keyCache = new KvKeyCache(new MemoryKvStore(), ["pk"]);
+		const options = {
+			documentLoader,
+			contextLoader,
+			keyCache,
+			portableKeyResolvers: {
+				gatewayKey: () => Promise.resolve({ type: "legacy" }),
+				actorKey: (keyId) => resolvePortableActorKey(keyId, {
+					documentLoader,
+					contextLoader,
+					lookupTimeout: 50
+				})
+			}
+		};
+		const hintedKeyId = hinted(gw1, gw2);
+		for (let i = 0; i < 2; i++) {
+			const result = await fetchKeyDetailed(hintedKeyId, CryptographicKey, options);
+			strictEqual(result.key, null);
+			strictEqual(result.cached, cached && i > 0, `${cached}, ${i}`);
+			ok(result.fetchError == null || !("status" in result.fetchError), "a timeout has no HTTP status");
+		}
+		strictEqual(documentLoader.fetched.filter((url) => url === compatibleId(gw1)).length, cached ? 1 : 2);
+	}
+});
+test("verifyRequestDetailed() reports keys at ap: key IDs that time out as fetch errors", async () => {
+	const timeout = new DOMException("Timed out", "TimeoutError");
+	const documentLoader = () => Promise.reject(timeout);
+	for (const spec of specs) {
+		const result = await verifyRequestDetailed(await signedRequest(spec, hinted(gw1)), {
+			documentLoader,
+			contextLoader,
+			spec
+		});
+		ok(!result.verified, spec);
+		strictEqual(result.reason.type, "keyFetchError", spec);
+		if (result.reason.type === "keyFetchError") ok(!("status" in result.reason.result), spec);
+	}
+});
 //#endregion
 export {};

package/dist/sig/proof.test.mjs

@@ -10,10 +10,10 @@ import "../std__assert-DvMDRPes.mjs";
 import { t as assertRejects } from "../assert_rejects-CTptdYck.mjs";
 import { t as assert } from "../assert-D1Eafmd_.mjs";
 import { r as normalizeOutgoingActivityJsonLd } from "../outgoing-jsonld-4IJqPYos.mjs";
-import { a as signObject, c as verifyPortableObjectProof, d as verifyProof, i as hasProofLike, r as createProof, s as verifyObject } from "../proof-CRTPWbVh.mjs";
-import { d as verifyRequest } from "../http-DRH0n8TD.mjs";
+import { a as signObject, c as verifyPortableObjectProof, d as verifyProof, i as hasProofLike, r as createProof, s as verifyObject } from "../proof-C9115DX_.mjs";
+import { f as verifyRequest } from "../http-Y1ObT1A8.mjs";
 import { i as rsaPrivateKey2, n as ed25519PrivateKey, r as ed25519PublicKey, s as rsaPublicKey2, t as ed25519Multikey } from "../keys-DIJNHW-Y.mjs";
-import { t as getAuthenticatedDocumentLoader } from "../docloader-BBFAItNB.mjs";
+import { t as getAuthenticatedDocumentLoader } from "../docloader-u6zzOExF.mjs";
 import { Create, DataIntegrityProof, Document, Multikey, Note, PUBLIC_COLLECTION, Place, Translation } from "@fedify/vocab";
 import { createTestMeterProvider, mockDocumentLoader, test } from "@fedify/fixture";
 import { decodeMultibase, encodeMultibase, exportDidKey, exportMultibaseKey, formatIri, importMultibaseKey, parseIri } from "@fedify/vocab-runtime";

package/dist/{temporal-Dhsk6aUT.mjs → temporal-DKchpKyp.mjs}

@@ -1,7 +1,7 @@
 import { Temporal } from "temporal-polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { c as getNormalizationContextLoader } from "./ld-CyliEU48.mjs";
+import { c as getNormalizationContextLoader } from "./ld-oQj6j_hP.mjs";
 import jsonld from "@fedify/vocab-runtime/jsonld";
 //#region src/federation/temporal.ts
 function isPlainObject(value) {

package/dist/testing/kv.test.mjs

@@ -6,7 +6,7 @@ import { t as MemoryKvStore } from "../kv-DCHkaJ9-.mjs";
 import { t as ManualClockKvStore } from "../kv-DBRWVx3Q.mjs";
 import { n as baseOptions, o as stringSchema, t as MockQueue } from "../tasks-IG3pHfvZ.mjs";
 import { t as assertEquals } from "../assert_equals-Z6IcEbWU.mjs";
-import { o as createFederation } from "../middleware-B99JjvFn.mjs";
+import { o as createFederation } from "../middleware-Bdu2-OPD.mjs";
 //#region src/testing/kv.test.ts
 test("ManualClockKvStore keeps an entry at its exact expiration instant", async () => {
 	const kv = new ManualClockKvStore();

package/dist/testing/mod.d.mts

@@ -2275,6 +2275,35 @@ interface FederationOptions<TContextData> {
    * @since 1.3.0
    */
   userAgent?: GetUserAgentOptions | string;
+  /**
+   * The timeout for each call of the built-in document loader, context
+   * loader, and authenticated document loader, e.g., when Fedify fetches
+   * a key to verify a signature.  The timeout is shared by all the steps of
+   * a call, including every redirect it follows, retries, and reading the
+   * response body.  It does not cover the time spent reading from or
+   * writing to the cache.
+   *
+   * A timed-out call throws a `FetchError` without a response, whose
+   * `cause` is a `DOMException` named `"TimeoutError"`, so that, e.g.,
+   * a key fetch that times out is reported as a `keyFetchError` and cached
+   * like other failures to fetch a key.
+   *
+   * It does not affect loaders made by
+   * {@link FederationOptions.documentLoaderFactory},
+   * {@link FederationOptions.contextLoaderFactory}, or
+   * {@link FederationOptions.authenticatedDocumentLoaderFactory}.
+   * Note that if only {@link FederationOptions.documentLoaderFactory} is
+   * set, it also makes context loaders.
+   *
+   * Set it to `null` to turn off the timeout.
+   *
+   * 10 seconds by default.
+   * @throws {RangeError} If the duration is not positive, is longer than
+   *                      about 24.8 days, or is given in calendar units
+   *                      such as months.
+   * @since 2.4.0
+   */
+  documentLoaderTimeout?: Temporal.Duration | Temporal.DurationLike | null;
   /**
    * A callback that handles errors during outbox processing.  Note that this
    * callback can be called multiple times for the same activity, because
@@ -2303,6 +2332,29 @@ interface FederationOptions<TContextData> {
    * By default, the window is an hour.
    */
   signatureTimeWindow?: Temporal.Duration | Temporal.DurationLike | false;
+  /**
+   * The maximum number of [RFC 9421] signatures of an incoming request to
+   * verify, e.g., in the inbox and in
+   * {@link RequestContext.getSignedKey}.  A request can carry several
+   * signatures, each of which may make Fedify fetch the key that it names,
+   * so only the first ones in the order of the `Signature-Input` header are
+   * verified, and the rest are ignored as if they were absent.  Every
+   * signature among the first ones counts, even if it fails before its key
+   * is fetched.  See also the `maxSignatures` option of `verifyRequest()`.
+   *
+   * It has to be a positive integer, or `Infinity` to verify every
+   * signature, which lets a single request make Fedify fetch any number of
+   * keys.  Draft-cavage HTTP Signatures carry a single signature, so this
+   * option does not affect them.
+   *
+   * Three by default.
+   *
+   * [RFC 9421]: https://www.rfc-editor.org/rfc/rfc9421
+   * @throws {RangeError} Thrown when the federation is created if the value
+   *         is not a positive integer or `Infinity`.
+   * @since 2.4.0
+   */
+  maxHttpSignatures?: number;
   /**
    * Whether to skip HTTP Signatures verification for incoming activities.
    * This is useful for testing purposes, but should not be used in production.

package/dist/utils/docloader.test.mjs

@@ -5,9 +5,9 @@ import { t as esm_default } from "../esm-BHXXx4Wx.mjs";
 import { t as assertEquals } from "../assert_equals-Z6IcEbWU.mjs";
 import "../std__assert-DvMDRPes.mjs";
 import { t as assertRejects } from "../assert_rejects-CTptdYck.mjs";
-import { d as verifyRequest } from "../http-DRH0n8TD.mjs";
+import { f as verifyRequest } from "../http-Y1ObT1A8.mjs";
 import { i as rsaPrivateKey2 } from "../keys-DIJNHW-Y.mjs";
-import { t as getAuthenticatedDocumentLoader } from "../docloader-BBFAItNB.mjs";
+import { t as getAuthenticatedDocumentLoader } from "../docloader-u6zzOExF.mjs";
 import { configure, reset } from "@logtape/logtape";
 import { mockDocumentLoader, test } from "@fedify/fixture";
 import { FetchError, UrlError } from "@fedify/vocab-runtime";
@@ -534,5 +534,96 @@ test("getAuthenticatedDocumentLoader() rejects cancellation before fetching", as
 		esm_default.hardReset();
 	}
 });
+function assertTimeoutFetchError(error, url) {
+	ok(error instanceof FetchError, String(error));
+	deepStrictEqual(error.url.href, url);
+	deepStrictEqual(error.response, void 0);
+	ok(error.cause instanceof DOMException);
+	deepStrictEqual(error.cause.name, "TimeoutError");
+	return true;
+}
+test("getAuthenticatedDocumentLoader() times out", async (t) => {
+	const identity = {
+		keyId: new URL("https://example.com/key2"),
+		privateKey: rsaPrivateKey2
+	};
+	const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+	await t.step("a request without a response", async () => {
+		esm_default.mockGlobal();
+		const url = "https://example.com/hang";
+		esm_default.get(url, () => new Promise(() => {}));
+		try {
+			await rejects(getAuthenticatedDocumentLoader(identity, {
+				allowPrivateAddress: true,
+				timeout: 100
+			})(url), (e) => assertTimeoutFetchError(e, url));
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	await t.step("double-knocking shares the timeout", async () => {
+		esm_default.mockGlobal();
+		const url = "https://example.com/double-knock";
+		let requests = 0;
+		esm_default.get(url, async () => {
+			requests++;
+			await delay(80);
+			return new Response(null, { status: 401 });
+		});
+		try {
+			await rejects(getAuthenticatedDocumentLoader(identity, {
+				allowPrivateAddress: true,
+				timeout: 120
+			})(url), (e) => assertTimeoutFetchError(e, url));
+			deepStrictEqual(requests, 2);
+			await delay(100);
+			deepStrictEqual(requests, 2);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	for (const step of ["determineSpec", "rememberSpec"]) await t.step(`a slow ${step}()`, async () => {
+		esm_default.mockGlobal();
+		const url = `https://example.com/slow-${step}`;
+		let requests = 0;
+		esm_default.get(url, () => {
+			requests++;
+			return Response.json({ parsed: true });
+		});
+		try {
+			await rejects(getAuthenticatedDocumentLoader(identity, {
+				allowPrivateAddress: true,
+				timeout: 50,
+				specDeterminer: {
+					async determineSpec() {
+						if (step === "determineSpec") await delay(150);
+						return "rfc9421";
+					},
+					async rememberSpec() {
+						if (step === "rememberSpec") await delay(150);
+					}
+				}
+			})(url), (e) => assertTimeoutFetchError(e, url));
+			await delay(200);
+			deepStrictEqual(requests, step === "determineSpec" ? 0 : 1);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	await t.step("the caller's signal still aborts", async () => {
+		esm_default.mockGlobal();
+		const url = "https://example.com/hang";
+		esm_default.get(url, () => new Promise(() => {}));
+		try {
+			const loader = getAuthenticatedDocumentLoader(identity, { allowPrivateAddress: true });
+			const controller = new AbortController();
+			const reason = /* @__PURE__ */ new Error("Canceled by the caller");
+			setTimeout(() => controller.abort(reason), 50);
+			await rejects(loader(url, { signal: controller.signal }), (e) => e === reason);
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+});
 //#endregion
 export {};

package/dist/utils/kv-cache.test.mjs

@@ -1,7 +1,7 @@
 import { Temporal } from "temporal-polyfill";
 import { URLPattern } from "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { n as kvCache, t as MockKvStore } from "../kv-cache-C7RWL7hz.mjs";
+import { n as kvCache, t as MockKvStore } from "../kv-cache-C8YjNAi_.mjs";
 import { deepStrictEqual, throws } from "node:assert";
 import { createTestMeterProvider, mockDocumentLoader, test } from "@fedify/fixture";
 import { preloadedContexts } from "@fedify/vocab-runtime";

package/dist/utils/mod.cjs

@@ -1,5 +1,5 @@
 const { URLPattern } = require("urlpattern-polyfill");
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_kv_cache = require("../kv-cache-Ct-KWRta.cjs");
+const require_kv_cache = require("../kv-cache-DUXluAc0.cjs");
 exports.getAuthenticatedDocumentLoader = require_kv_cache.getAuthenticatedDocumentLoader;
 exports.kvCache = require_kv_cache.kvCache;

package/dist/utils/mod.d.cts

@@ -1,3 +1,3 @@
 /// <reference lib="esnext.temporal" />
-import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../mod-BA_F2x53.cjs";
+import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../mod-Dp3Ij7sw.cjs";
 export { getAuthenticatedDocumentLoader, kvCache };

package/dist/utils/mod.d.ts

@@ -1,3 +1,3 @@
 /// <reference lib="esnext.temporal" />
-import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../mod-B5z_q9TH.js";
+import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../mod-C5Mwx5ty.js";
 export { getAuthenticatedDocumentLoader, kvCache };

package/dist/utils/mod.js

@@ -1,4 +1,4 @@
 import { Temporal } from "temporal-polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../kv-cache-CZiBDLPi.js";
+import { n as getAuthenticatedDocumentLoader, t as kvCache } from "../kv-cache-C02XitwK.js";
 export { getAuthenticatedDocumentLoader, kvCache };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/fedify",
-  "version": "2.4.0-dev.2164+db2b8571",
+  "version": "2.4.0-dev.2190+be3a8be0",
   "description": "An ActivityPub server framework",
   "keywords": [
     "ActivityPub",
@@ -151,10 +151,10 @@
     "structured-field-values": "^2.0.4",
     "temporal-polyfill": "^1.0.1",
     "urlpattern-polyfill": "^10.1.0",
-    "@fedify/webfinger": "2.4.0-dev.2164+db2b8571",
-    "@fedify/uri-template": "2.4.0-dev.2164+db2b8571",
-    "@fedify/vocab": "2.4.0-dev.2164+db2b8571",
-    "@fedify/vocab-runtime": "2.4.0-dev.2164+db2b8571"
+    "@fedify/uri-template": "2.4.0-dev.2190+be3a8be0",
+    "@fedify/vocab-runtime": "2.4.0-dev.2190+be3a8be0",
+    "@fedify/vocab": "2.4.0-dev.2190+be3a8be0",
+    "@fedify/webfinger": "2.4.0-dev.2190+be3a8be0"
   },
   "devDependencies": {
     "@std/assert": "npm:@jsr/std__assert@^0.226.0",
@@ -167,7 +167,7 @@
     "typescript": "^6.0.0",
     "wrangler": "^4.17.0",
     "@fedify/fixture": "2.0.0",
-    "@fedify/vocab-tools": "^2.4.0-dev.2164+db2b8571"
+    "@fedify/vocab-tools": "^2.4.0-dev.2190+be3a8be0"
   },
   "scripts": {
     "build:self": "tsdown",