@fedify/testing 2.0.0-dev.1641 → 2.0.0-dev.166

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright 2024–2025 Hong Minhee
+Copyright 2024–2026 Hong Minhee
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

package/README.md

@@ -40,7 +40,7 @@ interface for unit testing:
 
 ~~~~ typescript
 import { MockFederation } from "@fedify/testing";
-import { Create } from "@fedify/fedify/vocab";
+import { Create } from "@fedify/vocab";
 
 // Create a mock federation
 const federation = new MockFederation<{ userId: string }>();
@@ -95,10 +95,12 @@ The package also exports helper functions for creating various context types:
  -  `createRequestContext()`: Creates a request context
  -  `createInboxContext()`: Creates an inbox context
 
-## Features
 
-- Track sent activities with metadata
-- Simulate activity reception
-- Configure custom URI templates
-- Test queue-based activity processing
-- Mock document loaders and context loaders
+Features
+--------
+
+ -  Track sent activities with metadata
+ -  Simulate activity reception
+ -  Configure custom URI templates
+ -  Test queue-based activity processing
+ -  Mock document loaders and context loaders

package/dist/mod.cjs

@@ -21,10 +21,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const __opentelemetry_api = __toESM(require("@opentelemetry/api"));
 const __fedify_fedify_federation = __toESM(require("@fedify/fedify/federation"));
-const __fedify_fedify_vocab = __toESM(require("@fedify/fedify/vocab"));
-const __fedify_fedify_webfinger = __toESM(require("@fedify/fedify/webfinger"));
+const __fedify_vocab = __toESM(require("@fedify/vocab"));
 
 //#region src/docloader.ts
 const mockDocumentLoader = async (url) => ({
@@ -35,6 +33,10 @@ const mockDocumentLoader = async (url) => ({
 
 //#endregion
 //#region src/context.ts
+const noopTracerProvider$1 = { getTracer: () => ({
+	startActiveSpan: () => void 0,
+	startSpan: () => void 0
+}) };
 function createContext(values) {
 	const { federation, url = new URL("http://example.com/"), canonicalOrigin, data, documentLoader, contextLoader, tracerProvider, clone, getNodeInfoUri, getActorUri, getObjectUri, getCollectionUri, getOutboxUri, getInboxUri, getFollowingUri, getFollowersUri, getLikedUri, getFeaturedUri, getFeaturedTagsUri, parseUri, getActorKeyPairs, getDocumentLoader, lookupObject, traverseCollection, lookupNodeInfo, lookupWebFinger, sendActivity, routeActivity } = values;
 	function throwRouteError() {
@@ -49,7 +51,7 @@ function createContext(values) {
 		hostname: url.hostname,
 		documentLoader: documentLoader ?? mockDocumentLoader,
 		contextLoader: contextLoader ?? mockDocumentLoader,
-		tracerProvider: tracerProvider ?? __opentelemetry_api.trace.getTracerProvider(),
+		tracerProvider: tracerProvider ?? noopTracerProvider$1,
 		clone: clone ?? ((data$1) => createContext({
 			...values,
 			data: data$1
@@ -73,13 +75,13 @@ function createContext(values) {
 		}),
 		getActorKeyPairs: getActorKeyPairs ?? ((_handle) => Promise.resolve([])),
 		lookupObject: lookupObject ?? ((uri, options = {}) => {
-			return (0, __fedify_fedify_vocab.lookupObject)(uri, {
+			return (0, __fedify_vocab.lookupObject)(uri, {
 				documentLoader: options.documentLoader ?? documentLoader ?? mockDocumentLoader,
 				contextLoader: options.contextLoader ?? contextLoader ?? mockDocumentLoader
 			});
 		}),
 		traverseCollection: traverseCollection ?? ((collection, options = {}) => {
-			return (0, __fedify_fedify_vocab.traverseCollection)(collection, {
+			return (0, __fedify_vocab.traverseCollection)(collection, {
 				documentLoader: options.documentLoader ?? documentLoader ?? mockDocumentLoader,
 				contextLoader: options.contextLoader ?? contextLoader ?? mockDocumentLoader
 			});
@@ -87,8 +89,8 @@ function createContext(values) {
 		lookupNodeInfo: lookupNodeInfo ?? ((_params) => {
 			throw new Error("Not implemented");
 		}),
-		lookupWebFinger: lookupWebFinger ?? ((resource, options = {}) => {
-			return (0, __fedify_fedify_webfinger.lookupWebFinger)(resource, options);
+		lookupWebFinger: lookupWebFinger ?? ((_resource, _options = {}) => {
+			return Promise.resolve(null);
 		}),
 		sendActivity: sendActivity ?? ((_params) => {
 			throw new Error("Not implemented");
@@ -98,6 +100,13 @@ function createContext(values) {
 		})
 	};
 }
+/**
+* Creates a RequestContext for testing purposes.
+* Not exported - used internally only. Public API is in mock.ts
+* @param args Partial RequestContext properties
+* @returns A RequestContext instance
+* @since 1.8.0
+*/
 function createRequestContext(args) {
 	return {
 		...createContext(args),
@@ -116,6 +125,13 @@ function createRequestContext(args) {
 		})
 	};
 }
+/**
+* Creates an InboxContext for testing purposes.
+* Not exported - used internally only. Public API is in mock.ts
+* @param args Partial InboxContext properties
+* @returns An InboxContext instance
+* @since 1.8.0
+*/
 function createInboxContext(args) {
 	return {
 		...createContext(args),
@@ -132,6 +148,10 @@ function createInboxContext(args) {
 
 //#endregion
 //#region src/mock.ts
+const noopTracerProvider = { getTracer: () => ({
+	startActiveSpan: () => void 0,
+	startSpan: () => void 0
+}) };
 /**
 * Helper function to expand URI templates with values.
 * Supports simple placeholders like {identifier}, {handle}, etc.
@@ -151,18 +171,18 @@ function expandUriTemplate(template, values) {
 *
 * @example
 * ```typescript
-* import { Create } from "@fedify/fedify/vocab";
-* import { MockFederation } from "@fedify/testing";
+* import { Create } from "@fedify/vocab";
+* import { createFederation } from "@fedify/testing";
 *
 * // Create a mock federation with contextData
-* const federation = new MockFederation<{ userId: string }>({
+* const federation = createFederation<{ userId: string }>({
 *   contextData: { userId: "test-user" }
 * });
 *
 * // Set up inbox listeners
 * federation
 *   .setInboxListeners("/users/{identifier}/inbox")
-*   .on(Create, async (ctx, activity) => {
+*   .on(Create, async (ctx: any, activity: any) => {
 *     console.log("Received:", activity);
 *   });
 *
@@ -318,6 +338,9 @@ var MockFederation = class {
 			},
 			setSharedKeyDispatcher() {
 				return this;
+			},
+			withIdempotency() {
+				return this;
 			}
 		};
 	}
@@ -336,22 +359,9 @@ var MockFederation = class {
 	}
 	createContext(baseUrlOrRequest, contextData) {
 		const mockFederation = this;
-		if (baseUrlOrRequest instanceof Request) return createRequestContext({
-			url: new URL(baseUrlOrRequest.url),
-			request: baseUrlOrRequest,
-			data: contextData,
-			federation: mockFederation,
-			sendActivity: async (sender, recipients, activity, options) => {
-				const tempContext = new MockContext({
-					url: new URL(baseUrlOrRequest.url),
-					data: contextData,
-					federation: mockFederation
-				});
-				await tempContext.sendActivity(sender, recipients, activity, options);
-			}
-		});
-		else return new MockContext({
-			url: baseUrlOrRequest,
+		const url = baseUrlOrRequest instanceof Request ? new URL(baseUrlOrRequest.url) : baseUrlOrRequest;
+		return new MockContext({
+			url,
 			data: contextData,
 			federation: mockFederation
 		});
@@ -409,22 +419,66 @@ var MockFederation = class {
 	}
 };
 /**
+* Creates a mock Federation instance for testing purposes.
+*
+* @template TContextData The type of context data to use
+* @param options Optional configuration for the mock federation
+* @returns A Federation instance that can be used for testing
+* @since 1.9.1
+*
+* @example
+* ```typescript
+* import { Create } from "@fedify/vocab";
+* import { createFederation } from "@fedify/testing";
+*
+* // Create a mock federation with contextData
+* const federation = createFederation<{ userId: string }>({
+*   contextData: { userId: "test-user" }
+* });
+*
+* // Set up inbox listeners
+* federation
+*   .setInboxListeners("/users/{identifier}/inbox")
+*   .on(Create, async (ctx, activity) => {
+*     console.log("Received:", activity);
+*   });
+*
+* // Simulate receiving an activity
+* const createActivity = new Create({
+*   id: new URL("https://example.com/create/1"),
+*   actor: new URL("https://example.com/users/alice")
+* });
+* await federation.receiveActivity(createActivity);
+*
+* // Check sent activities
+* console.log(federation.sentActivities);
+* ```
+*/
+function createFederation(options = {}) {
+	return new MockFederation(options);
+}
+/**
 * A mock implementation of the {@link Context} interface for unit testing.
 * This class provides a way to test Fedify applications without needing
 * a real federation context.
 *
+* Note: This class is not exported from the public API to avoid JSR type
+* analyzer issues. The MockContext class has complex type dependencies that
+* can cause JSR's type analyzer to hang during processing (issue #468).
+* Use {@link MockFederation.createContext}, {@link createContext},
+* {@link createRequestContext}, or {@link createInboxContext} instead.
+*
 * @example
 * ```typescript
-* import { Person, Create } from "@fedify/fedify/vocab";
-* import { MockContext, MockFederation } from "@fedify/testing";
+* import { Person, Create } from "@fedify/vocab";
+* import { createFederation } from "@fedify/testing";
 *
-* // Create a mock context
-* const mockFederation = new MockFederation<{ userId: string }>();
-* const context = new MockContext({
-*   url: new URL("https://example.com"),
-*   data: { userId: "test-user" },
-*   federation: mockFederation
-* });
+* // Create a mock federation and context
+* const federation = createFederation<{ userId: string }>();
+* const context = federation.createContext(
+*   new URL("https://example.com"),
+*   { userId: "test-user" }
+* );
 *
 * // Send an activity
 * const recipient = new Person({ id: new URL("https://example.com/users/bob") });
@@ -438,8 +492,8 @@ var MockFederation = class {
 *   activity
 * );
 *
-* // Check sent activities
-* const sent = context.getSentActivities();
+* // Check sent activities from the federation
+* const sent = federation.sentActivities;
 * console.log(sent[0].activity);
 * ```
 *
@@ -456,6 +510,8 @@ var MockContext = class MockContext {
 	documentLoader;
 	contextLoader;
 	tracerProvider;
+	request;
+	url;
 	sentActivities = [];
 	constructor(options) {
 		const url = options.url ?? new URL("https://example.com");
@@ -463,6 +519,8 @@ var MockContext = class MockContext {
 		this.canonicalOrigin = url.origin;
 		this.host = url.host;
 		this.hostname = url.hostname;
+		this.url = url;
+		this.request = new Request(url);
 		this.data = options.data;
 		this.federation = options.federation;
 		this.documentLoader = options.documentLoader ?? (async (url$1) => ({
@@ -471,11 +529,23 @@ var MockContext = class MockContext {
 			documentUrl: url$1
 		}));
 		this.contextLoader = options.contextLoader ?? this.documentLoader;
-		this.tracerProvider = options.tracerProvider ?? __opentelemetry_api.trace.getTracerProvider();
+		this.tracerProvider = options.tracerProvider ?? noopTracerProvider;
+	}
+	getActor(_handle) {
+		return Promise.resolve(null);
+	}
+	getObject(_cls, _values) {
+		return Promise.resolve(null);
+	}
+	getSignedKey() {
+		return Promise.resolve(null);
+	}
+	getSignedKeyOwner() {
+		return Promise.resolve(null);
 	}
 	clone(data) {
 		return new MockContext({
-			url: new URL(this.origin),
+			url: this.url,
 			data,
 			federation: this.federation,
 			documentLoader: this.documentLoader,
@@ -657,8 +727,7 @@ var MockContext = class MockContext {
 };
 
 //#endregion
-exports.MockContext = MockContext;
-exports.MockFederation = MockFederation;
 exports.createContext = createContext;
+exports.createFederation = createFederation;
 exports.createInboxContext = createInboxContext;
 exports.createRequestContext = createRequestContext;

package/dist/mod.d.cts

@@ -1,12 +1,45 @@
-import { ActorCallbackSetters, ActorDispatcher, ActorKeyPair, CollectionCallbackSetters, CollectionDispatcher, Context, Federation, FederationFetchOptions, FederationStartQueueOptions, InboxContext, InboxListenerSetters, Message, NodeInfoDispatcher, ObjectCallbackSetters, ObjectDispatcher, ParseUriResult, RequestContext, RouteActivityOptions, SendActivityOptions, SendActivityOptionsForCollection, SenderKeyPair, WebFingerLinksDispatcher } from "@fedify/fedify/federation";
-import { JsonValue, NodeInfo } from "@fedify/fedify/nodeinfo";
-import { DocumentLoader } from "@fedify/fedify/runtime";
-import { Activity, Actor, Collection, Hashtag, LookupObjectOptions, Object as Object$1, Recipient, TraverseCollectionOptions } from "@fedify/fedify/vocab";
-import { ResourceDescriptor } from "@fedify/fedify/webfinger";
-import { TracerProvider } from "@opentelemetry/api";
+import { Context, Federation, InboxContext, RequestContext } from "@fedify/fedify/federation";
+import { Activity } from "@fedify/vocab";
 
+//#region src/context.d.ts
+declare function createContext<TContextData>(values: Partial<Context<TContextData>> & {
+  url?: URL;
+  data: TContextData;
+  federation: Federation<TContextData>;
+}): Context<TContextData>;
+/**
+ * Creates a RequestContext for testing purposes.
+ * Not exported - used internally only. Public API is in mock.ts
+ * @param args Partial RequestContext properties
+ * @returns A RequestContext instance
+ * @since 1.8.0
+ */
+declare function createRequestContext<TContextData>(args: Partial<RequestContext<TContextData>> & {
+  url: URL;
+  data: TContextData;
+  federation: Federation<TContextData>;
+}): RequestContext<TContextData>;
+/**
+ * Test-specific InboxContext type alias.
+ * This indirection helps avoid JSR type analyzer issues.
+ * @since 1.9.1
+ */
+type TestInboxContext<TContextData> = InboxContext<TContextData>;
+/**
+ * Creates an InboxContext for testing purposes.
+ * Not exported - used internally only. Public API is in mock.ts
+ * @param args Partial InboxContext properties
+ * @returns An InboxContext instance
+ * @since 1.8.0
+ */
+declare function createInboxContext<TContextData>(args: Partial<InboxContext<TContextData>> & {
+  url?: URL;
+  data: TContextData;
+  recipient?: string | null;
+  federation: Federation<TContextData>;
+}): TestInboxContext<TContextData>;
+//#endregion
 //#region src/mock.d.ts
-
 /**
  * Represents a sent activity with metadata about how it was sent.
  * @since 1.8.0
@@ -22,17 +55,47 @@ interface SentActivity {
   sentOrder: number;
 }
 /**
- * A mock implementation of the {@link Federation} interface for unit testing.
- * This class provides a way to test Fedify applications without needing
- * a real federation setup.
+ * A mock Context interface for testing purposes.
+ * Extends the standard Context interface with additional testing utilities.
+ * @since 1.9.1
+ */
+interface TestContext<TContextData> extends Omit<Context<TContextData>, "clone">, Pick<RequestContext<TContextData>, "request" | "url" | "getActor" | "getObject" | "getSignedKey" | "getSignedKeyOwner" | "sendActivity" | "routeActivity"> {
+  clone(data: TContextData): TestContext<TContextData>;
+  getSentActivities(): Array<{
+    sender: any;
+    recipients: any;
+    activity: Activity;
+  }>;
+  reset(): void;
+}
+/**
+ * A mock Federation interface for testing purposes.
+ * Extends the standard Federation interface with additional testing utilities.
+ * @since 1.9.1
+ */
+interface TestFederation<TContextData> extends Omit<Federation<TContextData>, "createContext"> {
+  sentActivities: SentActivity[];
+  queueStarted: boolean;
+  sentCounter: number;
+  receiveActivity(activity: Activity): Promise<void>;
+  reset(): void;
+  createContext(baseUrlOrRequest: URL | Request, contextData: TContextData): TestContext<TContextData>;
+}
+/**
+ * Creates a mock Federation instance for testing purposes.
+ *
+ * @template TContextData The type of context data to use
+ * @param options Optional configuration for the mock federation
+ * @returns A Federation instance that can be used for testing
+ * @since 1.9.1
  *
  * @example
  * ```typescript
- * import { Create } from "@fedify/fedify/vocab";
- * import { MockFederation } from "@fedify/testing";
+ * import { Create } from "@fedify/vocab";
+ * import { createFederation } from "@fedify/testing";
  *
  * // Create a mock federation with contextData
- * const federation = new MockFederation<{ userId: string }>({
+ * const federation = createFederation<{ userId: string }>({
  *   contextData: { userId: "test-user" }
  * });
  *
@@ -49,249 +112,15 @@ interface SentActivity {
  *   actor: new URL("https://example.com/users/alice")
  * });
  * await federation.receiveActivity(createActivity);
- * ```
- *
- * @template TContextData The context data to pass to the {@link Context}.
- * @since 1.8.0
- */
-declare class MockFederation<TContextData> implements Federation<TContextData> {
-  private options;
-  sentActivities: SentActivity[];
-  queueStarted: boolean;
-  private activeQueues;
-  sentCounter: number;
-  private nodeInfoDispatcher?;
-  private webFingerDispatcher?;
-  private actorDispatchers;
-  actorPath?: string;
-  inboxPath?: string;
-  outboxPath?: string;
-  followingPath?: string;
-  followersPath?: string;
-  likedPath?: string;
-  featuredPath?: string;
-  featuredTagsPath?: string;
-  nodeInfoPath?: string;
-  sharedInboxPath?: string;
-  objectPaths: Map<string, string>;
-  private objectDispatchers;
-  private inboxDispatcher?;
-  private outboxDispatcher?;
-  private followingDispatcher?;
-  private followersDispatcher?;
-  private likedDispatcher?;
-  private featuredDispatcher?;
-  private featuredTagsDispatcher?;
-  private inboxListeners;
-  private contextData?;
-  private receivedActivities;
-  constructor(options?: {
-    contextData?: TContextData;
-    origin?: string;
-    tracerProvider?: TracerProvider;
-  });
-  setNodeInfoDispatcher(path: string, dispatcher: NodeInfoDispatcher<TContextData>): void;
-  setWebFingerLinksDispatcher(dispatcher: WebFingerLinksDispatcher<TContextData>): void;
-  setActorDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: ActorDispatcher<TContextData>): ActorCallbackSetters<TContextData>;
-  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: string, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
-  setInboxDispatcher(_path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Activity, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setOutboxDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Activity, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setFollowingDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Actor | URL, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setFollowersDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Recipient, Context<TContextData>, TContextData, URL>): CollectionCallbackSetters<Context<TContextData>, TContextData, URL>;
-  setLikedDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Object$1 | URL, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setFeaturedDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Object$1, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setFeaturedTagsDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Hashtag, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setInboxListeners(inboxPath: `${string}{identifier}${string}` | `${string}{handle}${string}`, sharedInboxPath?: string): InboxListenerSetters<TContextData>;
-  startQueue(contextData: TContextData, options?: FederationStartQueueOptions): Promise<void>;
-  processQueuedTask(contextData: TContextData, _message: Message): Promise<void>;
-  createContext(baseUrl: URL, contextData: TContextData): Context<TContextData>;
-  createContext(request: Request, contextData: TContextData): RequestContext<TContextData>;
-  fetch(request: Request, options: FederationFetchOptions<TContextData>): Promise<Response>;
-  /**
-   * Simulates receiving an activity. This method is specific to the mock
-   * implementation and is used for testing purposes.
-   *
-   * @param activity The activity to receive.
-   * @returns A promise that resolves when the activity has been processed.
-   * @since 1.8.0
-   */
-  receiveActivity(activity: Activity): Promise<void>;
-  /**
-   * Clears all sent activities from the mock federation.
-   * This method is specific to the mock implementation and is used for
-   * testing purposes.
-   *
-   * @since 1.8.0
-   */
-  reset(): void;
-  setCollectionDispatcher<TObject extends Object$1, TParams extends Record<string, string>>(_name: string | symbol, _itemType: any, _path: any, _dispatcher: any): any;
-  setOrderedCollectionDispatcher<TObject extends Object$1, TParams extends Record<string, string>>(_name: string | symbol, _itemType: any, _path: any, _dispatcher: any): any;
-}
-/**
- * A mock implementation of the {@link Context} interface for unit testing.
- * This class provides a way to test Fedify applications without needing
- * a real federation context.
- *
- * @example
- * ```typescript
- * import { Person, Create } from "@fedify/fedify/vocab";
- * import { MockContext, MockFederation } from "@fedify/testing";
- *
- * // Create a mock context
- * const mockFederation = new MockFederation<{ userId: string }>();
- * const context = new MockContext({
- *   url: new URL("https://example.com"),
- *   data: { userId: "test-user" },
- *   federation: mockFederation
- * });
- *
- * // Send an activity
- * const recipient = new Person({ id: new URL("https://example.com/users/bob") });
- * const activity = new Create({
- *   id: new URL("https://example.com/create/1"),
- *   actor: new URL("https://example.com/users/alice")
- * });
- * await context.sendActivity(
- *   { identifier: "alice" },
- *   recipient,
- *   activity
- * );
  *
  * // Check sent activities
- * const sent = context.getSentActivities();
- * console.log(sent[0].activity);
+ * console.log(federation.sentActivities);
  * ```
- *
- * @template TContextData The context data to pass to the {@link Context}.
- * @since 1.8.0
  */
-declare class MockContext<TContextData> implements Context<TContextData> {
-  readonly origin: string;
-  readonly canonicalOrigin: string;
-  readonly host: string;
-  readonly hostname: string;
-  readonly data: TContextData;
-  readonly federation: Federation<TContextData>;
-  readonly documentLoader: DocumentLoader;
-  readonly contextLoader: DocumentLoader;
-  readonly tracerProvider: TracerProvider;
-  private sentActivities;
-  constructor(options: {
-    url?: URL;
-    data: TContextData;
-    federation: Federation<TContextData>;
-    documentLoader?: DocumentLoader;
-    contextLoader?: DocumentLoader;
-    tracerProvider?: TracerProvider;
-  });
-  clone(data: TContextData): Context<TContextData>;
-  getNodeInfoUri(): URL;
-  getActorUri(identifier: string): URL;
-  getObjectUri<TObject extends Object$1>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, values: Record<string, string>): URL;
-  getOutboxUri(identifier: string): URL;
-  getInboxUri(identifier: string): URL;
-  getInboxUri(): URL;
-  getFollowingUri(identifier: string): URL;
-  getFollowersUri(identifier: string): URL;
-  getLikedUri(identifier: string): URL;
-  getFeaturedUri(identifier: string): URL;
-  getFeaturedTagsUri(identifier: string): URL;
-  getCollectionUri<TParam extends Record<string, string>>(_name: string | symbol, values: TParam): URL;
-  parseUri(uri: URL): ParseUriResult | null;
-  getActorKeyPairs(_identifier: string): Promise<ActorKeyPair[]>;
-  getDocumentLoader(params: {
-    handle: string;
-  } | {
-    identifier: string;
-  }): Promise<DocumentLoader>;
-  getDocumentLoader(params: {
-    keyId: URL;
-    privateKey: CryptoKey;
-  }): DocumentLoader;
-  lookupObject(_uri: URL | string, _options?: LookupObjectOptions): Promise<Object$1 | null>;
-  traverseCollection<TItem, TContext extends Context<TContextData>>(_collection: Collection | URL | null, _options?: TraverseCollectionOptions): AsyncIterable<TItem>;
-  lookupNodeInfo(url: URL | string, options?: {
-    parse?: "strict" | "best-effort";
-  } & any): Promise<NodeInfo | undefined>;
-  lookupNodeInfo(url: URL | string, options?: {
-    parse: "none";
-  } & any): Promise<JsonValue | undefined>;
-  lookupWebFinger(_resource: URL | `acct:${string}@${string}` | string, _options?: any): Promise<ResourceDescriptor | null>;
-  sendActivity(sender: SenderKeyPair | SenderKeyPair[] | {
-    identifier: string;
-  } | {
-    username: string;
-  } | {
-    handle: string;
-  }, recipients: Recipient | Recipient[], activity: Activity, options?: SendActivityOptions): Promise<void>;
-  sendActivity(sender: {
-    identifier: string;
-  } | {
-    username: string;
-  } | {
-    handle: string;
-  }, recipients: "followers", activity: Activity, options?: SendActivityOptionsForCollection): Promise<void>;
-  sendActivity(sender: SenderKeyPair | SenderKeyPair[] | {
-    identifier: string;
-  } | {
-    username: string;
-  } | {
-    handle: string;
-  }, recipients: Recipient | Recipient[], activity: Activity, options?: SendActivityOptions): Promise<void>;
-  sendActivity(sender: {
-    identifier: string;
-  } | {
-    username: string;
-  } | {
-    handle: string;
-  }, recipients: "followers", activity: Activity, options?: SendActivityOptionsForCollection): Promise<void>;
-  routeActivity(_recipient: string | null, _activity: Activity, _options?: RouteActivityOptions): Promise<boolean>;
-  /**
-   * Gets all activities that have been sent through this mock context.
-   * This method is specific to the mock implementation and is used for
-   * testing purposes.
-   *
-   * @returns An array of sent activity records.
-   */
-  getSentActivities(): Array<{
-    sender: SenderKeyPair | SenderKeyPair[] | {
-      identifier: string;
-    } | {
-      username: string;
-    } | {
-      handle: string;
-    };
-    recipients: Recipient | Recipient[] | "followers";
-    activity: Activity;
-  }>;
-  /**
-   * Clears all sent activities from the mock context.
-   * This method is specific to the mock implementation and is used for
-   * testing purposes.
-   */
-  reset(): void;
-}
-//#endregion
-//#region src/context.d.ts
-declare function createContext<TContextData>(values: Partial<Context<TContextData>> & {
-  url?: URL;
-  data: TContextData;
-  federation: Federation<TContextData>;
-}): Context<TContextData>;
-declare function createRequestContext<TContextData>(args: Partial<RequestContext<TContextData>> & {
-  url: URL;
-  data: TContextData;
-  federation: Federation<TContextData>;
-}): RequestContext<TContextData>;
-declare function createInboxContext<TContextData>(args: Partial<InboxContext<TContextData>> & {
-  url?: URL;
-  data: TContextData;
-  recipient?: string | null;
-  federation: Federation<TContextData>;
-}): InboxContext<TContextData>;
+declare function createFederation<TContextData>(options?: {
+  contextData?: TContextData;
+  origin?: string;
+  tracerProvider?: any;
+}): TestFederation<TContextData>;
 //#endregion
-export { MockContext, MockFederation, SentActivity, createContext, createInboxContext, createRequestContext };
+export { createContext, createFederation, createInboxContext, createRequestContext };

package/dist/mod.d.ts

@@ -1,12 +1,45 @@
-import { TracerProvider } from "@opentelemetry/api";
-import { ActorCallbackSetters, ActorDispatcher, ActorKeyPair, CollectionCallbackSetters, CollectionDispatcher, Context, Federation, FederationFetchOptions, FederationStartQueueOptions, InboxContext, InboxListenerSetters, Message, NodeInfoDispatcher, ObjectCallbackSetters, ObjectDispatcher, ParseUriResult, RequestContext, RouteActivityOptions, SendActivityOptions, SendActivityOptionsForCollection, SenderKeyPair, WebFingerLinksDispatcher } from "@fedify/fedify/federation";
-import { Activity, Actor, Collection, Hashtag, LookupObjectOptions, Object as Object$1, Recipient, TraverseCollectionOptions } from "@fedify/fedify/vocab";
-import { ResourceDescriptor } from "@fedify/fedify/webfinger";
-import { JsonValue, NodeInfo } from "@fedify/fedify/nodeinfo";
-import { DocumentLoader } from "@fedify/fedify/runtime";
+import { Context, Federation, InboxContext, RequestContext } from "@fedify/fedify/federation";
+import { Activity } from "@fedify/vocab";
 
+//#region src/context.d.ts
+declare function createContext<TContextData>(values: Partial<Context<TContextData>> & {
+  url?: URL;
+  data: TContextData;
+  federation: Federation<TContextData>;
+}): Context<TContextData>;
+/**
+ * Creates a RequestContext for testing purposes.
+ * Not exported - used internally only. Public API is in mock.ts
+ * @param args Partial RequestContext properties
+ * @returns A RequestContext instance
+ * @since 1.8.0
+ */
+declare function createRequestContext<TContextData>(args: Partial<RequestContext<TContextData>> & {
+  url: URL;
+  data: TContextData;
+  federation: Federation<TContextData>;
+}): RequestContext<TContextData>;
+/**
+ * Test-specific InboxContext type alias.
+ * This indirection helps avoid JSR type analyzer issues.
+ * @since 1.9.1
+ */
+type TestInboxContext<TContextData> = InboxContext<TContextData>;
+/**
+ * Creates an InboxContext for testing purposes.
+ * Not exported - used internally only. Public API is in mock.ts
+ * @param args Partial InboxContext properties
+ * @returns An InboxContext instance
+ * @since 1.8.0
+ */
+declare function createInboxContext<TContextData>(args: Partial<InboxContext<TContextData>> & {
+  url?: URL;
+  data: TContextData;
+  recipient?: string | null;
+  federation: Federation<TContextData>;
+}): TestInboxContext<TContextData>;
+//#endregion
 //#region src/mock.d.ts
-
 /**
  * Represents a sent activity with metadata about how it was sent.
  * @since 1.8.0
@@ -22,17 +55,47 @@ interface SentActivity {
   sentOrder: number;
 }
 /**
- * A mock implementation of the {@link Federation} interface for unit testing.
- * This class provides a way to test Fedify applications without needing
- * a real federation setup.
+ * A mock Context interface for testing purposes.
+ * Extends the standard Context interface with additional testing utilities.
+ * @since 1.9.1
+ */
+interface TestContext<TContextData> extends Omit<Context<TContextData>, "clone">, Pick<RequestContext<TContextData>, "request" | "url" | "getActor" | "getObject" | "getSignedKey" | "getSignedKeyOwner" | "sendActivity" | "routeActivity"> {
+  clone(data: TContextData): TestContext<TContextData>;
+  getSentActivities(): Array<{
+    sender: any;
+    recipients: any;
+    activity: Activity;
+  }>;
+  reset(): void;
+}
+/**
+ * A mock Federation interface for testing purposes.
+ * Extends the standard Federation interface with additional testing utilities.
+ * @since 1.9.1
+ */
+interface TestFederation<TContextData> extends Omit<Federation<TContextData>, "createContext"> {
+  sentActivities: SentActivity[];
+  queueStarted: boolean;
+  sentCounter: number;
+  receiveActivity(activity: Activity): Promise<void>;
+  reset(): void;
+  createContext(baseUrlOrRequest: URL | Request, contextData: TContextData): TestContext<TContextData>;
+}
+/**
+ * Creates a mock Federation instance for testing purposes.
+ *
+ * @template TContextData The type of context data to use
+ * @param options Optional configuration for the mock federation
+ * @returns A Federation instance that can be used for testing
+ * @since 1.9.1
  *
  * @example
  * ```typescript
- * import { Create } from "@fedify/fedify/vocab";
- * import { MockFederation } from "@fedify/testing";
+ * import { Create } from "@fedify/vocab";
+ * import { createFederation } from "@fedify/testing";
  *
  * // Create a mock federation with contextData
- * const federation = new MockFederation<{ userId: string }>({
+ * const federation = createFederation<{ userId: string }>({
  *   contextData: { userId: "test-user" }
  * });
  *
@@ -49,249 +112,15 @@ interface SentActivity {
  *   actor: new URL("https://example.com/users/alice")
  * });
  * await federation.receiveActivity(createActivity);
- * ```
- *
- * @template TContextData The context data to pass to the {@link Context}.
- * @since 1.8.0
- */
-declare class MockFederation<TContextData> implements Federation<TContextData> {
-  private options;
-  sentActivities: SentActivity[];
-  queueStarted: boolean;
-  private activeQueues;
-  sentCounter: number;
-  private nodeInfoDispatcher?;
-  private webFingerDispatcher?;
-  private actorDispatchers;
-  actorPath?: string;
-  inboxPath?: string;
-  outboxPath?: string;
-  followingPath?: string;
-  followersPath?: string;
-  likedPath?: string;
-  featuredPath?: string;
-  featuredTagsPath?: string;
-  nodeInfoPath?: string;
-  sharedInboxPath?: string;
-  objectPaths: Map<string, string>;
-  private objectDispatchers;
-  private inboxDispatcher?;
-  private outboxDispatcher?;
-  private followingDispatcher?;
-  private followersDispatcher?;
-  private likedDispatcher?;
-  private featuredDispatcher?;
-  private featuredTagsDispatcher?;
-  private inboxListeners;
-  private contextData?;
-  private receivedActivities;
-  constructor(options?: {
-    contextData?: TContextData;
-    origin?: string;
-    tracerProvider?: TracerProvider;
-  });
-  setNodeInfoDispatcher(path: string, dispatcher: NodeInfoDispatcher<TContextData>): void;
-  setWebFingerLinksDispatcher(dispatcher: WebFingerLinksDispatcher<TContextData>): void;
-  setActorDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: ActorDispatcher<TContextData>): ActorCallbackSetters<TContextData>;
-  setObjectDispatcher<TObject extends Object$1, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, path: string, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
-  setInboxDispatcher(_path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Activity, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setOutboxDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Activity, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setFollowingDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Actor | URL, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setFollowersDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Recipient, Context<TContextData>, TContextData, URL>): CollectionCallbackSetters<Context<TContextData>, TContextData, URL>;
-  setLikedDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Object$1 | URL, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setFeaturedDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Object$1, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setFeaturedTagsDispatcher(path: `${string}{identifier}${string}` | `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Hashtag, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-  setInboxListeners(inboxPath: `${string}{identifier}${string}` | `${string}{handle}${string}`, sharedInboxPath?: string): InboxListenerSetters<TContextData>;
-  startQueue(contextData: TContextData, options?: FederationStartQueueOptions): Promise<void>;
-  processQueuedTask(contextData: TContextData, _message: Message): Promise<void>;
-  createContext(baseUrl: URL, contextData: TContextData): Context<TContextData>;
-  createContext(request: Request, contextData: TContextData): RequestContext<TContextData>;
-  fetch(request: Request, options: FederationFetchOptions<TContextData>): Promise<Response>;
-  /**
-   * Simulates receiving an activity. This method is specific to the mock
-   * implementation and is used for testing purposes.
-   *
-   * @param activity The activity to receive.
-   * @returns A promise that resolves when the activity has been processed.
-   * @since 1.8.0
-   */
-  receiveActivity(activity: Activity): Promise<void>;
-  /**
-   * Clears all sent activities from the mock federation.
-   * This method is specific to the mock implementation and is used for
-   * testing purposes.
-   *
-   * @since 1.8.0
-   */
-  reset(): void;
-  setCollectionDispatcher<TObject extends Object$1, TParams extends Record<string, string>>(_name: string | symbol, _itemType: any, _path: any, _dispatcher: any): any;
-  setOrderedCollectionDispatcher<TObject extends Object$1, TParams extends Record<string, string>>(_name: string | symbol, _itemType: any, _path: any, _dispatcher: any): any;
-}
-/**
- * A mock implementation of the {@link Context} interface for unit testing.
- * This class provides a way to test Fedify applications without needing
- * a real federation context.
- *
- * @example
- * ```typescript
- * import { Person, Create } from "@fedify/fedify/vocab";
- * import { MockContext, MockFederation } from "@fedify/testing";
- *
- * // Create a mock context
- * const mockFederation = new MockFederation<{ userId: string }>();
- * const context = new MockContext({
- *   url: new URL("https://example.com"),
- *   data: { userId: "test-user" },
- *   federation: mockFederation
- * });
- *
- * // Send an activity
- * const recipient = new Person({ id: new URL("https://example.com/users/bob") });
- * const activity = new Create({
- *   id: new URL("https://example.com/create/1"),
- *   actor: new URL("https://example.com/users/alice")
- * });
- * await context.sendActivity(
- *   { identifier: "alice" },
- *   recipient,
- *   activity
- * );
  *
  * // Check sent activities
- * const sent = context.getSentActivities();
- * console.log(sent[0].activity);
+ * console.log(federation.sentActivities);
  * ```
- *
- * @template TContextData The context data to pass to the {@link Context}.
- * @since 1.8.0
  */
-declare class MockContext<TContextData> implements Context<TContextData> {
-  readonly origin: string;
-  readonly canonicalOrigin: string;
-  readonly host: string;
-  readonly hostname: string;
-  readonly data: TContextData;
-  readonly federation: Federation<TContextData>;
-  readonly documentLoader: DocumentLoader;
-  readonly contextLoader: DocumentLoader;
-  readonly tracerProvider: TracerProvider;
-  private sentActivities;
-  constructor(options: {
-    url?: URL;
-    data: TContextData;
-    federation: Federation<TContextData>;
-    documentLoader?: DocumentLoader;
-    contextLoader?: DocumentLoader;
-    tracerProvider?: TracerProvider;
-  });
-  clone(data: TContextData): Context<TContextData>;
-  getNodeInfoUri(): URL;
-  getActorUri(identifier: string): URL;
-  getObjectUri<TObject extends Object$1>(cls: (new (...args: any[]) => TObject) & {
-    typeId: URL;
-  }, values: Record<string, string>): URL;
-  getOutboxUri(identifier: string): URL;
-  getInboxUri(identifier: string): URL;
-  getInboxUri(): URL;
-  getFollowingUri(identifier: string): URL;
-  getFollowersUri(identifier: string): URL;
-  getLikedUri(identifier: string): URL;
-  getFeaturedUri(identifier: string): URL;
-  getFeaturedTagsUri(identifier: string): URL;
-  getCollectionUri<TParam extends Record<string, string>>(_name: string | symbol, values: TParam): URL;
-  parseUri(uri: URL): ParseUriResult | null;
-  getActorKeyPairs(_identifier: string): Promise<ActorKeyPair[]>;
-  getDocumentLoader(params: {
-    handle: string;
-  } | {
-    identifier: string;
-  }): Promise<DocumentLoader>;
-  getDocumentLoader(params: {
-    keyId: URL;
-    privateKey: CryptoKey;
-  }): DocumentLoader;
-  lookupObject(_uri: URL | string, _options?: LookupObjectOptions): Promise<Object$1 | null>;
-  traverseCollection<TItem, TContext extends Context<TContextData>>(_collection: Collection | URL | null, _options?: TraverseCollectionOptions): AsyncIterable<TItem>;
-  lookupNodeInfo(url: URL | string, options?: {
-    parse?: "strict" | "best-effort";
-  } & any): Promise<NodeInfo | undefined>;
-  lookupNodeInfo(url: URL | string, options?: {
-    parse: "none";
-  } & any): Promise<JsonValue | undefined>;
-  lookupWebFinger(_resource: URL | `acct:${string}@${string}` | string, _options?: any): Promise<ResourceDescriptor | null>;
-  sendActivity(sender: SenderKeyPair | SenderKeyPair[] | {
-    identifier: string;
-  } | {
-    username: string;
-  } | {
-    handle: string;
-  }, recipients: Recipient | Recipient[], activity: Activity, options?: SendActivityOptions): Promise<void>;
-  sendActivity(sender: {
-    identifier: string;
-  } | {
-    username: string;
-  } | {
-    handle: string;
-  }, recipients: "followers", activity: Activity, options?: SendActivityOptionsForCollection): Promise<void>;
-  sendActivity(sender: SenderKeyPair | SenderKeyPair[] | {
-    identifier: string;
-  } | {
-    username: string;
-  } | {
-    handle: string;
-  }, recipients: Recipient | Recipient[], activity: Activity, options?: SendActivityOptions): Promise<void>;
-  sendActivity(sender: {
-    identifier: string;
-  } | {
-    username: string;
-  } | {
-    handle: string;
-  }, recipients: "followers", activity: Activity, options?: SendActivityOptionsForCollection): Promise<void>;
-  routeActivity(_recipient: string | null, _activity: Activity, _options?: RouteActivityOptions): Promise<boolean>;
-  /**
-   * Gets all activities that have been sent through this mock context.
-   * This method is specific to the mock implementation and is used for
-   * testing purposes.
-   *
-   * @returns An array of sent activity records.
-   */
-  getSentActivities(): Array<{
-    sender: SenderKeyPair | SenderKeyPair[] | {
-      identifier: string;
-    } | {
-      username: string;
-    } | {
-      handle: string;
-    };
-    recipients: Recipient | Recipient[] | "followers";
-    activity: Activity;
-  }>;
-  /**
-   * Clears all sent activities from the mock context.
-   * This method is specific to the mock implementation and is used for
-   * testing purposes.
-   */
-  reset(): void;
-}
-//#endregion
-//#region src/context.d.ts
-declare function createContext<TContextData>(values: Partial<Context<TContextData>> & {
-  url?: URL;
-  data: TContextData;
-  federation: Federation<TContextData>;
-}): Context<TContextData>;
-declare function createRequestContext<TContextData>(args: Partial<RequestContext<TContextData>> & {
-  url: URL;
-  data: TContextData;
-  federation: Federation<TContextData>;
-}): RequestContext<TContextData>;
-declare function createInboxContext<TContextData>(args: Partial<InboxContext<TContextData>> & {
-  url?: URL;
-  data: TContextData;
-  recipient?: string | null;
-  federation: Federation<TContextData>;
-}): InboxContext<TContextData>;
+declare function createFederation<TContextData>(options?: {
+  contextData?: TContextData;
+  origin?: string;
+  tracerProvider?: any;
+}): TestFederation<TContextData>;
 //#endregion
-export { MockContext, MockFederation, SentActivity, createContext, createInboxContext, createRequestContext };
+export { createContext, createFederation, createInboxContext, createRequestContext };

package/dist/mod.js

@@ -1,7 +1,5 @@
-import { trace } from "@opentelemetry/api";
 import { RouterError } from "@fedify/fedify/federation";
-import { lookupObject, traverseCollection } from "@fedify/fedify/vocab";
-import { lookupWebFinger } from "@fedify/fedify/webfinger";
+import { lookupObject, traverseCollection } from "@fedify/vocab";
 
 //#region src/docloader.ts
 const mockDocumentLoader = async (url) => ({
@@ -12,8 +10,12 @@ const mockDocumentLoader = async (url) => ({
 
 //#endregion
 //#region src/context.ts
+const noopTracerProvider$1 = { getTracer: () => ({
+	startActiveSpan: () => void 0,
+	startSpan: () => void 0
+}) };
 function createContext(values) {
-	const { federation, url = new URL("http://example.com/"), canonicalOrigin, data, documentLoader, contextLoader, tracerProvider, clone, getNodeInfoUri, getActorUri, getObjectUri, getCollectionUri, getOutboxUri, getInboxUri, getFollowingUri, getFollowersUri, getLikedUri, getFeaturedUri, getFeaturedTagsUri, parseUri, getActorKeyPairs, getDocumentLoader, lookupObject: lookupObject$1, traverseCollection: traverseCollection$1, lookupNodeInfo, lookupWebFinger: lookupWebFinger$1, sendActivity, routeActivity } = values;
+	const { federation, url = new URL("http://example.com/"), canonicalOrigin, data, documentLoader, contextLoader, tracerProvider, clone, getNodeInfoUri, getActorUri, getObjectUri, getCollectionUri, getOutboxUri, getInboxUri, getFollowingUri, getFollowersUri, getLikedUri, getFeaturedUri, getFeaturedTagsUri, parseUri, getActorKeyPairs, getDocumentLoader, lookupObject: lookupObject$1, traverseCollection: traverseCollection$1, lookupNodeInfo, lookupWebFinger, sendActivity, routeActivity } = values;
 	function throwRouteError() {
 		throw new RouterError("Not implemented");
 	}
@@ -26,7 +28,7 @@ function createContext(values) {
 		hostname: url.hostname,
 		documentLoader: documentLoader ?? mockDocumentLoader,
 		contextLoader: contextLoader ?? mockDocumentLoader,
-		tracerProvider: tracerProvider ?? trace.getTracerProvider(),
+		tracerProvider: tracerProvider ?? noopTracerProvider$1,
 		clone: clone ?? ((data$1) => createContext({
 			...values,
 			data: data$1
@@ -64,8 +66,8 @@ function createContext(values) {
 		lookupNodeInfo: lookupNodeInfo ?? ((_params) => {
 			throw new Error("Not implemented");
 		}),
-		lookupWebFinger: lookupWebFinger$1 ?? ((resource, options = {}) => {
-			return lookupWebFinger(resource, options);
+		lookupWebFinger: lookupWebFinger ?? ((_resource, _options = {}) => {
+			return Promise.resolve(null);
 		}),
 		sendActivity: sendActivity ?? ((_params) => {
 			throw new Error("Not implemented");
@@ -75,6 +77,13 @@ function createContext(values) {
 		})
 	};
 }
+/**
+* Creates a RequestContext for testing purposes.
+* Not exported - used internally only. Public API is in mock.ts
+* @param args Partial RequestContext properties
+* @returns A RequestContext instance
+* @since 1.8.0
+*/
 function createRequestContext(args) {
 	return {
 		...createContext(args),
@@ -93,6 +102,13 @@ function createRequestContext(args) {
 		})
 	};
 }
+/**
+* Creates an InboxContext for testing purposes.
+* Not exported - used internally only. Public API is in mock.ts
+* @param args Partial InboxContext properties
+* @returns An InboxContext instance
+* @since 1.8.0
+*/
 function createInboxContext(args) {
 	return {
 		...createContext(args),
@@ -109,6 +125,10 @@ function createInboxContext(args) {
 
 //#endregion
 //#region src/mock.ts
+const noopTracerProvider = { getTracer: () => ({
+	startActiveSpan: () => void 0,
+	startSpan: () => void 0
+}) };
 /**
 * Helper function to expand URI templates with values.
 * Supports simple placeholders like {identifier}, {handle}, etc.
@@ -128,18 +148,18 @@ function expandUriTemplate(template, values) {
 *
 * @example
 * ```typescript
-* import { Create } from "@fedify/fedify/vocab";
-* import { MockFederation } from "@fedify/testing";
+* import { Create } from "@fedify/vocab";
+* import { createFederation } from "@fedify/testing";
 *
 * // Create a mock federation with contextData
-* const federation = new MockFederation<{ userId: string }>({
+* const federation = createFederation<{ userId: string }>({
 *   contextData: { userId: "test-user" }
 * });
 *
 * // Set up inbox listeners
 * federation
 *   .setInboxListeners("/users/{identifier}/inbox")
-*   .on(Create, async (ctx, activity) => {
+*   .on(Create, async (ctx: any, activity: any) => {
 *     console.log("Received:", activity);
 *   });
 *
@@ -295,6 +315,9 @@ var MockFederation = class {
 			},
 			setSharedKeyDispatcher() {
 				return this;
+			},
+			withIdempotency() {
+				return this;
 			}
 		};
 	}
@@ -313,22 +336,9 @@ var MockFederation = class {
 	}
 	createContext(baseUrlOrRequest, contextData) {
 		const mockFederation = this;
-		if (baseUrlOrRequest instanceof Request) return createRequestContext({
-			url: new URL(baseUrlOrRequest.url),
-			request: baseUrlOrRequest,
-			data: contextData,
-			federation: mockFederation,
-			sendActivity: async (sender, recipients, activity, options) => {
-				const tempContext = new MockContext({
-					url: new URL(baseUrlOrRequest.url),
-					data: contextData,
-					federation: mockFederation
-				});
-				await tempContext.sendActivity(sender, recipients, activity, options);
-			}
-		});
-		else return new MockContext({
-			url: baseUrlOrRequest,
+		const url = baseUrlOrRequest instanceof Request ? new URL(baseUrlOrRequest.url) : baseUrlOrRequest;
+		return new MockContext({
+			url,
 			data: contextData,
 			federation: mockFederation
 		});
@@ -386,22 +396,66 @@ var MockFederation = class {
 	}
 };
 /**
+* Creates a mock Federation instance for testing purposes.
+*
+* @template TContextData The type of context data to use
+* @param options Optional configuration for the mock federation
+* @returns A Federation instance that can be used for testing
+* @since 1.9.1
+*
+* @example
+* ```typescript
+* import { Create } from "@fedify/vocab";
+* import { createFederation } from "@fedify/testing";
+*
+* // Create a mock federation with contextData
+* const federation = createFederation<{ userId: string }>({
+*   contextData: { userId: "test-user" }
+* });
+*
+* // Set up inbox listeners
+* federation
+*   .setInboxListeners("/users/{identifier}/inbox")
+*   .on(Create, async (ctx, activity) => {
+*     console.log("Received:", activity);
+*   });
+*
+* // Simulate receiving an activity
+* const createActivity = new Create({
+*   id: new URL("https://example.com/create/1"),
+*   actor: new URL("https://example.com/users/alice")
+* });
+* await federation.receiveActivity(createActivity);
+*
+* // Check sent activities
+* console.log(federation.sentActivities);
+* ```
+*/
+function createFederation(options = {}) {
+	return new MockFederation(options);
+}
+/**
 * A mock implementation of the {@link Context} interface for unit testing.
 * This class provides a way to test Fedify applications without needing
 * a real federation context.
 *
+* Note: This class is not exported from the public API to avoid JSR type
+* analyzer issues. The MockContext class has complex type dependencies that
+* can cause JSR's type analyzer to hang during processing (issue #468).
+* Use {@link MockFederation.createContext}, {@link createContext},
+* {@link createRequestContext}, or {@link createInboxContext} instead.
+*
 * @example
 * ```typescript
-* import { Person, Create } from "@fedify/fedify/vocab";
-* import { MockContext, MockFederation } from "@fedify/testing";
+* import { Person, Create } from "@fedify/vocab";
+* import { createFederation } from "@fedify/testing";
 *
-* // Create a mock context
-* const mockFederation = new MockFederation<{ userId: string }>();
-* const context = new MockContext({
-*   url: new URL("https://example.com"),
-*   data: { userId: "test-user" },
-*   federation: mockFederation
-* });
+* // Create a mock federation and context
+* const federation = createFederation<{ userId: string }>();
+* const context = federation.createContext(
+*   new URL("https://example.com"),
+*   { userId: "test-user" }
+* );
 *
 * // Send an activity
 * const recipient = new Person({ id: new URL("https://example.com/users/bob") });
@@ -415,8 +469,8 @@ var MockFederation = class {
 *   activity
 * );
 *
-* // Check sent activities
-* const sent = context.getSentActivities();
+* // Check sent activities from the federation
+* const sent = federation.sentActivities;
 * console.log(sent[0].activity);
 * ```
 *
@@ -433,6 +487,8 @@ var MockContext = class MockContext {
 	documentLoader;
 	contextLoader;
 	tracerProvider;
+	request;
+	url;
 	sentActivities = [];
 	constructor(options) {
 		const url = options.url ?? new URL("https://example.com");
@@ -440,6 +496,8 @@ var MockContext = class MockContext {
 		this.canonicalOrigin = url.origin;
 		this.host = url.host;
 		this.hostname = url.hostname;
+		this.url = url;
+		this.request = new Request(url);
 		this.data = options.data;
 		this.federation = options.federation;
 		this.documentLoader = options.documentLoader ?? (async (url$1) => ({
@@ -448,11 +506,23 @@ var MockContext = class MockContext {
 			documentUrl: url$1
 		}));
 		this.contextLoader = options.contextLoader ?? this.documentLoader;
-		this.tracerProvider = options.tracerProvider ?? trace.getTracerProvider();
+		this.tracerProvider = options.tracerProvider ?? noopTracerProvider;
+	}
+	getActor(_handle) {
+		return Promise.resolve(null);
+	}
+	getObject(_cls, _values) {
+		return Promise.resolve(null);
+	}
+	getSignedKey() {
+		return Promise.resolve(null);
+	}
+	getSignedKeyOwner() {
+		return Promise.resolve(null);
 	}
 	clone(data) {
 		return new MockContext({
-			url: new URL(this.origin),
+			url: this.url,
 			data,
 			federation: this.federation,
 			documentLoader: this.documentLoader,
@@ -634,4 +704,4 @@ var MockContext = class MockContext {
 };
 
 //#endregion
-export { MockContext, MockFederation, createContext, createInboxContext, createRequestContext };
+export { createContext, createFederation, createInboxContext, createRequestContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/testing",
-  "version": "2.0.0-dev.1641+6b0c942c",
+  "version": "2.0.0-dev.166+15dea3c0",
   "description": "Testing utilities for Fedify applications",
   "keywords": [
     "fedify",
@@ -50,17 +50,14 @@
     "package.json"
   ],
   "peerDependencies": {
-    "@fedify/fedify": "^2.0.0-dev.1641+6b0c942c"
-  },
-  "dependencies": {
-    "@opentelemetry/api": "^1.9.0"
+    "@fedify/fedify": "^2.0.0-dev.166+15dea3c0"
   },
   "devDependencies": {
     "@js-temporal/polyfill": "^0.5.1",
     "@std/assert": "npm:@jsr/std__assert@^1.0.13",
     "@std/async": "npm:@jsr/std__async@^1.0.13",
     "tsdown": "^0.12.9",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   },
   "scripts": {
     "build": "tsdown",