@visulima/notification 0.0.1 → 1.0.0-alpha.2

package/dist/packem_shared/types.d-GUzX1jTk.d.ts

@@ -0,0 +1,235 @@
+type EmailRecipients = EmailAddressLike | string | (EmailAddressLike | string)[];
+/**
+* Utility type for values that can be promises.
+*/
+type MaybePromise<T> = T | Promise<T>;
+/**
+* The logical delivery channels a notification can be routed through.
+*/
+type ChannelType = "chat" | "email" | "inapp" | "push" | "sms" | "webhook";
+/**
+* Feature flags indicating what capabilities a provider supports. Used to gate
+* payloads before sending (see `checkFeatureSupport`) and to surface capabilities
+* to consumers.
+*/
+interface FeatureFlags {
+  /** Supports file/media attachments (MMS, rich push images). */
+  attachments?: boolean;
+  /** Supports sending to many recipients in a single API call. */
+  batchSending?: boolean;
+  /** Reports delivery receipts / status callbacks. */
+  deliveryReceipts?: boolean;
+  /** Supports media URLs (MMS images, push images). */
+  media?: boolean;
+  /** Supports rich structured content (Slack blocks, cards, action buttons). */
+  richContent?: boolean;
+  /** Supports scheduled / delayed sending. */
+  scheduling?: boolean;
+  /** Supports provider-side templates. */
+  templates?: boolean;
+  /** Supports open/click tracking. */
+  tracking?: boolean;
+}
+/**
+* Base configuration shared by every provider.
+*/
+interface BaseConfig {
+  debug?: boolean;
+  logger?: Console;
+  retries?: number;
+  timeout?: number;
+}
+/**
+* Fields common to every channel payload.
+*/
+interface BaseNotificationPayload {
+  /**
+  * Idempotency key to dedupe retried sends at the provider (where supported)
+  * and in the dedupe middleware.
+  */
+  idempotencyKey?: string;
+  /**
+  * Arbitrary metadata passed through to the provider and emitted on events.
+  */
+  metadata?: Record<string, unknown>;
+  /**
+  * Optional scheduled send time (providers advertising `scheduling`).
+  */
+  scheduledAt?: Date | string;
+}
+/**
+* SMS / MMS payload.
+*/
+interface SmsPayload extends BaseNotificationPayload {
+  /** Sender id or phone number (overrides provider default). */
+  from?: string;
+  /** Media URLs for MMS. */
+  mediaUrls?: string[];
+  /** Message body. */
+  text: string;
+  /** Destination phone number(s) in E.164 format. */
+  to: string | string[];
+}
+/**
+* Push notification payload (mobile + web push).
+*/
+interface PushPayload extends BaseNotificationPayload {
+  /** Badge count (iOS). */
+  badge?: number;
+  /** Notification body. */
+  body: string;
+  /** Action invoked when the notification is tapped. */
+  clickAction?: string;
+  /** Custom key/value data payload. */
+  data?: Record<string, unknown>;
+  /** Image URL for rich push. */
+  imageUrl?: string;
+  /** Sound to play. */
+  sound?: string;
+  /** Notification title. */
+  title?: string;
+  /** Device token(s) / subscription target(s). */
+  to: string | string[];
+}
+/**
+* Chat payload (Slack, Discord, Teams, Telegram, ...).
+*/
+interface ChatPayload extends BaseNotificationPayload {
+  /** Provider-specific rich content (Slack blocks, Discord embeds, ...). */
+  blocks?: unknown;
+  /** Plain-text message body. */
+  text: string;
+  /** Thread / reply target. */
+  threadId?: string;
+  /** Channel id, conversation id or webhook target (overrides provider default). */
+  to?: string;
+}
+/**
+* In-app inbox payload.
+*/
+interface InAppPayload extends BaseNotificationPayload {
+  /** Optional CTA actions. */
+  actions?: {
+    label: string;
+    url?: string;
+  }[];
+  /** Notification body. */
+  body: string;
+  /** Custom key/value data payload. */
+  data?: Record<string, unknown>;
+  /** Notification title. */
+  title?: string;
+  /** Subscriber id the notification belongs to. */
+  to: string;
+}
+/**
+* An email address, optionally with a display name.
+*/
+interface EmailAddressLike {
+  email: string;
+  name?: string;
+}
+/**
+* Email channel payload. Delivered through `@visulima/email` by the email channel adapter;
+* the shape mirrors `EmailOptions` so it passes through with minimal mapping.
+*/
+interface EmailChannelPayload extends BaseNotificationPayload {
+  attachments?: unknown[];
+  bcc?: EmailRecipients;
+  cc?: EmailRecipients;
+  from?: EmailAddressLike | string;
+  headers?: Record<string, string>;
+  html?: string;
+  replyTo?: EmailAddressLike | string;
+  subject: string;
+  text?: string;
+  to: EmailRecipients;
+}
+/**
+* Generic outbound webhook payload.
+*/
+interface WebhookPayload extends BaseNotificationPayload {
+  /** JSON-serialisable request body. */
+  body: unknown;
+  /** Extra request headers. */
+  headers?: Record<string, string>;
+  /** HTTP method (defaults to POST). */
+  method?: string;
+  /** Target URL (overrides provider default). */
+  url?: string;
+}
+/**
+* Union of all built-in channel payloads.
+*/
+type NotificationPayload = ChatPayload | EmailChannelPayload | InAppPayload | PushPayload | SmsPayload | WebhookPayload;
+/**
+* Per-recipient delivery outcome for multi-recipient sends.
+*/
+interface RecipientResult {
+  error?: string;
+  id: string;
+  messageId?: string;
+  status: "failed" | "sent";
+}
+/**
+* Normalised result of a successful provider send.
+*/
+interface NotificationResult {
+  channel?: ChannelType;
+  messageId: string;
+  provider?: string;
+  /** Per-recipient breakdown when a single call targets many recipients. */
+  recipients?: RecipientResult[];
+  response?: unknown;
+  sent: boolean;
+  timestamp: Date;
+}
+/**
+* A successful send receipt.
+*/
+interface SuccessReceipt {
+  channel?: ChannelType;
+  messageId: string;
+  provider?: string;
+  response?: unknown;
+  successful: true;
+  timestamp: Date;
+}
+/**
+* A failed send receipt.
+*/
+interface FailureReceipt {
+  channel?: ChannelType;
+  errorMessages: string[];
+  provider?: string;
+  successful: false;
+}
+/**
+* Discriminated send receipt returned by the high-level facade.
+*/
+type Receipt = FailureReceipt | SuccessReceipt;
+/**
+* Generic result tuple used across providers and middleware.
+*/
+interface Result<T = unknown> {
+  data?: T;
+  error?: unknown;
+  success: boolean;
+}
+/**
+* Lifecycle event names emitted on the event bus and parsed from provider webhooks.
+*/
+type NotificationEventType = "bounced" | "clicked" | "delivered" | "failed" | "interacted" | "queued" | "read" | "sent";
+/**
+* Normalised lifecycle / delivery event.
+*/
+interface NotificationEvent {
+  channel?: ChannelType;
+  messageId: string;
+  metadata?: Record<string, unknown>;
+  provider?: string;
+  recipient?: string;
+  timestamp: Date;
+  type: NotificationEventType;
+}
+export { BaseNotificationPayload as B, ChannelType as C, EmailChannelPayload as E, FeatureFlags as F, InAppPayload as I, MaybePromise as M, NotificationEvent as N, PushPayload as P, Result as R, SmsPayload as S, WebhookPayload as W, NotificationResult as a, ChatPayload as b, Receipt as c, BaseConfig as d, NotificationEventType as e, EmailAddressLike as f, FailureReceipt as g, NotificationPayload as h, RecipientResult as i, SuccessReceipt as j };

package/dist/packem_shared/types.d-td-F2Oh0.d.ts

@@ -0,0 +1,10 @@
+/**
+* Template render function type. Engines accept a template, optional data and
+* engine-specific options and return the rendered string (sync or async).
+* @param template Template content (typically a string).
+* @param data Data/variables to pass to the template.
+* @param options Options specific to the template engine.
+* @returns The rendered string.
+*/
+type TemplateRenderer = (template: unknown, data?: Record<string, unknown>, options?: Record<string, unknown>) => string | Promise<string>;
+export { TemplateRenderer as T };

package/dist/packem_shared/unstorage.DqlWKU2I.d-CogP3Etw.d.ts

@@ -0,0 +1,120 @@
+type StorageValue = null | string | number | boolean | object;
+type WatchEvent = "update" | "remove";
+type WatchCallback = (event: WatchEvent, key: string) => any;
+type MaybePromise<T> = T | Promise<T>;
+type MaybeDefined<T> = T extends any ? T : any;
+type Unwatch = () => MaybePromise<void>;
+interface StorageMeta {
+  atime?: Date;
+  mtime?: Date;
+  ttl?: number;
+  [key: string]: StorageValue | Date | undefined;
+}
+type TransactionOptions = Record<string, any>;
+type GetKeysOptions = TransactionOptions & {
+  maxDepth?: number;
+};
+interface DriverFlags {
+  maxDepth?: boolean;
+  ttl?: boolean;
+}
+interface Driver<OptionsT = any, InstanceT = any> {
+  name?: string;
+  flags?: DriverFlags;
+  options?: OptionsT;
+  getInstance?: () => InstanceT;
+  hasItem: (key: string, opts: TransactionOptions) => MaybePromise<boolean>;
+  getItem: (key: string, opts?: TransactionOptions) => MaybePromise<StorageValue>;
+  /** @experimental */
+  getItems?: (items: {
+    key: string;
+    options?: TransactionOptions;
+  }[], commonOptions?: TransactionOptions) => MaybePromise<{
+    key: string;
+    value: StorageValue;
+  }[]>;
+  /** @experimental */
+  getItemRaw?: (key: string, opts: TransactionOptions) => MaybePromise<unknown>;
+  setItem?: (key: string, value: string, opts: TransactionOptions) => MaybePromise<void>;
+  /** @experimental */
+  setItems?: (items: {
+    key: string;
+    value: string;
+    options?: TransactionOptions;
+  }[], commonOptions?: TransactionOptions) => MaybePromise<void>;
+  /** @experimental */
+  setItemRaw?: (key: string, value: any, opts: TransactionOptions) => MaybePromise<void>;
+  removeItem?: (key: string, opts: TransactionOptions) => MaybePromise<void>;
+  getMeta?: (key: string, opts: TransactionOptions) => MaybePromise<StorageMeta | null>;
+  getKeys: (base: string, opts: GetKeysOptions) => MaybePromise<string[]>;
+  clear?: (base: string, opts: TransactionOptions) => MaybePromise<void>;
+  dispose?: () => MaybePromise<void>;
+  watch?: (callback: WatchCallback) => MaybePromise<Unwatch>;
+}
+type StorageDefinition = {
+  items: unknown;
+  [key: string]: unknown;
+};
+type StorageItemMap<T> = T extends StorageDefinition ? T["items"] : T;
+type StorageItemType<T, K> = K extends keyof StorageItemMap<T> ? StorageItemMap<T>[K] : T extends StorageDefinition ? StorageValue : T;
+interface Storage<T extends StorageValue = StorageValue> {
+  hasItem<U extends Extract<T, StorageDefinition>, K extends keyof StorageItemMap<U>>(key: K, opts?: TransactionOptions): Promise<boolean>;
+  hasItem(key: string, opts?: TransactionOptions): Promise<boolean>;
+  getItem<U extends Extract<T, StorageDefinition>, K extends string & keyof StorageItemMap<U>>(key: K, ops?: TransactionOptions): Promise<StorageItemType<T, K> | null>;
+  getItem<R = StorageItemType<T, string>>(key: string, opts?: TransactionOptions): Promise<R | null>;
+  /** @experimental */
+  getItems: <U extends T>(items: (string | {
+    key: string;
+    options?: TransactionOptions;
+  })[], commonOptions?: TransactionOptions) => Promise<{
+    key: string;
+    value: U;
+  }[]>;
+  /** @experimental See https://github.com/unjs/unstorage/issues/142 */
+  getItemRaw: <T = any>(key: string, opts?: TransactionOptions) => Promise<MaybeDefined<T> | null>;
+  setItem<U extends Extract<T, StorageDefinition>, K extends keyof StorageItemMap<U>>(key: K, value: StorageItemType<T, K>, opts?: TransactionOptions): Promise<void>;
+  setItem<U extends T>(key: string, value: U, opts?: TransactionOptions): Promise<void>;
+  /** @experimental */
+  setItems: <U extends T>(items: {
+    key: string;
+    value: U;
+    options?: TransactionOptions;
+  }[], commonOptions?: TransactionOptions) => Promise<void>;
+  /** @experimental See https://github.com/unjs/unstorage/issues/142 */
+  setItemRaw: <T = any>(key: string, value: MaybeDefined<T>, opts?: TransactionOptions) => Promise<void>;
+  removeItem<U extends Extract<T, StorageDefinition>, K extends keyof StorageItemMap<U>>(key: K, opts?: (TransactionOptions & {
+    removeMeta?: boolean;
+  }) | boolean): Promise<void>;
+  removeItem(key: string, opts?: (TransactionOptions & {
+    removeMeta?: boolean;
+  }) | boolean): Promise<void>;
+  getMeta: (key: string, opts?: (TransactionOptions & {
+    nativeOnly?: boolean;
+  }) | boolean) => MaybePromise<StorageMeta>;
+  setMeta: (key: string, value: StorageMeta, opts?: TransactionOptions) => Promise<void>;
+  removeMeta: (key: string, opts?: TransactionOptions) => Promise<void>;
+  getKeys: (base?: string, opts?: GetKeysOptions) => Promise<string[]>;
+  clear: (base?: string, opts?: TransactionOptions) => Promise<void>;
+  dispose: () => Promise<void>;
+  watch: (callback: WatchCallback) => Promise<Unwatch>;
+  unwatch: () => Promise<void>;
+  mount: (base: string, driver: Driver) => Storage;
+  unmount: (base: string, dispose?: boolean) => Promise<void>;
+  getMount: (key?: string) => {
+    base: string;
+    driver: Driver;
+  };
+  getMounts: (base?: string, options?: {
+    parents?: boolean;
+  }) => {
+    base: string;
+    driver: Driver;
+  }[];
+  keys: Storage["getKeys"];
+  get: Storage<T>["getItem"];
+  set: Storage<T>["setItem"];
+  has: Storage<T>["hasItem"];
+  del: Storage<T>["removeItem"];
+  remove: Storage<T>["removeItem"];
+}
+export type { Storage as S };

package/dist/packem_shared/vonageProvider-BF76ca89.js

@@ -0,0 +1 @@
+import n from"./RequiredOptionError-CuL42XRq.js";import{defineProvider as l}from"./defineProvider-C9q-7iwt.js";import{t as g}from"./credentials-CG0zkn-W.js";import{r as y}from"./http-BMYcUNBU.js";import{s as v,b as w}from"./sms-CU-OZvNU.js";const S="https://rest.nexmo.com",P=l(d=>{const e=d??{};if(!e.apiKey)throw new n("vonage","apiKey");if(!e.apiSecret)throw new n("vonage","apiSecret");const o=e.endpoint??S,p=e.retries??3,c=e.timeout??3e4,m=`${o}/sms/json`,f=async(t,a)=>{const s=a.from??e.from;if(!s)return{error:"Missing sender: provide `from` on the payload or provider config",id:t,status:"failed"};const u=new URLSearchParams({api_key:e.apiKey,api_secret:e.apiSecret,from:s,text:a.text,to:t}),r=await y(m,{body:u.toString(),headers:{"Content-Type":"application/x-www-form-urlencoded"},method:"POST",timeout:c},p);if(!r.success||!r.data)return{error:r.error instanceof Error?r.error.message:"Request failed",id:t,status:"failed"};const i=r.data.body.messages?.[0];return i?.status!=="0"?{error:i?.["error-text"]??`Vonage status ${i?.status??"unknown"}`,id:t,status:"failed"}:{id:t,messageId:i["message-id"],status:"sent"}};return{channel:"sms",endpoint:o,features:{batchSending:!1,deliveryReceipts:!0,media:!1},id:"vonage",initialize:()=>{},isAvailable:()=>!!(e.apiKey&&e.apiSecret),options:e,send:async t=>{const a=await v(g(t.to),async s=>f(s,t));return w("vonage",a)},validateCredentials:()=>!!(e.apiKey&&e.apiSecret)}});export{P as default};

package/dist/packem_shared/webPushProvider-B962RwsA.js

@@ -0,0 +1 @@
+import K from"./RequiredOptionError-CuL42XRq.js";import{defineProvider as C}from"./defineProvider-C9q-7iwt.js";import{t as A}from"./credentials-CG0zkn-W.js";import{m as E}from"./http-BMYcUNBU.js";import{n as U}from"./id-C_FRCsUM.js";import{a as $}from"./sms-CU-OZvNU.js";import{u as y,f as S,t as f,s as d,r as k,c as g,h as P,a as T}from"./webcrypto-bY7wJCB5.js";const j=2419200,x=i=>{let e=i;if(typeof i=="string")try{e=JSON.parse(i)}catch{return}const t=e;if(!(!t||typeof t.endpoint!="string"||typeof t.keys?.p256dh!="string"||typeof t.keys.auth!="string"))return t},B=async(i,e)=>{const t=S(e),p=f(t.slice(1,33)),r=f(t.slice(33,65));return d().importKey("jwk",{crv:"P-256",d:i,ext:!0,key_ops:["sign"],kty:"EC",x:p,y:r},{name:"ECDSA",namedCurve:"P-256"},!1,["sign"])},D=async(i,e,t)=>{const p=f(y(JSON.stringify({alg:"ES256",typ:"JWT"}))),r=f(y(JSON.stringify({aud:i,exp:Math.floor(Date.now()/1e3)+720*60,sub:e}))),u=`${p}.${r}`,a=await d().sign({hash:"SHA-256",name:"ECDSA"},t,y(u));return`${u}.${f(new Uint8Array(a))}`},H=async(i,e)=>{const t=S(i.keys.p256dh),p=S(i.keys.auth),r=k(16),u=await d().generateKey({name:"ECDH",namedCurve:"P-256"},!0,["deriveBits"]),a=new Uint8Array(await d().exportKey("raw",u.publicKey)),n=await d().importKey("raw",t,{name:"ECDH",namedCurve:"P-256"},!1,[]),m=new Uint8Array(await d().deriveBits({name:"ECDH",public:n},u.privateKey,256)),s=g(y("WebPush: info\0"),t,a),l=await P(p,m,s,32),v=await P(r,l,y("Content-Encoding: aes128gcm\0"),16),w=await P(r,l,y("Content-Encoding: nonce\0"),12),b=await d().importKey("raw",v,{name:"AES-GCM"},!1,["encrypt"]),h=g(e,new Uint8Array([2])),o=new Uint8Array(await d().encrypt({iv:w,name:"AES-GCM"},b,h)),c=g(r,T(4096,4),new Uint8Array([a.length]),a);return g(c,o)},z=C(i=>{const e=i??{};if(!e.vapidPublicKey||!e.vapidPrivateKey||!e.vapidSubject)throw new K("web-push",["vapidPublicKey","vapidPrivateKey","vapidSubject"]);const t=e.ttl??j,p=e.urgency??"normal",r=e.timeout??3e4,u=async(a,n,m)=>{const s=x(a);if(!s)return{error:"Invalid push subscription (expected { endpoint, keys: { p256dh, auth } })",id:a,status:"failed"};const{origin:l}=new URL(s.endpoint),v=await D(l,e.vapidSubject,m),w=JSON.stringify({badge:n.badge,body:n.body,data:n.data,image:n.imageUrl,title:n.title}),b=await H(s,y(w)),h={Authorization:`vapid t=${v},k=${e.vapidPublicKey}`,"Content-Encoding":"aes128gcm","Content-Type":"application/octet-stream",TTL:String(t),Urgency:p},o=await E(s.endpoint,{body:b,headers:h,method:"POST",timeout:r});if(!o.success||!o.data)return{error:o.error instanceof Error?o.error.message:"Request failed",id:a,status:"failed"};const{status:c}=o.data;return c===404||c===410?{error:`Subscription gone (HTTP ${String(c)}) — remove this subscription`,id:a,status:"failed"}:c>=400?{error:`HTTP ${String(c)}: ${typeof o.data.body=="string"?o.data.body:""}`.trim(),id:a,status:"failed"}:{id:a,messageId:U("web-push"),status:"sent"}};return{channel:"push",features:{batchSending:!1,media:!1,richContent:!0},id:"web-push",initialize:()=>{},isAvailable:()=>!!(e.vapidPublicKey&&e.vapidPrivateKey&&e.vapidSubject),options:e,send:async a=>{const n=A(a.to),m=await B(e.vapidPrivateKey,e.vapidPublicKey),s=[];for(const l of n)s.push(await u(l,a,m));return $("push","web-push",s)},validateCredentials:()=>!!(e.vapidPublicKey&&e.vapidPrivateKey&&e.vapidSubject)}});export{z as default};

package/dist/packem_shared/webcrypto-bY7wJCB5.js

@@ -0,0 +1 @@
+const l=r=>new Uint8Array(new ArrayBuffer(r)),i=r=>{if(r.buffer instanceof ArrayBuffer)return r;const t=l(r.length);return t.set(r),t},o=()=>globalThis.crypto.subtle,u=r=>{const t=l(r);return globalThis.crypto.getRandomValues(t),t},c=r=>{const t=new TextEncoder().encode(r),e=l(t.length);return e.set(t),e},y=(...r)=>{let t=0;for(const a of r)t+=a.length;const e=l(t);let n=0;for(const a of r)e.set(a,n),n+=a.length;return e},g=r=>{let t="";for(const e of r)t+=e.toString(16).padStart(2,"0");return t},h=r=>{let t="";for(const e of r)t+=String.fromCodePoint(e);return btoa(t)},A=r=>{let t=h(r).replaceAll("+","-").replaceAll("/","_");for(;t.endsWith("=");)t=t.slice(0,-1);return t},w=r=>{const t=r.replaceAll("-","+").replaceAll("_","/"),e=t.padEnd(t.length+(4-t.length%4)%4,"="),n=atob(e),a=l(n.length);for(let s=0;s<n.length;s+=1)a[s]=n.codePointAt(s)??0;return a},d=(r,t)=>{const e=l(t);let n=r;for(let a=t-1;a>=0;a-=1)e[a]=n%256,n=Math.floor(n/256);return e},p=async r=>{const t=await o().digest("SHA-256",r);return new Uint8Array(t)},m=async(r,t)=>{const e=await o().importKey("raw",r,{hash:"SHA-256",name:"HMAC"},!1,["sign"]),n=await o().sign("HMAC",e,t);return new Uint8Array(n)},B=async(r,t,e)=>{const n=typeof r=="string"?c(r):i(r),a=typeof t=="string"?c(t):i(t),s=await o().importKey("raw",n,{hash:e,name:"HMAC"},!1,["sign"]),f=await o().sign("HMAC",s,a);return new Uint8Array(f)},H=async(r,t,e,n)=>{const a=await o().importKey("raw",t,"HKDF",!1,["deriveBits"]),s=await o().deriveBits({hash:"SHA-256",info:e,name:"HKDF",salt:r},a,n*8);return new Uint8Array(s)};export{d as a,g as b,y as c,p as d,m as e,w as f,h as g,H as h,B as i,u as r,o as s,A as t,c as u};

package/dist/packem_shared/webhookProvider-BALSb2pc.js

@@ -0,0 +1 @@
+import s from"./NotificationError-DVfMJQ1u.js";import i from"./RequiredOptionError-CuL42XRq.js";import{r as d}from"./http-BMYcUNBU.js";import{n as u}from"./id-C_FRCsUM.js";const w=(t={})=>{const a=t.retries??3,n=t.timeout??3e4;return{channel:"webhook",endpoint:t.url,features:{},id:"webhook",initialize:()=>{},isAvailable:()=>!0,send:async o=>{const r=o.url??t.url;if(!r)throw new i("webhook","url");const e=await d(r,{body:typeof o.body=="string"?o.body:JSON.stringify(o.body),headers:{"Content-Type":"application/json",...t.headers,...o.headers},method:o.method??t.method??"POST",timeout:n},a);return!e.success||!e.data?{error:new s("webhook",e.error instanceof Error?e.error.message:"Request failed"),success:!1}:e.data.status>=400?{error:new s("webhook",`HTTP ${String(e.data.status)}`),success:!1}:{data:{channel:"webhook",messageId:u("webhook"),provider:"webhook",response:e.data.body,sent:!0,timestamp:new Date},success:!0}}}};export{w as webhookProvider};

package/dist/preferences/index.d.ts

@@ -0,0 +1,49 @@
+import { ChannelGate } from "../routing/index.js";
+import { C as ChannelType } from "../packem_shared/types.d-GUzX1jTk.js";
+import "../packem_shared/notification.d-DFCVTods.js";
+import "../packem_shared/types.d-CximoA8M.js";
+import "../packem_shared/provider.d-BQAGriz6.js";
+/**
+* A subscriber's channel preferences. A channel set to `false` is opted out; channels
+* absent default to allowed.
+*/
+interface SubscriberPreferences {
+  channels: Partial<Record<ChannelType, boolean>>;
+}
+interface IsAllowedOptions {
+  /** Critical notifications bypass opt-outs (e.g. security alerts). */
+  critical?: boolean;
+}
+/**
+* Stores per-subscriber channel preferences and answers allow/deny questions.
+*/
+interface PreferenceStore {
+  get: (subscriberId: string) => Promise<SubscriberPreferences> | SubscriberPreferences;
+  isAllowed: (subscriberId: string, channel: ChannelType, options?: IsAllowedOptions) => Promise<boolean> | boolean;
+  set: (subscriberId: string, preferences: SubscriberPreferences) => Promise<void> | void;
+}
+/**
+* In-memory {@link PreferenceStore}.
+*/
+declare class MemoryPreferenceStore implements PreferenceStore {
+  #private;
+  get(subscriberId: string): SubscriberPreferences;
+  set(subscriberId: string, preferences: SubscriberPreferences): void;
+  isAllowed(subscriberId: string, channel: ChannelType, options?: IsAllowedOptions): boolean;
+}
+/**
+* Builds a {@link ChannelGate} for `route(...)` from a preference store. The subscriber id
+* is resolved from each payload (default: the payload's `to` field, stringified).
+* @param store The preference store.
+* @param options Resolution options.
+* @param options.critical When true the produced gate treats every send as critical, bypassing opt-outs.
+* @param options.subscriberId Resolver mapping a payload to its subscriber id (defaults to the `to` field).
+* @returns A gate suitable for `route(notification, message, { gate })`.
+*/
+declare const preferencesGate: (store: PreferenceStore, options?: {
+  critical?: boolean;
+  subscriberId?: (payload: {
+    to?: unknown;
+  }) => string | undefined;
+}) => ChannelGate;
+export { IsAllowedOptions, MemoryPreferenceStore, PreferenceStore, SubscriberPreferences, preferencesGate };

package/dist/preferences/index.js

@@ -0,0 +1 @@
+class l{#e=new Map;get(e){return this.#e.get(e)??{channels:{}}}set(e,r){this.#e.set(e,r)}isAllowed(e,r,s={}){return s.critical?!0:this.get(e).channels[r]!==!1}}const o=(c,e={})=>{const r=n=>{const{to:t}=n;if(t!=null)return typeof t=="string"?t:JSON.stringify(t)},s=e.subscriberId??r;return async(n,t)=>{const i=s(t);return i?c.isAllowed(i,n,{critical:e.critical}):!0}};export{l as MemoryPreferenceStore,o as preferencesGate};

package/dist/providers/chat/discord/index.d.ts

@@ -0,0 +1,14 @@
+import { d as BaseConfig, b as ChatPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface DiscordConfig extends BaseConfig {
+  /** Override the bot username for the message. */
+  username?: string;
+  /** Discord webhook URL. Required. */
+  webhookUrl: string;
+}
+/**
+* Discord chat provider via Incoming Webhooks. Edge-safe — `fetch` only.
+* @see https://discord.com/developers/docs/resources/webhook#execute-webhook
+*/
+declare const discordProvider: ProviderFactory<DiscordConfig, ChatPayload>;
+export { type DiscordConfig, discordProvider };

package/dist/providers/chat/discord/index.js

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

package/dist/providers/chat/msteams/index.d.ts

@@ -0,0 +1,14 @@
+import { d as BaseConfig, b as ChatPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface MsTeamsConfig extends BaseConfig {
+  /** Microsoft Teams Incoming Webhook URL. Required. */
+  webhookUrl: string;
+}
+/**
+* Microsoft Teams chat provider via Incoming Webhook. When `blocks` is provided it is
+* sent verbatim (e.g. an Adaptive Card / MessageCard), otherwise a plain MessageCard is
+* built from `text`. Edge-safe — `fetch` only.
+* @see https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using
+*/
+declare const msTeamsProvider: ProviderFactory<MsTeamsConfig, ChatPayload>;
+export { type MsTeamsConfig, msTeamsProvider };

package/dist/providers/chat/msteams/index.js

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

package/dist/providers/chat/slack/index.d.ts

@@ -0,0 +1,19 @@
+import { d as BaseConfig, b as ChatPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface SlackConfig extends BaseConfig {
+  /** Default channel id/name used when the payload omits `to` (Web API mode). */
+  defaultChannel?: string;
+  /** Override the API base URL (Web API mode). */
+  endpoint?: string;
+  /** Bot/User OAuth token (`xoxb-...`) for the Web API. Required unless `webhookUrl` is set. */
+  token?: string;
+  /** Incoming webhook URL. When set, takes precedence over the Web API. */
+  webhookUrl?: string;
+}
+/**
+* Slack chat provider. Supports both Incoming Webhooks (`webhookUrl`) and the Web API
+* (`token` + channel). Edge-safe — `fetch` only.
+* @see https://api.slack.com/methods/chat.postMessage
+*/
+declare const slackProvider: ProviderFactory<SlackConfig, ChatPayload>;
+export { type SlackConfig, slackProvider };

package/dist/providers/chat/slack/index.js

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

package/dist/providers/chat/telegram/index.d.ts

@@ -0,0 +1,18 @@
+import { d as BaseConfig, b as ChatPayload } from "../../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../../packem_shared/provider.d-BQAGriz6.js";
+interface TelegramConfig extends BaseConfig {
+  /** Telegram bot token (`123456:ABC-DEF...`). Required. */
+  botToken: string;
+  /** Default chat id used when the payload omits `to`. */
+  defaultChatId?: number | string;
+  /** Override the API base URL. */
+  endpoint?: string;
+  /** Default parse mode (`MarkdownV2`, `HTML`, ...). */
+  parseMode?: string;
+}
+/**
+* Telegram chat provider via the Bot API. Edge-safe — `fetch` only.
+* @see https://core.telegram.org/bots/api#sendmessage
+*/
+declare const telegramProvider: ProviderFactory<TelegramConfig, ChatPayload>;
+export { type TelegramConfig, telegramProvider };

package/dist/providers/chat/telegram/index.js

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

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

@@ -0,0 +1,16 @@
+import { B as BaseNotificationPayload } from "../../packem_shared/types.d-GUzX1jTk.js";
+import { P as Provider } from "../../packem_shared/provider.d-BQAGriz6.js";
+interface FailoverConfig {
+  /** Provider id reported on results (default `"failover"`). */
+  id?: string;
+  /** Logger for failover transitions. */
+  logger?: Console;
+}
+/**
+* Wraps several same-channel providers and tries each in order until one succeeds.
+* @param providers The providers to fail over between (highest priority first).
+* @param config Optional config.
+* @returns A composite provider.
+*/
+declare const failoverProvider: <PayloadT extends BaseNotificationPayload>(providers: Provider<unknown, PayloadT>[], config?: FailoverConfig) => Provider<unknown, PayloadT>;
+export { type FailoverConfig, failoverProvider };

package/dist/providers/failover/index.js

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

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

@@ -0,0 +1,29 @@
+import { C as ChannelType, B as BaseNotificationPayload } from "../../packem_shared/types.d-GUzX1jTk.js";
+import { a as ProviderFactory } from "../../packem_shared/provider.d-BQAGriz6.js";
+interface MockSentMessage {
+  messageId: string;
+  payload: BaseNotificationPayload;
+  timestamp: Date;
+}
+interface MockProviderConfig {
+  /** Channel to advertise (defaults to `"sms"`). */
+  channel?: ChannelType;
+  /** When set, every `send` fails with this message. */
+  failWith?: string;
+  /** Provider id (defaults to `"mock"`). */
+  id?: string;
+}
+interface MockProviderInstance {
+  /** Clears the recorded message log. */
+  clear: () => void;
+  /** Returns the most recently sent message, if any. */
+  last: () => MockSentMessage | undefined;
+  /** All messages recorded by this provider. */
+  readonly sent: MockSentMessage[];
+}
+/**
+* In-memory provider for tests and local development. Records every payload it is
+* asked to send and can be configured to fail deterministically.
+*/
+declare const mockProvider: ProviderFactory<MockProviderConfig, BaseNotificationPayload, MockProviderInstance>;
+export { type MockProviderConfig, type MockProviderInstance, type MockSentMessage, mockProvider };

package/dist/providers/mock/index.js

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

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

@@ -0,0 +1,21 @@
+import { T as Tracer } from "../../packem_shared/tracer.d-Co1s_NwG.js";
+import { B as BaseNotificationPayload } from "../../packem_shared/types.d-GUzX1jTk.js";
+import { P as Provider } from "../../packem_shared/provider.d-BQAGriz6.js";
+interface OtelProviderConfig {
+  /**
+  * The OpenTelemetry {@link Tracer} used to create spans. When omitted, a no-op tracer is
+  * used so the wrapper is inert until the host application supplies one (keeping
+  * `@opentelemetry/api` an optional peer dependency).
+  */
+  tracer?: Tracer;
+}
+/**
+* Wraps any {@link Provider} and records an OpenTelemetry span per `send` call. Edge-safe:
+* `@opentelemetry/api` is runtime-agnostic and the tracer is injected, so nothing is bundled
+* when tracing is disabled.
+* @param inner The provider to wrap.
+* @param config Optional config; supply a `tracer` to emit real spans.
+* @returns A provider that delegates to `inner` while tracing each send.
+*/
+declare const otelProvider: <PayloadT extends BaseNotificationPayload>(inner: Provider<unknown, PayloadT>, config?: OtelProviderConfig) => Provider<unknown, PayloadT>;
+export { type OtelProviderConfig, otelProvider };

package/dist/providers/opentelemetry/index.js

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

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

@@ -0,0 +1,24 @@
+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";
+interface ApnsConfig extends BaseConfig {
+  /** The app bundle id, sent as the `apns-topic` header. */
+  bundleId: string;
+  /** The 10-character Key ID of the signing key, used as the JWT `kid`. */
+  keyId: string;
+  /** Send to the production gateway when `true`, otherwise the sandbox gateway (default `false`). */
+  production?: boolean;
+  /** The ES256 signing key in PEM format (contents of the `.p8` file). */
+  signingKey: string;
+  /** The 10-character Apple Developer Team ID, used as the JWT `iss`. */
+  teamId: string;
+}
+/**
+* Apple Push Notification service (APNs) provider.
+*
+* NODE-ONLY: APNs mandates HTTP/2 with token-based (JWT/ES256) auth, so this provider uses
+* `node:http2` and `node:crypto`. It is NOT edge/Cloudflare-Workers-safe and will not run on
+* Web-only runtimes that lack `node:http2`.
+* @see https://developer.apple.com/documentation/usernotifications/sending-notification-requests-to-apns
+*/
+declare const apnsProvider: ProviderFactory<ApnsConfig, PushPayload>;
+export { type ApnsConfig, apnsProvider };

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

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

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

@@ -0,0 +1,14 @@
+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";
+interface ExpoConfig extends BaseConfig {
+  /** Expo access token (required for projects with enhanced security). */
+  accessToken?: string;
+  /** Override the API base URL. */
+  endpoint?: string;
+}
+/**
+* Expo push provider. Sends a batch of device tokens in one call. Edge-safe — `fetch` only.
+* @see https://docs.expo.dev/push-notifications/sending-notifications/
+*/
+declare const expoProvider: ProviderFactory<ExpoConfig, PushPayload>;
+export { type ExpoConfig, expoProvider };