@fedify/fedify 2.0.0-pr.412.1559 → 2.0.0-pr.412.1692

package/dist/{context-9gCpIkiz.d.ts → context-ByZprN0S.d.ts}

@@ -2,12 +2,12 @@ import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
 import { KvKey, KvStore } from "./kv-C7sopW2E.js";
 import { AuthenticatedDocumentLoaderFactory, DocumentLoader, DocumentLoaderFactory, GetUserAgentOptions } from "./docloader-CxWcuWqQ.js";
-import { GetNodeInfoOptions, JsonValue, NodeInfo } from "./client-DF8anIB5.js";
-import { Activity, Collection, CryptographicKey, Hashtag, Link, Multikey, Object as Object$1 } from "./vocab-SOE1ifCr.js";
-import { Actor, Recipient } from "./actor-C22bXuuC.js";
-import { HttpMessageSignaturesSpec } from "./http-DqSNLFNY.js";
-import { GetKeyOwnerOptions } from "./owner-CQPnQVtf.js";
-import { LookupObjectOptions, TraverseCollectionOptions } from "./mod-Cxt4Kpf6.js";
+import { GetNodeInfoOptions, JsonValue, NodeInfo } from "./client-bgSdkFa2.js";
+import { Activity, Collection, CryptographicKey, Hashtag, Link, Multikey, Object as Object$1 } from "./vocab-BI0Ak5lL.js";
+import { Actor, Recipient } from "./actor-T6RyhRgk.js";
+import { HttpMessageSignaturesSpec } from "./http-D6Uj2x2y.js";
+import { GetKeyOwnerOptions } from "./owner-hd9lvQcP.js";
+import { LookupObjectOptions, TraverseCollectionOptions } from "./mod-DlU8ISoa.js";
 import { Link as Link$1, LookupWebFingerOptions, ResourceDescriptor } from "./mod-DBzN0aCM.js";
 import { MessageQueue } from "./mq-CRGm1e_F.js";
 import { Span, TracerProvider } from "@opentelemetry/api";
@@ -1306,6 +1306,36 @@ interface CollectionCallbackSetters<TContext extends Context<TContextData>, TCon
    */
   authorize(predicate: AuthorizePredicate<TContextData>): CollectionCallbackSetters<TContext, TContextData, TFilter>;
 }
+/**
+ * The strategy for handling activity idempotency in inbox processing.
+ *
+ *  -  `"global"`: Activities are deduplicated globally across all inboxes and
+ *     origins.  The same activity ID will be processed only once, regardless
+ *     of which inbox receives it or which server sent it.
+ *
+ *  -  `"per-origin"`: Activities are deduplicated per receiving server's origin.
+ *     The same activity ID will be processed only once on each receiving server,
+ *     but can be processed separately on different receiving servers. This had
+ *     been the default behavior in Fedify 1.x versions.
+ *
+ *  -  `"per-inbox"`: Activities are deduplicated per inbox. The same activity
+ *     ID can be processed once per inbox, allowing the same activity to be
+ *     delivered to multiple inboxes independently.  This follows standard
+ *     ActivityPub behavior and is the default strategy since Fedify 2.0.0.
+ *
+ * @since 1.9.0
+ */
+type IdempotencyStrategy = "global" | "per-origin" | "per-inbox";
+/**
+ * A callback to generate a custom idempotency key for an activity.
+ * Returns the cache key to use, or null to skip idempotency checking.
+ * @template TContextData The context data to pass to the {@link InboxContext}.
+ * @param ctx The inbox context.
+ * @param activity The activity being processed.
+ * @returns The idempotency key to use for caching, or null to skip caching.
+ * @since 1.9.0
+ */
+type IdempotencyKeyCallback<TContextData> = (ctx: InboxContext<TContextData>, activity: Activity) => string | null | Promise<string | null>;
 /**
  * Registry for inbox listeners for different activity types.
  */
@@ -1336,6 +1366,36 @@ interface InboxListenerSetters<TContextData> {
    * @since 0.11.0
    */
   setSharedKeyDispatcher(dispatcher: SharedInboxKeyDispatcher<TContextData>): InboxListenerSetters<TContextData>;
+  /**
+   * Configures the strategy for handling activity idempotency in inbox processing.
+   *
+   * @example
+   * Use per-inbox strategy (standard ActivityPub behavior):
+   * ```
+   * federation
+   *   .setInboxListeners("/users/{identifier}/inbox", "/inbox")
+   *   .withIdempotency("per-inbox");
+   * ```
+   *
+   * Use custom strategy:
+   * ```
+   * federation
+   *   .setInboxListeners("/users/{identifier}/inbox", "/inbox")
+   *   .withIdempotency((ctx, activity) => {
+   *     // Return null to skip idempotency
+   *     return `${ctx.origin}:${activity.id?.href}:${ctx.recipient}`;
+   *   });
+   * ```
+   *
+   * @param strategy The idempotency strategy to use. Can be:
+   *   - `"global"`: Activities are deduplicated across all inboxes and origins
+   *   - `"per-origin"`: Activities are deduplicated per inbox origin
+   *   - `"per-inbox"`: Activities are deduplicated per inbox
+   *   - A custom callback function that returns the cache key to use
+   * @returns The setters object so that settings can be chained.
+   * @since 1.9.0
+   */
+  withIdempotency(strategy: IdempotencyStrategy | IdempotencyKeyCallback<TContextData>): InboxListenerSetters<TContextData>;
 }
 /**
  * Parameters of {@link Federation.fetch} method.
@@ -2254,4 +2314,4 @@ interface ActorKeyPair extends CryptoKeyPair {
   multikey: Multikey;
 }
 //#endregion
-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, WebFingerLinksDispatcher, 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, IdempotencyKeyCallback, IdempotencyStrategy, 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, WebFingerLinksDispatcher, buildCollectionSynchronizationHeader, createExponentialBackoffPolicy, createFederation, createFederationBuilder, digest, respondWithObject, respondWithObjectIfAcceptable };