@clipboard-health/notifications 0.6.0 → 0.7.0

package/README.md

@@ -6,7 +6,6 @@ Send notifications through third-party providers.
 
 - [Install](#install)
 - [Usage](#usage)
-  - [`NotificationClient`](#notificationclient)
 - [Local development commands](#local-development-commands)
 
 ## Install
@@ -17,49 +16,140 @@ npm install @clipboard-health/notifications
 
 ## Usage
 
-### `NotificationClient`
-
-<embedex source="packages/notifications/examples/notificationClient.ts">
-
-```ts
-import { NotificationClient, type Span } from "@clipboard-health/notifications";
-import { isSuccess } from "@clipboard-health/util-ts";
-
-const client = new NotificationClient({
-  apiKey: "test-api-key",
-  logger: {
-    info: console.log,
-    warn: console.warn,
-    error: console.error,
-  } as const,
-  tracer: {
-    trace: <T>(_name: string, _options: unknown, fun: (span?: Span | undefined) => T): T => fun(),
-  },
-});
-
-async function triggerNotification(job: { attemptsCount: number }) {
-  const result = await client.trigger({
-    attempt: (job?.attemptsCount ?? 0) + 1,
-    body: {
-      recipients: ["user-1"],
-      data: { favoriteColor: "blue", secret: "2" },
-    },
-    expiresAt: new Date(Date.now() + 300_000), // 5 minutes
-    idempotencyKey: "welcome-user-4",
-    key: "welcome-email",
-    keysToRedact: ["secret"],
-  });
-
-  if (isSuccess(result)) {
-    console.log("Notification sent:", result.value.id);
-  }
-}
-
-// eslint-disable-next-line unicorn/prefer-top-level-await
-void triggerNotification({ attemptsCount: 0 });
-```
+1. Export a `NotificationJobEnqueuer` instance:
+
+   <embedex source="packages/notifications/examples/notificationJobEnqueuer.ts">
+
+   ```ts
+   import { NotificationJobEnqueuer } from "@clipboard-health/notifications";
+
+   import { BackgroundJobsService } from "./setup";
+
+   // Provide this in your microservice.
+   export const notificationJobEnqueuer = new NotificationJobEnqueuer({
+     adapter: new BackgroundJobsService(),
+   });
+   ```
+
+   </embedex>
+
+1. Enqueue your job:
+
+   <embedex source="packages/notifications/examples/enqueueNotificationJob.ts">
+
+   ```ts
+   import { IdempotencyKey } from "@clipboard-health/notifications";
+
+   import { ExampleNotificationJob } from "./exampleNotification.job";
+   import { notificationJobEnqueuer } from "./notificationJobEnqueuer";
+
+   async function enqueueNotificationJob() {
+     await notificationJobEnqueuer.enqueueOneOrMore(ExampleNotificationJob, {
+       // Set expiresAt at enqueue-time so it remains stable across job retries.
+       expiresAt: minutesFromNow(60),
+       // Set idempotencyKey at enqueue-time so it remains stable across job retries.
+       idempotencyKey: new IdempotencyKey({
+         resourceId: "event-123",
+       }),
+       // Set recipients at enqueue-time so they respect our notification provider's limits.
+       recipients: ["user-1"],
+
+       workflowKey: "event-starting-reminder",
+
+       // Any additional enqueue-time data passed to the job:
+       workplaceId: "workplace-123",
+     });
+   }
+
+   // eslint-disable-next-line unicorn/prefer-top-level-await
+   void enqueueNotificationJob();
+
+   function minutesFromNow(minutes: number) {
+     return new Date(Date.now() + minutes * 60_000);
+   }
+   ```
+
+   </embedex>
+
+1. Implement your job, which should be minimal, calling off to a service to send the actual notification:
+
+   <embedex source="packages/notifications/examples/exampleNotification.job.ts">
+
+   ```ts
+   import { type BaseHandler } from "@clipboard-health/background-jobs-adapter";
+   import {
+     errorsInResult,
+     type NotificationEnqueueData,
+     type NotificationJobData,
+     RETRYABLE_ERRORS,
+   } from "@clipboard-health/notifications";
+   import { toError } from "@clipboard-health/util-ts";
+
+   import { type ExampleNotificationService } from "./exampleNotification.service";
+
+   interface ExampleNotificationData {
+     workplaceId: string;
+   }
+
+   export type ExampleNotificationEnqueueData = NotificationEnqueueData & ExampleNotificationData;
+   export type ExampleNotificationJobData = NotificationJobData & ExampleNotificationData;
+
+   export class ExampleNotificationJob implements BaseHandler<ExampleNotificationJobData> {
+     constructor(private readonly service: ExampleNotificationService) {}
+
+     async perform(data: ExampleNotificationJobData, job: { attemptsCount: number }) {
+       const result = await this.service.sendNotification({
+         ...data,
+         // Include the job's attempts count for debugging, this is called `retryAttempts` in `background-jobs-postgres`.
+         attempt: job.attemptsCount + 1,
+       });
+
+       if (errorsInResult(result, RETRYABLE_ERRORS)) {
+         throw toError(result.error);
+       }
+     }
+   }
+   ```
+
+   </embedex>
+
+1. Trigger the job in your service:
+
+   <embedex source="packages/notifications/examples/exampleNotification.service.ts">
+
+   ```ts
+   import { type NotificationClient } from "@clipboard-health/notifications";
+
+   import { type ExampleNotificationJobData } from "./exampleNotification.job";
+
+   type ExampleNotificationDo = ExampleNotificationJobData & { attempt: number };
+
+   export class ExampleNotificationService {
+     constructor(private readonly client: NotificationClient) {}
+
+     async sendNotification(params: ExampleNotificationDo) {
+       const { attempt, expiresAt, idempotencyKey, recipients, workflowKey, workplaceId } = params;
+
+       // Assume this comes from a database and, for example, are used as template variables...
+       const data = { favoriteColor: "blue", secret: "2" };
+
+       return await this.client.trigger({
+         attempt,
+         body: {
+           recipients,
+           data,
+           workplaceId,
+         },
+         expiresAt,
+         idempotencyKey,
+         workflowKey,
+         keysToRedact: ["secret"],
+       });
+     }
+   }
+   ```
 
-</embedex>
+   </embedex>
 
 ## Local development commands
 

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@clipboard-health/notifications",
   "description": "Send notifications through third-party providers.",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "bugs": "https://github.com/ClipboardHealth/core-utils/issues",
   "dependencies": {
-    "@clipboard-health/phone-number": "0.5.0",
-    "@clipboard-health/util-ts": "3.14.0",
+    "@clipboard-health/background-jobs-adapter": "0.2.0",
+    "@clipboard-health/phone-number": "0.6.0",
+    "@clipboard-health/util-ts": "3.15.0",
     "@knocklabs/node": "1.16.0",
-    "fast-json-stable-stringify": "2.1.0",
     "tslib": "2.8.1"
   },
   "devDependencies": {
-    "@clipboard-health/testing-core": "0.23.0"
+    "@clipboard-health/testing-core": "0.24.0"
   },
   "keywords": [],
   "license": "MIT",

package/src/index.d.ts

@@ -1,5 +1,5 @@
-export * from "./lib/chunkRecipients";
-export * from "./lib/createIdempotencyKey";
 export * from "./lib/errorsInResult";
+export * from "./lib/idempotencyKey";
 export * from "./lib/notificationClient";
+export * from "./lib/notificationJobEnqueuer";
 export * from "./lib/types";

package/src/index.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./lib/chunkRecipients"), exports);
-tslib_1.__exportStar(require("./lib/createIdempotencyKey"), exports);
 tslib_1.__exportStar(require("./lib/errorsInResult"), exports);
+tslib_1.__exportStar(require("./lib/idempotencyKey"), exports);
 tslib_1.__exportStar(require("./lib/notificationClient"), exports);
+tslib_1.__exportStar(require("./lib/notificationJobEnqueuer"), exports);
 tslib_1.__exportStar(require("./lib/types"), exports);
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/notifications/src/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,qEAA2C;AAC3C,+DAAqC;AACrC,mEAAyC;AACzC,sDAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/notifications/src/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,+DAAqC;AACrC,mEAAyC;AACzC,wEAA8C;AAC9C,sDAA4B"}

package/src/lib/idempotencyKey.d.ts

@@ -0,0 +1,46 @@
+export interface IdempotencyKeyParams {
+    /**
+     * Prefer `resourceId` over `eventOccurredAt`; it's harder to misuse.
+     *
+     * If an event triggered your workflow and it doesn't have a unique ID, you may decide to use its
+     * occurrence timestamp. For example, if you have a daily CRON job, use the date it ran.
+     *
+     * Take care when using `Date.now()` or `new Date()`. These change each time your job runs, which
+     * means the idempotency key will always be different and doesn't prevent duplicate notifications.
+     */
+    eventOccurredAt?: Date | undefined;
+    /**
+     * If a resource triggered your workflow, include its unique ID.
+     *
+     * @note `recipients` (and `workplaceId` if it exists) are included in the idempotency key
+     * automatically from the trigger body.
+     *
+     * @example
+     * 1. For a "meeting starts in one hour" notification, set resourceId to the meeting ID.
+     * 2. For a payout notification, set resourceId to the payment ID.
+     */
+    resourceId?: string | undefined;
+}
+/**
+ * Idempotency keys prevent duplicate notifications. They should be deterministic and remain the
+ * same across retry logic.
+ *
+ * If you retry a request with the same idempotency key within 24 hours, the client returns the same
+ * response as the original request.
+ *
+ * @note `recipients` (and `workplaceId` if it exists) are included in the idempotency key
+ * automatically from the trigger body.
+ *
+ * We provide this class because idempotency keys can be difficult to use correctly. If the key
+ * changes on each retry (e.g., Date.now() or uuid.v4()), it won't prevent duplicate notifications.
+ * Conversely, if you don't provide enough information, you prevent recipients from receiving
+ * notifications they otherwise should have. For example, if you use the trigger key and the
+ * recipient's ID as the idempotency key, but it's possible the recipient could receive the same
+ * notification multiple times within the idempotency key's validity window, the recipient will only
+ * receive the first notification.
+ */
+export declare class IdempotencyKey {
+    protected readonly eventOccurredAt: IdempotencyKeyParams["eventOccurredAt"];
+    protected readonly resourceId: IdempotencyKeyParams["resourceId"];
+    constructor(params: IdempotencyKeyParams);
+}

package/src/lib/idempotencyKey.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdempotencyKey = void 0;
+/**
+ * Idempotency keys prevent duplicate notifications. They should be deterministic and remain the
+ * same across retry logic.
+ *
+ * If you retry a request with the same idempotency key within 24 hours, the client returns the same
+ * response as the original request.
+ *
+ * @note `recipients` (and `workplaceId` if it exists) are included in the idempotency key
+ * automatically from the trigger body.
+ *
+ * We provide this class because idempotency keys can be difficult to use correctly. If the key
+ * changes on each retry (e.g., Date.now() or uuid.v4()), it won't prevent duplicate notifications.
+ * Conversely, if you don't provide enough information, you prevent recipients from receiving
+ * notifications they otherwise should have. For example, if you use the trigger key and the
+ * recipient's ID as the idempotency key, but it's possible the recipient could receive the same
+ * notification multiple times within the idempotency key's validity window, the recipient will only
+ * receive the first notification.
+ */
+class IdempotencyKey {
+    eventOccurredAt;
+    resourceId;
+    constructor(params) {
+        const { eventOccurredAt, resourceId } = params;
+        this.eventOccurredAt = eventOccurredAt;
+        this.resourceId = resourceId;
+    }
+}
+exports.IdempotencyKey = IdempotencyKey;
+//# sourceMappingURL=idempotencyKey.js.map

package/src/lib/idempotencyKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyKey.js","sourceRoot":"","sources":["../../../../../packages/notifications/src/lib/idempotencyKey.ts"],"names":[],"mappings":";;;AAyBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,cAAc;IACN,eAAe,CAA0C;IACzD,UAAU,CAAqC;IAElE,YAAmB,MAA4B;QAC7C,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAE/C,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAVD,wCAUC"}

package/src/lib/internal/chunkRecipients.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Chunks recipients into groups that don't exceed the maximum recipients count,
+ * assigning a unique chunk number to each group.
+ *
+ * This function is used to split large recipient lists into smaller batches that
+ * comply with notification provider limits. Each chunk is numbered sequentially
+ * starting from 1.
+ *
+ * @param params - The chunking parameters
+ * @param params.recipients - Array of recipient IDs to chunk
+ * @returns Array of chunks, each containing a chunk number and recipients array
+ */
+export declare function chunkRecipients(params: {
+    recipients: string[];
+}): Array<{
+    number: number;
+    recipients: string[];
+}>;

package/src/lib/internal/chunkRecipients.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chunkRecipients = chunkRecipients;
+const util_ts_1 = require("@clipboard-health/util-ts");
+const notificationClient_1 = require("../notificationClient");
+/**
+ * Chunks recipients into groups that don't exceed the maximum recipients count,
+ * assigning a unique chunk number to each group.
+ *
+ * This function is used to split large recipient lists into smaller batches that
+ * comply with notification provider limits. Each chunk is numbered sequentially
+ * starting from 1.
+ *
+ * @param params - The chunking parameters
+ * @param params.recipients - Array of recipient IDs to chunk
+ * @returns Array of chunks, each containing a chunk number and recipients array
+ */
+function chunkRecipients(params) {
+    const { recipients } = params;
+    if (recipients.length === 0) {
+        return [{ number: 1, recipients: [] }];
+    }
+    return (0, util_ts_1.chunk)(recipients, notificationClient_1.MAXIMUM_RECIPIENTS_COUNT).map((recipientsChunk, index) => ({
+        number: index + 1,
+        recipients: recipientsChunk,
+    }));
+}
+//# sourceMappingURL=chunkRecipients.js.map

package/src/lib/internal/chunkRecipients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkRecipients.js","sourceRoot":"","sources":["../../../../../../packages/notifications/src/lib/internal/chunkRecipients.ts"],"names":[],"mappings":";;AAgBA,0CAaC;AA7BD,uDAAkD;AAElD,8DAAiE;AAEjE;;;;;;;;;;;GAWG;AACH,SAAgB,eAAe,CAAC,MAE/B;IACC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAE9B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,IAAA,eAAK,EAAC,UAAU,EAAE,6CAAwB,CAAC,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAClF,MAAM,EAAE,KAAK,GAAG,CAAC;QACjB,UAAU,EAAE,eAAe;KAC5B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/src/lib/internal/createDeterministicHash.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Creates a deterministic hash.
+ *
+ * Normalizes `value` using stable JSON serialization for non-string values and generates
+ * a SHA-256 hash.
+ *
+ * Note: Non-JSON-serializable values (undefined, Symbol, functions, circular refs) may be
+ * dropped or cause errors during serialization.
+ *
+ * @param value - Value to hash (string, string[], object, etc.).
+ * @returns A hex string representing the hash.
+ */
+export declare function createDeterministicHash(value: unknown): string;

package/src/lib/internal/createDeterministicHash.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDeterministicHash = createDeterministicHash;
+const node_crypto_1 = require("node:crypto");
+const util_ts_1 = require("@clipboard-health/util-ts");
+/**
+ * Creates a deterministic hash.
+ *
+ * Normalizes `value` using stable JSON serialization for non-string values and generates
+ * a SHA-256 hash.
+ *
+ * Note: Non-JSON-serializable values (undefined, Symbol, functions, circular refs) may be
+ * dropped or cause errors during serialization.
+ *
+ * @param value - Value to hash (string, string[], object, etc.).
+ * @returns A hex string representing the hash.
+ */
+function createDeterministicHash(value) {
+    return (0, node_crypto_1.createHash)("sha256")
+        .update(typeof value === "string" ? value : (0, util_ts_1.stringify)(value))
+        .digest("hex");
+}
+//# sourceMappingURL=createDeterministicHash.js.map

package/src/lib/internal/createDeterministicHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDeterministicHash.js","sourceRoot":"","sources":["../../../../../../packages/notifications/src/lib/internal/createDeterministicHash.ts"],"names":[],"mappings":";;AAgBA,0DAIC;AApBD,6CAAyC;AAEzC,uDAAsD;AAEtD;;;;;;;;;;;GAWG;AACH,SAAgB,uBAAuB,CAAC,KAAc;IACpD,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,mBAAS,EAAC,KAAK,CAAC,CAAC;SAC5D,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/src/lib/internal/createTriggerLogParams.d.ts

@@ -1,3 +1,3 @@
 import type { LogParams, TriggerRequest } from "../types";
-export type TriggerLogContext = LogParams & Pick<TriggerRequest, "attempt" | "idempotencyKey" | "key">;
+export type TriggerLogContext = LogParams & Pick<TriggerRequest, "attempt" | "idempotencyKey" | "workflowKey">;
 export declare function createTriggerLogParams(params: TriggerRequest & LogParams): TriggerLogContext;

package/src/lib/internal/createTriggerLogParams.js

@@ -2,12 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTriggerLogParams = createTriggerLogParams;
 function createTriggerLogParams(params) {
-    const { attempt, destination, idempotencyKey, key, traceName } = params;
+    const { attempt, destination, idempotencyKey, key, workflowKey, traceName } = params;
     return {
         attempt,
         destination,
         idempotencyKey,
-        key,
+        workflowKey: /* istanbul ignore next */ workflowKey ?? key,
         traceName,
     };
 }

package/src/lib/internal/createTriggerLogParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"createTriggerLogParams.js","sourceRoot":"","sources":["../../../../../../packages/notifications/src/lib/internal/createTriggerLogParams.ts"],"names":[],"mappings":";;AAKA,wDAUC;AAVD,SAAgB,sBAAsB,CAAC,MAAkC;IACvE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAExE,OAAO;QACL,OAAO;QACP,WAAW;QACX,cAAc;QACd,GAAG;QACH,SAAS;KACV,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createTriggerLogParams.js","sourceRoot":"","sources":["../../../../../../packages/notifications/src/lib/internal/createTriggerLogParams.ts"],"names":[],"mappings":";;AAKA,wDAUC;AAVD,SAAgB,sBAAsB,CAAC,MAAkC;IACvE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAErF,OAAO;QACL,OAAO;QACP,WAAW;QACX,cAAc;QACd,WAAW,EAAE,0BAA0B,CAAC,WAAW,IAAI,GAAG;QAC1D,SAAS;KACV,CAAC;AACJ,CAAC"}

package/src/lib/internal/createTriggerTraceOptions.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTriggerTraceOptions = createTriggerTraceOptions;
 function createTriggerTraceOptions(params) {
-    const { key, attempt, destination } = params;
+    const { workflowKey, attempt, destination } = params;
     return {
-        resource: `notification.${key}`,
+        resource: `notification.${workflowKey}`,
         /**
          * Don't include high cardinality tags like expiresAt and idempotencyKey to reduce Datadog
          * costs.

package/src/lib/internal/createTriggerTraceOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"createTriggerTraceOptions.js","sourceRoot":"","sources":["../../../../../../packages/notifications/src/lib/internal/createTriggerTraceOptions.ts"],"names":[],"mappings":";;AAGA,8DAkBC;AAlBD,SAAgB,yBAAyB,CAAC,MAAyB;IACjE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE7C,OAAO;QACL,QAAQ,EAAE,gBAAgB,GAAG,EAAE;QAC/B;;;WAGG;QACH,IAAI,EAAE;YACJ,WAAW,EAAE,UAAU;YACvB,SAAS,EAAE,wBAAwB;YACnC,kBAAkB,EAAE,WAAW;YAC/B,qBAAqB,EAAE,SAAS;YAChC,uBAAuB,EAAE,WAAW;YACpC,sBAAsB,EAAE,OAAO,CAAC,QAAQ,EAAE;SAC3C;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createTriggerTraceOptions.js","sourceRoot":"","sources":["../../../../../../packages/notifications/src/lib/internal/createTriggerTraceOptions.ts"],"names":[],"mappings":";;AAGA,8DAkBC;AAlBD,SAAgB,yBAAyB,CAAC,MAAyB;IACjE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAErD,OAAO;QACL,QAAQ,EAAE,gBAAgB,WAAW,EAAE;QACvC;;;WAGG;QACH,IAAI,EAAE;YACJ,WAAW,EAAE,UAAU;YACvB,SAAS,EAAE,wBAAwB;YACnC,kBAAkB,EAAE,WAAW;YAC/B,qBAAqB,EAAE,SAAS;YAChC,uBAAuB,EAAE,WAAW;YACpC,sBAAsB,EAAE,OAAO,CAAC,QAAQ,EAAE;SAC3C;KACF,CAAC;AACJ,CAAC"}

package/src/lib/internal/idempotencyKeyDoNotImportOutsideNotificationsLibrary.d.ts

@@ -0,0 +1,35 @@
+import { IdempotencyKey, type IdempotencyKeyParams } from "../idempotencyKey";
+interface IdempotencyKeyDoNotImportOutsideNotificationsLibraryParams extends IdempotencyKeyParams {
+    /**
+     * The recipient chunk number.
+     */
+    chunk: number;
+    /**
+     * The recipients in the chunk; maximum of MAXIMUM_RECIPIENTS_COUNT.
+     */
+    recipients: string[];
+    /**
+     * The workflow key.
+     */
+    workflowKey: string;
+}
+/**
+ * Idempotency keys prevent duplicate notifications. `NotificationClient.trigger` should be called
+ * after properly enqueuing a job using `NotificationJobEnqueuer.enqueueOneOrMore` to help ensure
+ * we're following best practices so customers don't receive duplicate or stale notifications.
+ *
+ * Yes, you could import this class into your service and call `NotificationClient.trigger`
+ * directly. We're using the honor system in hopes that enforcement is unnecessary.
+ *
+ * @see {@link NotificationJobEnqueuer.enqueueOneOrMore}.
+ */
+export declare class IdempotencyKeyDoNotImportOutsideNotificationsLibrary extends IdempotencyKey {
+    private readonly chunk;
+    private readonly recipients;
+    private readonly workflowKey;
+    constructor(params: IdempotencyKeyDoNotImportOutsideNotificationsLibraryParams);
+    toHash(params: {
+        workplaceId?: string | undefined;
+    }): string;
+}
+export {};

package/src/lib/internal/idempotencyKeyDoNotImportOutsideNotificationsLibrary.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdempotencyKeyDoNotImportOutsideNotificationsLibrary = void 0;
+const util_ts_1 = require("@clipboard-health/util-ts");
+const idempotencyKey_1 = require("../idempotencyKey");
+const createDeterministicHash_1 = require("./createDeterministicHash");
+/**
+ * Idempotency keys prevent duplicate notifications. `NotificationClient.trigger` should be called
+ * after properly enqueuing a job using `NotificationJobEnqueuer.enqueueOneOrMore` to help ensure
+ * we're following best practices so customers don't receive duplicate or stale notifications.
+ *
+ * Yes, you could import this class into your service and call `NotificationClient.trigger`
+ * directly. We're using the honor system in hopes that enforcement is unnecessary.
+ *
+ * @see {@link NotificationJobEnqueuer.enqueueOneOrMore}.
+ */
+class IdempotencyKeyDoNotImportOutsideNotificationsLibrary extends idempotencyKey_1.IdempotencyKey {
+    chunk;
+    recipients;
+    workflowKey;
+    constructor(params) {
+        const { chunk, recipients, workflowKey, ...rest } = params;
+        super(rest);
+        this.chunk = chunk;
+        this.recipients = recipients;
+        this.workflowKey = workflowKey;
+    }
+    toHash(params) {
+        const { workplaceId } = params;
+        return (0, createDeterministicHash_1.createDeterministicHash)([
+            this.workflowKey,
+            this.chunk,
+            this.resourceId,
+            this.eventOccurredAt?.toISOString(),
+            this.recipients.join(","),
+            workplaceId,
+        ]
+            .filter(util_ts_1.isDefined)
+            .join(","));
+    }
+}
+exports.IdempotencyKeyDoNotImportOutsideNotificationsLibrary = IdempotencyKeyDoNotImportOutsideNotificationsLibrary;
+//# sourceMappingURL=idempotencyKeyDoNotImportOutsideNotificationsLibrary.js.map

package/src/lib/internal/idempotencyKeyDoNotImportOutsideNotificationsLibrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyKeyDoNotImportOutsideNotificationsLibrary.js","sourceRoot":"","sources":["../../../../../../packages/notifications/src/lib/internal/idempotencyKeyDoNotImportOutsideNotificationsLibrary.ts"],"names":[],"mappings":";;;AAAA,uDAAsD;AAEtD,sDAA8E;AAK9E,uEAAoE;AAmBpE;;;;;;;;;GASG;AACH,MAAa,oDAAqD,SAAQ,+BAAc;IACrE,KAAK,CAAsE;IAC3E,UAAU,CAA2E;IACrF,WAAW,CAA4E;IAExG,YAAY,MAAkE;QAC5E,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAE3D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,MAA4C;QACjD,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAE/B,OAAO,IAAA,iDAAuB,EAC5B;YACE,IAAI,CAAC,WAAW;YAChB,IAAI,CAAC,KAAK;YACV,IAAI,CAAC,UAAU;YACf,IAAI,CAAC,eAAe,EAAE,WAAW,EAAE;YACnC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;YACzB,WAAW;SACZ;aACE,MAAM,CAAC,mBAAS,CAAC;aACjB,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;IACJ,CAAC;CACF;AA9BD,oHA8BC"}

package/src/lib/internal/idempotentKnock.d.ts

@@ -1,5 +1,10 @@
 import { type Logger } from "@clipboard-health/util-ts";
 import { Knock } from "@knocklabs/node";
+/**
+ * Extended Knock client with custom configuration for idempotent operations.
+ *
+ * @see {@link https://docs.knock.app/api-reference/overview/idempotent-requests}
+ */
 export declare class IdempotentKnock extends Knock {
     logLevel: "warn";
     maxRetries: number;

package/src/lib/internal/idempotentKnock.js

@@ -2,6 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IdempotentKnock = void 0;
 const node_1 = require("@knocklabs/node");
+/**
+ * Extended Knock client with custom configuration for idempotent operations.
+ *
+ * @see {@link https://docs.knock.app/api-reference/overview/idempotent-requests}
+ */
 class IdempotentKnock extends node_1.Knock {
     logLevel = "warn"; // Knock's default.
     maxRetries = 1; // Knock's default is 2, but we rely on background job retries.

package/src/lib/internal/idempotentKnock.js.map

@@ -1 +1 @@
-{"version":3,"file":"idempotentKnock.js","sourceRoot":"","sources":["../../../../../../packages/notifications/src/lib/internal/idempotentKnock.ts"],"names":[],"mappings":";;;AACA,0CAAwC;AAExC,MAAa,eAAgB,SAAQ,YAAK;IACxB,QAAQ,GAAG,MAAe,CAAC,CAAC,mBAAmB;IAC/C,UAAU,GAAG,CAAC,CAAC,CAAC,+DAA+D;IAC/E,OAAO,GAAG,MAAM,CAAC,CAAC,mBAAmB;IAElC,iBAAiB,GAAG,iBAAiB,CAAC;IAEzD,YAAY,MAA0C;QACpD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAElC,KAAK,CAAC;YACJ,MAAM;YACN,MAAM,EAAE;gBACN,GAAG,MAAM;gBACT,KAAK,EAAE,MAAM,CAAC,IAAI;aACnB;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAlBD,0CAkBC"}
+{"version":3,"file":"idempotentKnock.js","sourceRoot":"","sources":["../../../../../../packages/notifications/src/lib/internal/idempotentKnock.ts"],"names":[],"mappings":";;;AACA,0CAAwC;AAExC;;;;GAIG;AACH,MAAa,eAAgB,SAAQ,YAAK;IACxB,QAAQ,GAAG,MAAe,CAAC,CAAC,mBAAmB;IAC/C,UAAU,GAAG,CAAC,CAAC,CAAC,+DAA+D;IAC/E,OAAO,GAAG,MAAM,CAAC,CAAC,mBAAmB;IAElC,iBAAiB,GAAG,iBAAiB,CAAC;IAEzD,YAAY,MAA0C;QACpD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAElC,KAAK,CAAC;YACJ,MAAM;YACN,MAAM,EAAE;gBACN,GAAG,MAAM;gBACT,KAAK,EAAE,MAAM,CAAC,IAAI;aACnB;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAlBD,0CAkBC"}

package/src/lib/notificationClient.d.ts

@@ -1,6 +1,5 @@
-import { type LogFunction, type Logger, type ServiceResult } from "@clipboard-health/util-ts";
-import { IdempotentKnock } from "./internal/idempotentKnock";
-import type { AppendPushTokenRequest, AppendPushTokenResponse, LogParams, NotificationClientParams, SignUserTokenRequest, SignUserTokenResponse, Span, Tracer, TriggerRequest, TriggerResponse, UpsertWorkplaceRequest, UpsertWorkplaceResponse } from "./types";
+import { type LogFunction, type ServiceResult } from "@clipboard-health/util-ts";
+import type { AppendPushTokenRequest, AppendPushTokenResponse, LogParams, NotificationClientParams, SignUserTokenRequest, SignUserTokenResponse, Span, TriggerRequest, TriggerResponse, UpsertWorkplaceRequest, UpsertWorkplaceResponse } from "./types";
 export declare const MAXIMUM_RECIPIENTS_COUNT = 1000;
 export declare const ERROR_CODES: {
     readonly expired: "expired";
@@ -18,9 +17,9 @@ interface NotificationError {
  * Client for sending notifications through third-party providers.
  */
 export declare class NotificationClient {
-    protected readonly logger: Logger;
-    protected readonly provider: IdempotentKnock;
-    protected readonly tracer: Tracer;
+    protected readonly logger: NotificationClientParams["logger"];
+    protected readonly provider: Required<NotificationClientParams>["provider"];
+    protected readonly tracer: NotificationClientParams["tracer"];
     private readonly signingKey;
     /**
      * Creates a new NotificationClient instance.
@@ -39,44 +38,38 @@ export declare class NotificationClient {
      * @returns Promise resolving to either an error or successful response.
      *
      * @example
-     * <embedex source="packages/notifications/examples/notificationClient.ts">
+     * <embedex source="packages/notifications/examples/exampleNotification.service.ts">
      *
      * ```ts
-     * import { NotificationClient, type Span } from "@clipboard-health/notifications";
-     * import { isSuccess } from "@clipboard-health/util-ts";
+     * import { type NotificationClient } from "@clipboard-health/notifications";
      *
-     * const client = new NotificationClient({
-     *   apiKey: "test-api-key",
-     *   logger: {
-     *     info: console.log,
-     *     warn: console.warn,
-     *     error: console.error,
-     *   } as const,
-     *   tracer: {
-     *     trace: <T>(_name: string, _options: unknown, fun: (span?: Span | undefined) => T): T => fun(),
-     *   },
-     * });
+     * import { type ExampleNotificationJobData } from "./exampleNotification.job";
      *
-     * async function triggerNotification(job: { attemptsCount: number }) {
-     *   const result = await client.trigger({
-     *     attempt: (job?.attemptsCount ?? 0) + 1,
-     *     body: {
-     *       recipients: ["user-1"],
-     *       data: { favoriteColor: "blue", secret: "2" },
-     *     },
-     *     expiresAt: new Date(Date.now() + 300_000), // 5 minutes
-     *     idempotencyKey: "welcome-user-4",
-     *     key: "welcome-email",
-     *     keysToRedact: ["secret"],
-     *   });
+     * type ExampleNotificationDo = ExampleNotificationJobData & { attempt: number };
      *
-     *   if (isSuccess(result)) {
-     *     console.log("Notification sent:", result.value.id);
+     * export class ExampleNotificationService {
+     *   constructor(private readonly client: NotificationClient) {}
+     *
+     *   async sendNotification(params: ExampleNotificationDo) {
+     *     const { attempt, expiresAt, idempotencyKey, recipients, workflowKey, workplaceId } = params;
+     *
+     *     // Assume this comes from a database and, for example, are used as template variables...
+     *     const data = { favoriteColor: "blue", secret: "2" };
+     *
+     *     return await this.client.trigger({
+     *       attempt,
+     *       body: {
+     *         recipients,
+     *         data,
+     *         workplaceId,
+     *       },
+     *       expiresAt,
+     *       idempotencyKey,
+     *       workflowKey,
+     *       keysToRedact: ["secret"],
+     *     });
      *   }
      * }
-     *
-     * // eslint-disable-next-line unicorn/prefer-top-level-await
-     * void triggerNotification({ attemptsCount: 0 });
      * ```
      *
      * </embedex>

package/src/lib/notificationClient.js

@@ -5,6 +5,7 @@ const util_ts_1 = require("@clipboard-health/util-ts");
 const node_1 = require("@knocklabs/node");
 const createTriggerLogParams_1 = require("./internal/createTriggerLogParams");
 const createTriggerTraceOptions_1 = require("./internal/createTriggerTraceOptions");
+const idempotencyKeyDoNotImportOutsideNotificationsLibrary_1 = require("./internal/idempotencyKeyDoNotImportOutsideNotificationsLibrary");
 const idempotentKnock_1 = require("./internal/idempotentKnock");
 const redact_1 = require("./internal/redact");
 const toTenantSetRequest_1 = require("./internal/toTenantSetRequest");
@@ -71,44 +72,38 @@ class NotificationClient {
      * @returns Promise resolving to either an error or successful response.
      *
      * @example
-     * <embedex source="packages/notifications/examples/notificationClient.ts">
+     * <embedex source="packages/notifications/examples/exampleNotification.service.ts">
      *
      * ```ts
-     * import { NotificationClient, type Span } from "@clipboard-health/notifications";
-     * import { isSuccess } from "@clipboard-health/util-ts";
+     * import { type NotificationClient } from "@clipboard-health/notifications";
      *
-     * const client = new NotificationClient({
-     *   apiKey: "test-api-key",
-     *   logger: {
-     *     info: console.log,
-     *     warn: console.warn,
-     *     error: console.error,
-     *   } as const,
-     *   tracer: {
-     *     trace: <T>(_name: string, _options: unknown, fun: (span?: Span | undefined) => T): T => fun(),
-     *   },
-     * });
+     * import { type ExampleNotificationJobData } from "./exampleNotification.job";
      *
-     * async function triggerNotification(job: { attemptsCount: number }) {
-     *   const result = await client.trigger({
-     *     attempt: (job?.attemptsCount ?? 0) + 1,
-     *     body: {
-     *       recipients: ["user-1"],
-     *       data: { favoriteColor: "blue", secret: "2" },
-     *     },
-     *     expiresAt: new Date(Date.now() + 300_000), // 5 minutes
-     *     idempotencyKey: "welcome-user-4",
-     *     key: "welcome-email",
-     *     keysToRedact: ["secret"],
-     *   });
+     * type ExampleNotificationDo = ExampleNotificationJobData & { attempt: number };
      *
-     *   if (isSuccess(result)) {
-     *     console.log("Notification sent:", result.value.id);
+     * export class ExampleNotificationService {
+     *   constructor(private readonly client: NotificationClient) {}
+     *
+     *   async sendNotification(params: ExampleNotificationDo) {
+     *     const { attempt, expiresAt, idempotencyKey, recipients, workflowKey, workplaceId } = params;
+     *
+     *     // Assume this comes from a database and, for example, are used as template variables...
+     *     const data = { favoriteColor: "blue", secret: "2" };
+     *
+     *     return await this.client.trigger({
+     *       attempt,
+     *       body: {
+     *         recipients,
+     *         data,
+     *         workplaceId,
+     *       },
+     *       expiresAt,
+     *       idempotencyKey,
+     *       workflowKey,
+     *       keysToRedact: ["secret"],
+     *     });
      *   }
      * }
-     *
-     * // eslint-disable-next-line unicorn/prefer-top-level-await
-     * void triggerNotification({ attemptsCount: 0 });
      * ```
      *
      * </embedex>
@@ -121,10 +116,15 @@ class NotificationClient {
                 return validated;
             }
             try {
-                const { key, body, idempotencyKey, keysToRedact = [] } = validated.value;
+                const { body, idempotencyKey, key, keysToRedact = [], workflowKey } = validated.value;
+                const triggerBody = (0, toTriggerBody_1.toTriggerBody)(body);
                 this.logTriggerRequest({ logParams, body, keysToRedact });
-                const response = await this.provider.workflows.trigger(key, (0, toTriggerBody_1.toTriggerBody)(body), {
-                    idempotencyKey,
+                const response = await this.provider.workflows.trigger(
+                /* istanbul ignore next */ workflowKey ?? key, triggerBody, {
+                    idempotencyKey: idempotencyKey instanceof idempotencyKeyDoNotImportOutsideNotificationsLibrary_1.IdempotencyKeyDoNotImportOutsideNotificationsLibrary
+                        ? idempotencyKey.toHash({ workplaceId: params.body.workplaceId })
+                        : /* istanbul ignore next */
+                            idempotencyKey,
                 });
                 const id = response.workflow_run_id;
                 this.logTriggerResponse({ span, response, id, logParams });
@@ -297,7 +297,7 @@ class NotificationClient {
             });
         }
         const now = new Date();
-        if (now > expiresAt) {
+        if (expiresAt instanceof Date && now > expiresAt) {
             return this.createAndLogError({
                 notificationError: {
                     code: exports.ERROR_CODES.expired,

package/src/lib/notificationClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"notificationClient.js","sourceRoot":"","sources":["../../../../../packages/notifications/src/lib/notificationClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"notificationClient.js","sourceRoot":"","sources":["../../../../../packages/notifications/src/lib/notificationClient.ts"],"names":[],"mappings":"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"}

package/src/lib/notificationJobEnqueuer.d.ts

@@ -0,0 +1,96 @@
+import { type BackgroundJobsAdapter } from "@clipboard-health/background-jobs-adapter";
+import { type IdempotencyKey } from "./idempotencyKey";
+import { IdempotencyKeyDoNotImportOutsideNotificationsLibrary } from "./internal/idempotencyKeyDoNotImportOutsideNotificationsLibrary";
+import { type ErrorCode } from "./notificationClient";
+import { type TriggerRequest } from "./types";
+/**
+ * Assuming `NotificationClient` is called from a background job with unchanging recipients, only
+ * the following are retryable.
+ */
+export declare const RETRYABLE_ERRORS: ErrorCode[];
+type EnqueueParameters = Parameters<BackgroundJobsAdapter["enqueue"]>;
+export interface NotificationEnqueueData {
+    idempotencyKey: IdempotencyKey;
+    /** @see {@link TriggerRequest.expiresAt} */
+    expiresAt: TriggerRequest["expiresAt"];
+    /** @see {@link TriggerBody.recipients} */
+    recipients: string[];
+    /** @see {@link TriggerRequest.workflowKey} */
+    workflowKey: string;
+}
+export interface NotificationJobData extends Omit<NotificationEnqueueData, "idempotencyKey"> {
+    idempotencyKey: IdempotencyKeyDoNotImportOutsideNotificationsLibrary;
+}
+interface NotificationJobEnqueuerParams {
+    adapter: BackgroundJobsAdapter;
+}
+export declare class NotificationJobEnqueuer {
+    private readonly adapter;
+    constructor(params: NotificationJobEnqueuerParams);
+    /**
+     * In short: It's important that notification jobs use this method. It enforces best practices to
+     * ensure customers don't receive duplicate or stale notifications.
+     *
+     * @remarks
+     * The following are true:
+     * 1. There is a maximum of MAXIMUM_RECIPIENTS_COUNT recipients per trigger request.
+     * 2. Our notification provider throws if we use the same idempotency key, but the body changes.
+     * 3. We want to be able to query for template variables in jobs so we're getting the most
+     *    up-to-date values.
+     *
+     * Taken together, we need to ensure each job only contains one chunk of recipients so it either
+     * succeeds or fails and retries on its own. If we moved chunking to the
+     * `NotificationClient.trigger` method, for example, the following could happen:
+     * 1. A job with >MAXIMUM_RECIPIENTS_COUNT recipients runs.
+     * 2. The first chunk succeeds, but the second fails because of a transient issue.
+     * 3. The job retries, but a first batch template variable changes in the meantime.
+     *
+     * Now the job will fail indefinitely and the later batches won't get their notifications.
+     *
+     * Even if you're sure you won't have more >MAXIMUM_RECIPIENTS_COUNT recipients, the method
+     * enforces other best practices, like setting `expiresAt` on enqueue instead of calculating it in
+     * your job on each run. Doing this usually means it's always in the future and doesn't help
+     * prevent stale notifications.
+     *
+     * So please, use this method if not for customers, then to save fellow engineers time debugging!
+     *
+     * @example
+     * <embedex source="packages/notifications/examples/enqueueNotificationJob.ts">
+     *
+     * ```ts
+     * import { IdempotencyKey } from "@clipboard-health/notifications";
+     *
+     * import { ExampleNotificationJob } from "./exampleNotification.job";
+     * import { notificationJobEnqueuer } from "./notificationJobEnqueuer";
+     *
+     * async function enqueueNotificationJob() {
+     *   await notificationJobEnqueuer.enqueueOneOrMore(ExampleNotificationJob, {
+     *     // Set expiresAt at enqueue-time so it remains stable across job retries.
+     *     expiresAt: minutesFromNow(60),
+     *     // Set idempotencyKey at enqueue-time so it remains stable across job retries.
+     *     idempotencyKey: new IdempotencyKey({
+     *       resourceId: "event-123",
+     *     }),
+     *     // Set recipients at enqueue-time so they respect our notification provider's limits.
+     *     recipients: ["user-1"],
+     *
+     *     workflowKey: "event-starting-reminder",
+     *
+     *     // Any additional enqueue-time data passed to the job:
+     *     workplaceId: "workplace-123",
+     *   });
+     * }
+     *
+     * // eslint-disable-next-line unicorn/prefer-top-level-await
+     * void enqueueNotificationJob();
+     *
+     * function minutesFromNow(minutes: number) {
+     *   return new Date(Date.now() + minutes * 60_000);
+     * }
+     * ```
+     *
+     * </embedex>
+     */
+    enqueueOneOrMore<TEnqueueData extends NotificationEnqueueData>(handlerClassOrInstance: EnqueueParameters[0], data: TEnqueueData, options?: Omit<EnqueueParameters[2], "idempotencyKey" | "unique">): Promise<void>;
+}
+export {};

package/src/lib/notificationJobEnqueuer.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationJobEnqueuer = exports.RETRYABLE_ERRORS = void 0;
+const background_jobs_adapter_1 = require("@clipboard-health/background-jobs-adapter");
+const chunkRecipients_1 = require("./internal/chunkRecipients");
+const idempotencyKeyDoNotImportOutsideNotificationsLibrary_1 = require("./internal/idempotencyKeyDoNotImportOutsideNotificationsLibrary");
+const notificationClient_1 = require("./notificationClient");
+/**
+ * Assuming `NotificationClient` is called from a background job with unchanging recipients, only
+ * the following are retryable.
+ */
+exports.RETRYABLE_ERRORS = [notificationClient_1.ERROR_CODES.unknown];
+class NotificationJobEnqueuer {
+    adapter;
+    constructor(params) {
+        const { adapter } = params;
+        this.adapter = adapter;
+    }
+    /**
+     * In short: It's important that notification jobs use this method. It enforces best practices to
+     * ensure customers don't receive duplicate or stale notifications.
+     *
+     * @remarks
+     * The following are true:
+     * 1. There is a maximum of MAXIMUM_RECIPIENTS_COUNT recipients per trigger request.
+     * 2. Our notification provider throws if we use the same idempotency key, but the body changes.
+     * 3. We want to be able to query for template variables in jobs so we're getting the most
+     *    up-to-date values.
+     *
+     * Taken together, we need to ensure each job only contains one chunk of recipients so it either
+     * succeeds or fails and retries on its own. If we moved chunking to the
+     * `NotificationClient.trigger` method, for example, the following could happen:
+     * 1. A job with >MAXIMUM_RECIPIENTS_COUNT recipients runs.
+     * 2. The first chunk succeeds, but the second fails because of a transient issue.
+     * 3. The job retries, but a first batch template variable changes in the meantime.
+     *
+     * Now the job will fail indefinitely and the later batches won't get their notifications.
+     *
+     * Even if you're sure you won't have more >MAXIMUM_RECIPIENTS_COUNT recipients, the method
+     * enforces other best practices, like setting `expiresAt` on enqueue instead of calculating it in
+     * your job on each run. Doing this usually means it's always in the future and doesn't help
+     * prevent stale notifications.
+     *
+     * So please, use this method if not for customers, then to save fellow engineers time debugging!
+     *
+     * @example
+     * <embedex source="packages/notifications/examples/enqueueNotificationJob.ts">
+     *
+     * ```ts
+     * import { IdempotencyKey } from "@clipboard-health/notifications";
+     *
+     * import { ExampleNotificationJob } from "./exampleNotification.job";
+     * import { notificationJobEnqueuer } from "./notificationJobEnqueuer";
+     *
+     * async function enqueueNotificationJob() {
+     *   await notificationJobEnqueuer.enqueueOneOrMore(ExampleNotificationJob, {
+     *     // Set expiresAt at enqueue-time so it remains stable across job retries.
+     *     expiresAt: minutesFromNow(60),
+     *     // Set idempotencyKey at enqueue-time so it remains stable across job retries.
+     *     idempotencyKey: new IdempotencyKey({
+     *       resourceId: "event-123",
+     *     }),
+     *     // Set recipients at enqueue-time so they respect our notification provider's limits.
+     *     recipients: ["user-1"],
+     *
+     *     workflowKey: "event-starting-reminder",
+     *
+     *     // Any additional enqueue-time data passed to the job:
+     *     workplaceId: "workplace-123",
+     *   });
+     * }
+     *
+     * // eslint-disable-next-line unicorn/prefer-top-level-await
+     * void enqueueNotificationJob();
+     *
+     * function minutesFromNow(minutes: number) {
+     *   return new Date(Date.now() + minutes * 60_000);
+     * }
+     * ```
+     *
+     * </embedex>
+     */
+    async enqueueOneOrMore(handlerClassOrInstance, data, 
+    // The job's idempotency/unique key is set automatically.
+    options) {
+        await Promise.all((0, chunkRecipients_1.chunkRecipients)({ recipients: data.recipients }).map(async ({ number, recipients }) => {
+            const idempotencyKey = new idempotencyKeyDoNotImportOutsideNotificationsLibrary_1.IdempotencyKeyDoNotImportOutsideNotificationsLibrary({
+                ...data.idempotencyKey,
+                chunk: number,
+                recipients,
+                workflowKey: data.workflowKey,
+            });
+            await this.adapter.enqueue(handlerClassOrInstance, { ...data, recipients, idempotencyKey }, {
+                ...(options ? { ...options } : {}),
+                [background_jobs_adapter_1.ENQUEUE_FIELD_NAMES[this.adapter.implementation].idempotencyKey]: idempotencyKey.toHash({}),
+            });
+        }));
+    }
+}
+exports.NotificationJobEnqueuer = NotificationJobEnqueuer;
+//# sourceMappingURL=notificationJobEnqueuer.js.map

package/src/lib/notificationJobEnqueuer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationJobEnqueuer.js","sourceRoot":"","sources":["../../../../../packages/notifications/src/lib/notificationJobEnqueuer.ts"],"names":[],"mappings":";;;AAAA,uFAGmD;AAGnD,gEAA6D;AAC7D,0IAAuI;AACvI,6DAAmE;AAOnE;;;GAGG;AACU,QAAA,gBAAgB,GAAgB,CAAC,gCAAW,CAAC,OAAO,CAAC,CAAC;AAyBnE,MAAa,uBAAuB;IACjB,OAAO,CAA2C;IAEnE,YAAY,MAAqC;QAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAE3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+DG;IACH,KAAK,CAAC,gBAAgB,CACpB,sBAA4C,EAC5C,IAAkB;IAClB,yDAAyD;IACzD,OAAiE;QAEjE,MAAM,OAAO,CAAC,GAAG,CACf,IAAA,iCAAe,EAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE;YACpF,MAAM,cAAc,GAAG,IAAI,2GAAoD,CAAC;gBAC9E,GAAG,IAAI,CAAC,cAAc;gBACtB,KAAK,EAAE,MAAM;gBACb,UAAU;gBACV,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CACxB,sBAAsB,EACtB,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,EACvC;gBACE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClC,CAAC,6CAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,EAC/D,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;aAC5B,CACF,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AApGD,0DAoGC"}

package/src/lib/types.d.ts

@@ -1,4 +1,5 @@
 import { type Logger } from "@clipboard-health/util-ts";
+import { type IdempotencyKeyDoNotImportOutsideNotificationsLibrary } from "./internal/idempotencyKeyDoNotImportOutsideNotificationsLibrary";
 import { type IdempotentKnock } from "./internal/idempotentKnock";
 export type Tags = Record<string, unknown>;
 export interface TraceOptions {
@@ -123,37 +124,33 @@ export interface TriggerBody {
  * Request parameters for triggering a notification.
  */
 export interface TriggerRequest {
-    /** Notification key. */
+    /** Workflow key.
+     *
+     * @deprecated Use `workflowKey` instead.
+     */
     key: string;
-    /** Notification payload. */
+    /** Workflow key. */
+    workflowKey?: string;
+    /** Trigger payload. */
     body: TriggerBody;
     /**
-     * Key to prevent duplicate requests if provider supports it. It's important it is deterministic
-     * ({@link createIdempotencyKey}) and remains the same across retry logic.
-     *
-     * If you retry a request with the same idempotency key within 24 hours from the original request,
-     * we will return the same response as the original request. Idempotent requests are expected to
-     * be identical. To prevent accidental misuse, the client throws an error when incoming parameters
-     * don't match those from the original request.
-     *
-     * Ensure your idempotency key doesn't prevent recipients from receiving notifications. For
-     * example, if you use the workflow key and the recipient's ID as the idempotency key, but it's
-     * possible the recipient could receive the notification multiple times within the idempotency
-     * key's validity window, the recipient will only receive the first notification.
+     * @see {@link IdempotencyKeyDoNotImportOutsideNotificationsLibrary}
      */
-    idempotencyKey: string;
+    idempotencyKey: string | IdempotencyKeyDoNotImportOutsideNotificationsLibrary;
     /** Array of data keys to redact in logs for privacy. */
     keysToRedact?: string[];
     /**
-     * Expiration timestamp after which the request is dropped. Use this to prevent stale
-     * notifications. If, for example, you're notifying about an event that starts in one hour, you
-     * might set this to one hour from now.
+     * `expiresAt` prevents stale notifications across retries by dropping the request when `now >
+     * expiresAt`. If, for example, you're notifying about an event that starts in one hour, you might
+     * set this to one hour from now.
+     *
+     * If you are not retrying or your notification is never stale, set it to `false`.
      *
-     * If you're triggering from a background job, don't set this at the call site! Set it when you
+     * If you're triggering from a background job, don't set this at the call site, set it when you
      * enqueue the job. Otherwise, it gets updated each time the job retries, will always be in the
      * future, and won't prevent stale notifications.
      */
-    expiresAt: Date;
+    expiresAt: Date | false;
     /** Attempt number for tracing. */
     attempt: number;
 }

package/src/lib/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/notifications/src/lib/types.ts"],"names":[],"mappings":";;;AA2Ca,QAAA,gBAAgB,GAAG,CAAC,SAAS,EAAE,KAAK,CAAU,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/notifications/src/lib/types.ts"],"names":[],"mappings":";;;AA4Ca,QAAA,gBAAgB,GAAG,CAAC,SAAS,EAAE,KAAK,CAAU,CAAC"}

package/src/lib/chunkRecipients.d.ts

@@ -1,7 +0,0 @@
-export declare function chunkRecipients(params: {
-    idempotencyKey: string;
-    recipients: string[];
-}): Array<{
-    idempotencyKey: string;
-    recipients: string[];
-}>;

package/src/lib/chunkRecipients.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.chunkRecipients = chunkRecipients;
-const util_ts_1 = require("@clipboard-health/util-ts");
-const notificationClient_1 = require("./notificationClient");
-function chunkRecipients(params) {
-    const { recipients, idempotencyKey } = params;
-    if (recipients.length === 0) {
-        return [{ idempotencyKey, recipients: [] }];
-    }
-    const idChunks = (0, util_ts_1.chunk)(recipients, notificationClient_1.MAXIMUM_RECIPIENTS_COUNT);
-    const singleChunk = idChunks.length === 1;
-    return idChunks.map((ids, index) => ({
-        idempotencyKey: singleChunk ? idempotencyKey : `${idempotencyKey}-chunk-${index + 1}`,
-        recipients: ids,
-    }));
-}
-//# sourceMappingURL=chunkRecipients.js.map

package/src/lib/chunkRecipients.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunkRecipients.js","sourceRoot":"","sources":["../../../../../packages/notifications/src/lib/chunkRecipients.ts"],"names":[],"mappings":";;AAIA,0CAgBC;AApBD,uDAAkD;AAElD,6DAAgE;AAEhE,SAAgB,eAAe,CAAC,MAG/B;IACC,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAE9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,eAAK,EAAC,UAAU,EAAE,6CAAwB,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,UAAU,KAAK,GAAG,CAAC,EAAE;QACrF,UAAU,EAAE,GAAG;KAChB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/src/lib/createIdempotencyKey.d.ts

@@ -1,17 +0,0 @@
-export declare const MAX_IDEMPOTENCY_KEY_LENGTH = 255;
-/**
- * Creates a deterministic hash for use as an idempotency key.
- *
- * The function normalizes `value` (using a stable JSON.stringify for non-string values), generates
- * a SHA-256 hash, prepends the workflow key, and truncates the result to MAX_IDEMPOTENCY_KEY_LENGTH
- * maximum.
- *
- * @param params.key - Workflow key to prepend to the hash.
- * @param params.value - Value to hash (string, string[], object, etc.).
- *
- * @returns A hash string prefixed with the workflow key.
- */
-export declare function createIdempotencyKey(params: {
-    key: string;
-    value: unknown;
-}): string;

package/src/lib/createIdempotencyKey.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_IDEMPOTENCY_KEY_LENGTH = void 0;
-exports.createIdempotencyKey = createIdempotencyKey;
-const tslib_1 = require("tslib");
-const node_crypto_1 = require("node:crypto");
-const fast_json_stable_stringify_1 = tslib_1.__importDefault(require("fast-json-stable-stringify"));
-exports.MAX_IDEMPOTENCY_KEY_LENGTH = 255;
-/**
- * Creates a deterministic hash for use as an idempotency key.
- *
- * The function normalizes `value` (using a stable JSON.stringify for non-string values), generates
- * a SHA-256 hash, prepends the workflow key, and truncates the result to MAX_IDEMPOTENCY_KEY_LENGTH
- * maximum.
- *
- * @param params.key - Workflow key to prepend to the hash.
- * @param params.value - Value to hash (string, string[], object, etc.).
- *
- * @returns A hash string prefixed with the workflow key.
- */
-function createIdempotencyKey(params) {
-    const { key, value } = params;
-    const hash = (0, node_crypto_1.createHash)("sha256")
-        .update(typeof value === "string" ? value : (0, fast_json_stable_stringify_1.default)(value))
-        .digest("hex");
-    return `${key}:${hash}`.slice(0, exports.MAX_IDEMPOTENCY_KEY_LENGTH);
-}
-//# sourceMappingURL=createIdempotencyKey.js.map

package/src/lib/createIdempotencyKey.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createIdempotencyKey.js","sourceRoot":"","sources":["../../../../../packages/notifications/src/lib/createIdempotencyKey.ts"],"names":[],"mappings":";;;AAkBA,oDAQC;;AA1BD,6CAAyC;AAEzC,oGAAmD;AAEtC,QAAA,0BAA0B,GAAG,GAAG,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,SAAgB,oBAAoB,CAAC,MAAuC;IAC1E,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAE9B,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,oCAAS,EAAC,KAAK,CAAC,CAAC;SAC5D,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjB,OAAO,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,kCAA0B,CAAC,CAAC;AAC/D,CAAC"}