sently 0.3.3 → 0.4.1

package/dist/transports/preview.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/preview.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * PreviewTransport — development transport that writes emails to disk\n * instead of sending them. Optionally opens in the default browser.\n * Use in place of a real transport during local development.\n *\n * @example\n * ```ts\n * import { PreviewTransport } from 'sently/transports/preview'\n * const transport = new PreviewTransport({ outDir: './.emails', open: true })\n * ```\n */\nimport { extractEmails } from \"../core/address.js\";\nimport { buildMIME } from \"../core/mime.js\";\nimport type {\n  MailOptions,\n  PreviewConfig,\n  SendResult,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\nfunction sanitizeSubject(subject: string): string {\n  const sanitized = subject.replace(/[^a-zA-Z0-9]+/g, \"-\").replace(/^-|-$/g, \"\");\n  return sanitized.slice(0, 40) || \"no-subject\";\n}\n\nfunction getOpenCommand(platform: string): string {\n  if (platform === \"darwin\") {\n    return \"open\";\n  }\n  if (platform === \"win32\") {\n    return \"start\";\n  }\n  return \"xdg-open\";\n}\n\n/**\n * Development transport that writes emails to disk instead of sending them.\n */\nexport class PreviewTransport implements Transport {\n  private readonly outDir: string;\n  private readonly open: boolean;\n  private readonly format: \"eml\" | \"html\";\n\n  /** Creates a preview transport with optional output directory and format. */\n  constructor(config?: PreviewConfig) {\n    this.outDir = config?.outDir ?? \"./.emails\";\n    this.open = config?.open ?? false;\n    this.format = config?.format ?? \"eml\";\n  }\n\n  /** Writes the message to disk and returns a synthetic SendResult. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const resolvedOptions = { ...options, attachments };\n    const mime = await buildMIME(resolvedOptions);\n\n    const fs = await import(\"node:fs/promises\");\n    await fs.mkdir(this.outDir, { recursive: true });\n\n    const filename = `${Date.now()}-${sanitizeSubject(options.subject)}.${this.format}`;\n    const filepath = `${this.outDir}/${filename}`;\n\n    if (this.format === \"html\") {\n      const html =\n        options.html ??\n        (options.text\n          ? `<pre>${options.text.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\")}</pre>`\n          : \"\");\n      await fs.writeFile(filepath, html, \"utf8\");\n    } else {\n      await fs.writeFile(filepath, mime.raw);\n    }\n\n    console.log(`[sently preview] Written: ${filepath}`);\n\n    if (this.open) {\n      const { spawn } = await import(\"node:child_process\");\n      const command = getOpenCommand(process.platform);\n      spawn(command, [filepath], { detached: true, stdio: \"ignore\" }).unref();\n    }\n\n    return {\n      messageId: mime.messageId,\n      accepted: extractEmails(options.to),\n      rejected: [],\n      response: `preview: ${filepath}`,\n      envelope: mime.envelope,\n    };\n  }\n\n  /** Always succeeds — preview transport requires no external connectivity. */\n  async verify(): Promise<VerifyResult> {\n    return { ok: true, provider: \"preview\" };\n  }\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;AAuBA,SAAS,eAAe,CAAC,SAAyB;AAAA,EAChD,MAAM,YAAY,QAAQ,QAAQ,kBAAkB,GAAG,EAAE,QAAQ,UAAU,EAAE;AAAA,EAC7E,OAAO,UAAU,MAAM,GAAG,EAAE,KAAK;AAAA;AAGnC,SAAS,cAAc,CAAC,UAA0B;AAAA,EAChD,IAAI,aAAa,UAAU;AAAA,IACzB,OAAO;AAAA,EACT;AAAA,EACA,IAAI,aAAa,SAAS;AAAA,IACxB,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA;AAAA;AAMF,MAAM,iBAAsC;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EAGjB,WAAW,CAAC,QAAwB;AAAA,IAClC,KAAK,SAAS,QAAQ,UAAU;AAAA,IAChC,KAAK,OAAO,QAAQ,QAAQ;AAAA,IAC5B,KAAK,SAAS,QAAQ,UAAU;AAAA;AAAA,OAI5B,KAAI,CAAC,SAA2C;AAAA,IACpD,MAAM,cAAc,MAAM,mBAAmB,QAAQ,WAAW;AAAA,IAChE,MAAM,kBAAkB,KAAK,SAAS,YAAY;AAAA,IAClD,MAAM,OAAO,MAAM,UAAU,eAAe;AAAA,IAE5C,MAAM,KAAK,MAAa;AAAA,IACxB,MAAM,GAAG,MAAM,KAAK,QAAQ,EAAE,WAAW,KAAK,CAAC;AAAA,IAE/C,MAAM,WAAW,GAAG,KAAK,IAAI,KAAK,gBAAgB,QAAQ,OAAO,KAAK,KAAK;AAAA,IAC3E,MAAM,WAAW,GAAG,KAAK,UAAU;AAAA,IAEnC,IAAI,KAAK,WAAW,QAAQ;AAAA,MAC1B,MAAM,OACJ,QAAQ,SACP,QAAQ,OACL,QAAQ,QAAQ,KAAK,QAAQ,MAAM,OAAO,EAAE,QAAQ,MAAM,MAAM,EAAE,QAAQ,MAAM,MAAM,YACtF;AAAA,MACN,MAAM,GAAG,UAAU,UAAU,MAAM,MAAM;AAAA,IAC3C,EAAO;AAAA,MACL,MAAM,GAAG,UAAU,UAAU,KAAK,GAAG;AAAA;AAAA,IAGvC,QAAQ,IAAI,6BAA6B,UAAU;AAAA,IAEnD,IAAI,KAAK,MAAM;AAAA,MACb,QAAQ,UAAU,MAAa;AAAA,MAC/B,MAAM,UAAU,eAAe,QAAQ,QAAQ;AAAA,MAC/C,MAAM,SAAS,CAAC,QAAQ,GAAG,EAAE,UAAU,MAAM,OAAO,SAAS,CAAC,EAAE,MAAM;AAAA,IACxE;AAAA,IAEA,OAAO;AAAA,MACL,WAAW,KAAK;AAAA,MAChB,UAAU,cAAc,QAAQ,EAAE;AAAA,MAClC,UAAU,CAAC;AAAA,MACX,UAAU,YAAY;AAAA,MACtB,UAAU,KAAK;AAAA,IACjB;AAAA;AAAA,OAII,OAAM,GAA0B;AAAA,IACpC,OAAO,EAAE,IAAI,MAAM,UAAU,UAAU;AAAA;AAE3C;",
+  "debugId": "A9DB64292AD1542264756E2164756E21",
+  "names": []
+}

package/dist/transports/resend.d.ts

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

package/dist/{src/transports → transports}/resend.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/resend.ts
 class ResendError extends Error {
@@ -77,10 +77,34 @@ class ResendTransport {
       }
     };
   }
+  async verify() {
+    try {
+      const response = await fetch(`${this.baseUrl}/domains`, {
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`
+        }
+      });
+      if (!response.ok) {
+        const payload = await response.json().catch(() => ({}));
+        return {
+          ok: false,
+          provider: "resend",
+          message: payload.message ?? `HTTP ${response.status}`
+        };
+      }
+      return { ok: true, provider: "resend", message: "API key is valid" };
+    } catch (err) {
+      return {
+        ok: false,
+        provider: "resend",
+        message: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
 }
 export {
   ResendTransport,
   ResendError
 };
 
-//# debugId=98FD7F3A23B2FBC264756E2164756E21
+//# debugId=C97D4F9F26828E0A64756E2164756E21

package/dist/transports/resend.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/resend.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * Resend HTTP API transport for sending email via api.resend.com.\n *\n * @example\n * ```ts\n * import { ResendTransport } from \"sently/transports/resend\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   transport: new ResendTransport({ apiKey: process.env.RESEND_API_KEY! }),\n * });\n *\n * await mailer.send({\n *   from: \"onboarding@yourdomain.com\",\n *   to: \"recipient@example.com\",\n *   subject: \"Hello\",\n *   html: \"<p>Sent via Resend</p>\",\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/** Resend API configuration. */\nexport interface ResendConfig {\n  apiKey: string;\n  baseUrl?: string;\n}\n\n/** Error thrown when the Resend API returns a non-success response. */\nexport class ResendError extends Error {\n  /** Creates a Resend 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 = \"ResendError\";\n  }\n}\n\n/**\n * Resend HTTP API transport.\n */\nexport class ResendTransport implements Transport {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  /** Creates a Resend transport with the given API key. */\n  constructor(config: ResendConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl ?? \"https://api.resend.com\";\n  }\n\n  /** Sends an email via the Resend HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const from = parseAddresses(options.from)[0];\n    const body = {\n      from: from ? toMIMEHeader(from) : \"\",\n      to: extractEmails(options.to),\n      subject: options.subject,\n      ...(options.cc ? { cc: extractEmails(options.cc) } : {}),\n      ...(options.bcc ? { bcc: extractEmails(options.bcc) } : {}),\n      ...(options.replyTo ? { reply_to: extractEmails(options.replyTo) } : {}),\n      ...(options.text ? { text: options.text } : {}),\n      ...(options.html ? { html: options.html } : {}),\n      ...(options.headers ? { headers: options.headers } : {}),\n      ...(attachments.length > 0\n        ? {\n            attachments: attachments.map((att) => ({\n              filename: att.filename,\n              content:\n                att.content instanceof Uint8Array\n                  ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n                  : att.content,\n              ...(att.contentType ? { content_type: att.contentType } : {}),\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(`${this.baseUrl}/emails`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    const payload = (await response.json()) as { id?: string; message?: string };\n\n    if (!response.ok) {\n      throw new ResendError(payload.message ?? \"Resend API error\", response.status, payload);\n    }\n\n    const accepted = extractEmails(options.to);\n    return {\n      messageId: payload.id ?? options.messageId ?? \"\",\n      accepted,\n      rejected: [],\n      response: payload.message ?? \"Email sent\",\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 Resend API key by listing domains. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const response = await fetch(`${this.baseUrl}/domains`, {\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n        },\n      });\n\n      if (!response.ok) {\n        const payload = (await response.json().catch(() => ({}))) as { message?: string };\n        return {\n          ok: false,\n          provider: \"resend\",\n          message: payload.message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return { ok: true, provider: \"resend\", message: \"API key is valid\" };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"resend\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "C97D4F9F26828E0A64756E2164756E21",
+  "names": []
+}

package/dist/transports/resolve-attachments.d.ts

@@ -0,0 +1,12 @@
+import type { Attachment } from "../core/types.js";
+/** Options for {@link resolveAttachments}. */
+export interface ResolveAttachmentsOptions {
+    /** If set, attachment paths must resolve within this directory.
+     *  Prevents symlink escape and path traversal. Opt-in only. */
+    basePath?: string;
+}
+/**
+ * Resolve attachment.path to in-memory Uint8Array content.
+ * @throws When attachment.path is used on runtimes without node:fs/promises
+ */
+export declare function resolveAttachments(attachments: Attachment[] | undefined, options?: ResolveAttachmentsOptions): Promise<Attachment[]>;

package/dist/transports/retry.d.ts

@@ -0,0 +1,21 @@
+import type { MailOptions, RetryConfig, SendResult, Transport, VerifyResult } from "../core/types.js";
+/**
+ * Decorator transport that retries failed sends with configurable backoff.
+ */
+export declare class RetryTransport implements Transport {
+    private readonly inner;
+    private readonly _sleep;
+    private readonly maxAttempts;
+    private readonly backoff;
+    private readonly baseDelay;
+    private readonly retryOn;
+    private readonly onRetry;
+    /** Wraps an inner transport with retry logic and optional backoff configuration. */
+    constructor(inner: Transport, config?: RetryConfig, _sleep?: (ms: number) => Promise<void>);
+    /** Sends with retries according to configured backoff and retry rules. */
+    send(options: 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/transports/retry.js

@@ -0,0 +1,79 @@
+import {
+  SMTPError
+} from "../chunk-tjsgb3qb.js";
+import"../chunk-794hc3m4.js";
+import"../chunk-v0bahtg2.js";
+
+// src/transports/retry.ts
+var DEFAULT_RETRY_ON = [429, 500, 502, 503, 504];
+function computeDelay(attempt, backoff, base) {
+  if (backoff === "exponential") {
+    return base * 2 ** (attempt - 1);
+  }
+  if (backoff === "linear") {
+    return base * attempt;
+  }
+  return base;
+}
+function shouldRetry(err, retryOn) {
+  if (err instanceof SMTPError && err.code === 535) {
+    return false;
+  }
+  if (typeof err === "object" && err !== null && "statusCode" in err && typeof err.statusCode === "number") {
+    return retryOn.includes(err.statusCode);
+  }
+  return true;
+}
+
+class RetryTransport {
+  inner;
+  _sleep;
+  maxAttempts;
+  backoff;
+  baseDelay;
+  retryOn;
+  onRetry;
+  constructor(inner, config, _sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))) {
+    this.inner = inner;
+    this._sleep = _sleep;
+    this.maxAttempts = config?.maxAttempts ?? 3;
+    this.backoff = config?.backoff ?? "exponential";
+    this.baseDelay = config?.baseDelay ?? 1000;
+    this.retryOn = config?.retryOn ?? DEFAULT_RETRY_ON;
+    this.onRetry = config?.onRetry;
+  }
+  async send(options) {
+    let lastError;
+    for (let attempt = 1;attempt <= this.maxAttempts; attempt++) {
+      try {
+        return await this.inner.send(options);
+      } catch (err) {
+        lastError = err;
+        if (attempt === this.maxAttempts) {
+          throw err;
+        }
+        if (!shouldRetry(err, this.retryOn)) {
+          throw err;
+        }
+        const delay = computeDelay(attempt, this.backoff, this.baseDelay);
+        this.onRetry?.(attempt, err);
+        await this._sleep(delay);
+      }
+    }
+    throw lastError;
+  }
+  async verify() {
+    if (this.inner.verify) {
+      return this.inner.verify();
+    }
+    return { ok: true, provider: "retry" };
+  }
+  async close() {
+    await this.inner.close?.();
+  }
+}
+export {
+  RetryTransport
+};
+
+//# debugId=F5AD32E7B75CAE2A64756E2164756E21

package/dist/transports/retry.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/retry.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * RetryTransport — decorator that wraps any sently transport\n * and retries failed sends with configurable backoff.\n * Works with SMTP, Resend, SendGrid, SES, and any custom transport.\n *\n * @example\n * ```ts\n * import { RetryTransport } from 'sently/transports/retry'\n * import { ResendTransport } from 'sently/transports/resend'\n *\n * const transport = new RetryTransport(\n *   new ResendTransport({ apiKey }),\n *   { maxAttempts: 3, backoff: 'exponential', retryOn: [429, 503] }\n * )\n * ```\n */\nimport { SMTPError } from \"../core/smtp.js\";\nimport type {\n  MailOptions,\n  RetryConfig,\n  SendResult,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\n\nconst DEFAULT_RETRY_ON = [429, 500, 502, 503, 504];\n\nfunction computeDelay(attempt: number, backoff: string, base: number): number {\n  if (backoff === \"exponential\") {\n    return base * 2 ** (attempt - 1);\n  }\n  if (backoff === \"linear\") {\n    return base * attempt;\n  }\n  return base;\n}\n\nfunction shouldRetry(err: unknown, retryOn: number[]): boolean {\n  if (err instanceof SMTPError && err.code === 535) {\n    return false;\n  }\n\n  if (\n    typeof err === \"object\" &&\n    err !== null &&\n    \"statusCode\" in err &&\n    typeof (err as { statusCode: unknown }).statusCode === \"number\"\n  ) {\n    return retryOn.includes((err as { statusCode: number }).statusCode);\n  }\n\n  return true;\n}\n\n/**\n * Decorator transport that retries failed sends with configurable backoff.\n */\nexport class RetryTransport implements Transport {\n  private readonly maxAttempts: number;\n  private readonly backoff: \"exponential\" | \"linear\" | \"fixed\";\n  private readonly baseDelay: number;\n  private readonly retryOn: number[];\n  private readonly onRetry: RetryConfig[\"onRetry\"];\n\n  /** Wraps an inner transport with retry logic and optional backoff configuration. */\n  constructor(\n    private readonly inner: Transport,\n    config?: RetryConfig,\n    private readonly _sleep: (ms: number) => Promise<void> = (ms) =>\n      new Promise((resolve) => setTimeout(resolve, ms)),\n  ) {\n    this.maxAttempts = config?.maxAttempts ?? 3;\n    this.backoff = config?.backoff ?? \"exponential\";\n    this.baseDelay = config?.baseDelay ?? 1000;\n    this.retryOn = config?.retryOn ?? DEFAULT_RETRY_ON;\n    this.onRetry = config?.onRetry;\n  }\n\n  /** Sends with retries according to configured backoff and retry rules. */\n  async send(options: MailOptions): Promise<SendResult> {\n    let lastError: unknown;\n\n    for (let attempt = 1; attempt <= this.maxAttempts; attempt++) {\n      try {\n        return await this.inner.send(options);\n      } catch (err) {\n        lastError = err;\n        if (attempt === this.maxAttempts) {\n          throw err;\n        }\n        if (!shouldRetry(err, this.retryOn)) {\n          throw err;\n        }\n        const delay = computeDelay(attempt, this.backoff, this.baseDelay);\n        this.onRetry?.(attempt, err);\n        await this._sleep(delay);\n      }\n    }\n\n    throw lastError;\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: \"retry\" };\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": ";;;;;;;AA0BA,IAAM,mBAAmB,CAAC,KAAK,KAAK,KAAK,KAAK,GAAG;AAEjD,SAAS,YAAY,CAAC,SAAiB,SAAiB,MAAsB;AAAA,EAC5E,IAAI,YAAY,eAAe;AAAA,IAC7B,OAAO,OAAO,MAAM,UAAU;AAAA,EAChC;AAAA,EACA,IAAI,YAAY,UAAU;AAAA,IACxB,OAAO,OAAO;AAAA,EAChB;AAAA,EACA,OAAO;AAAA;AAGT,SAAS,WAAW,CAAC,KAAc,SAA4B;AAAA,EAC7D,IAAI,eAAe,aAAa,IAAI,SAAS,KAAK;AAAA,IAChD,OAAO;AAAA,EACT;AAAA,EAEA,IACE,OAAO,QAAQ,YACf,QAAQ,QACR,gBAAgB,OAChB,OAAQ,IAAgC,eAAe,UACvD;AAAA,IACA,OAAO,QAAQ,SAAU,IAA+B,UAAU;AAAA,EACpE;AAAA,EAEA,OAAO;AAAA;AAAA;AAMF,MAAM,eAAoC;AAAA,EAS5B;AAAA,EAEA;AAAA,EAVF;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGjB,WAAW,CACQ,OACjB,QACiB,SAAwC,CAAC,OACxD,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC,GAClD;AAAA,IAJiB;AAAA,IAEA;AAAA,IAGjB,KAAK,cAAc,QAAQ,eAAe;AAAA,IAC1C,KAAK,UAAU,QAAQ,WAAW;AAAA,IAClC,KAAK,YAAY,QAAQ,aAAa;AAAA,IACtC,KAAK,UAAU,QAAQ,WAAW;AAAA,IAClC,KAAK,UAAU,QAAQ;AAAA;AAAA,OAInB,KAAI,CAAC,SAA2C;AAAA,IACpD,IAAI;AAAA,IAEJ,SAAS,UAAU,EAAG,WAAW,KAAK,aAAa,WAAW;AAAA,MAC5D,IAAI;AAAA,QACF,OAAO,MAAM,KAAK,MAAM,KAAK,OAAO;AAAA,QACpC,OAAO,KAAK;AAAA,QACZ,YAAY;AAAA,QACZ,IAAI,YAAY,KAAK,aAAa;AAAA,UAChC,MAAM;AAAA,QACR;AAAA,QACA,IAAI,CAAC,YAAY,KAAK,KAAK,OAAO,GAAG;AAAA,UACnC,MAAM;AAAA,QACR;AAAA,QACA,MAAM,QAAQ,aAAa,SAAS,KAAK,SAAS,KAAK,SAAS;AAAA,QAChE,KAAK,UAAU,SAAS,GAAG;AAAA,QAC3B,MAAM,KAAK,OAAO,KAAK;AAAA;AAAA,IAE3B;AAAA,IAEA,MAAM;AAAA;AAAA,OAIF,OAAM,GAA0B;AAAA,IACpC,IAAI,KAAK,MAAM,QAAQ;AAAA,MACrB,OAAO,KAAK,MAAM,OAAO;AAAA,IAC3B;AAAA,IACA,OAAO,EAAE,IAAI,MAAM,UAAU,QAAQ;AAAA;AAAA,OAIjC,MAAK,GAAkB;AAAA,IAC3B,MAAM,KAAK,MAAM,QAAQ;AAAA;AAE7B;",
+  "debugId": "F5AD32E7B75CAE2A64756E2164756E21",
+  "names": []
+}

package/dist/transports/sendgrid.d.ts

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

package/dist/{src/transports → transports}/sendgrid.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/sendgrid.ts
 class SendGridError extends Error {
@@ -95,10 +95,39 @@ class SendGridTransport {
       }
     };
   }
+  async verify() {
+    try {
+      const response = await fetch("https://api.sendgrid.com/v3/user/profile", {
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`
+        }
+      });
+      if (!response.ok) {
+        const apiError = await response.text().catch(() => "");
+        return {
+          ok: false,
+          provider: "sendgrid",
+          message: apiError || `HTTP ${response.status}`
+        };
+      }
+      const payload = await response.json();
+      return {
+        ok: true,
+        provider: "sendgrid",
+        ...payload.username ? { message: payload.username } : {}
+      };
+    } catch (err) {
+      return {
+        ok: false,
+        provider: "sendgrid",
+        message: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
 }
 export {
   SendGridTransport,
   SendGridError
 };
 
-//# debugId=ECC2C430859A7F7264756E2164756E21
+//# debugId=53D65F527A73629564756E2164756E21

package/dist/transports/sendgrid.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/sendgrid.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * SendGrid v3 HTTP API transport for sending email via api.sendgrid.com.\n *\n * @example\n * ```ts\n * import { SendGridTransport } from \"sently/transports/sendgrid\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   transport: new SendGridTransport({ apiKey: process.env.SENDGRID_API_KEY! }),\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 } 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/** SendGrid API configuration. */\nexport interface SendGridConfig {\n  apiKey: string;\n}\n\n/** Error thrown when the SendGrid API returns a non-success response. */\nexport class SendGridError extends Error {\n  /** Creates a SendGrid 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 = \"SendGridError\";\n  }\n}\n\n/**\n * SendGrid v3 HTTP API transport.\n */\nexport class SendGridTransport implements Transport {\n  private readonly apiKey: string;\n\n  /** Creates a SendGrid transport with the given API key. */\n  constructor(config: SendGridConfig) {\n    this.apiKey = config.apiKey;\n  }\n\n  /** Sends an email via the SendGrid v3 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 personalization = {\n      to: parseAddresses(options.to).map((addr) => ({ email: addr.address, name: addr.name })),\n      ...(options.cc\n        ? {\n            cc: parseAddresses(options.cc).map((addr) => ({\n              email: addr.address,\n              name: addr.name,\n            })),\n          }\n        : {}),\n      ...(options.bcc\n        ? {\n            bcc: parseAddresses(options.bcc).map((addr) => ({\n              email: addr.address,\n              name: addr.name,\n            })),\n          }\n        : {}),\n    };\n\n    const body = {\n      personalizations: [personalization],\n      from: from\n        ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n        : { email: \"\" },\n      subject: options.subject,\n      ...(options.replyTo\n        ? {\n            reply_to: parseAddresses(options.replyTo).map((addr) => ({\n              email: addr.address,\n              name: addr.name,\n            }))[0],\n          }\n        : {}),\n      content: [\n        ...(options.text ? [{ type: \"text/plain\", value: options.text }] : []),\n        ...(options.html ? [{ type: \"text/html\", value: options.html }] : []),\n      ],\n      ...(attachments.length > 0\n        ? {\n            attachments: attachments.map((att) => ({\n              filename: att.filename,\n              type: att.contentType ?? \"application/octet-stream\",\n              content:\n                att.content instanceof Uint8Array\n                  ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n                  : att.content,\n              ...(att.contentId ? { content_id: att.contentId } : {}),\n              disposition: att.inline ? \"inline\" : \"attachment\",\n            })),\n          }\n        : {}),\n    };\n\n    const response = await fetch(\"https://api.sendgrid.com/v3/mail/send\", {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      const apiError = await response.text();\n      throw new SendGridError(\"SendGrid API error\", response.status, apiError);\n    }\n\n    const messageId = response.headers.get(\"x-message-id\") ?? options.messageId ?? \"\";\n\n    return {\n      messageId,\n      accepted: extractEmails(options.to),\n      rejected: [],\n      response: \"Accepted\",\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 SendGrid API key by fetching the user profile. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const response = await fetch(\"https://api.sendgrid.com/v3/user/profile\", {\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n        },\n      });\n\n      if (!response.ok) {\n        const apiError = await response.text().catch(() => \"\");\n        return {\n          ok: false,\n          provider: \"sendgrid\",\n          message: apiError || `HTTP ${response.status}`,\n        };\n      }\n\n      const payload = (await response.json()) as { username?: string };\n      return {\n        ok: true,\n        provider: \"sendgrid\",\n        ...(payload.username ? { message: payload.username } : {}),\n      };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"sendgrid\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "53D65F527A73629564756E2164756E21",
+  "names": []
+}

package/dist/transports/ses.d.ts

@@ -0,0 +1,25 @@
+import type { MailOptions, SESConfig, SendResult, Transport, VerifyResult } from "../core/types.js";
+/** Error thrown when the AWS SES API returns a non-success response. */
+export declare class SESError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    readonly requestId: string;
+    /** Creates an AWS SES API error with status code, error code, and request ID. */
+    constructor(message: string, statusCode: number, code: string, requestId: string);
+}
+/**
+ * AWS SES v2 HTTP API transport.
+ */
+export declare class SESTransport implements Transport {
+    private readonly accessKeyId;
+    private readonly secretAccessKey;
+    private readonly region;
+    private readonly sessionToken;
+    private readonly dkim;
+    /** Creates an SES transport with AWS credentials. */
+    constructor(config: SESConfig);
+    /** Sends an email via the AWS SES v2 HTTP API. */
+    send(options: MailOptions): Promise<SendResult>;
+    /** Verifies AWS credentials by listing SES configuration sets. */
+    verify(): Promise<VerifyResult>;
+}

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

@@ -1,16 +1,16 @@
 import {
   buildMIME
-} from "../../chunk-dhbe64fc.js";
+} from "../chunk-j6qw8ms6.js";
 import {
   extractEmails,
   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/core/sigv4.ts
 var encoder = new TextEncoder;
@@ -121,11 +121,13 @@ class SESTransport {
   secretAccessKey;
   region;
   sessionToken;
+  dkim;
   constructor(config) {
     this.accessKeyId = config.accessKeyId;
     this.secretAccessKey = config.secretAccessKey;
     this.region = config.region ?? "us-east-1";
     this.sessionToken = config.sessionToken;
+    this.dkim = config.dkim;
   }
   async send(options) {
     const attachments = await resolveAttachments(options.attachments);
@@ -142,7 +144,7 @@ class SESTransport {
     };
     let requestBody;
     if (attachments.length > 0) {
-      const mime = await buildMIME(resolvedOptions);
+      const mime = await buildMIME(resolvedOptions, this.dkim);
       requestBody = {
         FromEmailAddress: fromEmail,
         Destination: destination,
@@ -205,10 +207,47 @@ class SESTransport {
       }
     };
   }
+  async verify() {
+    try {
+      const url = `https://email.${this.region}.amazonaws.com/v2/email/configuration-sets`;
+      const signed = await signRequest({
+        method: "GET",
+        url,
+        headers: {},
+        body: "",
+        credentials: {
+          accessKeyId: this.accessKeyId,
+          secretAccessKey: this.secretAccessKey,
+          region: this.region,
+          service: "ses",
+          ...this.sessionToken ? { sessionToken: this.sessionToken } : {}
+        }
+      });
+      const response = await fetch(url, {
+        method: "GET",
+        headers: signed.headers
+      });
+      const payload = await response.json().catch(() => ({}));
+      if (!response.ok) {
+        return {
+          ok: false,
+          provider: "ses",
+          message: payload.message ?? `HTTP ${response.status}`
+        };
+      }
+      return { ok: true, provider: "ses", message: "Credentials are valid" };
+    } catch (err) {
+      return {
+        ok: false,
+        provider: "ses",
+        message: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
 }
 export {
   SESTransport,
   SESError
 };
 
-//# debugId=FC953DAF4FBD627764756E2164756E21
+//# debugId=6145DD9B4D8CB4E464756E2164756E21

package/dist/{src/transports → transports}/ses.js.map

@@ -3,9 +3,9 @@
   "sources": ["../src/core/sigv4.ts", "../src/transports/ses.ts"],
   "sourcesContent": [
     "/**\n * @module\n * AWS Signature Version 4 signing using Web Crypto (HMAC-SHA256).\n * Works on Node.js, Bun, Deno, and Cloudflare Workers.\n * No external dependencies.\n *\n * @example\n * ```ts\n * import { signRequest } from \"sently/core/sigv4\";\n * const signed = await signRequest({\n *   method: \"POST\",\n *   url: \"https://email.us-east-1.amazonaws.com/v2/email/outbound-emails\",\n *   headers: { \"content-type\": \"application/json\" },\n *   body: '{\"...\"}',\n *   credentials: { accessKeyId, secretAccessKey, region: \"us-east-1\", service: \"ses\" },\n * });\n * ```\n */\n\n/** AWS credentials and signing scope for SigV4. */\nexport interface SigV4Credentials {\n  accessKeyId: string;\n  secretAccessKey: string;\n  region: string;\n  service: string;\n  sessionToken?: string;\n}\n\n/** HTTP request to sign with AWS Signature Version 4. */\nexport interface SigV4Request {\n  method: string;\n  url: string;\n  headers: Record<string, string>;\n  body: string;\n  credentials: SigV4Credentials;\n  /** Override datetime for testing. Full 'YYYYMMDDTHHMMSSZ' when provided. */\n  _date?: string;\n}\n\n/** Signed request headers including Authorization. */\nexport interface SigV4Result {\n  /** All headers including Authorization, x-amz-date, and x-amz-security-token */\n  headers: Record<string, string>;\n}\n\nconst encoder = new TextEncoder();\n\n/**\n * Compute SHA-256 hash of a string using Web Crypto.\n * Returns lowercase hex string.\n * @internal\n */\nexport async function sha256Hex(data: string): Promise<string> {\n  const hash = await crypto.subtle.digest(\"SHA-256\", encoder.encode(data));\n  return bytesToHex(new Uint8Array(hash));\n}\n\n/**\n * Compute HMAC-SHA256 using Web Crypto.\n * @internal\n */\nexport async function hmacSHA256(key: Uint8Array | string, data: string): Promise<Uint8Array> {\n  const keyBytes = typeof key === \"string\" ? encoder.encode(key) : new Uint8Array(key);\n  const cryptoKey = await crypto.subtle.importKey(\n    \"raw\",\n    keyBytes,\n    { name: \"HMAC\", hash: \"SHA-256\" },\n    false,\n    [\"sign\"],\n  );\n  const signature = await crypto.subtle.sign(\"HMAC\", cryptoKey, encoder.encode(data));\n  return new Uint8Array(signature);\n}\n\n/**\n * Sign an HTTP request with AWS Signature Version 4.\n * Returns the complete set of headers to include in the request.\n */\nexport async function signRequest(request: SigV4Request): Promise<SigV4Result> {\n  const { method, url, body, credentials } = request;\n  const parsed = new URL(url);\n  const amzDate = request._date ?? `${new Date().toISOString().replace(/[-:]/g, \"\").slice(0, 16)}Z`;\n  const dateStamp = amzDate.slice(0, 8);\n\n  const headers: Record<string, string> = {\n    ...Object.fromEntries(\n      Object.entries(request.headers).map(([key, value]) => [key.toLowerCase(), value.trim()]),\n    ),\n    host: parsed.host,\n    \"x-amz-date\": amzDate,\n  };\n\n  if (credentials.sessionToken) {\n    headers[\"x-amz-security-token\"] = credentials.sessionToken;\n  }\n\n  const signedHeaderNames = Object.keys(headers)\n    .map((name) => name.toLowerCase())\n    .sort();\n  const signedHeaders = signedHeaderNames.join(\";\");\n  const canonicalHeaders = `${signedHeaderNames.map((name) => `${name}:${headers[name]}`).join(\"\\n\")}\\n`;\n  const canonicalQuery = normalizeQuery(parsed.searchParams);\n  const payloadHash = await sha256Hex(body);\n  const canonicalRequest = [\n    method.toUpperCase(),\n    canonicalUri(parsed.pathname),\n    canonicalQuery,\n    canonicalHeaders,\n    signedHeaders,\n    payloadHash,\n  ].join(\"\\n\");\n\n  const credentialScope = `${dateStamp}/${credentials.region}/${credentials.service}/aws4_request`;\n  const stringToSign = [\n    \"AWS4-HMAC-SHA256\",\n    amzDate,\n    credentialScope,\n    await sha256Hex(canonicalRequest),\n  ].join(\"\\n\");\n\n  const signingKey = await deriveSigningKey(\n    credentials.secretAccessKey,\n    dateStamp,\n    credentials.region,\n    credentials.service,\n  );\n  const signature = bytesToHex(await hmacSHA256(signingKey, stringToSign));\n  const authorization = [\n    `AWS4-HMAC-SHA256 Credential=${credentials.accessKeyId}/${credentialScope}`,\n    `SignedHeaders=${signedHeaders}`,\n    `Signature=${signature}`,\n  ].join(\", \");\n\n  return {\n    headers: {\n      ...headers,\n      Authorization: authorization,\n    },\n  };\n}\n\nasync function deriveSigningKey(\n  secretAccessKey: string,\n  dateStamp: string,\n  region: string,\n  service: string,\n): Promise<Uint8Array> {\n  const kDate = await hmacSHA256(`AWS4${secretAccessKey}`, dateStamp);\n  const kRegion = await hmacSHA256(kDate, region);\n  const kService = await hmacSHA256(kRegion, service);\n  return hmacSHA256(kService, \"aws4_request\");\n}\n\nfunction canonicalUri(pathname: string): string {\n  if (!pathname || pathname === \"/\") {\n    return \"/\";\n  }\n  return pathname\n    .split(\"/\")\n    .map((segment) => encodeURIComponent(decodeURIComponent(segment)))\n    .join(\"/\");\n}\n\nfunction normalizeQuery(searchParams: URLSearchParams): string {\n  const pairs: string[] = [];\n  for (const [key, value] of searchParams.entries()) {\n    pairs.push(`${encodeRfc3986(key)}=${encodeRfc3986(value)}`);\n  }\n  pairs.sort();\n  return pairs.join(\"&\");\n}\n\nfunction encodeRfc3986(value: string): string {\n  return encodeURIComponent(value).replace(\n    /[!'()*]/g,\n    (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`,\n  );\n}\n\nfunction bytesToHex(bytes: Uint8Array): string {\n  return Array.from(bytes, (byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n}\n",
-    "/**\n * @module\n * AWS SES v2 HTTP transport for sently.\n * Signs requests with AWS Signature Version 4 using Web Crypto.\n * Works on Node.js, Bun, Deno, and Cloudflare Workers.\n *\n * @example\n * ```ts\n * import { SESTransport } from \"sently/transports/ses\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   transport: new SESTransport({\n *     accessKeyId: process.env.AWS_ACCESS_KEY_ID!,\n *     secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,\n *     region: \"us-east-1\",\n *   }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { buildMIME } from \"../core/mime.js\";\nimport { signRequest } from \"../core/sigv4.js\";\nimport type { MailOptions, SESConfig, SendResult, Transport } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the AWS SES API returns a non-success response. */\nexport class SESError extends Error {\n  /** Creates an AWS SES API error with status code, error code, and request ID. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly code: string,\n    public readonly requestId: string,\n  ) {\n    super(message);\n    this.name = \"SESError\";\n  }\n}\n\n/**\n * AWS SES v2 HTTP API transport.\n */\nexport class SESTransport implements Transport {\n  private readonly accessKeyId: string;\n  private readonly secretAccessKey: string;\n  private readonly region: string;\n  private readonly sessionToken: string | undefined;\n\n  /** Creates an SES transport with AWS credentials. */\n  constructor(config: SESConfig) {\n    this.accessKeyId = config.accessKeyId;\n    this.secretAccessKey = config.secretAccessKey;\n    this.region = config.region ?? \"us-east-1\";\n    this.sessionToken = config.sessionToken;\n  }\n\n  /** Sends an email via the AWS SES v2 HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const resolvedOptions = { ...options, attachments };\n    const from = parseAddresses(options.from)[0];\n    const fromEmail = from ? toMIMEHeader(from) : \"\";\n    const toEmails = extractEmails(options.to);\n    const ccEmails = options.cc ? extractEmails(options.cc) : [];\n    const bccEmails = options.bcc ? extractEmails(options.bcc) : [];\n\n    const destination = {\n      ToAddresses: toEmails,\n      CcAddresses: ccEmails,\n      BccAddresses: bccEmails,\n    };\n\n    let requestBody: Record<string, unknown>;\n\n    if (attachments.length > 0) {\n      const mime = await buildMIME(resolvedOptions);\n      requestBody = {\n        FromEmailAddress: fromEmail,\n        Destination: destination,\n        Content: {\n          Raw: {\n            Data: encodeBase64(mime.raw).replace(/\\r\\n/g, \"\"),\n          },\n        },\n      };\n    } else {\n      requestBody = {\n        FromEmailAddress: fromEmail,\n        Destination: destination,\n        Content: {\n          Simple: {\n            Subject: { Data: options.subject, Charset: \"UTF-8\" },\n            Body: {\n              ...(options.text ? { Text: { Data: options.text, Charset: \"UTF-8\" } } : {}),\n              ...(options.html ? { Html: { Data: options.html, Charset: \"UTF-8\" } } : {}),\n            },\n          },\n        },\n      };\n    }\n\n    const body = JSON.stringify(requestBody);\n    const url = `https://email.${this.region}.amazonaws.com/v2/email/outbound-emails`;\n    const signed = await signRequest({\n      method: \"POST\",\n      url,\n      headers: {\n        \"content-type\": \"application/json\",\n      },\n      body,\n      credentials: {\n        accessKeyId: this.accessKeyId,\n        secretAccessKey: this.secretAccessKey,\n        region: this.region,\n        service: \"ses\",\n        ...(this.sessionToken ? { sessionToken: this.sessionToken } : {}),\n      },\n    });\n\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: signed.headers,\n      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 SESError(\n        payload.message ?? \"SES API error\",\n        response.status,\n        payload.Code ?? \"\",\n        response.headers.get(\"x-amzn-requestid\") ?? \"\",\n      );\n    }\n\n    const messageId = payload.MessageId ?? \"\";\n    return {\n      messageId,\n      accepted: [...toEmails, ...ccEmails, ...bccEmails],\n      rejected: [],\n      response: `MessageId: ${messageId}`,\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n}\n"
+    "/**\n * @module\n * AWS SES v2 HTTP transport for sently.\n * Signs requests with AWS Signature Version 4 using Web Crypto.\n * Works on Node.js, Bun, Deno, and Cloudflare Workers.\n *\n * @example\n * ```ts\n * import { SESTransport } from \"sently/transports/ses\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   transport: new SESTransport({\n *     accessKeyId: process.env.AWS_ACCESS_KEY_ID!,\n *     secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,\n *     region: \"us-east-1\",\n *   }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { buildMIME } from \"../core/mime.js\";\nimport { signRequest } from \"../core/sigv4.js\";\nimport type { MailOptions, SESConfig, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the AWS SES API returns a non-success response. */\nexport class SESError extends Error {\n  /** Creates an AWS SES API error with status code, error code, and request ID. */\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly code: string,\n    public readonly requestId: string,\n  ) {\n    super(message);\n    this.name = \"SESError\";\n  }\n}\n\n/**\n * AWS SES v2 HTTP API transport.\n */\nexport class SESTransport implements Transport {\n  private readonly accessKeyId: string;\n  private readonly secretAccessKey: string;\n  private readonly region: string;\n  private readonly sessionToken: string | undefined;\n  private readonly dkim: SESConfig[\"dkim\"];\n\n  /** Creates an SES transport with AWS credentials. */\n  constructor(config: SESConfig) {\n    this.accessKeyId = config.accessKeyId;\n    this.secretAccessKey = config.secretAccessKey;\n    this.region = config.region ?? \"us-east-1\";\n    this.sessionToken = config.sessionToken;\n    this.dkim = config.dkim;\n  }\n\n  /** Sends an email via the AWS SES v2 HTTP API. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const attachments = await resolveAttachments(options.attachments);\n    const resolvedOptions = { ...options, attachments };\n    const from = parseAddresses(options.from)[0];\n    const fromEmail = from ? toMIMEHeader(from) : \"\";\n    const toEmails = extractEmails(options.to);\n    const ccEmails = options.cc ? extractEmails(options.cc) : [];\n    const bccEmails = options.bcc ? extractEmails(options.bcc) : [];\n\n    const destination = {\n      ToAddresses: toEmails,\n      CcAddresses: ccEmails,\n      BccAddresses: bccEmails,\n    };\n\n    let requestBody: Record<string, unknown>;\n\n    if (attachments.length > 0) {\n      const mime = await buildMIME(resolvedOptions, this.dkim);\n      requestBody = {\n        FromEmailAddress: fromEmail,\n        Destination: destination,\n        Content: {\n          Raw: {\n            Data: encodeBase64(mime.raw).replace(/\\r\\n/g, \"\"),\n          },\n        },\n      };\n    } else {\n      requestBody = {\n        FromEmailAddress: fromEmail,\n        Destination: destination,\n        Content: {\n          Simple: {\n            Subject: { Data: options.subject, Charset: \"UTF-8\" },\n            Body: {\n              ...(options.text ? { Text: { Data: options.text, Charset: \"UTF-8\" } } : {}),\n              ...(options.html ? { Html: { Data: options.html, Charset: \"UTF-8\" } } : {}),\n            },\n          },\n        },\n      };\n    }\n\n    const body = JSON.stringify(requestBody);\n    const url = `https://email.${this.region}.amazonaws.com/v2/email/outbound-emails`;\n    const signed = await signRequest({\n      method: \"POST\",\n      url,\n      headers: {\n        \"content-type\": \"application/json\",\n      },\n      body,\n      credentials: {\n        accessKeyId: this.accessKeyId,\n        secretAccessKey: this.secretAccessKey,\n        region: this.region,\n        service: \"ses\",\n        ...(this.sessionToken ? { sessionToken: this.sessionToken } : {}),\n      },\n    });\n\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: signed.headers,\n      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 SESError(\n        payload.message ?? \"SES API error\",\n        response.status,\n        payload.Code ?? \"\",\n        response.headers.get(\"x-amzn-requestid\") ?? \"\",\n      );\n    }\n\n    const messageId = payload.MessageId ?? \"\";\n    return {\n      messageId,\n      accepted: [...toEmails, ...ccEmails, ...bccEmails],\n      rejected: [],\n      response: `MessageId: ${messageId}`,\n      envelope: {\n        from: from?.address ?? \"\",\n        to: toEmails,\n      },\n    };\n  }\n\n  /** Verifies AWS credentials by listing SES configuration sets. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const url = `https://email.${this.region}.amazonaws.com/v2/email/configuration-sets`;\n      const signed = await signRequest({\n        method: \"GET\",\n        url,\n        headers: {},\n        body: \"\",\n        credentials: {\n          accessKeyId: this.accessKeyId,\n          secretAccessKey: this.secretAccessKey,\n          region: this.region,\n          service: \"ses\",\n          ...(this.sessionToken ? { sessionToken: this.sessionToken } : {}),\n        },\n      });\n\n      const response = await fetch(url, {\n        method: \"GET\",\n        headers: signed.headers,\n      });\n\n      const payload = (await response.json().catch(() => ({}))) as { message?: string };\n\n      if (!response.ok) {\n        return {\n          ok: false,\n          provider: \"ses\",\n          message: payload.message ?? `HTTP ${response.status}`,\n        };\n      }\n\n      return { ok: true, provider: \"ses\", message: \"Credentials are valid\" };\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"ses\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "FC953DAF4FBD627764756E2164756E21",
+  "mappings": "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",
+  "debugId": "6145DD9B4D8CB4E464756E2164756E21",
   "names": []
 }

package/dist/transports/smtp.d.ts

@@ -0,0 +1,52 @@
+import { type MIMEBuildResult } from "../core/mime.js";
+import type { SMTPResponse } from "../core/smtp.js";
+import { encodeLine } from "../core/smtp.js";
+import type { MailOptions, SendResult, SMTPConfig, SocketAdapter, Transport, VerifyResult } from "../core/types.js";
+/**
+ * SMTP transport orchestrating adapter, MIME builder, and protocol logic.
+ */
+export declare class SMTPTransport implements Transport {
+    private readonly config;
+    private adapter;
+    /** Creates an SMTP transport with the given configuration. */
+    constructor(config: SMTPConfig);
+    /** Sends an email via SMTP using the configured adapter. */
+    send(options: MailOptions): Promise<SendResult>;
+    /** Verifies SMTP connectivity and authentication without sending mail. */
+    verify(): Promise<VerifyResult>;
+    /** Closes the underlying socket adapter if connected. */
+    close(): Promise<void>;
+    private getAdapter;
+}
+/** Resolved SMTP transport configuration with defaults applied. */
+export interface ResolvedSMTPConfig {
+    host: string;
+    port: number;
+    secure: boolean;
+    auth?: SMTPConfig["auth"];
+    tls?: SMTPConfig["tls"];
+    dkim?: SMTPConfig["dkim"];
+    connectionTimeout?: number;
+    greetingTimeout?: number;
+    socketTimeout?: number;
+    direct?: boolean;
+    adapter?: SocketAdapter;
+}
+/** Apply defaults to SMTP configuration. */
+export declare function resolveSMTPConfig(config: SMTPConfig): ResolvedSMTPConfig;
+/**
+ * Connect greeting, EHLO, optional STARTTLS, and AUTH on an open adapter.
+ */
+export declare function openSMTPSession(adapter: SocketAdapter, config: ResolvedSMTPConfig): Promise<void>;
+/**
+ * MAIL FROM, RCPT TO, and DATA for a built MIME message on an authenticated session.
+ */
+export declare function deliverSMTPMessage(adapter: SocketAdapter, mime: MIMEBuildResult): Promise<SendResult>;
+/**
+ * QUIT and close an SMTP session adapter.
+ */
+export declare function closeSMTPSession(adapter: SocketAdapter): Promise<void>;
+/** Reads and parses a complete SMTP response from the adapter. */
+declare function readSMTPResponse(adapter: SocketAdapter): Promise<SMTPResponse>;
+/** @internal Test helper for raw line writes. */
+export { encodeLine, readSMTPResponse };

package/dist/transports/smtp.js

@@ -0,0 +1,27 @@
+import {
+  SMTPTransport,
+  closeSMTPSession,
+  deliverSMTPMessage,
+  openSMTPSession,
+  readSMTPResponse,
+  resolveSMTPConfig
+} from "../chunk-z3eq2t1d.js";
+import"../chunk-j6qw8ms6.js";
+import {
+  encodeLine
+} from "../chunk-tjsgb3qb.js";
+import"../chunk-ym3zzv8b.js";
+import"../chunk-bvxkmq94.js";
+import"../chunk-794hc3m4.js";
+import"../chunk-v0bahtg2.js";
+export {
+  resolveSMTPConfig,
+  readSMTPResponse,
+  openSMTPSession,
+  encodeLine,
+  deliverSMTPMessage,
+  closeSMTPSession,
+  SMTPTransport
+};
+
+//# debugId=4C3155F8A9C4A96064756E2164756E21