sently 0.7.2 → 0.9.0

package/dist/core/types.d.ts

@@ -87,6 +87,13 @@ export interface SendResult {
     deduped?: boolean;
     /** Set when this item failed inside an otherwise successful batch HTTP response. */
     batchError?: unknown;
+    /** Identifier of the transport that handled the send; set by FallbackTransport. */
+    provider?: string;
+    /**
+     * Zero-based index of the transport that handled the send in a fallback chain.
+     * Set by FallbackTransport (e.g. `1` means provider #0 failed and #1 succeeded).
+     */
+    providerIndex?: number;
 }
 /** SMTP envelope addresses (MAIL FROM / RCPT TO). */
 export interface Envelope {
@@ -134,6 +141,11 @@ export interface VerifyResult {
 }
 /** Pluggable mail delivery backend (SMTP, HTTP API, etc.). */
 export interface Transport {
+    /**
+     * Stable provider identifier for observability (e.g. `"resend"`, `"ses"`).
+     * Prefer this over constructor-name inference in hooks and fallback diagnostics.
+     */
+    readonly provider?: string;
     /** Send a message through this transport. */
     send(options: MailOptions): Promise<SendResult>;
     /**
@@ -362,12 +374,23 @@ export interface MailerHookContext {
 export interface MailerHooks {
     /** Fired before the transport sends the message. */
     onSend?: (ctx: MailerHookContext) => void | Promise<void>;
-    /** Fired after a successful send. */
-    onSuccess?: (ctx: MailerHookContext, result: SendResult) => void | Promise<void>;
-    /** Fired when a send throws (error is re-thrown after the hook runs). */
-    onError?: (ctx: MailerHookContext, error: unknown) => void | Promise<void>;
+    /**
+     * Fired after a successful send.
+     * @param durationMs — elapsed milliseconds from send start to success (optional third argument).
+     */
+    onSuccess?: (ctx: MailerHookContext, result: SendResult, durationMs?: number) => void | Promise<void>;
+    /**
+     * Fired when a send throws (error is re-thrown after the hook runs).
+     * @param durationMs — elapsed milliseconds from send start to failure (optional third argument).
+     */
+    onError?: (ctx: MailerHookContext, error: unknown, durationMs?: number) => void | Promise<void>;
     /** Fired before each retry attempt (requires {@link RetryTransport}). */
     onRetry?: (ctx: MailerHookContext, attempt: number, error: unknown) => void | Promise<void>;
+    /**
+     * Fired when {@link FallbackTransport} fails over to the next provider.
+     * Requires a {@link FallbackTransport} (or {@link WeightedFallbackTransport}) in the mailer stack.
+     */
+    onFallback?: (ctx: MailerHookContext, failedProvider: string, nextProvider: string, error: unknown) => void | Promise<void>;
 }
 /** Options for {@link createMailer} from `sently/mailer` — transport-only, smallest bundle. */
 export interface TransportMailerOptions {

package/dist/core/whatsapp-types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @module
+ * Shared WhatsApp channel contracts — sibling types to email MailOptions/Transport/Hooks.
+ *
+ * Sently-first: this contract is the stable WhatsApp surface. Provider transports
+ * implement {@link WhatsAppTransport}; multi-product vendors get a separate
+ * WhatsApp transport entry, not a mega vendor client.
+ *
+ * Meta requires a pre-approved template for business-initiated messages; free text
+ * is only allowed within an open 24h customer-service window. Model both shapes.
+ */
+import type { VerifyResult } from "./types.js";
+/** Parameter inside a WhatsApp template component. */
+export interface WhatsAppTemplateParameter {
+    /** Parameter value type. */
+    type: "text" | "currency" | "date_time";
+    /** Text value when {@link type} is `"text"`. */
+    text?: string;
+}
+/** Component of a WhatsApp template message (header, body, or button). */
+export interface WhatsAppTemplateComponent {
+    /** Component role in the template. */
+    type: "header" | "body" | "button";
+    /** Substitution parameters for this component. */
+    parameters?: WhatsAppTemplateParameter[];
+}
+/**
+ * Business-initiated WhatsApp message using a pre-approved template.
+ * Required outside the 24h customer-service window.
+ */
+export interface WhatsAppTemplateMessage {
+    /** Recipient phone number (E.164 recommended). */
+    to: string;
+    /** Pre-approved template definition. */
+    template: {
+        /** Template name registered with Meta. */
+        name: string;
+        /** Language code (e.g. `"en_US"`). */
+        language: string;
+        /** Optional header/body/button components with parameters. */
+        components?: WhatsAppTemplateComponent[];
+    };
+    /** Client-supplied message identifier when known. */
+    messageId?: string;
+}
+/**
+ * Free-text WhatsApp message.
+ * Only valid within an open 24h customer-service window.
+ */
+export interface WhatsAppTextMessage {
+    /** Recipient phone number (E.164 recommended). */
+    to: string;
+    /** Plain text body. */
+    text: string;
+    /** Client-supplied message identifier when known. */
+    messageId?: string;
+}
+/** Options for sending a WhatsApp message (template or free text). */
+export type WhatsAppOptions = WhatsAppTemplateMessage | WhatsAppTextMessage;
+/** Result returned after a WhatsApp message is accepted for delivery. */
+export interface WhatsAppSendResult {
+    /** Provider-assigned or client message identifier. */
+    messageId: string;
+    /** Recipient phone number. */
+    to: string;
+    /** Provider delivery status string (e.g. `"accepted"`). */
+    status: string;
+    /** Human-readable or raw status text from the provider. */
+    response: string;
+    /** Transport or provider identifier (e.g. `"whatsapp-cloud"`). */
+    provider?: string;
+}
+/** Pluggable WhatsApp delivery backend. */
+export interface WhatsAppTransport {
+    /**
+     * Stable provider identifier for observability (e.g. `"whatsapp-cloud"`).
+     * Prefer this over constructor-name inference in hooks.
+     */
+    readonly provider?: string;
+    /** Send a WhatsApp message through this transport. */
+    send(options: WhatsAppOptions): Promise<WhatsAppSendResult>;
+    /** Test connectivity and credentials without sending. */
+    verify?(): Promise<VerifyResult>;
+    /** Release resources held by the transport. */
+    close?(): Promise<void>;
+}
+/** Context passed to WhatsApp lifecycle hooks (no message body — avoids PII in logs). */
+export interface WhatsAppHookContext {
+    /** Message-ID when known (from options or send result). */
+    messageId?: string;
+    /** Recipient phone number. */
+    to: string;
+    /** Transport or provider identifier (e.g. `"whatsapp-cloud"`). */
+    provider: string;
+}
+/** Optional lifecycle hooks for metrics, tracing, and observability on every WhatsApp send. */
+export interface WhatsAppHooks {
+    /** Fired before the transport sends the message. */
+    onSend?: (ctx: WhatsAppHookContext) => void | Promise<void>;
+    /**
+     * Fired after a successful send.
+     * @param durationMs — elapsed milliseconds from send start to success (optional third argument).
+     */
+    onSuccess?: (ctx: WhatsAppHookContext, result: WhatsAppSendResult, durationMs?: number) => void | Promise<void>;
+    /**
+     * Fired when a send throws (error is re-thrown after the hook runs).
+     * @param durationMs — elapsed milliseconds from send start to failure (optional third argument).
+     */
+    onError?: (ctx: WhatsAppHookContext, error: unknown, durationMs?: number) => void | Promise<void>;
+}
+/**
+ * A WhatsApp plugin transforms {@link WhatsAppOptions} before the transport sends.
+ * Plugins run sequentially. Each receives the output of the previous.
+ * Return a new options object — do not mutate the input.
+ */
+export type WhatsAppPlugin = ((options: WhatsAppOptions) => WhatsAppOptions) | ((options: WhatsAppOptions) => Promise<WhatsAppOptions>);

package/dist/detect.js

@@ -1,3 +1,3 @@
-import{t as a,u as b}from"./chunk-74rha3ac.js";import"./chunk-keksa6fx.js";export{a as detectRuntime,b as createDefaultAdapter};
+import{J as a,K as b}from"./chunk-29z7fkzy.js";import"./chunk-6npp3x3c.js";export{a as detectRuntime,b as createDefaultAdapter};
 
-//# debugId=9582229C18BADC5064756E2164756E21
+//# debugId=D0D0974ACACB2BDE64756E2164756E21

package/dist/detect.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "9582229C18BADC5064756E2164756E21",
+  "debugId": "D0D0974ACACB2BDE64756E2164756E21",
   "names": []
 }

package/dist/dkim.js

@@ -1,4 +1,4 @@
-import{P as G,S as E}from"./chunk-d5rwm3br.js";import"./chunk-keksa6fx.js";var j=`\r
+import{Y as G,ba as E}from"./chunk-ywq6s10g.js";import"./chunk-6npp3x3c.js";var j=`\r
 `,C="from:to:subject:date:message-id:mime-version:content-type";function _(M,I){let x=F(M),K=[];for(let S of I){let Y=S.toLowerCase().trim(),z=x.get(Y);if(!z)continue;for(let D of z){let w=D.replace(/\r?\n/g,"").replace(/\s+/g," ").trim();K.push(`${Y}:${w}`)}}return K.length>0?`${K.join(j)}${j}`:""}function $(M){let x=M.replace(/\r\n/g,`
 `).replace(/\r/g,`
 `).split(`
@@ -6,4 +6,4 @@ import{P as G,S as E}from"./chunk-d5rwm3br.js";import"./chunk-keksa6fx.js";var j
 \r
 `),w=D>=0?z.slice(0,D):z,P=D>=0?z.slice(D+4):"",T=$(P),O=await k(E(T)),Q=x==="ed25519-sha256"?"ed25519-sha256":"rsa-sha256",X=Y.join(":"),Z=Math.floor(Date.now()/1000),W=["v=1",`a=${Q}`,"c=relaxed/relaxed",`d=${I.domainName}`,`s=${I.keySelector}`,`h=${X}`,`bh=${O}`,"b=",`t=${Z}`].join("; "),b="dkim-signature",H=`${w}${j}dkim-signature:${W}`,p=_(H,[...Y,"dkim-signature"]),A=await v(I.privateKey,x),R=E(p),U=await L(A,R,x),V=G(U).replace(/\r\n/g,"");return{header:`DKIM-Signature: v=1; a=${Q}; c=relaxed/relaxed; d=${I.domainName}; s=${I.keySelector}; h=${X}; bh=${O}; b=${V}; t=${Z}`}}function F(M){let I=new Map,x=M.split(/\r?\n/).filter((z)=>z.length>0),K="",S="",Y=()=>{if(!K)return;let z=K.toLowerCase(),D=I.get(z)??[];D.push(S),I.set(z,D),K="",S=""};for(let z of x){if(/^[ \t]/.test(z)&&K){S+=` ${z.trim()}`;continue}Y();let D=z.indexOf(":");if(D>0)K=z.slice(0,D).trim(),S=z.slice(D+1).trim()}return Y(),I}function B(M){let I=M.replace(/-----BEGIN[^-]+-----/g,"").replace(/-----END[^-]+-----/g,"").replace(/\s/g,""),x=atob(I),K=new Uint8Array(x.length);for(let S=0;S<x.length;S++)K[S]=x.charCodeAt(S);return K}function J(M){return M.buffer.slice(M.byteOffset,M.byteOffset+M.byteLength)}async function k(M){let I=await crypto.subtle.digest("SHA-256",J(M));return G(new Uint8Array(I)).replace(/\r\n/g,"")}async function L(M,I,x){let K=J(I);if(x==="ed25519-sha256"){let Y=await crypto.subtle.sign("Ed25519",M,K);return new Uint8Array(Y)}let S=await crypto.subtle.sign({name:"RSASSA-PKCS1-v1_5"},M,K);return new Uint8Array(S)}export{N as signDKIM,v as importPrivateKey,_ as canonicalizeHeadersRelaxed,$ as canonicalizeBodyRelaxed};
 
-//# debugId=E9167771F8AA372D64756E2164756E21
+//# debugId=16320E7654B927CA64756E2164756E21

package/dist/dkim.js.map

@@ -4,7 +4,7 @@
   "sourcesContent": [
     "/**\n * DKIM signing implementation (RFC 6376). Public entry: `sently/dkim`.\n */\nimport { encodeBase64, encodeUtf8 } from \"./base64.js\";\nimport type { DKIMConfig } from \"./types.js\";\n\nconst CRLF = \"\\r\\n\";\nconst DEFAULT_HEADER_FIELDS = \"from:to:subject:date:message-id:mime-version:content-type\";\n\n/** Result of DKIM signing — the header line to prepend. */\nexport interface DKIMSignResult {\n  /** Complete DKIM-Signature header line (without trailing CRLF). */\n  header: string;\n}\n\n/**\n * Canonicalize headers using the relaxed algorithm (RFC 6376 §3.4.2).\n */\nexport function canonicalizeHeadersRelaxed(headers: string, fieldNames: string[]): string {\n  const parsed = parseHeaders(headers);\n  const lines: string[] = [];\n\n  for (const name of fieldNames) {\n    const key = name.toLowerCase().trim();\n    const values = parsed.get(key);\n    if (!values) {\n      continue;\n    }\n    for (const value of values) {\n      const unfolded = value.replace(/\\r?\\n/g, \"\").replace(/\\s+/g, \" \").trim();\n      lines.push(`${key}:${unfolded}`);\n    }\n  }\n\n  return lines.length > 0 ? `${lines.join(CRLF)}${CRLF}` : \"\";\n}\n\n/**\n * Canonicalize body using the relaxed algorithm (RFC 6376 §3.4.4).\n */\nexport function canonicalizeBodyRelaxed(body: string): string {\n  const normalized = body.replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\");\n  const lines = normalized\n    .split(\"\\n\")\n    .map((line) => line.replace(/[ \\t]+$/g, \"\").replace(/[ \\t]+/g, \" \"))\n    .filter((line) => line.length > 0);\n  if (lines.length === 0) {\n    return CRLF;\n  }\n  return `${lines.join(CRLF)}${CRLF}`;\n}\n\n/**\n * Import a PEM-encoded private key into a Web Crypto CryptoKey.\n */\nexport async function importPrivateKey(\n  pem: string,\n  algorithm: \"rsa-sha256\" | \"ed25519-sha256\",\n): Promise<CryptoKey> {\n  if (algorithm === \"ed25519-sha256\" && /OPENSSH PRIVATE KEY/i.test(pem)) {\n    throw new Error(\n      \"Ed25519 keys must be in PKCS#8 PEM format (-----BEGIN PRIVATE KEY-----). Convert with: openssl pkcs8 -topk8 -nocrypt -in key.pem -out key_pkcs8.pem\",\n    );\n  }\n\n  const der = pemToDer(pem);\n\n  const derBuffer = toArrayBuffer(der);\n\n  try {\n    if (algorithm === \"ed25519-sha256\") {\n      return await crypto.subtle.importKey(\"pkcs8\", derBuffer, { name: \"Ed25519\" }, false, [\n        \"sign\",\n      ]);\n    }\n    return await crypto.subtle.importKey(\n      \"pkcs8\",\n      derBuffer,\n      { name: \"RSASSA-PKCS1-v1_5\", hash: \"SHA-256\" },\n      false,\n      [\"sign\"],\n    );\n  } catch (err) {\n    if (algorithm === \"ed25519-sha256\" && err instanceof DOMException) {\n      throw new Error(\"Ed25519 DKIM requires Node.js ≥ 18.4, Bun ≥ 1.0, or Cloudflare Workers\", {\n        cause: err,\n      });\n    }\n    throw err;\n  }\n}\n\n/**\n * Sign a raw MIME message with DKIM.\n */\nexport async function signDKIM(\n  rawMessage: Uint8Array,\n  config: DKIMConfig,\n): Promise<DKIMSignResult> {\n  const algorithm = config.algorithm ?? \"rsa-sha256\";\n  const fieldList = (config.headerFieldNames ?? DEFAULT_HEADER_FIELDS)\n    .split(\":\")\n    .map((f) => f.trim().toLowerCase())\n    .filter(Boolean);\n  const skip = new Set(\n    (config.skipFields ?? \"\")\n      .split(\":\")\n      .map((f) => f.trim().toLowerCase())\n      .filter(Boolean),\n  );\n  const signFields = fieldList.filter((f) => !skip.has(f));\n\n  const text = new TextDecoder().decode(rawMessage);\n  const sep = text.indexOf(\"\\r\\n\\r\\n\");\n  const headerPart = sep >= 0 ? text.slice(0, sep) : text;\n  const bodyPart = sep >= 0 ? text.slice(sep + 4) : \"\";\n\n  const bodyCanonical = canonicalizeBodyRelaxed(bodyPart);\n  const bodyHash = await sha256Base64(encodeUtf8(bodyCanonical));\n\n  const dkimAlgo = algorithm === \"ed25519-sha256\" ? \"ed25519-sha256\" : \"rsa-sha256\";\n  const headerList = signFields.join(\":\");\n  const timestamp = Math.floor(Date.now() / 1000);\n\n  const dkimWithoutSig = [\n    `v=1`,\n    `a=${dkimAlgo}`,\n    `c=relaxed/relaxed`,\n    `d=${config.domainName}`,\n    `s=${config.keySelector}`,\n    `h=${headerList}`,\n    `bh=${bodyHash}`,\n    `b=`,\n    `t=${timestamp}`,\n  ].join(\"; \");\n\n  const dkimHeaderName = \"dkim-signature\";\n  const dkimHeaderValue = dkimWithoutSig;\n  const headersWithDkim = `${headerPart}${CRLF}${dkimHeaderName}:${dkimHeaderValue}`;\n  const canonical = canonicalizeHeadersRelaxed(headersWithDkim, [...signFields, dkimHeaderName]);\n\n  const key = await importPrivateKey(config.privateKey, algorithm);\n  const data = encodeUtf8(canonical);\n  const signature = await signData(key, data, algorithm);\n  const bValue = encodeBase64(signature).replace(/\\r\\n/g, \"\");\n\n  const header = `DKIM-Signature: v=1; a=${dkimAlgo}; c=relaxed/relaxed; d=${config.domainName}; s=${config.keySelector}; h=${headerList}; bh=${bodyHash}; b=${bValue}; t=${timestamp}`;\n\n  return { header };\n}\n\nfunction parseHeaders(headerBlock: string): Map<string, string[]> {\n  const map = new Map<string, string[]>();\n  const lines = headerBlock.split(/\\r?\\n/).filter((l) => l.length > 0);\n  let currentName = \"\";\n  let currentValue = \"\";\n\n  const flush = (): void => {\n    if (!currentName) {\n      return;\n    }\n    const key = currentName.toLowerCase();\n    const list = map.get(key) ?? [];\n    list.push(currentValue);\n    map.set(key, list);\n    currentName = \"\";\n    currentValue = \"\";\n  };\n\n  for (const line of lines) {\n    if (/^[ \\t]/.test(line) && currentName) {\n      currentValue += ` ${line.trim()}`;\n      continue;\n    }\n    flush();\n    const colon = line.indexOf(\":\");\n    if (colon > 0) {\n      currentName = line.slice(0, colon).trim();\n      currentValue = line.slice(colon + 1).trim();\n    }\n  }\n  flush();\n  return map;\n}\n\nfunction pemToDer(pem: string): Uint8Array {\n  const lines = pem\n    .replace(/-----BEGIN[^-]+-----/g, \"\")\n    .replace(/-----END[^-]+-----/g, \"\")\n    .replace(/\\s/g, \"\");\n  const binary = atob(lines);\n  const der = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    der[i] = binary.charCodeAt(i);\n  }\n  return der;\n}\n\nfunction toArrayBuffer(bytes: Uint8Array): ArrayBuffer {\n  return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength) as ArrayBuffer;\n}\n\nasync function sha256Base64(data: Uint8Array): Promise<string> {\n  const hash = await crypto.subtle.digest(\"SHA-256\", toArrayBuffer(data));\n  return encodeBase64(new Uint8Array(hash)).replace(/\\r\\n/g, \"\");\n}\n\nasync function signData(\n  key: CryptoKey,\n  data: Uint8Array,\n  algorithm: \"rsa-sha256\" | \"ed25519-sha256\",\n): Promise<Uint8Array> {\n  const buf = toArrayBuffer(data);\n  if (algorithm === \"ed25519-sha256\") {\n    const sig = await crypto.subtle.sign(\"Ed25519\", key, buf);\n    return new Uint8Array(sig);\n  }\n  const sig = await crypto.subtle.sign({ name: \"RSASSA-PKCS1-v1_5\" }, key, buf);\n  return new Uint8Array(sig);\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "E9167771F8AA372D64756E2164756E21",
+  "mappings": "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",
+  "debugId": "16320E7654B927CA64756E2164756E21",
   "names": []
 }

package/dist/idempotency.d.ts

@@ -29,6 +29,7 @@ export interface IdempotencyTransportOptions {
 export declare class IdempotencyTransport implements Transport {
     /** Transport that performs the actual send when the key is new. */
     private readonly inner;
+    readonly provider = "idempotency";
     private readonly store;
     private readonly ttlMs;
     /** Wraps an inner transport with idempotency deduplication. */

package/dist/idempotency.js

@@ -1,3 +1,3 @@
-import{q as F}from"./chunk-qp4y0kp2.js";import{B,z as C}from"./chunk-gh5n759p.js";import"./chunk-d5rwm3br.js";import"./chunk-keksa6fx.js";class G{entries=new Map;async has(q){let w=this.entries.get(q);if(w===void 0)return!1;if(w<=Date.now())return this.entries.delete(q),!1;return!0}async set(q,w){let z=w!==void 0?Date.now()+w:Number.POSITIVE_INFINITY;this.entries.set(q,z)}}function H(q){let w=C(q.from)[0],z=[...B(q.to),...q.cc?B(q.cc):[],...q.bcc?B(q.bcc):[]];return{messageId:q.messageId??"",accepted:B(q.to),rejected:[],response:"Deduped — idempotency key already recorded",envelope:{from:w?.address??"",to:z},deduped:!0}}class J{inner;store;ttlMs;constructor(q,w){this.inner=q;this.store=w?.store??new G,this.ttlMs=w?.ttlMs??86400000}async send(q){let w=F(q);if(w===void 0)return this.inner.send(q);if(await this.store.has(w))return H(q);let z=await this.inner.send(q);return await this.store.set(w,this.ttlMs),z}async sendBatch(q){if(this.inner.sendBatch)return this.inner.sendBatch(q);return Promise.all(q.map((w)=>this.send(w)))}async verify(){if(this.inner.verify)return this.inner.verify();return{ok:!0,provider:"idempotency"}}async close(){await this.inner.close?.()}}export{G as MemoryIdempotencyStore,J as IdempotencyTransport};
+import{H as F}from"./chunk-8njyga62.js";import{Q as C,S as B}from"./chunk-93vqxxj2.js";import"./chunk-ywq6s10g.js";import"./chunk-6npp3x3c.js";class G{entries=new Map;async has(q){let w=this.entries.get(q);if(w===void 0)return!1;if(w<=Date.now())return this.entries.delete(q),!1;return!0}async set(q,w){let z=w!==void 0?Date.now()+w:Number.POSITIVE_INFINITY;this.entries.set(q,z)}}function H(q){let w=C(q.from)[0],z=[...B(q.to),...q.cc?B(q.cc):[],...q.bcc?B(q.bcc):[]];return{messageId:q.messageId??"",accepted:B(q.to),rejected:[],response:"Deduped — idempotency key already recorded",envelope:{from:w?.address??"",to:z},deduped:!0}}class J{inner;provider="idempotency";store;ttlMs;constructor(q,w){this.inner=q;this.store=w?.store??new G,this.ttlMs=w?.ttlMs??86400000}async send(q){let w=F(q);if(w===void 0)return this.inner.send(q);if(await this.store.has(w))return H(q);let z=await this.inner.send(q);return await this.store.set(w,this.ttlMs),z}async sendBatch(q){if(this.inner.sendBatch)return this.inner.sendBatch(q);return Promise.all(q.map((w)=>this.send(w)))}async verify(){if(this.inner.verify)return this.inner.verify();return{ok:!0,provider:"idempotency"}}async close(){await this.inner.close?.()}}export{G as MemoryIdempotencyStore,J as IdempotencyTransport};
 
-//# debugId=48F7CB8FE23D7A4364756E2164756E21
+//# debugId=FFD2A6F7847E144564756E2164756E21

package/dist/idempotency.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/idempotency.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * IdempotencyTransport — decorator that deduplicates sends on retry or replay.\n *\n * Wrap **outside** RetryTransport so all retry attempts share one key:\n *\n * ```ts\n * new IdempotencyTransport(new RetryTransport(inner))\n * ```\n *\n * For production, supply a shared store (Redis, Dragonfly, etc.).\n *\n * @example\n * ```ts\n * import { IdempotencyTransport, MemoryIdempotencyStore } from \"sently/idempotency\";\n * import { RetryTransport } from \"sently/transports/retry\";\n * import { ResendTransport } from \"sently/transports/resend\";\n *\n * const transport = new IdempotencyTransport(\n *   new RetryTransport(new ResendTransport({ apiKey })),\n *   { store: new MemoryIdempotencyStore(), ttlMs: 86_400_000 },\n * );\n * ```\n */\nimport { extractEmails, parseAddresses } from \"./core/address.js\";\nimport { resolveIdempotencyKey } from \"./core/idempotency-key.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"./core/types.js\";\n\n/** Key-value store for idempotency deduplication. */\nexport interface IdempotencyStore {\n  /** Returns true when the key was already recorded. */\n  has(key: string): Promise<boolean>;\n  /** Record a key, optionally expiring after `ttlMs` milliseconds. */\n  set(key: string, ttlMs?: number): Promise<void>;\n}\n\n/** In-memory idempotency store with optional TTL expiry. Suitable for single-process use. */\nexport class MemoryIdempotencyStore implements IdempotencyStore {\n  private readonly entries = new Map<string, number>();\n\n  /** Returns true when the key exists and has not expired. */\n  async has(key: string): Promise<boolean> {\n    const expiresAt = this.entries.get(key);\n    if (expiresAt === undefined) {\n      return false;\n    }\n    if (expiresAt <= Date.now()) {\n      this.entries.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  /** Record a key with optional TTL in milliseconds. */\n  async set(key: string, ttlMs?: number): Promise<void> {\n    const expiresAt = ttlMs !== undefined ? Date.now() + ttlMs : Number.POSITIVE_INFINITY;\n    this.entries.set(key, expiresAt);\n  }\n}\n\n/** Options for {@link IdempotencyTransport}. */\nexport interface IdempotencyTransportOptions {\n  /** Store used to track sent keys. Defaults to {@link MemoryIdempotencyStore}. */\n  store?: IdempotencyStore;\n  /** TTL in milliseconds for recorded keys. Default: 24 hours. */\n  ttlMs?: number;\n}\n\nfunction syntheticDedupedResult(options: MailOptions): SendResult {\n  const from = parseAddresses(options.from)[0];\n  const to = [\n    ...extractEmails(options.to),\n    ...(options.cc ? extractEmails(options.cc) : []),\n    ...(options.bcc ? extractEmails(options.bcc) : []),\n  ];\n\n  return {\n    messageId: options.messageId ?? \"\",\n    accepted: extractEmails(options.to),\n    rejected: [],\n    response: \"Deduped — idempotency key already recorded\",\n    envelope: {\n      from: from?.address ?? \"\",\n      to,\n    },\n    deduped: true,\n  };\n}\n\n/**\n * Transport decorator that skips duplicate sends when an idempotency key\n * was already recorded. Checks the store once before delegating to the inner\n * transport, so retries inside RetryTransport reuse the same key automatically.\n */\nexport class IdempotencyTransport implements Transport {\n  private readonly store: IdempotencyStore;\n  private readonly ttlMs: number;\n\n  /** Wraps an inner transport with idempotency deduplication. */\n  constructor(\n    /** Transport that performs the actual send when the key is new. */\n    private readonly inner: Transport,\n    options?: IdempotencyTransportOptions,\n  ) {\n    this.store = options?.store ?? new MemoryIdempotencyStore();\n    this.ttlMs = options?.ttlMs ?? 86_400_000;\n  }\n\n  /** Sends once per idempotency key; returns a synthetic result on duplicate keys. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const key = resolveIdempotencyKey(options);\n    if (key === undefined) {\n      return this.inner.send(options);\n    }\n\n    if (await this.store.has(key)) {\n      return syntheticDedupedResult(options);\n    }\n\n    const result = await this.inner.send(options);\n    await this.store.set(key, this.ttlMs);\n    return result;\n  }\n\n  /** Delegates batch sends to the inner transport when available. */\n  async sendBatch(messages: MailOptions[]): Promise<SendResult[]> {\n    if (this.inner.sendBatch) {\n      return this.inner.sendBatch(messages);\n    }\n    return Promise.all(messages.map((message) => this.send(message)));\n  }\n\n  /** Delegates to the inner transport verify or returns a default success result. */\n  async verify(): Promise<VerifyResult> {\n    if (this.inner.verify) {\n      return this.inner.verify();\n    }\n    return { ok: true, provider: \"idempotency\" };\n  }\n\n  /** Delegates close to the inner transport if available. */\n  async close(): Promise<void> {\n    await this.inner.close?.();\n  }\n}\n"
+    "/**\n * @module\n * IdempotencyTransport — decorator that deduplicates sends on retry or replay.\n *\n * Wrap **outside** RetryTransport so all retry attempts share one key:\n *\n * ```ts\n * new IdempotencyTransport(new RetryTransport(inner))\n * ```\n *\n * For production, supply a shared store (Redis, Dragonfly, etc.).\n *\n * @example\n * ```ts\n * import { IdempotencyTransport, MemoryIdempotencyStore } from \"sently/idempotency\";\n * import { RetryTransport } from \"sently/transports/retry\";\n * import { ResendTransport } from \"sently/transports/resend\";\n *\n * const transport = new IdempotencyTransport(\n *   new RetryTransport(new ResendTransport({ apiKey })),\n *   { store: new MemoryIdempotencyStore(), ttlMs: 86_400_000 },\n * );\n * ```\n */\nimport { extractEmails, parseAddresses } from \"./core/address.js\";\nimport { resolveIdempotencyKey } from \"./core/idempotency-key.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"./core/types.js\";\n\n/** Key-value store for idempotency deduplication. */\nexport interface IdempotencyStore {\n  /** Returns true when the key was already recorded. */\n  has(key: string): Promise<boolean>;\n  /** Record a key, optionally expiring after `ttlMs` milliseconds. */\n  set(key: string, ttlMs?: number): Promise<void>;\n}\n\n/** In-memory idempotency store with optional TTL expiry. Suitable for single-process use. */\nexport class MemoryIdempotencyStore implements IdempotencyStore {\n  private readonly entries = new Map<string, number>();\n\n  /** Returns true when the key exists and has not expired. */\n  async has(key: string): Promise<boolean> {\n    const expiresAt = this.entries.get(key);\n    if (expiresAt === undefined) {\n      return false;\n    }\n    if (expiresAt <= Date.now()) {\n      this.entries.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  /** Record a key with optional TTL in milliseconds. */\n  async set(key: string, ttlMs?: number): Promise<void> {\n    const expiresAt = ttlMs !== undefined ? Date.now() + ttlMs : Number.POSITIVE_INFINITY;\n    this.entries.set(key, expiresAt);\n  }\n}\n\n/** Options for {@link IdempotencyTransport}. */\nexport interface IdempotencyTransportOptions {\n  /** Store used to track sent keys. Defaults to {@link MemoryIdempotencyStore}. */\n  store?: IdempotencyStore;\n  /** TTL in milliseconds for recorded keys. Default: 24 hours. */\n  ttlMs?: number;\n}\n\nfunction syntheticDedupedResult(options: MailOptions): SendResult {\n  const from = parseAddresses(options.from)[0];\n  const to = [\n    ...extractEmails(options.to),\n    ...(options.cc ? extractEmails(options.cc) : []),\n    ...(options.bcc ? extractEmails(options.bcc) : []),\n  ];\n\n  return {\n    messageId: options.messageId ?? \"\",\n    accepted: extractEmails(options.to),\n    rejected: [],\n    response: \"Deduped — idempotency key already recorded\",\n    envelope: {\n      from: from?.address ?? \"\",\n      to,\n    },\n    deduped: true,\n  };\n}\n\n/**\n * Transport decorator that skips duplicate sends when an idempotency key\n * was already recorded. Checks the store once before delegating to the inner\n * transport, so retries inside RetryTransport reuse the same key automatically.\n */\nexport class IdempotencyTransport implements Transport {\n  readonly provider = \"idempotency\";\n\n  private readonly store: IdempotencyStore;\n  private readonly ttlMs: number;\n\n  /** Wraps an inner transport with idempotency deduplication. */\n  constructor(\n    /** Transport that performs the actual send when the key is new. */\n    private readonly inner: Transport,\n    options?: IdempotencyTransportOptions,\n  ) {\n    this.store = options?.store ?? new MemoryIdempotencyStore();\n    this.ttlMs = options?.ttlMs ?? 86_400_000;\n  }\n\n  /** Sends once per idempotency key; returns a synthetic result on duplicate keys. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const key = resolveIdempotencyKey(options);\n    if (key === undefined) {\n      return this.inner.send(options);\n    }\n\n    if (await this.store.has(key)) {\n      return syntheticDedupedResult(options);\n    }\n\n    const result = await this.inner.send(options);\n    await this.store.set(key, this.ttlMs);\n    return result;\n  }\n\n  /** Delegates batch sends to the inner transport when available. */\n  async sendBatch(messages: MailOptions[]): Promise<SendResult[]> {\n    if (this.inner.sendBatch) {\n      return this.inner.sendBatch(messages);\n    }\n    return Promise.all(messages.map((message) => this.send(message)));\n  }\n\n  /** Delegates to the inner transport verify or returns a default success result. */\n  async verify(): Promise<VerifyResult> {\n    if (this.inner.verify) {\n      return this.inner.verify();\n    }\n    return { ok: true, provider: \"idempotency\" };\n  }\n\n  /** Delegates close to the inner transport if available. */\n  async close(): Promise<void> {\n    await this.inner.close?.();\n  }\n}\n"
   ],
-  "mappings": "4JAqCO,AAAM,LAAmD,LAC7C,QAAU,IAAI,SAGzB,IAAG,CAAC,EAA+B,CACvC,IAAM,EAAY,KAAK,QAAQ,IAAI,CAAG,EACtC,GAAI,IAAc,OAChB,MAAO,GAET,GAAI,GAAa,KAAK,IAAI,EAExB,OADA,KAAK,QAAQ,OAAO,CAAG,EAChB,GAET,MAAO,QAIH,IAAG,CAAC,EAAa,EAA+B,CACpD,IAAM,EAAY,IAAU,OAAY,KAAK,IAAI,EAAI,EAAQ,OAAO,kBACpE,KAAK,QAAQ,IAAI,EAAK,CAAS,EAEnC,CAUA,SAAS,CAAsB,CAAC,EAAkC,CAChE,IAAM,EAAO,EAAe,EAAQ,IAAI,EAAE,GACpC,EAAK,CACT,GAAG,EAAc,EAAQ,EAAE,EAC3B,GAAI,EAAQ,GAAK,EAAc,EAAQ,EAAE,EAAI,CAAC,EAC9C,GAAI,EAAQ,IAAM,EAAc,EAAQ,GAAG,EAAI,CAAC,CAClD,EAEA,MAAO,CACL,UAAW,EAAQ,WAAa,GAChC,SAAU,EAAc,EAAQ,EAAE,EAClC,SAAU,CAAC,EACX,SAAU,6CACV,SAAU,CACR,KAAM,GAAM,SAAW,GACvB,IACF,EACA,QAAS,EACX,EAQK,MAAM,CAA0C,CAOlC,MANF,MACA,MAGjB,WAAW,CAEQ,EACjB,EACA,CAFiB,aAGjB,KAAK,MAAQ,GAAS,OAAS,IAAI,EACnC,KAAK,MAAQ,GAAS,OAAS,cAI3B,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAM,EAAsB,CAAO,EACzC,GAAI,IAAQ,OACV,OAAO,KAAK,MAAM,KAAK,CAAO,EAGhC,GAAI,MAAM,KAAK,MAAM,IAAI,CAAG,EAC1B,OAAO,EAAuB,CAAO,EAGvC,IAAM,EAAS,MAAM,KAAK,MAAM,KAAK,CAAO,EAE5C,OADA,MAAM,KAAK,MAAM,IAAI,EAAK,KAAK,KAAK,EAC7B,OAIH,UAAS,CAAC,EAAgD,CAC9D,GAAI,KAAK,MAAM,UACb,OAAO,KAAK,MAAM,UAAU,CAAQ,EAEtC,OAAO,QAAQ,IAAI,EAAS,IAAI,CAAC,IAAY,KAAK,KAAK,CAAO,CAAC,CAAC,OAI5D,OAAM,EAA0B,CACpC,GAAI,KAAK,MAAM,OACb,OAAO,KAAK,MAAM,OAAO,EAE3B,MAAO,CAAE,GAAI,GAAM,SAAU,aAAc,OAIvC,MAAK,EAAkB,CAC3B,MAAM,KAAK,MAAM,QAAQ,EAE7B",
-  "debugId": "48F7CB8FE23D7A4364756E2164756E21",
+  "mappings": "iKAqCO,AAAM,LAAmD,LAC7C,QAAU,IAAI,SAGzB,IAAG,CAAC,EAA+B,CACvC,IAAM,EAAY,KAAK,QAAQ,IAAI,CAAG,EACtC,GAAI,IAAc,OAChB,MAAO,GAET,GAAI,GAAa,KAAK,IAAI,EAExB,OADA,KAAK,QAAQ,OAAO,CAAG,EAChB,GAET,MAAO,QAIH,IAAG,CAAC,EAAa,EAA+B,CACpD,IAAM,EAAY,IAAU,OAAY,KAAK,IAAI,EAAI,EAAQ,OAAO,kBACpE,KAAK,QAAQ,IAAI,EAAK,CAAS,EAEnC,CAUA,SAAS,CAAsB,CAAC,EAAkC,CAChE,IAAM,EAAO,EAAe,EAAQ,IAAI,EAAE,GACpC,EAAK,CACT,GAAG,EAAc,EAAQ,EAAE,EAC3B,GAAI,EAAQ,GAAK,EAAc,EAAQ,EAAE,EAAI,CAAC,EAC9C,GAAI,EAAQ,IAAM,EAAc,EAAQ,GAAG,EAAI,CAAC,CAClD,EAEA,MAAO,CACL,UAAW,EAAQ,WAAa,GAChC,SAAU,EAAc,EAAQ,EAAE,EAClC,SAAU,CAAC,EACX,SAAU,6CACV,SAAU,CACR,KAAM,GAAM,SAAW,GACvB,IACF,EACA,QAAS,EACX,EAQK,MAAM,CAA0C,CASlC,MARV,SAAW,cAEH,MACA,MAGjB,WAAW,CAEQ,EACjB,EACA,CAFiB,aAGjB,KAAK,MAAQ,GAAS,OAAS,IAAI,EACnC,KAAK,MAAQ,GAAS,OAAS,cAI3B,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAM,EAAsB,CAAO,EACzC,GAAI,IAAQ,OACV,OAAO,KAAK,MAAM,KAAK,CAAO,EAGhC,GAAI,MAAM,KAAK,MAAM,IAAI,CAAG,EAC1B,OAAO,EAAuB,CAAO,EAGvC,IAAM,EAAS,MAAM,KAAK,MAAM,KAAK,CAAO,EAE5C,OADA,MAAM,KAAK,MAAM,IAAI,EAAK,KAAK,KAAK,EAC7B,OAIH,UAAS,CAAC,EAAgD,CAC9D,GAAI,KAAK,MAAM,UACb,OAAO,KAAK,MAAM,UAAU,CAAQ,EAEtC,OAAO,QAAQ,IAAI,EAAS,IAAI,CAAC,IAAY,KAAK,KAAK,CAAO,CAAC,CAAC,OAI5D,OAAM,EAA0B,CACpC,GAAI,KAAK,MAAM,OACb,OAAO,KAAK,MAAM,OAAO,EAE3B,MAAO,CAAE,GAAI,GAAM,SAAU,aAAc,OAIvC,MAAK,EAAkB,CAC3B,MAAM,KAAK,MAAM,QAAQ,EAE7B",
+  "debugId": "FFD2A6F7847E144564756E2164756E21",
   "names": []
 }

package/dist/index.d.ts

@@ -2,8 +2,11 @@
  * @module
  * Main sently entrypoint — shared types, mailer factories, runtime detection, and OAuth2.
  *
- * Import transports, webhooks, idempotency, DKIM, and plugins from their subpaths
- * (e.g. `sently/transports/resend`, `sently/webhooks`) for the smallest bundle.
+ * Import provider transports and webhook parsers from their subpaths
+ * (e.g. `sently/transports/resend`, `sently/transports/sndr`, `sently/webhooks/sndr`)
+ * for the smallest bundle. The main barrel only re-exports core APIs plus
+ * routing helpers (`FallbackTransport`, `WeightedFallbackTransport`) and
+ * `CloudflareEmailTransport`.
  *
  * @example
  * ```ts
@@ -45,5 +48,24 @@ export {
 /** Create a mailer for custom transports (HTTP APIs, preview, retry). Prefer `sently/mailer` for smallest bundles. */
 createMailer, } from "./mailer.js";
 export { 
+/** Ready-made console logging hooks for mailer lifecycle events. */
+consoleObserver, } from "./observability/console.js";
+export { 
 /** Create a mailer from SMTP host/port config (pooling, adapters). Prefer `sently/smtp` for smallest SMTP bundles. */
 createSMTPMailer, } from "./smtp-mailer.js";
+export type { CloudflareEmailConfig, CloudflareEmailMessage, CloudflareSendEmailFn, } from "./transports/cloudflare-email.js";
+export { 
+/** Error thrown when the Cloudflare Email binding rejects a send. */
+CloudflareEmailError, 
+/** Cloudflare Workers `send_email` binding transport. */
+CloudflareEmailTransport, } from "./transports/cloudflare-email.js";
+export type { FallbackAttempt, FallbackOptions, FallbackProviderVerifyResult, FallbackVerifyAllResult, } from "./transports/fallback.js";
+export { 
+/** Thrown when every transport in a fallback chain fails. */
+FallbackError, 
+/** Provider failover decorator — routes through an ordered list of transports. */
+FallbackTransport, } from "./transports/fallback.js";
+export type { WeightedTransportEntry } from "./transports/weighted-fallback.js";
+export { 
+/** Weighted provider routing with failover on error. */
+WeightedFallbackTransport, } from "./transports/weighted-fallback.js";

package/dist/index.js

@@ -24,7 +24,30 @@ export {
   
   createMailer,
 } from "./mailer.js";
+export {
+  
+  consoleObserver,
+} from "./observability/console.js";
 export {
   
   createSMTPMailer,
 } from "./smtp-mailer.js";
+
+export {
+  
+  CloudflareEmailError,
+  
+  CloudflareEmailTransport,
+} from "./transports/cloudflare-email.js";
+
+export {
+  
+  FallbackError,
+  
+  FallbackTransport,
+} from "./transports/fallback.js";
+
+export {
+  
+  WeightedFallbackTransport,
+} from "./transports/weighted-fallback.js";

package/dist/mailer.js

@@ -1,3 +1,3 @@
-import{v as a,w as b}from"./chunk-ka6t8g77.js";import"./chunk-kebhy657.js";import"./chunk-gh5n759p.js";import"./chunk-d5rwm3br.js";import"./chunk-a1c87hn1.js";import"./chunk-keksa6fx.js";export{a as createMailer,b as MailerImpl};
+import{L as a,M as b}from"./chunk-5915vbcj.js";import"./chunk-gp4fwrs8.js";import"./chunk-0qxws3kj.js";import"./chunk-93vqxxj2.js";import"./chunk-qtkd5bak.js";import"./chunk-ywq6s10g.js";import"./chunk-tamww15j.js";import"./chunk-6npp3x3c.js";export{a as createMailer,b as MailerImpl};
 
-//# debugId=473A1A6D56DBB5E664756E2164756E21
+//# debugId=E91F43209A181C3464756E2164756E21

package/dist/mailer.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "473A1A6D56DBB5E664756E2164756E21",
+  "debugId": "E91F43209A181C3464756E2164756E21",
   "names": []
 }

package/dist/observability/console.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module
+ * Ready-made observability helpers for sently.
+ */
+import type { MailerHooks } from "../core/types.js";
+/**
+ * Returns {@link MailerHooks} that log lifecycle events to the console.
+ * For production, write your own hooks targeting your metrics/tracing system.
+ *
+ * @param prefix — log line prefix. Default: `'[sently]'`.
+ */
+export declare function consoleObserver(prefix?: string): MailerHooks;

package/dist/observability/console.js

@@ -0,0 +1,3 @@
+import"../chunk-6npp3x3c.js";function E(A="[sently]"){return{onSend:({subject:q})=>{console.log(`${A} sending: ${q}`)},onSuccess:({subject:q},C,z)=>{let B=z!==void 0?` (${z.toFixed(0)}ms)`:"";console.log(`${A} sent: ${q}${B}`)},onError:({subject:q},C,z)=>{let B=z!==void 0?` (${z.toFixed(0)}ms)`:"";console.error(`${A} failed: ${q}${B}`,C)}}}export{E as consoleObserver};
+
+//# debugId=0D8FEC4487F45FD464756E2164756E21

package/dist/observability/console.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/observability/console.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Ready-made observability helpers for sently.\n */\nimport type { MailerHooks } from \"../core/types.js\";\n\n/**\n * Returns {@link MailerHooks} that log lifecycle events to the console.\n * For production, write your own hooks targeting your metrics/tracing system.\n *\n * @param prefix — log line prefix. Default: `'[sently]'`.\n */\nexport function consoleObserver(prefix = \"[sently]\"): MailerHooks {\n  return {\n    onSend: ({ subject }) => {\n      console.log(`${prefix} sending: ${subject}`);\n    },\n    onSuccess: ({ subject }, _result, durationMs) => {\n      const timing = durationMs !== undefined ? ` (${durationMs.toFixed(0)}ms)` : \"\";\n      console.log(`${prefix} sent: ${subject}${timing}`);\n    },\n    onError: ({ subject }, error, durationMs) => {\n      const timing = durationMs !== undefined ? ` (${durationMs.toFixed(0)}ms)` : \"\";\n      console.error(`${prefix} failed: ${subject}${timing}`, error);\n    },\n  };\n}\n"
+  ],
+  "mappings": "6BAYO,SAAS,CAAe,CAAC,EAAS,WAAyB,CAChE,MAAO,CACL,OAAQ,EAAG,aAAc,CACvB,QAAQ,IAAI,GAAG,cAAmB,GAAS,GAE7C,UAAW,EAAG,WAAW,EAAS,IAAe,CAC/C,IAAM,EAAS,IAAe,OAAY,KAAK,EAAW,QAAQ,CAAC,OAAS,GAC5E,QAAQ,IAAI,GAAG,WAAgB,IAAU,GAAQ,GAEnD,QAAS,EAAG,WAAW,EAAO,IAAe,CAC3C,IAAM,EAAS,IAAe,OAAY,KAAK,EAAW,QAAQ,CAAC,OAAS,GAC5E,QAAQ,MAAM,GAAG,aAAkB,IAAU,IAAU,CAAK,EAEhE",
+  "debugId": "0D8FEC4487F45FD464756E2164756E21",
+  "names": []
+}

package/dist/plugins/react.js

@@ -1,3 +1,3 @@
-import{W as B}from"../chunk-keksa6fx.js";function F(){return async(j)=>{if(j.react===void 0||j.react===null)return j;let{render:k}=await import("@react-email/render"),q=j.html??await k(j.react,{pretty:!1}),z=j.text??await k(j.react,{plainText:!0}),{react:D,...A}=j;return{...A,html:q,text:z}}}export{F as reactPlugin};
+import{fa as B}from"../chunk-6npp3x3c.js";function F(){return async(j)=>{if(j.react===void 0||j.react===null)return j;let{render:k}=await import("@react-email/render"),q=j.html??await k(j.react,{pretty:!1}),z=j.text??await k(j.react,{plainText:!0}),{react:D,...A}=j;return{...A,html:q,text:z}}}export{F as reactPlugin};
 
-//# debugId=311F9607C4B15F8264756E2164756E21
+//# debugId=688D707C4B4EB1C964756E2164756E21

package/dist/plugins/react.js.map

@@ -4,7 +4,7 @@
   "sourcesContent": [
     "/**\n * @module\n * React Email plugin for sently.\n * Renders a React element to HTML and plain text via `@react-email/render`.\n *\n * @example\n * ```ts\n * import { reactPlugin } from \"sently/react\";\n * import { WelcomeEmail } from \"./emails/welcome\";\n *\n * const mailer = await createMailer({\n *   transport: new ResendTransport({ apiKey }),\n *   plugins: [reactPlugin()],\n * });\n *\n * await mailer.send({\n *   from: \"...\",\n *   to: \"...\",\n *   subject: \"Welcome!\",\n *   react: WelcomeEmail({ name: \"Ali\" }),\n * });\n * ```\n */\nimport type { MailOptions, MailPlugin } from \"../core/types.js\";\n\n/** Mail options with a React element body (requires `react` peer). */\nexport interface ReactMailOptions extends Omit<MailOptions, \"react\"> {\n  /** React element rendered to html + text by the react plugin. */\n  react?: import(\"react\").ReactElement;\n}\n\n/**\n * Create a plugin that renders `options.react` to HTML and plain text.\n * Explicit `html` / `text` values always win. The `react` field is stripped\n * before options reach the transport.\n */\nexport function reactPlugin(): MailPlugin {\n  return async (options: MailOptions): Promise<MailOptions> => {\n    if (options.react === undefined || options.react === null) {\n      return options;\n    }\n\n    const { render } = await import(\"@react-email/render\");\n\n    const html =\n      options.html ??\n      (await render(options.react as Parameters<typeof render>[0], { pretty: false }));\n\n    const text =\n      options.text ??\n      (await render(options.react as Parameters<typeof render>[0], { plainText: true }));\n\n    const { react: _react, ...rest } = options;\n    return { ...rest, html, text };\n  };\n}\n"
   ],
-  "mappings": "yCAoCO,SAAS,CAAW,EAAe,CACxC,MAAO,OAAO,IAA+C,CAC3D,GAAI,EAAQ,QAAU,QAAa,EAAQ,QAAU,KACnD,OAAO,EAGT,IAAQ,UAAW,KAAa,+BAE1B,EACJ,EAAQ,MACP,MAAM,EAAO,EAAQ,MAAuC,CAAE,OAAQ,EAAM,CAAC,EAE1E,EACJ,EAAQ,MACP,MAAM,EAAO,EAAQ,MAAuC,CAAE,UAAW,EAAK,CAAC,GAE1E,MAAO,KAAW,GAAS,EACnC,MAAO,IAAK,EAAM,OAAM,MAAK",
-  "debugId": "311F9607C4B15F8264756E2164756E21",
+  "mappings": "0CAoCO,SAAS,CAAW,EAAe,CACxC,MAAO,OAAO,IAA+C,CAC3D,GAAI,EAAQ,QAAU,QAAa,EAAQ,QAAU,KACnD,OAAO,EAGT,IAAQ,UAAW,KAAa,+BAE1B,EACJ,EAAQ,MACP,MAAM,EAAO,EAAQ,MAAuC,CAAE,OAAQ,EAAM,CAAC,EAE1E,EACJ,EAAQ,MACP,MAAM,EAAO,EAAQ,MAAuC,CAAE,UAAW,EAAK,CAAC,GAE1E,MAAO,KAAW,GAAS,EACnC,MAAO,IAAK,EAAM,OAAM,MAAK",
+  "debugId": "688D707C4B4EB1C964756E2164756E21",
   "names": []
 }

package/dist/plugins/template.js

@@ -1,3 +1,3 @@
-import"../chunk-keksa6fx.js";function E(q,j){return q.replace(/\{\{(\w+)\}\}/g,(z,A)=>{let w=j[A];return w!==void 0&&w!==null?String(w):""})}function F(q){return(j)=>{if(!j.template)return j;let z=q.templates[j.template];if(!z)throw Error(`sently: template "${j.template}" not found`);let A=q.engine(z,j.data??{}),{template:w,data:D,...B}=j;return{...B,html:A}}}export{F as templatePlugin,E as simpleEngine};
+import"../chunk-6npp3x3c.js";function E(q,j){return q.replace(/\{\{(\w+)\}\}/g,(z,A)=>{let w=j[A];return w!==void 0&&w!==null?String(w):""})}function F(q){return(j)=>{if(!j.template)return j;let z=q.templates[j.template];if(!z)throw Error(`sently: template "${j.template}" not found`);let A=q.engine(z,j.data??{}),{template:w,data:D,...B}=j;return{...B,html:A}}}export{F as templatePlugin,E as simpleEngine};
 
 //# debugId=094B3D1AC9B011AB64756E2164756E21

package/dist/pool/pool.js

@@ -1,3 +1,3 @@
-import{i as B,j as Q,k as U,l as V}from"../chunk-4mvp3b85.js";import"../chunk-rm78s1ek.js";import{r as K}from"../chunk-gkkv7yqm.js";import{s as N}from"../chunk-r7ee9tk7.js";import{x as G}from"../chunk-kebhy657.js";import"../chunk-gh5n759p.js";import"../chunk-cvrbfke9.js";import"../chunk-d5rwm3br.js";import"../chunk-a1c87hn1.js";import"../chunk-keksa6fx.js";async function W(k){let q=B(k.config),w=await k.createAdapter();await w.connect(k.connectHost,q.port),await Q(w,q);let z=0,D=!0,F=Promise.resolve(),X=k.maxMessages;return{get idle(){return D},get messageCount(){return z},get usable(){return z<X},async send(H){let Y=async()=>{D=!1;try{let Z={...H,attachments:await N(H.attachments)},_=await K(Z,q.dkim),$=await U(w,_);return z+=1,$}finally{D=!0}},J=F.then(Y);return F=J.then(()=>{return},()=>{return}),J},async close(){await F,await V(w)}}}class b{config;maxConnections;maxMessages;createAdapterFn;rateLimiter;connections=[];queue=[];draining=!1;closed=!1;processChain=Promise.resolve();constructor(k,q){if(this.config=k,this.maxConnections=k.maxConnections??5,this.maxMessages=k.maxMessages??100,q?.createAdapter){let w=q.createAdapter;this.createAdapterFn=async()=>w()}else if(k.adapter)this.createAdapterFn=async()=>k.adapter;else throw Error("SMTPPool requires config.adapter or options.createAdapter");if(k.rateDelta!==void 0&&k.rateDelta>0)this.rateLimiter=new G(k.rateDelta,k.rateLimit??1000,q?.now);else this.rateLimiter=null}async send(k){if(this.draining)throw Error("SMTPPool is closing — no new messages accepted");if(this.closed)throw Error("SMTPPool is closed");if(this.rateLimiter)await this.rateLimiter.acquire();return new Promise((q,w)=>{this.queue.push({options:k,resolve:q,reject:w}),this.scheduleProcess()})}scheduleProcess(){this.processChain=this.processChain.then(()=>this.processQueue()).catch(()=>{return})}async verify(){try{let k=await this.spawnConnection();try{return{ok:!0,provider:"smtp-pool"}}finally{await k.close(),this.removeConnection(k)}}catch(k){return{ok:!1,provider:"smtp-pool",message:k instanceof Error?k.message:String(k)}}}async close(){this.draining=!0,await this.drainQueue(),await Promise.allSettled(this.connections.map((k)=>k.close())),this.connections.length=0,this.closed=!0}get connectionCount(){return this.connections.length}get queueSize(){return this.queue.length}async processQueue(){if(this.draining)return;while(this.queue.length>0){let k=this.connections.find((q)=>q.idle&&q.usable);if(k){let q=this.queue.shift();if(!q)break;try{let w=await k.send(q.options);if(q.resolve(w),!k.usable)await k.close(),this.removeConnection(k)}catch(w){q.reject(w),await k.close().catch(()=>{return}),this.removeConnection(k)}continue}if(this.connections.length<this.maxConnections){let q=this.queue.shift();if(!q)break;let w=await this.spawnConnection();try{let z=await w.send(q.options);if(q.resolve(z),!w.usable)await w.close(),this.removeConnection(w)}catch(z){q.reject(z),await w.close().catch(()=>{return}),this.removeConnection(w)}continue}break}}async spawnConnection(){let k=B(this.config),q=await W({config:this.config,maxMessages:this.maxMessages,connectHost:k.host,createAdapter:this.createAdapterFn});return this.connections.push(q),q}removeConnection(k){let q=this.connections.indexOf(k);if(q>=0)this.connections.splice(q,1)}async drainQueue(){while(this.queue.length>0||this.connections.some((k)=>!k.idle))if(await this.processQueue(),this.queue.length>0)await new Promise((k)=>setTimeout(k,10))}}export{b as SMTPPool,G as RateLimiter};
+import{m as B,n as Q,o as U,p as V}from"../chunk-vjpds2pf.js";import"../chunk-b602dhck.js";import{u as K}from"../chunk-8dty8c4p.js";import"../chunk-n0qeyzqm.js";import{I as N}from"../chunk-skqhj0rm.js";import{O as G}from"../chunk-0qxws3kj.js";import"../chunk-93vqxxj2.js";import"../chunk-ywq6s10g.js";import"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";async function W(k){let q=B(k.config),w=await k.createAdapter();await w.connect(k.connectHost,q.port),await Q(w,q);let z=0,D=!0,F=Promise.resolve(),X=k.maxMessages;return{get idle(){return D},get messageCount(){return z},get usable(){return z<X},async send(H){let Y=async()=>{D=!1;try{let Z={...H,attachments:await N(H.attachments)},_=await K(Z,q.dkim),$=await U(w,_);return z+=1,$}finally{D=!0}},J=F.then(Y);return F=J.then(()=>{return},()=>{return}),J},async close(){await F,await V(w)}}}class b{config;maxConnections;maxMessages;createAdapterFn;rateLimiter;connections=[];queue=[];draining=!1;closed=!1;processChain=Promise.resolve();constructor(k,q){if(this.config=k,this.maxConnections=k.maxConnections??5,this.maxMessages=k.maxMessages??100,q?.createAdapter){let w=q.createAdapter;this.createAdapterFn=async()=>w()}else if(k.adapter)this.createAdapterFn=async()=>k.adapter;else throw Error("SMTPPool requires config.adapter or options.createAdapter");if(k.rateDelta!==void 0&&k.rateDelta>0)this.rateLimiter=new G(k.rateDelta,k.rateLimit??1000,q?.now);else this.rateLimiter=null}async send(k){if(this.draining)throw Error("SMTPPool is closing — no new messages accepted");if(this.closed)throw Error("SMTPPool is closed");if(this.rateLimiter)await this.rateLimiter.acquire();return new Promise((q,w)=>{this.queue.push({options:k,resolve:q,reject:w}),this.scheduleProcess()})}scheduleProcess(){this.processChain=this.processChain.then(()=>this.processQueue()).catch(()=>{return})}async verify(){try{let k=await this.spawnConnection();try{return{ok:!0,provider:"smtp-pool"}}finally{await k.close(),this.removeConnection(k)}}catch(k){return{ok:!1,provider:"smtp-pool",message:k instanceof Error?k.message:String(k)}}}async close(){this.draining=!0,await this.drainQueue(),await Promise.allSettled(this.connections.map((k)=>k.close())),this.connections.length=0,this.closed=!0}get connectionCount(){return this.connections.length}get queueSize(){return this.queue.length}async processQueue(){if(this.draining)return;while(this.queue.length>0){let k=this.connections.find((q)=>q.idle&&q.usable);if(k){let q=this.queue.shift();if(!q)break;try{let w=await k.send(q.options);if(q.resolve(w),!k.usable)await k.close(),this.removeConnection(k)}catch(w){q.reject(w),await k.close().catch(()=>{return}),this.removeConnection(k)}continue}if(this.connections.length<this.maxConnections){let q=this.queue.shift();if(!q)break;let w=await this.spawnConnection();try{let z=await w.send(q.options);if(q.resolve(z),!w.usable)await w.close(),this.removeConnection(w)}catch(z){q.reject(z),await w.close().catch(()=>{return}),this.removeConnection(w)}continue}break}}async spawnConnection(){let k=B(this.config),q=await W({config:this.config,maxMessages:this.maxMessages,connectHost:k.host,createAdapter:this.createAdapterFn});return this.connections.push(q),q}removeConnection(k){let q=this.connections.indexOf(k);if(q>=0)this.connections.splice(q,1)}async drainQueue(){while(this.queue.length>0||this.connections.some((k)=>!k.idle))if(await this.processQueue(),this.queue.length>0)await new Promise((k)=>setTimeout(k,10))}}export{b as SMTPPool,G as RateLimiter};
 
-//# debugId=EEBF20CE45142C1F64756E2164756E21
+//# debugId=47D346C1EF337DEF64756E2164756E21

package/dist/pool/pool.js.map

@@ -6,6 +6,6 @@
     "/**\n * @module\n * SMTP connection pool with optional rate limiting.\n *\n * @example\n * ```ts\n * import { SMTPPool } from \"sently/pool\";\n * import { NodeAdapter } from \"sently/adapters/node\";\n *\n * const pool = new SMTPPool({\n *   host: \"smtp.example.com\",\n *   auth: { user: \"you@example.com\", pass: \"secret\" },\n *   adapter: new NodeAdapter(),\n *   pool: true,\n *   maxConnections: 5,\n * });\n *\n * await pool.send({\n *   from: \"you@example.com\",\n *   to: \"recipient@example.com\",\n *   subject: \"Hello\",\n *   text: \"Pooled send\",\n * });\n * ```\n */\n\nimport { RateLimiter } from \"../core/rate-limiter.js\";\nimport type {\n  MailOptions,\n  PoolConfig,\n  SendResult,\n  SMTPConfig,\n  SocketAdapter,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\nimport { resolveSMTPConfig } from \"../transports/smtp.js\";\nimport { createPooledConnection, type PooledConnection } from \"./connection.js\";\n\n/** Options for {@link SMTPPool}. */\nexport interface SMTPPoolOptions {\n  /** Factory for a new socket adapter per pooled connection. */\n  createAdapter?: () => Promise<SocketAdapter> | SocketAdapter;\n  /** Injectable clock for rate limiting (testing). */\n  now?: () => number;\n}\n\ninterface QueueEntry {\n  options: MailOptions;\n  resolve: (result: SendResult) => void;\n  reject: (error: unknown) => void;\n}\n\n/**\n * SMTP connection pool with optional rate limiting.\n */\nexport class SMTPPool implements Transport {\n  /** Resolved SMTP and pool configuration. */\n  private readonly config: SMTPConfig & PoolConfig;\n  /** Maximum simultaneous pooled connections. */\n  private readonly maxConnections: number;\n  /** Maximum messages per connection before recycle. */\n  private readonly maxMessages: number;\n  /** Factory that creates a socket adapter for each new connection. */\n  private readonly createAdapterFn: () => Promise<SocketAdapter>;\n  /** Optional token-bucket rate limiter, or null when disabled. */\n  private readonly rateLimiter: RateLimiter | null;\n  /** Active pooled SMTP connections. */\n  private readonly connections: PooledConnection[] = [];\n  /** Pending send operations waiting for a connection. */\n  private readonly queue: QueueEntry[] = [];\n  /** True while {@link close} is draining; rejects new sends. */\n  private draining = false;\n  /** True after the pool has fully closed. */\n  private closed = false;\n  /** Serializes queue processing to avoid concurrent drain races. */\n  private processChain: Promise<void> = Promise.resolve();\n\n  /** Creates an SMTP connection pool. */\n  constructor(config: SMTPConfig & PoolConfig, options?: SMTPPoolOptions) {\n    this.config = config;\n    this.maxConnections = config.maxConnections ?? 5;\n    this.maxMessages = config.maxMessages ?? 100;\n\n    if (options?.createAdapter) {\n      const factory = options.createAdapter;\n      this.createAdapterFn = async () => factory();\n    } else if (config.adapter) {\n      this.createAdapterFn = async () => config.adapter as SocketAdapter;\n    } else {\n      throw new Error(\"SMTPPool requires config.adapter or options.createAdapter\");\n    }\n\n    if (config.rateDelta !== undefined && config.rateDelta > 0) {\n      this.rateLimiter = new RateLimiter(config.rateDelta, config.rateLimit ?? 1000, options?.now);\n    } else {\n      this.rateLimiter = null;\n    }\n  }\n\n  /** Sends a message through the pool. */\n  async send(options: MailOptions): Promise<SendResult> {\n    if (this.draining) {\n      throw new Error(\"SMTPPool is closing — no new messages accepted\");\n    }\n    if (this.closed) {\n      throw new Error(\"SMTPPool is closed\");\n    }\n    if (this.rateLimiter) {\n      await this.rateLimiter.acquire();\n    }\n    return new Promise<SendResult>((resolve, reject) => {\n      this.queue.push({ options, resolve, reject });\n      this.scheduleProcess();\n    });\n  }\n\n  /** Schedules asynchronous processing of the send queue. */\n  private scheduleProcess(): void {\n    this.processChain = this.processChain.then(() => this.processQueue()).catch(() => undefined);\n  }\n\n  /** Verifies connectivity using a temporary connection. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const conn = await this.spawnConnection();\n      try {\n        return { ok: true, provider: \"smtp-pool\" };\n      } finally {\n        await conn.close();\n        this.removeConnection(conn);\n      }\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"smtp-pool\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  /** Drains the queue and closes all connections. */\n  async close(): Promise<void> {\n    this.draining = true;\n    await this.drainQueue();\n    await Promise.allSettled(this.connections.map((c) => c.close()));\n    this.connections.length = 0;\n    this.closed = true;\n  }\n\n  /** Current number of open pooled connections. */\n  get connectionCount(): number {\n    return this.connections.length;\n  }\n\n  /** Number of messages waiting in the send queue. */\n  get queueSize(): number {\n    return this.queue.length;\n  }\n\n  /** Dispatches queued messages to idle or newly spawned connections. */\n  private async processQueue(): Promise<void> {\n    if (this.draining) {\n      return;\n    }\n\n    while (this.queue.length > 0) {\n      const idleConn = this.connections.find((c) => c.idle && c.usable);\n      if (idleConn) {\n        const entry = this.queue.shift();\n        if (!entry) {\n          break;\n        }\n        try {\n          const result = await idleConn.send(entry.options);\n          entry.resolve(result);\n          if (!idleConn.usable) {\n            await idleConn.close();\n            this.removeConnection(idleConn);\n          }\n        } catch (err) {\n          entry.reject(err);\n          await idleConn.close().catch(() => undefined);\n          this.removeConnection(idleConn);\n        }\n        continue;\n      }\n\n      if (this.connections.length < this.maxConnections) {\n        const entry = this.queue.shift();\n        if (!entry) {\n          break;\n        }\n        const conn = await this.spawnConnection();\n        try {\n          const result = await conn.send(entry.options);\n          entry.resolve(result);\n          if (!conn.usable) {\n            await conn.close();\n            this.removeConnection(conn);\n          }\n        } catch (err) {\n          entry.reject(err);\n          await conn.close().catch(() => undefined);\n          this.removeConnection(conn);\n        }\n        continue;\n      }\n\n      break;\n    }\n  }\n\n  /** Opens a new authenticated pooled SMTP connection. */\n  private async spawnConnection(): Promise<PooledConnection> {\n    const resolved = resolveSMTPConfig(this.config);\n    const conn = await createPooledConnection({\n      config: this.config,\n      maxMessages: this.maxMessages,\n      connectHost: resolved.host,\n      createAdapter: this.createAdapterFn,\n    });\n    this.connections.push(conn);\n    return conn;\n  }\n\n  /** Removes a connection from the active pool list. */\n  private removeConnection(conn: PooledConnection): void {\n    const index = this.connections.indexOf(conn);\n    if (index >= 0) {\n      this.connections.splice(index, 1);\n    }\n  }\n\n  /** Waits until the send queue and in-flight work are fully drained. */\n  private async drainQueue(): Promise<void> {\n    while (this.queue.length > 0 || this.connections.some((c) => !c.idle)) {\n      await this.processQueue();\n      if (this.queue.length > 0) {\n        await new Promise((r) => setTimeout(r, 10));\n      }\n    }\n  }\n}\n\n/** @internal Exposed for deterministic rate limiter tests. */\nexport { RateLimiter } from \"../core/rate-limiter.js\";\n"
   ],
   "mappings": "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",
-  "debugId": "EEBF20CE45142C1F64756E2164756E21",
+  "debugId": "47D346C1EF337DEF64756E2164756E21",
   "names": []
 }

package/dist/push.d.ts

@@ -0,0 +1,26 @@
+import type { PushHooks, PushOptions, PushPlugin, PushSendResult, PushTransport } from "./core/push-types.js";
+import type { VerifyResult } from "./core/types.js";
+/** Configuration for {@link createPushSender}. */
+export interface PushSenderConfig {
+    /** Push delivery transport. */
+    transport: PushTransport;
+    /** Optional plugins run before each send. */
+    plugins?: PushPlugin[];
+    /** Optional lifecycle hooks for metrics and tracing. */
+    hooks?: PushHooks;
+}
+/** Push sender returned by {@link createPushSender}. */
+export interface PushSender {
+    /** Send a push notification through the configured transport. */
+    send(options: PushOptions): Promise<PushSendResult>;
+    /** Test connectivity and credentials without sending. */
+    verify(): Promise<VerifyResult>;
+    /** Release resources held by the transport. */
+    close(): Promise<void>;
+}
+/**
+ * Create a push sender that wraps a {@link PushTransport}.
+ *
+ * Pipeline: plugins → onSend → transport.send → onSuccess / onError.
+ */
+export declare function createPushSender(config: PushSenderConfig): PushSender;

package/dist/push.js

@@ -0,0 +1,3 @@
+import{V as I}from"./chunk-yp311efr.js";import{W as z,X as G}from"./chunk-qtkd5bak.js";import"./chunk-ywq6s10g.js";import"./chunk-6npp3x3c.js";async function M(y,m){return{...y.messageId!==void 0?{messageId:y.messageId}:{},endpoint:await I(y.subscription.endpoint),provider:m.provider??"push"}}function R(y){let{transport:m,plugins:J,hooks:A}=y;return{async send(K){let D=await G(K,J),B=await M(D,m);await z(A?.onSend,B);let F=performance.now();try{let q=await m.send(D),L={...B,messageId:q.messageId};return await z(A?.onSuccess,L,q,performance.now()-F),q}catch(q){throw await z(A?.onError,B,q,performance.now()-F),q}},async verify(){if(m.verify)return m.verify();return{ok:!0,provider:"push"}},async close(){if(m.close)await m.close()}}}export{R as createPushSender};
+
+//# debugId=EF4B8931029EC5E464756E2164756E21

package/dist/push.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/push.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Web Push sender orchestrator — plugins, hooks, and transport.send pipeline.\n *\n * Sently-first: apps call {@link createPushSender}; providers implement\n * {@link PushTransport}.\n *\n * @example\n * ```ts\n * import { createPushSender } from \"sently/push\";\n * import { WebPushTransport } from \"sently/transports/webpush\";\n *\n * const push = createPushSender({\n *   transport: new WebPushTransport({\n *     vapidPublicKey: \"...\",\n *     vapidPrivateKey: \"...\",\n *     subject: \"mailto:you@example.com\",\n *   }),\n * });\n *\n * await push.send({\n *   subscription: { endpoint: \"...\", keys: { p256dh: \"...\", auth: \"...\" } },\n *   title: \"Hello\",\n *   body: \"World\",\n * });\n * ```\n */\nimport { invokeHook } from \"./core/hooks.js\";\nimport { runPlugins } from \"./core/plugin.js\";\nimport { redactPushEndpoint } from \"./core/push-endpoint.js\";\nimport type {\n  PushHookContext,\n  PushHooks,\n  PushOptions,\n  PushPlugin,\n  PushSendResult,\n  PushTransport,\n} from \"./core/push-types.js\";\nimport type { VerifyResult } from \"./core/types.js\";\n\n/** Configuration for {@link createPushSender}. */\nexport interface PushSenderConfig {\n  /** Push delivery transport. */\n  transport: PushTransport;\n  /** Optional plugins run before each send. */\n  plugins?: PushPlugin[];\n  /** Optional lifecycle hooks for metrics and tracing. */\n  hooks?: PushHooks;\n}\n\n/** Push sender returned by {@link createPushSender}. */\nexport interface PushSender {\n  /** Send a push notification through the configured transport. */\n  send(options: PushOptions): Promise<PushSendResult>;\n  /** Test connectivity and credentials without sending. */\n  verify(): Promise<VerifyResult>;\n  /** Release resources held by the transport. */\n  close(): Promise<void>;\n}\n\nasync function buildPushHookContext(\n  options: PushOptions,\n  transport: PushTransport,\n): Promise<PushHookContext> {\n  return {\n    ...(options.messageId !== undefined ? { messageId: options.messageId } : {}),\n    endpoint: await redactPushEndpoint(options.subscription.endpoint),\n    provider: transport.provider ?? \"push\",\n  };\n}\n\n/**\n * Create a push sender that wraps a {@link PushTransport}.\n *\n * Pipeline: plugins → onSend → transport.send → onSuccess / onError.\n */\nexport function createPushSender(config: PushSenderConfig): PushSender {\n  const { transport, plugins, hooks } = config;\n\n  return {\n    async send(options: PushOptions): Promise<PushSendResult> {\n      const processed = await runPlugins(options, plugins);\n      const ctx = await buildPushHookContext(processed, transport);\n\n      await invokeHook(hooks?.onSend, ctx);\n\n      const start = performance.now();\n\n      try {\n        const result = await transport.send(processed);\n        const successCtx: PushHookContext = {\n          ...ctx,\n          messageId: result.messageId,\n        };\n        await invokeHook(hooks?.onSuccess, successCtx, result, performance.now() - start);\n        return result;\n      } catch (error) {\n        await invokeHook(hooks?.onError, ctx, error, performance.now() - start);\n        throw error;\n      }\n    },\n\n    async verify(): Promise<VerifyResult> {\n      if (transport.verify) {\n        return transport.verify();\n      }\n      return { ok: true, provider: \"push\" };\n    },\n\n    async close(): Promise<void> {\n      if (transport.close) {\n        await transport.close();\n      }\n    },\n  };\n}\n"
+  ],
+  "mappings": "iKA4DA,SAAe,LAAoB,LACjC,EACA,EAC0B,CAC1B,MAAO,IACD,EAAQ,YAAc,OAAY,CAAE,UAAW,EAAQ,SAAU,EAAI,CAAC,EAC1E,SAAU,MAAM,EAAmB,EAAQ,aAAa,QAAQ,EAChE,SAAU,EAAU,UAAY,MAClC,EAQK,SAAS,CAAgB,CAAC,EAAsC,CACrE,IAAQ,YAAW,UAAS,SAAU,EAEtC,MAAO,MACC,KAAI,CAAC,EAA+C,CACxD,IAAM,EAAY,MAAM,EAAW,EAAS,CAAO,EAC7C,EAAM,MAAM,EAAqB,EAAW,CAAS,EAE3D,MAAM,EAAW,GAAO,OAAQ,CAAG,EAEnC,IAAM,EAAQ,YAAY,IAAI,EAE9B,GAAI,CACF,IAAM,EAAS,MAAM,EAAU,KAAK,CAAS,EACvC,EAA8B,IAC/B,EACH,UAAW,EAAO,SACpB,EAEA,OADA,MAAM,EAAW,GAAO,UAAW,EAAY,EAAQ,YAAY,IAAI,EAAI,CAAK,EACzE,EACP,MAAO,EAAO,CAEd,MADA,MAAM,EAAW,GAAO,QAAS,EAAK,EAAO,YAAY,IAAI,EAAI,CAAK,EAChE,SAIJ,OAAM,EAA0B,CACpC,GAAI,EAAU,OACZ,OAAO,EAAU,OAAO,EAE1B,MAAO,CAAE,GAAI,GAAM,SAAU,MAAO,QAGhC,MAAK,EAAkB,CAC3B,GAAI,EAAU,MACZ,MAAM,EAAU,MAAM,EAG5B",
+  "debugId": "EF4B8931029EC5E464756E2164756E21",
+  "names": []
+}

package/dist/sms.d.ts

@@ -0,0 +1,26 @@
+import type { SmsHooks, SmsOptions, SmsPlugin, SmsSendResult, SmsTransport } from "./core/sms-types.js";
+import type { VerifyResult } from "./core/types.js";
+/** Configuration for {@link createSmsSender}. */
+export interface SmsSenderConfig {
+    /** SMS delivery transport. */
+    transport: SmsTransport;
+    /** Optional plugins run before each send. */
+    plugins?: SmsPlugin[];
+    /** Optional lifecycle hooks for metrics and tracing. */
+    hooks?: SmsHooks;
+}
+/** SMS sender returned by {@link createSmsSender}. */
+export interface SmsSender {
+    /** Send an SMS through the configured transport. */
+    send(options: SmsOptions): Promise<SmsSendResult>;
+    /** Test connectivity and credentials without sending. */
+    verify(): Promise<VerifyResult>;
+    /** Release resources held by the transport. */
+    close(): Promise<void>;
+}
+/**
+ * Create an SMS sender that wraps an {@link SmsTransport}.
+ *
+ * Pipeline: plugins → onSend → transport.send → onSuccess / onError.
+ */
+export declare function createSmsSender(config: SmsSenderConfig): SmsSender;

package/dist/sms.js

@@ -0,0 +1,3 @@
+import{W as A,X as I}from"./chunk-qtkd5bak.js";import"./chunk-6npp3x3c.js";function N(z,q){return{...z.messageId!==void 0?{messageId:z.messageId}:{},to:z.to,provider:q.provider??"sms"}}function R(z){let{transport:q,plugins:J,hooks:B}=z;return{async send(K){let F=await I(K,J),D=N(F,q);await A(B?.onSend,D);let G=performance.now();try{let y=await q.send(F),L={...D,messageId:y.messageId};return await A(B?.onSuccess,L,y,performance.now()-G),y}catch(y){throw await A(B?.onError,D,y,performance.now()-G),y}},async verify(){if(q.verify)return q.verify();return{ok:!0,provider:"sms"}},async close(){if(q.close)await q.close()}}}export{R as createSmsSender};
+
+//# debugId=9AD22B10712186FC64756E2164756E21