@fedify/fedify 1.8.1-pr.334.1193 → 1.8.1-pr.340.1214

package/dist/{context-B6mUZhs_.d.ts → context-BNA3vzcr.d.ts}

@@ -1,14 +1,14 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { KvKey, KvStore } from "./kv-DDdb1hMa.js";
-import { AuthenticatedDocumentLoaderFactory, DocumentLoader, DocumentLoaderFactory, GetUserAgentOptions } from "./docloader-BeCtcTOJ.js";
-import { GetNodeInfoOptions, JsonValue, NodeInfo } from "./client-BQ4AQGKo.js";
-import { Activity, Collection, CryptographicKey, Hashtag, Link, Multikey, Object as Object$1 } from "./vocab-By6mpzr-.js";
-import { Actor, Recipient } from "./actor-B4TBtqRP.js";
-import { HttpMessageSignaturesSpec } from "./http-D1uoUH4N.js";
-import { GetKeyOwnerOptions } from "./owner-CEv_PfyK.js";
-import { LookupObjectOptions, TraverseCollectionOptions } from "./mod-BFwgZ7_K.js";
-import { LookupWebFingerOptions, ResourceDescriptor } from "./lookup-J_m4YZg0.js";
+import { KvKey, KvStore } from "./kv-BqOK6zss.js";
+import { AuthenticatedDocumentLoaderFactory, DocumentLoader, DocumentLoaderFactory, GetUserAgentOptions } from "./docloader-CLolPVL_.js";
+import { GetNodeInfoOptions, JsonValue, NodeInfo } from "./client-B0IOer6B.js";
+import { Activity, Collection, CryptographicKey, Hashtag, Link, Multikey, Object as Object$1 } from "./vocab-Cyrb7_co.js";
+import { Actor, Recipient } from "./actor-CWNAGvnO.js";
+import { HttpMessageSignaturesSpec } from "./http-COez3YdK.js";
+import { GetKeyOwnerOptions } from "./owner-BlxMNrL4.js";
+import { LookupObjectOptions, TraverseCollectionOptions } from "./mod-C2jQirfr.js";
+import { LookupWebFingerOptions, ResourceDescriptor } from "./lookup-tSXYzgYs.js";
 import { MessageQueue } from "./mq-DYKDDJmp.js";
 import { Span, TracerProvider } from "@opentelemetry/api";
 
@@ -70,13 +70,13 @@ interface SenderKeyPair {
 /**
  * A callback that dispatches a {@link NodeInfo} object.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  */
 type NodeInfoDispatcher<TContextData> = (context: RequestContext<TContextData>) => NodeInfo | Promise<NodeInfo>;
 /**
  * A callback that dispatches an {@link Actor} object.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @param context The request context.
  * @param identifier The actor's internal identifier or username.
  */
@@ -84,7 +84,7 @@ type ActorDispatcher<TContextData> = (context: RequestContext<TContextData>, ide
 /**
  * A callback that dispatches key pairs for an actor.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @param context The context.
  * @param identifier The actor's internal identifier or username.
  * @returns The key pairs.
@@ -94,7 +94,7 @@ type ActorKeyPairsDispatcher<TContextData> = (context: Context<TContextData>, id
 /**
  * A callback that maps a WebFinger username to the corresponding actor's
  * internal identifier, or `null` if the username is not found.
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @param context The context.
  * @param username The WebFinger username.
  * @returns The actor's internal identifier, or `null` if the username is not
@@ -105,7 +105,7 @@ type ActorHandleMapper<TContextData> = (context: Context<TContextData>, username
 /**
  * A callback that maps a WebFinger query to the corresponding actor's
  * internal identifier or username, or `null` if the query is not found.
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @param context The request context.
  * @param resource The URL that was queried through WebFinger.
  * @returns The actor's internal identifier or username, or `null` if the query
@@ -124,20 +124,20 @@ type ActorAliasMapper<TContextData> = (context: RequestContext<TContextData>, re
 /**
  * A callback that dispatches an object.
  *
- * @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.
+ * @template TContextData The context data to pass to the {@link Context}.
+ * @template TObject The type of object to dispatch.
+ * @template TParam The parameter names of the requested URL.
  * @since 0.7.0
  */
 type ObjectDispatcher<TContextData, TObject extends Object$1, TParam extends string> = (context: RequestContext<TContextData>, values: Record<TParam, string>) => TObject | null | Promise<TObject | null>;
 /**
  * A callback that dispatches a collection.
  *
- * @typeParam TItem The type of items in the collection.
- * @typeParam TContext The type of the context. {@link Context} or
+ * @template TItem The type of items in the collection.
+ * @template TContext The type of the context. {@link Context} or
  *                     {@link RequestContext}.
- * @typeParam TContextData The context data to pass to the `TContext`.
- * @typeParam TFilter The type of the filter, if any.
+ * @template TContextData The context data to pass to the `TContext`.
+ * @template TFilter The type of the filter, if any.
  * @param context The context.
  * @param identifier The internal identifier or the username of the collection
  *                   owner.
@@ -149,7 +149,7 @@ type CollectionDispatcher<TItem, TContext extends Context<TContextData>, TContex
 /**
  * A callback that counts the number of items in a collection.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @param context The context.
  * @param identifier The internal identifier or the username of the collection
  *                   owner.
@@ -159,10 +159,10 @@ type CollectionCounter<TContextData, TFilter> = (context: RequestContext<TContex
 /**
  * A callback that returns a cursor for a collection.
  *
- * @typeParam TContext The type of the context. {@link Context} or
+ * @template 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 the filter, if any.
+ * @template TContextData The context data to pass to the {@link Context}.
+ * @template TFilter The type of the filter, if any.
  * @param context The context.
  * @param identifier The internal identifier or the username of the collection
  *                   owner.
@@ -172,8 +172,8 @@ type CollectionCursor<TContext extends Context<TContextData>, TContextData, TFil
 /**
  * A callback that listens for activities in an inbox.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
- * @typeParam TActivity The type of activity to listen for.
+ * @template TContextData The context data to pass to the {@link Context}.
+ * @template TActivity The type of activity to listen for.
  * @param context The inbox context.
  * @param activity The activity that was received.
  */
@@ -181,7 +181,7 @@ type InboxListener<TContextData, TActivity extends Activity> = (context: InboxCo
 /**
  * A callback that handles errors in an inbox.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @param context The inbox context.
  */
 type InboxErrorHandler<TContextData> = (context: Context<TContextData>, error: Error) => void | Promise<void>;
@@ -189,7 +189,7 @@ type InboxErrorHandler<TContextData> = (context: Context<TContextData>, error: E
  * A callback that dispatches the key pair for the authenticated document loader
  * of the {@link Context} passed to the shared inbox listener.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @param context The context.
  * @returns The username or the internal identifier of the actor or the key pair
  *          for the authenticated document loader of the {@link Context} passed
@@ -222,7 +222,7 @@ type OutboxErrorHandler = (error: Error, activity: Activity | null) => void | Pr
 /**
  * A callback that determines if a request is authorized or not.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @param context The request context.
  * @param identifier The internal identifier of the actor that is being requested.
  * @param signedKey *Deprecated in Fedify 1.5.0 in favor of
@@ -242,8 +242,8 @@ type AuthorizePredicate<TContextData> = (context: RequestContext<TContextData>,
 /**
  * A callback that determines if a request is authorized or not.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
- * @typeParam TParam The parameter names of the requested URL.
+ * @template TContextData The context data to pass to the {@link Context}.
+ * @template TParam The parameter names of the requested URL.
  * @param context The request context.
  * @param values The parameters of the requested URL.
  * @param signedKey *Deprecated in Fedify 1.5.0 in favor of
@@ -260,8 +260,48 @@ type AuthorizePredicate<TContextData> = (context: RequestContext<TContextData>,
  * @since 0.7.0
  */
 type ObjectAuthorizePredicate<TContextData, TParam extends string> = (context: RequestContext<TContextData>, values: Record<TParam, string>, signedKey: CryptographicKey | null, signedKeyOwner: Actor | null) => boolean | Promise<boolean>;
+/**
+ * A callback that dispatches a custom collection.
+ *
+ * @template TItem The type of items in the collection.
+ * @template TParams The parameter names of the requested URL.
+ * @template TContext The type of the context. {@link Context} or
+ *                     {@link RequestContext}.
+ * @template TContextData The context data to pass to the `TContext`.
+ * @template TFilter The type of the filter, if any.
+ * @param context The context.
+ * @param values The parameters of the requested URL.
+ * @param cursor The cursor to start the collection from, or `null` to dispatch
+ *               the entire collection without pagination.
+ * @since 1.8.0
+ */
+type CustomCollectionDispatcher<TItem, TParams extends Record<string, string>, TContext extends Context<TContextData>, TContextData> = (context: TContext, values: TParams, cursor: string | null) => PageItems<TItem> | null | Promise<PageItems<TItem> | null>;
+/**
+ * A callback that counts the number of items in a custom collection.
+ *
+ * @template TParams The parameter names of the requested URL.
+ * @template TContextData The context data to pass to the {@link Context}.
+ * @param context The context.
+ * @param values The parameters of the requested URL.
+ * @since 1.8.0
+ */
+type CustomCollectionCounter<TParams extends Record<string, string>, TContextData> = (context: RequestContext<TContextData>, values: TParams) => number | bigint | null | Promise<number | bigint | null>;
+/**
+ * A callback that returns a cursor for a custom collection.
+ *
+ * @template TParams The parameter names of the requested URL.
+ * @template TContext The type of the context. {@link Context} or
+ *                     {@link RequestContext}.
+ * @template TContextData The context data to pass to the {@link Context}.
+ * @template TFilter The type of the filter, if any.
+ * @param context The context.
+ * @param values The parameters of the requested URL.
+ * @since 1.8.0
+ */
+type CustomCollectionCursor<TParams extends Record<string, string>, TContext extends Context<TContextData>, TContextData> = (context: TContext, values: TParams) => string | null | Promise<string | null>;
 //#endregion
 //#region federation/handler.d.ts
+
 /**
  * Options for the {@link respondWithObject} and
  * {@link respondWithObjectIfAcceptable} functions.
@@ -509,7 +549,7 @@ declare function createExponentialBackoffPolicy(options?: CreateExponentialBacko
 //#region federation/middleware.d.ts
 /**
  * Options for {@link createFederation} function.
- * @typeParam TContextData The type of the context data.
+ * @template TContextData The type of the context data.
  * @since 0.10.0
  * @deprecated Use {@link FederationOptions} instead.
  */
@@ -613,7 +653,7 @@ interface FederationStartQueueOptions {
 }
 /**
  * A common interface between {@link Federation} and {@link FederationBuilder}.
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @since 1.6.0
  */
 interface Federatable<TContextData> {
@@ -655,9 +695,9 @@ interface Federatable<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.
+   * @template TContextData The context data to pass to the {@link Context}.
+   * @template TObject The type of object to dispatch.
+   * @template 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
@@ -671,9 +711,9 @@ interface Federatable<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.
+   * @template TContextData The context data to pass to the {@link Context}.
+   * @template TObject The type of object to dispatch.
+   * @template 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
@@ -687,9 +727,9 @@ interface Federatable<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.
+   * @template TContextData The context data to pass to the {@link Context}.
+   * @template TObject The type of object to dispatch.
+   * @template 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
@@ -703,9 +743,9 @@ interface Federatable<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.
+   * @template TContextData The context data to pass to the {@link Context}.
+   * @template TObject The type of object to dispatch.
+   * @template 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
@@ -719,9 +759,9 @@ interface Federatable<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.
+   * @template TContextData The context data to pass to the {@link Context}.
+   * @template TObject The type of object to dispatch.
+   * @template 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
@@ -735,9 +775,9 @@ interface Federatable<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.
+   * @template TContextData The context data to pass to the {@link Context}.
+   * @template TObject The type of object to dispatch.
+   * @template 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
@@ -874,6 +914,36 @@ interface Federatable<TContextData> {
    * @throws {RouteError} Thrown if the path pattern is invalid.
    */
   setInboxListeners(inboxPath: `${string}{identifier}${string}` | `${string}{handle}${string}`, sharedInboxPath?: string): InboxListenerSetters<TContextData>;
+  /**
+   * Registers a collection of objects dispatcher.
+   *
+   * @template TContextData The context data to pass to the {@link Context}.
+   * @template TObject The type of objects to dispatch.
+   * @template TParam The parameter names of the requested URL.
+   * @param name A unique name for the collection dispatcher.
+   * @param itemType The Activity Vocabulary class of the object to dispatch.
+   * @param path The URI path pattern for the collection 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 A collection dispatcher callback to register.
+   */
+  setCollectionDispatcher<TObject extends Object$1, TParams extends Record<string, string>>(name: string | symbol, itemType: ConstructorWithTypeId<TObject>, path: ParamsKeyPath<TParams>, dispatcher: CustomCollectionDispatcher<TObject, TParams, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParams, RequestContext<TContextData>, TContextData>;
+  /**
+   * Registers an ordered collection of objects dispatcher.
+   *
+   * @template TContextData The context data to pass to the {@link Context}.
+   * @template TObject The type of objects to dispatch.
+   * @template TParam The parameter names of the requested URL.
+   * @param name A unique name for the collection dispatcher.
+   * @param itemType The Activity Vocabulary class of the object to dispatch.
+   * @param path The URI path pattern for the collection 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 A collection dispatcher callback to register.
+   */
+  setOrderedCollectionDispatcher<TObject extends Object$1, TParams extends Record<string, string>>(name: string | symbol, itemType: ConstructorWithTypeId<TObject>, path: ParamsKeyPath<TParams>, dispatcher: CustomCollectionDispatcher<TObject, TParams, RequestContext<TContextData>, TContextData>): CustomCollectionCallbackSetters<TParams, RequestContext<TContextData>, TContextData>;
 }
 /**
  * An object that registers federation-related business logic and dispatches
@@ -881,7 +951,7 @@ interface Federatable<TContextData> {
  *
  * It also provides a middleware interface for handling requests before your
  * web framework's router; see {@link Federation.fetch}.
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @since 0.13.0
  */
 interface Federation<TContextData> extends Federatable<TContextData> {
@@ -940,7 +1010,7 @@ interface Federation<TContextData> extends Federatable<TContextData> {
  * instantiation of the {@link Federation} object until the {@link build}
  * method is called so that dispatchers and listeners can be registered
  * before the {@link Federation} object is instantiated.
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @since 1.6.0
  */
 interface FederationBuilder<TContextData> extends Federatable<TContextData> {
@@ -952,7 +1022,7 @@ interface FederationBuilder<TContextData> extends Federatable<TContextData> {
 }
 /**
  * Options for creating a {@link Federation} object.
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @since 1.6.0
  */
 interface FederationOptions<TContextData> {
@@ -1197,10 +1267,10 @@ interface ObjectCallbackSetters<TContextData, TObject extends Object$1, TParam e
 /**
  * Additional settings for a collection dispatcher.
  *
- * @typeParam TContext The type of the context.  {@link Context} or
+ * @template 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.
+ * @template TContextData The context data to pass to the {@link Context}.
+ * @template TFilter The type of filter for the collection.
  */
 interface CollectionCallbackSetters<TContext extends Context<TContextData>, TContextData, TFilter> {
   /**
@@ -1263,7 +1333,7 @@ interface InboxListenerSetters<TContextData> {
 /**
  * Parameters of {@link Federation.fetch} method.
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @since 0.6.0
  */
 interface FederationFetchOptions<TContextData> {
@@ -1294,6 +1364,119 @@ interface FederationFetchOptions<TContextData> {
    */
   onUnauthorized?: (request: Request) => Response | Promise<Response>;
 }
+/**
+ * Additional settings for a custom collection dispatcher.
+ *
+ * @template TParams The type of the parameters in the URL path.
+ * @template TContext The type of the context.  {@link Context} or
+ *                     {@link RequestContext}.
+ * @template TContextData The context data to pass to the {@link Context}.
+ * @template TFilter The type of filter for the collection.
+ */
+interface CustomCollectionCallbackSetters<TParams extends Record<string, string>, TContext extends Context<TContextData>, TContextData> {
+  /**
+   * Sets the counter for the custom collection.
+   * @param counter A callback that returns the number of items in the custom collection.
+   * @returns The setters object so that settings can be chained.
+   */
+  setCounter(counter: CustomCollectionCounter<TParams, TContextData>): CustomCollectionCallbackSetters<TParams, TContext, TContextData>;
+  /**
+   * Sets the first cursor for the custom collection.
+   * @param cursor The cursor for the first item in the custom collection.
+   * @returns The setters object so that settings can be chained.
+   */
+  setFirstCursor(cursor: CustomCollectionCursor<TParams, TContext, TContextData>): CustomCollectionCallbackSetters<TParams, TContext, TContextData>;
+  /**
+   * Sets the last cursor for the custom collection.
+   * @param cursor The cursor for the last item in the custom collection.
+   * @returns The setters object so that settings can be chained.
+   */
+  setLastCursor(cursor: CustomCollectionCursor<TParams, TContext, TContextData>): CustomCollectionCallbackSetters<TParams, TContext, 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: ObjectAuthorizePredicate<TContextData, string>): CustomCollectionCallbackSetters<TParams, TContext, TContextData>;
+}
+/**
+ * Represents an object with a type ID, which is either a constructor or an
+ * instance of the object.
+ *
+ * @template TObject The type of the object.
+ */
+type ConstructorWithTypeId<TObject extends Object$1> = (new (...args: any[]) => TObject) & {
+  typeId: URL;
+};
+/**
+ * Represents a path from the key of parameter objects.
+ * @param Params - A record of parameters where keys are parameter names and
+ *                 values are their string representations.
+ * @returns A string representing the path with all parameters.
+ * @example
+ * ```ts
+ * type UserPostPath = ParamsKeyPath<{ userId: string; postId: string }>;
+ * let userPostPath: UserPostPath;
+ * // userPostPath = "/posts/{postId}"; // invalid - does not contain `{userId}`
+ * // userPostPath = "/users/{userId}"; // invalid - does not contain `{postId}`
+ * userPostPath = "/users/{userId}/posts/{postId}"; // valid
+ * userPostPath = "/posts/{postId}/users/{userId}"; // valid
+ * ```
+ */
+type ParamsKeyPath<Params extends Record<string, string>> = ParamsPath<Extract<keyof Params, string>> & string;
+/**
+ * Represents a path with multiple parameters.
+ * All permutations of the parameters are included in the union type.
+ * The path must have all parameters in the form of `{paramName}`.
+ * @param Params - A union of parameter names.
+ * @returns A string representing the path with all parameters.
+ * @example
+ * ```ts
+ * type UserPostPath = ParamsPath<"userId" | "postId">;
+ * // = `${string}{userId}${string}` & `${string}{postId}${string}`
+ * // =
+ * //  | `${string}{userId}${string}{postId}${string}`
+ * //  | `${string}{postId}${string}{userId}${string}`
+ * let userPostPath: UserPostPath;
+ * userPostPath = "/users/posts"; // ❌ invalid
+ * userPostPath = "/users/{userId}"; // ❌ invalid
+ * userPostPath = "/posts/{postId}"; // ❌ invalid
+ * userPostPath = "/users/{userId}/posts/{postId}"; // ✅ valid
+ * userPostPath = "/posts/{postId}/users/{userId}"; // ✅ valid
+ */
+type ParamsPath<Params extends string> = UnionToIntersection<ParamPath<Params>>;
+/**
+ * Represents a path with a single parameter.
+ * The path must have at least one of the parameters in the form of `{paramName}`.
+ * @param Param - The name of the parameter.
+ * @returns A string representing the path with the parameter.
+ * @example
+ * ```ts
+ * type UserPostPath = ParamPath<"userId" | "postId">;
+ * // = `${string}{userId}${string}` | `${string}{postId}${string}`
+ * let userPostPath: UserPostPath;
+ * userPostPath = "/users/posts"; // ❌ invalid
+ * userPostPath = "/users/{userId}"; // ✅ valid
+ * userPostPath = "/posts/{postId}"; // ✅ valid
+ * userPostPath = "/users/{userId}/posts/{postId}"; // ✅ valid
+ * userPostPath = "/posts/{postId}/users/{userId}"; // ✅ valid
+ */
+type ParamPath<Param extends string> = `${string}{${Param}}${string}`;
+/**
+ * Converts union types to intersection types.
+ *
+ * @template U - The union type to convert.
+ * @returns The intersection type of the union.
+ * @example
+ * ```ts
+ * type A = { a: string };
+ * type B = { b: number };
+ * type AorB = A | B;
+ * type AandB = UnionToIntersection<AorB>;
+ * // AandB = { a: string; b: number }
+ */
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends ((x: infer I) => void) ? I : never;
 //#endregion
 //#region federation/context.d.ts
 /**
@@ -1648,6 +1831,16 @@ interface Context<TContextData> {
    * @since 1.3.0
    */
   routeActivity(recipient: string | null, activity: Activity, options?: RouteActivityOptions): Promise<boolean>;
+  /**
+   * Builds the URI of a collection of objects with the given name and values.
+   * @param name The name of the collection, which can be a string or a symbol.
+   * @param values The values of the URI parameters.
+   * @return The URI of the collection.
+   * @throws {RouteError} If no object dispatcher is available for the name.
+   * @throws {TypeError} If values are invalid.
+   * @since 1.8.0
+   */
+  getCollectionUri<TParam extends Record<string, string>>(name: string | symbol, values: TParam): URL;
 }
 /**
  * A context for a request.
@@ -1898,6 +2091,26 @@ type ParseUriResult =
   readonly type: "featuredTags";
   readonly identifier: string;
   readonly handle: string;
+}
+/**
+ * The case of a custom collection URI.
+ * @since 1.8.0
+ */ | {
+  readonly type: "collection";
+  readonly name: string | symbol;
+  readonly class: ConstructorWithTypeId<Object$1>;
+  readonly typeId: URL;
+  readonly values: Record<string, string>;
+}
+/**
+ * The case of a custom ordered collection URI.
+ * @since 1.8.0
+ */ | {
+  readonly type: "orderedCollection";
+  readonly name: string | symbol;
+  readonly class: ConstructorWithTypeId<Object$1>;
+  readonly typeId: URL;
+  readonly values: Record<string, string>;
 };
 /**
  * Options for {@link Context.sendActivity} method.
@@ -2034,4 +2247,4 @@ interface ActorKeyPair extends CryptoKeyPair {
   multikey: Multikey;
 }
 //#endregion
-export { ActivityTransformer, ActorAliasMapper, ActorCallbackSetters, ActorDispatcher, ActorHandleMapper, ActorKeyPair, ActorKeyPairsDispatcher, AuthorizePredicate, CollectionCallbackSetters, CollectionCounter, CollectionCursor, CollectionDispatcher, Context, CreateExponentialBackoffPolicyOptions, CreateFederationOptions, Federatable, Federation, FederationBuilder, FederationFetchOptions, FederationKvPrefixes, FederationOptions, FederationOrigin, FederationQueueOptions, FederationStartQueueOptions, ForwardActivityOptions, GetSignedKeyOptions, InboxContext, InboxErrorHandler, InboxListener, InboxListenerSetters, Message, NodeInfoDispatcher, ObjectAuthorizePredicate, ObjectCallbackSetters, ObjectDispatcher, OutboxErrorHandler, PageItems, ParseUriResult, RequestContext, RespondWithObjectOptions, RetryContext, RetryPolicy, RouteActivityOptions, Router, RouterError, RouterOptions, RouterRouteResult, SendActivityOptions, SendActivityOptionsForCollection, SenderKeyPair, SharedInboxKeyDispatcher, buildCollectionSynchronizationHeader, createExponentialBackoffPolicy, createFederation, createFederationBuilder, digest, respondWithObject, respondWithObjectIfAcceptable };
+export { ActivityTransformer, ActorAliasMapper, ActorCallbackSetters, ActorDispatcher, ActorHandleMapper, ActorKeyPair, ActorKeyPairsDispatcher, AuthorizePredicate, CollectionCallbackSetters, CollectionCounter, CollectionCursor, CollectionDispatcher, ConstructorWithTypeId, Context, CreateExponentialBackoffPolicyOptions, CreateFederationOptions, CustomCollectionCallbackSetters, CustomCollectionCounter, CustomCollectionCursor, CustomCollectionDispatcher, Federatable, Federation, FederationBuilder, FederationFetchOptions, FederationKvPrefixes, FederationOptions, FederationOrigin, FederationQueueOptions, FederationStartQueueOptions, ForwardActivityOptions, GetSignedKeyOptions, InboxContext, InboxErrorHandler, InboxListener, InboxListenerSetters, Message, NodeInfoDispatcher, ObjectAuthorizePredicate, ObjectCallbackSetters, ObjectDispatcher, OutboxErrorHandler, PageItems, ParamsKeyPath, ParseUriResult, RequestContext, RespondWithObjectOptions, RetryContext, RetryPolicy, RouteActivityOptions, Router, RouterError, RouterOptions, RouterRouteResult, SendActivityOptions, SendActivityOptionsForCollection, SenderKeyPair, SharedInboxKeyDispatcher, buildCollectionSynchronizationHeader, createExponentialBackoffPolicy, createFederation, createFederationBuilder, digest, respondWithObject, respondWithObjectIfAcceptable };

package/dist/{docloader-BeCtcTOJ.d.ts → docloader-CLolPVL_.d.ts}

@@ -1,6 +1,6 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { KvKey, KvStore } from "./kv-DDdb1hMa.js";
+import { KvKey, KvStore } from "./kv-BqOK6zss.js";
 
 //#region runtime/docloader.d.ts
 /**

package/dist/{docloader-BU0Mbf3M.js → docloader-DWk5FlEW.js}

@@ -10,7 +10,7 @@ import { isIP } from "node:net";
 
 //#region deno.json
 var name = "@fedify/fedify";
-var version = "1.8.1-pr.334.1193+17e63d2f";
+var version = "1.8.1-pr.340.1214+314e295d";
 var license = "MIT";
 var exports = {
 	".": "./mod.ts",

package/dist/{esm-LMB9p-G5.js → esm-CXrO8Uio.js}

@@ -3,7 +3,7 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { __commonJS, __toESM } from "./type-DGlR8Urb.js";
+import { __commonJS, __toESM } from "./type-DDS4cl1h.js";
 
 //#region ../node_modules/.pnpm/glob-to-regexp@0.4.1/node_modules/glob-to-regexp/index.js
 var require_glob_to_regexp = __commonJS({ "../node_modules/.pnpm/glob-to-regexp@0.4.1/node_modules/glob-to-regexp/index.js"(exports, module) {

package/dist/federation/builder.test.js

@@ -3,21 +3,21 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { Activity, Note, Person } from "../type-DGlR8Urb.js";
+import { Activity, Note, Person } from "../type-DDS4cl1h.js";
 import { assertEquals } from "../assert_equals-C5gKCm6A.js";
 import "../assert-DwEa6glZ.js";
 import "../assert_instance_of-C9QtN-X9.js";
 import { MemoryKvStore } from "../kv-D7Yt6pnB.js";
 import { parseSemVer } from "../semver-DCqorrj5.js";
-import "../lookup-B0_qPExk.js";
-import "../inbox-CKssCQNk.js";
-import { createFederationBuilder } from "../builder-BMWyrhEH.js";
-import { test } from "../testing-CROcCUCq.js";
+import "../lookup-Cph3FzCE.js";
+import "../inbox-BU_xB7k0.js";
+import { createFederationBuilder } from "../builder-BMJsk4Fm.js";
+import { test } from "../testing-B1f6X3bJ.js";
 import { assertExists } from "../std__assert-BQdmxyzF.js";
 import "../assert_rejects-AjlKk-Vo.js";
 import "../assert_is_error-CeVBLPsZ.js";
 import "../assert_not_equals-D2R2nl5h.js";
-import "../assert_throws-CqMKbTh_.js";
+import { assertThrows } from "../assert_throws-CqMKbTh_.js";
 
 //#region federation/builder.test.ts
 test("FederationBuilder", async (t) => {
@@ -150,6 +150,25 @@ test("FederationBuilder", async (t) => {
 		assertEquals(personRoute?.name, `object:${Person.typeId.href}`);
 		assertEquals(personRoute?.values.id, "abc");
 	});
+	await t.step("should handle symbol names uniquely in custom collection dispatchers", () => {
+		const builder = createFederationBuilder();
+		const unnamedSymbol1 = Symbol();
+		const unnamedSymbol2 = Symbol();
+		const namedSymbol1 = Symbol.for("");
+		const namedSymbol2 = Symbol.for("");
+		const strId = String(unnamedSymbol1);
+		const dispatcher = (_ctx, _params) => ({ items: [] });
+		builder.setCollectionDispatcher(unnamedSymbol1, Note, "/unnamed-symbol1/{id}", dispatcher);
+		assertThrows(() => {
+			builder.setCollectionDispatcher(unnamedSymbol1, Note, "/unnamed-symbol1-duplicate/{id}", dispatcher);
+		}, Error, "Collection dispatcher for Symbol() already set.");
+		builder.setCollectionDispatcher(unnamedSymbol2, Note, "/unnamed-symbol2/{id}", dispatcher);
+		builder.setCollectionDispatcher(namedSymbol1, Note, "/named-symbol/{id}", dispatcher);
+		assertThrows(() => {
+			builder.setCollectionDispatcher(namedSymbol2, Note, "/named-symbol/{id}", dispatcher);
+		});
+		builder.setCollectionDispatcher(strId, Note, "/string-id/{id}", dispatcher);
+	});
 });
 
 //#endregion