sently 0.3.2 → 0.4.0

package/dist/plugins/template.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/plugins/template.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Template plugin for sently.\n * Renders HTML email templates using a pluggable engine.\n * Built-in: simple {{variable}} interpolation (zero dependencies).\n * Bring your own engine: pass any render function.\n *\n * @example\n * ```ts\n * import { templatePlugin, simpleEngine } from 'sently/plugins/template'\n *\n * const mailer = await createMailer({\n *   transport: new ResendTransport({ apiKey }),\n *   plugins: [\n *     templatePlugin({\n *       engine: simpleEngine,\n *       templates: {\n *         welcome: '<h1>Hello, {{name}}!</h1>',\n *         reset:   '<p>Reset link: {{link}}</p>',\n *       },\n *     }),\n *   ],\n * })\n *\n * await mailer.send({\n *   from: '...',\n *   to: '...',\n *   subject: 'Welcome!',\n *   template: 'welcome',\n *   data: { name: 'Ali' },\n * })\n * ```\n */\nimport type { MailOptions, MailPlugin } from \"../core/types.js\";\n\n/** Renders a template string with the given data object. */\nexport type TemplateEngine = (template: string, data: Record<string, unknown>) => string;\n\n/** Configuration for the template plugin. */\nexport interface TemplatePluginConfig {\n  /**\n   * Rendering function. Use `simpleEngine` for zero-dep {{var}} interpolation,\n   * or pass any function: (template, data) => string.\n   */\n  engine: TemplateEngine;\n  /**\n   * Map of template names to HTML strings.\n   * Templates are loaded once at plugin creation time.\n   */\n  templates: Record<string, string>;\n}\n\n/**\n * Built-in zero-dependency template engine.\n * Replaces {{variable}} with the matching value from data.\n * Unknown variables are replaced with an empty string.\n */\nexport function simpleEngine(template: string, data: Record<string, unknown>): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_, key: string) => {\n    const val = data[key];\n    return val !== undefined && val !== null ? String(val) : \"\";\n  });\n}\n\n/**\n * Create a template plugin from the given config.\n * The plugin reads options.template and options.data, renders the HTML,\n * sets options.html, and removes template/data before passing to the next plugin.\n */\nexport function templatePlugin(config: TemplatePluginConfig): MailPlugin {\n  return (options: MailOptions): MailOptions => {\n    if (!options.template) {\n      return options;\n    }\n\n    const tmpl = config.templates[options.template];\n    if (!tmpl) {\n      throw new Error(`sently: template \"${options.template}\" not found`);\n    }\n\n    const html = config.engine(tmpl, options.data ?? {});\n    const { template: _template, data: _data, ...rest } = options;\n    return { ...rest, html };\n  };\n}\n"
+  ],
+  "mappings": ";;;AAyDO,SAAS,YAAY,CAAC,UAAkB,MAAuC;AAAA,EACpF,OAAO,SAAS,QAAQ,kBAAkB,CAAC,GAAG,QAAgB;AAAA,IAC5D,MAAM,MAAM,KAAK;AAAA,IACjB,OAAO,QAAQ,aAAa,QAAQ,OAAO,OAAO,GAAG,IAAI;AAAA,GAC1D;AAAA;AAQI,SAAS,cAAc,CAAC,QAA0C;AAAA,EACvE,OAAO,CAAC,YAAsC;AAAA,IAC5C,IAAI,CAAC,QAAQ,UAAU;AAAA,MACrB,OAAO;AAAA,IACT;AAAA,IAEA,MAAM,OAAO,OAAO,UAAU,QAAQ;AAAA,IACtC,IAAI,CAAC,MAAM;AAAA,MACT,MAAM,IAAI,MAAM,qBAAqB,QAAQ,qBAAqB;AAAA,IACpE;AAAA,IAEA,MAAM,OAAO,OAAO,OAAO,MAAM,QAAQ,QAAQ,CAAC,CAAC;AAAA,IACnD,QAAQ,UAAU,WAAW,MAAM,UAAU,SAAS;AAAA,IACtD,OAAO,KAAK,MAAM,KAAK;AAAA;AAAA;",
+  "debugId": "BF4AF728A3AA093064756E2164756E21",
+  "names": []
+}

package/dist/pool/connection.d.ts

@@ -0,0 +1,25 @@
+import type { MailOptions, SendResult, SMTPConfig } from "../core/types.js";
+/** A single pooled SMTP connection with a persistent session. */
+export interface PooledConnection {
+    /** Send one message over this connection. */
+    send(options: MailOptions): Promise<SendResult>;
+    /** Whether this connection is idle and available for work. */
+    readonly idle: boolean;
+    /** Number of messages sent on this connection. */
+    readonly messageCount: number;
+    /** Whether this connection can accept more messages before recycle. */
+    readonly usable: boolean;
+    /** Close the connection and end the SMTP session. */
+    close(): Promise<void>;
+}
+/** Options for creating a pooled connection. */
+export interface PooledConnectionOptions {
+    config: SMTPConfig;
+    maxMessages: number;
+    connectHost: string;
+    createAdapter: () => Promise<import("../core/types.js").SocketAdapter>;
+}
+/**
+ * Create a pooled SMTP connection with an open authenticated session.
+ */
+export declare function createPooledConnection(options: PooledConnectionOptions): Promise<PooledConnection>;

package/dist/pool/pool.d.ts

@@ -0,0 +1,59 @@
+import type { MailOptions, PoolConfig, SendResult, SMTPConfig, SocketAdapter, Transport, VerifyResult } from "../core/types.js";
+/** Options for {@link SMTPPool}. */
+export interface SMTPPoolOptions {
+    /** Factory for a new socket adapter per pooled connection. */
+    createAdapter?: () => Promise<SocketAdapter> | SocketAdapter;
+    /** Injectable clock for rate limiting (testing). */
+    now?: () => number;
+}
+/**
+ * Token bucket rate limiter with lazy refill on acquire.
+ */
+declare class RateLimiter {
+    private readonly rateDelta;
+    private readonly rateLimit;
+    private readonly now;
+    private tokens;
+    private lastRefill;
+    private waiters;
+    constructor(rateDelta: number, rateLimit: number, now?: () => number);
+    /** Wait until a token is available, then consume one. */
+    acquire(): Promise<void>;
+    /** Wake waiters after the clock advances (for testing). */
+    notify(): void;
+    private refill;
+}
+/**
+ * SMTP connection pool with optional rate limiting.
+ */
+export declare class SMTPPool implements Transport {
+    private readonly config;
+    private readonly maxConnections;
+    private readonly maxMessages;
+    private readonly createAdapterFn;
+    private readonly rateLimiter;
+    private readonly connections;
+    private readonly queue;
+    private draining;
+    private closed;
+    private processChain;
+    /** Creates an SMTP connection pool. */
+    constructor(config: SMTPConfig & PoolConfig, options?: SMTPPoolOptions);
+    /** Sends a message through the pool. */
+    send(options: MailOptions): Promise<SendResult>;
+    private scheduleProcess;
+    /** Verifies connectivity using a temporary connection. */
+    verify(): Promise<VerifyResult>;
+    /** Drains the queue and closes all connections. */
+    close(): Promise<void>;
+    /** Current number of open pooled connections. */
+    get connectionCount(): number;
+    /** Number of messages waiting in the send queue. */
+    get queueSize(): number;
+    private processQueue;
+    private spawnConnection;
+    private removeConnection;
+    private drainQueue;
+}
+/** @internal Exposed for deterministic rate limiter tests. */
+export { RateLimiter };

package/dist/{src/pool → pool}/pool.js

@@ -3,16 +3,17 @@ import {
   deliverSMTPMessage,
   openSMTPSession,
   resolveSMTPConfig
-} from "../../chunk-qb05tsqn.js";
+} from "../chunk-z3eq2t1d.js";
 import {
   buildMIME
-} from "../../chunk-dhbe64fc.js";
-import"../../chunk-ym3zzv8b.js";
+} from "../chunk-j6qw8ms6.js";
+import"../chunk-tjsgb3qb.js";
+import"../chunk-ym3zzv8b.js";
 import {
   resolveAttachments
-} from "../../chunk-hdqpvsm8.js";
-import"../../chunk-794hc3m4.js";
-import"../../chunk-v0bahtg2.js";
+} from "../chunk-bvxkmq94.js";
+import"../chunk-794hc3m4.js";
+import"../chunk-v0bahtg2.js";
 
 // src/pool/connection.ts
 async function createPooledConnection(options) {
@@ -141,6 +142,9 @@ class SMTPPool {
     }
   }
   async send(options) {
+    if (this.draining) {
+      throw new Error("SMTPPool is closing — no new messages accepted");
+    }
     if (this.closed) {
       throw new Error("SMTPPool is closed");
     }
@@ -158,20 +162,28 @@ class SMTPPool {
     });
   }
   async verify() {
-    const conn = await this.spawnConnection();
     try {
-      return true;
-    } finally {
-      await conn.close();
-      this.removeConnection(conn);
+      const conn = await this.spawnConnection();
+      try {
+        return { ok: true, provider: "smtp-pool" };
+      } finally {
+        await conn.close();
+        this.removeConnection(conn);
+      }
+    } catch (err) {
+      return {
+        ok: false,
+        provider: "smtp-pool",
+        message: err instanceof Error ? err.message : String(err)
+      };
     }
   }
   async close() {
-    this.closed = true;
     this.draining = true;
     await this.drainQueue();
-    await Promise.all(this.connections.map((c) => c.close()));
+    await Promise.allSettled(this.connections.map((c) => c.close()));
     this.connections.length = 0;
+    this.closed = true;
   }
   get connectionCount() {
     return this.connections.length;
@@ -262,4 +274,4 @@ export {
   RateLimiter
 };
 
-//# debugId=90F2338A3E37CF8464756E2164756E21
+//# debugId=8D3A435BD1D17B7464756E2164756E21

package/dist/pool/pool.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/pool/connection.ts", "../src/pool/pool.ts"],
+  "sourcesContent": [
+    "import { buildMIME } from \"../core/mime.js\";\nimport type { MailOptions, SendResult, SMTPConfig } from \"../core/types.js\";\nimport { resolveAttachments } from \"../transports/resolve-attachments.js\";\nimport {\n  closeSMTPSession,\n  deliverSMTPMessage,\n  openSMTPSession,\n  resolveSMTPConfig,\n} from \"../transports/smtp.js\";\n\n/** A single pooled SMTP connection with a persistent session. */\nexport interface PooledConnection {\n  /** Send one message over this connection. */\n  send(options: MailOptions): Promise<SendResult>;\n  /** Whether this connection is idle and available for work. */\n  readonly idle: boolean;\n  /** Number of messages sent on this connection. */\n  readonly messageCount: number;\n  /** Whether this connection can accept more messages before recycle. */\n  readonly usable: boolean;\n  /** Close the connection and end the SMTP session. */\n  close(): Promise<void>;\n}\n\n/** Options for creating a pooled connection. */\nexport interface PooledConnectionOptions {\n  config: SMTPConfig;\n  maxMessages: number;\n  connectHost: string;\n  createAdapter: () => Promise<import(\"../core/types.js\").SocketAdapter>;\n}\n\n/**\n * Create a pooled SMTP connection with an open authenticated session.\n */\nexport async function createPooledConnection(\n  options: PooledConnectionOptions,\n): Promise<PooledConnection> {\n  const config = resolveSMTPConfig(options.config);\n  const adapter = await options.createAdapter();\n  await adapter.connect(options.connectHost, config.port);\n  await openSMTPSession(adapter, config);\n\n  let messageCount = 0;\n  let idle = true;\n  let sendChain: Promise<void> = Promise.resolve();\n\n  const maxMessages = options.maxMessages;\n\n  return {\n    get idle(): boolean {\n      return idle;\n    },\n    get messageCount(): number {\n      return messageCount;\n    },\n    get usable(): boolean {\n      return messageCount < maxMessages;\n    },\n\n    async send(mailOptions: MailOptions): Promise<SendResult> {\n      const run = async (): Promise<SendResult> => {\n        idle = false;\n        try {\n          const resolvedOptions = {\n            ...mailOptions,\n            attachments: await resolveAttachments(mailOptions.attachments),\n          };\n          const mime = await buildMIME(resolvedOptions, config.dkim);\n          const result = await deliverSMTPMessage(adapter, mime);\n          messageCount += 1;\n          return result;\n        } finally {\n          idle = true;\n        }\n      };\n\n      const resultPromise = sendChain.then(run);\n      sendChain = resultPromise.then(\n        () => undefined,\n        () => undefined,\n      );\n      return resultPromise;\n    },\n\n    async close(): Promise<void> {\n      await sendChain;\n      await closeSMTPSession(adapter);\n    },\n  };\n}\n",
+    "import 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 * Token bucket rate limiter with lazy refill on acquire.\n */\nclass RateLimiter {\n  private tokens: number;\n  private lastRefill: number;\n  private waiters: Array<() => void> = [];\n\n  constructor(\n    private readonly rateDelta: number,\n    private readonly rateLimit: number,\n    private readonly now: () => number = Date.now,\n  ) {\n    this.tokens = rateDelta;\n    this.lastRefill = now();\n  }\n\n  /** Wait until a token is available, then consume one. */\n  async acquire(): Promise<void> {\n    for (;;) {\n      this.refill();\n      if (this.tokens > 0) {\n        this.tokens -= 1;\n        return;\n      }\n      await new Promise<void>((resolve) => {\n        this.waiters.push(resolve);\n      });\n    }\n  }\n\n  /** Wake waiters after the clock advances (for testing). */\n  notify(): void {\n    this.refill();\n  }\n\n  private refill(): void {\n    const t = this.now();\n    const elapsed = t - this.lastRefill;\n    if (elapsed >= this.rateLimit) {\n      const periods = Math.floor(elapsed / this.rateLimit);\n      this.tokens = Math.min(this.rateDelta, this.tokens + periods * this.rateDelta);\n      this.lastRefill += periods * this.rateLimit;\n      while (this.tokens > 0 && this.waiters.length > 0) {\n        this.tokens -= 1;\n        const next = this.waiters.shift();\n        next?.();\n      }\n    }\n  }\n}\n\n/**\n * SMTP connection pool with optional rate limiting.\n */\nexport class SMTPPool implements Transport {\n  private readonly config: SMTPConfig & PoolConfig;\n  private readonly maxConnections: number;\n  private readonly maxMessages: number;\n  private readonly createAdapterFn: () => Promise<SocketAdapter>;\n  private readonly rateLimiter: RateLimiter | null;\n  private readonly connections: PooledConnection[] = [];\n  private readonly queue: QueueEntry[] = [];\n  private draining = false;\n  private closed = false;\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  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  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  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  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  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 };\n"
+  ],
+  "mappings": "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",
+  "debugId": "8D3A435BD1D17B7464756E2164756E21",
+  "names": []
+}

package/dist/transports/brevo.d.ts

@@ -0,0 +1,20 @@
+import type { BrevoConfig, MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
+/** Error thrown when the Brevo API returns a non-success response. */
+export declare class BrevoError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    /** Creates a Brevo API error with status code and error code. */
+    constructor(message: string, statusCode: number, code: string);
+}
+/**
+ * Brevo HTTP API transport.
+ */
+export declare class BrevoTransport implements Transport {
+    private readonly apiKey;
+    /** Creates a Brevo transport with the given API key. */
+    constructor(config: BrevoConfig);
+    /** Sends an email via the Brevo HTTP API. */
+    send(options: MailOptions): Promise<SendResult>;
+    /** Verifies the Brevo API key by fetching account info. */
+    verify(): Promise<VerifyResult>;
+}

package/dist/{src/transports → transports}/brevo.js

@@ -2,11 +2,11 @@ import {
   extractEmails,
   parseAddresses,
   resolveAttachments
-} from "../../chunk-hdqpvsm8.js";
+} from "../chunk-bvxkmq94.js";
 import {
   encodeBase64
-} from "../../chunk-794hc3m4.js";
-import"../../chunk-v0bahtg2.js";
+} from "../chunk-794hc3m4.js";
+import"../chunk-v0bahtg2.js";
 
 // src/transports/brevo.ts
 class BrevoError extends Error {
@@ -79,10 +79,38 @@ class BrevoTransport {
       }
     };
   }
+  async verify() {
+    try {
+      const response = await fetch("https://api.brevo.com/v3/account", {
+        headers: {
+          "api-key": this.apiKey
+        }
+      });
+      const payload = await response.json();
+      if (!response.ok) {
+        return {
+          ok: false,
+          provider: "brevo",
+          message: payload.message ?? `HTTP ${response.status}`
+        };
+      }
+      return {
+        ok: true,
+        provider: "brevo",
+        ...payload.companyName ? { message: payload.companyName } : {}
+      };
+    } catch (err) {
+      return {
+        ok: false,
+        provider: "brevo",
+        message: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
 }
 export {
   BrevoTransport,
   BrevoError
 };
 
-//# debugId=FB124904BBBBECEB64756E2164756E21
+//# debugId=C5824397C8CE442364756E2164756E21

package/dist/transports/brevo.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/brevo.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Brevo (formerly Sendinblue) HTTP transport for sently.\n *\n * @example\n * ```ts\n * import { BrevoTransport } from \"sently/transports/brevo\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   transport: new BrevoTransport({ apiKey: \"xkeysib-...\" }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport type {\n  BrevoConfig,\n  MailOptions,\n  SendResult,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the Brevo API returns a non-success response. */\nexport class BrevoError extends Error {\n  /** Creates a Brevo API error with status code and error code. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = \"BrevoError\";\n  }\n}\n\nfunction toAddressObjects(input: MailOptions[\"to\"]): Array<{ email: string; name?: string }> {\n  return parseAddresses(input).map((addr) => ({\n    email: addr.address,\n    ...(addr.name ? { name: addr.name } : {}),\n  }));\n}\n\n/**\n * Brevo HTTP API transport.\n */\nexport class BrevoTransport implements Transport {\n  private readonly apiKey: string;\n\n  /** Creates a Brevo transport with the given API key. */\n  constructor(config: BrevoConfig) {\n    this.apiKey = config.apiKey;\n  }\n\n  /** Sends an email via the Brevo HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n\n    const body: Record<string, unknown> = {\n      sender: from\n        ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n        : { email: \"\" },\n      to: toAddressObjects(options.to),\n      subject: options.subject,\n      ...(options.cc ? { cc: toAddressObjects(options.cc) } : {}),\n      ...(options.bcc ? { bcc: toAddressObjects(options.bcc) } : {}),\n      ...(options.replyTo\n        ? {\n            replyTo: (() => {\n              const reply = parseAddresses(options.replyTo as MailOptions[\"to\"])[0];\n              return reply\n                ? { email: reply.address, ...(reply.name ? { name: reply.name } : {}) }\n                : undefined;\n            })(),\n          }\n        : {}),\n      ...(options.html ? { htmlContent: options.html } : {}),\n      ...(options.text ? { textContent: options.text } : {}),\n      ...(attachments.length > 0\n        ? {\n            attachment: attachments.map((att) => ({\n              name: att.filename,\n              content:\n                att.content instanceof Uint8Array\n                  ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n                  : att.content,\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(\"https://api.brevo.com/v3/smtp/email\", {\n      method: \"POST\",\n      headers: {\n        \"api-key\": this.apiKey,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    const payload = (await response.json()) as {\n      messageId?: string;\n      message?: string;\n      code?: string;\n    };\n\n    if (!response.ok) {\n      throw new BrevoError(\n        payload.message ?? \"Brevo API error\",\n        response.status,\n        payload.code ?? \"\",\n      );\n    }\n\n    const toEmails = extractEmails(options.to);\n    return {\n      messageId: payload.messageId ?? \"\",\n      accepted: toEmails,\n      rejected: [],\n      response: payload.messageId ?? \"sent\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n\n  /** Verifies the Brevo API key by fetching account info. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const response = await fetch(\"https://api.brevo.com/v3/account\", {\n        headers: {\n          \"api-key\": this.apiKey,\n        },\n      });\n\n      const payload = (await response.json()) as { companyName?: string; message?: string };\n\n      if (!response.ok) {\n        return {\n          ok: false,\n          provider: \"brevo\",\n          message: payload.message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return {\n        ok: true,\n        provider: \"brevo\",\n        ...(payload.companyName ? { message: payload.companyName } : {}),\n      };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"brevo\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "C5824397C8CE442364756E2164756E21",
+  "names": []
+}

package/dist/transports/mailgun.d.ts

@@ -0,0 +1,22 @@
+import type { MailgunConfig, MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
+/** Error thrown when the Mailgun API returns a non-success response. */
+export declare class MailgunError extends Error {
+    readonly statusCode: number;
+    readonly apiError: unknown;
+    /** Creates a Mailgun API error with status code and response payload. */
+    constructor(message: string, statusCode: number, apiError: unknown);
+}
+/**
+ * Mailgun HTTP API transport (multipart/form-data).
+ */
+export declare class MailgunTransport implements Transport {
+    private readonly apiKey;
+    private readonly domain;
+    private readonly baseUrl;
+    /** Creates a Mailgun transport with the given API key and domain. */
+    constructor(config: MailgunConfig);
+    /** Sends an email via the Mailgun Messages API. */
+    send(options: MailOptions): Promise<SendResult>;
+    /** Verifies the Mailgun API key by listing domains. */
+    verify(): Promise<VerifyResult>;
+}

package/dist/{src/transports → transports}/mailgun.js

@@ -3,11 +3,11 @@ import {
   parseAddresses,
   resolveAttachments,
   toMIMEHeader
-} from "../../chunk-hdqpvsm8.js";
+} from "../chunk-bvxkmq94.js";
 import {
   encodeBase64
-} from "../../chunk-794hc3m4.js";
-import"../../chunk-v0bahtg2.js";
+} from "../chunk-794hc3m4.js";
+import"../chunk-v0bahtg2.js";
 
 // src/transports/mailgun.ts
 class MailgunError extends Error {
@@ -86,10 +86,35 @@ class MailgunTransport {
       }
     };
   }
+  async verify() {
+    try {
+      const auth = encodeBase64(`api:${this.apiKey}`).replace(/\r\n/g, "");
+      const response = await fetch(`${this.baseUrl}/v3/domains`, {
+        headers: {
+          Authorization: `Basic ${auth}`
+        }
+      });
+      if (!response.ok) {
+        const payload = await response.json().catch(() => ({}));
+        return {
+          ok: false,
+          provider: "mailgun",
+          message: payload.message ?? `HTTP ${response.status}`
+        };
+      }
+      return { ok: true, provider: "mailgun", message: "API key is valid" };
+    } catch (err) {
+      return {
+        ok: false,
+        provider: "mailgun",
+        message: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
 }
 export {
   MailgunTransport,
   MailgunError
 };
 
-//# debugId=0BE9B4ECD763D6B564756E2164756E21
+//# debugId=0BB5E6A11ACE98B264756E2164756E21

package/dist/transports/mailgun.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/mailgun.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Mailgun HTTP transport for sently.\n * Uses the Mailgun Messages API v3 with multipart/form-data.\n *\n * @example\n * ```ts\n * import { MailgunTransport } from \"sently/transports/mailgun\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   transport: new MailgunTransport({\n *     apiKey: \"key-...\",\n *     domain: \"mg.example.com\",\n *   }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport type {\n  MailgunConfig,\n  MailOptions,\n  SendResult,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the Mailgun API returns a non-success response. */\nexport class MailgunError extends Error {\n  /** Creates a Mailgun API error with status code and response payload. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly apiError: unknown,\n  ) {\n    super(message);\n    this.name = \"MailgunError\";\n  }\n}\n\n/**\n * Mailgun HTTP API transport (multipart/form-data).\n */\nexport class MailgunTransport implements Transport {\n  private readonly apiKey: string;\n  private readonly domain: string;\n  private readonly baseUrl: string;\n\n  /** Creates a Mailgun transport with the given API key and domain. */\n  constructor(config: MailgunConfig) {\n    this.apiKey = config.apiKey;\n    this.domain = config.domain;\n    this.baseUrl =\n      config.region === \"eu\" ? \"https://api.eu.mailgun.net\" : \"https://api.mailgun.net\";\n  }\n\n  /** Sends an email via the Mailgun Messages API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n    const form = new FormData();\n\n    form.append(\"from\", from ? toMIMEHeader(from) : \"\");\n    form.append(\"to\", parseAddresses(options.to).map(toMIMEHeader).join(\", \"));\n\n    if (options.cc) {\n      form.append(\"cc\", parseAddresses(options.cc).map(toMIMEHeader).join(\", \"));\n    }\n    if (options.bcc) {\n      form.append(\"bcc\", parseAddresses(options.bcc).map(toMIMEHeader).join(\", \"));\n    }\n\n    form.append(\"subject\", options.subject);\n\n    if (options.text) {\n      form.append(\"text\", options.text);\n    }\n    if (options.html) {\n      form.append(\"html\", options.html);\n    }\n    if (options.replyTo) {\n      const replyTo = parseAddresses(options.replyTo)[0];\n      if (replyTo) {\n        form.append(\"h:Reply-To\", toMIMEHeader(replyTo));\n      }\n    }\n\n    for (const attachment of attachments) {\n      const content =\n        attachment.content instanceof Uint8Array\n          ? attachment.content\n          : new TextEncoder().encode(String(attachment.content ?? \"\"));\n      const blob = new Blob([new Uint8Array(content)], {\n        type: attachment.contentType ?? \"application/octet-stream\",\n      });\n      form.append(\"attachment\", blob, attachment.filename);\n    }\n\n    const auth = encodeBase64(`api:${this.apiKey}`).replace(/\\r\\n/g, \"\");\n    const response = await fetch(`${this.baseUrl}/v3/${this.domain}/messages`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Basic ${auth}`,\n      },\n      body: form,\n    });\n\n    const payload = (await response.json()) as { id?: string; message?: string };\n\n    if (!response.ok) {\n      throw new MailgunError(payload.message ?? \"Mailgun API error\", response.status, payload);\n    }\n\n    const toEmails = extractEmails(options.to);\n    return {\n      messageId: payload.id ?? \"\",\n      accepted: toEmails,\n      rejected: [],\n      response: payload.message ?? \"queued\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n\n  /** Verifies the Mailgun API key by listing domains. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const auth = encodeBase64(`api:${this.apiKey}`).replace(/\\r\\n/g, \"\");\n      const response = await fetch(`${this.baseUrl}/v3/domains`, {\n        headers: {\n          Authorization: `Basic ${auth}`,\n        },\n      });\n\n      if (!response.ok) {\n        const payload = (await response.json().catch(() => ({}))) as { message?: string };\n        return {\n          ok: false,\n          provider: \"mailgun\",\n          message: payload.message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return { ok: true, provider: \"mailgun\", message: \"API key is valid\" };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"mailgun\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "0BB5E6A11ACE98B264756E2164756E21",
+  "names": []
+}

package/dist/transports/postmark.d.ts

@@ -0,0 +1,24 @@
+import type { MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
+/** Postmark API configuration. */
+export interface PostmarkConfig {
+    serverToken: string;
+}
+/** Error thrown when the Postmark API returns a non-success response. */
+export declare class PostmarkError extends Error {
+    readonly statusCode: number;
+    readonly apiError: unknown;
+    /** Creates a Postmark API error with status code and response payload. */
+    constructor(message: string, statusCode: number, apiError: unknown);
+}
+/**
+ * Postmark HTTP API transport.
+ */
+export declare class PostmarkTransport implements Transport {
+    private readonly serverToken;
+    /** Creates a Postmark transport with the given server token. */
+    constructor(config: PostmarkConfig);
+    /** Sends an email via the Postmark HTTP API. */
+    send(options: MailOptions): Promise<SendResult>;
+    /** Verifies the Postmark server token by fetching server info. */
+    verify(): Promise<VerifyResult>;
+}

package/dist/{src/transports → transports}/postmark.js

@@ -3,11 +3,11 @@ import {
   parseAddresses,
   resolveAttachments,
   toMIMEHeader
-} from "../../chunk-hdqpvsm8.js";
+} from "../chunk-bvxkmq94.js";
 import {
   encodeBase64
-} from "../../chunk-794hc3m4.js";
-import"../../chunk-v0bahtg2.js";
+} from "../chunk-794hc3m4.js";
+import"../chunk-v0bahtg2.js";
 
 // src/transports/postmark.ts
 class PostmarkError extends Error {
@@ -76,10 +76,39 @@ class PostmarkTransport {
       }
     };
   }
+  async verify() {
+    try {
+      const response = await fetch("https://api.postmarkapp.com/server", {
+        headers: {
+          "X-Postmark-Server-Token": this.serverToken,
+          Accept: "application/json"
+        }
+      });
+      const payload = await response.json();
+      if (!response.ok) {
+        return {
+          ok: false,
+          provider: "postmark",
+          message: payload.Message ?? `HTTP ${response.status}`
+        };
+      }
+      return {
+        ok: true,
+        provider: "postmark",
+        ...payload.Name ? { message: payload.Name } : {}
+      };
+    } catch (err) {
+      return {
+        ok: false,
+        provider: "postmark",
+        message: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
 }
 export {
   PostmarkTransport,
   PostmarkError
 };
 
-//# debugId=882FB10A12306FDB64756E2164756E21
+//# debugId=650BF60942E0759C64756E2164756E21

package/dist/transports/postmark.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/postmark.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Postmark HTTP API transport for sending email via api.postmarkapp.com.\n *\n * @example\n * ```ts\n * import { PostmarkTransport } from \"sently/transports/postmark\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   transport: new PostmarkTransport({ serverToken: process.env.POSTMARK_TOKEN! }),\n * });\n *\n * await mailer.send({\n *   from: \"sender@example.com\",\n *   to: \"recipient@example.com\",\n *   subject: \"Hello\",\n *   text: \"Plain text body\",\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Postmark API configuration. */\nexport interface PostmarkConfig {\n  serverToken: string;\n}\n\n/** Error thrown when the Postmark API returns a non-success response. */\nexport class PostmarkError extends Error {\n  /** Creates a Postmark API error with status code and response payload. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly apiError: unknown,\n  ) {\n    super(message);\n    this.name = \"PostmarkError\";\n  }\n}\n\n/**\n * Postmark HTTP API transport.\n */\nexport class PostmarkTransport implements Transport {\n  private readonly serverToken: string;\n\n  /** Creates a Postmark transport with the given server token. */\n  constructor(config: PostmarkConfig) {\n    this.serverToken = config.serverToken;\n  }\n\n  /** Sends an email via the Postmark HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n\n    const body = {\n      From: from ? toMIMEHeader(from) : \"\",\n      To: parseAddresses(options.to).map(toMIMEHeader).join(\", \"),\n      Subject: options.subject,\n      ...(options.cc ? { Cc: parseAddresses(options.cc).map(toMIMEHeader).join(\", \") } : {}),\n      ...(options.bcc ? { Bcc: parseAddresses(options.bcc).map(toMIMEHeader).join(\", \") } : {}),\n      ...(options.replyTo\n        ? { ReplyTo: parseAddresses(options.replyTo).map(toMIMEHeader).join(\", \") }\n        : {}),\n      ...(options.text ? { TextBody: options.text } : {}),\n      ...(options.html ? { HtmlBody: options.html } : {}),\n      ...(options.headers\n        ? { Headers: Object.entries(options.headers).map(([Name, Value]) => ({ Name, Value })) }\n        : {}),\n      ...(attachments.length > 0\n        ? {\n            Attachments: attachments.map((att) => ({\n              Name: att.filename,\n              Content:\n                att.content instanceof Uint8Array\n                  ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n                  : att.content,\n              ContentType: att.contentType ?? \"application/octet-stream\",\n              ...(att.contentId ? { ContentID: att.contentId } : {}),\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(\"https://api.postmarkapp.com/email\", {\n      method: \"POST\",\n      headers: {\n        \"X-Postmark-Server-Token\": this.serverToken,\n        \"Content-Type\": \"application/json\",\n        Accept: \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    const payload = (await response.json()) as {\n      MessageID?: string;\n      Message?: string;\n      ErrorCode?: number;\n    };\n\n    if (!response.ok) {\n      throw new PostmarkError(payload.Message ?? \"Postmark API error\", response.status, payload);\n    }\n\n    return {\n      messageId: payload.MessageID ?? options.messageId ?? \"\",\n      accepted: extractEmails(options.to),\n      rejected: [],\n      response: payload.Message ?? \"OK\",\n      envelope: {\n        from: from?.address ?? \"\",\n        to: [\n          ...extractEmails(options.to),\n          ...(options.cc ? extractEmails(options.cc) : []),\n          ...(options.bcc ? extractEmails(options.bcc) : []),\n        ],\n      },\n    };\n  }\n\n  /** Verifies the Postmark server token by fetching server info. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const response = await fetch(\"https://api.postmarkapp.com/server\", {\n        headers: {\n          \"X-Postmark-Server-Token\": this.serverToken,\n          Accept: \"application/json\",\n        },\n      });\n\n      const payload = (await response.json()) as { Name?: string; Message?: string };\n\n      if (!response.ok) {\n        return {\n          ok: false,\n          provider: \"postmark\",\n          message: payload.Message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return {\n        ok: true,\n        provider: \"postmark\",\n        ...(payload.Name ? { message: payload.Name } : {}),\n      };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"postmark\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "650BF60942E0759C64756E2164756E21",
+  "names": []
+}

package/dist/transports/preview.d.ts

@@ -0,0 +1,15 @@
+import type { MailOptions, PreviewConfig, SendResult, Transport, VerifyResult } from "../core/types.js";
+/**
+ * Development transport that writes emails to disk instead of sending them.
+ */
+export declare class PreviewTransport implements Transport {
+    private readonly outDir;
+    private readonly open;
+    private readonly format;
+    /** Creates a preview transport with optional output directory and format. */
+    constructor(config?: PreviewConfig);
+    /** Writes the message to disk and returns a synthetic SendResult. */
+    send(options: MailOptions): Promise<SendResult>;
+    /** Always succeeds — preview transport requires no external connectivity. */
+    verify(): Promise<VerifyResult>;
+}

package/dist/transports/preview.js

@@ -0,0 +1,73 @@
+import {
+  buildMIME
+} from "../chunk-j6qw8ms6.js";
+import {
+  extractEmails,
+  resolveAttachments
+} from "../chunk-bvxkmq94.js";
+import"../chunk-794hc3m4.js";
+import {
+  __require
+} from "../chunk-v0bahtg2.js";
+
+// src/transports/preview.ts
+function sanitizeSubject(subject) {
+  const sanitized = subject.replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-|-$/g, "");
+  return sanitized.slice(0, 40) || "no-subject";
+}
+function getOpenCommand(platform) {
+  if (platform === "darwin") {
+    return "open";
+  }
+  if (platform === "win32") {
+    return "start";
+  }
+  return "xdg-open";
+}
+
+class PreviewTransport {
+  outDir;
+  open;
+  format;
+  constructor(config) {
+    this.outDir = config?.outDir ?? "./.emails";
+    this.open = config?.open ?? false;
+    this.format = config?.format ?? "eml";
+  }
+  async send(options) {
+    const attachments = await resolveAttachments(options.attachments);
+    const resolvedOptions = { ...options, attachments };
+    const mime = await buildMIME(resolvedOptions);
+    const fs = await import("node:fs/promises");
+    await fs.mkdir(this.outDir, { recursive: true });
+    const filename = `${Date.now()}-${sanitizeSubject(options.subject)}.${this.format}`;
+    const filepath = `${this.outDir}/${filename}`;
+    if (this.format === "html") {
+      const html = options.html ?? (options.text ? `<pre>${options.text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")}</pre>` : "");
+      await fs.writeFile(filepath, html, "utf8");
+    } else {
+      await fs.writeFile(filepath, mime.raw);
+    }
+    console.log(`[sently preview] Written: ${filepath}`);
+    if (this.open) {
+      const { spawn } = await import("node:child_process");
+      const command = getOpenCommand(process.platform);
+      spawn(command, [filepath], { detached: true, stdio: "ignore" }).unref();
+    }
+    return {
+      messageId: mime.messageId,
+      accepted: extractEmails(options.to),
+      rejected: [],
+      response: `preview: ${filepath}`,
+      envelope: mime.envelope
+    };
+  }
+  async verify() {
+    return { ok: true, provider: "preview" };
+  }
+}
+export {
+  PreviewTransport
+};
+
+//# debugId=A9DB64292AD1542264756E2164756E21