sently 0.4.1 → 0.4.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.4.2] — 2026-05-30
+
+### Fixed
+
+- CI: replaced node -e dynamic import with scripts/smoke.mjs
+  (top-level await ESM) for reliable Node.js smoke testing
+- CI: integration test now imports from dist/index.js directly
+  instead of relying on package self-reference resolution
+- CI: updated GitHub Actions to latest patch versions
+
 ## [0.4.1] — 2026-05-30
 
 ### Fixed

package/README.md

@@ -1,6 +1,11 @@
 # sently
 
-**Runtime-agnostic email library for Node.js, Bun, Deno, and Cloudflare Workers.**
+> Nodemailer hasn't been updated in years, doesn't run on Bun or Deno, and ships at 220KB.
+> sently is the modern replacement — same familiar API, runs everywhere, tree-shakes to ~6KB.
+
+```bash
+bun add sently
+```
 
 [![npm version](https://img.shields.io/npm/v/sently.svg)](https://www.npmjs.com/package/sently)
 [![JSR](https://jsr.io/badges/@alialnaghmoush/sently)](https://jsr.io/@alialnaghmoush/sently)
@@ -11,17 +16,62 @@
 
 ---
 
-## Why sently
+## Why not Nodemailer?
+
+| Feature | Nodemailer | sently |
+|---------|-----------|--------|
+| Bundle size | ~220 KB | ~6 KB core |
+| Runtimes | Node.js only | Node, Bun, Deno, CF Workers |
+| Module format | CommonJS | ESM only |
+| Dependencies | 3 | 0 |
+| DKIM signing | ✓ via `nodemailer-dkim` | ✓ built-in (Web Crypto) |
+| OAuth2 / XOAUTH2 | ✓ via plugin | ✓ built-in |
+| Connection pooling | ✓ | ✓ |
+| HTTP transports | ✓ via plugins | ✓ built-in (6 providers) |
+| Retry transport | ✗ | ✓ |
+| Preview transport | ✗ | ✓ |
+| Template engine | ✗ | ✓ |
+| `sendBulk()` | ✗ | ✓ |
+| TypeScript | via `@types/nodemailer` | ✓ built-in |
+| Last release | 2021 | 2026 |
+
+---
+
+## The 30-second tour
+
+```typescript
+import { createMailer, type MailOptions } from "sently";
+import { ResendTransport } from "sently/transports/resend";
+import { PreviewTransport } from "sently/transports/preview";
+
+const addFooter = (options: MailOptions): MailOptions => ({
+  ...options,
+  html: (options.html ?? "") + '<p style="color:#999">Unsubscribe</p>',
+});
+
+// Swap providers without changing send code
+const mailer = await createMailer({
+  transport: new ResendTransport({ apiKey: process.env.RESEND_API_KEY! }),
+  plugins: [addFooter],
+});
 
-- **Works everywhere** — Node.js, Bun, Deno, Cloudflare Workers, and any environment with Web APIs
-- **True tree-shaking** — import only what you need; unused adapters and transports stay out of your bundle
-- **Zero dependencies in core** — MIME, SMTP protocol, and encoding use pure Web APIs only
-- **Plugin system** — transform `MailOptions` before send with composable middleware
-- **HTTP transports** — Resend, SendGrid, Postmark, Mailgun, AWS SES, and Brevo
-- **DKIM signing** — RSA-SHA256 and Ed25519-SHA256 via Web Crypto
-- **OAuth2 / XOAUTH2** — Gmail and Microsoft 365 SMTP auth with automatic token refresh
-- **Connection pooling** — reuse SMTP sessions with optional rate limiting
-- **TypeScript-first** — strict types, subpath exports, and full IDE support
+await mailer.send({
+  from: "you@example.com",
+  to: "recipient@example.com",
+  subject: "Hello from sently",
+  html: "<p>Hello!</p>",
+});
+
+// Bulk send with concurrency control
+await mailer.sendBulk(recipients, { concurrency: 5 });
+
+// Local dev — write to disk instead of sending
+const devMailer = await createMailer({
+  transport: process.env.CI
+    ? new ResendTransport({ apiKey: process.env.RESEND_API_KEY! })
+    : new PreviewTransport({ outDir: ".emails", open: true }),
+});
+```
 
 ---
 
@@ -228,63 +278,19 @@ const pool = new SMTPPool({
 
 ### HTTP APIs
 
-#### Resend
-
-```typescript
-import { ResendTransport } from "sently/transports/resend";
-
-const transport = new ResendTransport({ apiKey: "re_..." });
-```
-
-#### SendGrid
-
-```typescript
-import { SendGridTransport } from "sently/transports/sendgrid";
-
-const transport = new SendGridTransport({ apiKey: "SG...." });
-```
-
-#### Postmark
-
-```typescript
-import { PostmarkTransport } from "sently/transports/postmark";
-
-const transport = new PostmarkTransport({ serverToken: "..." });
-```
-
-#### Mailgun
-
-```typescript
-import { MailgunTransport } from "sently/transports/mailgun";
-
-const transport = new MailgunTransport({
-  apiKey: "key-...",
-  domain: "mg.example.com",
-});
-```
+| Transport | Import path | Required config |
+|-----------|-------------|-----------------|
+| Resend | `sently/transports/resend` | `apiKey` |
+| SendGrid | `sently/transports/sendgrid` | `apiKey` |
+| Postmark | `sently/transports/postmark` | `serverToken` |
+| Mailgun | `sently/transports/mailgun` | `apiKey`, `domain` |
+| AWS SES | `sently/transports/ses` | `accessKeyId`, `secretAccessKey`, `region` |
+| Brevo | `sently/transports/brevo` | `apiKey` |
 
-#### AWS SES
-
-```typescript
-import { SESTransport } from "sently/transports/ses";
-
-const transport = new SESTransport({
-  accessKeyId: process.env.AWS_ACCESS_KEY_ID!,
-  secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
-  region: "us-east-1",
-});
-```
+All transports implement the same interface — swap without changing your send code.
 
 Messages with attachments are sent as raw MIME (`Content.Raw`); simple messages use `Content.Simple`.
 
-#### Brevo
-
-```typescript
-import { BrevoTransport } from "sently/transports/brevo";
-
-const transport = new BrevoTransport({ apiKey: "xkeysib-..." });
-```
-
 ### PreviewTransport
 
 Write emails to disk during local development instead of sending them:
@@ -346,6 +352,38 @@ const result = await mailer.sendBulk(
 console.log(result.sent, result.failed);
 ```
 
+---
+
+## Plugin system
+
+Plugins transform `MailOptions` before the transport builds and sends the message. They run sequentially — each receives the output of the previous plugin.
+
+```typescript
+import { createMailer, type MailOptions } from "sently";
+
+const addFooter = (options: MailOptions) => ({
+  ...options,
+  html: (options.html ?? "") + '<p style="color:#999">Unsubscribe</p>',
+});
+
+const mailer = await createMailer({
+  host: "smtp.resend.com",
+  port: 465,
+  secure: true,
+  auth: { user: "resend", pass: process.env.RESEND_API_KEY! },
+  plugins: [addFooter],
+});
+```
+
+Works with SMTP config or custom transports:
+
+```typescript
+const mailer = await createMailer({
+  transport: new ResendTransport({ apiKey: "re_..." }),
+  plugins: [addFooter],
+});
+```
+
 ### TemplatePlugin
 
 Render HTML from named templates with zero dependencies:
@@ -378,36 +416,6 @@ await mailer.send({
 
 Use a custom engine by passing any `(template, data) => string` function to `templatePlugin`.
 
-### Plugin system
-
-Plugins transform `MailOptions` before the transport builds and sends the message. They run sequentially — each receives the output of the previous plugin.
-
-```typescript
-import { createMailer, type MailOptions } from "sently";
-
-const addFooter = (options: MailOptions) => ({
-  ...options,
-  html: (options.html ?? "") + '<p style="color:#999">Unsubscribe</p>',
-});
-
-const mailer = await createMailer({
-  host: "smtp.resend.com",
-  port: 465,
-  secure: true,
-  auth: { user: "resend", pass: process.env.RESEND_API_KEY! },
-  plugins: [addFooter],
-});
-```
-
-Works with SMTP config or custom transports:
-
-```typescript
-const mailer = await createMailer({
-  transport: new ResendTransport({ apiKey: "re_..." }),
-  plugins: [addFooter],
-});
-```
-
 ---
 
 ## MailOptions Reference
@@ -469,6 +477,35 @@ On Cloudflare Workers and browsers, use `content: Uint8Array` — `attachment.pa
 
 ---
 
+## Error Handling
+
+```typescript
+import { SMTPError } from "sently";
+import { ResendError } from "sently/transports/resend";
+// Each HTTP transport exports its own error class:
+// SendGridError  → sently/transports/sendgrid
+// PostmarkError  → sently/transports/postmark
+// MailgunError   → sently/transports/mailgun
+// SESError       → sently/transports/ses
+// BrevoError     → sently/transports/brevo
+
+try {
+  await mailer.send({ ... });
+} catch (err) {
+  if (err instanceof SMTPError) {
+    console.error(err.code);     // SMTP response code, e.g. 550
+    console.error(err.command);  // failed command, e.g. "RCPT TO"
+  }
+  if (err instanceof ResendError) {
+    console.error(err.statusCode); // HTTP status code
+  }
+}
+```
+
+Import error classes from their transport subpath — not from `sently` core. Each exports a `statusCode` property on HTTP failures.
+
+---
+
 ## Tree-Shaking
 
 Each import path is a separate build entry point:
@@ -518,6 +555,24 @@ Approximate gzip sizes per subpath export:
 | `sently/adapters/deno` | ~2 KB |
 | `sently/adapters/cf` | ~2 KB |
 
+> **Example:** Resend only = core (~6 KB) + transport (~2 KB) = **~8 KB total**. Nodemailer ships 220 KB regardless of which transport you use.
+
+---
+
+## TypeScript
+
+```typescript
+import type {
+  MailOptions,
+  MailPlugin,
+  SendResult,
+  Attachment,
+  SMTPConfig,
+} from "sently";
+```
+
+All types ship with the package — no separate `@types/` install needed.
+
 ---
 
 ## Links

package/dist/{chunk-z3eq2t1d.js → chunk-8sm0vz0n.js}

@@ -1,3 +1,6 @@
+import {
+  OAuth2Client
+} from "./chunk-ym3zzv8b.js";
 import {
   buildMIME
 } from "./chunk-j6qw8ms6.js";
@@ -13,10 +16,7 @@ import {
   parseEHLO,
   parseResponse,
   selectAuthMethod
-} from "./chunk-tjsgb3qb.js";
-import {
-  OAuth2Client
-} from "./chunk-ym3zzv8b.js";
+} from "./chunk-sbydk09g.js";
 import {
   resolveAttachments
 } from "./chunk-bvxkmq94.js";
@@ -100,7 +100,8 @@ async function openSMTPSession(adapter, config) {
   const greeting = await readSMTPResponse(adapter);
   assertResponse(greeting, [220], "greeting");
   let capabilities = await ehlo(adapter, config.host);
-  if (!config.secure && !adapter.secure) {
+  const supportsStartTls = capabilities.some((cap) => cap.toUpperCase() === "STARTTLS");
+  if (!config.secure && !adapter.secure && supportsStartTls) {
     await sendRaw(adapter, encodeCommand({ type: "STARTTLS" }));
     const starttlsResp = await readSMTPResponse(adapter);
     assertResponse(starttlsResp, [220], "STARTTLS");
@@ -241,4 +242,4 @@ async function resolveMX(domain) {
 }
 export { SMTPTransport, resolveSMTPConfig, openSMTPSession, deliverSMTPMessage, closeSMTPSession, readSMTPResponse };
 
-//# debugId=58BDA0CC5C272AF664756E2164756E21
+//# debugId=44FB4148CD9604AA64756E2164756E21

package/dist/chunk-8sm0vz0n.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\";\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  private readonly config: ResolvedSMTPConfig;\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  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  host: string;\n  port: number;\n  secure: boolean;\n  auth?: SMTPConfig[\"auth\"];\n  tls?: SMTPConfig[\"tls\"];\n  dkim?: SMTPConfig[\"dkim\"];\n  connectionTimeout?: number;\n  greetingTimeout?: number;\n  socketTimeout?: number;\n  direct?: boolean;\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.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    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\n/** @internal Test helper for raw line writes. */\nexport { encodeLine, readSMTPResponse };\n"
+  ],
+  "mappings": "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",
+  "debugId": "44FB4148CD9604AA64756E2164756E21",
+  "names": []
+}

package/dist/chunk-bfrvnqhq.js

@@ -0,0 +1,270 @@
+import {
+  closeSMTPSession,
+  deliverSMTPMessage,
+  openSMTPSession,
+  resolveSMTPConfig
+} from "./chunk-8sm0vz0n.js";
+import {
+  buildMIME
+} from "./chunk-j6qw8ms6.js";
+import {
+  resolveAttachments
+} from "./chunk-bvxkmq94.js";
+
+// src/pool/connection.ts
+async function createPooledConnection(options) {
+  const config = resolveSMTPConfig(options.config);
+  const adapter = await options.createAdapter();
+  await adapter.connect(options.connectHost, config.port);
+  await openSMTPSession(adapter, config);
+  let messageCount = 0;
+  let idle = true;
+  let sendChain = Promise.resolve();
+  const maxMessages = options.maxMessages;
+  return {
+    get idle() {
+      return idle;
+    },
+    get messageCount() {
+      return messageCount;
+    },
+    get usable() {
+      return messageCount < maxMessages;
+    },
+    async send(mailOptions) {
+      const run = async () => {
+        idle = false;
+        try {
+          const resolvedOptions = {
+            ...mailOptions,
+            attachments: await resolveAttachments(mailOptions.attachments)
+          };
+          const mime = await buildMIME(resolvedOptions, config.dkim);
+          const result = await deliverSMTPMessage(adapter, mime);
+          messageCount += 1;
+          return result;
+        } finally {
+          idle = true;
+        }
+      };
+      const resultPromise = sendChain.then(run);
+      sendChain = resultPromise.then(() => {
+        return;
+      }, () => {
+        return;
+      });
+      return resultPromise;
+    },
+    async close() {
+      await sendChain;
+      await closeSMTPSession(adapter);
+    }
+  };
+}
+
+// src/pool/pool.ts
+class RateLimiter {
+  rateDelta;
+  rateLimit;
+  now;
+  tokens;
+  lastRefill;
+  waiters = [];
+  constructor(rateDelta, rateLimit, now = Date.now) {
+    this.rateDelta = rateDelta;
+    this.rateLimit = rateLimit;
+    this.now = now;
+    this.tokens = rateDelta;
+    this.lastRefill = now();
+  }
+  async acquire() {
+    for (;; ) {
+      this.refill();
+      if (this.tokens > 0) {
+        this.tokens -= 1;
+        return;
+      }
+      await new Promise((resolve) => {
+        this.waiters.push(resolve);
+      });
+    }
+  }
+  notify() {
+    this.refill();
+  }
+  refill() {
+    const t = this.now();
+    const elapsed = t - this.lastRefill;
+    if (elapsed >= this.rateLimit) {
+      const periods = Math.floor(elapsed / this.rateLimit);
+      this.tokens = Math.min(this.rateDelta, this.tokens + periods * this.rateDelta);
+      this.lastRefill += periods * this.rateLimit;
+      while (this.tokens > 0 && this.waiters.length > 0) {
+        this.tokens -= 1;
+        const next = this.waiters.shift();
+        next?.();
+      }
+    }
+  }
+}
+
+class SMTPPool {
+  config;
+  maxConnections;
+  maxMessages;
+  createAdapterFn;
+  rateLimiter;
+  connections = [];
+  queue = [];
+  draining = false;
+  closed = false;
+  processChain = Promise.resolve();
+  constructor(config, options) {
+    this.config = config;
+    this.maxConnections = config.maxConnections ?? 5;
+    this.maxMessages = config.maxMessages ?? 100;
+    if (options?.createAdapter) {
+      const factory = options.createAdapter;
+      this.createAdapterFn = async () => factory();
+    } else if (config.adapter) {
+      this.createAdapterFn = async () => config.adapter;
+    } else {
+      throw new Error("SMTPPool requires config.adapter or options.createAdapter");
+    }
+    if (config.rateDelta !== undefined && config.rateDelta > 0) {
+      this.rateLimiter = new RateLimiter(config.rateDelta, config.rateLimit ?? 1000, options?.now);
+    } else {
+      this.rateLimiter = null;
+    }
+  }
+  async send(options) {
+    if (this.draining) {
+      throw new Error("SMTPPool is closing — no new messages accepted");
+    }
+    if (this.closed) {
+      throw new Error("SMTPPool is closed");
+    }
+    if (this.rateLimiter) {
+      await this.rateLimiter.acquire();
+    }
+    return new Promise((resolve, reject) => {
+      this.queue.push({ options, resolve, reject });
+      this.scheduleProcess();
+    });
+  }
+  scheduleProcess() {
+    this.processChain = this.processChain.then(() => this.processQueue()).catch(() => {
+      return;
+    });
+  }
+  async verify() {
+    try {
+      const conn = await this.spawnConnection();
+      try {
+        return { ok: true, provider: "smtp-pool" };
+      } finally {
+        await conn.close();
+        this.removeConnection(conn);
+      }
+    } catch (err) {
+      return {
+        ok: false,
+        provider: "smtp-pool",
+        message: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+  async close() {
+    this.draining = true;
+    await this.drainQueue();
+    await Promise.allSettled(this.connections.map((c) => c.close()));
+    this.connections.length = 0;
+    this.closed = true;
+  }
+  get connectionCount() {
+    return this.connections.length;
+  }
+  get queueSize() {
+    return this.queue.length;
+  }
+  async processQueue() {
+    if (this.draining) {
+      return;
+    }
+    while (this.queue.length > 0) {
+      const idleConn = this.connections.find((c) => c.idle && c.usable);
+      if (idleConn) {
+        const entry = this.queue.shift();
+        if (!entry) {
+          break;
+        }
+        try {
+          const result = await idleConn.send(entry.options);
+          entry.resolve(result);
+          if (!idleConn.usable) {
+            await idleConn.close();
+            this.removeConnection(idleConn);
+          }
+        } catch (err) {
+          entry.reject(err);
+          await idleConn.close().catch(() => {
+            return;
+          });
+          this.removeConnection(idleConn);
+        }
+        continue;
+      }
+      if (this.connections.length < this.maxConnections) {
+        const entry = this.queue.shift();
+        if (!entry) {
+          break;
+        }
+        const conn = await this.spawnConnection();
+        try {
+          const result = await conn.send(entry.options);
+          entry.resolve(result);
+          if (!conn.usable) {
+            await conn.close();
+            this.removeConnection(conn);
+          }
+        } catch (err) {
+          entry.reject(err);
+          await conn.close().catch(() => {
+            return;
+          });
+          this.removeConnection(conn);
+        }
+        continue;
+      }
+      break;
+    }
+  }
+  async spawnConnection() {
+    const resolved = resolveSMTPConfig(this.config);
+    const conn = await createPooledConnection({
+      config: this.config,
+      maxMessages: this.maxMessages,
+      connectHost: resolved.host,
+      createAdapter: this.createAdapterFn
+    });
+    this.connections.push(conn);
+    return conn;
+  }
+  removeConnection(conn) {
+    const index = this.connections.indexOf(conn);
+    if (index >= 0) {
+      this.connections.splice(index, 1);
+    }
+  }
+  async drainQueue() {
+    while (this.queue.length > 0 || this.connections.some((c) => !c.idle)) {
+      await this.processQueue();
+      if (this.queue.length > 0) {
+        await new Promise((r) => setTimeout(r, 10));
+      }
+    }
+  }
+}
+export { RateLimiter, SMTPPool };
+
+//# debugId=D47B35696A356F3464756E2164756E21