sently 0.6.2 → 0.7.0

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 ## [Unreleased]
 
+## [0.7.0] — 2026-05-31
+
+### Breaking + Migration
+
+Summary:
+
+- **Transport-only `createMailer`** — passing SMTP config (`host` / `port` / `auth`) to
+  `createMailer` from `sently` or `sently/mailer` throws `SentlyError` (`INVALID_CONFIG`)
+  at factory time with guidance to use `createSMTPMailer`.
+- **`sently/smtp`** — removed `createMailer` alias; export is **`createSMTPMailer` only**
+  (also available from main `"sently"`).
+- **`CreateMailerOptions`** removed — use **`TransportMailerOptions`** or
+  **`SMTPMailerOptions`** instead.
+- **Main barrel slimmed** — `"sently"` no longer re-exports transports, webhook parsers,
+  idempotency, DKIM helpers, template plugin, or `SMTPPool`. Import from subpaths
+  (e.g. `sently/transports/resend`, `sently/webhooks`).
+- **Prior breaks documented in one place:** v0.5.1 react barrel move; v0.6.2
+  transport-only main `createMailer`; v0.5.x bulk-send behavior (native batch, default
+  2 req/s throttle, `SendResult.batchError`).
+
+### Added
+
+- **`INVALID_CONFIG`** stable error code for misconfigured mailer factories
+- **`SMTPMailerOptions`** type for SMTP factory config
+- README decision-tree section and Microsoft 365 OAuth2 example
+
+### Changed
+
+- **`BulkSendOptions.concurrency` TSDoc** — documents default `1` (matches implementation)
+- Bundle size budgets updated for slimmer main entry
+- JSDoc and README examples use explicit subpath imports
+
 ## [0.6.2] — 2026-05-31
 
 ### Added

package/README.md

@@ -14,6 +14,8 @@ bun add sently
 [![tests](https://img.shields.io/badge/tests-passing-brightgreen)](#)
 [![GitHub](https://img.shields.io/github/stars/alialnaghmoush/sently?style=social&label=GitHub)](https://github.com/alialnaghmoush/sently)
 
+> **Pre-1.0 — API may change.** sently is pre-1.0 and the public API is still being refined ahead of a stable v1.0.0. Breaking changes can land in any 0.x release; review the [CHANGELOG](CHANGELOG.md) before upgrading. Pin an exact version (e.g. `"sently": "0.7.0"`) for production until v1.0.0.
+
 ---
 
 ## Why not Nodemailer?
@@ -98,7 +100,7 @@ bunx jsr add @alialnaghmoush/sently
 
 ```typescript
 import { createMailer } from "sently/mailer"; // HTTP transports (~3 KB)
-import { createMailer } from "sently/smtp"; // SMTP host/port (~15 KB)
+import { createSMTPMailer } from "sently/smtp"; // SMTP host/port (~15 KB)
 // Or: import { createSMTPMailer } from "sently";
 ```
 
@@ -109,9 +111,9 @@ import { createMailer } from "sently/smtp"; // SMTP host/port (~15 KB)
 ### SMTP with auto-detected adapter
 
 ```typescript
-import { createMailer } from "sently/smtp";
+import { createSMTPMailer } from "sently/smtp";
 
-const mailer = await createMailer({
+const mailer = await createSMTPMailer({
   host: "smtp.example.com",
   port: 587,
   auth: { user: "you@example.com", pass: "secret" },
@@ -149,12 +151,12 @@ await mailer.send({
 ### Cloudflare Worker
 
 ```typescript
-import { createMailer } from "sently/smtp";
+import { createSMTPMailer } from "sently/smtp";
 import { CloudflareAdapter } from "sently/adapters/cf";
 
 export default {
   async fetch() {
-    const mailer = await createMailer({
+    const mailer = await createSMTPMailer({
       host: "smtp.example.com",
       port: 587,
       auth: { user: "relay@example.com", pass: "secret" },
@@ -179,17 +181,18 @@ export default {
 
 | Runtime | Import | Notes |
 |---------|--------|-------|
-| Node.js (auto) | `createMailer(config)` | Auto-detected |
+| Node.js (auto) | `createSMTPMailer` from `sently/smtp` | Auto-detected adapter |
 | Node.js (explicit) | `sently/adapters/node` → `NodeAdapter` | Reference implementation |
-| Bun (auto) | `createMailer(config)` | Auto-detected |
+| Bun (auto) | `createSMTPMailer` from `sently/smtp` | Auto-detected adapter |
 | Bun (explicit) | `sently/adapters/bun` → `BunAdapter` | Node compat layer |
 | Deno | `sently/adapters/deno` → `DenoAdapter` | Native `Deno.startTls` |
 | Cloudflare Workers | `sently/adapters/cf` → `CloudflareAdapter` | `cloudflare:sockets` |
 
 ```typescript
+import { createSMTPMailer } from "sently/smtp";
 import { NodeAdapter } from "sently/adapters/node";
 
-const mailer = await createMailer({
+const mailer = await createSMTPMailer({
   host: "smtp.example.com",
   adapter: new NodeAdapter({ secure: false }),
   auth: { user: "you@example.com", pass: "secret" },
@@ -218,7 +221,7 @@ const mailer = await createMailer({ transport });
 await mailer.verify(); // test connection + auth
 ```
 
-Use `sently/mailer` instead of `sently` when passing `{ transport }` — keeps HTTP-only bundles ~10 KB smaller.
+For relay config (`host` / `port` / `auth`), prefer [`sently/smtp`](#smtp-with-auto-detected-adapter). Use `mailer` + `SMTPTransport` when you need an explicit adapter or transport-level options.
 
 **AUTH methods:** XOAUTH2, CRAM-MD5, LOGIN, and PLAIN (auto-negotiated from EHLO unless `auth.type` is set).
 
@@ -227,7 +230,9 @@ Use `sently/mailer` instead of `sently` when passing `{ transport }` — keeps H
 #### DKIM signing
 
 ```typescript
-const mailer = await createMailer({
+import { createSMTPMailer } from "sently/smtp";
+
+const mailer = await createSMTPMailer({
   host: "smtp.example.com",
   auth: { user: "you@example.com", pass: "secret" },
   dkim: {
@@ -243,9 +248,9 @@ Pass `dkim` on SMTP config or use `signDKIM` from `sently/dkim` directly. MIME l
 #### Gmail OAuth2 (XOAUTH2)
 
 ```typescript
-import { OAuth2Client } from "sently/auth/oauth2";
+import { createSMTPMailer } from "sently/smtp";
 
-const mailer = await createMailer({
+const mailer = await createSMTPMailer({
   host: "smtp.gmail.com",
   port: 465,
   secure: true,
@@ -262,12 +267,35 @@ const mailer = await createMailer({
 });
 ```
 
-Microsoft 365 uses the same `OAuth2Client` — pass `tokenUrl: MICROSOFT_TOKEN_URL` (from `sently/auth/oauth2`) on the `oauth2` config.
+#### Microsoft 365 OAuth2 (XOAUTH2)
+
+```typescript
+import { MICROSOFT_TOKEN_URL } from "sently";
+import { createSMTPMailer } from "sently/smtp";
+
+const mailer = await createSMTPMailer({
+  host: "smtp.office365.com",
+  port: 587,
+  auth: {
+    type: "OAUTH2",
+    user: "you@yourtenant.onmicrosoft.com",
+    oauth2: {
+      user: "you@yourtenant.onmicrosoft.com",
+      clientId: process.env.AZURE_CLIENT_ID!,
+      clientSecret: process.env.AZURE_CLIENT_SECRET!,
+      refreshToken: process.env.AZURE_REFRESH_TOKEN!,
+      tokenUrl: MICROSOFT_TOKEN_URL,
+    },
+  },
+});
+```
 
 #### Connection pooling
 
 ```typescript
-const mailer = await createMailer({
+import { createSMTPMailer } from "sently/smtp";
+
+const mailer = await createSMTPMailer({
   host: "smtp.example.com",
   pool: true,
   maxConnections: 5,
@@ -388,7 +416,7 @@ const mailer = await createMailer({
 
 Hooks are fully optional and zero-cost when unset. A throwing hook does **not** break the send — in non-production environments the error is logged with `console.warn` and the send continues. Pair `onRetry` with `RetryTransport` for per-attempt retry metrics.
 
-Works with both `sently/mailer` (`{ transport, hooks }`) and SMTP config (`{ host, auth, hooks }`).
+Works with both `sently/mailer` (`{ transport, hooks }`) and SMTP config via `createSMTPMailer` (`{ host, auth, hooks }`).
 
 ### IdempotencyTransport
 
@@ -423,14 +451,14 @@ Plugins transform `MailOptions` before the transport builds and sends the messag
 
 ```typescript
 import type { MailOptions } from "sently";
-import { createMailer } from "sently/smtp";
+import { createSMTPMailer } from "sently/smtp";
 
 const addFooter = (options: MailOptions) => ({
   ...options,
   html: (options.html ?? "") + '<p style="color:#999">Unsubscribe</p>',
 });
 
-const mailer = await createMailer({
+const mailer = await createSMTPMailer({
   host: "smtp.resend.com",
   port: 465,
   secure: true,
@@ -595,7 +623,8 @@ On Cloudflare Workers and browsers, use `content: Uint8Array` — `attachment.pa
 All transport errors extend `SentlyError` for unified handling while preserving existing class names and properties:
 
 ```typescript
-import { SentlyError, SMTPError } from "sently";
+import { SentlyError } from "sently/errors";
+import { SMTPError } from "sently/transports/smtp";
 import { ResendError } from "sently/transports/resend";
 // Each HTTP transport exports its own error class:
 // SendGridError  → sently/transports/sendgrid
@@ -686,10 +715,31 @@ import { createMailer } from "sently/mailer";
 import { ResendTransport } from "sently/transports/resend";
 
 // SMTP
-import { createMailer } from "sently/smtp";
+import { createSMTPMailer } from "sently/smtp";
 ```
 
-Main `createMailer` from `sently` is transport-only (~2.4 KB). Add-ons (`sently/dkim`, `sently/webhooks`, `sently/idempotency`, `sently/react`) are separate subpaths. SMTP adapters are auto-loaded at runtime unless you pass `adapter` explicitly.
+Main `"sently"` exports shared types, `createMailer` (transport), `createSMTPMailer`, `detectRuntime`, OAuth2, and `SentlyError`. Transports, webhooks, idempotency, DKIM, and plugins are separate subpaths only.
+
+---
+
+## Choosing an entrypoint
+
+```
+How do you send mail?
+│
+├─ HTTP API (Resend, SendGrid, …)
+│    import { createMailer } from "sently/mailer"
+│    import { ResendTransport } from "sently/transports/resend"
+│    createMailer({ transport: new ResendTransport({ apiKey }) })
+│
+├─ SMTP relay (host / port / auth)
+│    import { createSMTPMailer } from "sently/smtp"
+│    createSMTPMailer({ host, port, auth })
+│
+└─ Custom / decorated transport (Retry, Idempotency, Preview)
+     import { createMailer } from "sently/mailer"
+     createMailer({ transport: new RetryTransport(inner) })
+```
 
 ---
 
@@ -697,11 +747,11 @@ Main `createMailer` from `sently` is transport-only (~2.4 KB). Add-ons (`sently/
 
 | Nodemailer | sently |
 |------------|--------|
-| `nodemailer.createTransport({...})` | `await createMailer({...})` |
+| `nodemailer.createTransport({...})` | `await createSMTPMailer({...})` or `createMailer({ transport })` |
 | `transporter.sendMail(options)` | `mailer.send(options)` |
 | `transporter.verify()` | `mailer.verify()` |
 | `options.attachments[].path` | Same (Node/Bun/Deno); use `content` on edge |
-| `import nodemailer from 'nodemailer'` | `import { createMailer } from 'sently/mailer'` (HTTP) or `'sently/smtp'` (SMTP) |
+| `import nodemailer from 'nodemailer'` | `import { createMailer } from 'sently/mailer'` (HTTP) or `createSMTPMailer` from `'sently/smtp'` |
 | CommonJS | ESM only |
 | Node.js only | Node, Bun, Deno, CF Workers |
 
@@ -716,6 +766,8 @@ import type {
   SendResult,
   Attachment,
   SMTPConfig,
+  SMTPMailerOptions,
+  TransportMailerOptions,
 } from "sently";
 ```
 

package/dist/adapters/bun.js.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["../src/adapters/bun.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Bun socket adapter for SMTP connections via the Node.js compatibility layer.\n *\n * @example\n * ```ts\n * import { BunAdapter } from \"sently/adapters/bun\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   host: \"smtp.example.com\",\n *   adapter: new BunAdapter(),\n *   auth: { user: \"you@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport net from \"node:net\";\nimport tls from \"node:tls\";\nimport type { SocketAdapter, TLSOptions } from \"../core/types.js\";\n\nfunction warnRejectUnauthorizedDisabled(tls: TLSOptions): void {\n  if (tls.rejectUnauthorized === false) {\n    console.warn(\n      \"[sently] TLS certificate verification is disabled. \" +\n        \"Never use rejectUnauthorized: false in production.\",\n    );\n  }\n}\n\ndeclare const Bun: { version: string } | undefined;\n\n/** Configuration options for {@link BunAdapter}. */\nexport interface BunAdapterOptions {\n  /** Use implicit TLS on connect (port 465). Default: false. */\n  secure?: boolean;\n  /** Socket connect timeout in milliseconds. Default: 30_000. */\n  connectionTimeout?: number;\n  /** TLS options passed to node:tls (Bun Node compat layer). */\n  tls?: TLSOptions;\n}\n\n/**\n * Bun socket adapter using node:net and node:tls (Node compat layer).\n */\nexport class BunAdapter implements SocketAdapter {\n  /** Underlying TCP or TLS socket (Node compat layer). */\n  private socket: net.Socket | tls.TLSSocket | null = null;\n  /** Whether the connection is currently encrypted. */\n  private _secure: boolean;\n  /** Whether the socket is connected. */\n  private _connected = false;\n  /** Socket connect timeout in milliseconds. */\n  private readonly connectionTimeout: number;\n  /** TLS options for direct TLS and STARTTLS upgrades. */\n  private readonly tlsOptions: TLSOptions;\n\n  /** Creates a Bun socket adapter (requires the Bun runtime). */\n  constructor(options: BunAdapterOptions = {}) {\n    if (typeof Bun === \"undefined\") {\n      throw new Error(\"BunAdapter requires the Bun runtime\");\n    }\n    this._secure = options.secure ?? false;\n    this.connectionTimeout = options.connectionTimeout ?? 30_000;\n    this.tlsOptions = options.tls ?? {};\n  }\n\n  /** Whether the connection uses TLS. */\n  get secure(): boolean {\n    return this._secure;\n  }\n\n  /** Whether the socket is currently connected. */\n  get connected(): boolean {\n    return this._connected;\n  }\n\n  /** Opens a TCP or TLS connection to the given host and port. */\n  async connect(host: string, port: number): Promise<void> {\n    if (this._secure) {\n      await this.connectTls(host, port);\n    } else {\n      await this.connectPlain(host, port);\n    }\n    this._connected = true;\n  }\n\n  /** Upgrades a plain connection to TLS via STARTTLS. */\n  async startTLS(options?: TLSOptions): Promise<void> {\n    if (!this.socket || this._secure) {\n      throw new Error(\"Cannot STARTTLS: no plain socket available\");\n    }\n\n    const plain = this.socket;\n    const merged = { ...this.tlsOptions, ...options };\n    warnRejectUnauthorizedDisabled(merged);\n\n    await new Promise<void>((resolve, reject) => {\n      const tlsSocket = tls.connect({\n        socket: plain,\n        servername: merged.servername,\n        rejectUnauthorized: merged.rejectUnauthorized ?? true,\n        minVersion: merged.minVersion,\n      });\n\n      tlsSocket.once(\"secureConnect\", () => {\n        this.socket = tlsSocket;\n        this._secure = true;\n        resolve();\n      });\n      tlsSocket.once(\"error\", reject);\n    });\n  }\n\n  /** Writes raw bytes to the socket. */\n  async write(data: Uint8Array): Promise<void> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    await new Promise<void>((resolve, reject) => {\n      this.socket?.write(Buffer.from(data), (err: Error | null | undefined) => {\n        if (err) {\n          reject(err);\n        } else {\n          resolve();\n        }\n      });\n    });\n  }\n\n  /** Reads incoming socket data as an async iterable of byte chunks. */\n  async *read(): AsyncGenerator<Uint8Array, void, unknown> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    const socket = this.socket;\n    const queue: Uint8Array[] = [];\n    let resolveNext: ((value: IteratorResult<Uint8Array>) => void) | null = null;\n    let done = false;\n    let error: Error | null = null;\n\n    const onData = (chunk: Buffer): void => {\n      const data = new Uint8Array(chunk);\n      if (resolveNext) {\n        resolveNext({ value: data, done: false });\n        resolveNext = null;\n      } else {\n        queue.push(data);\n      }\n    };\n\n    const onError = (err: Error): void => {\n      error = err;\n      done = true;\n      if (resolveNext) {\n        resolveNext({ value: undefined as unknown as Uint8Array, done: true });\n        resolveNext = null;\n      }\n    };\n\n    const onClose = (): void => {\n      done = true;\n      if (resolveNext) {\n        resolveNext({ value: undefined as unknown as Uint8Array, done: true });\n        resolveNext = null;\n      }\n    };\n\n    socket.on(\"data\", onData);\n    socket.on(\"error\", onError);\n    socket.on(\"close\", onClose);\n\n    try {\n      while (!done || queue.length > 0) {\n        if (error) {\n          throw error;\n        }\n        if (queue.length > 0) {\n          yield queue.shift() as Uint8Array;\n          continue;\n        }\n        if (done) {\n          break;\n        }\n        const chunk = await new Promise<IteratorResult<Uint8Array>>((resolve) => {\n          resolveNext = resolve;\n        });\n        if (chunk.done) {\n          break;\n        }\n        yield chunk.value;\n      }\n    } finally {\n      socket.off(\"data\", onData);\n      socket.off(\"error\", onError);\n      socket.off(\"close\", onClose);\n    }\n  }\n\n  /** Closes the socket connection. */\n  async close(): Promise<void> {\n    if (!this.socket) {\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      this.socket?.end(() => resolve());\n    });\n    this.socket = null;\n    this._connected = false;\n  }\n\n  /** Opens a plain TCP connection to the SMTP server. */\n  private connectPlain(host: string, port: number): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const socket = net.connect({ host, port }, () => resolve());\n      socket.setTimeout(this.connectionTimeout);\n      socket.once(\"timeout\", () => {\n        socket.destroy();\n        reject(new Error(\"Connection timeout\"));\n      });\n      socket.once(\"error\", reject);\n      this.socket = socket;\n    });\n  }\n\n  /** Opens a direct TLS connection to the SMTP server. */\n  private connectTls(host: string, port: number): Promise<void> {\n    warnRejectUnauthorizedDisabled(this.tlsOptions);\n    return new Promise((resolve, reject) => {\n      const socket = tls.connect(\n        {\n          host,\n          port,\n          servername: this.tlsOptions.servername ?? host,\n          rejectUnauthorized: this.tlsOptions.rejectUnauthorized ?? true,\n          minVersion: this.tlsOptions.minVersion,\n        },\n        () => resolve(),\n      );\n      socket.setTimeout(this.connectionTimeout);\n      socket.once(\"timeout\", () => {\n        socket.destroy();\n        reject(new Error(\"Connection timeout\"));\n      });\n      socket.once(\"error\", reject);\n      this.socket = socket;\n    });\n  }\n}\n"
+    "/**\n * @module\n * Bun socket adapter for SMTP connections via the Node.js compatibility layer.\n *\n * @example\n * ```ts\n * import { BunAdapter } from \"sently/adapters/bun\";\n * import { createSMTPMailer } from \"sently/smtp\";\n *\n * const mailer = await createSMTPMailer({\n *   host: \"smtp.example.com\",\n *   adapter: new BunAdapter(),\n *   auth: { user: \"you@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport net from \"node:net\";\nimport tls from \"node:tls\";\nimport type { SocketAdapter, TLSOptions } from \"../core/types.js\";\n\nfunction warnRejectUnauthorizedDisabled(tls: TLSOptions): void {\n  if (tls.rejectUnauthorized === false) {\n    console.warn(\n      \"[sently] TLS certificate verification is disabled. \" +\n        \"Never use rejectUnauthorized: false in production.\",\n    );\n  }\n}\n\ndeclare const Bun: { version: string } | undefined;\n\n/** Configuration options for {@link BunAdapter}. */\nexport interface BunAdapterOptions {\n  /** Use implicit TLS on connect (port 465). Default: false. */\n  secure?: boolean;\n  /** Socket connect timeout in milliseconds. Default: 30_000. */\n  connectionTimeout?: number;\n  /** TLS options passed to node:tls (Bun Node compat layer). */\n  tls?: TLSOptions;\n}\n\n/**\n * Bun socket adapter using node:net and node:tls (Node compat layer).\n */\nexport class BunAdapter implements SocketAdapter {\n  /** Underlying TCP or TLS socket (Node compat layer). */\n  private socket: net.Socket | tls.TLSSocket | null = null;\n  /** Whether the connection is currently encrypted. */\n  private _secure: boolean;\n  /** Whether the socket is connected. */\n  private _connected = false;\n  /** Socket connect timeout in milliseconds. */\n  private readonly connectionTimeout: number;\n  /** TLS options for direct TLS and STARTTLS upgrades. */\n  private readonly tlsOptions: TLSOptions;\n\n  /** Creates a Bun socket adapter (requires the Bun runtime). */\n  constructor(options: BunAdapterOptions = {}) {\n    if (typeof Bun === \"undefined\") {\n      throw new Error(\"BunAdapter requires the Bun runtime\");\n    }\n    this._secure = options.secure ?? false;\n    this.connectionTimeout = options.connectionTimeout ?? 30_000;\n    this.tlsOptions = options.tls ?? {};\n  }\n\n  /** Whether the connection uses TLS. */\n  get secure(): boolean {\n    return this._secure;\n  }\n\n  /** Whether the socket is currently connected. */\n  get connected(): boolean {\n    return this._connected;\n  }\n\n  /** Opens a TCP or TLS connection to the given host and port. */\n  async connect(host: string, port: number): Promise<void> {\n    if (this._secure) {\n      await this.connectTls(host, port);\n    } else {\n      await this.connectPlain(host, port);\n    }\n    this._connected = true;\n  }\n\n  /** Upgrades a plain connection to TLS via STARTTLS. */\n  async startTLS(options?: TLSOptions): Promise<void> {\n    if (!this.socket || this._secure) {\n      throw new Error(\"Cannot STARTTLS: no plain socket available\");\n    }\n\n    const plain = this.socket;\n    const merged = { ...this.tlsOptions, ...options };\n    warnRejectUnauthorizedDisabled(merged);\n\n    await new Promise<void>((resolve, reject) => {\n      const tlsSocket = tls.connect({\n        socket: plain,\n        servername: merged.servername,\n        rejectUnauthorized: merged.rejectUnauthorized ?? true,\n        minVersion: merged.minVersion,\n      });\n\n      tlsSocket.once(\"secureConnect\", () => {\n        this.socket = tlsSocket;\n        this._secure = true;\n        resolve();\n      });\n      tlsSocket.once(\"error\", reject);\n    });\n  }\n\n  /** Writes raw bytes to the socket. */\n  async write(data: Uint8Array): Promise<void> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    await new Promise<void>((resolve, reject) => {\n      this.socket?.write(Buffer.from(data), (err: Error | null | undefined) => {\n        if (err) {\n          reject(err);\n        } else {\n          resolve();\n        }\n      });\n    });\n  }\n\n  /** Reads incoming socket data as an async iterable of byte chunks. */\n  async *read(): AsyncGenerator<Uint8Array, void, unknown> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    const socket = this.socket;\n    const queue: Uint8Array[] = [];\n    let resolveNext: ((value: IteratorResult<Uint8Array>) => void) | null = null;\n    let done = false;\n    let error: Error | null = null;\n\n    const onData = (chunk: Buffer): void => {\n      const data = new Uint8Array(chunk);\n      if (resolveNext) {\n        resolveNext({ value: data, done: false });\n        resolveNext = null;\n      } else {\n        queue.push(data);\n      }\n    };\n\n    const onError = (err: Error): void => {\n      error = err;\n      done = true;\n      if (resolveNext) {\n        resolveNext({ value: undefined as unknown as Uint8Array, done: true });\n        resolveNext = null;\n      }\n    };\n\n    const onClose = (): void => {\n      done = true;\n      if (resolveNext) {\n        resolveNext({ value: undefined as unknown as Uint8Array, done: true });\n        resolveNext = null;\n      }\n    };\n\n    socket.on(\"data\", onData);\n    socket.on(\"error\", onError);\n    socket.on(\"close\", onClose);\n\n    try {\n      while (!done || queue.length > 0) {\n        if (error) {\n          throw error;\n        }\n        if (queue.length > 0) {\n          yield queue.shift() as Uint8Array;\n          continue;\n        }\n        if (done) {\n          break;\n        }\n        const chunk = await new Promise<IteratorResult<Uint8Array>>((resolve) => {\n          resolveNext = resolve;\n        });\n        if (chunk.done) {\n          break;\n        }\n        yield chunk.value;\n      }\n    } finally {\n      socket.off(\"data\", onData);\n      socket.off(\"error\", onError);\n      socket.off(\"close\", onClose);\n    }\n  }\n\n  /** Closes the socket connection. */\n  async close(): Promise<void> {\n    if (!this.socket) {\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      this.socket?.end(() => resolve());\n    });\n    this.socket = null;\n    this._connected = false;\n  }\n\n  /** Opens a plain TCP connection to the SMTP server. */\n  private connectPlain(host: string, port: number): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const socket = net.connect({ host, port }, () => resolve());\n      socket.setTimeout(this.connectionTimeout);\n      socket.once(\"timeout\", () => {\n        socket.destroy();\n        reject(new Error(\"Connection timeout\"));\n      });\n      socket.once(\"error\", reject);\n      this.socket = socket;\n    });\n  }\n\n  /** Opens a direct TLS connection to the SMTP server. */\n  private connectTls(host: string, port: number): Promise<void> {\n    warnRejectUnauthorizedDisabled(this.tlsOptions);\n    return new Promise((resolve, reject) => {\n      const socket = tls.connect(\n        {\n          host,\n          port,\n          servername: this.tlsOptions.servername ?? host,\n          rejectUnauthorized: this.tlsOptions.rejectUnauthorized ?? true,\n          minVersion: this.tlsOptions.minVersion,\n        },\n        () => resolve(),\n      );\n      socket.setTimeout(this.connectionTimeout);\n      socket.once(\"timeout\", () => {\n        socket.destroy();\n        reject(new Error(\"Connection timeout\"));\n      });\n      socket.once(\"error\", reject);\n      this.socket = socket;\n    });\n  }\n}\n"
   ],
   "mappings": "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",
   "debugId": "94AAFD676203266764756E2164756E21",

package/dist/adapters/cf.d.ts

@@ -5,9 +5,9 @@
  * @example
  * ```ts
  * import { CloudflareAdapter } from "sently/adapters/cf";
- * import { createMailer } from "sently";
+ * import { createSMTPMailer } from "sently/smtp";
  *
- * const mailer = await createMailer({
+ * const mailer = await createSMTPMailer({
  *   host: "smtp.example.com",
  *   adapter: new CloudflareAdapter(),
  *   auth: { user: "relay@example.com", pass: "secret" },

package/dist/adapters/cf.js.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["../src/adapters/cf.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Cloudflare Workers socket adapter for SMTP via cloudflare:sockets.\n *\n * @example\n * ```ts\n * import { CloudflareAdapter } from \"sently/adapters/cf\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   host: \"smtp.example.com\",\n *   adapter: new CloudflareAdapter(),\n *   auth: { user: \"relay@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport type { SocketAdapter, TLSOptions } from \"../core/types.js\";\n\ninterface CFSocket {\n  readonly readable: ReadableStream<Uint8Array>;\n  readonly writable: WritableStream<Uint8Array>;\n  readonly closed: Promise<void>;\n  close(): Promise<void>;\n  startTls(): CFSocket;\n}\n\ntype CFConnect = (\n  address: { hostname: string; port: number },\n  options?: { secureTransport?: \"off\" | \"on\" | \"starttls\"; allowHalfOpen?: boolean },\n) => CFSocket;\n\n/** Configuration options for {@link CloudflareAdapter}. */\nexport interface CloudflareAdapterOptions {\n  /** Use implicit TLS on connect (secureTransport: \"on\"). Default: false. */\n  secure?: boolean;\n  /** Enable STARTTLS upgrade after plain connect. Default: true when not secure. */\n  starttls?: boolean;\n  /** Reserved for future TLS tuning (Workers sockets API). */\n  tls?: TLSOptions;\n}\n\n/**\n * Cloudflare Workers socket adapter via cloudflare:sockets.\n *\n * Limitations:\n * - No connection pooling (isolate lifecycle)\n * - No file system access for attachment.path\n * - No DNS MX lookup — explicit SMTP relay host required\n */\nexport class CloudflareAdapter implements SocketAdapter {\n  /** Underlying Cloudflare Workers socket. */\n  private socket: CFSocket | null = null;\n  /** Writable stream writer for outbound bytes. */\n  private writer: WritableStreamDefaultWriter<Uint8Array> | null = null;\n  /** Whether the connection is currently encrypted. */\n  private _secure: boolean;\n  /** Whether the socket is connected. */\n  private _connected = false;\n  /** Whether implicit TLS is used on connect (port 465 style). */\n  private readonly directTls: boolean;\n  /** Whether STARTTLS upgrade is enabled after plain connect. */\n  private readonly starttls: boolean;\n\n  /** Creates a Cloudflare Workers socket adapter. */\n  constructor(options: CloudflareAdapterOptions = {}) {\n    this._secure = options.secure ?? false;\n    this.directTls = options.secure ?? false;\n    this.starttls = options.starttls ?? !this.directTls;\n  }\n\n  /** Whether the connection uses TLS. */\n  get secure(): boolean {\n    return this._secure;\n  }\n\n  /** Whether the socket is currently connected. */\n  get connected(): boolean {\n    return this._connected;\n  }\n\n  /** Opens a TCP or TLS connection to the given host and port. */\n  async connect(host: string, port: number): Promise<void> {\n    const { connect } = (await import(\"cloudflare:sockets\")) as { connect: CFConnect };\n\n    const secureTransport = this.directTls ? \"on\" : this.starttls ? \"starttls\" : \"off\";\n    this.socket = connect({ hostname: host, port }, { secureTransport });\n    this.writer = this.socket.writable.getWriter();\n    this._connected = true;\n    this._secure = secureTransport === \"on\";\n  }\n\n  /** Upgrades a plain connection to TLS via STARTTLS. */\n  async startTLS(_options?: TLSOptions): Promise<void> {\n    if (!this.socket || this._secure) {\n      throw new Error(\"Cannot STARTTLS: no plain socket available\");\n    }\n\n    await this.writer?.close();\n    this.socket = this.socket.startTls();\n    this.writer = this.socket.writable.getWriter();\n    this._secure = true;\n  }\n\n  /** Writes raw bytes to the socket. */\n  async write(data: Uint8Array): Promise<void> {\n    if (!this.writer) {\n      throw new Error(\"Socket not connected\");\n    }\n    await this.writer.write(data);\n  }\n\n  /** Reads incoming socket data as an async iterable of byte chunks. */\n  async *read(): AsyncGenerator<Uint8Array, void, unknown> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    const reader = this.socket.readable.getReader();\n    try {\n      while (true) {\n        const { value, done } = await reader.read();\n        if (done) {\n          break;\n        }\n        if (value) {\n          yield value;\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n\n  /** Closes the socket connection. */\n  async close(): Promise<void> {\n    await this.writer?.close();\n    await this.socket?.close();\n    this.writer = null;\n    this.socket = null;\n    this._connected = false;\n  }\n}\n"
+    "/**\n * @module\n * Cloudflare Workers socket adapter for SMTP via cloudflare:sockets.\n *\n * @example\n * ```ts\n * import { CloudflareAdapter } from \"sently/adapters/cf\";\n * import { createSMTPMailer } from \"sently/smtp\";\n *\n * const mailer = await createSMTPMailer({\n *   host: \"smtp.example.com\",\n *   adapter: new CloudflareAdapter(),\n *   auth: { user: \"relay@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport type { SocketAdapter, TLSOptions } from \"../core/types.js\";\n\ninterface CFSocket {\n  readonly readable: ReadableStream<Uint8Array>;\n  readonly writable: WritableStream<Uint8Array>;\n  readonly closed: Promise<void>;\n  close(): Promise<void>;\n  startTls(): CFSocket;\n}\n\ntype CFConnect = (\n  address: { hostname: string; port: number },\n  options?: { secureTransport?: \"off\" | \"on\" | \"starttls\"; allowHalfOpen?: boolean },\n) => CFSocket;\n\n/** Configuration options for {@link CloudflareAdapter}. */\nexport interface CloudflareAdapterOptions {\n  /** Use implicit TLS on connect (secureTransport: \"on\"). Default: false. */\n  secure?: boolean;\n  /** Enable STARTTLS upgrade after plain connect. Default: true when not secure. */\n  starttls?: boolean;\n  /** Reserved for future TLS tuning (Workers sockets API). */\n  tls?: TLSOptions;\n}\n\n/**\n * Cloudflare Workers socket adapter via cloudflare:sockets.\n *\n * Limitations:\n * - No connection pooling (isolate lifecycle)\n * - No file system access for attachment.path\n * - No DNS MX lookup — explicit SMTP relay host required\n */\nexport class CloudflareAdapter implements SocketAdapter {\n  /** Underlying Cloudflare Workers socket. */\n  private socket: CFSocket | null = null;\n  /** Writable stream writer for outbound bytes. */\n  private writer: WritableStreamDefaultWriter<Uint8Array> | null = null;\n  /** Whether the connection is currently encrypted. */\n  private _secure: boolean;\n  /** Whether the socket is connected. */\n  private _connected = false;\n  /** Whether implicit TLS is used on connect (port 465 style). */\n  private readonly directTls: boolean;\n  /** Whether STARTTLS upgrade is enabled after plain connect. */\n  private readonly starttls: boolean;\n\n  /** Creates a Cloudflare Workers socket adapter. */\n  constructor(options: CloudflareAdapterOptions = {}) {\n    this._secure = options.secure ?? false;\n    this.directTls = options.secure ?? false;\n    this.starttls = options.starttls ?? !this.directTls;\n  }\n\n  /** Whether the connection uses TLS. */\n  get secure(): boolean {\n    return this._secure;\n  }\n\n  /** Whether the socket is currently connected. */\n  get connected(): boolean {\n    return this._connected;\n  }\n\n  /** Opens a TCP or TLS connection to the given host and port. */\n  async connect(host: string, port: number): Promise<void> {\n    const { connect } = (await import(\"cloudflare:sockets\")) as { connect: CFConnect };\n\n    const secureTransport = this.directTls ? \"on\" : this.starttls ? \"starttls\" : \"off\";\n    this.socket = connect({ hostname: host, port }, { secureTransport });\n    this.writer = this.socket.writable.getWriter();\n    this._connected = true;\n    this._secure = secureTransport === \"on\";\n  }\n\n  /** Upgrades a plain connection to TLS via STARTTLS. */\n  async startTLS(_options?: TLSOptions): Promise<void> {\n    if (!this.socket || this._secure) {\n      throw new Error(\"Cannot STARTTLS: no plain socket available\");\n    }\n\n    await this.writer?.close();\n    this.socket = this.socket.startTls();\n    this.writer = this.socket.writable.getWriter();\n    this._secure = true;\n  }\n\n  /** Writes raw bytes to the socket. */\n  async write(data: Uint8Array): Promise<void> {\n    if (!this.writer) {\n      throw new Error(\"Socket not connected\");\n    }\n    await this.writer.write(data);\n  }\n\n  /** Reads incoming socket data as an async iterable of byte chunks. */\n  async *read(): AsyncGenerator<Uint8Array, void, unknown> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    const reader = this.socket.readable.getReader();\n    try {\n      while (true) {\n        const { value, done } = await reader.read();\n        if (done) {\n          break;\n        }\n        if (value) {\n          yield value;\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n\n  /** Closes the socket connection. */\n  async close(): Promise<void> {\n    await this.writer?.close();\n    await this.socket?.close();\n    this.writer = null;\n    this.socket = null;\n    this._connected = false;\n  }\n}\n"
   ],
   "mappings": "yCAiDO,MAAM,CAA2C,CAE9C,OAA0B,KAE1B,OAAyD,KAEzD,QAEA,WAAa,GAEJ,UAEA,SAGjB,WAAW,CAAC,EAAoC,CAAC,EAAG,CAClD,KAAK,QAAU,EAAQ,QAAU,GACjC,KAAK,UAAY,EAAQ,QAAU,GACnC,KAAK,SAAW,EAAQ,UAAY,CAAC,KAAK,aAIxC,OAAM,EAAY,CACpB,OAAO,KAAK,WAIV,UAAS,EAAY,CACvB,OAAO,KAAK,gBAIR,QAAO,CAAC,EAAc,EAA6B,CACvD,IAAQ,WAAa,KAAa,8BAE5B,EAAkB,KAAK,UAAY,KAAO,KAAK,SAAW,WAAa,MAC7E,KAAK,OAAS,EAAQ,CAAE,SAAU,EAAM,MAAK,EAAG,CAAE,iBAAgB,CAAC,EACnE,KAAK,OAAS,KAAK,OAAO,SAAS,UAAU,EAC7C,KAAK,WAAa,GAClB,KAAK,QAAU,IAAoB,UAI/B,SAAQ,CAAC,EAAsC,CACnD,GAAI,CAAC,KAAK,QAAU,KAAK,QACvB,MAAU,MAAM,4CAA4C,EAG9D,MAAM,KAAK,QAAQ,MAAM,EACzB,KAAK,OAAS,KAAK,OAAO,SAAS,EACnC,KAAK,OAAS,KAAK,OAAO,SAAS,UAAU,EAC7C,KAAK,QAAU,QAIX,MAAK,CAAC,EAAiC,CAC3C,GAAI,CAAC,KAAK,OACR,MAAU,MAAM,sBAAsB,EAExC,MAAM,KAAK,OAAO,MAAM,CAAI,QAIvB,IAAI,EAA8C,CACvD,GAAI,CAAC,KAAK,OACR,MAAU,MAAM,sBAAsB,EAGxC,IAAM,EAAS,KAAK,OAAO,SAAS,UAAU,EAC9C,GAAI,CACF,MAAO,GAAM,CACX,IAAQ,QAAO,QAAS,MAAM,EAAO,KAAK,EAC1C,GAAI,EACF,MAEF,GAAI,EACF,MAAM,UAGV,CACA,EAAO,YAAY,QAKjB,MAAK,EAAkB,CAC3B,MAAM,KAAK,QAAQ,MAAM,EACzB,MAAM,KAAK,QAAQ,MAAM,EACzB,KAAK,OAAS,KACd,KAAK,OAAS,KACd,KAAK,WAAa,GAEtB",
   "debugId": "7B1527506618792564756E2164756E21",

package/dist/adapters/deno.d.ts

@@ -5,9 +5,9 @@
  * @example
  * ```ts
  * import { DenoAdapter } from "sently/adapters/deno";
- * import { createMailer } from "sently";
+ * import { createSMTPMailer } from "sently/smtp";
  *
- * const mailer = await createMailer({
+ * const mailer = await createSMTPMailer({
  *   host: "smtp.example.com",
  *   adapter: new DenoAdapter(),
  *   auth: { user: "you@example.com", pass: "secret" },

package/dist/adapters/deno.js.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["../src/adapters/deno.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Deno socket adapter for SMTP connections via Deno.connect and Deno.startTls.\n *\n * @example\n * ```ts\n * import { DenoAdapter } from \"sently/adapters/deno\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   host: \"smtp.example.com\",\n *   adapter: new DenoAdapter(),\n *   auth: { user: \"you@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport type { SocketAdapter, TLSOptions } from \"../core/types.js\";\n\ndeclare const Deno: {\n  connect(options: { hostname: string; port: number }): Promise<DenoTcpConn>;\n  connectTls(options: {\n    hostname: string;\n    port: number;\n    [key: string]: unknown;\n  }): Promise<DenoTlsConn>;\n  startTls(conn: DenoTcpConn, options?: { hostname?: string }): Promise<DenoTlsConn>;\n};\n\ninterface DenoConn {\n  read(p: Uint8Array): Promise<number | null>;\n  write(p: Uint8Array): Promise<number>;\n  close(): void;\n}\n\ninterface DenoTcpConn extends DenoConn {}\ninterface DenoTlsConn extends DenoConn {}\n\n/** Configuration options for {@link DenoAdapter}. */\nexport interface DenoAdapterOptions {\n  /** Use implicit TLS on connect (port 465). Default: false. */\n  secure?: boolean;\n  /** Socket connect timeout in milliseconds. Default: 30_000. */\n  connectionTimeout?: number;\n  /** TLS options passed to Deno.startTls / Deno.connectTls. */\n  tls?: TLSOptions;\n}\n\n/**\n * Deno socket adapter using Deno.connect / Deno.startTls.\n */\nexport class DenoAdapter implements SocketAdapter {\n  /** Active Deno TCP or TLS connection. */\n  private conn: DenoConn | null = null;\n  /** Whether the connection is currently encrypted. */\n  private _secure: boolean;\n  /** Whether the socket is connected. */\n  private _connected = false;\n  /** TLS options for direct TLS and STARTTLS upgrades. */\n  private readonly tlsOptions: TLSOptions;\n\n  /** Creates a Deno socket adapter (requires the Deno runtime). */\n  constructor(options: DenoAdapterOptions = {}) {\n    if (typeof Deno === \"undefined\") {\n      throw new Error(\"DenoAdapter requires the Deno runtime\");\n    }\n    this._secure = options.secure ?? false;\n    this.tlsOptions = options.tls ?? {};\n  }\n\n  /** Whether the connection uses TLS. */\n  get secure(): boolean {\n    return this._secure;\n  }\n\n  /** Whether the socket is currently connected. */\n  get connected(): boolean {\n    return this._connected;\n  }\n\n  /** Opens a TCP or TLS connection to the given host and port. */\n  async connect(host: string, port: number): Promise<void> {\n    if (this._secure) {\n      this.conn = await Deno.connectTls({\n        hostname: host,\n        port,\n        ...(this.tlsOptions.servername ? { servername: this.tlsOptions.servername } : {}),\n      });\n    } else {\n      this.conn = await Deno.connect({ hostname: host, port });\n    }\n    this._connected = true;\n  }\n\n  /** Upgrades a plain connection to TLS via STARTTLS. */\n  async startTLS(options?: TLSOptions): Promise<void> {\n    if (!this.conn || this._secure) {\n      throw new Error(\"Cannot STARTTLS: no plain connection available\");\n    }\n\n    const merged = { ...this.tlsOptions, ...options };\n    this.conn = await Deno.startTls(this.conn as DenoTcpConn, {\n      ...(merged.servername ? { hostname: merged.servername } : {}),\n    });\n    this._secure = true;\n  }\n\n  /** Writes raw bytes to the socket. */\n  async write(data: Uint8Array): Promise<void> {\n    if (!this.conn) {\n      throw new Error(\"Socket not connected\");\n    }\n    await this.conn.write(data);\n  }\n\n  /** Reads incoming socket data as an async iterable of byte chunks. */\n  async *read(): AsyncGenerator<Uint8Array, void, unknown> {\n    if (!this.conn) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    const buffer = new Uint8Array(8192);\n    while (true) {\n      const n = await this.conn.read(buffer);\n      if (n === null) {\n        break;\n      }\n      yield buffer.slice(0, n);\n    }\n  }\n\n  /** Closes the socket connection. */\n  async close(): Promise<void> {\n    this.conn?.close();\n    this.conn = null;\n    this._connected = false;\n  }\n}\n"
+    "/**\n * @module\n * Deno socket adapter for SMTP connections via Deno.connect and Deno.startTls.\n *\n * @example\n * ```ts\n * import { DenoAdapter } from \"sently/adapters/deno\";\n * import { createSMTPMailer } from \"sently/smtp\";\n *\n * const mailer = await createSMTPMailer({\n *   host: \"smtp.example.com\",\n *   adapter: new DenoAdapter(),\n *   auth: { user: \"you@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport type { SocketAdapter, TLSOptions } from \"../core/types.js\";\n\ndeclare const Deno: {\n  connect(options: { hostname: string; port: number }): Promise<DenoTcpConn>;\n  connectTls(options: {\n    hostname: string;\n    port: number;\n    [key: string]: unknown;\n  }): Promise<DenoTlsConn>;\n  startTls(conn: DenoTcpConn, options?: { hostname?: string }): Promise<DenoTlsConn>;\n};\n\ninterface DenoConn {\n  read(p: Uint8Array): Promise<number | null>;\n  write(p: Uint8Array): Promise<number>;\n  close(): void;\n}\n\ninterface DenoTcpConn extends DenoConn {}\ninterface DenoTlsConn extends DenoConn {}\n\n/** Configuration options for {@link DenoAdapter}. */\nexport interface DenoAdapterOptions {\n  /** Use implicit TLS on connect (port 465). Default: false. */\n  secure?: boolean;\n  /** Socket connect timeout in milliseconds. Default: 30_000. */\n  connectionTimeout?: number;\n  /** TLS options passed to Deno.startTls / Deno.connectTls. */\n  tls?: TLSOptions;\n}\n\n/**\n * Deno socket adapter using Deno.connect / Deno.startTls.\n */\nexport class DenoAdapter implements SocketAdapter {\n  /** Active Deno TCP or TLS connection. */\n  private conn: DenoConn | null = null;\n  /** Whether the connection is currently encrypted. */\n  private _secure: boolean;\n  /** Whether the socket is connected. */\n  private _connected = false;\n  /** TLS options for direct TLS and STARTTLS upgrades. */\n  private readonly tlsOptions: TLSOptions;\n\n  /** Creates a Deno socket adapter (requires the Deno runtime). */\n  constructor(options: DenoAdapterOptions = {}) {\n    if (typeof Deno === \"undefined\") {\n      throw new Error(\"DenoAdapter requires the Deno runtime\");\n    }\n    this._secure = options.secure ?? false;\n    this.tlsOptions = options.tls ?? {};\n  }\n\n  /** Whether the connection uses TLS. */\n  get secure(): boolean {\n    return this._secure;\n  }\n\n  /** Whether the socket is currently connected. */\n  get connected(): boolean {\n    return this._connected;\n  }\n\n  /** Opens a TCP or TLS connection to the given host and port. */\n  async connect(host: string, port: number): Promise<void> {\n    if (this._secure) {\n      this.conn = await Deno.connectTls({\n        hostname: host,\n        port,\n        ...(this.tlsOptions.servername ? { servername: this.tlsOptions.servername } : {}),\n      });\n    } else {\n      this.conn = await Deno.connect({ hostname: host, port });\n    }\n    this._connected = true;\n  }\n\n  /** Upgrades a plain connection to TLS via STARTTLS. */\n  async startTLS(options?: TLSOptions): Promise<void> {\n    if (!this.conn || this._secure) {\n      throw new Error(\"Cannot STARTTLS: no plain connection available\");\n    }\n\n    const merged = { ...this.tlsOptions, ...options };\n    this.conn = await Deno.startTls(this.conn as DenoTcpConn, {\n      ...(merged.servername ? { hostname: merged.servername } : {}),\n    });\n    this._secure = true;\n  }\n\n  /** Writes raw bytes to the socket. */\n  async write(data: Uint8Array): Promise<void> {\n    if (!this.conn) {\n      throw new Error(\"Socket not connected\");\n    }\n    await this.conn.write(data);\n  }\n\n  /** Reads incoming socket data as an async iterable of byte chunks. */\n  async *read(): AsyncGenerator<Uint8Array, void, unknown> {\n    if (!this.conn) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    const buffer = new Uint8Array(8192);\n    while (true) {\n      const n = await this.conn.read(buffer);\n      if (n === null) {\n        break;\n      }\n      yield buffer.slice(0, n);\n    }\n  }\n\n  /** Closes the socket connection. */\n  async close(): Promise<void> {\n    this.conn?.close();\n    this.conn = null;\n    this._connected = false;\n  }\n}\n"
   ],
   "mappings": "6BAkDO,MAAM,CAAqC,CAExC,KAAwB,KAExB,QAEA,WAAa,GAEJ,WAGjB,WAAW,CAAC,EAA8B,CAAC,EAAG,CAC5C,GAAI,OAAO,KAAS,IAClB,MAAU,MAAM,uCAAuC,EAEzD,KAAK,QAAU,EAAQ,QAAU,GACjC,KAAK,WAAa,EAAQ,KAAO,CAAC,KAIhC,OAAM,EAAY,CACpB,OAAO,KAAK,WAIV,UAAS,EAAY,CACvB,OAAO,KAAK,gBAIR,QAAO,CAAC,EAAc,EAA6B,CACvD,GAAI,KAAK,QACP,KAAK,KAAO,MAAM,KAAK,WAAW,CAChC,SAAU,EACV,UACI,KAAK,WAAW,WAAa,CAAE,WAAY,KAAK,WAAW,UAAW,EAAI,CAAC,CACjF,CAAC,EAED,UAAK,KAAO,MAAM,KAAK,QAAQ,CAAE,SAAU,EAAM,MAAK,CAAC,EAEzD,KAAK,WAAa,QAId,SAAQ,CAAC,EAAqC,CAClD,GAAI,CAAC,KAAK,MAAQ,KAAK,QACrB,MAAU,MAAM,gDAAgD,EAGlE,IAAM,EAAS,IAAK,KAAK,cAAe,CAAQ,EAChD,KAAK,KAAO,MAAM,KAAK,SAAS,KAAK,KAAqB,IACpD,EAAO,WAAa,CAAE,SAAU,EAAO,UAAW,EAAI,CAAC,CAC7D,CAAC,EACD,KAAK,QAAU,QAIX,MAAK,CAAC,EAAiC,CAC3C,GAAI,CAAC,KAAK,KACR,MAAU,MAAM,sBAAsB,EAExC,MAAM,KAAK,KAAK,MAAM,CAAI,QAIrB,IAAI,EAA8C,CACvD,GAAI,CAAC,KAAK,KACR,MAAU,MAAM,sBAAsB,EAGxC,IAAM,EAAS,IAAI,WAAW,IAAI,EAClC,MAAO,GAAM,CACX,IAAM,EAAI,MAAM,KAAK,KAAK,KAAK,CAAM,EACrC,GAAI,IAAM,KACR,MAEF,MAAM,EAAO,MAAM,EAAG,CAAC,QAKrB,MAAK,EAAkB,CAC3B,KAAK,MAAM,MAAM,EACjB,KAAK,KAAO,KACZ,KAAK,WAAa,GAEtB",
   "debugId": "433F0358DDA6910C64756E2164756E21",

package/dist/adapters/node.js.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["../src/adapters/node.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Node.js socket adapter for SMTP connections via node:net and node:tls.\n *\n * @example\n * ```ts\n * import { NodeAdapter } from \"sently/adapters/node\";\n * import { createMailer } from \"sently\";\n *\n * const mailer = await createMailer({\n *   host: \"smtp.example.com\",\n *   adapter: new NodeAdapter(),\n *   auth: { user: \"you@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport net from \"node:net\";\nimport tls from \"node:tls\";\nimport type { SocketAdapter, TLSOptions } from \"../core/types.js\";\n\nfunction warnRejectUnauthorizedDisabled(tls: TLSOptions): void {\n  if (tls.rejectUnauthorized === false) {\n    console.warn(\n      \"[sently] TLS certificate verification is disabled. \" +\n        \"Never use rejectUnauthorized: false in production.\",\n    );\n  }\n}\n\n/** Configuration options for {@link NodeAdapter}. */\nexport interface NodeAdapterOptions {\n  /** Use implicit TLS on connect (port 465). Default: false. */\n  secure?: boolean;\n  /** Socket connect timeout in milliseconds. Default: 30_000. */\n  connectionTimeout?: number;\n  /** TLS options passed to node:tls. */\n  tls?: TLSOptions;\n}\n\n/**\n * Node.js socket adapter using node:net and node:tls.\n */\nexport class NodeAdapter implements SocketAdapter {\n  /** Underlying Node.js TCP or TLS socket. */\n  private socket: net.Socket | tls.TLSSocket | null = null;\n  /** Whether the connection is currently encrypted. */\n  private _secure: boolean;\n  /** Whether the socket is connected. */\n  private _connected = false;\n  /** Socket connect timeout in milliseconds. */\n  private readonly connectionTimeout: number;\n  /** TLS options for direct TLS and STARTTLS upgrades. */\n  private readonly tlsOptions: TLSOptions;\n\n  /** Creates a Node.js socket adapter. */\n  constructor(options: NodeAdapterOptions = {}) {\n    this._secure = options.secure ?? false;\n    this.connectionTimeout = options.connectionTimeout ?? 30_000;\n    this.tlsOptions = options.tls ?? {};\n  }\n\n  /** Whether the connection uses TLS. */\n  get secure(): boolean {\n    return this._secure;\n  }\n\n  /** Whether the socket is currently connected. */\n  get connected(): boolean {\n    return this._connected;\n  }\n\n  /** Opens a TCP or TLS connection to the given host and port. */\n  async connect(host: string, port: number): Promise<void> {\n    if (this._secure) {\n      await this.connectTls(host, port);\n    } else {\n      await this.connectPlain(host, port);\n    }\n    this._connected = true;\n  }\n\n  /** Upgrades a plain connection to TLS via STARTTLS. */\n  async startTLS(options?: TLSOptions): Promise<void> {\n    if (!this.socket || this._secure) {\n      throw new Error(\"Cannot STARTTLS: no plain socket available\");\n    }\n\n    const plain = this.socket;\n    const merged = { ...this.tlsOptions, ...options };\n    warnRejectUnauthorizedDisabled(merged);\n\n    await new Promise<void>((resolve, reject) => {\n      const tlsSocket = tls.connect({\n        socket: plain,\n        servername: merged.servername,\n        rejectUnauthorized: merged.rejectUnauthorized ?? true,\n        minVersion: merged.minVersion,\n      });\n\n      tlsSocket.once(\"secureConnect\", () => {\n        this.socket = tlsSocket;\n        this._secure = true;\n        resolve();\n      });\n      tlsSocket.once(\"error\", reject);\n    });\n  }\n\n  /** Writes raw bytes to the socket. */\n  async write(data: Uint8Array): Promise<void> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    await new Promise<void>((resolve, reject) => {\n      this.socket?.write(Buffer.from(data), (err: Error | null | undefined) => {\n        if (err) {\n          reject(err);\n        } else {\n          resolve();\n        }\n      });\n    });\n  }\n\n  /** Reads incoming socket data as an async iterable of byte chunks. */\n  async *read(): AsyncGenerator<Uint8Array, void, unknown> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    const socket = this.socket;\n    const queue: Uint8Array[] = [];\n    let resolveNext: ((value: IteratorResult<Uint8Array>) => void) | null = null;\n    let done = false;\n    let error: Error | null = null;\n\n    const onData = (chunk: Buffer): void => {\n      const data = new Uint8Array(chunk);\n      if (resolveNext) {\n        resolveNext({ value: data, done: false });\n        resolveNext = null;\n      } else {\n        queue.push(data);\n      }\n    };\n\n    const onError = (err: Error): void => {\n      error = err;\n      if (resolveNext) {\n        resolveNext({ value: undefined as unknown as Uint8Array, done: true });\n        resolveNext = null;\n      }\n      done = true;\n    };\n\n    const onClose = (): void => {\n      done = true;\n      if (resolveNext) {\n        resolveNext({ value: undefined as unknown as Uint8Array, done: true });\n        resolveNext = null;\n      }\n    };\n\n    socket.on(\"data\", onData);\n    socket.on(\"error\", onError);\n    socket.on(\"close\", onClose);\n\n    try {\n      while (!done || queue.length > 0) {\n        if (error) {\n          throw error;\n        }\n        if (queue.length > 0) {\n          yield queue.shift() as Uint8Array;\n          continue;\n        }\n        if (done) {\n          break;\n        }\n        const chunk = await new Promise<IteratorResult<Uint8Array>>((resolve) => {\n          resolveNext = resolve;\n        });\n        if (chunk.done) {\n          break;\n        }\n        yield chunk.value;\n      }\n    } finally {\n      socket.off(\"data\", onData);\n      socket.off(\"error\", onError);\n      socket.off(\"close\", onClose);\n    }\n  }\n\n  /** Closes the socket connection. */\n  async close(): Promise<void> {\n    if (!this.socket) {\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      this.socket?.end(() => resolve());\n    });\n    this.socket = null;\n    this._connected = false;\n  }\n\n  /** Opens a plain TCP connection to the SMTP server. */\n  private connectPlain(host: string, port: number): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const socket = net.connect({ host, port }, () => resolve());\n      socket.setTimeout(this.connectionTimeout);\n      socket.once(\"timeout\", () => {\n        socket.destroy();\n        reject(new Error(\"Connection timeout\"));\n      });\n      socket.once(\"error\", reject);\n      this.socket = socket;\n    });\n  }\n\n  /** Opens a direct TLS connection to the SMTP server. */\n  private connectTls(host: string, port: number): Promise<void> {\n    warnRejectUnauthorizedDisabled(this.tlsOptions);\n    return new Promise((resolve, reject) => {\n      const socket = tls.connect(\n        {\n          host,\n          port,\n          servername: this.tlsOptions.servername ?? host,\n          rejectUnauthorized: this.tlsOptions.rejectUnauthorized ?? true,\n          minVersion: this.tlsOptions.minVersion,\n        },\n        () => resolve(),\n      );\n      socket.setTimeout(this.connectionTimeout);\n      socket.once(\"timeout\", () => {\n        socket.destroy();\n        reject(new Error(\"Connection timeout\"));\n      });\n      socket.once(\"error\", reject);\n      this.socket = socket;\n    });\n  }\n}\n"
+    "/**\n * @module\n * Node.js socket adapter for SMTP connections via node:net and node:tls.\n *\n * @example\n * ```ts\n * import { NodeAdapter } from \"sently/adapters/node\";\n * import { createSMTPMailer } from \"sently/smtp\";\n *\n * const mailer = await createSMTPMailer({\n *   host: \"smtp.example.com\",\n *   adapter: new NodeAdapter(),\n *   auth: { user: \"you@example.com\", pass: \"secret\" },\n * });\n * ```\n */\nimport net from \"node:net\";\nimport tls from \"node:tls\";\nimport type { SocketAdapter, TLSOptions } from \"../core/types.js\";\n\nfunction warnRejectUnauthorizedDisabled(tls: TLSOptions): void {\n  if (tls.rejectUnauthorized === false) {\n    console.warn(\n      \"[sently] TLS certificate verification is disabled. \" +\n        \"Never use rejectUnauthorized: false in production.\",\n    );\n  }\n}\n\n/** Configuration options for {@link NodeAdapter}. */\nexport interface NodeAdapterOptions {\n  /** Use implicit TLS on connect (port 465). Default: false. */\n  secure?: boolean;\n  /** Socket connect timeout in milliseconds. Default: 30_000. */\n  connectionTimeout?: number;\n  /** TLS options passed to node:tls. */\n  tls?: TLSOptions;\n}\n\n/**\n * Node.js socket adapter using node:net and node:tls.\n */\nexport class NodeAdapter implements SocketAdapter {\n  /** Underlying Node.js TCP or TLS socket. */\n  private socket: net.Socket | tls.TLSSocket | null = null;\n  /** Whether the connection is currently encrypted. */\n  private _secure: boolean;\n  /** Whether the socket is connected. */\n  private _connected = false;\n  /** Socket connect timeout in milliseconds. */\n  private readonly connectionTimeout: number;\n  /** TLS options for direct TLS and STARTTLS upgrades. */\n  private readonly tlsOptions: TLSOptions;\n\n  /** Creates a Node.js socket adapter. */\n  constructor(options: NodeAdapterOptions = {}) {\n    this._secure = options.secure ?? false;\n    this.connectionTimeout = options.connectionTimeout ?? 30_000;\n    this.tlsOptions = options.tls ?? {};\n  }\n\n  /** Whether the connection uses TLS. */\n  get secure(): boolean {\n    return this._secure;\n  }\n\n  /** Whether the socket is currently connected. */\n  get connected(): boolean {\n    return this._connected;\n  }\n\n  /** Opens a TCP or TLS connection to the given host and port. */\n  async connect(host: string, port: number): Promise<void> {\n    if (this._secure) {\n      await this.connectTls(host, port);\n    } else {\n      await this.connectPlain(host, port);\n    }\n    this._connected = true;\n  }\n\n  /** Upgrades a plain connection to TLS via STARTTLS. */\n  async startTLS(options?: TLSOptions): Promise<void> {\n    if (!this.socket || this._secure) {\n      throw new Error(\"Cannot STARTTLS: no plain socket available\");\n    }\n\n    const plain = this.socket;\n    const merged = { ...this.tlsOptions, ...options };\n    warnRejectUnauthorizedDisabled(merged);\n\n    await new Promise<void>((resolve, reject) => {\n      const tlsSocket = tls.connect({\n        socket: plain,\n        servername: merged.servername,\n        rejectUnauthorized: merged.rejectUnauthorized ?? true,\n        minVersion: merged.minVersion,\n      });\n\n      tlsSocket.once(\"secureConnect\", () => {\n        this.socket = tlsSocket;\n        this._secure = true;\n        resolve();\n      });\n      tlsSocket.once(\"error\", reject);\n    });\n  }\n\n  /** Writes raw bytes to the socket. */\n  async write(data: Uint8Array): Promise<void> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    await new Promise<void>((resolve, reject) => {\n      this.socket?.write(Buffer.from(data), (err: Error | null | undefined) => {\n        if (err) {\n          reject(err);\n        } else {\n          resolve();\n        }\n      });\n    });\n  }\n\n  /** Reads incoming socket data as an async iterable of byte chunks. */\n  async *read(): AsyncGenerator<Uint8Array, void, unknown> {\n    if (!this.socket) {\n      throw new Error(\"Socket not connected\");\n    }\n\n    const socket = this.socket;\n    const queue: Uint8Array[] = [];\n    let resolveNext: ((value: IteratorResult<Uint8Array>) => void) | null = null;\n    let done = false;\n    let error: Error | null = null;\n\n    const onData = (chunk: Buffer): void => {\n      const data = new Uint8Array(chunk);\n      if (resolveNext) {\n        resolveNext({ value: data, done: false });\n        resolveNext = null;\n      } else {\n        queue.push(data);\n      }\n    };\n\n    const onError = (err: Error): void => {\n      error = err;\n      if (resolveNext) {\n        resolveNext({ value: undefined as unknown as Uint8Array, done: true });\n        resolveNext = null;\n      }\n      done = true;\n    };\n\n    const onClose = (): void => {\n      done = true;\n      if (resolveNext) {\n        resolveNext({ value: undefined as unknown as Uint8Array, done: true });\n        resolveNext = null;\n      }\n    };\n\n    socket.on(\"data\", onData);\n    socket.on(\"error\", onError);\n    socket.on(\"close\", onClose);\n\n    try {\n      while (!done || queue.length > 0) {\n        if (error) {\n          throw error;\n        }\n        if (queue.length > 0) {\n          yield queue.shift() as Uint8Array;\n          continue;\n        }\n        if (done) {\n          break;\n        }\n        const chunk = await new Promise<IteratorResult<Uint8Array>>((resolve) => {\n          resolveNext = resolve;\n        });\n        if (chunk.done) {\n          break;\n        }\n        yield chunk.value;\n      }\n    } finally {\n      socket.off(\"data\", onData);\n      socket.off(\"error\", onError);\n      socket.off(\"close\", onClose);\n    }\n  }\n\n  /** Closes the socket connection. */\n  async close(): Promise<void> {\n    if (!this.socket) {\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      this.socket?.end(() => resolve());\n    });\n    this.socket = null;\n    this._connected = false;\n  }\n\n  /** Opens a plain TCP connection to the SMTP server. */\n  private connectPlain(host: string, port: number): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const socket = net.connect({ host, port }, () => resolve());\n      socket.setTimeout(this.connectionTimeout);\n      socket.once(\"timeout\", () => {\n        socket.destroy();\n        reject(new Error(\"Connection timeout\"));\n      });\n      socket.once(\"error\", reject);\n      this.socket = socket;\n    });\n  }\n\n  /** Opens a direct TLS connection to the SMTP server. */\n  private connectTls(host: string, port: number): Promise<void> {\n    warnRejectUnauthorizedDisabled(this.tlsOptions);\n    return new Promise((resolve, reject) => {\n      const socket = tls.connect(\n        {\n          host,\n          port,\n          servername: this.tlsOptions.servername ?? host,\n          rejectUnauthorized: this.tlsOptions.rejectUnauthorized ?? true,\n          minVersion: this.tlsOptions.minVersion,\n        },\n        () => resolve(),\n      );\n      socket.setTimeout(this.connectionTimeout);\n      socket.once(\"timeout\", () => {\n        socket.destroy();\n        reject(new Error(\"Connection timeout\"));\n      });\n      socket.once(\"error\", reject);\n      this.socket = socket;\n    });\n  }\n}\n"
   ],
   "mappings": "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",
   "debugId": "81CB75805F76C9AC64756E2164756E21",

package/dist/{chunk-fjq6b8gj.js → chunk-4mvp3b85.js}

@@ -1,3 +1,3 @@
-import{p as U}from"./chunk-rm78s1ek.js";import{r as X}from"./chunk-gkkv7yqm.js";import{s as b}from"./chunk-r7ee9tk7.js";import{D as k,E as x,F as Z,G as O,H as q,I as L,J as j,K as N,L as v,M as A,O as E}from"./chunk-cvrbfke9.js";import{W as C}from"./chunk-keksa6fx.js";class T{config;adapter=null;constructor(z){this.config=P(z)}async send(z){let B={...z,attachments:await b(z.attachments)},G=await X(B,this.config.dkim),F=await this.getAdapter(),W=this.config.direct?await M(G.envelope.from.split("@")[1]??this.config.host):this.config.host;await F.connect(W,this.config.port),this.adapter=F;try{return await D(F,this.config),await S(F,G)}finally{await H(F),this.adapter=null}}async verify(){try{let z=await this.getAdapter();await z.connect(this.config.host,this.config.port);try{return await D(z,this.config),{ok:!0,provider:"smtp"}}finally{await H(z)}}catch(z){return{ok:!1,provider:"smtp",message:z instanceof Error?z.message:String(z)}}}async close(){if(this.adapter)await this.adapter.close(),this.adapter=null}async getAdapter(){if(!this.config.adapter)throw new x("No socket adapter configured",0,"CONNECT","");return this.config.adapter}}function P(z){let B=z.secure??!1;return{host:z.host,port:z.port??(B?465:587),secure:B,...z.auth!==void 0?{auth:z.auth}:{},...z.requireTLS!==void 0?{requireTLS:z.requireTLS}:{},...z.dkim!==void 0?{dkim:z.dkim}:{},...z.tls!==void 0?{tls:z.tls}:{},...z.connectionTimeout!==void 0?{connectionTimeout:z.connectionTimeout}:{},...z.greetingTimeout!==void 0?{greetingTimeout:z.greetingTimeout}:{},...z.socketTimeout!==void 0?{socketTimeout:z.socketTimeout}:{},...z.direct!==void 0?{direct:z.direct}:{},...z.adapter!==void 0?{adapter:z.adapter}:{}}}async function D(z,B){let G=await J(z);N(G,[220],"greeting");let F=await I(z,B.host),W=F.some((Q)=>Q.toUpperCase()==="STARTTLS");if(!B.secure&&!z.secure&&W){await Y(z,Z({type:"STARTTLS"}));let Q=await J(z);N(Q,[220],"STARTTLS"),await z.startTLS(B.tls),F=await I(z,B.host)}if(B.auth){let Q=B.requireTLS??!0,V=z.secure||B.secure;if(Q&&!V)throw new x("Refusing to authenticate over unencrypted connection. Set requireTLS: false to disable this check (not recommended).",0,"AUTH","");await l(z,B.auth,F)}}async function S(z,B){await _(z,{type:"MAIL_FROM",address:B.envelope.from});let G=await J(z);N(G,[250],"MAIL FROM");let F=[],W=[];for(let K of B.envelope.to)if(await Y(z,Z({type:"RCPT_TO",address:K})),(await J(z)).isSuccess)F.push(K);else W.push(K);await _(z,{type:"DATA"});let Q=await J(z);N(Q,[354],"DATA");let V;try{await Y(z,Z({type:"DATA_BODY",content:B.raw})),V=await J(z)}catch(K){if(await Y(z,Z({type:"DATA_BODY",content:B.raw})),V=await J(z),V.isError)throw K}return N(V,[250],"DATA end"),{messageId:B.messageId,accepted:F,rejected:W,response:V.message,envelope:B.envelope}}async function H(z){try{await _(z,{type:"QUIT"}),await J(z)}catch{}finally{await z.close()}}async function I(z,B){await _(z,{type:"EHLO",domain:B});let G=await J(z);return N(G,[250],"EHLO"),j(G)}async function l(z,B,G){if(B.type==="OAUTH2"&&B.oauth2){let K=await new U(B.oauth2).buildXOAUTH2();await _(z,{type:"AUTH_XOAUTH2",xoauth2String:K});let $=await J(z);if($.code===334)await Y(z,E("")),$=await J(z);N($,[235],"AUTH XOAUTH2");return}let F=B.type??L(G);if(F==="CRAM-MD5"){let V=y(B,"CRAM-MD5");await _(z,{type:"AUTH_CRAM_MD5_INIT"});let K=await J(z);N(K,[334],"AUTH CRAM-MD5");let $=K.message.trim(),w=await k($,B.user,V);await _(z,{type:"AUTH_CRAM_MD5_RESPONSE",response:w}),K=await J(z),N(K,[235],"AUTH CRAM-MD5 response");return}if(F==="PLAIN"){let V=y(B,"PLAIN");await Y(z,Z({type:"AUTH_PLAIN",user:B.user,pass:V}));let K=await J(z);N(K,[235],"AUTH PLAIN");return}let W=y(B,"LOGIN");await Y(z,Z({type:"AUTH_LOGIN",user:B.user,pass:W}));let Q=await J(z);N(Q,[334],"AUTH LOGIN"),await Y(z,A(B.user)),Q=await J(z),N(Q,[334],"AUTH LOGIN user"),await Y(z,v(W)),Q=await J(z),N(Q,[235],"AUTH LOGIN pass")}function y(z,B){if(!z.pass)throw new x(`Password required for ${B} authentication`,0,`AUTH ${B}`,"");return z.pass}async function _(z,B){await Y(z,Z(B))}async function Y(z,B){await z.write(B)}async function J(z){let B=[];for await(let G of z.read()){B.push(G);let F=q(B);if(F)return O(F)}throw new x("Connection closed while reading SMTP response",0,"READ","")}async function M(z){let G=await(await import("node:dns/promises")).resolveMx(z);if(G.length===0)throw new x(`No MX records for ${z}`,0,"MX","");return G.sort((F,W)=>F.priority-W.priority),G[0]?.exchange??z}export{T as h,P as i,D as j,S as k,H as l,J as m};
+import{p as U}from"./chunk-rm78s1ek.js";import{r as X}from"./chunk-gkkv7yqm.js";import{s as b}from"./chunk-r7ee9tk7.js";import{D as k,E as $,F as Z,G as O,H as q,I as L,J as v,K as N,L as A,M as j,O as E}from"./chunk-cvrbfke9.js";import{W as C}from"./chunk-keksa6fx.js";class T{config;adapter=null;constructor(z){this.config=P(z)}async send(z){let B={...z,attachments:await b(z.attachments)},G=await X(B,this.config.dkim),F=await this.getAdapter(),W=this.config.direct?await M(G.envelope.from.split("@")[1]??this.config.host):this.config.host;await F.connect(W,this.config.port),this.adapter=F;try{return await D(F,this.config),await S(F,G)}finally{await H(F),this.adapter=null}}async verify(){try{let z=await this.getAdapter();await z.connect(this.config.host,this.config.port);try{return await D(z,this.config),{ok:!0,provider:"smtp"}}finally{await H(z)}}catch(z){return{ok:!1,provider:"smtp",message:z instanceof Error?z.message:String(z)}}}async close(){if(this.adapter)await this.adapter.close(),this.adapter=null}async getAdapter(){if(!this.config.adapter)throw new $("No socket adapter configured",0,"CONNECT","");return this.config.adapter}}function P(z){let B=z.secure??!1;return{host:z.host,port:z.port??(B?465:587),secure:B,...z.auth!==void 0?{auth:z.auth}:{},...z.requireTLS!==void 0?{requireTLS:z.requireTLS}:{},...z.dkim!==void 0?{dkim:z.dkim}:{},...z.tls!==void 0?{tls:z.tls}:{},...z.connectionTimeout!==void 0?{connectionTimeout:z.connectionTimeout}:{},...z.greetingTimeout!==void 0?{greetingTimeout:z.greetingTimeout}:{},...z.socketTimeout!==void 0?{socketTimeout:z.socketTimeout}:{},...z.direct!==void 0?{direct:z.direct}:{},...z.adapter!==void 0?{adapter:z.adapter}:{}}}async function D(z,B){let G=await J(z);N(G,[220],"greeting");let F=await I(z,B.host),W=F.some((Q)=>Q.toUpperCase()==="STARTTLS");if(!B.secure&&!z.secure&&W){await Y(z,Z({type:"STARTTLS"}));let Q=await J(z);N(Q,[220],"STARTTLS"),await z.startTLS(B.tls),F=await I(z,B.host)}if(B.auth){let Q=B.requireTLS??!0,V=z.secure||B.secure;if(Q&&!V)throw new $("Refusing to authenticate over unencrypted connection. Set requireTLS: false to disable this check (not recommended).",0,"AUTH","");await l(z,B.auth,F)}}async function S(z,B){await _(z,{type:"MAIL_FROM",address:B.envelope.from});let G=await J(z);N(G,[250],"MAIL FROM");let F=[],W=[];for(let K of B.envelope.to)if(await Y(z,Z({type:"RCPT_TO",address:K})),(await J(z)).isSuccess)F.push(K);else W.push(K);await _(z,{type:"DATA"});let Q=await J(z);N(Q,[354],"DATA");let V;try{await Y(z,Z({type:"DATA_BODY",content:B.raw})),V=await J(z)}catch(K){if(await Y(z,Z({type:"DATA_BODY",content:B.raw})),V=await J(z),V.isError)throw K}return N(V,[250],"DATA end"),{messageId:B.messageId,accepted:F,rejected:W,response:V.message,envelope:B.envelope}}async function H(z){try{await _(z,{type:"QUIT"}),await J(z)}catch{}finally{await z.close()}}async function I(z,B){await _(z,{type:"EHLO",domain:B});let G=await J(z);return N(G,[250],"EHLO"),v(G)}async function l(z,B,G){if(B.type==="OAUTH2"&&B.oauth2){let K=await new U(B.oauth2).buildXOAUTH2();await _(z,{type:"AUTH_XOAUTH2",xoauth2String:K});let x=await J(z);if(x.code===334)await Y(z,E("")),x=await J(z);N(x,[235],"AUTH XOAUTH2");return}let F=B.type??L(G);if(F==="CRAM-MD5"){let V=y(B,"CRAM-MD5");await _(z,{type:"AUTH_CRAM_MD5_INIT"});let K=await J(z);N(K,[334],"AUTH CRAM-MD5");let x=K.message.trim(),w=await k(x,B.user,V);await _(z,{type:"AUTH_CRAM_MD5_RESPONSE",response:w}),K=await J(z),N(K,[235],"AUTH CRAM-MD5 response");return}if(F==="PLAIN"){let V=y(B,"PLAIN");await Y(z,Z({type:"AUTH_PLAIN",user:B.user,pass:V}));let K=await J(z);N(K,[235],"AUTH PLAIN");return}let W=y(B,"LOGIN");await Y(z,Z({type:"AUTH_LOGIN",user:B.user,pass:W}));let Q=await J(z);N(Q,[334],"AUTH LOGIN"),await Y(z,j(B.user)),Q=await J(z),N(Q,[334],"AUTH LOGIN user"),await Y(z,A(W)),Q=await J(z),N(Q,[235],"AUTH LOGIN pass")}function y(z,B){if(!z.pass)throw new $(`Password required for ${B} authentication`,0,`AUTH ${B}`,"");return z.pass}async function _(z,B){await Y(z,Z(B))}async function Y(z,B){await z.write(B)}async function J(z){let B=[];for await(let G of z.read()){B.push(G);let F=q(B);if(F)return O(F)}throw new $("Connection closed while reading SMTP response",0,"READ","")}async function M(z){let G=await(await import("node:dns/promises")).resolveMx(z);if(G.length===0)throw new $(`No MX records for ${z}`,0,"MX","");return G.sort((F,W)=>F.priority-W.priority),G[0]?.exchange??z}export{T as h,P as i,D as j,S as k,H as l,J as m};
 
-//# debugId=2AE3F79365288A7C64756E2164756E21
+//# debugId=7424DBD21313E1C964756E2164756E21

package/dist/chunk-4mvp3b85.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/transports/smtp.ts"],
+  "sourcesContent": [
+    "/**\n * @module\n * SMTP transport — orchestrates socket adapter, MIME builder, and protocol logic.\n *\n * @example\n * ```ts\n * import { SMTPTransport } from \"sently/transports/smtp\";\n * import { NodeAdapter } from \"sently/adapters/node\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n *   transport: new SMTPTransport({\n *     host: \"smtp.example.com\",\n *     auth: { user: \"you@example.com\", pass: \"secret\" },\n *     adapter: new NodeAdapter(),\n *   }),\n * });\n * ```\n */\nimport { OAuth2Client } from \"../auth/oauth2.js\";\nimport { buildMIME, type MIMEBuildResult } from \"../core/mime.js\";\nimport type { SMTPResponse } from \"../core/smtp.js\";\nimport {\n  accumulateResponse,\n  assertResponse,\n  computeCRAMMD5,\n  encodeAuthLoginPass,\n  encodeAuthLoginUser,\n  encodeCommand,\n  encodeLine,\n  parseEHLO,\n  parseResponse,\n  SMTPError,\n  selectAuthMethod,\n} from \"../core/smtp.js\";\nimport type {\n  MailOptions,\n  SendResult,\n  SMTPConfig,\n  SocketAdapter,\n  Transport,\n  VerifyResult,\n} from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/**\n * SMTP transport orchestrating adapter, MIME builder, and protocol logic.\n */\nexport class SMTPTransport implements Transport {\n  /** Resolved SMTP configuration with defaults applied. */\n  private readonly config: ResolvedSMTPConfig;\n  /** Active socket adapter for the current session, if any. */\n  private adapter: SocketAdapter | null = null;\n\n  /** Creates an SMTP transport with the given configuration. */\n  constructor(config: SMTPConfig) {\n    this.config = resolveSMTPConfig(config);\n  }\n\n  /** Sends an email via SMTP using the configured adapter. */\n  async send(options: MailOptions): Promise<SendResult> {\n    const resolvedOptions = {\n      ...options,\n      attachments: await resolveAttachments(options.attachments),\n    };\n    const mime = await buildMIME(resolvedOptions, this.config.dkim);\n    const adapter = await this.getAdapter();\n\n    const host = this.config.direct\n      ? await resolveMX(mime.envelope.from.split(\"@\")[1] ?? this.config.host)\n      : this.config.host;\n\n    await adapter.connect(host, this.config.port);\n    this.adapter = adapter;\n\n    try {\n      await openSMTPSession(adapter, this.config);\n      return await deliverSMTPMessage(adapter, mime);\n    } finally {\n      await closeSMTPSession(adapter);\n      this.adapter = null;\n    }\n  }\n\n  /** Verifies SMTP connectivity and authentication without sending mail. */\n  async verify(): Promise<VerifyResult> {\n    try {\n      const adapter = await this.getAdapter();\n      await adapter.connect(this.config.host, this.config.port);\n\n      try {\n        await openSMTPSession(adapter, this.config);\n        return { ok: true, provider: \"smtp\" };\n      } finally {\n        await closeSMTPSession(adapter);\n      }\n    } catch (err) {\n      return {\n        ok: false,\n        provider: \"smtp\",\n        message: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  /** Closes the underlying socket adapter if connected. */\n  async close(): Promise<void> {\n    if (this.adapter) {\n      await this.adapter.close();\n      this.adapter = null;\n    }\n  }\n\n  /** Returns the configured socket adapter or throws if none is set. */\n  private async getAdapter(): Promise<SocketAdapter> {\n    if (!this.config.adapter) {\n      throw new SMTPError(\"No socket adapter configured\", 0, \"CONNECT\", \"\");\n    }\n    return this.config.adapter;\n  }\n}\n\n/** Resolved SMTP transport configuration with defaults applied. */\nexport interface ResolvedSMTPConfig {\n  /** SMTP server hostname. */\n  host: string;\n  /** SMTP port with secure/default applied. */\n  port: number;\n  /** Whether implicit TLS is used. */\n  secure: boolean;\n  /** Resolved authentication credentials, if any. */\n  auth?: SMTPConfig[\"auth\"];\n  /** Whether AUTH requires an encrypted connection. */\n  requireTLS?: boolean;\n  /** TLS options for STARTTLS and direct TLS. */\n  tls?: SMTPConfig[\"tls\"];\n  /** DKIM signing configuration. */\n  dkim?: SMTPConfig[\"dkim\"];\n  /** Socket connect timeout in milliseconds. */\n  connectionTimeout?: number;\n  /** Timeout waiting for the SMTP greeting in milliseconds. */\n  greetingTimeout?: number;\n  /** Idle socket timeout in milliseconds. */\n  socketTimeout?: number;\n  /** Direct-to-MX delivery mode. */\n  direct?: boolean;\n  /** Runtime socket adapter. */\n  adapter?: SocketAdapter;\n}\n\n/** Apply defaults to SMTP configuration. */\nexport function resolveSMTPConfig(config: SMTPConfig): ResolvedSMTPConfig {\n  const secure = config.secure ?? false;\n  return {\n    host: config.host,\n    port: config.port ?? (secure ? 465 : 587),\n    secure,\n    ...(config.auth !== undefined ? { auth: config.auth } : {}),\n    ...(config.requireTLS !== undefined ? { requireTLS: config.requireTLS } : {}),\n    ...(config.dkim !== undefined ? { dkim: config.dkim } : {}),\n    ...(config.tls !== undefined ? { tls: config.tls } : {}),\n    ...(config.connectionTimeout !== undefined\n      ? { connectionTimeout: config.connectionTimeout }\n      : {}),\n    ...(config.greetingTimeout !== undefined ? { greetingTimeout: config.greetingTimeout } : {}),\n    ...(config.socketTimeout !== undefined ? { socketTimeout: config.socketTimeout } : {}),\n    ...(config.direct !== undefined ? { direct: config.direct } : {}),\n    ...(config.adapter !== undefined ? { adapter: config.adapter } : {}),\n  };\n}\n\n/**\n * Connect greeting, EHLO, optional STARTTLS, and AUTH on an open adapter.\n */\nexport async function openSMTPSession(\n  adapter: SocketAdapter,\n  config: ResolvedSMTPConfig,\n): Promise<void> {\n  const greeting = await readSMTPResponse(adapter);\n  assertResponse(greeting, [220], \"greeting\");\n\n  let capabilities = await ehlo(adapter, config.host);\n  const supportsStartTls = capabilities.some((cap) => cap.toUpperCase() === \"STARTTLS\");\n  if (!config.secure && !adapter.secure && supportsStartTls) {\n    await sendRaw(adapter, encodeCommand({ type: \"STARTTLS\" }));\n    const starttlsResp = await readSMTPResponse(adapter);\n    assertResponse(starttlsResp, [220], \"STARTTLS\");\n    await adapter.startTLS(config.tls);\n    capabilities = await ehlo(adapter, config.host);\n  }\n\n  if (config.auth) {\n    const tlsRequired = config.requireTLS ?? true;\n    const encrypted = adapter.secure || config.secure;\n    if (tlsRequired && !encrypted) {\n      throw new SMTPError(\n        \"Refusing to authenticate over unencrypted connection. \" +\n          \"Set requireTLS: false to disable this check (not recommended).\",\n        0,\n        \"AUTH\",\n        \"\",\n      );\n    }\n    await authenticate(adapter, config.auth, capabilities);\n  }\n}\n\n/**\n * MAIL FROM, RCPT TO, and DATA for a built MIME message on an authenticated session.\n */\nexport async function deliverSMTPMessage(\n  adapter: SocketAdapter,\n  mime: MIMEBuildResult,\n): Promise<SendResult> {\n  await sendCommand(adapter, { type: \"MAIL_FROM\", address: mime.envelope.from });\n  const mailResp = await readSMTPResponse(adapter);\n  assertResponse(mailResp, [250], \"MAIL FROM\");\n\n  const accepted: string[] = [];\n  const rejected: string[] = [];\n\n  for (const recipient of mime.envelope.to) {\n    await sendRaw(adapter, encodeCommand({ type: \"RCPT_TO\", address: recipient }));\n    const rcptResp = await readSMTPResponse(adapter);\n    if (rcptResp.isSuccess) {\n      accepted.push(recipient);\n    } else {\n      rejected.push(recipient);\n    }\n  }\n\n  await sendCommand(adapter, { type: \"DATA\" });\n  const dataResp = await readSMTPResponse(adapter);\n  assertResponse(dataResp, [354], \"DATA\");\n\n  let finalResp: SMTPResponse;\n  try {\n    await sendRaw(adapter, encodeCommand({ type: \"DATA_BODY\", content: mime.raw }));\n    finalResp = await readSMTPResponse(adapter);\n  } catch (err) {\n    await sendRaw(adapter, encodeCommand({ type: \"DATA_BODY\", content: mime.raw }));\n    finalResp = await readSMTPResponse(adapter);\n    if (finalResp.isError) {\n      throw err;\n    }\n  }\n  assertResponse(finalResp, [250], \"DATA end\");\n\n  return {\n    messageId: mime.messageId,\n    accepted,\n    rejected,\n    response: finalResp.message,\n    envelope: mime.envelope,\n  };\n}\n\n/**\n * QUIT and close an SMTP session adapter.\n */\nexport async function closeSMTPSession(adapter: SocketAdapter): Promise<void> {\n  try {\n    await sendCommand(adapter, { type: \"QUIT\" });\n    await readSMTPResponse(adapter);\n  } catch {\n    // ignore errors during shutdown\n  } finally {\n    await adapter.close();\n  }\n}\n\nasync function ehlo(adapter: SocketAdapter, host: string): Promise<string[]> {\n  await sendCommand(adapter, { type: \"EHLO\", domain: host });\n  const response = await readSMTPResponse(adapter);\n  assertResponse(response, [250], \"EHLO\");\n  return parseEHLO(response);\n}\n\nasync function authenticate(\n  adapter: SocketAdapter,\n  auth: NonNullable<SMTPConfig[\"auth\"]>,\n  capabilities: string[],\n): Promise<void> {\n  if (auth.type === \"OAUTH2\" && auth.oauth2) {\n    const client = new OAuth2Client(auth.oauth2);\n    const xoauth2 = await client.buildXOAUTH2();\n    await sendCommand(adapter, { type: \"AUTH_XOAUTH2\", xoauth2String: xoauth2 });\n    let resp = await readSMTPResponse(adapter);\n    if (resp.code === 334) {\n      await sendRaw(adapter, encodeLine(\"\"));\n      resp = await readSMTPResponse(adapter);\n    }\n    assertResponse(resp, [235], \"AUTH XOAUTH2\");\n    return;\n  }\n\n  const method = auth.type ?? selectAuthMethod(capabilities);\n\n  if (method === \"CRAM-MD5\") {\n    const pass = requirePassword(auth, \"CRAM-MD5\");\n    await sendCommand(adapter, { type: \"AUTH_CRAM_MD5_INIT\" });\n    let resp = await readSMTPResponse(adapter);\n    assertResponse(resp, [334], \"AUTH CRAM-MD5\");\n    const challenge = resp.message.trim();\n    const response = await computeCRAMMD5(challenge, auth.user, pass);\n    await sendCommand(adapter, { type: \"AUTH_CRAM_MD5_RESPONSE\", response });\n    resp = await readSMTPResponse(adapter);\n    assertResponse(resp, [235], \"AUTH CRAM-MD5 response\");\n    return;\n  }\n\n  if (method === \"PLAIN\") {\n    const pass = requirePassword(auth, \"PLAIN\");\n    await sendRaw(adapter, encodeCommand({ type: \"AUTH_PLAIN\", user: auth.user, pass }));\n    const resp = await readSMTPResponse(adapter);\n    assertResponse(resp, [235], \"AUTH PLAIN\");\n    return;\n  }\n\n  const pass = requirePassword(auth, \"LOGIN\");\n  await sendRaw(adapter, encodeCommand({ type: \"AUTH_LOGIN\", user: auth.user, pass }));\n  let resp = await readSMTPResponse(adapter);\n  assertResponse(resp, [334], \"AUTH LOGIN\");\n\n  await sendRaw(adapter, encodeAuthLoginUser(auth.user));\n  resp = await readSMTPResponse(adapter);\n  assertResponse(resp, [334], \"AUTH LOGIN user\");\n\n  await sendRaw(adapter, encodeAuthLoginPass(pass));\n  resp = await readSMTPResponse(adapter);\n  assertResponse(resp, [235], \"AUTH LOGIN pass\");\n}\n\nfunction requirePassword(auth: NonNullable<SMTPConfig[\"auth\"]>, method: string): string {\n  if (!auth.pass) {\n    throw new SMTPError(`Password required for ${method} authentication`, 0, `AUTH ${method}`, \"\");\n  }\n  return auth.pass;\n}\n\nasync function sendCommand(\n  adapter: SocketAdapter,\n  command: Parameters<typeof encodeCommand>[0],\n): Promise<void> {\n  await sendRaw(adapter, encodeCommand(command));\n}\n\nasync function sendRaw(adapter: SocketAdapter, data: Uint8Array): Promise<void> {\n  await adapter.write(data);\n}\n\n/** Reads and parses a complete SMTP response from the adapter. */\nasync function readSMTPResponse(adapter: SocketAdapter): Promise<SMTPResponse> {\n  const chunks: Uint8Array[] = [];\n  for await (const chunk of adapter.read()) {\n    chunks.push(chunk);\n    const complete = accumulateResponse(chunks);\n    if (complete) {\n      return parseResponse(complete);\n    }\n  }\n  throw new SMTPError(\"Connection closed while reading SMTP response\", 0, \"READ\", \"\");\n}\n\nasync function resolveMX(domain: string): Promise<string> {\n  const dns = await import(\"node:dns/promises\");\n  const records = await dns.resolveMx(domain);\n  if (records.length === 0) {\n    throw new SMTPError(`No MX records for ${domain}`, 0, \"MX\", \"\");\n  }\n  records.sort((a: { priority: number }, b: { priority: number }) => a.priority - b.priority);\n  return records[0]?.exchange ?? domain;\n}\n\nexport { SMTPError } from \"../core/smtp.js\";\n/** @internal Test helper for raw line writes. */\nexport { encodeLine, readSMTPResponse };\n"
+  ],
+  "mappings": "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",
+  "debugId": "7424DBD21313E1C964756E2164756E21",
+  "names": []
+}

package/dist/chunk-a1c87hn1.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/core/errors.ts"],
   "sourcesContent": [
-    "/**\n * @module\n * Unified error hierarchy for sently transports and SMTP.\n */\n\n/** Stable machine-readable error codes shared across providers. */\nexport type SentlyErrorCode =\n  | \"SMTP_AUTH_FAILED\"\n  | \"RATE_LIMITED\"\n  | \"TIMEOUT\"\n  | \"CONNECTION_FAILED\"\n  | \"PROVIDER_ERROR\"\n  | \"BAD_REQUEST\";\n\n/** Options for constructing a {@link SentlyError}. */\nexport interface SentlyErrorOptions {\n  /** HTTP status code when the failure originated from an HTTP transport. */\n  statusCode?: number;\n  /** Original error or response payload. */\n  cause?: unknown;\n  /** Provider identifier (e.g. `\"smtp\"`, `\"resend\"`). */\n  provider?: string;\n}\n\n/**\n * Base error class for all sently transport and protocol failures.\n *\n * Subclasses may shadow {@link code} with provider-specific or numeric values\n * (e.g. SMTP response codes). Use {@link sentlyCode} for the stable machine-readable\n * code in those cases.\n */\nexport class SentlyError extends Error {\n  /**\n   * Stable machine-readable error code.\n   * Preserved even when a subclass shadows {@link code}.\n   */\n  readonly sentlyCode: SentlyErrorCode;\n\n  /** HTTP status code when applicable. */\n  readonly statusCode?: number;\n\n  /** Provider identifier when applicable. */\n  readonly provider?: string;\n\n  /**\n   * Error code — machine-readable string on {@link SentlyError}, or a legacy\n   * provider/SMTP-specific value on subclasses (numeric SMTP codes, Brevo/SES API codes).\n   */\n  code: string | number;\n\n  /** Creates a sently error with a machine-readable code and optional metadata. */\n  constructor(message: string, sentlyCode: SentlyErrorCode, options?: SentlyErrorOptions) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = \"SentlyError\";\n    this.sentlyCode = sentlyCode;\n    this.code = sentlyCode;\n    if (options?.statusCode !== undefined) {\n      this.statusCode = options.statusCode;\n    }\n    if (options?.provider !== undefined) {\n      this.provider = options.provider;\n    }\n  }\n}\n\n/**\n * Map an HTTP status code to a stable sently error code.\n *\n * @param status - HTTP response status code\n * @returns Machine-readable error code\n */\nexport function httpStatusToSentlyCode(status: number): SentlyErrorCode {\n  if (status === 429) {\n    return \"RATE_LIMITED\";\n  }\n  if (status >= 500) {\n    return \"PROVIDER_ERROR\";\n  }\n  if (status >= 400) {\n    return \"BAD_REQUEST\";\n  }\n  return \"PROVIDER_ERROR\";\n}\n\n/**\n * Map an SMTP response code and command to a stable sently error code.\n *\n * @param smtpCode - Three-digit SMTP response code (0 for local/parse errors)\n * @param command - SMTP command that failed\n * @returns Machine-readable error code\n */\nexport function smtpCodeToSentlyCode(smtpCode: number, command: string): SentlyErrorCode {\n  if (smtpCode === 535 || smtpCode === 534) {\n    return \"SMTP_AUTH_FAILED\";\n  }\n  if (smtpCode === 421 || smtpCode === 450 || smtpCode === 451) {\n    return \"TIMEOUT\";\n  }\n  if (smtpCode === 0) {\n    if (command === \"CONNECT\" || command === \"READ\" || command === \"MX\") {\n      return \"CONNECTION_FAILED\";\n    }\n    return \"PROVIDER_ERROR\";\n  }\n  if (smtpCode >= 500) {\n    return \"PROVIDER_ERROR\";\n  }\n  if (smtpCode >= 400) {\n    return \"BAD_REQUEST\";\n  }\n  return \"PROVIDER_ERROR\";\n}\n"
+    "/**\n * @module\n * Unified error hierarchy for sently transports and SMTP.\n */\n\n/** Stable machine-readable error codes shared across providers. */\nexport type SentlyErrorCode =\n  | \"INVALID_CONFIG\"\n  | \"SMTP_AUTH_FAILED\"\n  | \"RATE_LIMITED\"\n  | \"TIMEOUT\"\n  | \"CONNECTION_FAILED\"\n  | \"PROVIDER_ERROR\"\n  | \"BAD_REQUEST\";\n\n/** Options for constructing a {@link SentlyError}. */\nexport interface SentlyErrorOptions {\n  /** HTTP status code when the failure originated from an HTTP transport. */\n  statusCode?: number;\n  /** Original error or response payload. */\n  cause?: unknown;\n  /** Provider identifier (e.g. `\"smtp\"`, `\"resend\"`). */\n  provider?: string;\n}\n\n/**\n * Base error class for all sently transport and protocol failures.\n *\n * Subclasses may shadow {@link code} with provider-specific or numeric values\n * (e.g. SMTP response codes). Use {@link sentlyCode} for the stable machine-readable\n * code in those cases.\n */\nexport class SentlyError extends Error {\n  /**\n   * Stable machine-readable error code.\n   * Preserved even when a subclass shadows {@link code}.\n   */\n  readonly sentlyCode: SentlyErrorCode;\n\n  /** HTTP status code when applicable. */\n  readonly statusCode?: number;\n\n  /** Provider identifier when applicable. */\n  readonly provider?: string;\n\n  /**\n   * Error code — machine-readable string on {@link SentlyError}, or a legacy\n   * provider/SMTP-specific value on subclasses (numeric SMTP codes, Brevo/SES API codes).\n   */\n  code: string | number;\n\n  /** Creates a sently error with a machine-readable code and optional metadata. */\n  constructor(message: string, sentlyCode: SentlyErrorCode, options?: SentlyErrorOptions) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = \"SentlyError\";\n    this.sentlyCode = sentlyCode;\n    this.code = sentlyCode;\n    if (options?.statusCode !== undefined) {\n      this.statusCode = options.statusCode;\n    }\n    if (options?.provider !== undefined) {\n      this.provider = options.provider;\n    }\n  }\n}\n\n/**\n * Map an HTTP status code to a stable sently error code.\n *\n * @param status - HTTP response status code\n * @returns Machine-readable error code\n */\nexport function httpStatusToSentlyCode(status: number): SentlyErrorCode {\n  if (status === 429) {\n    return \"RATE_LIMITED\";\n  }\n  if (status >= 500) {\n    return \"PROVIDER_ERROR\";\n  }\n  if (status >= 400) {\n    return \"BAD_REQUEST\";\n  }\n  return \"PROVIDER_ERROR\";\n}\n\n/**\n * Map an SMTP response code and command to a stable sently error code.\n *\n * @param smtpCode - Three-digit SMTP response code (0 for local/parse errors)\n * @param command - SMTP command that failed\n * @returns Machine-readable error code\n */\nexport function smtpCodeToSentlyCode(smtpCode: number, command: string): SentlyErrorCode {\n  if (smtpCode === 535 || smtpCode === 534) {\n    return \"SMTP_AUTH_FAILED\";\n  }\n  if (smtpCode === 421 || smtpCode === 450 || smtpCode === 451) {\n    return \"TIMEOUT\";\n  }\n  if (smtpCode === 0) {\n    if (command === \"CONNECT\" || command === \"READ\" || command === \"MX\") {\n      return \"CONNECTION_FAILED\";\n    }\n    return \"PROVIDER_ERROR\";\n  }\n  if (smtpCode >= 500) {\n    return \"PROVIDER_ERROR\";\n  }\n  if (smtpCode >= 400) {\n    return \"BAD_REQUEST\";\n  }\n  return \"PROVIDER_ERROR\";\n}\n"
   ],
-  "mappings": "AA+BO,MAAM,UAAoB,KAAM,CAK5B,WAGA,WAGA,SAMT,KAGA,WAAW,CAAC,EAAiB,EAA6B,EAA8B,CACtF,MAAM,EAAS,GAAS,QAAU,OAAY,CAAE,MAAO,EAAQ,KAAM,EAAI,MAAS,EAIlF,GAHA,KAAK,KAAO,cACZ,KAAK,WAAa,EAClB,KAAK,KAAO,EACR,GAAS,aAAe,OAC1B,KAAK,WAAa,EAAQ,WAE5B,GAAI,GAAS,WAAa,OACxB,KAAK,SAAW,EAAQ,SAG9B,CAQO,SAAS,CAAsB,CAAC,EAAiC,CACtE,GAAI,IAAW,IACb,MAAO,eAET,GAAI,GAAU,IACZ,MAAO,iBAET,GAAI,GAAU,IACZ,MAAO,cAET,MAAO,iBAUF,SAAS,CAAoB,CAAC,EAAkB,EAAkC,CACvF,GAAI,IAAa,KAAO,IAAa,IACnC,MAAO,mBAET,GAAI,IAAa,KAAO,IAAa,KAAO,IAAa,IACvD,MAAO,UAET,GAAI,IAAa,EAAG,CAClB,GAAI,IAAY,WAAa,IAAY,QAAU,IAAY,KAC7D,MAAO,oBAET,MAAO,iBAET,GAAI,GAAY,IACd,MAAO,iBAET,GAAI,GAAY,IACd,MAAO,cAET,MAAO",
+  "mappings": "AAgCO,MAAM,UAAoB,KAAM,CAK5B,WAGA,WAGA,SAMT,KAGA,WAAW,CAAC,EAAiB,EAA6B,EAA8B,CACtF,MAAM,EAAS,GAAS,QAAU,OAAY,CAAE,MAAO,EAAQ,KAAM,EAAI,MAAS,EAIlF,GAHA,KAAK,KAAO,cACZ,KAAK,WAAa,EAClB,KAAK,KAAO,EACR,GAAS,aAAe,OAC1B,KAAK,WAAa,EAAQ,WAE5B,GAAI,GAAS,WAAa,OACxB,KAAK,SAAW,EAAQ,SAG9B,CAQO,SAAS,CAAsB,CAAC,EAAiC,CACtE,GAAI,IAAW,IACb,MAAO,eAET,GAAI,GAAU,IACZ,MAAO,iBAET,GAAI,GAAU,IACZ,MAAO,cAET,MAAO,iBAUF,SAAS,CAAoB,CAAC,EAAkB,EAAkC,CACvF,GAAI,IAAa,KAAO,IAAa,IACnC,MAAO,mBAET,GAAI,IAAa,KAAO,IAAa,KAAO,IAAa,IACvD,MAAO,UAET,GAAI,IAAa,EAAG,CAClB,GAAI,IAAY,WAAa,IAAY,QAAU,IAAY,KAC7D,MAAO,oBAET,MAAO,iBAET,GAAI,GAAY,IACd,MAAO,iBAET,GAAI,GAAY,IACd,MAAO,cAET,MAAO",
   "debugId": "09C74C7A3E8123A164756E2164756E21",
   "names": []
 }

package/dist/chunk-ka6t8g77.js

@@ -0,0 +1,4 @@
+import{x as O}from"./chunk-kebhy657.js";import{B as q}from"./chunk-gh5n759p.js";import{T as N}from"./chunk-a1c87hn1.js";async function T(j,w){if(!w||w.length===0)return j;let H=j;for(let W of w)H=await W(H);return H}function _(j){return typeof j.setMailerOnRetry==="function"}var f="SMTP config passed to transport-only createMailer. Use: import { createSMTPMailer } from 'sently' or import { createSMTPMailer } from 'sently/smtp'.";async function h(j){if(j.transport===void 0||"host"in j&&j.transport===void 0)throw new N(f,"INVALID_CONFIG");return new D(j.transport,j.plugins??[],j.hooks)}function S(j){return j.attachments!==void 0&&j.attachments.length>0}function b(j){let w=j.constructor.name;if(w==="Object")return"custom";if(w.endsWith("Transport"))return w.slice(0,-9).toLowerCase();return w.toLowerCase()||"unknown"}function F(j,w){return{...j.messageId!==void 0?{messageId:j.messageId}:{},to:q(j.to),subject:j.subject,provider:b(w)}}async function G(j,...w){if(j===void 0)return;try{await j(...w)}catch(H){if(!(typeof process<"u"&&process.env?.NODE_ENV==="production"))console.warn("[sently] Mailer hook threw; send continues:",H)}}class D{transport;plugins;hooks;constructor(j,w=[],H){this.transport=j;this.plugins=w;this.hooks=H}async send(j){let w=await T(j,this.plugins),H=F(w,this.transport);if(await G(this.hooks?.onSend,H),this.hooks?.onRetry!==void 0&&_(this.transport))this.transport.setMailerOnRetry((W,X)=>{G(this.hooks?.onRetry,H,W,X)});try{let W=await this.transport.send(w),X={...H,messageId:W.messageId};return await G(this.hooks?.onSuccess,X,W),W}catch(W){throw await G(this.hooks?.onError,H,W),W}finally{if(_(this.transport))this.transport.setMailerOnRetry(void 0)}}async processMessage(j){return T(j,this.plugins)}async sendBulk(j,w){if(j.length===0)return{total:0,sent:0,failed:0,results:[]};let H=Array(j.length),W=w?.stopOnError??!1,X=!1,M=async(Z,$,J,Q)=>{if(H[$]={status:"sent",result:J},Q!==void 0&&this.hooks!==void 0){let U=F(Q,this.transport);await G(this.hooks.onSend,U),await G(this.hooks.onSuccess,{...U,messageId:J.messageId},J)}w?.onSuccess?.(Z,$,J)},L=async(Z,$,J,Q)=>{if(H[$]={status:"failed",error:J},Q!==void 0&&this.hooks!==void 0){let U=F(Q,this.transport);await G(this.hooks.onSend,U),await G(this.hooks.onError,U,J)}if(w?.onError?.(Z,$,J),W)X=!0};if(this.transport.sendBatch){let Z=[],$=[];for(let[J,Q]of j.entries())if(S(Q))$.push({index:J,message:Q});else Z.push({index:J,message:Q});if(Z.length>0&&!X){let J=this.transport.batchMax??Z.length,Q=w?.rateDelta??2,U=Q>0?new O(Q,w?.rateLimit??1000,w?.now):null;for(let z=0;z<Z.length&&!X;z+=J){let V=Z.slice(z,z+J);if(U)await U.acquire();try{let Y=await Promise.all(V.map(({message:B})=>this.processMessage(B))),K=await this.transport.sendBatch(Y);for(let B=0;B<V.length;B++){let C=V[B],P=Y[B],A=K[B];if(A===void 0)await L(C.message,C.index,Error("Batch response missing result for message"),P);else if(A.batchError!==void 0)await L(C.message,C.index,A.batchError,P);else await M(C.message,C.index,A,P)}}catch(Y){let K=await Promise.all(V.map(({message:B})=>this.processMessage(B)));for(let B=0;B<V.length;B++){if(X)break;let C=V[B];await L(C.message,C.index,Y,K[B])}}}}if($.length>0&&!X){let J=w?.concurrency??1,Q=[...$],U=0;await new Promise((z)=>{let V=()=>{if(Q.length===0&&U===0||X)z()},Y=()=>{if(Q.length===0||X){V();return}let K=Q.shift();if(K===void 0){V();return}U++,this.send(K.message).then((B)=>{H[K.index]={status:"sent",result:B},w?.onSuccess?.(K.message,K.index,B)}).catch((B)=>{if(H[K.index]={status:"failed",error:B},w?.onError?.(K.message,K.index,B),W)X=!0}).finally(()=>{U--,Y(),V()})};for(let K=0;K<J;K++)Y()})}}else{let Z=w?.concurrency??1,$=[...j.entries()],J=0;await new Promise((Q)=>{let U=()=>{if($.length===0&&J===0||X)Q()},z=()=>{if($.length===0||X){U();return}let V=$.shift();if(V===void 0){U();return}let[Y,K]=V;J++,this.send(K).then((B)=>{H[Y]={status:"sent",result:B},w?.onSuccess?.(K,Y,B)}).catch((B)=>{if(H[Y]={status:"failed",error:B},w?.onError?.(K,Y,B),W)X=!0}).finally(()=>{J--,z(),U()})};for(let V=0;V<Z;V++)z()})}let I=0,R=0;for(let Z of H){if(Z===void 0)continue;if(Z.status==="sent")I++;else R++}return{total:j.length,sent:I,failed:R,results:H}}verify(){if(this.transport.verify)return this.transport.verify();return Promise.resolve({ok:!0,provider:"mailer"})}close(){if(this.transport.close)return this.transport.close();return Promise.resolve()}}
+export{h as v,D as w};
+
+//# debugId=C3B38A0E65479A2E64756E2164756E21