@fedify/fedify 2.0.0-dev.1875 → 2.0.0-dev.196

package/dist/{middleware-Aqt52eK0.js → middleware-CxwWsgSo.js}

@@ -3,25 +3,28 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { Activity, Collection, CollectionPage, CryptographicKey, Link, Multikey, Object as Object$1, OrderedCollection, OrderedCollectionPage, RouterError, deno_default, getTypeId, lookupObject, lookupWebFinger, traverseCollection } from "./lookup-Bhv7efZB.js";
-import { getNodeInfo } from "./client-pY7-3icS.js";
-import { nodeInfoToJson } from "./types-C2XVl6gj.js";
-import { exportJwk, importJwk, validateCryptoKey } from "./key-BcT6cdMK.js";
-import { verifyRequest } from "./http-BIYwcgTd.js";
-import { detachSignature, hasSignature, signJsonLd, verifyJsonLd } from "./ld-DR6mmQjt.js";
-import { doesActorOwnKey, getKeyOwner } from "./owner-DEgLiB7Z.js";
-import { signObject, verifyObject } from "./proof-p3cmdfis.js";
-import { getAuthenticatedDocumentLoader } from "./docloader-BkhI_RcC.js";
-import { kvCache } from "./kv-cache-DN9pfMBe.js";
-import { routeActivity } from "./inbox-Dbt8hLxb.js";
-import { FederationBuilderImpl } from "./builder-CLT_zIyw.js";
-import { buildCollectionSynchronizationHeader } from "./collection-BzWsN9pB.js";
-import { KvKeyCache } from "./keycache-B8aIeTgt.js";
-import { acceptsJsonLd } from "./negotiation-C4nFufNk.js";
-import { createExponentialBackoffPolicy } from "./retry-CfF8Gn4d.js";
-import { extractInboxes, sendActivity } from "./send-CcKJ-npK.js";
-import { getDocumentLoader } from "@fedify/vocab-runtime";
+import { deno_default } from "./deno-i60L3ZJW.js";
+import { getNodeInfo } from "./client-Dg7OfUDA.js";
+import { RouterError } from "./router-D9eI0s4b.js";
+import { nodeInfoToJson } from "./types-CPz01LGH.js";
+import { exportJwk, importJwk, validateCryptoKey } from "./key-DBHCloAO.js";
+import { verifyRequest } from "./http-uzkhnm0W.js";
+import { detachSignature, hasSignature, signJsonLd, verifyJsonLd } from "./ld-CZgNIUGN.js";
+import { doesActorOwnKey, getKeyOwner } from "./owner-BDvRiO5T.js";
+import { signObject, verifyObject } from "./proof-XEPY5YKg.js";
+import { getAuthenticatedDocumentLoader } from "./docloader-BuOglEYx.js";
+import { kvCache } from "./kv-cache-BEeqyGER.js";
+import { routeActivity } from "./inbox-CxrUTds4.js";
+import { FederationBuilderImpl } from "./builder-R1Sfe-tb.js";
+import { buildCollectionSynchronizationHeader } from "./collection-CcnIw1qY.js";
+import { KvKeyCache } from "./keycache-DRxpZ5r9.js";
+import { acceptsJsonLd } from "./negotiation-5NPJL6zp.js";
+import { createExponentialBackoffPolicy } from "./retry-D4GJ670a.js";
+import { extractInboxes, sendActivity } from "./send-BdhhZ2MN.js";
 import { getLogger, withContext } from "@logtape/logtape";
+import { Activity, Collection, CollectionPage, CryptographicKey, Link, Multikey, Object as Object$1, OrderedCollection, OrderedCollectionPage, getTypeId, lookupObject, traverseCollection } from "@fedify/vocab";
+import { getDocumentLoader } from "@fedify/vocab-runtime";
+import { lookupWebFinger } from "@fedify/webfinger";
 import { SpanKind, SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
 import { ATTR_HTTP_REQUEST_HEADER, ATTR_HTTP_REQUEST_METHOD, ATTR_HTTP_RESPONSE_HEADER, ATTR_HTTP_RESPONSE_STATUS_CODE, ATTR_URL_FULL } from "@opentelemetry/semantic-conventions";
 import { domainToASCII } from "node:url";
@@ -62,7 +65,7 @@ function autoIdAssigner(activity, context$1) {
 * activity like this:
 *
 * ```typescript
-* import { Follow, Person } from "@fedify/fedify/vocab";
+* import { Follow, Person } from "@fedify/vocab";
 * const input = new Follow({
 *   id: new URL("http://example.com/activities/1"),
 *   actor: new Person({
@@ -81,7 +84,7 @@ function autoIdAssigner(activity, context$1) {
 * The result of applying this transformer would be:
 *
 * ```typescript
-* import { Follow, Person } from "@fedify/fedify/vocab";
+* import { Follow, Person } from "@fedify/vocab";
 * const output = new Follow({
 *   id: new URL("http://example.com/activities/1"),
 *   actor: new URL("http://example.com/actors/1"),
@@ -154,151 +157,6 @@ function handleNodeInfoJrd(_request, context$1) {
 	return Promise.resolve(response);
 }
 
-//#endregion
-//#region src/vocab/constants.ts
-/**
-* The special public collection for [public addressing].  *Do not mutate this
-* object.*
-*
-* [public addressing]: https://www.w3.org/TR/activitypub/#public-addressing
-*
-* @since 0.7.0
-*/
-const PUBLIC_COLLECTION = new URL("https://www.w3.org/ns/activitystreams#Public");
-
-//#endregion
-//#region src/webfinger/handler.ts
-const logger = getLogger([
-	"fedify",
-	"webfinger",
-	"server"
-]);
-/**
-* Handles a WebFinger request.  You would not typically call this function
-* directly, but instead use {@link Federation.fetch} method.
-* @param request The WebFinger request to handle.
-* @param parameters The parameters for handling the request.
-* @returns The response to the request.
-*/
-async function handleWebFinger(request, options) {
-	if (options.tracer == null) return await handleWebFingerInternal(request, options);
-	return await options.tracer.startActiveSpan("webfinger.handle", { kind: SpanKind.SERVER }, async (span) => {
-		try {
-			const response = await handleWebFingerInternal(request, options);
-			span.setStatus({ code: response.ok ? SpanStatusCode.UNSET : SpanStatusCode.ERROR });
-			return response;
-		} catch (error) {
-			span.setStatus({
-				code: SpanStatusCode.ERROR,
-				message: String(error)
-			});
-			throw error;
-		} finally {
-			span.end();
-		}
-	});
-}
-async function handleWebFingerInternal(request, { context: context$1, host, actorDispatcher, actorHandleMapper, actorAliasMapper, onNotFound, span, webFingerLinksDispatcher }) {
-	if (actorDispatcher == null) {
-		logger.error("Actor dispatcher is not set.");
-		return await onNotFound(request);
-	}
-	const resource = context$1.url.searchParams.get("resource");
-	if (resource == null) return new Response("Missing resource parameter.", { status: 400 });
-	span?.setAttribute("webfinger.resource", resource);
-	let resourceUrl;
-	try {
-		resourceUrl = new URL(resource);
-	} catch (e) {
-		if (e instanceof TypeError) return new Response("Invalid resource URL.", { status: 400 });
-		throw e;
-	}
-	span?.setAttribute("webfinger.resource.scheme", resourceUrl.protocol.replace(/:$/, ""));
-	async function mapUsernameToIdentifier(username) {
-		if (actorHandleMapper == null) {
-			logger.error("No actor handle mapper is set; use the WebFinger username {username} as the actor's internal identifier.", { username });
-			return username;
-		}
-		const identifier$1 = await actorHandleMapper(context$1, username);
-		if (identifier$1 == null) {
-			logger.error("Actor {username} not found.", { username });
-			return null;
-		}
-		return identifier$1;
-	}
-	let identifier = null;
-	const uriParsed = context$1.parseUri(resourceUrl);
-	if (uriParsed?.type != "actor") {
-		const match = /^acct:([^@]+)@([^@]+)$/.exec(resource);
-		if (match == null) {
-			const result = await actorAliasMapper?.(context$1, resourceUrl);
-			if (result == null) return await onNotFound(request);
-			if ("identifier" in result) identifier = result.identifier;
-			else identifier = await mapUsernameToIdentifier(result.username);
-		} else {
-			const portMatch = /:\d+$/.exec(match[2]);
-			const normalizedHost = portMatch == null ? domainToASCII(match[2].toLowerCase()) : domainToASCII(match[2].substring(0, portMatch.index).toLowerCase()) + portMatch[0];
-			if (normalizedHost != context$1.url.host && normalizedHost != host) return await onNotFound(request);
-			else {
-				identifier = await mapUsernameToIdentifier(match[1]);
-				resourceUrl = new URL(`acct:${match[1]}@${normalizedHost}`);
-			}
-		}
-	} else identifier = uriParsed.identifier;
-	if (identifier == null) return await onNotFound(request);
-	const actor = await actorDispatcher(context$1, identifier);
-	if (actor == null) {
-		logger.error("Actor {identifier} not found.", { identifier });
-		return await onNotFound(request);
-	}
-	const links = [{
-		rel: "self",
-		href: context$1.getActorUri(identifier).href,
-		type: "application/activity+json"
-	}];
-	for (const url of actor.urls) if (url instanceof Link && url.href != null) links.push({
-		rel: url.rel ?? "http://webfinger.net/rel/profile-page",
-		href: url.href.href,
-		type: url.mediaType == null ? void 0 : url.mediaType
-	});
-	else if (url instanceof URL) links.push({
-		rel: "http://webfinger.net/rel/profile-page",
-		href: url.href
-	});
-	for await (const image of actor.getIcons()) {
-		if (image.url?.href == null) continue;
-		const link = {
-			rel: "http://webfinger.net/rel/avatar",
-			href: image.url.href.toString()
-		};
-		if (image.mediaType != null) link.type = image.mediaType;
-		links.push(link);
-	}
-	if (webFingerLinksDispatcher != null) {
-		const customLinks = await webFingerLinksDispatcher(context$1, resourceUrl);
-		if (customLinks != null) for (const link of customLinks) links.push(link);
-	}
-	const aliases = [];
-	if (resourceUrl.protocol != "acct:" && actor.preferredUsername != null) {
-		aliases.push(`acct:${actor.preferredUsername}@${host ?? context$1.url.host}`);
-		if (host != null && host !== context$1.url.host) aliases.push(`acct:${actor.preferredUsername}@${context$1.url.host}`);
-	}
-	if (resourceUrl.href !== context$1.getActorUri(identifier).href) aliases.push(context$1.getActorUri(identifier).href);
-	if (resourceUrl.protocol === "acct:" && host != null && host !== context$1.url.host && !resourceUrl.href.endsWith(`@${host}`)) {
-		const username = resourceUrl.href.replace(/^acct:/, "").replace(/@.*$/, "");
-		aliases.push(`acct:${username}@${host}`);
-	}
-	const jrd = {
-		subject: resourceUrl.href,
-		aliases,
-		links
-	};
-	return new Response(JSON.stringify(jrd), { headers: {
-		"Content-Type": "application/jrd+json",
-		"Access-Control-Allow-Origin": "*"
-	} });
-}
-
 //#endregion
 //#region src/federation/handler.ts
 /**
@@ -780,6 +638,13 @@ async function handleInboxInternal(request, parameters, span) {
 	}
 	if (activity.id != null) span.setAttribute("activitypub.activity.id", activity.id.href);
 	span.setAttribute("activitypub.activity.type", getTypeId(activity).href);
+	span.addEvent("activitypub.activity.received", {
+		"activitypub.activity.json": JSON.stringify(json),
+		"activitypub.activity.verified": activity != null,
+		"ld_signatures.verified": ldSigVerified,
+		"http_signatures.verified": httpSigKey != null,
+		"http_signatures.key_id": httpSigKey?.id?.href ?? ""
+	});
 	if (httpSigKey != null && !await doesActorOwnKey(activity, httpSigKey, ctx)) {
 		logger$2.error("The signer ({keyId}) and the actor ({actorId}) do not match.", {
 			activity: json,
@@ -1282,6 +1147,138 @@ async function respondWithObjectIfAcceptable(object, request, options) {
 	return response;
 }
 
+//#endregion
+//#region src/federation/webfinger.ts
+const logger = getLogger([
+	"fedify",
+	"webfinger",
+	"server"
+]);
+/**
+* Handles a WebFinger request.  You would not typically call this function
+* directly, but instead use {@link Federation.fetch} method.
+* @param request The WebFinger request to handle.
+* @param parameters The parameters for handling the request.
+* @returns The response to the request.
+*/
+async function handleWebFinger(request, options) {
+	if (options.tracer == null) return await handleWebFingerInternal(request, options);
+	return await options.tracer.startActiveSpan("webfinger.handle", { kind: SpanKind.SERVER }, async (span) => {
+		try {
+			const response = await handleWebFingerInternal(request, options);
+			span.setStatus({ code: response.ok ? SpanStatusCode.UNSET : SpanStatusCode.ERROR });
+			return response;
+		} catch (error) {
+			span.setStatus({
+				code: SpanStatusCode.ERROR,
+				message: String(error)
+			});
+			throw error;
+		} finally {
+			span.end();
+		}
+	});
+}
+async function handleWebFingerInternal(request, { context: context$1, host, actorDispatcher, actorHandleMapper, actorAliasMapper, onNotFound, span, webFingerLinksDispatcher }) {
+	if (actorDispatcher == null) {
+		logger.error("Actor dispatcher is not set.");
+		return await onNotFound(request);
+	}
+	const resource = context$1.url.searchParams.get("resource");
+	if (resource == null) return new Response("Missing resource parameter.", { status: 400 });
+	span?.setAttribute("webfinger.resource", resource);
+	let resourceUrl;
+	try {
+		resourceUrl = new URL(resource);
+	} catch (e) {
+		if (e instanceof TypeError) return new Response("Invalid resource URL.", { status: 400 });
+		throw e;
+	}
+	span?.setAttribute("webfinger.resource.scheme", resourceUrl.protocol.replace(/:$/, ""));
+	async function mapUsernameToIdentifier(username) {
+		if (actorHandleMapper == null) {
+			logger.error("No actor handle mapper is set; use the WebFinger username {username} as the actor's internal identifier.", { username });
+			return username;
+		}
+		const identifier$1 = await actorHandleMapper(context$1, username);
+		if (identifier$1 == null) {
+			logger.error("Actor {username} not found.", { username });
+			return null;
+		}
+		return identifier$1;
+	}
+	let identifier = null;
+	const uriParsed = context$1.parseUri(resourceUrl);
+	if (uriParsed?.type != "actor") {
+		const match = /^acct:([^@]+)@([^@]+)$/.exec(resource);
+		if (match == null) {
+			const result = await actorAliasMapper?.(context$1, resourceUrl);
+			if (result == null) return await onNotFound(request);
+			if ("identifier" in result) identifier = result.identifier;
+			else identifier = await mapUsernameToIdentifier(result.username);
+		} else {
+			const portMatch = /:\d+$/.exec(match[2]);
+			const normalizedHost = portMatch == null ? domainToASCII(match[2].toLowerCase()) : domainToASCII(match[2].substring(0, portMatch.index).toLowerCase()) + portMatch[0];
+			if (normalizedHost != context$1.url.host && normalizedHost != host) return await onNotFound(request);
+			else {
+				identifier = await mapUsernameToIdentifier(match[1]);
+				resourceUrl = new URL(`acct:${match[1]}@${normalizedHost}`);
+			}
+		}
+	} else identifier = uriParsed.identifier;
+	if (identifier == null) return await onNotFound(request);
+	const actor = await actorDispatcher(context$1, identifier);
+	if (actor == null) {
+		logger.error("Actor {identifier} not found.", { identifier });
+		return await onNotFound(request);
+	}
+	const links = [{
+		rel: "self",
+		href: context$1.getActorUri(identifier).href,
+		type: "application/activity+json"
+	}];
+	for (const url of actor.urls) if (url instanceof Link && url.href != null) links.push({
+		rel: url.rel ?? "http://webfinger.net/rel/profile-page",
+		href: url.href.href,
+		type: url.mediaType == null ? void 0 : url.mediaType
+	});
+	else if (url instanceof URL) links.push({
+		rel: "http://webfinger.net/rel/profile-page",
+		href: url.href
+	});
+	for await (const image of actor.getIcons()) {
+		if (image.url?.href == null) continue;
+		links.push({
+			rel: "http://webfinger.net/rel/avatar",
+			href: image.url.href.toString(),
+			...image.mediaType != null && { type: image.mediaType }
+		});
+	}
+	if (webFingerLinksDispatcher != null) {
+		const customLinks = await webFingerLinksDispatcher(context$1, resourceUrl);
+		if (customLinks != null) for (const link of customLinks) links.push(link);
+	}
+	const aliases = [];
+	if (resourceUrl.protocol != "acct:" && actor.preferredUsername != null) {
+		aliases.push(`acct:${actor.preferredUsername}@${host ?? context$1.url.host}`);
+		if (host != null && host !== context$1.url.host) aliases.push(`acct:${actor.preferredUsername}@${context$1.url.host}`);
+	}
+	if (resourceUrl.href !== context$1.getActorUri(identifier).href) aliases.push(context$1.getActorUri(identifier).href);
+	if (resourceUrl.protocol === "acct:" && host != null && host !== context$1.url.host && !resourceUrl.href.endsWith(`@${host}`)) {
+		const username = resourceUrl.href.replace(/^acct:/, "").replace(/@.*$/, "");
+		aliases.push(`acct:${username}@${host}`);
+	}
+	const jrd = {
+		subject: resourceUrl.href,
+		aliases,
+		links
+	};
+	return new Response(JSON.stringify(jrd), { headers: {
+		"Content-Type": "application/jrd+json",
+		"Access-Control-Allow-Origin": "*"
+	} });
+}
+
 //#endregion
 //#region src/federation/middleware.ts
 /**

package/dist/middleware-DoFisLae.js

@@ -0,0 +1,26 @@
+
+      import { Temporal } from "@js-temporal/polyfill";
+      import { URLPattern } from "urlpattern-polyfill";
+      globalThis.addEventListener = () => {};
+    
+import "./deno-i60L3ZJW.js";
+import { ContextImpl, FederationImpl, InboxContextImpl, KvSpecDeterminer, createFederation } from "./middleware-CxwWsgSo.js";
+import "./client-Dg7OfUDA.js";
+import "./router-D9eI0s4b.js";
+import "./types-CPz01LGH.js";
+import "./key-DBHCloAO.js";
+import "./http-uzkhnm0W.js";
+import "./ld-CZgNIUGN.js";
+import "./owner-BDvRiO5T.js";
+import "./proof-XEPY5YKg.js";
+import "./docloader-BuOglEYx.js";
+import "./kv-cache-BEeqyGER.js";
+import "./inbox-CxrUTds4.js";
+import "./builder-R1Sfe-tb.js";
+import "./collection-CcnIw1qY.js";
+import "./keycache-DRxpZ5r9.js";
+import "./negotiation-5NPJL6zp.js";
+import "./retry-D4GJ670a.js";
+import "./send-BdhhZ2MN.js";
+
+export { FederationImpl };

package/dist/middleware-ZN9cd_L8.js

@@ -0,0 +1,12 @@
+
+          import { Temporal } from "@js-temporal/polyfill";
+          import { URLPattern } from "urlpattern-polyfill";
+        
+import "./transformers-N_ip_y4P.js";
+import "./http-B5BgMxiO.js";
+import { ContextImpl, FederationImpl, InboxContextImpl, KvSpecDeterminer, createFederation } from "./middleware-BqPcChYv.js";
+import "./proof-DzFse-Bn.js";
+import "./types-8l28uC8o.js";
+import "./kv-cache-BqWqxam4.js";
+
+export { FederationImpl };

package/dist/{mod-0noXw66R.d.cts → mod-0p9zUdzg.d.cts}

@@ -1,5 +1,5 @@
-import { HttpMessageSignaturesSpecDeterminer } from "./http-M8k5mKc0.cjs";
-import { KvKey, KvStore } from "./kv-Bxr0Q87_.cjs";
+import { HttpMessageSignaturesSpecDeterminer } from "./http-ClB3pLcL.cjs";
+import { KvKey, KvStore } from "./kv-B4vFhIYL.cjs";
 import { DocumentLoader, DocumentLoaderFactoryOptions } from "@fedify/vocab-runtime";
 import { TracerProvider } from "@opentelemetry/api";
 
@@ -72,16 +72,16 @@ interface KvCacheParameters {
   /**
    * The document loader to decorate with a cache.
    */
-  loader: DocumentLoader;
+  readonly loader: DocumentLoader;
   /**
    * The key–value store to use for backing the cache.
    */
-  kv: KvStore;
+  readonly kv: KvStore;
   /**
    * The key prefix to use for namespacing the cache.
    * `["_fedify", "remoteDocument"]` by default.
    */
-  prefix?: KvKey;
+  readonly prefix?: KvKey;
   /**
    * The per-URL cache rules in the array of `[urlPattern, duration]` pairs
    * where `urlPattern` is either a string, a {@link URL}, or
@@ -90,7 +90,7 @@ interface KvCacheParameters {
    *
    * By default, 5 minutes for all URLs.
    */
-  rules?: [string | URL | URLPattern, Temporal.Duration | Temporal.DurationLike][];
+  readonly rules?: readonly [string | URL | URLPattern, Temporal.Duration | Temporal.DurationLike][];
 }
 /**
  * Decorates a {@link DocumentLoader} with a cache backed by a {@link Deno.Kv}.

package/dist/mod-0qnPv4EC.d.cts

@@ -0,0 +1,62 @@
+import { ActorAliasMapper, ActorDispatcher, ActorHandleMapper, RequestContext, WebFingerLinksDispatcher } from "./context-CrB9RFy5.cjs";
+import { Span, Tracer } from "@opentelemetry/api";
+
+//#region src/federation/webfinger.d.ts
+/**
+ * Parameters for {@link handleWebFinger}.
+ */
+interface WebFingerHandlerParameters<TContextData> {
+  /**
+   * The request context.
+   */
+  context: RequestContext<TContextData>;
+  /**
+   * The canonical hostname of the server, if it's explicitly configured.
+   * @since 1.5.0
+   */
+  host?: string;
+  /**
+   * The callback for dispatching the actor.
+   */
+  actorDispatcher?: ActorDispatcher<TContextData>;
+  /**
+   * The callback for mapping a WebFinger username to the corresponding actor's
+   * internal identifier, or `null` if the username is not found.
+   * @since 0.15.0
+   */
+  actorHandleMapper?: ActorHandleMapper<TContextData>;
+  /**
+   * The callback for mapping a WebFinger query to the corresponding actor's
+   * internal identifier or username, or `null` if the query is not found.
+   * @since 1.4.0
+   */
+  actorAliasMapper?: ActorAliasMapper<TContextData>;
+  /**
+   * The callback for dispatching the Links of webFinger.
+   */
+  webFingerLinksDispatcher?: WebFingerLinksDispatcher<TContextData>;
+  /**
+   * The function to call when the actor is not found.
+   */
+  onNotFound(request: Request): Response | Promise<Response>;
+  /**
+   * The OpenTelemetry tracer.
+   * @since 1.3.0
+   */
+  tracer?: Tracer;
+  /**
+   * The span for the request.
+   * @since 1.3.0
+   */
+  span?: Span;
+}
+/**
+ * Handles a WebFinger request.  You would not typically call this function
+ * directly, but instead use {@link Federation.fetch} method.
+ * @param request The WebFinger request to handle.
+ * @param parameters The parameters for handling the request.
+ * @returns The response to the request.
+ */
+declare function handleWebFinger<TContextData>(request: Request, options: WebFingerHandlerParameters<TContextData>): Promise<Response>;
+//#endregion
+export { WebFingerHandlerParameters, handleWebFinger };

package/dist/{mod-DgdBYYa0.d.cts → mod-BrS8tiad.d.cts}

@@ -1,5 +1,5 @@
-import { CryptographicKey, DataIntegrityProof, Multikey, Object as Object$1 } from "./vocab-CeDBzu-f.cjs";
-import { KeyCache } from "./http-M8k5mKc0.cjs";
+import { KeyCache } from "./http-ClB3pLcL.cjs";
+import { CryptographicKey, DataIntegrityProof, Multikey, Object as Object$1 } from "@fedify/vocab";
 import { DocumentLoader } from "@fedify/vocab-runtime";
 import { TracerProvider } from "@opentelemetry/api";
 

package/dist/mod-C3SOvTD1.d.ts

@@ -0,0 +1,64 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { URLPattern } from "urlpattern-polyfill";
+import { ActorAliasMapper, ActorDispatcher, ActorHandleMapper, RequestContext, WebFingerLinksDispatcher } from "./context-C7vzWilY.js";
+import { Span, Tracer } from "@opentelemetry/api";
+
+//#region src/federation/webfinger.d.ts
+/**
+ * Parameters for {@link handleWebFinger}.
+ */
+interface WebFingerHandlerParameters<TContextData> {
+  /**
+   * The request context.
+   */
+  context: RequestContext<TContextData>;
+  /**
+   * The canonical hostname of the server, if it's explicitly configured.
+   * @since 1.5.0
+   */
+  host?: string;
+  /**
+   * The callback for dispatching the actor.
+   */
+  actorDispatcher?: ActorDispatcher<TContextData>;
+  /**
+   * The callback for mapping a WebFinger username to the corresponding actor's
+   * internal identifier, or `null` if the username is not found.
+   * @since 0.15.0
+   */
+  actorHandleMapper?: ActorHandleMapper<TContextData>;
+  /**
+   * The callback for mapping a WebFinger query to the corresponding actor's
+   * internal identifier or username, or `null` if the query is not found.
+   * @since 1.4.0
+   */
+  actorAliasMapper?: ActorAliasMapper<TContextData>;
+  /**
+   * The callback for dispatching the Links of webFinger.
+   */
+  webFingerLinksDispatcher?: WebFingerLinksDispatcher<TContextData>;
+  /**
+   * The function to call when the actor is not found.
+   */
+  onNotFound(request: Request): Response | Promise<Response>;
+  /**
+   * The OpenTelemetry tracer.
+   * @since 1.3.0
+   */
+  tracer?: Tracer;
+  /**
+   * The span for the request.
+   * @since 1.3.0
+   */
+  span?: Span;
+}
+/**
+ * Handles a WebFinger request.  You would not typically call this function
+ * directly, but instead use {@link Federation.fetch} method.
+ * @param request The WebFinger request to handle.
+ * @param parameters The parameters for handling the request.
+ * @returns The response to the request.
+ */
+declare function handleWebFinger<TContextData>(request: Request, options: WebFingerHandlerParameters<TContextData>): Promise<Response>;
+//#endregion
+export { WebFingerHandlerParameters, handleWebFinger };

package/dist/{mod-DJcZDvjA.d.cts → mod-D6pS5_xJ.d.cts}

@@ -1,5 +1,5 @@
-import { Activity } from "./vocab-CeDBzu-f.cjs";
-import { ActivityTransformer, Context } from "./context-DJ8aSy2Q.cjs";
+import { ActivityTransformer, Context } from "./context-CrB9RFy5.cjs";
+import { Activity } from "@fedify/vocab";
 
 //#region src/compat/transformers.d.ts
 
@@ -28,7 +28,7 @@ declare function autoIdAssigner<TContextData>(activity: Activity, context: Conte
  * activity like this:
  *
  * ```typescript
- * import { Follow, Person } from "@fedify/fedify/vocab";
+ * import { Follow, Person } from "@fedify/vocab";
  * const input = new Follow({
  *   id: new URL("http://example.com/activities/1"),
  *   actor: new Person({
@@ -47,7 +47,7 @@ declare function autoIdAssigner<TContextData>(activity: Activity, context: Conte
  * The result of applying this transformer would be:
  *
  * ```typescript
- * import { Follow, Person } from "@fedify/fedify/vocab";
+ * import { Follow, Person } from "@fedify/vocab";
  * const output = new Follow({
  *   id: new URL("http://example.com/activities/1"),
  *   actor: new URL("http://example.com/actors/1"),

package/dist/{mod-B2iOw50L.d.ts → mod-jOa7W503.d.ts}

@@ -1,7 +1,7 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { CryptographicKey, DataIntegrityProof, Multikey, Object as Object$1 } from "./vocab-BCWe1Ih5.js";
-import { KeyCache } from "./http-BbO0ejuk.js";
+import { KeyCache } from "./http-DLBDPal9.js";
+import { CryptographicKey, DataIntegrityProof, Multikey, Object as Object$1 } from "@fedify/vocab";
 import { TracerProvider } from "@opentelemetry/api";
 import { DocumentLoader } from "@fedify/vocab-runtime";
 

package/dist/{mod-BoHnwOCs.d.ts → mod-waqu-BL_.d.ts}

@@ -1,7 +1,7 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { Activity } from "./vocab-BCWe1Ih5.js";
-import { ActivityTransformer, Context } from "./context-DG0huGW-.js";
+import { ActivityTransformer, Context } from "./context-C7vzWilY.js";
+import { Activity } from "@fedify/vocab";
 
 //#region src/compat/transformers.d.ts
 
@@ -30,7 +30,7 @@ declare function autoIdAssigner<TContextData>(activity: Activity, context: Conte
  * activity like this:
  *
  * ```typescript
- * import { Follow, Person } from "@fedify/fedify/vocab";
+ * import { Follow, Person } from "@fedify/vocab";
  * const input = new Follow({
  *   id: new URL("http://example.com/activities/1"),
  *   actor: new Person({
@@ -49,7 +49,7 @@ declare function autoIdAssigner<TContextData>(activity: Activity, context: Conte
  * The result of applying this transformer would be:
  *
  * ```typescript
- * import { Follow, Person } from "@fedify/fedify/vocab";
+ * import { Follow, Person } from "@fedify/vocab";
  * const output = new Follow({
  *   id: new URL("http://example.com/activities/1"),
  *   actor: new URL("http://example.com/actors/1"),