@fedify/testing 2.2.0-pr.695.16 → 2.2.0-pr.697.18

package/dist/mod.cjs

@@ -1,5 +1,6 @@
 const { Temporal } = require("@js-temporal/polyfill");
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _fedify_fedify_sig = require("@fedify/fedify/sig");
 let _fedify_vocab = require("@fedify/vocab");
 let _fedify_fedify_federation = require("@fedify/fedify/federation");
 let es_toolkit = require("es-toolkit");
@@ -112,6 +113,9 @@ function createRequestContext(args) {
 * @since 1.8.0
 */
 function createInboxContext(args) {
+	const forwardActivity = args.forwardActivity ?? ((_forwarder, _recipients, _options) => {
+		throw new Error("Not implemented");
+	});
 	return {
 		...createContext(args),
 		clone: args.clone ?? ((data) => createInboxContext({
@@ -119,9 +123,29 @@ function createInboxContext(args) {
 			data
 		})),
 		recipient: args.recipient ?? null,
-		forwardActivity: args.forwardActivity ?? ((_params) => {
-			throw new Error("Not implemented");
-		})
+		forwardActivity
+	};
+}
+/**
+* Creates an OutboxContext for testing purposes.
+* Not exported - used internally only. Public API is in mock.ts
+* @param args Partial OutboxContext properties
+* @returns An OutboxContext instance
+* @since 2.2.0
+*/
+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
@@ -131,17 +155,41 @@ const noopTracerProvider = { getTracer: () => ({
 	startSpan: () => void 0
 }) };
 /**
-* Helper function to expand URI templates with values.
-* Supports simple placeholders like {identifier}, etc.
+* Helper function to expand URI templates used by the mock.
+* Supports the RFC 6570 operators accepted by Fedify's identifier paths.
 * @param template The URI template pattern
 * @param values The values to substitute
 * @returns The expanded URI path
 */
 function expandUriTemplate(template, values) {
-	return template.replace(/{([^}]+)}/g, (match, key) => {
-		return values[key] || match;
+	return template.replace(/{([+#./;?&]?)([A-Za-z_][A-Za-z0-9_]*)}/g, (match, operator, key) => {
+		const value = values[key];
+		if (value == null) return match;
+		switch (operator) {
+			case "": return encodeURIComponent(value);
+			case "+": return encodeURI(value);
+			case "#": return `#${encodeURI(value)}`;
+			case ".": return `.${encodeURIComponent(value)}`;
+			case "/": return `/${encodeURIComponent(value)}`;
+			case ";": return `;${key}=${encodeURIComponent(value)}`;
+			case "?": return `?${key}=${encodeURIComponent(value)}`;
+			case "&": return `&${key}=${encodeURIComponent(value)}`;
+			default: return match;
+		}
 	});
 }
+function validateOutboxListenerPath(path, dispatcherPath) {
+	if (!path.startsWith("/")) throw new TypeError("Path must start with a slash.");
+	if (dispatcherPath != null && dispatcherPath !== path) throw new TypeError("Outbox listener path and outbox dispatcher path must match.");
+	const operatorMatches = globalThis.Array.from(path.matchAll(/{([+#./;?&]?)([A-Za-z_][A-Za-z0-9_]*)}/g));
+	if (operatorMatches.some((match) => [
+		"?",
+		"&",
+		"#"
+	].includes(match[1]) && match[2] === "identifier")) throw new TypeError("Path for outbox cannot use query or fragment expansion for identifier.");
+	const variables = operatorMatches.map((match) => match[2]);
+	if (variables.length !== 1 || variables[0] !== "identifier") throw new TypeError("Path for outbox must have exactly one variable named identifier.");
+}
 /**
 * A mock implementation of the {@link Federation} interface for unit testing.
 * This class provides a way to test Fedify applications without needing
@@ -198,12 +246,17 @@ var MockFederation = class {
 	objectDispatchers = /* @__PURE__ */ new Map();
 	inboxDispatcher;
 	outboxDispatcher;
+	outboxAuthorizePredicate;
+	outboxDispatcherAuthorizePredicate;
+	outboxListenerErrorHandler;
 	followingDispatcher;
 	followersDispatcher;
 	likedDispatcher;
 	featuredDispatcher;
 	featuredTagsDispatcher;
 	inboxListeners = /* @__PURE__ */ new Map();
+	outboxListeners = /* @__PURE__ */ new Map();
+	outboxListenersInitialized = false;
 	contextData;
 	receivedActivities = [];
 	constructor(options = {}) {
@@ -245,13 +298,17 @@ var MockFederation = class {
 		};
 	}
 	setOutboxDispatcher(path, dispatcher) {
+		validateOutboxListenerPath(path, this.outboxListenersInitialized ? this.outboxPath : void 0);
 		this.outboxDispatcher = dispatcher;
 		this.outboxPath = path;
 		return {
 			setCounter: () => this,
 			setFirstCursor: () => this,
 			setLastCursor: () => this,
-			authorize: () => this
+			authorize: (predicate) => {
+				this.outboxDispatcherAuthorizePredicate = predicate;
+				return this;
+			}
 		};
 	}
 	setFollowingDispatcher(path, dispatcher) {
@@ -329,6 +386,28 @@ var MockFederation = class {
 			}
 		};
 	}
+	setOutboxListeners(outboxPath) {
+		if (this.outboxListenersInitialized) throw new TypeError("Outbox listeners already set.");
+		validateOutboxListenerPath(outboxPath, this.outboxPath);
+		this.outboxListenersInitialized = true;
+		this.outboxPath = outboxPath;
+		const self = this;
+		return {
+			on(type, listener) {
+				if (self.outboxListeners.has(type)) throw new TypeError("Listener already set for this type.");
+				self.outboxListeners.set(type, listener);
+				return this;
+			},
+			onError(handler) {
+				self.outboxListenerErrorHandler = handler;
+				return this;
+			},
+			authorize(predicate) {
+				self.outboxAuthorizePredicate = predicate;
+				return this;
+			}
+		};
+	}
 	setOutboxPermanentFailureHandler(_handler) {}
 	async startQueue(contextData, options) {
 		this.contextData = contextData;
@@ -345,8 +424,10 @@ var MockFederation = class {
 	}
 	createContext(baseUrlOrRequest, contextData) {
 		const mockFederation = this;
+		const request = baseUrlOrRequest instanceof Request ? baseUrlOrRequest : null;
 		return new MockContext({
-			url: baseUrlOrRequest instanceof Request ? new URL(baseUrlOrRequest.url) : baseUrlOrRequest,
+			url: request == null ? baseUrlOrRequest : new URL(request.url),
+			request,
 			data: contextData,
 			federation: mockFederation
 		});
@@ -374,6 +455,81 @@ var MockFederation = class {
 		}), activity);
 	}
 	/**
+	* Simulates posting an activity to a local actor outbox.
+	* This method is specific to the mock implementation and is used for
+	* testing purposes.
+	*
+	* @param identifier The identifier of the outbox owner.
+	* @param activity The activity to post.
+	* @returns A promise that resolves when the activity has been processed.
+	* @since 2.2.0
+	*/
+	async postOutboxActivity(identifier, activity) {
+		if (!this.outboxListenersInitialized) throw new Error("MockFederation.postOutboxActivity(): setOutboxListeners() is not initialized.");
+		let ctor = activity.constructor;
+		let listener = this.outboxListeners.get(ctor);
+		while (listener == null && ctor !== _fedify_vocab.Activity) {
+			ctor = globalThis.Object.getPrototypeOf(ctor);
+			listener = this.outboxListeners.get(ctor);
+		}
+		if (listener != null && this.contextData === void 0) throw new Error("MockFederation.postOutboxActivity(): contextData is not initialized. Please provide contextData through the constructor or call startQueue() before posting activities.");
+		const origin = new URL(this.options.origin ?? "https://example.com");
+		const routingContext = this.createContext(origin, this.contextData);
+		const postedJson = await activity.toJsonLd({ contextLoader: routingContext.contextLoader });
+		const request = new Request(routingContext.getOutboxUri(identifier), {
+			method: "POST",
+			body: JSON.stringify(postedJson),
+			headers: { "content-type": "application/activity+json" }
+		});
+		const baseContext = this.createContext(request, this.contextData);
+		const rawActivity = postedJson;
+		const deliveryState = { delivered: false };
+		const createMockOutboxContext = () => createOutboxContext({
+			...baseContext,
+			clone: void 0,
+			federation: this,
+			identifier,
+			hasDeliveredActivity: () => deliveryState.delivered,
+			sendActivity: async (sender, recipients, outboundActivity, options) => {
+				await baseContext.sendActivity(sender, recipients, outboundActivity, options);
+				deliveryState.delivered = true;
+			},
+			forwardActivity: async (forwarder, recipients, options) => {
+				const hasProof = (0, _fedify_fedify_sig.hasProofLike)(rawActivity);
+				const hasLds = (0, _fedify_fedify_sig.hasSignatureLike)(rawActivity);
+				if (options?.skipIfUnsigned && !hasProof && !hasLds) return;
+				await baseContext.sendActivity(forwarder, recipients, activity, {
+					...options,
+					rawActivity
+				});
+				deliveryState.delivered = true;
+			}
+		});
+		const actor = await baseContext.getActor(identifier);
+		if (actor == null) throw new Error(`Actor ${JSON.stringify(identifier)} not found.`);
+		const authorizePredicate = this.outboxAuthorizePredicate ?? this.outboxDispatcherAuthorizePredicate;
+		if (authorizePredicate != null && !await authorizePredicate(baseContext, identifier)) throw new Error("Unauthorized.");
+		const expectedActorId = actor.id ?? baseContext.getActorUri(identifier);
+		if (activity.actorIds.length < 1) {
+			const error = /* @__PURE__ */ new Error("The posted activity has no actor.");
+			await this.outboxListenerErrorHandler?.(createMockOutboxContext(), error);
+			throw error;
+		}
+		if (!activity.actorIds.every((actorId) => actorId.href === expectedActorId.href)) {
+			const error = /* @__PURE__ */ new Error("The activity actor does not match the outbox owner.");
+			await this.outboxListenerErrorHandler?.(createMockOutboxContext(), error);
+			throw error;
+		}
+		if (listener == null) return;
+		const context = createMockOutboxContext();
+		try {
+			await listener(context, activity);
+		} catch (error) {
+			await this.outboxListenerErrorHandler?.(context, error);
+			throw error;
+		}
+	}
+	/**
 	* Clears all sent activities from the mock federation.
 	* This method is specific to the mock implementation and is used for
 	* testing purposes.
@@ -502,7 +658,7 @@ var MockContext = class MockContext {
 		this.host = url.host;
 		this.hostname = url.hostname;
 		this.url = url;
-		this.request = new Request(url);
+		this.request = options.request ?? new Request(url);
 		this.data = options.data;
 		this.federation = options.federation;
 		this.documentLoader = options.documentLoader ?? (async (url) => ({
@@ -671,11 +827,12 @@ var MockContext = class MockContext {
 	lookupWebFinger(_resource, _options) {
 		return Promise.resolve(null);
 	}
-	sendActivity(sender, recipients, activity, _options) {
+	sendActivity(sender, recipients, activity, options) {
 		this.sentActivities.push({
 			sender,
 			recipients,
-			activity
+			activity,
+			rawActivity: options?.rawActivity
 		});
 		if (this.federation instanceof MockFederation) {
 			const queued = this.federation.queueStarted;
@@ -683,6 +840,7 @@ var MockContext = class MockContext {
 				queued,
 				queue: queued ? "outbox" : void 0,
 				activity,
+				rawActivity: options?.rawActivity,
 				sentOrder: ++this.federation.sentCounter
 			});
 		}
@@ -894,6 +1052,7 @@ const getRandomKey = (prefix) => `fedify_test_${prefix}_${crypto.randomUUID()}`;
 exports.createContext = createContext;
 exports.createFederation = createFederation;
 exports.createInboxContext = createInboxContext;
+exports.createOutboxContext = createOutboxContext;
 exports.createRequestContext = createRequestContext;
 exports.getRandomKey = getRandomKey;
 exports.testMessageQueue = testMessageQueue;

package/dist/mod.d.cts

@@ -1,4 +1,4 @@
-import { Context, Federation, InboxContext, RequestContext } from "@fedify/fedify/federation";
+import { Context, Federation, InboxContext, OutboxContext, RequestContext } from "@fedify/fedify/federation";
 import { Activity } from "@fedify/vocab";
 import { MessageQueue } from "@fedify/fedify";
 
@@ -27,6 +27,12 @@ declare function createRequestContext<TContextData>(args: Partial<RequestContext
 */
 type TestInboxContext<TContextData> = InboxContext<TContextData>;
 /**
+* Test-specific OutboxContext type alias.
+* This indirection helps avoid JSR type analyzer issues.
+* @since 2.2.0
+*/
+type TestOutboxContext<TContextData> = OutboxContext<TContextData>;
+/**
 * Creates an InboxContext for testing purposes.
 * Not exported - used internally only. Public API is in mock.ts
 * @param args Partial InboxContext properties
@@ -39,6 +45,19 @@ declare function createInboxContext<TContextData>(args: Partial<InboxContext<TCo
   recipient?: string | null;
   federation: Federation<TContextData>;
 }): TestInboxContext<TContextData>;
+/**
+* Creates an OutboxContext for testing purposes.
+* Not exported - used internally only. Public API is in mock.ts
+* @param args Partial OutboxContext properties
+* @returns An OutboxContext instance
+* @since 2.2.0
+*/
+declare function createOutboxContext<TContextData>(args: Partial<OutboxContext<TContextData>> & {
+  url?: URL;
+  data: TContextData;
+  identifier: string;
+  federation: Federation<TContextData>;
+}): TestOutboxContext<TContextData>;
 //#endregion
 //#region src/mock.d.ts
 /**
@@ -52,6 +71,8 @@ interface SentActivity {
   queue?: "inbox" | "outbox" | "fanout";
   /** The activity that was sent. */
   activity: Activity;
+  /** The raw forwarded payload, if preserved by the caller. */
+  rawActivity?: unknown;
   /** The order in which the activity was sent (auto-incrementing counter). */
   sentOrder: number;
 }
@@ -66,6 +87,7 @@ interface TestContext<TContextData> extends Omit<Context<TContextData>, "clone">
     sender: any;
     recipients: any;
     activity: Activity;
+    rawActivity?: unknown;
   }>;
   reset(): void;
 }
@@ -79,6 +101,7 @@ interface TestFederation<TContextData> extends Omit<Federation<TContextData>, "c
   queueStarted: boolean;
   sentCounter: number;
   receiveActivity(activity: Activity): Promise<void>;
+  postOutboxActivity(identifier: string, activity: Activity): Promise<void>;
   reset(): void;
   createContext(baseUrlOrRequest: URL | Request, contextData: TContextData): TestContext<TContextData>;
 }
@@ -194,4 +217,4 @@ declare function testMessageQueue<MQ extends MessageQueue>(getMessageQueue: () =
 declare function waitFor(predicate: () => boolean, timeoutMs: number): Promise<void>;
 declare const getRandomKey: (prefix: string) => string;
 //#endregion
-export { type TestMessageQueueOptions, createContext, createFederation, createInboxContext, createRequestContext, getRandomKey, testMessageQueue, waitFor };
+export { type TestMessageQueueOptions, createContext, createFederation, createInboxContext, createOutboxContext, createRequestContext, getRandomKey, testMessageQueue, waitFor };

package/dist/mod.d.ts

@@ -1,6 +1,6 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { Activity } from "@fedify/vocab";
-import { Context, Federation, InboxContext, RequestContext } from "@fedify/fedify/federation";
+import { Context, Federation, InboxContext, OutboxContext, RequestContext } from "@fedify/fedify/federation";
 import { MessageQueue } from "@fedify/fedify";
 
 //#region src/context.d.ts
@@ -28,6 +28,12 @@ declare function createRequestContext<TContextData>(args: Partial<RequestContext
 */
 type TestInboxContext<TContextData> = InboxContext<TContextData>;
 /**
+* Test-specific OutboxContext type alias.
+* This indirection helps avoid JSR type analyzer issues.
+* @since 2.2.0
+*/
+type TestOutboxContext<TContextData> = OutboxContext<TContextData>;
+/**
 * Creates an InboxContext for testing purposes.
 * Not exported - used internally only. Public API is in mock.ts
 * @param args Partial InboxContext properties
@@ -40,6 +46,19 @@ declare function createInboxContext<TContextData>(args: Partial<InboxContext<TCo
   recipient?: string | null;
   federation: Federation<TContextData>;
 }): TestInboxContext<TContextData>;
+/**
+* Creates an OutboxContext for testing purposes.
+* Not exported - used internally only. Public API is in mock.ts
+* @param args Partial OutboxContext properties
+* @returns An OutboxContext instance
+* @since 2.2.0
+*/
+declare function createOutboxContext<TContextData>(args: Partial<OutboxContext<TContextData>> & {
+  url?: URL;
+  data: TContextData;
+  identifier: string;
+  federation: Federation<TContextData>;
+}): TestOutboxContext<TContextData>;
 //#endregion
 //#region src/mock.d.ts
 /**
@@ -53,6 +72,8 @@ interface SentActivity {
   queue?: "inbox" | "outbox" | "fanout";
   /** The activity that was sent. */
   activity: Activity;
+  /** The raw forwarded payload, if preserved by the caller. */
+  rawActivity?: unknown;
   /** The order in which the activity was sent (auto-incrementing counter). */
   sentOrder: number;
 }
@@ -67,6 +88,7 @@ interface TestContext<TContextData> extends Omit<Context<TContextData>, "clone">
     sender: any;
     recipients: any;
     activity: Activity;
+    rawActivity?: unknown;
   }>;
   reset(): void;
 }
@@ -80,6 +102,7 @@ interface TestFederation<TContextData> extends Omit<Federation<TContextData>, "c
   queueStarted: boolean;
   sentCounter: number;
   receiveActivity(activity: Activity): Promise<void>;
+  postOutboxActivity(identifier: string, activity: Activity): Promise<void>;
   reset(): void;
   createContext(baseUrlOrRequest: URL | Request, contextData: TContextData): TestContext<TContextData>;
 }
@@ -195,4 +218,4 @@ declare function testMessageQueue<MQ extends MessageQueue>(getMessageQueue: () =
 declare function waitFor(predicate: () => boolean, timeoutMs: number): Promise<void>;
 declare const getRandomKey: (prefix: string) => string;
 //#endregion
-export { type TestMessageQueueOptions, createContext, createFederation, createInboxContext, createRequestContext, getRandomKey, testMessageQueue, waitFor };
+export { type TestMessageQueueOptions, createContext, createFederation, createInboxContext, createOutboxContext, createRequestContext, getRandomKey, testMessageQueue, waitFor };

package/dist/mod.js

@@ -1,5 +1,6 @@
 import { Temporal } from "@js-temporal/polyfill";
-import { CryptographicKey, Multikey, lookupObject, traverseCollection } from "@fedify/vocab";
+import { hasProofLike, hasSignatureLike } from "@fedify/fedify/sig";
+import { Activity, CryptographicKey, Multikey, lookupObject, traverseCollection } from "@fedify/vocab";
 import { RouterError } from "@fedify/fedify/federation";
 import { delay } from "es-toolkit";
 import { deepStrictEqual, ok, strictEqual } from "node:assert/strict";
@@ -111,6 +112,9 @@ function createRequestContext(args) {
 * @since 1.8.0
 */
 function createInboxContext(args) {
+	const forwardActivity = args.forwardActivity ?? ((_forwarder, _recipients, _options) => {
+		throw new Error("Not implemented");
+	});
 	return {
 		...createContext(args),
 		clone: args.clone ?? ((data) => createInboxContext({
@@ -118,9 +122,29 @@ function createInboxContext(args) {
 			data
 		})),
 		recipient: args.recipient ?? null,
-		forwardActivity: args.forwardActivity ?? ((_params) => {
-			throw new Error("Not implemented");
-		})
+		forwardActivity
+	};
+}
+/**
+* Creates an OutboxContext for testing purposes.
+* Not exported - used internally only. Public API is in mock.ts
+* @param args Partial OutboxContext properties
+* @returns An OutboxContext instance
+* @since 2.2.0
+*/
+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
@@ -130,17 +154,41 @@ const noopTracerProvider = { getTracer: () => ({
 	startSpan: () => void 0
 }) };
 /**
-* Helper function to expand URI templates with values.
-* Supports simple placeholders like {identifier}, etc.
+* Helper function to expand URI templates used by the mock.
+* Supports the RFC 6570 operators accepted by Fedify's identifier paths.
 * @param template The URI template pattern
 * @param values The values to substitute
 * @returns The expanded URI path
 */
 function expandUriTemplate(template, values) {
-	return template.replace(/{([^}]+)}/g, (match, key) => {
-		return values[key] || match;
+	return template.replace(/{([+#./;?&]?)([A-Za-z_][A-Za-z0-9_]*)}/g, (match, operator, key) => {
+		const value = values[key];
+		if (value == null) return match;
+		switch (operator) {
+			case "": return encodeURIComponent(value);
+			case "+": return encodeURI(value);
+			case "#": return `#${encodeURI(value)}`;
+			case ".": return `.${encodeURIComponent(value)}`;
+			case "/": return `/${encodeURIComponent(value)}`;
+			case ";": return `;${key}=${encodeURIComponent(value)}`;
+			case "?": return `?${key}=${encodeURIComponent(value)}`;
+			case "&": return `&${key}=${encodeURIComponent(value)}`;
+			default: return match;
+		}
 	});
 }
+function validateOutboxListenerPath(path, dispatcherPath) {
+	if (!path.startsWith("/")) throw new TypeError("Path must start with a slash.");
+	if (dispatcherPath != null && dispatcherPath !== path) throw new TypeError("Outbox listener path and outbox dispatcher path must match.");
+	const operatorMatches = globalThis.Array.from(path.matchAll(/{([+#./;?&]?)([A-Za-z_][A-Za-z0-9_]*)}/g));
+	if (operatorMatches.some((match) => [
+		"?",
+		"&",
+		"#"
+	].includes(match[1]) && match[2] === "identifier")) throw new TypeError("Path for outbox cannot use query or fragment expansion for identifier.");
+	const variables = operatorMatches.map((match) => match[2]);
+	if (variables.length !== 1 || variables[0] !== "identifier") throw new TypeError("Path for outbox must have exactly one variable named identifier.");
+}
 /**
 * A mock implementation of the {@link Federation} interface for unit testing.
 * This class provides a way to test Fedify applications without needing
@@ -197,12 +245,17 @@ var MockFederation = class {
 	objectDispatchers = /* @__PURE__ */ new Map();
 	inboxDispatcher;
 	outboxDispatcher;
+	outboxAuthorizePredicate;
+	outboxDispatcherAuthorizePredicate;
+	outboxListenerErrorHandler;
 	followingDispatcher;
 	followersDispatcher;
 	likedDispatcher;
 	featuredDispatcher;
 	featuredTagsDispatcher;
 	inboxListeners = /* @__PURE__ */ new Map();
+	outboxListeners = /* @__PURE__ */ new Map();
+	outboxListenersInitialized = false;
 	contextData;
 	receivedActivities = [];
 	constructor(options = {}) {
@@ -244,13 +297,17 @@ var MockFederation = class {
 		};
 	}
 	setOutboxDispatcher(path, dispatcher) {
+		validateOutboxListenerPath(path, this.outboxListenersInitialized ? this.outboxPath : void 0);
 		this.outboxDispatcher = dispatcher;
 		this.outboxPath = path;
 		return {
 			setCounter: () => this,
 			setFirstCursor: () => this,
 			setLastCursor: () => this,
-			authorize: () => this
+			authorize: (predicate) => {
+				this.outboxDispatcherAuthorizePredicate = predicate;
+				return this;
+			}
 		};
 	}
 	setFollowingDispatcher(path, dispatcher) {
@@ -328,6 +385,28 @@ var MockFederation = class {
 			}
 		};
 	}
+	setOutboxListeners(outboxPath) {
+		if (this.outboxListenersInitialized) throw new TypeError("Outbox listeners already set.");
+		validateOutboxListenerPath(outboxPath, this.outboxPath);
+		this.outboxListenersInitialized = true;
+		this.outboxPath = outboxPath;
+		const self = this;
+		return {
+			on(type, listener) {
+				if (self.outboxListeners.has(type)) throw new TypeError("Listener already set for this type.");
+				self.outboxListeners.set(type, listener);
+				return this;
+			},
+			onError(handler) {
+				self.outboxListenerErrorHandler = handler;
+				return this;
+			},
+			authorize(predicate) {
+				self.outboxAuthorizePredicate = predicate;
+				return this;
+			}
+		};
+	}
 	setOutboxPermanentFailureHandler(_handler) {}
 	async startQueue(contextData, options) {
 		this.contextData = contextData;
@@ -344,8 +423,10 @@ var MockFederation = class {
 	}
 	createContext(baseUrlOrRequest, contextData) {
 		const mockFederation = this;
+		const request = baseUrlOrRequest instanceof Request ? baseUrlOrRequest : null;
 		return new MockContext({
-			url: baseUrlOrRequest instanceof Request ? new URL(baseUrlOrRequest.url) : baseUrlOrRequest,
+			url: request == null ? baseUrlOrRequest : new URL(request.url),
+			request,
 			data: contextData,
 			federation: mockFederation
 		});
@@ -373,6 +454,81 @@ var MockFederation = class {
 		}), activity);
 	}
 	/**
+	* Simulates posting an activity to a local actor outbox.
+	* This method is specific to the mock implementation and is used for
+	* testing purposes.
+	*
+	* @param identifier The identifier of the outbox owner.
+	* @param activity The activity to post.
+	* @returns A promise that resolves when the activity has been processed.
+	* @since 2.2.0
+	*/
+	async postOutboxActivity(identifier, activity) {
+		if (!this.outboxListenersInitialized) throw new Error("MockFederation.postOutboxActivity(): setOutboxListeners() is not initialized.");
+		let ctor = activity.constructor;
+		let listener = this.outboxListeners.get(ctor);
+		while (listener == null && ctor !== Activity) {
+			ctor = globalThis.Object.getPrototypeOf(ctor);
+			listener = this.outboxListeners.get(ctor);
+		}
+		if (listener != null && this.contextData === void 0) throw new Error("MockFederation.postOutboxActivity(): contextData is not initialized. Please provide contextData through the constructor or call startQueue() before posting activities.");
+		const origin = new URL(this.options.origin ?? "https://example.com");
+		const routingContext = this.createContext(origin, this.contextData);
+		const postedJson = await activity.toJsonLd({ contextLoader: routingContext.contextLoader });
+		const request = new Request(routingContext.getOutboxUri(identifier), {
+			method: "POST",
+			body: JSON.stringify(postedJson),
+			headers: { "content-type": "application/activity+json" }
+		});
+		const baseContext = this.createContext(request, this.contextData);
+		const rawActivity = postedJson;
+		const deliveryState = { delivered: false };
+		const createMockOutboxContext = () => createOutboxContext({
+			...baseContext,
+			clone: void 0,
+			federation: this,
+			identifier,
+			hasDeliveredActivity: () => deliveryState.delivered,
+			sendActivity: async (sender, recipients, outboundActivity, options) => {
+				await baseContext.sendActivity(sender, recipients, outboundActivity, options);
+				deliveryState.delivered = true;
+			},
+			forwardActivity: async (forwarder, recipients, options) => {
+				const hasProof = hasProofLike(rawActivity);
+				const hasLds = hasSignatureLike(rawActivity);
+				if (options?.skipIfUnsigned && !hasProof && !hasLds) return;
+				await baseContext.sendActivity(forwarder, recipients, activity, {
+					...options,
+					rawActivity
+				});
+				deliveryState.delivered = true;
+			}
+		});
+		const actor = await baseContext.getActor(identifier);
+		if (actor == null) throw new Error(`Actor ${JSON.stringify(identifier)} not found.`);
+		const authorizePredicate = this.outboxAuthorizePredicate ?? this.outboxDispatcherAuthorizePredicate;
+		if (authorizePredicate != null && !await authorizePredicate(baseContext, identifier)) throw new Error("Unauthorized.");
+		const expectedActorId = actor.id ?? baseContext.getActorUri(identifier);
+		if (activity.actorIds.length < 1) {
+			const error = /* @__PURE__ */ new Error("The posted activity has no actor.");
+			await this.outboxListenerErrorHandler?.(createMockOutboxContext(), error);
+			throw error;
+		}
+		if (!activity.actorIds.every((actorId) => actorId.href === expectedActorId.href)) {
+			const error = /* @__PURE__ */ new Error("The activity actor does not match the outbox owner.");
+			await this.outboxListenerErrorHandler?.(createMockOutboxContext(), error);
+			throw error;
+		}
+		if (listener == null) return;
+		const context = createMockOutboxContext();
+		try {
+			await listener(context, activity);
+		} catch (error) {
+			await this.outboxListenerErrorHandler?.(context, error);
+			throw error;
+		}
+	}
+	/**
 	* Clears all sent activities from the mock federation.
 	* This method is specific to the mock implementation and is used for
 	* testing purposes.
@@ -501,7 +657,7 @@ var MockContext = class MockContext {
 		this.host = url.host;
 		this.hostname = url.hostname;
 		this.url = url;
-		this.request = new Request(url);
+		this.request = options.request ?? new Request(url);
 		this.data = options.data;
 		this.federation = options.federation;
 		this.documentLoader = options.documentLoader ?? (async (url) => ({
@@ -670,11 +826,12 @@ var MockContext = class MockContext {
 	lookupWebFinger(_resource, _options) {
 		return Promise.resolve(null);
 	}
-	sendActivity(sender, recipients, activity, _options) {
+	sendActivity(sender, recipients, activity, options) {
 		this.sentActivities.push({
 			sender,
 			recipients,
-			activity
+			activity,
+			rawActivity: options?.rawActivity
 		});
 		if (this.federation instanceof MockFederation) {
 			const queued = this.federation.queueStarted;
@@ -682,6 +839,7 @@ var MockContext = class MockContext {
 				queued,
 				queue: queued ? "outbox" : void 0,
 				activity,
+				rawActivity: options?.rawActivity,
 				sentOrder: ++this.federation.sentCounter
 			});
 		}
@@ -890,4 +1048,4 @@ async function waitFor(predicate, timeoutMs) {
 }
 const getRandomKey = (prefix) => `fedify_test_${prefix}_${crypto.randomUUID()}`;
 //#endregion
-export { createContext, createFederation, createInboxContext, createRequestContext, getRandomKey, testMessageQueue, waitFor };
+export { createContext, createFederation, createInboxContext, createOutboxContext, createRequestContext, getRandomKey, testMessageQueue, waitFor };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/testing",
-  "version": "2.2.0-pr.695.16+7a782334",
+  "version": "2.2.0-pr.697.18+b776632f",
   "description": "Testing utilities for Fedify applications",
   "keywords": [
     "fedify",
@@ -50,7 +50,7 @@
     "package.json"
   ],
   "peerDependencies": {
-    "@fedify/fedify": "^2.2.0-pr.695.16+7a782334"
+    "@fedify/fedify": "^2.2.0-pr.697.18+b776632f"
   },
   "dependencies": {
     "es-toolkit": "1.43.0"