@fedify/fedify 2.0.0-pr.435.1673 → 2.0.0-pr.445.1694

package/dist/{actor-C22bXuuC.d.ts → actor-T6RyhRgk.d.ts}

@@ -1,7 +1,7 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
 import { GetUserAgentOptions } from "./docloader-CxWcuWqQ.js";
-import { Application, Group, Organization, Person, Service } from "./vocab-SOE1ifCr.js";
+import { Application, Group, Organization, Person, Service } from "./vocab-BI0Ak5lL.js";
 import { TracerProvider } from "@opentelemetry/api";
 
 //#region src/vocab/actor.d.ts

package/dist/{authdocloader-nRFL9luh.js → authdocloader-Cv_qEn1G.js}

@@ -2,9 +2,9 @@
           import { Temporal } from "@js-temporal/polyfill";
           import { URLPattern } from "urlpattern-polyfill";
         
-import { UrlError, createRequest, getRemoteDocument, logRequest, validatePublicUrl } from "./docloader-_WdHTWQR.js";
-import { validateCryptoKey } from "./key-Cf8KTg-A.js";
-import { doubleKnock } from "./http-BpoEurUR.js";
+import { UrlError, createRequest, getRemoteDocument, logRequest, validatePublicUrl } from "./docloader-Czl3xV10.js";
+import { validateCryptoKey } from "./key-BNJQQm3h.js";
+import { doubleKnock } from "./http-C_Qc2neP.js";
 import { getLogger } from "@logtape/logtape";
 
 //#region src/runtime/authdocloader.ts

package/dist/{authdocloader-Chl2nuOI.js → authdocloader-DYTNpaMA.js}

@@ -3,9 +3,9 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { UrlError, createRequest, getRemoteDocument, logRequest, validatePublicUrl } from "./type-BYN6Ax2M.js";
-import { validateCryptoKey } from "./key-Cps8Sv3N.js";
-import { doubleKnock } from "./http-BEo67UOx.js";
+import { UrlError, createRequest, getRemoteDocument, logRequest, validatePublicUrl } from "./type-DaUr3Il7.js";
+import { validateCryptoKey } from "./key-DnqhSgAv.js";
+import { doubleKnock } from "./http-CuS-d4U0.js";
 import { getLogger } from "@logtape/logtape";
 
 //#region src/runtime/authdocloader.ts

package/dist/{authdocloader-D_3mtAjX.cjs → authdocloader-bsmVF6eO.cjs}

@@ -3,9 +3,9 @@
           const { URLPattern } = require("urlpattern-polyfill");
         
 const require_chunk = require('./chunk-DqRYRqnO.cjs');
-const require_docloader = require('./docloader-SZjTrl6Z.cjs');
-const require_key = require('./key-JqiQvcq1.cjs');
-const require_http = require('./http-DREvFalF.cjs');
+const require_docloader = require('./docloader-CYnQRIXv.cjs');
+const require_key = require('./key-DuXv64tg.cjs');
+const require_http = require('./http-CAusBl_3.cjs');
 const __logtape_logtape = require_chunk.__toESM(require("@logtape/logtape"));
 
 //#region src/runtime/authdocloader.ts

package/dist/{builder-C8Of4dPy.js → builder-1_skw-d2.js}

@@ -3,9 +3,9 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { deno_default, getTypeId } from "./type-BYN6Ax2M.js";
-import { Router, RouterError } from "./lookup-DuqY2_In.js";
-import { InboxListenerSet } from "./inbox-D-B5xFtJ.js";
+import { deno_default, getTypeId } from "./type-DaUr3Il7.js";
+import { Router, RouterError } from "./lookup-CbtuFbtg.js";
+import { InboxListenerSet } from "./inbox-IETv_Qez.js";
 import { getLogger } from "@logtape/logtape";
 import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 
@@ -28,6 +28,7 @@ var FederationBuilderImpl = class {
 	inboxListeners;
 	inboxErrorHandler;
 	sharedInboxKeyDispatcher;
+	idempotencyStrategy;
 	collectionTypeIds;
 	collectionCallbacks;
 	/**
@@ -42,7 +43,7 @@ var FederationBuilderImpl = class {
 		this.collectionTypeIds = {};
 	}
 	async build(options) {
-		const { FederationImpl } = await import("./middleware-BD1IE5O5.js");
+		const { FederationImpl } = await import("./middleware-BpR6186a.js");
 		const f = new FederationImpl(options);
 		const trailingSlashInsensitiveValue = f.router.trailingSlashInsensitive;
 		f.router = this.router.clone();
@@ -64,6 +65,7 @@ var FederationBuilderImpl = class {
 		f.inboxListeners = this.inboxListeners?.clone();
 		f.inboxErrorHandler = this.inboxErrorHandler;
 		f.sharedInboxKeyDispatcher = this.sharedInboxKeyDispatcher;
+		f.idempotencyStrategy = this.idempotencyStrategy;
 		return f;
 	}
 	_getTracer() {
@@ -486,6 +488,10 @@ var FederationBuilderImpl = class {
 			setSharedKeyDispatcher: (dispatcher) => {
 				this.sharedInboxKeyDispatcher = dispatcher;
 				return setters;
+			},
+			withIdempotency: (strategy) => {
+				this.idempotencyStrategy = strategy;
+				return setters;
 			}
 		};
 		return setters;

package/dist/{client-yGBH5stP.js → client-D5CBsPrc.js}

@@ -3,7 +3,7 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { getUserAgent } from "./type-BYN6Ax2M.js";
+import { getUserAgent } from "./type-DaUr3Il7.js";
 import { getLogger } from "@logtape/logtape";
 
 //#region src/nodeinfo/client.ts

package/dist/compat/mod.d.cts

@@ -1,13 +1,13 @@
 import "../kv-63Cil1MD.cjs";
 import "../docloader-D-MrRyHl.cjs";
 import "../client-CegPX0Rn.cjs";
-import "../vocab-DJTYMqyU.cjs";
-import "../actor-DMgu-ZjT.cjs";
-import "../http-BS6766zs.cjs";
-import "../owner-B-7Ptt_m.cjs";
-import "../mod-evzlRVZq.cjs";
+import "../vocab-Dw1-yVGg.cjs";
+import "../actor-D6K058Tb.cjs";
+import "../http-D-e6AFwR.cjs";
+import "../owner-BN_tO3cY.cjs";
+import "../mod-CxkWO3Mg.cjs";
 import "../mod-jQ4OODsl.cjs";
-import { ActivityTransformer } from "../context-tVOQ76fi.cjs";
+import { ActivityTransformer } from "../context-DiqjMRef.cjs";
 import "../mq-B7R1Q-M5.cjs";
-import { actorDehydrator, autoIdAssigner, getDefaultActivityTransformers } from "../mod-DBQAI4v9.cjs";
+import { actorDehydrator, autoIdAssigner, getDefaultActivityTransformers } from "../mod-Bpb5QLaZ.cjs";
 export { ActivityTransformer, actorDehydrator, autoIdAssigner, getDefaultActivityTransformers };

package/dist/compat/mod.d.ts

@@ -3,13 +3,13 @@ import { URLPattern } from "urlpattern-polyfill";
 import "../kv-C7sopW2E.js";
 import "../docloader-CxWcuWqQ.js";
 import "../client-bgSdkFa2.js";
-import "../vocab-SOE1ifCr.js";
-import "../actor-C22bXuuC.js";
-import "../http-DqSNLFNY.js";
-import "../owner-CQPnQVtf.js";
-import "../mod-Cxt4Kpf6.js";
+import "../vocab-BI0Ak5lL.js";
+import "../actor-T6RyhRgk.js";
+import "../http-D6Uj2x2y.js";
+import "../owner-hd9lvQcP.js";
+import "../mod-DlU8ISoa.js";
 import "../mod-DBzN0aCM.js";
-import { ActivityTransformer } from "../context-CQsAT7xk.js";
+import { ActivityTransformer } from "../context-DBKpNBnc.js";
 import "../mq-CRGm1e_F.js";
-import { actorDehydrator, autoIdAssigner, getDefaultActivityTransformers } from "../mod-B26zRlH1.js";
+import { actorDehydrator, autoIdAssigner, getDefaultActivityTransformers } from "../mod-D_y2y32N.js";
 export { ActivityTransformer, actorDehydrator, autoIdAssigner, getDefaultActivityTransformers };

package/dist/compat/transformers.test.js

@@ -3,30 +3,30 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { Follow, Person } from "../type-BYN6Ax2M.js";
+import { Follow, Person } from "../type-DaUr3Il7.js";
 import { assertEquals } from "../assert_equals-DSbWqCm3.js";
 import { assert } from "../assert-MZs1qjMx.js";
 import { assertInstanceOf } from "../assert_instance_of-DHz7EHNU.js";
 import { MemoryKvStore } from "../kv-CRZrzyXm.js";
-import { FederationImpl, actorDehydrator, autoIdAssigner } from "../middleware-CMiUxZ6O.js";
-import "../client-yGBH5stP.js";
-import "../lookup-DuqY2_In.js";
+import { FederationImpl, actorDehydrator, autoIdAssigner } from "../middleware-DQYscW90.js";
+import "../client-D5CBsPrc.js";
+import "../lookup-CbtuFbtg.js";
 import "../types-BSuWJsOm.js";
-import "../actor-BxAu0qet.js";
-import "../key-Cps8Sv3N.js";
-import "../http-BEo67UOx.js";
-import "../authdocloader-Chl2nuOI.js";
-import "../ld-CXygHn_m.js";
-import "../owner-D2fTlp_x.js";
-import "../proof-kEUjWRNJ.js";
-import "../inbox-D-B5xFtJ.js";
-import "../builder-C8Of4dPy.js";
+import "../actor-D8gCwLzv.js";
+import "../key-DnqhSgAv.js";
+import "../http-CuS-d4U0.js";
+import "../authdocloader-DYTNpaMA.js";
+import "../ld-Isot0tiW.js";
+import "../owner-ChSL4aJ7.js";
+import "../proof-x3IBewan.js";
+import "../inbox-IETv_Qez.js";
+import "../builder-1_skw-d2.js";
 import "../collection-CcnIw1qY.js";
-import "../keycache-D_Q1fPV0.js";
+import "../keycache-CSBkusP8.js";
 import "../negotiation-5NPJL6zp.js";
 import "../retry-D4GJ670a.js";
-import "../send-Utq2Jm0I.js";
-import { test } from "../testing-DUpTIvNE.js";
+import "../send-D5fjmUEj.js";
+import { test } from "../testing-tWr1VQxx.js";
 
 //#region src/compat/transformers.test.ts
 const federation = new FederationImpl({ kv: new MemoryKvStore() });

package/dist/{context-CQsAT7xk.d.ts → context-DBKpNBnc.d.ts}

@@ -3,11 +3,11 @@ 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-bgSdkFa2.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 { 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";
@@ -309,6 +309,7 @@ type CustomCollectionCounter<TParams extends Record<string, string>, TContextDat
 type CustomCollectionCursor<TParams extends Record<string, string>, TContext extends Context<TContextData>, TContextData> = (context: TContext, values: TParams) => string | null | Promise<string | null>;
 //#endregion
 //#region src/federation/handler.d.ts
+
 /**
  * Options for the {@link respondWithObject} and
  * {@link respondWithObjectIfAcceptable} functions.
@@ -1091,12 +1092,6 @@ interface FederationOptions<TContextData> {
    * @since 1.4.0
    */
   contextLoaderFactory?: DocumentLoaderFactory;
-  /**
-   * A custom JSON-LD context loader.  By default, this uses the same loader
-   * as the document loader.
-   * @deprecated Use {@link contextLoaderFactory} instead.
-   */
-  contextLoader?: DocumentLoader;
   /**
    * A factory function that creates an authenticated document loader for a
    * given identity.  This is used for fetching documents that require
@@ -1305,6 +1300,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.
  */
@@ -1335,6 +1360,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.
@@ -2253,4 +2308,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 };

package/dist/{context-tVOQ76fi.d.cts → context-DiqjMRef.d.cts}

@@ -1,11 +1,11 @@
 import { KvKey, KvStore } from "./kv-63Cil1MD.cjs";
 import { AuthenticatedDocumentLoaderFactory, DocumentLoader, DocumentLoaderFactory, GetUserAgentOptions } from "./docloader-D-MrRyHl.cjs";
 import { GetNodeInfoOptions, JsonValue, NodeInfo } from "./client-CegPX0Rn.cjs";
-import { Activity, Collection, CryptographicKey, Hashtag, Link, Multikey, Object as Object$1 } from "./vocab-DJTYMqyU.cjs";
-import { Actor, Recipient } from "./actor-DMgu-ZjT.cjs";
-import { HttpMessageSignaturesSpec } from "./http-BS6766zs.cjs";
-import { GetKeyOwnerOptions } from "./owner-B-7Ptt_m.cjs";
-import { LookupObjectOptions, TraverseCollectionOptions } from "./mod-evzlRVZq.cjs";
+import { Activity, Collection, CryptographicKey, Hashtag, Link, Multikey, Object as Object$1 } from "./vocab-Dw1-yVGg.cjs";
+import { Actor, Recipient } from "./actor-D6K058Tb.cjs";
+import { HttpMessageSignaturesSpec } from "./http-D-e6AFwR.cjs";
+import { GetKeyOwnerOptions } from "./owner-BN_tO3cY.cjs";
+import { LookupObjectOptions, TraverseCollectionOptions } from "./mod-CxkWO3Mg.cjs";
 import { Link as Link$1, LookupWebFingerOptions, ResourceDescriptor } from "./mod-jQ4OODsl.cjs";
 import { MessageQueue } from "./mq-B7R1Q-M5.cjs";
 import { Span, TracerProvider } from "@opentelemetry/api";
@@ -307,6 +307,7 @@ type CustomCollectionCounter<TParams extends Record<string, string>, TContextDat
 type CustomCollectionCursor<TParams extends Record<string, string>, TContext extends Context<TContextData>, TContextData> = (context: TContext, values: TParams) => string | null | Promise<string | null>;
 //#endregion
 //#region src/federation/handler.d.ts
+
 /**
  * Options for the {@link respondWithObject} and
  * {@link respondWithObjectIfAcceptable} functions.
@@ -1089,12 +1090,6 @@ interface FederationOptions<TContextData> {
    * @since 1.4.0
    */
   contextLoaderFactory?: DocumentLoaderFactory;
-  /**
-   * A custom JSON-LD context loader.  By default, this uses the same loader
-   * as the document loader.
-   * @deprecated Use {@link contextLoaderFactory} instead.
-   */
-  contextLoader?: DocumentLoader;
   /**
    * A factory function that creates an authenticated document loader for a
    * given identity.  This is used for fetching documents that require
@@ -1303,6 +1298,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.
  */
@@ -1333,6 +1358,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.
@@ -2251,4 +2306,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 };

package/dist/{docloader-SZjTrl6Z.cjs → docloader-CYnQRIXv.cjs}

@@ -10,7 +10,7 @@ const node_net = require_chunk.__toESM(require("node:net"));
 
 //#region deno.json
 var name = "@fedify/fedify";
-var version = "2.0.0-pr.435.1673+515e9f9e";
+var version = "2.0.0-pr.445.1694+d0c7cd75";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/mod.ts",

package/dist/{docloader-_WdHTWQR.js → docloader-Czl3xV10.js}

@@ -9,7 +9,7 @@ import { isIP } from "node:net";
 
 //#region deno.json
 var name = "@fedify/fedify";
-var version = "2.0.0-pr.435.1673+515e9f9e";
+var version = "2.0.0-pr.445.1694+d0c7cd75";
 var license = "MIT";
 var exports = {
 	".": "./src/mod.ts",

package/dist/{esm-e_G_xo95.js → esm-Dl5T1RNE.js}

@@ -3,7 +3,7 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { __commonJS, __toESM } from "./type-BYN6Ax2M.js";
+import { __commonJS, __toESM } from "./type-DaUr3Il7.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,15 +3,15 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { Activity, Note, Person } from "../type-BYN6Ax2M.js";
+import { Activity, Note, Person } from "../type-DaUr3Il7.js";
 import { assertEquals } from "../assert_equals-DSbWqCm3.js";
 import "../assert-MZs1qjMx.js";
 import "../assert_instance_of-DHz7EHNU.js";
 import { MemoryKvStore } from "../kv-CRZrzyXm.js";
-import "../lookup-DuqY2_In.js";
-import "../inbox-D-B5xFtJ.js";
-import { createFederationBuilder } from "../builder-C8Of4dPy.js";
-import { test } from "../testing-DUpTIvNE.js";
+import "../lookup-CbtuFbtg.js";
+import "../inbox-IETv_Qez.js";
+import { createFederationBuilder } from "../builder-1_skw-d2.js";
+import { test } from "../testing-tWr1VQxx.js";
 import { assertExists } from "../std__assert-X-_kMxKM.js";
 import "../assert_rejects-DiIiJbZn.js";
 import "../assert_is_error-BPGph1Jx.js";

package/dist/federation/collection.test.js

@@ -3,13 +3,13 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import "../type-BYN6Ax2M.js";
+import "../type-DaUr3Il7.js";
 import { assertEquals } from "../assert_equals-DSbWqCm3.js";
 import "../assert-MZs1qjMx.js";
 import "../assert_instance_of-DHz7EHNU.js";
-import "../lookup-DuqY2_In.js";
+import "../lookup-CbtuFbtg.js";
 import { buildCollectionSynchronizationHeader, digest } from "../collection-CcnIw1qY.js";
-import { test } from "../testing-DUpTIvNE.js";
+import { test } from "../testing-tWr1VQxx.js";
 import "../std__assert-X-_kMxKM.js";
 import "../assert_rejects-DiIiJbZn.js";
 import "../assert_is_error-BPGph1Jx.js";

package/dist/federation/handler.test.js

@@ -3,36 +3,36 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { Create, Note, Person } from "../type-BYN6Ax2M.js";
+import { Create, Note, Person } from "../type-DaUr3Il7.js";
 import { assertEquals } from "../assert_equals-DSbWqCm3.js";
 import { assert } from "../assert-MZs1qjMx.js";
 import "../assert_instance_of-DHz7EHNU.js";
 import { MemoryKvStore } from "../kv-CRZrzyXm.js";
-import { createFederation, handleActor, handleCollection, handleCustomCollection, handleInbox, handleObject, respondWithObject, respondWithObjectIfAcceptable } from "../middleware-CMiUxZ6O.js";
-import "../client-yGBH5stP.js";
-import "../lookup-DuqY2_In.js";
+import { createFederation, handleActor, handleCollection, handleCustomCollection, handleInbox, handleObject, respondWithObject, respondWithObjectIfAcceptable } from "../middleware-DQYscW90.js";
+import "../client-D5CBsPrc.js";
+import "../lookup-CbtuFbtg.js";
 import "../types-BSuWJsOm.js";
-import "../actor-BxAu0qet.js";
-import "../key-Cps8Sv3N.js";
-import { signRequest } from "../http-BEo67UOx.js";
-import "../authdocloader-Chl2nuOI.js";
-import "../ld-CXygHn_m.js";
-import "../owner-D2fTlp_x.js";
-import "../proof-kEUjWRNJ.js";
-import { InboxListenerSet } from "../inbox-D-B5xFtJ.js";
-import "../builder-C8Of4dPy.js";
+import "../actor-D8gCwLzv.js";
+import "../key-DnqhSgAv.js";
+import { signRequest } from "../http-CuS-d4U0.js";
+import "../authdocloader-DYTNpaMA.js";
+import "../ld-Isot0tiW.js";
+import "../owner-ChSL4aJ7.js";
+import "../proof-x3IBewan.js";
+import { InboxListenerSet } from "../inbox-IETv_Qez.js";
+import "../builder-1_skw-d2.js";
 import "../collection-CcnIw1qY.js";
-import "../keycache-D_Q1fPV0.js";
+import "../keycache-CSBkusP8.js";
 import "../negotiation-5NPJL6zp.js";
 import "../retry-D4GJ670a.js";
-import "../send-Utq2Jm0I.js";
-import { createInboxContext, createRequestContext, mockDocumentLoader, test } from "../testing-DUpTIvNE.js";
+import "../send-D5fjmUEj.js";
+import { createInboxContext, createRequestContext, mockDocumentLoader, test } from "../testing-tWr1VQxx.js";
 import "../std__assert-X-_kMxKM.js";
 import "../assert_rejects-DiIiJbZn.js";
 import "../assert_is_error-BPGph1Jx.js";
 import "../assert_not_equals-f3m3epl3.js";
 import "../assert_throws-BOO88avQ.js";
-import { rsaPrivateKey3, rsaPublicKey2, rsaPublicKey3 } from "../keys-F0jh2GNR.js";
+import { rsaPrivateKey3, rsaPublicKey2, rsaPublicKey3 } from "../keys-D3_MDK7n.js";
 
 //#region src/federation/handler.test.ts
 test("handleActor()", async () => {

package/dist/federation/idempotency.test.d.ts

@@ -0,0 +1,3 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { URLPattern } from "urlpattern-polyfill";
+globalThis.addEventListener = () => {};