@visulima/notification 0.0.1 → 1.0.0-alpha.2

package/dist/providers/push/expo/index.js

@@ -0,0 +1 @@
+import{default as r}from"../../../packem_shared/expoProvider-CXq101FD.js";export{r as expoProvider};

package/dist/providers/push/fcm/index.d.ts

@@ -0,0 +1,26 @@
+import { M as MaybePromise, d as BaseConfig, P as PushPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface FcmConfig extends BaseConfig {
+  /**
+  * A static OAuth2 access token. Prefer {@link FcmConfig.getAccessToken} for tokens
+  * that expire. One of `accessToken` / `getAccessToken` is required.
+  */
+  accessToken?: string;
+  /** Override the API base URL. */
+  endpoint?: string;
+  /**
+  * Returns a fresh OAuth2 access token. Lets you plug in `google-auth-library` /
+  * `firebase-admin` without bundling Google's SDK or `node:crypto` — keeping the
+  * provider edge-safe.
+  */
+  getAccessToken?: () => MaybePromise<string>;
+  /** Firebase project id. Required. */
+  projectId: string;
+}
+/**
+* Firebase Cloud Messaging provider (HTTP v1). Edge-safe — you supply the OAuth2 token
+* (static or via `getAccessToken`), so no `node:crypto`/Google SDK is bundled.
+* @see https://firebase.google.com/docs/cloud-messaging/send-message
+*/
+declare const fcmProvider: ProviderFactory<FcmConfig, PushPayload>;
+export { type FcmConfig, fcmProvider };

package/dist/providers/push/fcm/index.js

@@ -0,0 +1 @@
+import{default as f}from"../../../packem_shared/fcmProvider-WdJGZ55l.js";export{f as fcmProvider};

package/dist/providers/push/web-push/index.d.ts

@@ -0,0 +1,36 @@
+import { d as BaseConfig, P as PushPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+/**
+* A W3C Push API subscription. The `to` field of a push payload carries one of these
+* (as an object, or its JSON string form) when targeting the web-push provider.
+*/
+interface PushSubscriptionLike {
+  /** The push service endpoint URL the encrypted payload is delivered to. */
+  endpoint: string;
+  /** The subscription's client public key (`p256dh`) and auth secret (`auth`), base64url. */
+  keys: {
+    auth: string;
+    p256dh: string;
+  };
+}
+interface WebPushConfig extends BaseConfig {
+  /** Time-to-live in seconds the push service should retain the message (default 2419200). */
+  ttl?: number;
+  /** Default delivery urgency hint (`very-low` | `low` | `normal` | `high`). */
+  urgency?: "high" | "low" | "normal" | "very-low";
+  /** Application server private VAPID key (base64url, raw P-256 scalar `d`). */
+  vapidPrivateKey: string;
+  /** Application server public VAPID key (base64url, uncompressed P-256 point). */
+  vapidPublicKey: string;
+  /** VAPID `sub` claim — a `mailto:` or `https:` contact for the app server. */
+  vapidSubject: string;
+}
+/**
+* Web Push provider (VAPID + RFC 8291 `aes128gcm`). Fully edge-safe — JWT signing and
+* payload encryption run on Web Crypto (ECDSA/ECDH P-256, HKDF, AES-GCM); no `node:*`.
+* The `to` target carries a Push API subscription (object or its JSON string form).
+* @see https://datatracker.ietf.org/doc/html/rfc8291
+* @see https://datatracker.ietf.org/doc/html/rfc8292
+*/
+declare const webPushProvider: ProviderFactory<WebPushConfig, PushPayload>;
+export { type PushSubscriptionLike, type WebPushConfig, webPushProvider };

package/dist/providers/push/web-push/index.js

@@ -0,0 +1 @@
+import{default as o}from"../../../packem_shared/webPushProvider-B962RwsA.js";export{o as webPushProvider};

package/dist/providers/roundrobin/index.d.ts

@@ -0,0 +1,17 @@
+import { B as BaseNotificationPayload } from "../../packem_shared/types.d-GUzX1jTk.js";
+import { P as Provider } from "../../packem_shared/provider.d-BQAGriz6.js";
+interface RoundRobinConfig {
+  /** When true, falls through to the next provider on failure (default true). */
+  failover?: boolean;
+  /** Provider id reported on results (default `"roundrobin"`). */
+  id?: string;
+}
+/**
+* Wraps several same-channel providers and distributes sends across them in rotation.
+* Optionally falls over to the next provider on failure.
+* @param providers The providers to balance across.
+* @param config Optional config.
+* @returns A composite provider.
+*/
+declare const roundRobinProvider: <PayloadT extends BaseNotificationPayload>(providers: Provider<unknown, PayloadT>[], config?: RoundRobinConfig) => Provider<unknown, PayloadT>;
+export { type RoundRobinConfig, roundRobinProvider };

package/dist/providers/roundrobin/index.js

@@ -0,0 +1 @@
+import{roundRobinProvider as d}from"../../packem_shared/roundRobinProvider-BetXJUUm.js";export{d as roundRobinProvider};

package/dist/providers/sms/messagebird/index.d.ts

@@ -0,0 +1,16 @@
+import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface MessageBirdConfig extends BaseConfig {
+  /** MessageBird (Bird) access key. */
+  accessKey: string;
+  /** Override the API base URL. */
+  endpoint?: string;
+  /** Default originator (sender id or number). */
+  from?: string;
+}
+/**
+* MessageBird (Bird) SMS provider. Sends to many recipients in one call.
+* @see https://docs.bird.com/api/sms-messaging
+*/
+declare const messageBirdProvider: ProviderFactory<MessageBirdConfig, SmsPayload>;
+export { type MessageBirdConfig, messageBirdProvider };

package/dist/providers/sms/messagebird/index.js

@@ -0,0 +1 @@
+import{default as a}from"../../../packem_shared/messageBirdProvider-CHUFB0hd.js";export{a as messageBirdProvider};

package/dist/providers/sms/plivo/index.d.ts

@@ -0,0 +1,18 @@
+import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface PlivoConfig extends BaseConfig {
+  /** Plivo Auth ID. */
+  authId: string;
+  /** Plivo Auth Token. */
+  authToken: string;
+  /** Override the API base URL. */
+  endpoint?: string;
+  /** Default source number or sender id. */
+  from?: string;
+}
+/**
+* Plivo SMS provider. Sends to many recipients in one call (`dst` joined by `<`).
+* @see https://www.plivo.com/docs/sms/api/message
+*/
+declare const plivoProvider: ProviderFactory<PlivoConfig, SmsPayload>;
+export { type PlivoConfig, plivoProvider };

package/dist/providers/sms/plivo/index.js

@@ -0,0 +1 @@
+import{default as e}from"../../../packem_shared/plivoProvider-CIOl6DWw.js";export{e as plivoProvider};

package/dist/providers/sms/sns/index.d.ts

@@ -0,0 +1,21 @@
+import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface SnsConfig extends BaseConfig {
+  /** AWS access key id. */
+  accessKeyId: string;
+  /** Override the SNS endpoint (defaults to `https://sns.{region}.amazonaws.com/`). */
+  endpoint?: string;
+  /** AWS region (defaults to `us-east-1`). */
+  region?: string;
+  /** AWS secret access key. */
+  secretAccessKey: string;
+  /** Optional STS session token for temporary credentials. */
+  sessionToken?: string;
+}
+/**
+* AWS SNS SMS provider. Edge-safe — signs the `Publish` action with Signature V4
+* computed entirely via Web Crypto (HMAC-SHA256 + SHA-256), no `node:crypto`.
+* @see https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
+*/
+declare const snsProvider: ProviderFactory<SnsConfig, SmsPayload>;
+export { type SnsConfig, snsProvider };

package/dist/providers/sms/sns/index.js

@@ -0,0 +1 @@
+import{default as o}from"../../../packem_shared/snsProvider-KCciJ-nj.js";export{o as snsProvider};

package/dist/providers/sms/telnyx/index.d.ts

@@ -0,0 +1,18 @@
+import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface TelnyxConfig extends BaseConfig {
+  /** Telnyx API key (v2). */
+  apiKey: string;
+  /** Override the API base URL. */
+  endpoint?: string;
+  /** Default sender phone number. */
+  from?: string;
+  /** Messaging profile id (alternative to `from`). */
+  messagingProfileId?: string;
+}
+/**
+* Telnyx SMS/MMS provider (v2 API). Edge-safe — `fetch` + Bearer auth.
+* @see https://developers.telnyx.com/api/messaging/send-message
+*/
+declare const telnyxProvider: ProviderFactory<TelnyxConfig, SmsPayload>;
+export { type TelnyxConfig, telnyxProvider };

package/dist/providers/sms/telnyx/index.js

@@ -0,0 +1 @@
+import{default as o}from"../../../packem_shared/telnyxProvider-C8TMPir1.js";export{o as telnyxProvider};

package/dist/providers/sms/twilio/index.d.ts

@@ -0,0 +1,20 @@
+import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface TwilioConfig extends BaseConfig {
+  /** Twilio Account SID. */
+  accountSid: string;
+  /** Twilio Auth Token. */
+  authToken: string;
+  /** Override the API base URL. */
+  endpoint?: string;
+  /** Default sender phone number or Messaging Service SID. */
+  from?: string;
+  /** Use `MessagingServiceSid` instead of `From` when `from` looks like a service SID. */
+  messagingServiceSid?: string;
+}
+/**
+* Twilio SMS/MMS provider. Edge-safe — uses `fetch` + Basic auth, no Node built-ins.
+* @see https://www.twilio.com/docs/sms/api/message-resource
+*/
+declare const twilioProvider: ProviderFactory<TwilioConfig, SmsPayload>;
+export { type TwilioConfig, twilioProvider };

package/dist/providers/sms/twilio/index.js

@@ -0,0 +1 @@
+import{default as e}from"../../../packem_shared/twilioProvider-BxI0e6LX.js";export{e as twilioProvider};

package/dist/providers/sms/vonage/index.d.ts

@@ -0,0 +1,18 @@
+import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface VonageConfig extends BaseConfig {
+  /** Vonage (Nexmo) API key. */
+  apiKey: string;
+  /** Vonage (Nexmo) API secret. */
+  apiSecret: string;
+  /** Override the API base URL. */
+  endpoint?: string;
+  /** Default sender id or phone number. */
+  from?: string;
+}
+/**
+* Vonage (Nexmo) SMS provider. Edge-safe — `fetch` + form auth.
+* @see https://developer.vonage.com/en/api/sms
+*/
+declare const vonageProvider: ProviderFactory<VonageConfig, SmsPayload>;
+export { type VonageConfig, vonageProvider };

package/dist/providers/sms/vonage/index.js

@@ -0,0 +1 @@
+import{default as r}from"../../../packem_shared/vonageProvider-BF76ca89.js";export{r as vonageProvider};

package/dist/providers/webhook/index.d.ts

@@ -0,0 +1,18 @@
+import { d as BaseConfig, W as WebhookPayload } from "../../packem_shared/types.d-GUzX1jTk.js";
+import { P as Provider } from "../../packem_shared/provider.d-BQAGriz6.js";
+interface WebhookConfig extends BaseConfig {
+  /** Default headers merged into every request. */
+  headers?: Record<string, string>;
+  /** Default HTTP method (default POST). */
+  method?: string;
+  /** Default target URL (overridable per payload). */
+  url?: string;
+}
+/**
+* Generic outbound webhook provider. Edge-safe — `fetch` only. Useful for custom
+* integrations and as a fan-out sink.
+* @param config Optional config.
+* @returns A webhook-channel provider.
+*/
+declare const webhookProvider: (config?: WebhookConfig) => Provider<WebhookConfig, WebhookPayload>;
+export { type WebhookConfig, webhookProvider };

package/dist/providers/webhook/index.js

@@ -0,0 +1 @@
+import{webhookProvider as e}from"../../packem_shared/webhookProvider-BALSb2pc.js";export{e as webhookProvider};

package/dist/queue/bullmq-queue.d.ts

@@ -0,0 +1,58 @@
+import { a as NotificationMessage } from "../packem_shared/notification.d-DFCVTods.js";
+import { Q as QueueJob, N as NotificationQueue } from "../packem_shared/types.d-67TogK4k.js";
+import "../packem_shared/types.d-CximoA8M.js";
+import "../packem_shared/types.d-GUzX1jTk.js";
+import "../packem_shared/provider.d-BQAGriz6.js";
+/**
+* A BullMQ job, narrowed to the members this adapter reads.
+*/
+interface BullmqJobLike {
+  attemptsMade: number;
+  data: unknown;
+  id?: string;
+  moveToDelayed: (timestamp: number) => Promise<unknown>;
+  remove: () => Promise<unknown>;
+}
+/**
+* The subset of a [BullMQ](https://docs.bullmq.io/) `Queue` this adapter uses. Typed structurally so
+* the `bullmq` optional peer is never imported — pass a real `Queue` instance, which satisfies this.
+*/
+interface BullmqQueueLike {
+  add: (name: string, data: unknown, options?: {
+    delay?: number;
+  }) => Promise<{
+    id?: string;
+  }>;
+  count: () => Promise<number>;
+  getJob: (id: string) => Promise<BullmqJobLike | undefined>;
+  getNextJob: (token: string) => Promise<BullmqJobLike | undefined>;
+}
+/**
+* A {@link NotificationQueue} backed by [BullMQ](https://docs.bullmq.io/) (Redis).
+*
+* BullMQ is push-based: jobs are normally consumed by a BullMQ `Worker`. This adapter maps the
+* pull-based reserve/ack model onto BullMQ's `getNextJob`-style primitives so it composes with the
+* notification `QueueWorker`. Pass an already-configured `Queue` instance — `bullmq` is an optional
+* peer dependency and is never instantiated here.
+*
+* Runtime: NODE ONLY (requires a Redis connection). Not Cloudflare Workers compatible.
+*/
+declare class BullMqQueue implements NotificationQueue {
+  #private;
+  constructor(queue: BullmqQueueLike, jobName?: string);
+  enqueue(message: NotificationMessage, options?: {
+    scheduledAt?: number;
+  }): Promise<string>;
+  reserve(): Promise<QueueJob | undefined>;
+  ack(id: string): Promise<void>;
+  retry(id: string, delayMs?: number): Promise<void>;
+  size(): Promise<number>;
+}
+/**
+* Convenience factory for {@link BullMqQueue}.
+* @param queue A configured BullMQ `Queue` instance (optional peer).
+* @param jobName The name jobs are enqueued under.
+* @returns A new {@link BullMqQueue}.
+*/
+declare const createBullMqQueue: (queue: BullmqQueueLike, jobName?: string) => BullMqQueue;
+export { BullMqQueue, type BullmqJobLike, type BullmqQueueLike, createBullMqQueue };

package/dist/queue/bullmq-queue.js

@@ -0,0 +1 @@
+class s{#t;#e;constructor(e,t="notification"){this.#t=e,this.#e=t}async enqueue(e,t){let a;return t?.scheduledAt!==void 0&&(a=Math.max(0,t.scheduledAt-Date.now())),(await this.#t.add(this.#e,e,a===void 0?void 0:{delay:a})).id??""}async reserve(){const e=`notification-${String(Date.now())}`,t=await this.#t.getNextJob(e);if(t)return{attempts:t.attemptsMade+1,id:t.id??"",message:t.data,scheduledAt:0}}async ack(e){const t=await this.#t.getJob(e);t&&await t.remove()}async retry(e,t=0){const a=await this.#t.getJob(e);a&&await a.moveToDelayed(Date.now()+t)}async size(){return await this.#t.count()}}const n=(i,e)=>new s(i,e);export{s as BullMqQueue,n as createBullMqQueue};

package/dist/queue/index.d.ts

@@ -0,0 +1,50 @@
+export { BullMqQueue, createBullMqQueue } from "./bullmq-queue.js";
+import { a as NotificationMessage, N as Notification } from "../packem_shared/notification.d-DFCVTods.js";
+import { Q as QueueJob, N as NotificationQueue } from "../packem_shared/types.d-67TogK4k.js";
+export { PgBossQueue, type PgBossQueueOptions, createPgBossQueue } from "./pg-boss-queue.js";
+export { SqsQueue, type SqsQueueOptions, createSqsQueue } from "./sqs-queue.js";
+import { c as Receipt } from "../packem_shared/types.d-GUzX1jTk.js";
+import "../packem_shared/types.d-CximoA8M.js";
+import "../packem_shared/provider.d-BQAGriz6.js";
+/**
+* In-process {@link NotificationQueue}. Suitable for single-instance apps, tests and the
+* default worker; swap for the unstorage/BullMQ adapters for durability.
+*/
+declare class MemoryQueue implements NotificationQueue {
+  #private;
+  enqueue(message: NotificationMessage, options?: {
+    scheduledAt?: number;
+  }): string;
+  reserve(): QueueJob | undefined;
+  ack(id: string): void;
+  retry(id: string, delayMs?: number): void;
+  size(): number;
+}
+interface QueueWorkerOptions {
+  /** Backoff in ms given the attempt count (default exponential: 1s, 2s, 4s...). */
+  backoff?: (attempt: number) => number;
+  /** Maximum delivery attempts before a job is dropped (default 5). */
+  maxAttempts?: number;
+  /** Called when a job is dropped after exhausting attempts. */
+  onDrop?: (job: QueueJob, receipts: Receipt[]) => void;
+  /** Poll interval in ms when the queue is empty (default 1000). */
+  pollInterval?: number;
+}
+interface QueueWorker {
+  /** Processes all currently-due jobs, then resolves. */
+  drain: () => Promise<void>;
+  /** Starts the polling loop. */
+  start: () => void;
+  /** Stops the polling loop. */
+  stop: () => void;
+}
+/**
+* Creates a worker that reserves jobs from a queue and delivers them via a
+* {@link Notification} facade, retrying with backoff and dropping after `maxAttempts`.
+* @param queue The queue to drain.
+* @param notification The facade used to deliver messages.
+* @param options Behaviour tuning (max attempts, backoff curve, poll interval, drop hook).
+* @returns A controllable worker.
+*/
+declare const createQueueWorker: (queue: NotificationQueue, notification: Notification, options?: QueueWorkerOptions) => QueueWorker;
+export { MemoryQueue, type NotificationQueue, type QueueJob, type QueueWorker, type QueueWorkerOptions, createQueueWorker };

package/dist/queue/index.js

@@ -0,0 +1 @@
+import{BullMqQueue as r,createBullMqQueue as o}from"./bullmq-queue.js";import{default as Q}from"../packem_shared/MemoryQueue-CXgWoZoY.js";import{PgBossQueue as a,createPgBossQueue as f}from"./pg-boss-queue.js";import{SqsQueue as l,createSqsQueue as p}from"./sqs-queue.js";import{createQueueWorker as c}from"../packem_shared/createQueueWorker-DjQBxjXc.js";export{r as BullMqQueue,Q as MemoryQueue,a as PgBossQueue,l as SqsQueue,o as createBullMqQueue,f as createPgBossQueue,c as createQueueWorker,p as createSqsQueue};

package/dist/queue/pg-boss-queue.d.ts

@@ -0,0 +1,66 @@
+import { a as NotificationMessage } from "../packem_shared/notification.d-DFCVTods.js";
+import { Q as QueueJob, N as NotificationQueue } from "../packem_shared/types.d-67TogK4k.js";
+import "../packem_shared/types.d-CximoA8M.js";
+import "../packem_shared/types.d-GUzX1jTk.js";
+import "../packem_shared/provider.d-BQAGriz6.js";
+/**
+* A pg-boss job fetched with `includeMetadata`, narrowed to the members this adapter reads.
+*/
+interface PgBossJobLike {
+  data: unknown;
+  id: string;
+  /** pg-boss retry count (present when fetched with `includeMetadata`). */
+  retryCount?: number;
+}
+/**
+* The subset of a [pg-boss](https://github.com/timgit/pg-boss) instance this adapter uses (v10 API).
+* Typed structurally so the `pg-boss` optional peer is never imported — pass a started `PgBoss` instance.
+*/
+interface PgBossLike {
+  complete: (name: string, id: string) => Promise<unknown>;
+  fail: (name: string, id: string) => Promise<unknown>;
+  fetch: (name: string, options?: {
+    batchSize?: number;
+    includeMetadata?: boolean;
+  }) => Promise<PgBossJobLike[] | PgBossJobLike | null>;
+  getQueueSize: (name: string) => Promise<number>;
+  send: (name: string, data: object, options?: {
+    startAfter?: Date;
+  }) => Promise<null | string>;
+}
+/**
+* Options for {@link createPgBossQueue}.
+*/
+interface PgBossQueueOptions {
+  /** The pg-boss queue name. */
+  queueName: string;
+}
+/**
+* A {@link NotificationQueue} backed by [pg-boss](https://github.com/timgit/pg-boss) (Postgres, v10 API).
+*
+* Pass a started pg-boss instance — `pg-boss` is an optional peer dependency and is never started here.
+* `reserve` uses `fetch` with `includeMetadata`, so the job's `attempts` reflects pg-boss's own
+* `retryCount`. `retry` calls `fail`, so the retry delay is governed by the queue's pg-boss retry policy
+* rather than the `delayMs` argument.
+*
+* Runtime: NODE ONLY (requires a Postgres connection). Not Cloudflare Workers compatible.
+*/
+declare class PgBossQueue implements NotificationQueue {
+  #private;
+  constructor(boss: PgBossLike, options: PgBossQueueOptions);
+  enqueue(message: NotificationMessage, options?: {
+    scheduledAt?: number;
+  }): Promise<string>;
+  reserve(): Promise<QueueJob | undefined>;
+  ack(id: string): Promise<void>;
+  retry(id: string): Promise<void>;
+  size(): Promise<number>;
+}
+/**
+* Convenience factory for {@link PgBossQueue}.
+* @param boss A started pg-boss instance (optional peer).
+* @param options Queue options. See {@link PgBossQueueOptions}.
+* @returns A new {@link PgBossQueue}.
+*/
+declare const createPgBossQueue: (boss: PgBossLike, options: PgBossQueueOptions) => PgBossQueue;
+export { type PgBossJobLike, type PgBossLike, PgBossQueue, PgBossQueueOptions, createPgBossQueue };

package/dist/queue/pg-boss-queue.js

@@ -0,0 +1 @@
+class i{#e;#t;constructor(e,t){this.#e=e,this.#t=t.queueName}async enqueue(e,t){const a=t?.scheduledAt===void 0?void 0:new Date(t.scheduledAt);return await this.#e.send(this.#t,e,a===void 0?{}:{startAfter:a})??""}async reserve(){const e=await this.#e.fetch(this.#t,{batchSize:1,includeMetadata:!0}),t=Array.isArray(e)?e[0]:e;if(t)return{attempts:t.retryCount??0,id:t.id,message:t.data,scheduledAt:0}}async ack(e){await this.#e.complete(this.#t,e)}async retry(e){await this.#e.fail(this.#t,e)}async size(){return await this.#e.getQueueSize(this.#t)}}const r=(s,e)=>new i(s,e);export{i as PgBossQueue,r as createPgBossQueue};

package/dist/queue/sqs-queue.d.ts

@@ -0,0 +1,91 @@
+import { a as NotificationMessage } from "../packem_shared/notification.d-DFCVTods.js";
+import { Q as QueueJob, N as NotificationQueue } from "../packem_shared/types.d-67TogK4k.js";
+import "../packem_shared/types.d-CximoA8M.js";
+import "../packem_shared/types.d-GUzX1jTk.js";
+import "../packem_shared/provider.d-BQAGriz6.js";
+/**
+* A single SQS message, narrowed to the members this adapter reads.
+*/
+interface SqsMessageLike {
+  Attributes?: Record<string, string>;
+  Body?: string;
+  ReceiptHandle?: string;
+}
+/**
+* The subset of the high-level `@aws-sdk/client-sqs` `SQS` operations this adapter uses. The `SQS`
+* class exposes these operation methods directly (unlike the command-based `SQSClient.send`), keeping
+* the adapter mockable with plain method stubs and avoiding an import of the optional peer.
+*/
+interface SqsClientLike {
+  changeMessageVisibility: (input: {
+    QueueUrl: string;
+    ReceiptHandle: string;
+    VisibilityTimeout: number;
+  }) => Promise<unknown>;
+  deleteMessage: (input: {
+    QueueUrl: string;
+    ReceiptHandle: string;
+  }) => Promise<unknown>;
+  getQueueAttributes: (input: {
+    AttributeNames: string[];
+    QueueUrl: string;
+  }) => Promise<{
+    Attributes?: Record<string, string>;
+  }>;
+  receiveMessage: (input: {
+    AttributeNames?: string[];
+    MaxNumberOfMessages?: number;
+    QueueUrl: string;
+    VisibilityTimeout?: number;
+    WaitTimeSeconds?: number;
+  }) => Promise<{
+    Messages?: SqsMessageLike[];
+  }>;
+  sendMessage: (input: {
+    DelaySeconds?: number;
+    MessageBody: string;
+    QueueUrl: string;
+  }) => Promise<{
+    MessageId?: string;
+  }>;
+}
+/**
+* Options for {@link createSqsQueue}.
+*/
+interface SqsQueueOptions {
+  /** The SQS queue URL. */
+  queueUrl: string;
+  /** Visibility timeout (seconds) applied when reserving a message (default 30). */
+  visibilityTimeout?: number;
+  /** Long-poll wait time (seconds) for `reserve` (default 0). */
+  waitTimeSeconds?: number;
+}
+/**
+* A {@link NotificationQueue} backed by Amazon SQS, which maps natively onto the reserve/ack/retry
+* model (ReceiveMessage / DeleteMessage / ChangeMessageVisibility).
+*
+* Pass an `@aws-sdk/client-sqs` `SQS` instance — it is an optional peer dependency and is never
+* constructed here. The reserved job `id` is the SQS `ReceiptHandle`. `scheduledAt` is honored up to
+* the SQS 15-minute delay limit.
+*
+* Runtime: NODE ONLY (depends on the AWS SDK). Not Cloudflare Workers compatible.
+*/
+declare class SqsQueue implements NotificationQueue {
+  #private;
+  constructor(client: SqsClientLike, options: SqsQueueOptions);
+  enqueue(message: NotificationMessage, options?: {
+    scheduledAt?: number;
+  }): Promise<string>;
+  reserve(): Promise<QueueJob | undefined>;
+  ack(id: string): Promise<void>;
+  retry(id: string, delayMs?: number): Promise<void>;
+  size(): Promise<number>;
+}
+/**
+* Convenience factory for {@link SqsQueue}.
+* @param client An `@aws-sdk/client-sqs` `SQS` instance (optional peer).
+* @param options Queue options. See {@link SqsQueueOptions}.
+* @returns A new {@link SqsQueue}.
+*/
+declare const createSqsQueue: (client: SqsClientLike, options: SqsQueueOptions) => SqsQueue;
+export { type SqsClientLike, type SqsMessageLike, SqsQueue, SqsQueueOptions, createSqsQueue };

package/dist/queue/sqs-queue.js

@@ -0,0 +1 @@
+const a="ApproximateNumberOfMessages",r="ApproximateNumberOfMessagesNotVisible",u=(s,e)=>{if(s===void 0)return 0;const t=Math.ceil((s-e)/1e3);return Math.max(0,t)};class n{#e;#t;#s;#i;constructor(e,t){this.#e=e,this.#t=t.queueUrl,this.#s=t.visibilityTimeout??30,this.#i=t.waitTimeSeconds??0}async enqueue(e,t){const i=u(t?.scheduledAt,Date.now());if(i>900)throw new RangeError(`SQS supports a maximum scheduling delay of ${String(900)}s (15 minutes); use a scheduler for longer delays`);return(await this.#e.sendMessage({DelaySeconds:i,MessageBody:JSON.stringify(e),QueueUrl:this.#t})).MessageId??""}async reserve(){const e=(await this.#e.receiveMessage({AttributeNames:["ApproximateReceiveCount"],MaxNumberOfMessages:1,QueueUrl:this.#t,VisibilityTimeout:this.#s,WaitTimeSeconds:this.#i})).Messages?.[0];if(!e?.ReceiptHandle)return;const t=Number(e.Attributes?.ApproximateReceiveCount??"1");let i;try{i=JSON.parse(e.Body??"{}")}catch{await this.#e.deleteMessage({QueueUrl:this.#t,ReceiptHandle:e.ReceiptHandle});return}return{attempts:Math.max(0,t-1),id:e.ReceiptHandle,message:i,scheduledAt:0}}async ack(e){await this.#e.deleteMessage({QueueUrl:this.#t,ReceiptHandle:e})}async retry(e,t=0){await this.#e.changeMessageVisibility({QueueUrl:this.#t,ReceiptHandle:e,VisibilityTimeout:Math.min(900,Math.max(0,Math.ceil(t/1e3)))})}async size(){const e=await this.#e.getQueueAttributes({AttributeNames:[a,r],QueueUrl:this.#t});return Number(e.Attributes?.[a]??0)+Number(e.Attributes?.[r]??0)}}const c=(s,e)=>new n(s,e);export{n as SqsQueue,c as createSqsQueue};

package/dist/queue/unstorage-queue.d.ts

@@ -0,0 +1,30 @@
+import { S as Storage } from "../packem_shared/unstorage.DqlWKU2I.d-CogP3Etw.js";
+import { a as NotificationMessage } from "../packem_shared/notification.d-DFCVTods.js";
+import { Q as QueueJob, N as NotificationQueue } from "../packem_shared/types.d-67TogK4k.js";
+import "../packem_shared/types.d-CximoA8M.js";
+import "../packem_shared/types.d-GUzX1jTk.js";
+import "../packem_shared/provider.d-BQAGriz6.js";
+/**
+* A {@link NotificationQueue} backed by an [unstorage](https://unstorage.unjs.io) driver,
+* giving durable, multi-backend persistence (Redis, filesystem, KV, ...). `unstorage` is
+* an optional peer dependency — pass a configured `Storage` instance.
+*/
+declare class UnstorageQueue implements NotificationQueue {
+  #private;
+  constructor(storage: Storage, prefix?: string);
+  enqueue(message: NotificationMessage, options?: {
+    scheduledAt?: number;
+  }): Promise<string>;
+  reserve(): Promise<QueueJob | undefined>;
+  ack(id: string): Promise<void>;
+  retry(id: string, delayMs?: number): Promise<void>;
+  size(): Promise<number>;
+}
+/**
+* Convenience factory for {@link UnstorageQueue}.
+* @param storage A configured unstorage `Storage` instance.
+* @param prefix Key prefix under which jobs are stored.
+* @returns A new {@link UnstorageQueue}.
+*/
+declare const createUnstorageQueue: (storage: Storage, prefix?: string) => UnstorageQueue;
+export { UnstorageQueue, createUnstorageQueue };

package/dist/queue/unstorage-queue.js

@@ -0,0 +1 @@
+import{n as h}from"../packem_shared/id-C_FRCsUM.js";class c{#t;#e;constructor(t,s="notification:queue"){this.#t=t,this.#e=s}async enqueue(t,s){const e={attempts:0,id:h("job"),message:t,scheduledAt:s?.scheduledAt};return await this.#t.setItem(this.#s(e.id),e),await this.#n(e.id),e.id}async reserve(){const t=Date.now(),s=await this.#i();for(const e of s){const i=await this.#t.getItem(this.#s(e));if(i&&(i.scheduledAt??0)<=t)return i.attempts+=1,await this.#t.setItem(this.#s(e),i),await this.#a(s.filter(n=>n!==e)),i}}async ack(t){await this.#t.removeItem(this.#s(t))}async retry(t,s=0){const e=await this.#t.getItem(this.#s(t));e&&(e.scheduledAt=Date.now()+s,await this.#t.setItem(this.#s(t),e),await this.#n(t))}async size(){return(await this.#i()).length}#s(t){return`${this.#e}:job:${t}`}async#i(){return await this.#t.getItem(`${this.#e}:pending`)??[]}async#a(t){await this.#t.setItem(`${this.#e}:pending`,t)}async#n(t){const s=await this.#i();s.includes(t)||(s.push(t),await this.#a(s))}}const o=(a,t)=>new c(a,t);export{c as UnstorageQueue,o as createUnstorageQueue};

package/dist/routing/index.d.ts

@@ -0,0 +1,35 @@
+import { C as ChannelPayloadMap, N as Notification, a as NotificationMessage } from "../packem_shared/notification.d-DFCVTods.js";
+import { C as ChannelType, M as MaybePromise, c as Receipt } from "../packem_shared/types.d-GUzX1jTk.js";
+import "../packem_shared/types.d-CximoA8M.js";
+import "../packem_shared/provider.d-BQAGriz6.js";
+/**
+* A gate decides whether a channel should be attempted for a given payload. Use it for
+* preferences, capability checks, send-windows or arbitrary conditions.
+*/
+type ChannelGate = (channel: ChannelType, payload: ChannelPayloadMap[ChannelType]) => MaybePromise<boolean>;
+interface RouteOptions {
+  /**
+  * Optional gate run before each channel send. Returning false skips the channel.
+  */
+  gate?: ChannelGate;
+  /**
+  * `"best-of"` (default) sends in `order` and stops at the first success;
+  * `"all"` broadcasts to every present, gated channel in parallel.
+  */
+  mode?: "all" | "best-of";
+  /**
+  * Channel priority order. Channels absent from the message are skipped; channels in
+  * the message but absent from `order` are appended in object order.
+  */
+  order?: ChannelType[];
+}
+/**
+* Routes a multi-channel message across channels with a priority order and an optional
+* gate. `"best-of"` stops at the first success (channel fallback); `"all"` broadcasts.
+* @param notification The facade used to send.
+* @param message The multi-channel message.
+* @param options Routing options.
+* @returns The receipts produced (one per attempted channel).
+*/
+declare const route: (notification: Notification, message: NotificationMessage, options?: RouteOptions) => Promise<Receipt[]>;
+export { ChannelGate, RouteOptions, route };

package/dist/routing/index.js

@@ -0,0 +1 @@
+const i=(n,e)=>{const t=Object.keys(n);if(!e)return t;const r=e.filter(o=>t.includes(o)),l=t.filter(o=>!e.includes(o));return[...r,...l]},f=async(n,e,t={})=>{const r=t.mode??"best-of",l=i(e,t.order),o=[];for(const s of l){const c=e[s];t.gate&&!await t.gate(s,c)||o.push(s)}if(r==="all")return Promise.all(o.map(async s=>n.sendToChannel(s,e[s])));const a=[];for(const s of o){const c=await n.sendToChannel(s,e[s]);if(a.push(c),c.successful)break}return a};export{f as route};

package/dist/template-engines/handlebars.d.ts

@@ -0,0 +1,16 @@
+import { T as TemplateRenderer } from "../packem_shared/types.d-td-F2Oh0.js";
+/**
+* Renders a [Handlebars](https://handlebarsjs.com/) template to a string.
+*
+* `handlebars` is an optional peer, loaded lazily so a missing install surfaces here
+* as a {@link NotificationError} rather than at import time. Pure JS — edge-safe and
+* runnable on Cloudflare Workers.
+* @param template The Handlebars template string.
+* @param data The data/variables exposed to the template.
+* @param options Handlebars compile options.
+* @returns The rendered string.
+* @throws {TypeError} When the template is not a string.
+* @throws {NotificationError} When `handlebars` is not installed or rendering fails.
+*/
+declare const renderHandlebars: TemplateRenderer;
+export { renderHandlebars as default, renderHandlebars };

package/dist/template-engines/handlebars.js

@@ -0,0 +1 @@
+import r from"../packem_shared/NotificationError-DVfMJQ1u.js";const d=async(a,n,s)=>{if(typeof a!="string")throw new TypeError("Handlebars template must be a string");let t;try{const e=await import("handlebars");t=e.default??e}catch(e){throw new r("handlebars","handlebars is not installed. Please install it: pnpm add handlebars",{cause:e})}try{return t.compile(a,s)(n??{})}catch(e){throw new r("handlebars",`Failed to render Handlebars template: ${e.message}`,{cause:e})}};export{d as default,d as renderHandlebars};