@fedify/fedify 1.0.0-dev.397 → 1.0.0-dev.399

package/types/federation/middleware.d.ts

@@ -3,12 +3,18 @@
 import * as dntShim from "../_dnt.shims.js";
 import { type AuthenticatedDocumentLoaderFactory, type DocumentLoader } from "../runtime/docloader.js";
 import type { Actor, Recipient } from "../vocab/actor.js";
-import { Activity, type Hashtag, type Object } from "../vocab/vocab.js";
-import type { ActorDispatcher, ActorHandleMapper, ActorKeyPairsDispatcher, AuthorizePredicate, CollectionCounter, CollectionCursor, CollectionDispatcher, InboxErrorHandler, InboxListener, NodeInfoDispatcher, ObjectAuthorizePredicate, ObjectDispatcher, OutboxErrorHandler, SharedInboxKeyDispatcher } from "./callback.js";
-import type { Context, RequestContext } from "./context.js";
+import { type LookupObjectOptions } from "../vocab/lookup.js";
+import { Activity, type Hashtag, type Like, type Object } from "../vocab/vocab.js";
+import type { ActorDispatcher, ActorHandleMapper, ActorKeyPairsDispatcher, AuthorizePredicate, CollectionDispatcher, InboxErrorHandler, NodeInfoDispatcher, ObjectAuthorizePredicate, ObjectDispatcher, OutboxErrorHandler, SharedInboxKeyDispatcher } from "./callback.js";
+import type { ActorKeyPair, Context, ForwardActivityOptions, InboxContext, ParseUriResult, RequestContext, SendActivityOptions } from "./context.js";
+import type { ActorCallbackSetters, CollectionCallbackSetters, Federation, FederationFetchOptions, InboxListenerSetters, ObjectCallbackSetters } from "./federation.js";
+import { type CollectionCallbacks } from "./handler.js";
+import { InboxListenerSet } from "./inbox.js";
 import type { KvKey, KvStore } from "./kv.js";
 import type { MessageQueue } from "./mq.js";
 import { type RetryPolicy } from "./retry.js";
+import { Router } from "./router.js";
+import { type SenderKeyPair } from "./send.js";
 /**
  * Options for {@link createFederation} function.
  * @since 0.10.0
@@ -141,465 +147,158 @@ export interface FederationKvPrefixes {
     publicKey: KvKey;
 }
 /**
- * An object that registers federation-related business logic and dispatches
- * requests to the appropriate handlers.
- *
- * It also provides a middleware interface for handling requests before your
- * web framework's router; see {@link Federation.fetch}.
- *
- * @since 0.13.0
+ * Create a new {@link Federation} instance.
+ * @param parameters Parameters for initializing the instance.
+ * @returns A new {@link Federation} instance.
+ * @since 0.10.0
  */
-export interface Federation<TContextData> {
-    /**
-     * Manually start the task queue.
-     *
-     * This method is useful when you set the `manuallyStartQueue` option to
-     * `true` in the {@link createFederation} function.
-     * @param contextData The context data to pass to the context.
-     */
+export declare function createFederation<TContextData>(options: CreateFederationOptions): Federation<TContextData>;
+export declare class FederationImpl<TContextData> implements Federation<TContextData> {
+    #private;
+    kv: KvStore;
+    kvPrefixes: FederationKvPrefixes;
+    queue?: MessageQueue;
+    queueStarted: boolean;
+    manuallyStartQueue: boolean;
+    router: Router;
+    nodeInfoDispatcher?: NodeInfoDispatcher<TContextData>;
+    actorCallbacks?: ActorCallbacks<TContextData>;
+    objectCallbacks: Record<string, ObjectCallbacks<TContextData, string>>;
+    objectTypeIds: Record<string, (new (...args: any[]) => Object) & {
+        typeId: URL;
+    }>;
+    inboxPath?: string;
+    inboxCallbacks?: CollectionCallbacks<Activity, RequestContext<TContextData>, TContextData, void>;
+    outboxCallbacks?: CollectionCallbacks<Activity, RequestContext<TContextData>, TContextData, void>;
+    followingCallbacks?: CollectionCallbacks<Actor | URL, RequestContext<TContextData>, TContextData, void>;
+    followersCallbacks?: CollectionCallbacks<Recipient, Context<TContextData>, TContextData, URL>;
+    likedCallbacks?: CollectionCallbacks<Like, RequestContext<TContextData>, TContextData, void>;
+    featuredCallbacks?: CollectionCallbacks<Object, RequestContext<TContextData>, TContextData, void>;
+    featuredTagsCallbacks?: CollectionCallbacks<Hashtag, RequestContext<TContextData>, TContextData, void>;
+    inboxListeners?: InboxListenerSet<TContextData>;
+    inboxErrorHandler?: InboxErrorHandler<TContextData>;
+    sharedInboxKeyDispatcher?: SharedInboxKeyDispatcher<TContextData>;
+    documentLoader: DocumentLoader;
+    contextLoader: DocumentLoader;
+    authenticatedDocumentLoaderFactory: AuthenticatedDocumentLoaderFactory;
+    onOutboxError?: OutboxErrorHandler;
+    signatureTimeWindow: dntShim.Temporal.DurationLike | false;
+    skipSignatureVerification: boolean;
+    outboxRetryPolicy: RetryPolicy;
+    inboxRetryPolicy: RetryPolicy;
+    constructor(options: CreateFederationOptions);
     startQueue(contextData: TContextData): Promise<void>;
-    /**
-     * Create a new context.
-     * @param baseUrl The base URL of the server.  The `pathname` remains root,
-     *                and the `search` and `hash` are stripped.
-     * @param contextData The context data to pass to the context.
-     * @returns The new context.
-     */
     createContext(baseUrl: URL, contextData: TContextData): Context<TContextData>;
-    /**
-     * Create a new context for a request.
-     * @param request The request object.
-     * @param contextData The context data to pass to the context.
-     * @returns The new request context.
-     */
     createContext(request: Request, contextData: TContextData): RequestContext<TContextData>;
-    /**
-     * Registers a NodeInfo dispatcher.
-     * @param path The URI path pattern for the NodeInfo dispatcher.  The syntax
-     *             is based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have no variables.
-     * @param dispatcher A NodeInfo dispatcher callback to register.
-     * @throws {RouterError} Thrown if the path pattern is invalid.
-     */
     setNodeInfoDispatcher(path: string, dispatcher: NodeInfoDispatcher<TContextData>): void;
-    /**
-     * Registers an actor dispatcher.
-     *
-     * @example
-     * ``` typescript
-     * federation.setActorDispatcher(
-     *   "/users/{handle}",
-     *   async (ctx, handle) => {
-     *     return new Person({
-     *       id: ctx.getActorUri(handle),
-     *       preferredUsername: handle,
-     *       // ...
-     *     });
-     *   }
-     * );
-     * ```
-     *
-     * @param path The URI path pattern for the actor dispatcher.  The syntax is
-     *             based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one variable: `{handle}`.
-     * @param dispatcher An actor dispatcher callback to register.
-     * @returns An object with methods to set other actor dispatcher callbacks.
-     * @throws {RouterError} Thrown if the path pattern is invalid.
-     */
     setActorDispatcher(path: `${string}{handle}${string}`, dispatcher: ActorDispatcher<TContextData>): ActorCallbackSetters<TContextData>;
-    /**
-     * Registers an object dispatcher.
-     *
-     * @typeParam TContextData The context data to pass to the {@link Context}.
-     * @typeParam TObject The type of object to dispatch.
-     * @typeParam TParam The parameter names of the requested URL.
-     * @param cls The Activity Vocabulary class of the object to dispatch.
-     * @param path The URI path pattern for the object dispatcher.  The syntax is
-     *             based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one or more variables.
-     * @param dispatcher An object dispatcher callback to register.
-     */
     setObjectDispatcher<TObject extends Object, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
         typeId: URL;
     }, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
-    /**
-     * Registers an object dispatcher.
-     *
-     * @typeParam TContextData The context data to pass to the {@link Context}.
-     * @typeParam TObject The type of object to dispatch.
-     * @typeParam TParam The parameter names of the requested URL.
-     * @param cls The Activity Vocabulary class of the object to dispatch.
-     * @param path The URI path pattern for the object dispatcher.  The syntax is
-     *             based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one or more variables.
-     * @param dispatcher An object dispatcher callback to register.
-     */
     setObjectDispatcher<TObject extends Object, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
         typeId: URL;
     }, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
-    /**
-     * Registers an object dispatcher.
-     *
-     * @typeParam TContextData The context data to pass to the {@link Context}.
-     * @typeParam TObject The type of object to dispatch.
-     * @typeParam TParam The parameter names of the requested URL.
-     * @param cls The Activity Vocabulary class of the object to dispatch.
-     * @param path The URI path pattern for the object dispatcher.  The syntax is
-     *             based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one or more variables.
-     * @param dispatcher An object dispatcher callback to register.
-     */
     setObjectDispatcher<TObject extends Object, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
         typeId: URL;
     }, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
-    /**
-     * Registers an object dispatcher.
-     *
-     * @typeParam TContextData The context data to pass to the {@link Context}.
-     * @typeParam TObject The type of object to dispatch.
-     * @typeParam TParam The parameter names of the requested URL.
-     * @param cls The Activity Vocabulary class of the object to dispatch.
-     * @param path The URI path pattern for the object dispatcher.  The syntax is
-     *             based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one or more variables.
-     * @param dispatcher An object dispatcher callback to register.
-     */
     setObjectDispatcher<TObject extends Object, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
         typeId: URL;
     }, path: `${string}{${TParam}}${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
-    /**
-     * Registers an object dispatcher.
-     *
-     * @typeParam TContextData The context data to pass to the {@link Context}.
-     * @typeParam TObject The type of object to dispatch.
-     * @typeParam TParam The parameter names of the requested URL.
-     * @param cls The Activity Vocabulary class of the object to dispatch.
-     * @param path The URI path pattern for the object dispatcher.  The syntax is
-     *             based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one or more variables.
-     * @param dispatcher An object dispatcher callback to register.
-     */
     setObjectDispatcher<TObject extends Object, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
         typeId: URL;
     }, path: `${string}{${TParam}}${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
-    /**
-     * Registers an object dispatcher.
-     *
-     * @typeParam TContextData The context data to pass to the {@link Context}.
-     * @typeParam TObject The type of object to dispatch.
-     * @typeParam TParam The parameter names of the requested URL.
-     * @param cls The Activity Vocabulary class of the object to dispatch.
-     * @param path The URI path pattern for the object dispatcher.  The syntax is
-     *             based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one or more variables.
-     * @param dispatcher An object dispatcher callback to register.
-     */
     setObjectDispatcher<TObject extends Object, TParam extends string>(cls: (new (...args: any[]) => TObject) & {
         typeId: URL;
     }, path: `${string}{${TParam}}${string}`, dispatcher: ObjectDispatcher<TContextData, TObject, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
-    /**
-     * Registers an inbox dispatcher.
-     *
-     * @param path The URI path pattern for the outbox dispatcher.  The syntax is
-     *             based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one variable: `{handle}`, and must match the inbox
-     *             listener path.
-     * @param dispatcher An inbox dispatcher callback to register.
-     * @throws {@link RouterError} Thrown if the path pattern is invalid.
-     */
     setInboxDispatcher(path: `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Activity, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-    /**
-     * Registers an outbox dispatcher.
-     *
-     * @example
-     * ``` typescript
-     * federation.setOutboxDispatcher(
-     *   "/users/{handle}/outbox",
-     *   async (ctx, handle, options) => {
-     *     let items: Activity[];
-     *     let nextCursor: string;
-     *     // ...
-     *     return { items, nextCursor };
-     *   }
-     * );
-     * ```
-     *
-     * @param path The URI path pattern for the outbox dispatcher.  The syntax is
-     *             based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one variable: `{handle}`.
-     * @param dispatcher An outbox dispatcher callback to register.
-     * @throws {@link RouterError} Thrown if the path pattern is invalid.
-     */
     setOutboxDispatcher(path: `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Activity, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-    /**
-     * Registers a following collection dispatcher.
-     * @param path The URI path pattern for the following collection.  The syntax
-     *             is based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one variable: `{handle}`.
-     * @param dispatcher A following collection callback to register.
-     * @returns An object with methods to set other following collection
-     *          callbacks.
-     * @throws {RouterError} Thrown if the path pattern is invalid.
-     */
     setFollowingDispatcher(path: `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Actor | URL, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-    /**
-     * Registers a followers collection dispatcher.
-     * @param path The URI path pattern for the followers collection.  The syntax
-     *             is based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one variable: `{handle}`.
-     * @param dispatcher A followers collection callback to register.
-     * @returns An object with methods to set other followers collection
-     *          callbacks.
-     * @throws {@link RouterError} Thrown if the path pattern is invalid.
-     */
     setFollowersDispatcher(path: `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Recipient, Context<TContextData>, TContextData, URL>): CollectionCallbackSetters<Context<TContextData>, TContextData, URL>;
-    /**
-     * Registers a liked collection dispatcher.
-     * @param path The URI path pattern for the liked collection.  The syntax
-     *             is based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one variable: `{handle}`.
-     * @param dispatcher A liked collection callback to register.
-     * @returns An object with methods to set other liked collection
-     *          callbacks.
-     * @throws {@link RouterError} Thrown if the path pattern is invalid.
-     */
-    setLikedDispatcher(path: `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Object | URL, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-    /**
-     * Registers a featured collection dispatcher.
-     * @param path The URI path pattern for the featured collection.  The syntax
-     *             is based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one variable: `{handle}`.
-     * @param dispatcher A featured collection callback to register.
-     * @returns An object with methods to set other featured collection
-     *          callbacks.
-     * @throws {@link RouterError} Thrown if the path pattern is invalid.
-     */
+    setLikedDispatcher(path: `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Like, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
     setFeaturedDispatcher(path: `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Object, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-    /**
-     * Registers a featured tags collection dispatcher.
-     * @param path The URI path pattern for the featured tags collection.
-     *             The syntax is based on URI Template
-     *             ([RFC 6570](https://tools.ietf.org/html/rfc6570)).  The path
-     *             must have one variable: `{handle}`.
-     * @param dispatcher A featured tags collection callback to register.
-     * @returns An object with methods to set other featured tags collection
-     *          callbacks.
-     * @throws {@link RouterError} Thrown if the path pattern is invalid.
-     */
     setFeaturedTagsDispatcher(path: `${string}{handle}${string}`, dispatcher: CollectionDispatcher<Hashtag, RequestContext<TContextData>, TContextData, void>): CollectionCallbackSetters<RequestContext<TContextData>, TContextData, void>;
-    /**
-     * Assigns the URL path for the inbox and starts setting inbox listeners.
-     *
-     * @example
-     * ``` typescript
-     * federation
-     *   .setInboxListeners("/users/{handle/inbox", "/inbox")
-     *   .on(Follow, async (ctx, follow) => {
-     *     const from = await follow.getActor(ctx);
-     *     if (!isActor(from)) return;
-     *     // ...
-     *     await ctx.sendActivity({ })
-     *   })
-     *   .on(Undo, async (ctx, undo) => {
-     *     // ...
-     *   });
-     * ```
-     *
-     * @param inboxPath The URI path pattern for the inbox.  The syntax is based
-     *                  on URI Template
-     *                  ([RFC 6570](https://tools.ietf.org/html/rfc6570)).
-     *                  The path must have one variable: `{handle}`, and must
-     *                  match the inbox dispatcher path.
-     * @param sharedInboxPath An optional URI path pattern for the shared inbox.
-     *                        The syntax is based on URI Template
-     *                        ([RFC 6570](https://tools.ietf.org/html/rfc6570)).
-     *                        The path must have no variables.
-     * @returns An object to register inbox listeners.
-     * @throws {RouteError} Thrown if the path pattern is invalid.
-     */
     setInboxListeners(inboxPath: `${string}{handle}${string}`, sharedInboxPath?: string): InboxListenerSetters<TContextData>;
-    /**
-     * Handles a request related to federation.  If a request is not related to
-     * federation, the `onNotFound` or `onNotAcceptable` callback is called.
-     *
-     * Usually, this method is called from a server's request handler or
-     * a web framework's middleware.
-     *
-     * @param request The request object.
-     * @param parameters The parameters for handling the request.
-     * @returns The response to the request.
-     */
+    sendActivity(keys: SenderKeyPair[], recipients: Recipient | Recipient[], activity: Activity, options: SendActivityInternalOptions<TContextData>): Promise<void>;
     fetch(request: Request, options: FederationFetchOptions<TContextData>): Promise<Response>;
 }
-/**
- * Create a new {@link Federation} instance.
- * @param parameters Parameters for initializing the instance.
- * @returns A new {@link Federation} instance.
- * @since 0.10.0
- */
-export declare function createFederation<TContextData>(options: CreateFederationOptions): Federation<TContextData>;
-/**
- * Parameters of {@link Federation.fetch} method.
- *
- * @typeParam TContextData The context data to pass to the {@link Context}.
- * @since 0.6.0
- */
-export interface FederationFetchOptions<TContextData> {
-    /**
-     * The context data to pass to the {@link Context}.
-     */
-    contextData: TContextData;
-    /**
-     * A callback to handle a request when the route is not found.
-     * If not provided, a 404 response is returned.
-     * @param request The request object.
-     * @returns The response to the request.
-     */
-    onNotFound?: (request: Request) => Response | Promise<Response>;
-    /**
-     * A callback to handle a request when the request's `Accept` header is not
-     * acceptable.  If not provided, a 406 response is returned.
-     * @param request The request object.
-     * @returns The response to the request.
-     */
-    onNotAcceptable?: (request: Request) => Response | Promise<Response>;
-    /**
-     * A callback to handle a request when the request is unauthorized.
-     * If not provided, a 401 response is returned.
-     * @param request The request object.
-     * @returns The response to the request.
-     * @since 0.7.0
-     */
-    onUnauthorized?: (request: Request) => Response | Promise<Response>;
+interface ContextOptions<TContextData> {
+    url: URL;
+    federation: FederationImpl<TContextData>;
+    data: TContextData;
+    documentLoader: DocumentLoader;
+    invokedFromActorKeyPairsDispatcher?: {
+        handle: string;
+    };
 }
-/**
- * Additional settings for the actor dispatcher.
- *
- * ``` typescript
- * const federation = createFederation<void>({ ... });
- * federation.setActorDispatcher("/users/{handle}", async (ctx, handle, key) => {
- *   ...
- * })
- *   .setKeyPairsDispatcher(async (ctxData, handle) => {
- *     ...
- *   });
- * ```
- */
-export interface ActorCallbackSetters<TContextData> {
-    /**
-     * Sets the key pairs dispatcher for actors.
-     * @param dispatcher A callback that returns the key pairs for an actor.
-     * @returns The setters object so that settings can be chained.
-     * @since 0.10.0
-     */
-    setKeyPairsDispatcher(dispatcher: ActorKeyPairsDispatcher<TContextData>): ActorCallbackSetters<TContextData>;
-    /**
-     * Sets the callback function that maps a WebFinger username to
-     * the corresponding actor's internal handle.  If it's omitted, the handle
-     * is assumed to be the same as the WebFinger username, which makes your
-     * actors have the immutable handles.  If you want to let your actors change
-     * their fediverse handles, you should set this dispatcher.
-     * @since 0.15.0
-     */
-    mapHandle(mapper: ActorHandleMapper<TContextData>): ActorCallbackSetters<TContextData>;
-    /**
-     * Specifies the conditions under which requests are authorized.
-     * @param predicate A callback that returns whether a request is authorized.
-     * @returns The setters object so that settings can be chained.
-     * @since 0.7.0
-     */
-    authorize(predicate: AuthorizePredicate<TContextData>): ActorCallbackSetters<TContextData>;
+declare class ContextImpl<TContextData> implements Context<TContextData> {
+    readonly url: URL;
+    readonly federation: FederationImpl<TContextData>;
+    readonly data: TContextData;
+    readonly documentLoader: DocumentLoader;
+    readonly invokedFromActorKeyPairsDispatcher?: {
+        handle: string;
+    };
+    constructor({ url, federation, data, documentLoader, invokedFromActorKeyPairsDispatcher, }: ContextOptions<TContextData>);
+    toInboxContext(activity: unknown): InboxContextImpl<TContextData>;
+    get hostname(): string;
+    get host(): string;
+    get origin(): string;
+    get contextLoader(): DocumentLoader;
+    getNodeInfoUri(): URL;
+    getActorUri(handle: string): URL;
+    getObjectUri<TObject extends Object>(cls: (new (...args: any[]) => TObject) & {
+        typeId: URL;
+    }, values: Record<string, string>): URL;
+    getOutboxUri(handle: string): URL;
+    getInboxUri(): URL;
+    getInboxUri(handle: string): URL;
+    getFollowingUri(handle: string): URL;
+    getFollowersUri(handle: string): URL;
+    getLikedUri(handle: string): URL;
+    getFeaturedUri(handle: string): URL;
+    getFeaturedTagsUri(handle: string): URL;
+    parseUri(uri: URL | null): ParseUriResult | null;
+    getActorKeyPairs(handle: string): Promise<ActorKeyPair[]>;
+    protected getKeyPairsFromHandle(handle: string): Promise<(dntShim.CryptoKeyPair & {
+        keyId: URL;
+    })[]>;
+    protected getRsaKeyPairFromHandle(handle: string): Promise<dntShim.CryptoKeyPair & {
+        keyId: URL;
+    } | null>;
+    getDocumentLoader(identity: {
+        handle: string;
+    }): Promise<DocumentLoader>;
+    getDocumentLoader(identity: SenderKeyPair): DocumentLoader;
+    lookupObject(identifier: string | URL, options?: LookupObjectOptions): Promise<Object | null>;
+    sendActivity(sender: SenderKeyPair | SenderKeyPair[] | {
+        handle: string;
+    }, recipients: Recipient | Recipient[] | "followers", activity: Activity, options?: SendActivityOptions): Promise<void>;
+    getFollowers(handle: string): AsyncIterable<Recipient>;
 }
-/**
- * Additional settings for an object dispatcher.
- */
-export interface ObjectCallbackSetters<TContextData, TObject extends Object, TParam extends string> {
-    /**
-     * Specifies the conditions under which requests are authorized.
-     * @param predicate A callback that returns whether a request is authorized.
-     * @returns The setters object so that settings can be chained.
-     * @since 0.7.0
-     */
-    authorize(predicate: ObjectAuthorizePredicate<TContextData, TParam>): ObjectCallbackSetters<TContextData, TObject, TParam>;
+export declare class InboxContextImpl<TContextData> extends ContextImpl<TContextData> implements InboxContext<TContextData> {
+    readonly activity: unknown;
+    constructor(activity: unknown, options: ContextOptions<TContextData>);
+    forwardActivity(forwarder: SenderKeyPair | SenderKeyPair[] | {
+        handle: string;
+    }, recipients: Recipient | Recipient[], options?: ForwardActivityOptions): Promise<void>;
+    forwardActivity(forwarder: {
+        handle: string;
+    }, recipients: "followers", options?: ForwardActivityOptions): Promise<void>;
 }
-/**
- * Additional settings for a collection dispatcher.
- *
- * @typeParam TContext The type of the context.  {@link Context} or
- *                     {@link RequestContext}.
- * @typeParam TContextData The context data to pass to the {@link Context}.
- * @typeParam TFilter The type of filter for the collection.
- */
-export interface CollectionCallbackSetters<TContext extends Context<TContextData>, TContextData, TFilter> {
-    /**
-     * Sets the counter for the collection.
-     * @param counter A callback that returns the number of items in the collection.
-     * @returns The setters object so that settings can be chained.
-     */
-    setCounter(counter: CollectionCounter<TContextData, TFilter>): CollectionCallbackSetters<TContext, TContextData, TFilter>;
-    /**
-     * Sets the first cursor for the collection.
-     * @param cursor The cursor for the first item in the collection.
-     * @returns The setters object so that settings can be chained.
-     */
-    setFirstCursor(cursor: CollectionCursor<TContext, TContextData, TFilter>): CollectionCallbackSetters<TContext, TContextData, TFilter>;
-    /**
-     * Sets the last cursor for the collection.
-     * @param cursor The cursor for the last item in the collection.
-     * @returns The setters object so that settings can be chained.
-     */
-    setLastCursor(cursor: CollectionCursor<TContext, TContextData, TFilter>): CollectionCallbackSetters<TContext, TContextData, TFilter>;
-    /**
-     * Specifies the conditions under which requests are authorized.
-     * @param predicate A callback that returns whether a request is authorized.
-     * @returns The setters object so that settings can be chained.
-     * @since 0.7.0
-     */
-    authorize(predicate: AuthorizePredicate<TContextData>): CollectionCallbackSetters<TContext, TContextData, TFilter>;
+interface ActorCallbacks<TContextData> {
+    dispatcher?: ActorDispatcher<TContextData>;
+    keyPairsDispatcher?: ActorKeyPairsDispatcher<TContextData>;
+    handleMapper?: ActorHandleMapper<TContextData>;
+    authorizePredicate?: AuthorizePredicate<TContextData>;
 }
-/**
- * Registry for inbox listeners for different activity types.
- */
-export interface InboxListenerSetters<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.
-     */
-    on<TActivity extends Activity>(type: new (...args: any[]) => TActivity, listener: InboxListener<TContextData, TActivity>): InboxListenerSetters<TContextData>;
-    /**
-     * Registers an error handler for inbox 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.
-     */
-    onError(handler: InboxErrorHandler<TContextData>): InboxListenerSetters<TContextData>;
-    /**
-     * Configures a callback to dispatch the key pair for the authenticated
-     * document loader of the {@link Context} passed to the shared inbox listener.
-     *
-     * @param dispatcher A callback to dispatch the key pair for the authenticated
-     *                   document loader.
-     * @returns The setters object so that settings can be chained.
-     * @since 0.11.0
-     */
-    setSharedKeyDispatcher(dispatcher: SharedInboxKeyDispatcher<TContextData>): InboxListenerSetters<TContextData>;
+interface ObjectCallbacks<TContextData, TParam extends string> {
+    dispatcher: ObjectDispatcher<TContextData, Object, string>;
+    parameters: Set<TParam>;
+    authorizePredicate?: ObjectAuthorizePredicate<TContextData, TParam>;
+}
+interface SendActivityInternalOptions<TContextData> extends SendActivityOptions {
+    collectionSync?: string;
+    contextData: TContextData;
 }
+export {};
 //# sourceMappingURL=middleware.d.ts.map