sently 0.4.6 → 0.5.1

package/dist/core/types.d.ts

@@ -60,6 +60,16 @@ export interface MailOptions {
     template?: string;
     /** Template variables passed to the rendering engine */
     data?: Record<string, unknown>;
+    /**
+     * React element rendered to html + text by the sently/react plugin.
+     * Requires `@react-email/render`.
+     */
+    react?: unknown;
+    /**
+     * Idempotency key for deduplicating sends on retry or replay.
+     * When absent but `messageId` is set, transports derive a stable key from it.
+     */
+    idempotencyKey?: string;
 }
 /** Result returned after a message is accepted for delivery. */
 export interface SendResult {
@@ -73,6 +83,10 @@ export interface SendResult {
     response: string;
     /** SMTP envelope used for delivery. */
     envelope: Envelope;
+    /** When true, the send was skipped because an idempotency key was already recorded. */
+    deduped?: boolean;
+    /** Set when this item failed inside an otherwise successful batch HTTP response. */
+    batchError?: unknown;
 }
 /** SMTP envelope addresses (MAIL FROM / RCPT TO). */
 export interface Envelope {
@@ -122,6 +136,16 @@ export interface VerifyResult {
 export interface Transport {
     /** Send a message through this transport. */
     send(options: MailOptions): Promise<SendResult>;
+    /**
+     * Send multiple messages in one provider batch request when supported.
+     * Messages with attachments may be excluded by the mailer and sent individually.
+     */
+    sendBatch?(messages: MailOptions[]): Promise<SendResult[]>;
+    /**
+     * When set, {@link Mailer.sendBulk} splits batch sends into chunks of this size.
+     * Omit when the transport sends all messages in one HTTP request (e.g. SendGrid).
+     */
+    batchMax?: number;
     /** Test connectivity and credentials without sending mail. */
     verify?(): Promise<VerifyResult>;
     /** Release resources held by the transport. */
@@ -258,6 +282,17 @@ export interface BulkSendOptions {
     onError?: (message: MailOptions, index: number, error: unknown) => void;
     /** Max concurrent sends. Defaults to pool maxConnections or 1 */
     concurrency?: number;
+    /** When true, stop sending after the first failure. Default: false */
+    stopOnError?: boolean;
+    /**
+     * Max batch HTTP requests per rate window (e.g. Resend default 2 req/s).
+     * Set to `0` to disable batch rate limiting. Default: `2`.
+     */
+    rateDelta?: number;
+    /** Rate limit window in milliseconds. Default: `1000`. */
+    rateLimit?: number;
+    /** Injectable clock for batch rate limiting (testing). */
+    now?: () => number;
 }
 /** Result of a batch send operation. */
 export interface BulkSendResult {
@@ -312,6 +347,13 @@ export interface PreviewConfig {
      */
     format?: "eml" | "html";
 }
+/** Options for {@link createMailer} from `sently/mailer` — transport-only, smallest bundle. */
+export interface TransportMailerOptions {
+    /** Transport that sends the message (HTTP API, SMTP wrapper, preview, etc.). */
+    transport: Transport;
+    /** Optional plugins run before each send. */
+    plugins?: MailPlugin[];
+}
 /** Options for {@link createMailer} — custom transport or SMTP config. */
 export type CreateMailerOptions = ({
     transport: Transport;

package/dist/detect.d.ts

@@ -11,5 +11,7 @@ export declare function createDefaultAdapter(options?: {
 }): Promise<SocketAdapter>;
 /**
  * Create a ready-to-use Mailer instance.
+ *
+ * For HTTP transports and smallest bundles, prefer `import { createMailer } from "sently/mailer"`.
  */
 export declare function createMailer(options: CreateMailerOptions): Promise<Mailer>;

package/dist/detect.js

@@ -1,181 +1,3 @@
-import {
-  SMTPPool
-} from "./chunk-mp5c9bfd.js";
-import {
-  SMTPTransport
-} from "./chunk-7fqv71z1.js";
-import"./chunk-ym3zzv8b.js";
-import"./chunk-x3szga4k.js";
-import"./chunk-tymfm441.js";
-import"./chunk-f4c9ttmr.js";
-import"./chunk-794hc3m4.js";
-import {
-  __require
-} from "./chunk-v0bahtg2.js";
+import{r as z,s as w}from"./chunk-pjzsvsm6.js";import"./chunk-ntqmn6pe.js";import{K as v}from"./chunk-rhade81v.js";function K(){if(typeof Bun<"u")return"bun";if(typeof Deno<"u")return"deno";if(typeof caches<"u"&&globalThis.navigator?.userAgent==="Cloudflare-Workers")return"cf-workers";if(typeof window<"u")return"browser";if(typeof process<"u"&&process.versions?.node)return"node";return"unknown"}async function x(k){let h=K();switch(h){case"node":{let{NodeAdapter:q}=await import("./adapters/node.js");return new q(k)}case"bun":{let{BunAdapter:q}=await import("./adapters/bun.js");return new q(k)}case"deno":{let{DenoAdapter:q}=await import("./adapters/deno.js");return new q(k)}case"cf-workers":{let{CloudflareAdapter:q}=await import("./adapters/cf.js");return new q(k)}default:throw Error(`No socket adapter available for runtime: ${h}`)}}async function Q(k){if("transport"in k)return z({transport:k.transport,...k.plugins!==void 0?{plugins:k.plugins}:{}});let h=k,q={...h.secure!==void 0?{secure:h.secure}:{},...h.connectionTimeout!==void 0?{connectionTimeout:h.connectionTimeout}:{},...h.tls!==void 0?{tls:h.tls}:{}};if(h.pool){let{SMTPPool:J}=await import("./pool/pool.js");return new w(new J(h,{createAdapter:async()=>h.adapter??await x(q)}),h.plugins)}let E=h.adapter??await x(q),{SMTPTransport:G}=await import("./transports/smtp.js");return new w(new G({...h,adapter:E}),h.plugins)}export{K as detectRuntime,Q as createMailer,x as createDefaultAdapter};
 
-// src/core/plugin.ts
-async function runPlugins(options, plugins) {
-  if (!plugins || plugins.length === 0) {
-    return options;
-  }
-  let current = options;
-  for (const plugin of plugins) {
-    current = await plugin(current);
-  }
-  return current;
-}
-
-// src/detect.ts
-function detectRuntime() {
-  if (typeof Bun !== "undefined") {
-    return "bun";
-  }
-  if (typeof Deno !== "undefined") {
-    return "deno";
-  }
-  if (typeof caches !== "undefined" && globalThis.navigator?.userAgent === "Cloudflare-Workers") {
-    return "cf-workers";
-  }
-  if (typeof window !== "undefined") {
-    return "browser";
-  }
-  if (typeof process !== "undefined" && process.versions?.node) {
-    return "node";
-  }
-  return "unknown";
-}
-async function createDefaultAdapter(options) {
-  const runtime = detectRuntime();
-  switch (runtime) {
-    case "node": {
-      const { NodeAdapter } = await import("./adapters/node.js");
-      return new NodeAdapter(options);
-    }
-    case "bun": {
-      const { BunAdapter } = await import("./adapters/bun.js");
-      return new BunAdapter(options);
-    }
-    case "deno": {
-      const { DenoAdapter } = await import("./adapters/deno.js");
-      return new DenoAdapter(options);
-    }
-    case "cf-workers": {
-      const { CloudflareAdapter } = await import("./adapters/cf.js");
-      return new CloudflareAdapter(options);
-    }
-    default:
-      throw new Error(`No socket adapter available for runtime: ${runtime}`);
-  }
-}
-async function createMailer(options) {
-  if ("transport" in options) {
-    return new MailerImpl(options.transport, options.plugins ?? []);
-  }
-  const smtpConfig = options;
-  if (smtpConfig.pool) {
-    return new MailerImpl(new SMTPPool(smtpConfig, {
-      createAdapter: async () => smtpConfig.adapter ?? await createDefaultAdapter({
-        ...smtpConfig.secure !== undefined ? { secure: smtpConfig.secure } : {},
-        ...smtpConfig.connectionTimeout !== undefined ? { connectionTimeout: smtpConfig.connectionTimeout } : {},
-        ...smtpConfig.tls !== undefined ? { tls: smtpConfig.tls } : {}
-      })
-    }), smtpConfig.plugins);
-  }
-  const adapter = smtpConfig.adapter ?? await createDefaultAdapter({
-    ...smtpConfig.secure !== undefined ? { secure: smtpConfig.secure } : {},
-    ...smtpConfig.connectionTimeout !== undefined ? { connectionTimeout: smtpConfig.connectionTimeout } : {},
-    ...smtpConfig.tls !== undefined ? { tls: smtpConfig.tls } : {}
-  });
-  return new MailerImpl(new SMTPTransport({ ...smtpConfig, adapter }), smtpConfig.plugins);
-}
-
-class MailerImpl {
-  transport;
-  plugins;
-  constructor(transport, plugins = []) {
-    this.transport = transport;
-    this.plugins = plugins;
-  }
-  async send(options) {
-    const processed = await runPlugins(options, this.plugins);
-    return this.transport.send(processed);
-  }
-  async sendBulk(messages, options) {
-    const concurrency = options?.concurrency ?? 1;
-    const results = new Array(messages.length);
-    const queue = [...messages.entries()];
-    let active = 0;
-    await new Promise((resolve) => {
-      if (messages.length === 0) {
-        resolve();
-        return;
-      }
-      const maybeDone = () => {
-        if (queue.length === 0 && active === 0) {
-          resolve();
-        }
-      };
-      const processNext = () => {
-        if (queue.length === 0) {
-          maybeDone();
-          return;
-        }
-        const entry = queue.shift();
-        if (entry === undefined) {
-          maybeDone();
-          return;
-        }
-        const [index, message] = entry;
-        active++;
-        this.send(message).then((result) => {
-          results[index] = { status: "sent", result };
-          options?.onSuccess?.(message, index, result);
-        }).catch((error) => {
-          results[index] = { status: "failed", error };
-          options?.onError?.(message, index, error);
-        }).finally(() => {
-          active--;
-          processNext();
-          maybeDone();
-        });
-      };
-      for (let i = 0;i < concurrency; i++) {
-        processNext();
-      }
-    });
-    let sent = 0;
-    let failed = 0;
-    for (const result of results) {
-      if (result.status === "sent") {
-        sent++;
-      } else {
-        failed++;
-      }
-    }
-    return {
-      total: messages.length,
-      sent,
-      failed,
-      results
-    };
-  }
-  verify() {
-    if (this.transport.verify) {
-      return this.transport.verify();
-    }
-    return Promise.resolve({ ok: true, provider: "mailer" });
-  }
-  close() {
-    if (this.transport.close) {
-      return this.transport.close();
-    }
-    return Promise.resolve();
-  }
-}
-export {
-  detectRuntime,
-  createMailer,
-  createDefaultAdapter
-};
-
-//# debugId=685AB5DE4D1E74D864756E2164756E21
+//# debugId=7BF2493D1AD14E8964756E2164756E21

package/dist/detect.js.map

@@ -1,11 +1,10 @@
 {
   "version": 3,
-  "sources": ["../src/core/plugin.ts", "../src/detect.ts"],
+  "sources": ["../src/detect.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Plugin pipeline for sently.\n * Plugins transform MailOptions before message construction.\n * They run sequentially — each receives the previous plugin's output.\n *\n * @example\n * ```ts\n * import { runPlugins } from \"sently/core/plugin\";\n * const result = await runPlugins(options, [pluginA, pluginB]);\n * ```\n */\nimport type { MailOptions, MailPlugin } from \"./types.js\";\n\n/**\n * Run a list of plugins sequentially over MailOptions.\n * If plugins is empty or undefined, returns options unchanged.\n * Each plugin may be sync or async.\n *\n * @param options - the original mail options\n * @param plugins - ordered list of plugins to apply\n * @returns transformed mail options after all plugins have run\n */\nexport async function runPlugins(\n  options: MailOptions,\n  plugins: MailPlugin[] | undefined,\n): Promise<MailOptions> {\n  if (!plugins || plugins.length === 0) {\n    return options;\n  }\n\n  let current = options;\n  for (const plugin of plugins) {\n    current = await plugin(current);\n  }\n  return current;\n}\n",
-    "// src/detect.ts\nimport { runPlugins } from \"./core/plugin.js\";\nimport type {\n  BulkSendOptions,\n  BulkSendResult,\n  CreateMailerOptions,\n  Mailer,\n  MailOptions,\n  MailPlugin,\n  Runtime,\n  SendResult,\n  SMTPConfig,\n  SocketAdapter,\n  TLSOptions,\n  Transport,\n  VerifyResult,\n} from \"./core/types.js\";\nimport { SMTPPool } from \"./pool/pool.js\";\nimport { SMTPTransport } from \"./transports/smtp.js\";\n\n/** Detect the current JavaScript runtime. */\nexport function detectRuntime(): Runtime {\n  if (typeof Bun !== \"undefined\") {\n    return \"bun\";\n  }\n  if (typeof Deno !== \"undefined\") {\n    return \"deno\";\n  }\n  if (typeof caches !== \"undefined\" && globalThis.navigator?.userAgent === \"Cloudflare-Workers\") {\n    return \"cf-workers\";\n  }\n  if (typeof window !== \"undefined\") {\n    return \"browser\";\n  }\n  if (typeof process !== \"undefined\" && process.versions?.node) {\n    return \"node\";\n  }\n  return \"unknown\";\n}\n\n/**\n * Dynamically import and instantiate the correct adapter for the current runtime.\n */\nexport async function createDefaultAdapter(options?: {\n  secure?: boolean;\n  connectionTimeout?: number;\n  tls?: TLSOptions;\n}): Promise<SocketAdapter> {\n  const runtime = detectRuntime();\n\n  switch (runtime) {\n    case \"node\": {\n      const { NodeAdapter } = await import(\"./adapters/node.js\");\n      return new NodeAdapter(options);\n    }\n    case \"bun\": {\n      const { BunAdapter } = await import(\"./adapters/bun.js\");\n      return new BunAdapter(options);\n    }\n    case \"deno\": {\n      const { DenoAdapter } = await import(\"./adapters/deno.js\");\n      return new DenoAdapter(options);\n    }\n    case \"cf-workers\": {\n      const { CloudflareAdapter } = await import(\"./adapters/cf.js\");\n      return new CloudflareAdapter(options);\n    }\n    default:\n      throw new Error(`No socket adapter available for runtime: ${runtime}`);\n  }\n}\n\n/**\n * Create a ready-to-use Mailer instance.\n */\nexport async function createMailer(options: CreateMailerOptions): Promise<Mailer> {\n  if (\"transport\" in options) {\n    return new MailerImpl(options.transport, options.plugins ?? []);\n  }\n\n  const smtpConfig = options as SMTPConfig;\n\n  if (smtpConfig.pool) {\n    return new MailerImpl(\n      new SMTPPool(smtpConfig, {\n        createAdapter: async () =>\n          smtpConfig.adapter ??\n          (await createDefaultAdapter({\n            ...(smtpConfig.secure !== undefined ? { secure: smtpConfig.secure } : {}),\n            ...(smtpConfig.connectionTimeout !== undefined\n              ? { connectionTimeout: smtpConfig.connectionTimeout }\n              : {}),\n            ...(smtpConfig.tls !== undefined ? { tls: smtpConfig.tls } : {}),\n          })),\n      }),\n      smtpConfig.plugins,\n    );\n  }\n\n  const adapter =\n    smtpConfig.adapter ??\n    (await createDefaultAdapter({\n      ...(smtpConfig.secure !== undefined ? { secure: smtpConfig.secure } : {}),\n      ...(smtpConfig.connectionTimeout !== undefined\n        ? { connectionTimeout: smtpConfig.connectionTimeout }\n        : {}),\n      ...(smtpConfig.tls !== undefined ? { tls: smtpConfig.tls } : {}),\n    }));\n\n  return new MailerImpl(new SMTPTransport({ ...smtpConfig, adapter }), smtpConfig.plugins);\n}\n\nclass MailerImpl implements Mailer {\n  constructor(\n    private readonly transport: Transport,\n    private readonly plugins: MailPlugin[] = [],\n  ) {}\n\n  async send(options: MailOptions): Promise<SendResult> {\n    const processed = await runPlugins(options, this.plugins);\n    return this.transport.send(processed);\n  }\n\n  async sendBulk(messages: MailOptions[], options?: BulkSendOptions): Promise<BulkSendResult> {\n    const concurrency = options?.concurrency ?? 1;\n    const results: BulkSendResult[\"results\"] = new Array(messages.length);\n    const queue = [...messages.entries()];\n    let active = 0;\n\n    await new Promise<void>((resolve) => {\n      if (messages.length === 0) {\n        resolve();\n        return;\n      }\n\n      const maybeDone = (): void => {\n        if (queue.length === 0 && active === 0) {\n          resolve();\n        }\n      };\n\n      const processNext = (): void => {\n        if (queue.length === 0) {\n          maybeDone();\n          return;\n        }\n\n        const entry = queue.shift();\n        if (entry === undefined) {\n          maybeDone();\n          return;\n        }\n\n        const [index, message] = entry;\n        active++;\n\n        void this.send(message)\n          .then((result) => {\n            results[index] = { status: \"sent\", result };\n            options?.onSuccess?.(message, index, result);\n          })\n          .catch((error: unknown) => {\n            results[index] = { status: \"failed\", error };\n            options?.onError?.(message, index, error);\n          })\n          .finally(() => {\n            active--;\n            processNext();\n            maybeDone();\n          });\n      };\n\n      for (let i = 0; i < concurrency; i++) {\n        processNext();\n      }\n    });\n\n    let sent = 0;\n    let failed = 0;\n    for (const result of results) {\n      if (result.status === \"sent\") {\n        sent++;\n      } else {\n        failed++;\n      }\n    }\n\n    return {\n      total: messages.length,\n      sent,\n      failed,\n      results,\n    };\n  }\n\n  verify(): Promise<VerifyResult> {\n    if (this.transport.verify) {\n      return this.transport.verify();\n    }\n    return Promise.resolve({ ok: true, provider: \"mailer\" });\n  }\n\n  close(): Promise<void> {\n    if (this.transport.close) {\n      return this.transport.close();\n    }\n    return Promise.resolve();\n  }\n}\n\ndeclare const Bun: unknown;\ndeclare const Deno: unknown;\n"
+    "// src/detect.ts\nimport type {\n  CreateMailerOptions,\n  Mailer,\n  Runtime,\n  SMTPConfig,\n  SocketAdapter,\n  TLSOptions,\n} from \"./core/types.js\";\nimport { createMailer as createTransportMailer, MailerImpl } from \"./mailer.js\";\n\n/** Detect the current JavaScript runtime. */\nexport function detectRuntime(): Runtime {\n  if (typeof Bun !== \"undefined\") {\n    return \"bun\";\n  }\n  if (typeof Deno !== \"undefined\") {\n    return \"deno\";\n  }\n  if (typeof caches !== \"undefined\" && globalThis.navigator?.userAgent === \"Cloudflare-Workers\") {\n    return \"cf-workers\";\n  }\n  if (typeof window !== \"undefined\") {\n    return \"browser\";\n  }\n  if (typeof process !== \"undefined\" && process.versions?.node) {\n    return \"node\";\n  }\n  return \"unknown\";\n}\n\n/**\n * Dynamically import and instantiate the correct adapter for the current runtime.\n */\nexport async function createDefaultAdapter(options?: {\n  secure?: boolean;\n  connectionTimeout?: number;\n  tls?: TLSOptions;\n}): Promise<SocketAdapter> {\n  const runtime = detectRuntime();\n\n  switch (runtime) {\n    case \"node\": {\n      const { NodeAdapter } = await import(\"./adapters/node.js\");\n      return new NodeAdapter(options);\n    }\n    case \"bun\": {\n      const { BunAdapter } = await import(\"./adapters/bun.js\");\n      return new BunAdapter(options);\n    }\n    case \"deno\": {\n      const { DenoAdapter } = await import(\"./adapters/deno.js\");\n      return new DenoAdapter(options);\n    }\n    case \"cf-workers\": {\n      const { CloudflareAdapter } = await import(\"./adapters/cf.js\");\n      return new CloudflareAdapter(options);\n    }\n    default:\n      throw new Error(`No socket adapter available for runtime: ${runtime}`);\n  }\n}\n\n/**\n * Create a ready-to-use Mailer instance.\n *\n * For HTTP transports and smallest bundles, prefer `import { createMailer } from \"sently/mailer\"`.\n */\nexport async function createMailer(options: CreateMailerOptions): Promise<Mailer> {\n  if (\"transport\" in options) {\n    return createTransportMailer({\n      transport: options.transport,\n      ...(options.plugins !== undefined ? { plugins: options.plugins } : {}),\n    });\n  }\n\n  const smtpConfig = options as SMTPConfig;\n  const adapterOptions = {\n    ...(smtpConfig.secure !== undefined ? { secure: smtpConfig.secure } : {}),\n    ...(smtpConfig.connectionTimeout !== undefined\n      ? { connectionTimeout: smtpConfig.connectionTimeout }\n      : {}),\n    ...(smtpConfig.tls !== undefined ? { tls: smtpConfig.tls } : {}),\n  };\n\n  if (smtpConfig.pool) {\n    const { SMTPPool } = await import(\"./pool/pool.js\");\n    return new MailerImpl(\n      new SMTPPool(smtpConfig, {\n        createAdapter: async () =>\n          smtpConfig.adapter ?? (await createDefaultAdapter(adapterOptions)),\n      }),\n      smtpConfig.plugins,\n    );\n  }\n\n  const adapter = smtpConfig.adapter ?? (await createDefaultAdapter(adapterOptions));\n  const { SMTPTransport } = await import(\"./transports/smtp.js\");\n\n  return new MailerImpl(new SMTPTransport({ ...smtpConfig, adapter }), smtpConfig.plugins);\n}\n\ndeclare const Bun: unknown;\ndeclare const Deno: unknown;\n"
   ],
-  "mappings": "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",
-  "debugId": "685AB5DE4D1E74D864756E2164756E21",
+  "mappings": "+HAYO,GAAS,LAAa,EAAY,CACvC,GAAI,OAAO,IAAQ,IACjB,MAAO,MAET,GAAI,OAAO,KAAS,IAClB,MAAO,OAET,GAAI,OAAO,OAAW,KAAe,WAAW,WAAW,YAAc,qBACvE,MAAO,aAET,GAAI,OAAO,OAAW,IACpB,MAAO,UAET,GAAI,OAAO,QAAY,KAAe,QAAQ,UAAU,KACtD,MAAO,OAET,MAAO,UAMT,eAAsB,CAAoB,CAAC,EAIhB,CACzB,IAAM,EAAU,EAAc,EAE9B,OAAQ,OACD,OAAQ,CACX,IAAQ,eAAgB,KAAa,8BACrC,OAAO,IAAI,EAAY,CAAO,CAChC,KACK,MAAO,CACV,IAAQ,cAAe,KAAa,6BACpC,OAAO,IAAI,EAAW,CAAO,CAC/B,KACK,OAAQ,CACX,IAAQ,eAAgB,KAAa,8BACrC,OAAO,IAAI,EAAY,CAAO,CAChC,KACK,aAAc,CACjB,IAAQ,qBAAsB,KAAa,4BAC3C,OAAO,IAAI,EAAkB,CAAO,CACtC,SAEE,MAAU,MAAM,4CAA4C,GAAS,GAS3E,eAAsB,CAAY,CAAC,EAA+C,CAChF,GAAI,cAAe,EACjB,OAAO,EAAsB,CAC3B,UAAW,EAAQ,aACf,EAAQ,UAAY,OAAY,CAAE,QAAS,EAAQ,OAAQ,EAAI,CAAC,CACtE,CAAC,EAGH,IAAM,EAAa,EACb,EAAiB,IACjB,EAAW,SAAW,OAAY,CAAE,OAAQ,EAAW,MAAO,EAAI,CAAC,KACnE,EAAW,oBAAsB,OACjC,CAAE,kBAAmB,EAAW,iBAAkB,EAClD,CAAC,KACD,EAAW,MAAQ,OAAY,CAAE,IAAK,EAAW,GAAI,EAAI,CAAC,CAChE,EAEA,GAAI,EAAW,KAAM,CACnB,IAAQ,YAAa,KAAa,0BAClC,OAAO,IAAI,EACT,IAAI,EAAS,EAAY,CACvB,cAAe,SACb,EAAW,SAAY,MAAM,EAAqB,CAAc,CACpE,CAAC,EACD,EAAW,OACb,EAGF,IAAM,EAAU,EAAW,SAAY,MAAM,EAAqB,CAAc,GACxE,iBAAkB,KAAa,gCAEvC,OAAO,IAAI,EAAW,IAAI,EAAc,IAAK,EAAY,SAAQ,CAAC,EAAG,EAAW,OAAO",
+  "debugId": "7BF2493D1AD14E8964756E2164756E21",
   "names": []
 }

package/dist/dkim.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @module
+ * DKIM (DomainKeys Identified Mail) signing per RFC 6376.
+ * Supports RSA-SHA256 and Ed25519-SHA256 using Web Crypto.
+ *
+ * Import from this entry when signing mail explicitly. MIME building lazy-loads
+ * DKIM only when a `dkim` option is passed to {@link buildMIME}.
+ *
+ * @example
+ * ```ts
+ * import { signDKIM } from "sently/dkim";
+ *
+ * const { header } = await signDKIM(rawMessage, {
+ *   domainName: "example.com",
+ *   keySelector: "2024",
+ *   privateKey: process.env.DKIM_PRIVATE_KEY!,
+ * });
+ * ```
+ */
+export type { DKIMSignResult } from "./core/dkim.js";
+export { canonicalizeBodyRelaxed, canonicalizeHeadersRelaxed, importPrivateKey, signDKIM, } from "./core/dkim.js";

package/dist/dkim.js

@@ -0,0 +1,9 @@
+import{G,J as E}from"./chunk-32dj0v9g.js";import"./chunk-rhade81v.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(`
+`).map((K)=>K.replace(/[ \t]+$/g,"").replace(/[ \t]+/g," ")).filter((K)=>K.length>0);if(x.length===0)return j;return`${x.join(j)}${j}`}async function v(M,I){if(I==="ed25519-sha256"&&/OPENSSH PRIVATE KEY/i.test(M))throw Error("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");let x=B(M),K=J(x);try{if(I==="ed25519-sha256")return await crypto.subtle.importKey("pkcs8",K,{name:"Ed25519"},!1,["sign"]);return await crypto.subtle.importKey("pkcs8",K,{name:"RSASSA-PKCS1-v1_5",hash:"SHA-256"},!1,["sign"])}catch(S){if(I==="ed25519-sha256"&&S instanceof DOMException)throw Error("Ed25519 DKIM requires Node.js ≥ 18.4, Bun ≥ 1.0, or Cloudflare Workers",{cause:S});throw S}}async function N(M,I){let x=I.algorithm??"rsa-sha256",K=(I.headerFieldNames??C).split(":").map((q)=>q.trim().toLowerCase()).filter(Boolean),S=new Set((I.skipFields??"").split(":").map((q)=>q.trim().toLowerCase()).filter(Boolean)),Y=K.filter((q)=>!S.has(q)),z=new TextDecoder().decode(M),D=z.indexOf(`\r
+\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=D2033210B783CB1164756E2164756E21

package/dist/dkim.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/dkim.ts"],
+  "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": "D2033210B783CB1164756E2164756E21",
+  "names": []
+}

package/dist/idempotency.d.ts

@@ -0,0 +1,46 @@
+import type { MailOptions, SendResult, Transport, VerifyResult } from "./core/types.js";
+/** Key-value store for idempotency deduplication. */
+export interface IdempotencyStore {
+    /** Returns true when the key was already recorded. */
+    has(key: string): Promise<boolean>;
+    /** Record a key, optionally expiring after `ttlMs` milliseconds. */
+    set(key: string, ttlMs?: number): Promise<void>;
+}
+/** In-memory idempotency store with optional TTL expiry. Suitable for single-process use. */
+export declare class MemoryIdempotencyStore implements IdempotencyStore {
+    private readonly entries;
+    /** Returns true when the key exists and has not expired. */
+    has(key: string): Promise<boolean>;
+    /** Record a key with optional TTL in milliseconds. */
+    set(key: string, ttlMs?: number): Promise<void>;
+}
+/** Options for {@link IdempotencyTransport}. */
+export interface IdempotencyTransportOptions {
+    /** Store used to track sent keys. Defaults to {@link MemoryIdempotencyStore}. */
+    store?: IdempotencyStore;
+    /** TTL in milliseconds for recorded keys. Default: 24 hours. */
+    ttlMs?: number;
+}
+/**
+ * Transport decorator that skips duplicate sends when an idempotency key
+ * was already recorded. Checks the store once before delegating to the inner
+ * transport, so retries inside RetryTransport reuse the same key automatically.
+ */
+export declare class IdempotencyTransport implements Transport {
+    /** Transport that performs the actual send when the key is new. */
+    private readonly inner;
+    private readonly store;
+    private readonly ttlMs;
+    /** Wraps an inner transport with idempotency deduplication. */
+    constructor(
+    /** Transport that performs the actual send when the key is new. */
+    inner: Transport, options?: IdempotencyTransportOptions);
+    /** Sends once per idempotency key; returns a synthetic result on duplicate keys. */
+    send(options: MailOptions): Promise<SendResult>;
+    /** Delegates batch sends to the inner transport when available. */
+    sendBatch(messages: MailOptions[]): Promise<SendResult[]>;
+    /** Delegates to the inner transport verify or returns a default success result. */
+    verify(): Promise<VerifyResult>;
+    /** Delegates close to the inner transport if available. */
+    close(): Promise<void>;
+}

package/dist/idempotency.js

@@ -0,0 +1,3 @@
+import{j as F}from"./chunk-zwm5bfa4.js";import{n as C,p as B}from"./chunk-kdqxhybf.js";import"./chunk-32dj0v9g.js";import"./chunk-rhade81v.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};
+
+//# debugId=C9F463170D0BFD9764756E2164756E21

package/dist/idempotency.js.map

@@ -0,0 +1,10 @@
+{
+  "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"
+  ],
+  "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,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": "C9F463170D0BFD9764756E2164756E21",
+  "names": []
+}

package/dist/index.d.ts

@@ -19,19 +19,109 @@
  * });
  * ```
  */
-export { GOOGLE_TOKEN_URL, MICROSOFT_TOKEN_URL, OAuth2Client } from "./auth/oauth2.js";
-export { SMTPError } from "./core/smtp.js";
-export type { Address, AddressInput, Attachment, BrevoConfig, BulkSendOptions, BulkSendResult, CreateMailerOptions, DKIMConfig, Envelope, Mailer, MailgunConfig, MailOptions, MailPlugin, OAuth2Config, PoolConfig, PreviewConfig, RetryConfig, Runtime, SESConfig, SendResult, SMTPAuth, SMTPConfig, SocketAdapter, TLSOptions, Transport, VerifyResult, } from "./core/types.js";
-export { createMailer, detectRuntime } from "./detect.js";
-export type { TemplateEngine, TemplatePluginConfig } from "./plugins/template.js";
-export { simpleEngine, templatePlugin } from "./plugins/template.js";
-export { SMTPPool } from "./pool/pool.js";
-export { BrevoError, BrevoTransport } from "./transports/brevo.js";
-export { MailgunError, MailgunTransport } from "./transports/mailgun.js";
-export { PostmarkError, PostmarkTransport } from "./transports/postmark.js";
-export { PreviewTransport } from "./transports/preview.js";
-export { ResendError, ResendTransport } from "./transports/resend.js";
-export { RetryTransport } from "./transports/retry.js";
-export { SendGridError, SendGridTransport } from "./transports/sendgrid.js";
-export { SESError, SESTransport } from "./transports/ses.js";
-export { SMTPTransport } from "./transports/smtp.js";
+export { 
+/** Default Google OAuth2 token endpoint. */
+GOOGLE_TOKEN_URL, 
+/** Microsoft OAuth2 token endpoint (common tenant). */
+MICROSOFT_TOKEN_URL, 
+/** OAuth2 client with in-memory token cache and automatic refresh. */
+OAuth2Client, } from "./auth/oauth2.js";
+export { 
+/** SMTP protocol error with server response details. */
+SMTPError, } from "./core/smtp.js";
+export type { Address, AddressInput, Attachment, BrevoConfig, BulkSendOptions, BulkSendResult, CreateMailerOptions, DKIMConfig, Envelope, Mailer, MailgunConfig, MailOptions, MailPlugin, OAuth2Config, PoolConfig, PreviewConfig, RetryConfig, Runtime, SESConfig, SendResult, SMTPAuth, SMTPConfig, SocketAdapter, TLSOptions, Transport, TransportMailerOptions, VerifyResult, } from "./core/types.js";
+export { 
+/** Create a ready-to-use Mailer instance. */
+createMailer, 
+/** Detect the current JavaScript runtime. */
+detectRuntime, } from "./detect.js";
+export type { DKIMSignResult } from "./dkim.js";
+export { 
+/** Import a PEM private key for DKIM signing. */
+importPrivateKey, 
+/** Sign a raw MIME message with DKIM (RFC 6376). */
+signDKIM, } from "./dkim.js";
+export type { 
+/** Key-value store for idempotency deduplication. */
+IdempotencyStore, 
+/** Options for {@link IdempotencyTransport}. */
+IdempotencyTransportOptions, } from "./idempotency.js";
+export { 
+/** Transport decorator that deduplicates sends on retry or replay. */
+IdempotencyTransport, 
+/** In-memory idempotency store with optional TTL expiry. */
+MemoryIdempotencyStore, } from "./idempotency.js";
+export type { 
+/** Renders a template string with the given data object. */
+TemplateEngine, 
+/** Configuration for the template plugin. */
+TemplatePluginConfig, } from "./plugins/template.js";
+export { 
+/** Built-in zero-dependency template engine using `{{variable}}` interpolation. */
+simpleEngine, 
+/** Create a template plugin that renders HTML from a named template and data. */
+templatePlugin, } from "./plugins/template.js";
+export { 
+/** SMTP connection pool with optional rate limiting. */
+SMTPPool, } from "./pool/pool.js";
+export { 
+/** Error thrown when the Brevo API returns a non-success response. */
+BrevoError, 
+/** Brevo HTTP API transport. */
+BrevoTransport, } from "./transports/brevo.js";
+export { 
+/** Error thrown when the Mailgun API returns a non-success response. */
+MailgunError, 
+/** Mailgun HTTP API transport (multipart/form-data). */
+MailgunTransport, } from "./transports/mailgun.js";
+export { 
+/** Error thrown when the Postmark API returns a non-success response. */
+PostmarkError, 
+/** Postmark HTTP API transport. */
+PostmarkTransport, } from "./transports/postmark.js";
+export { 
+/** Development transport that writes emails to disk instead of sending them. */
+PreviewTransport, } from "./transports/preview.js";
+export { 
+/** Maximum messages per Resend batch request. */
+RESEND_BATCH_MAX, 
+/** Error thrown when the Resend API returns a non-success response. */
+ResendError, 
+/** Resend HTTP API transport. */
+ResendTransport, } from "./transports/resend.js";
+export { 
+/** Decorator transport that retries failed sends with configurable backoff. */
+RetryTransport, } from "./transports/retry.js";
+export { 
+/** Error thrown when the SendGrid API returns a non-success response. */
+SendGridError, 
+/** SendGrid v3 HTTP API transport. */
+SendGridTransport, } from "./transports/sendgrid.js";
+export { 
+/** Error thrown when the AWS SES API returns a non-success response. */
+SESError, 
+/** AWS SES v2 HTTP API transport. */
+SESTransport, } from "./transports/ses.js";
+export { 
+/** SMTP transport orchestrating adapter, MIME builder, and protocol logic. */
+SMTPTransport, } from "./transports/smtp.js";
+export type { EmailEvent } from "./webhooks.js";
+export { 
+/** Parse a Brevo webhook payload into normalized email events. */
+parseBrevoWebhook, 
+/** Parse a Mailgun webhook payload into normalized email events. */
+parseMailgunWebhook, 
+/** Parse a Postmark webhook payload into normalized email events. */
+parsePostmarkWebhook, 
+/** Parse a Resend webhook payload into normalized email events. */
+parseResendWebhook, 
+/** Parse a SendGrid Event Webhook payload into normalized email events. */
+parseSendGridWebhook, 
+/** Parse an AWS SES SNS webhook payload into normalized email events. */
+parseSesWebhook, 
+/** Verify a Mailgun webhook using the nested signature object. */
+verifyMailgunPayload, 
+/** Verify a Mailgun webhook HMAC signature. */
+verifyMailgunSignature, 
+/** Verify a Resend webhook Svix-style signature. */
+verifyResendSignature, } from "./webhooks.js";