@fedify/fedify 2.2.0-pr.695.16 → 2.2.0-pr.697.17

package/dist/activity-listener-Ck3JZ_hR.mjs

@@ -0,0 +1,40 @@
+import "@js-temporal/polyfill";
+import "urlpattern-polyfill";
+globalThis.addEventListener = () => {};
+import { Activity } from "@fedify/vocab";
+//#region src/federation/activity-listener.ts
+var ActivityListenerSet = class {
+	#listeners;
+	constructor() {
+		this.#listeners = /* @__PURE__ */ new Map();
+	}
+	clone() {
+		const Clone = this.constructor;
+		const clone = new Clone();
+		clone.#listeners = new Map(this.#listeners);
+		return clone;
+	}
+	add(type, listener) {
+		if (this.#listeners.has(type)) throw new TypeError("Listener already set for this type.");
+		this.#listeners.set(type, listener);
+	}
+	dispatchWithClass(activity) {
+		let cls = activity.constructor;
+		while (cls != null) {
+			if (this.#listeners.has(cls)) break;
+			if (cls === Activity) return null;
+			cls = globalThis.Object.getPrototypeOf(cls);
+		}
+		if (cls == null) return null;
+		const listener = this.#listeners.get(cls);
+		return {
+			class: cls,
+			listener
+		};
+	}
+	dispatch(activity) {
+		return this.dispatchWithClass(activity)?.listener ?? null;
+	}
+};
+//#endregion
+export { ActivityListenerSet as t };

package/dist/{builder-7PVCiLiR.mjs → builder-0VkYL-Be.mjs}

@@ -2,12 +2,23 @@ import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 import { n as RouterError, t as Router } from "./router-CrMLXoOr.mjs";
-import { n as version, t as name } from "./deno-vxcWcxQS.mjs";
-import { t as InboxListenerSet } from "./inbox-CmYvcSMM.mjs";
+import { n as version, t as name } from "./deno-ZTLy21O_.mjs";
+import { t as ActivityListenerSet } from "./activity-listener-Ck3JZ_hR.mjs";
 import { Tombstone, getTypeId } from "@fedify/vocab";
 import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 import { getLogger } from "@logtape/logtape";
 //#region src/federation/builder.ts
+function validateSingleIdentifierVariablePath(path, errorMessage) {
+	const operatorMatches = globalThis.Array.from(path.matchAll(/{([+#./;?&]?)([A-Za-z_][A-Za-z0-9_]*)}/g));
+	if (operatorMatches.length !== 1 || operatorMatches[0]?.[2] !== "identifier") throw new RouterError(errorMessage);
+	if (operatorMatches.some((match) => [
+		"?",
+		"&",
+		"#"
+	].includes(match[1]) && match[2] === "identifier")) throw new RouterError(errorMessage);
+	const variables = new Router().add(path, "outbox");
+	if (variables.size !== 1 || !variables.has("identifier")) throw new RouterError(errorMessage);
+}
 var FederationBuilderImpl = class {
 	router;
 	actorCallbacks;
@@ -16,6 +27,7 @@ var FederationBuilderImpl = class {
 	objectCallbacks;
 	objectTypeIds;
 	inboxPath;
+	outboxPath;
 	inboxCallbacks;
 	outboxCallbacks;
 	followingCallbacks;
@@ -24,7 +36,10 @@ var FederationBuilderImpl = class {
 	featuredCallbacks;
 	featuredTagsCallbacks;
 	inboxListeners;
+	outboxListeners;
 	inboxErrorHandler;
+	outboxListenerErrorHandler;
+	outboxAuthorizePredicate;
 	sharedInboxKeyDispatcher;
 	unverifiedActivityHandler;
 	outboxPermanentFailureHandler;
@@ -43,7 +58,7 @@ var FederationBuilderImpl = class {
 		this.collectionTypeIds = {};
 	}
 	async build(options) {
-		const { FederationImpl } = await import("./middleware-wdfeWjRJ.mjs");
+		const { FederationImpl } = await import("./middleware-DDXN5eBU.mjs");
 		const f = new FederationImpl(options);
 		const trailingSlashInsensitiveValue = f.router.trailingSlashInsensitive;
 		f.router = this.router.clone();
@@ -55,6 +70,7 @@ var FederationBuilderImpl = class {
 		f.objectCallbacks = { ...this.objectCallbacks };
 		f.objectTypeIds = { ...this.objectTypeIds };
 		f.inboxPath = this.inboxPath;
+		f.outboxPath = this.outboxPath;
 		f.inboxCallbacks = this.inboxCallbacks == null ? void 0 : { ...this.inboxCallbacks };
 		f.outboxCallbacks = this.outboxCallbacks == null ? void 0 : { ...this.outboxCallbacks };
 		f.followingCallbacks = this.followingCallbacks == null ? void 0 : { ...this.followingCallbacks };
@@ -63,7 +79,10 @@ var FederationBuilderImpl = class {
 		f.featuredCallbacks = this.featuredCallbacks == null ? void 0 : { ...this.featuredCallbacks };
 		f.featuredTagsCallbacks = this.featuredTagsCallbacks == null ? void 0 : { ...this.featuredTagsCallbacks };
 		f.inboxListeners = this.inboxListeners?.clone();
+		f.outboxListeners = this.outboxListeners?.clone();
 		f.inboxErrorHandler = this.inboxErrorHandler;
+		f.outboxListenerErrorHandler = this.outboxListenerErrorHandler;
+		f.outboxAuthorizePredicate = this.outboxAuthorizePredicate;
 		f.sharedInboxKeyDispatcher = this.sharedInboxKeyDispatcher;
 		f.unverifiedActivityHandler = this.unverifiedActivityHandler;
 		f.outboxPermanentFailureHandler = this.outboxPermanentFailureHandler;
@@ -263,9 +282,14 @@ var FederationBuilderImpl = class {
 		return setters;
 	}
 	setOutboxDispatcher(path, dispatcher) {
-		if (this.router.has("outbox")) throw new RouterError("Outbox dispatcher already set.");
-		const variables = this.router.add(path, "outbox");
-		if (variables.size !== 1 || !variables.has("identifier")) throw new RouterError("Path for outbox dispatcher must have one variable: {identifier}");
+		if (this.outboxCallbacks != null) throw new RouterError("Outbox dispatcher already set.");
+		if (this.router.has("outbox")) {
+			if (this.outboxPath !== path) throw new RouterError("Outbox dispatcher path must match outbox listener path.");
+		} else {
+			validateSingleIdentifierVariablePath(path, "Path for outbox dispatcher must have one variable: {identifier}");
+			this.router.add(path, "outbox");
+			this.outboxPath = path;
+		}
 		const callbacks = { dispatcher };
 		this.outboxCallbacks = callbacks;
 		const setters = {
@@ -288,6 +312,32 @@ var FederationBuilderImpl = class {
 		};
 		return setters;
 	}
+	setOutboxListeners(outboxPath) {
+		if (this.outboxListeners != null) throw new RouterError("Outbox listeners already set.");
+		if (this.router.has("outbox")) {
+			if (this.outboxPath !== outboxPath) throw new RouterError("Outbox listener path must match outbox dispatcher path.");
+		} else {
+			validateSingleIdentifierVariablePath(outboxPath, "Path for outbox must have one variable: {identifier}");
+			this.router.add(outboxPath, "outbox");
+			this.outboxPath = outboxPath;
+		}
+		const listeners = this.outboxListeners = new ActivityListenerSet();
+		const setters = {
+			on(type, listener) {
+				listeners.add(type, listener);
+				return setters;
+			},
+			onError: (handler) => {
+				this.outboxListenerErrorHandler = handler;
+				return setters;
+			},
+			authorize: (predicate) => {
+				this.outboxAuthorizePredicate = predicate;
+				return setters;
+			}
+		};
+		return setters;
+	}
 	setFollowingDispatcher(path, dispatcher) {
 		if (this.router.has("following")) throw new RouterError("Following collection dispatcher already set.");
 		const variables = this.router.add(path, "following");
@@ -430,7 +480,7 @@ var FederationBuilderImpl = class {
 		if (sharedInboxPath != null) {
 			if (this.router.add(sharedInboxPath, "sharedInbox").size !== 0) throw new RouterError("Path for shared inbox must have no variables.");
 		}
-		const listeners = this.inboxListeners = new InboxListenerSet();
+		const listeners = this.inboxListeners = new ActivityListenerSet();
 		const setters = {
 			on(type, listener) {
 				listeners.add(type, listener);

package/dist/compat/mod.d.cts

@@ -1,4 +1,4 @@
-import { n as Context, wt as ActivityTransformer } from "../context-DYDPdoCb.cjs";
+import { Ot as ActivityTransformer, n as Context } from "../context-CMUd4wy0.cjs";
 import { Activity } from "@fedify/vocab";
 
 //#region src/compat/transformers.d.ts

package/dist/compat/mod.d.ts

@@ -1,6 +1,6 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { n as Context, wt as ActivityTransformer } from "../context-78ecvxf5.js";
+import { Ot as ActivityTransformer, n as Context } from "../context-BGrYMSTk.js";
 import { Activity } from "@fedify/vocab";
 
 //#region src/compat/transformers.d.ts

package/dist/compat/transformers.test.mjs

@@ -5,7 +5,7 @@ import { t as assertEquals } from "../assert_equals-Ew3jOFa3.mjs";
 import { t as assertInstanceOf } from "../assert_instance_of-C4Ri6VuN.mjs";
 import { t as assert } from "../assert-ddO5KLpe.mjs";
 import { t as MemoryKvStore } from "../kv-tL2TOE9X.mjs";
-import { _ as autoIdAssigner, g as actorDehydrator, n as FederationImpl } from "../middleware-BjVx-_bv.mjs";
+import { n as FederationImpl, v as actorDehydrator, y as autoIdAssigner } from "../middleware-DbCHS-GH.mjs";
 import { test } from "@fedify/fixture";
 import { Follow, Person } from "@fedify/vocab";
 //#region src/compat/transformers.test.ts

package/dist/{context-78ecvxf5.d.ts → context-BGrYMSTk.d.ts}

@@ -212,6 +212,16 @@ type CollectionCursor<TContext extends Context<TContextData>, TContextData, TFil
 */
 type InboxListener<TContextData, TActivity extends Activity> = (context: InboxContext<TContextData>, activity: TActivity) => void | Promise<void>;
 /**
+* A callback that listens for activities in an outbox.
+*
+* @template TContextData The context data to pass to the {@link Context}.
+* @template TActivity The type of activity to listen for.
+* @param context The outbox context.
+* @param activity The activity that was received.
+* @since 2.2.0
+*/
+type OutboxListener<TContextData, TActivity extends Activity> = (context: OutboxContext<TContextData>, activity: TActivity) => void | Promise<void>;
+/**
 * The reason why an incoming activity could not be verified.
 *
 * Unlike inbox listeners registered through {@link InboxListenerSetters.on},
@@ -242,6 +252,15 @@ type UnverifiedActivityHandler<TContextData> = (context: RequestContext<TContext
 */
 type InboxErrorHandler<TContextData> = (context: Context<TContextData>, error: Error) => void | Promise<void>;
 /**
+* A callback that handles errors in an outbox listener.
+*
+* @template TContextData The context data to pass to the {@link Context}.
+* @param context The outbox context.
+* @param error The error that occurred.
+* @since 2.2.0
+*/
+type OutboxListenerErrorHandler<TContextData> = (context: OutboxContext<TContextData>, error: Error) => void | Promise<void>;
+/**
 * A callback that dispatches the key pair for the authenticated document loader
 * of the {@link Context} passed to the shared inbox listener.
 *
@@ -1051,6 +1070,32 @@ interface Federatable<TContextData> {
   */
   setOutboxDispatcher(path: `${string}${Rfc6570Expression<"identifier">}${string}`, dispatcher: CollectionDispatcher<Activity, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
   /**
+  * Assigns the URL path for the outbox and starts setting outbox listeners.
+  *
+  * @example
+  * ``` typescript
+  * federation
+  *   .setOutboxListeners("/users/{identifier}/outbox")
+  *   .on(Activity, async (ctx, activity) => {
+  *     await ctx.sendActivity({ identifier: ctx.identifier }, "followers", activity);
+  *   })
+  *   .authorize(async (ctx, identifier) => {
+  *     return ctx.request.headers.get("authorization") === `Bearer ${identifier}`;
+  *   });
+  * ```
+  *
+  * @param outboxPath The URI path pattern for the outbox.  The syntax is based
+  *                   on URI Template
+  *                   ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The
+  *                   path must have one variable: `{identifier}`.  If an
+  *                   outbox dispatcher is configured, this path must match
+  *                   the outbox dispatcher path.
+  * @returns An object to register outbox listeners.
+  * @throws {RouterError} Thrown if the path pattern is invalid.
+  * @since 2.2.0
+  */
+  setOutboxListeners(outboxPath: `${string}${Rfc6570Expression<"identifier">}${string}`): OutboxListenerSetters<TContextData>;
+  /**
   * Registers a following collection dispatcher.
   * @param path The URI path pattern for the following collection.  The syntax
   *             is based on URI Template
@@ -1674,6 +1719,38 @@ type IdempotencyStrategy = "global" | "per-origin" | "per-inbox";
 */
 type IdempotencyKeyCallback<TContextData> = (ctx: InboxContext<TContextData>, activity: Activity) => string | null | Promise<string | null>;
 /**
+* Registry for outbox listeners for different activity types.
+* @since 2.2.0
+*/
+interface OutboxListenerSetters<TContextData> {
+  /**
+  * Registers a listener for a specific incoming activity type.
+  *
+  * @param type A subclass of {@link Activity} to listen to.
+  * @param listener A callback to handle an incoming activity.
+  * @returns The setters object so that settings can be chained.
+  * @since 2.2.0
+  */
+  on<TActivity extends Activity>(type: new (...args: any[]) => TActivity, listener: OutboxListener<TContextData, TActivity>): OutboxListenerSetters<TContextData>;
+  /**
+  * Registers an error handler for outbox listeners.  Any exceptions thrown
+  * from the listeners are caught and passed to this handler.
+  *
+  * @param handler A callback to handle an error.
+  * @returns The setters object so that settings can be chained.
+  * @since 2.2.0
+  */
+  onError(handler: OutboxListenerErrorHandler<TContextData>): OutboxListenerSetters<TContextData>;
+  /**
+  * Registers a callback to authorize POST requests to the outbox.
+  *
+  * @param predicate A callback to authorize the request.
+  * @returns The setters object so that settings can be chained.
+  * @since 2.2.0
+  */
+  authorize(predicate: AuthorizePredicate<TContextData>): OutboxListenerSetters<TContextData>;
+}
+/**
 * Registry for inbox listeners for different activity types.
 */
 interface InboxListenerSetters<TContextData> {
@@ -2445,6 +2522,71 @@ interface InboxContext<TContextData> extends Context<TContextData> {
   }, recipients: "followers", options?: ForwardActivityOptions): Promise<void>;
 }
 /**
+* A context for outbox listeners.
+* @since 2.2.0
+*/
+interface OutboxContext<TContextData> extends Context<TContextData> {
+  /**
+  * The identifier of the actor whose outbox received the POST.
+  * @since 2.2.0
+  */
+  readonly identifier: string;
+  /**
+  * Indicates whether the posted activity has been delivered during the
+  * current outbox listener invocation.
+  * @returns `true` if the posted activity has been delivered; `false`
+  *          otherwise.
+  * @since 2.2.0
+  */
+  hasDeliveredActivity(): boolean;
+  /**
+  * Forwards a posted activity to the recipients' inboxes without
+  * re-serializing the original payload.  The forwarded activity will be
+  * signed in HTTP Signatures by the forwarder, but its payload will not be
+  * modified, i.e., Linked Data Signatures and Object Integrity Proofs will
+  * not be added.  Therefore, if the posted activity is not signed (i.e., it
+  * has neither Linked Data Signatures nor Object Integrity Proofs), the
+  * recipients probably will not trust the activity.
+  * @param forwarder The forwarder's identifier or the forwarder's username
+  *                  or the forwarder's key pair(s).
+  * @param recipients The recipients of the activity.
+  * @param options Options for forwarding the activity.
+  * @since 2.2.0
+  */
+  forwardActivity(forwarder: SenderKeyPair | SenderKeyPair[] | {
+    identifier: string;
+  } | {
+    username: string;
+  }, recipients: Recipient | Recipient[], options?: ForwardActivityOptions): Promise<void>;
+  /**
+  * Forwards a posted activity to the recipients' inboxes without
+  * re-serializing the original payload.  The forwarded activity will be
+  * signed in HTTP Signatures by the forwarder, but its payload will not be
+  * modified, i.e., Linked Data Signatures and Object Integrity Proofs will
+  * not be added.  Therefore, if the posted activity is not signed (i.e., it
+  * has neither Linked Data Signatures nor Object Integrity Proofs), the
+  * recipients probably will not trust the activity.
+  * @param forwarder The forwarder's identifier or the forwarder's username.
+  * @param recipients In this case, it must be `"followers"`.
+  * @param options Options for forwarding the activity.
+  * @since 2.2.0
+  */
+  forwardActivity(forwarder: {
+    identifier: string;
+  } | {
+    username: string;
+  }, recipients: "followers", options?: ForwardActivityOptions): Promise<void>;
+  /**
+  * Creates a new context with the same properties as this one,
+  * but with the given data.
+  * @param data The new data to associate with the context.
+  * @returns A new context with the same properties as this one,
+  *          but with the given data.
+  * @since 2.2.0
+  */
+  clone(data: TContextData): OutboxContext<TContextData>;
+}
+/**
 * A result of parsing an URI.
 */
 type ParseUriResult = {
@@ -2644,4 +2786,4 @@ interface ActorKeyPair extends CryptoKeyPair {
   readonly multikey: Multikey;
 }
 //#endregion
-export { ActorHandleMapper as $, FederationQueueOptions as A, RouterOptions as B, IdempotencyStrategy as C, digest as Ct, Rfc6570Expression as D, ObjectCallbackSetters as E, createExponentialBackoffPolicy as F, InProcessMessageQueue as G, RespondWithObjectOptions as H, Message as I, MessageQueueEnqueueOptions as J, InProcessMessageQueueOptions as K, createFederationBuilder as L, CreateExponentialBackoffPolicyOptions as M, RetryContext as N, FederationKvPrefixes as O, RetryPolicy as P, ActorDispatcher as Q, Router as R, IdempotencyKeyCallback as S, buildCollectionSynchronizationHeader as St, InboxListenerSetters as T, respondWithObject as U, RouterRouteResult as V, respondWithObjectIfAcceptable as W, ParallelMessageQueue as X, MessageQueueListenOptions as Y, ActorAliasMapper as Z, Federation as _, UnverifiedActivityReason as _t, GetSignedKeyOptions as a, CustomCollectionCounter as at, FederationOptions as b, SenderKeyPair as bt, RequestContext as c, InboxErrorHandler as ct, SendActivityOptionsForCollection as d, ObjectAuthorizePredicate as dt, ActorKeyPairsDispatcher as et, ActorCallbackSetters as f, ObjectDispatcher as ft, Federatable as g, UnverifiedActivityHandler as gt, CustomCollectionCallbackSetters as h, SharedInboxKeyDispatcher as ht, GetActorOptions as i, CollectionDispatcher as it, createFederation as j, FederationOrigin as k, RouteActivityOptions as l, InboxListener as lt, ConstructorWithTypeId as m, OutboxPermanentFailureHandler as mt, Context as n, CollectionCounter as nt, InboxContext as o, CustomCollectionCursor as ot, CollectionCallbackSetters as p, OutboxErrorHandler as pt, MessageQueue as q, ForwardActivityOptions as r, CollectionCursor as rt, ParseUriResult as s, CustomCollectionDispatcher as st, ActorKeyPair as t, AuthorizePredicate as tt, SendActivityOptions as u, NodeInfoDispatcher as ut, FederationBuilder as v, WebFingerLinksDispatcher as vt, InboxChallengePolicy as w, ActivityTransformer as wt, FederationStartQueueOptions as x, PageItems as xt, FederationFetchOptions as y, SendActivityError as yt, RouterError as z };
+export { ActorAliasMapper as $, FederationKvPrefixes as A, Router as B, IdempotencyKeyCallback as C, SendActivityError as Ct, ObjectCallbackSetters as D, digest as Dt, InboxListenerSetters as E, buildCollectionSynchronizationHeader as Et, RetryContext as F, respondWithObject as G, RouterOptions as H, RetryPolicy as I, InProcessMessageQueueOptions as J, respondWithObjectIfAcceptable as K, createExponentialBackoffPolicy as L, FederationQueueOptions as M, createFederation as N, OutboxListenerSetters as O, ActivityTransformer as Ot, CreateExponentialBackoffPolicyOptions as P, ParallelMessageQueue as Q, Message as R, FederationStartQueueOptions as S, WebFingerLinksDispatcher as St, InboxChallengePolicy as T, PageItems as Tt, RouterRouteResult as U, RouterError as V, RespondWithObjectOptions as W, MessageQueueEnqueueOptions as X, MessageQueue as Y, MessageQueueListenOptions as Z, Federatable as _, OutboxListenerErrorHandler as _t, GetSignedKeyOptions as a, CollectionCursor as at, FederationFetchOptions as b, UnverifiedActivityHandler as bt, ParseUriResult as c, CustomCollectionCursor as ct, SendActivityOptions as d, InboxListener as dt, ActorDispatcher as et, SendActivityOptionsForCollection as f, NodeInfoDispatcher as ft, CustomCollectionCallbackSetters as g, OutboxListener as gt, ConstructorWithTypeId as h, OutboxErrorHandler as ht, GetActorOptions as i, CollectionCounter as it, FederationOrigin as j, Rfc6570Expression as k, RequestContext as l, CustomCollectionDispatcher as lt, CollectionCallbackSetters as m, ObjectDispatcher as mt, Context as n, ActorKeyPairsDispatcher as nt, InboxContext as o, CollectionDispatcher as ot, ActorCallbackSetters as p, ObjectAuthorizePredicate as pt, InProcessMessageQueue as q, ForwardActivityOptions as r, AuthorizePredicate as rt, OutboxContext as s, CustomCollectionCounter as st, ActorKeyPair as t, ActorHandleMapper as tt, RouteActivityOptions as u, InboxErrorHandler as ut, Federation as v, OutboxPermanentFailureHandler as vt, IdempotencyStrategy as w, SenderKeyPair as wt, FederationOptions as x, UnverifiedActivityReason as xt, FederationBuilder as y, SharedInboxKeyDispatcher as yt, createFederationBuilder as z };

package/dist/{context-DYDPdoCb.d.cts → context-CMUd4wy0.d.cts}

@@ -210,6 +210,16 @@ type CollectionCursor<TContext extends Context<TContextData>, TContextData, TFil
 */
 type InboxListener<TContextData, TActivity extends Activity> = (context: InboxContext<TContextData>, activity: TActivity) => void | Promise<void>;
 /**
+* A callback that listens for activities in an outbox.
+*
+* @template TContextData The context data to pass to the {@link Context}.
+* @template TActivity The type of activity to listen for.
+* @param context The outbox context.
+* @param activity The activity that was received.
+* @since 2.2.0
+*/
+type OutboxListener<TContextData, TActivity extends Activity> = (context: OutboxContext<TContextData>, activity: TActivity) => void | Promise<void>;
+/**
 * The reason why an incoming activity could not be verified.
 *
 * Unlike inbox listeners registered through {@link InboxListenerSetters.on},
@@ -240,6 +250,15 @@ type UnverifiedActivityHandler<TContextData> = (context: RequestContext<TContext
 */
 type InboxErrorHandler<TContextData> = (context: Context<TContextData>, error: Error) => void | Promise<void>;
 /**
+* A callback that handles errors in an outbox listener.
+*
+* @template TContextData The context data to pass to the {@link Context}.
+* @param context The outbox context.
+* @param error The error that occurred.
+* @since 2.2.0
+*/
+type OutboxListenerErrorHandler<TContextData> = (context: OutboxContext<TContextData>, error: Error) => void | Promise<void>;
+/**
 * A callback that dispatches the key pair for the authenticated document loader
 * of the {@link Context} passed to the shared inbox listener.
 *
@@ -1049,6 +1068,32 @@ interface Federatable<TContextData> {
   */
   setOutboxDispatcher(path: `${string}${Rfc6570Expression<"identifier">}${string}`, dispatcher: CollectionDispatcher<Activity, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
   /**
+  * Assigns the URL path for the outbox and starts setting outbox listeners.
+  *
+  * @example
+  * ``` typescript
+  * federation
+  *   .setOutboxListeners("/users/{identifier}/outbox")
+  *   .on(Activity, async (ctx, activity) => {
+  *     await ctx.sendActivity({ identifier: ctx.identifier }, "followers", activity);
+  *   })
+  *   .authorize(async (ctx, identifier) => {
+  *     return ctx.request.headers.get("authorization") === `Bearer ${identifier}`;
+  *   });
+  * ```
+  *
+  * @param outboxPath The URI path pattern for the outbox.  The syntax is based
+  *                   on URI Template
+  *                   ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The
+  *                   path must have one variable: `{identifier}`.  If an
+  *                   outbox dispatcher is configured, this path must match
+  *                   the outbox dispatcher path.
+  * @returns An object to register outbox listeners.
+  * @throws {RouterError} Thrown if the path pattern is invalid.
+  * @since 2.2.0
+  */
+  setOutboxListeners(outboxPath: `${string}${Rfc6570Expression<"identifier">}${string}`): OutboxListenerSetters<TContextData>;
+  /**
   * Registers a following collection dispatcher.
   * @param path The URI path pattern for the following collection.  The syntax
   *             is based on URI Template
@@ -1672,6 +1717,38 @@ type IdempotencyStrategy = "global" | "per-origin" | "per-inbox";
 */
 type IdempotencyKeyCallback<TContextData> = (ctx: InboxContext<TContextData>, activity: Activity) => string | null | Promise<string | null>;
 /**
+* Registry for outbox listeners for different activity types.
+* @since 2.2.0
+*/
+interface OutboxListenerSetters<TContextData> {
+  /**
+  * Registers a listener for a specific incoming activity type.
+  *
+  * @param type A subclass of {@link Activity} to listen to.
+  * @param listener A callback to handle an incoming activity.
+  * @returns The setters object so that settings can be chained.
+  * @since 2.2.0
+  */
+  on<TActivity extends Activity>(type: new (...args: any[]) => TActivity, listener: OutboxListener<TContextData, TActivity>): OutboxListenerSetters<TContextData>;
+  /**
+  * Registers an error handler for outbox listeners.  Any exceptions thrown
+  * from the listeners are caught and passed to this handler.
+  *
+  * @param handler A callback to handle an error.
+  * @returns The setters object so that settings can be chained.
+  * @since 2.2.0
+  */
+  onError(handler: OutboxListenerErrorHandler<TContextData>): OutboxListenerSetters<TContextData>;
+  /**
+  * Registers a callback to authorize POST requests to the outbox.
+  *
+  * @param predicate A callback to authorize the request.
+  * @returns The setters object so that settings can be chained.
+  * @since 2.2.0
+  */
+  authorize(predicate: AuthorizePredicate<TContextData>): OutboxListenerSetters<TContextData>;
+}
+/**
 * Registry for inbox listeners for different activity types.
 */
 interface InboxListenerSetters<TContextData> {
@@ -2443,6 +2520,71 @@ interface InboxContext<TContextData> extends Context<TContextData> {
   }, recipients: "followers", options?: ForwardActivityOptions): Promise<void>;
 }
 /**
+* A context for outbox listeners.
+* @since 2.2.0
+*/
+interface OutboxContext<TContextData> extends Context<TContextData> {
+  /**
+  * The identifier of the actor whose outbox received the POST.
+  * @since 2.2.0
+  */
+  readonly identifier: string;
+  /**
+  * Indicates whether the posted activity has been delivered during the
+  * current outbox listener invocation.
+  * @returns `true` if the posted activity has been delivered; `false`
+  *          otherwise.
+  * @since 2.2.0
+  */
+  hasDeliveredActivity(): boolean;
+  /**
+  * Forwards a posted activity to the recipients' inboxes without
+  * re-serializing the original payload.  The forwarded activity will be
+  * signed in HTTP Signatures by the forwarder, but its payload will not be
+  * modified, i.e., Linked Data Signatures and Object Integrity Proofs will
+  * not be added.  Therefore, if the posted activity is not signed (i.e., it
+  * has neither Linked Data Signatures nor Object Integrity Proofs), the
+  * recipients probably will not trust the activity.
+  * @param forwarder The forwarder's identifier or the forwarder's username
+  *                  or the forwarder's key pair(s).
+  * @param recipients The recipients of the activity.
+  * @param options Options for forwarding the activity.
+  * @since 2.2.0
+  */
+  forwardActivity(forwarder: SenderKeyPair | SenderKeyPair[] | {
+    identifier: string;
+  } | {
+    username: string;
+  }, recipients: Recipient | Recipient[], options?: ForwardActivityOptions): Promise<void>;
+  /**
+  * Forwards a posted activity to the recipients' inboxes without
+  * re-serializing the original payload.  The forwarded activity will be
+  * signed in HTTP Signatures by the forwarder, but its payload will not be
+  * modified, i.e., Linked Data Signatures and Object Integrity Proofs will
+  * not be added.  Therefore, if the posted activity is not signed (i.e., it
+  * has neither Linked Data Signatures nor Object Integrity Proofs), the
+  * recipients probably will not trust the activity.
+  * @param forwarder The forwarder's identifier or the forwarder's username.
+  * @param recipients In this case, it must be `"followers"`.
+  * @param options Options for forwarding the activity.
+  * @since 2.2.0
+  */
+  forwardActivity(forwarder: {
+    identifier: string;
+  } | {
+    username: string;
+  }, recipients: "followers", options?: ForwardActivityOptions): Promise<void>;
+  /**
+  * Creates a new context with the same properties as this one,
+  * but with the given data.
+  * @param data The new data to associate with the context.
+  * @returns A new context with the same properties as this one,
+  *          but with the given data.
+  * @since 2.2.0
+  */
+  clone(data: TContextData): OutboxContext<TContextData>;
+}
+/**
 * A result of parsing an URI.
 */
 type ParseUriResult = {
@@ -2642,4 +2784,4 @@ interface ActorKeyPair extends CryptoKeyPair {
   readonly multikey: Multikey;
 }
 //#endregion
-export { ActorHandleMapper as $, FederationQueueOptions as A, RouterOptions as B, IdempotencyStrategy as C, digest as Ct, Rfc6570Expression as D, ObjectCallbackSetters as E, createExponentialBackoffPolicy as F, InProcessMessageQueue as G, RespondWithObjectOptions as H, Message as I, MessageQueueEnqueueOptions as J, InProcessMessageQueueOptions as K, createFederationBuilder as L, CreateExponentialBackoffPolicyOptions as M, RetryContext as N, FederationKvPrefixes as O, RetryPolicy as P, ActorDispatcher as Q, Router as R, IdempotencyKeyCallback as S, buildCollectionSynchronizationHeader as St, InboxListenerSetters as T, respondWithObject as U, RouterRouteResult as V, respondWithObjectIfAcceptable as W, ParallelMessageQueue as X, MessageQueueListenOptions as Y, ActorAliasMapper as Z, Federation as _, UnverifiedActivityReason as _t, GetSignedKeyOptions as a, CustomCollectionCounter as at, FederationOptions as b, SenderKeyPair as bt, RequestContext as c, InboxErrorHandler as ct, SendActivityOptionsForCollection as d, ObjectAuthorizePredicate as dt, ActorKeyPairsDispatcher as et, ActorCallbackSetters as f, ObjectDispatcher as ft, Federatable as g, UnverifiedActivityHandler as gt, CustomCollectionCallbackSetters as h, SharedInboxKeyDispatcher as ht, GetActorOptions as i, CollectionDispatcher as it, createFederation as j, FederationOrigin as k, RouteActivityOptions as l, InboxListener as lt, ConstructorWithTypeId as m, OutboxPermanentFailureHandler as mt, Context as n, CollectionCounter as nt, InboxContext as o, CustomCollectionCursor as ot, CollectionCallbackSetters as p, OutboxErrorHandler as pt, MessageQueue as q, ForwardActivityOptions as r, CollectionCursor as rt, ParseUriResult as s, CustomCollectionDispatcher as st, ActorKeyPair as t, AuthorizePredicate as tt, SendActivityOptions as u, NodeInfoDispatcher as ut, FederationBuilder as v, WebFingerLinksDispatcher as vt, InboxChallengePolicy as w, ActivityTransformer as wt, FederationStartQueueOptions as x, PageItems as xt, FederationFetchOptions as y, SendActivityError as yt, RouterError as z };
+export { ActorAliasMapper as $, FederationKvPrefixes as A, Router as B, IdempotencyKeyCallback as C, SendActivityError as Ct, ObjectCallbackSetters as D, digest as Dt, InboxListenerSetters as E, buildCollectionSynchronizationHeader as Et, RetryContext as F, respondWithObject as G, RouterOptions as H, RetryPolicy as I, InProcessMessageQueueOptions as J, respondWithObjectIfAcceptable as K, createExponentialBackoffPolicy as L, FederationQueueOptions as M, createFederation as N, OutboxListenerSetters as O, ActivityTransformer as Ot, CreateExponentialBackoffPolicyOptions as P, ParallelMessageQueue as Q, Message as R, FederationStartQueueOptions as S, WebFingerLinksDispatcher as St, InboxChallengePolicy as T, PageItems as Tt, RouterRouteResult as U, RouterError as V, RespondWithObjectOptions as W, MessageQueueEnqueueOptions as X, MessageQueue as Y, MessageQueueListenOptions as Z, Federatable as _, OutboxListenerErrorHandler as _t, GetSignedKeyOptions as a, CollectionCursor as at, FederationFetchOptions as b, UnverifiedActivityHandler as bt, ParseUriResult as c, CustomCollectionCursor as ct, SendActivityOptions as d, InboxListener as dt, ActorDispatcher as et, SendActivityOptionsForCollection as f, NodeInfoDispatcher as ft, CustomCollectionCallbackSetters as g, OutboxListener as gt, ConstructorWithTypeId as h, OutboxErrorHandler as ht, GetActorOptions as i, CollectionCounter as it, FederationOrigin as j, Rfc6570Expression as k, RequestContext as l, CustomCollectionDispatcher as lt, CollectionCallbackSetters as m, ObjectDispatcher as mt, Context as n, ActorKeyPairsDispatcher as nt, InboxContext as o, CollectionDispatcher as ot, ActorCallbackSetters as p, ObjectAuthorizePredicate as pt, InProcessMessageQueue as q, ForwardActivityOptions as r, AuthorizePredicate as rt, OutboxContext as s, CustomCollectionCounter as st, ActorKeyPair as t, ActorHandleMapper as tt, RouteActivityOptions as u, InboxErrorHandler as ut, Federation as v, OutboxPermanentFailureHandler as vt, IdempotencyStrategy as w, SenderKeyPair as wt, FederationOptions as x, UnverifiedActivityReason as xt, FederationBuilder as y, SharedInboxKeyDispatcher as yt, createFederationBuilder as z };

package/dist/{context-Juj6bdHC.mjs → context-Dk_tacqz.mjs}

@@ -96,10 +96,25 @@ function createInboxContext(args) {
 			data
 		})),
 		recipient: args.recipient ?? null,
-		forwardActivity: args.forwardActivity ?? ((_params) => {
+		forwardActivity: args.forwardActivity ?? ((_forwarder, _recipients, _options) => {
 			throw new Error("Not implemented");
 		})
 	};
 }
+function createOutboxContext(args) {
+	const forwardActivity = args.forwardActivity ?? ((_forwarder, _recipients, _options) => {
+		throw new Error("Not implemented");
+	});
+	return {
+		...createContext(args),
+		clone: args.clone ?? ((data) => createOutboxContext({
+			...args,
+			data
+		})),
+		identifier: args.identifier,
+		hasDeliveredActivity: args.hasDeliveredActivity ?? (() => false),
+		forwardActivity
+	};
+}
 //#endregion
-export { createRequestContext as n, createInboxContext as t };
+export { createOutboxContext as n, createRequestContext as r, createInboxContext as t };

package/dist/{deno-vxcWcxQS.mjs → deno-ZTLy21O_.mjs}

@@ -3,6 +3,6 @@ import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 //#region deno.json
 var name = "@fedify/fedify";
-var version = "2.2.0-pr.695.16+7a782334";
+var version = "2.2.0-pr.697.17+8d06dbd9";
 //#endregion
 export { version as n, name as t };

package/dist/{docloader-D7q0-Xef.mjs → docloader-qLB9fFVV.mjs}

@@ -1,8 +1,8 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { o as validateCryptoKey } from "./key-CGx_dDkX.mjs";
-import { n as doubleKnock } from "./http-RZPxDWq5.mjs";
+import { o as validateCryptoKey } from "./key-DVFCI5om.mjs";
+import { n as doubleKnock } from "./http-CFmrJbuT.mjs";
 import { curry } from "es-toolkit";
 import { UrlError, createActivityPubRequest, getRemoteDocument, logRequest, validatePublicUrl } from "@fedify/vocab-runtime";
 import { getLogger } from "@logtape/logtape";