sently 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sendx contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,367 @@
+# sently
+
+**Runtime-agnostic email library for Node.js, Bun, Deno, and Cloudflare Workers.**
+
+[![npm version](https://img.shields.io/npm/v/sently.svg)](https://www.npmjs.com/package/sently)
+[![JSR](https://jsr.io/badges/@sently/sently)](https://jsr.io/@sently/sently)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/sently)](https://bundlephobia.com/package/sently)
+[![license](https://img.shields.io/npm/l/sently.svg)](LICENSE)
+[![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)
+
+---
+
+## Why sently
+
+- **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
+- **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
+
+---
+
+## Installation
+
+**npm** ([sently](https://www.npmjs.com/package/sently)):
+
+```bash
+bun add sently
+npm install sently
+pnpm add sently
+```
+
+**JSR** ([@sently/sently](https://jsr.io/@sently/sently)) — Deno, Bun, and other JSR-aware runtimes:
+
+```bash
+deno add jsr:@sently/sently
+bunx jsr add @sently/sently
+```
+
+```typescript
+import { createMailer } from "sently";
+```
+
+---
+
+## Quick Start
+
+### SMTP with auto-detected adapter
+
+```typescript
+import { createMailer } from "sently";
+
+const mailer = await createMailer({
+  host: "smtp.example.com",
+  port: 587,
+  auth: { user: "you@example.com", pass: "secret" },
+});
+
+await mailer.send({
+  from: "you@example.com",
+  to: "recipient@example.com",
+  subject: "Hello from sently",
+  text: "Plain text body",
+  html: "<p>HTML body</p>",
+});
+
+await mailer.close();
+```
+
+### Resend HTTP transport (Vercel Edge compatible)
+
+```typescript
+import { createMailer } from "sently";
+import { ResendTransport } from "sently/transports/resend";
+
+const mailer = await createMailer({
+  transport: new ResendTransport({ apiKey: process.env.RESEND_API_KEY! }),
+});
+
+await mailer.send({
+  from: "onboarding@yourdomain.com",
+  to: "recipient@example.com",
+  subject: "Hello from the edge",
+  html: "<p>Sent via Resend + sently</p>",
+});
+```
+
+### Cloudflare Worker
+
+```typescript
+import { createMailer } from "sently";
+import { CloudflareAdapter } from "sently/adapters/cf";
+
+export default {
+  async fetch() {
+    const mailer = await createMailer({
+      host: "smtp.example.com",
+      port: 587,
+      auth: { user: "relay@example.com", pass: "secret" },
+      adapter: new CloudflareAdapter(),
+    });
+
+    await mailer.send({
+      from: "relay@example.com",
+      to: "user@example.com",
+      subject: "From a Worker",
+      text: "Hello from Cloudflare Workers",
+    });
+
+    return new Response("Sent");
+  },
+};
+```
+
+---
+
+## Adapters
+
+| Runtime | Import | Notes |
+|---------|--------|-------|
+| Node.js (auto) | `createMailer(config)` | Auto-detected |
+| Node.js (explicit) | `sently/adapters/node` → `NodeAdapter` | Reference implementation |
+| Bun (auto) | `createMailer(config)` | Auto-detected |
+| 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 { NodeAdapter } from "sently/adapters/node";
+
+const mailer = await createMailer({
+  host: "smtp.example.com",
+  adapter: new NodeAdapter({ secure: false }),
+  auth: { user: "you@example.com", pass: "secret" },
+});
+```
+
+---
+
+## Transports
+
+### SMTP
+
+```typescript
+import { createMailer } from "sently";
+import { SMTPTransport } from "sently/transports/smtp";
+import { NodeAdapter } from "sently/adapters/node";
+
+const transport = new SMTPTransport({
+  host: "smtp.example.com",
+  port: 587,
+  auth: { user: "you@example.com", pass: "secret" },
+  adapter: new NodeAdapter(),
+});
+
+const mailer = await createMailer({ transport });
+await mailer.verify(); // test connection + auth
+```
+
+**AUTH methods:** XOAUTH2, CRAM-MD5, LOGIN, and PLAIN (auto-negotiated from EHLO unless `auth.type` is set).
+
+#### DKIM signing
+
+```typescript
+const mailer = await createMailer({
+  host: "smtp.example.com",
+  auth: { user: "you@example.com", pass: "secret" },
+  dkim: {
+    domainName: "example.com",
+    keySelector: "2024",
+    privateKey: await Bun.file("dkim-private.pem").text(),
+  },
+});
+```
+
+#### Gmail OAuth2 (XOAUTH2)
+
+```typescript
+import { OAuth2Client } from "sently/auth/oauth2";
+
+const mailer = await createMailer({
+  host: "smtp.gmail.com",
+  port: 465,
+  secure: true,
+  auth: {
+    type: "OAUTH2",
+    user: "me@gmail.com",
+    oauth2: {
+      user: "me@gmail.com",
+      clientId: process.env.GOOGLE_CLIENT_ID!,
+      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+      refreshToken: process.env.GOOGLE_REFRESH_TOKEN!,
+    },
+  },
+});
+```
+
+#### Connection pooling
+
+```typescript
+const mailer = await createMailer({
+  host: "smtp.example.com",
+  pool: true,
+  maxConnections: 5,
+  maxMessages: 100,
+  rateDelta: 10,
+  rateLimit: 1000,
+  auth: { user: "you@example.com", pass: "secret" },
+});
+```
+
+Or use `SMTPPool` directly:
+
+```typescript
+import { SMTPPool } from "sently/pool";
+
+const pool = new SMTPPool({
+  host: "smtp.example.com",
+  adapter: new NodeAdapter(),
+  auth: { user: "you@example.com", pass: "secret" },
+});
+```
+
+### 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: "..." });
+```
+
+---
+
+## MailOptions Reference
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `from` | `AddressInput` | *required* | Sender address |
+| `to` | `AddressInput` | *required* | Recipients |
+| `cc` | `AddressInput` | — | CC recipients (visible in headers) |
+| `bcc` | `AddressInput` | — | BCC recipients (envelope only, not in headers) |
+| `replyTo` | `AddressInput` | — | Reply-To header |
+| `subject` | `string` | *required* | Email subject (RFC 2047 for non-ASCII) |
+| `text` | `string` | — | Plain text body |
+| `html` | `string` | — | HTML body |
+| `attachments` | `Attachment[]` | — | File attachments |
+| `headers` | `Record<string, string>` | — | Custom headers |
+| `messageId` | `string` | auto | Message-ID header |
+| `date` | `Date` | now | Date header |
+| `priority` | `'high' \| 'normal' \| 'low'` | — | X-Priority / Importance |
+| `encoding` | `'utf-8' \| 'ascii'` | `'utf-8'` | Character encoding hint |
+
+---
+
+## Attachments
+
+### In-memory (all runtimes)
+
+```typescript
+await mailer.send({
+  from: "you@example.com",
+  to: "user@example.com",
+  subject: "With attachment",
+  text: "See attached",
+  attachments: [
+    {
+      filename: "report.pdf",
+      content: pdfBytes, // Uint8Array
+      contentType: "application/pdf",
+    },
+  ],
+});
+```
+
+### File path (Node.js / Bun / Deno only)
+
+```typescript
+attachments: [
+  {
+    filename: "report.pdf",
+    path: "/path/to/report.pdf",
+  },
+],
+```
+
+On Cloudflare Workers and browsers, use `content: Uint8Array` — `attachment.path` is not supported.
+
+---
+
+## Tree-Shaking
+
+Each import path is a separate build entry point:
+
+```
+import { createMailer } from "sently"
++ import { ResendTransport } from "sently/transports/resend"
+→ Bundle: core/mime (~8KB) + core/address (~2KB) + transports/resend (~2KB) ≈ ~12KB gzip
+
+vs. full Nodemailer: ~220KB
+```
+
+Only code you import is bundled. Adapters and transports you never import are never included.
+
+---
+
+## Migrating from Nodemailer
+
+| Nodemailer | sently |
+|------------|-------|
+| `nodemailer.createTransport({...})` | `await createMailer({...})` |
+| `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'` |
+| CommonJS | ESM only |
+| Node.js only | Node, Bun, Deno, CF Workers |
+
+---
+
+## Bundle Size
+
+Approximate gzip sizes per subpath export:
+
+| Export | ~gzip |
+|--------|-------|
+| `sently` | ~6 KB |
+| `sently/transports/smtp` | ~10 KB |
+| `sently/transports/resend` | ~2 KB |
+| `sently/transports/sendgrid` | ~2 KB |
+| `sently/transports/postmark` | ~2 KB |
+| `sently/adapters/node` | ~3 KB |
+| `sently/adapters/bun` | ~3 KB |
+| `sently/adapters/deno` | ~2 KB |
+| `sently/adapters/cf` | ~2 KB |
+
+---
+
+## Links
+
+- **Source & issues:** [github.com/alialnaghmoush/sently](https://github.com/alialnaghmoush/sently)
+- **npm:** [npmjs.com/package/sently](https://www.npmjs.com/package/sently)
+- **JSR:** [jsr.io/@sently/sently](https://jsr.io/@sently/sently)
+
+## License
+
+MIT

package/dist/chunk-794hc3m4.js

@@ -0,0 +1,105 @@
+// src/core/base64.ts
+var BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+var BASE64_LINE_LENGTH = 76;
+var encoder = new TextEncoder;
+var decoder = new TextDecoder;
+function encodeBase64(data) {
+  const bytes = typeof data === "string" ? encoder.encode(data) : data;
+  let result = "";
+  let i = 0;
+  while (i < bytes.length) {
+    const b0 = bytes[i] ?? 0;
+    const b1 = bytes[i + 1];
+    const b2 = bytes[i + 2];
+    if (b1 === undefined) {
+      result += BASE64_CHARS[b0 >> 2];
+      result += BASE64_CHARS[(b0 & 3) << 4];
+      result += "==";
+      break;
+    }
+    if (b2 === undefined) {
+      result += BASE64_CHARS[b0 >> 2];
+      result += BASE64_CHARS[(b0 & 3) << 4 | b1 >> 4];
+      result += BASE64_CHARS[(b1 & 15) << 2];
+      result += "=";
+      break;
+    }
+    result += BASE64_CHARS[b0 >> 2];
+    result += BASE64_CHARS[(b0 & 3) << 4 | b1 >> 4];
+    result += BASE64_CHARS[(b1 & 15) << 2 | b2 >> 6];
+    result += BASE64_CHARS[b2 & 63];
+    i += 3;
+  }
+  return wrapBase64Lines(result);
+}
+function decodeBase64(data) {
+  const cleaned = data.replace(/\s/g, "");
+  const len = cleaned.length;
+  if (len === 0) {
+    return new Uint8Array(0);
+  }
+  if (len % 4 !== 0) {
+    throw new Error("Invalid base64 string length");
+  }
+  const padding = cleaned.endsWith("==") ? 2 : cleaned.endsWith("=") ? 1 : 0;
+  const outputLen = len * 3 / 4 - padding;
+  const output = new Uint8Array(outputLen);
+  let outIndex = 0;
+  for (let i = 0;i < len; i += 4) {
+    const c0 = base64CharToValue(cleaned[i] ?? "=");
+    const c1 = base64CharToValue(cleaned[i + 1] ?? "=");
+    const c2 = base64CharToValue(cleaned[i + 2] ?? "=");
+    const c3 = base64CharToValue(cleaned[i + 3] ?? "=");
+    const triple = c0 << 18 | c1 << 12 | c2 << 6 | c3;
+    if (outIndex < outputLen) {
+      output[outIndex++] = triple >> 16 & 255;
+    }
+    if (outIndex < outputLen) {
+      output[outIndex++] = triple >> 8 & 255;
+    }
+    if (outIndex < outputLen) {
+      output[outIndex++] = triple & 255;
+    }
+  }
+  return output;
+}
+function encodeHeader(value) {
+  if (!needsEncoding(value)) {
+    return value;
+  }
+  const encoded = encodeBase64(value).replace(/\r\n/g, "");
+  return `=?UTF-8?B?${encoded}?=`;
+}
+function needsEncoding(text) {
+  for (let i = 0;i < text.length; i++) {
+    if (text.charCodeAt(i) > 127) {
+      return true;
+    }
+  }
+  return false;
+}
+function base64CharToValue(char) {
+  if (char === "=") {
+    return 0;
+  }
+  const index = BASE64_CHARS.indexOf(char);
+  if (index === -1) {
+    throw new Error(`Invalid base64 character: ${char}`);
+  }
+  return index;
+}
+function wrapBase64Lines(base64) {
+  const lines = [];
+  for (let i = 0;i < base64.length; i += BASE64_LINE_LENGTH) {
+    lines.push(base64.slice(i, i + BASE64_LINE_LENGTH));
+  }
+  return lines.join(`\r
+`);
+}
+function encodeUtf8(text) {
+  return encoder.encode(text);
+}
+
+export { encodeBase64, decodeBase64, encodeHeader, encodeUtf8 };
+
+//# debugId=93C9FABDDF825C4864756E2164756E21

package/dist/chunk-794hc3m4.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/base64.ts"],
+  "sourcesContent": [
+    "// src/core/base64.ts\n\nconst BASE64_CHARS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/\";\nconst BASE64_LINE_LENGTH = 76;\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\n\n/**\n * Encode a Uint8Array or string to Base64.\n * Uses TextEncoder + manual base64 to support binary data correctly.\n */\nexport function encodeBase64(data: Uint8Array | string): string {\n  const bytes = typeof data === \"string\" ? encoder.encode(data) : data;\n  let result = \"\";\n  let i = 0;\n\n  while (i < bytes.length) {\n    const b0 = bytes[i] ?? 0;\n    const b1 = bytes[i + 1];\n    const b2 = bytes[i + 2];\n\n    if (b1 === undefined) {\n      result += BASE64_CHARS[b0 >> 2];\n      result += BASE64_CHARS[(b0 & 0x03) << 4];\n      result += \"==\";\n      break;\n    }\n\n    if (b2 === undefined) {\n      result += BASE64_CHARS[b0 >> 2];\n      result += BASE64_CHARS[((b0 & 0x03) << 4) | (b1 >> 4)];\n      result += BASE64_CHARS[(b1 & 0x0f) << 2];\n      result += \"=\";\n      break;\n    }\n\n    result += BASE64_CHARS[b0 >> 2];\n    result += BASE64_CHARS[((b0 & 0x03) << 4) | (b1 >> 4)];\n    result += BASE64_CHARS[((b1 & 0x0f) << 2) | (b2 >> 6)];\n    result += BASE64_CHARS[b2 & 0x3f];\n    i += 3;\n  }\n\n  return wrapBase64Lines(result);\n}\n\n/**\n * Decode a Base64 string to Uint8Array.\n */\nexport function decodeBase64(data: string): Uint8Array {\n  const cleaned = data.replace(/\\s/g, \"\");\n  const len = cleaned.length;\n\n  if (len === 0) {\n    return new Uint8Array(0);\n  }\n\n  if (len % 4 !== 0) {\n    throw new Error(\"Invalid base64 string length\");\n  }\n\n  const padding = cleaned.endsWith(\"==\") ? 2 : cleaned.endsWith(\"=\") ? 1 : 0;\n  const outputLen = (len * 3) / 4 - padding;\n  const output = new Uint8Array(outputLen);\n\n  let outIndex = 0;\n  for (let i = 0; i < len; i += 4) {\n    const c0 = base64CharToValue(cleaned[i] ?? \"=\");\n    const c1 = base64CharToValue(cleaned[i + 1] ?? \"=\");\n    const c2 = base64CharToValue(cleaned[i + 2] ?? \"=\");\n    const c3 = base64CharToValue(cleaned[i + 3] ?? \"=\");\n    const triple = (c0 << 18) | (c1 << 12) | (c2 << 6) | c3;\n\n    if (outIndex < outputLen) {\n      output[outIndex++] = (triple >> 16) & 0xff;\n    }\n    if (outIndex < outputLen) {\n      output[outIndex++] = (triple >> 8) & 0xff;\n    }\n    if (outIndex < outputLen) {\n      output[outIndex++] = triple & 0xff;\n    }\n  }\n\n  return output;\n}\n\n/**\n * Encode text using Quoted-Printable (RFC 2045).\n */\nexport function encodeQP(text: string): string {\n  const bytes = encoder.encode(text);\n  const lines: string[] = [];\n  let line = \"\";\n\n  for (let i = 0; i < bytes.length; i++) {\n    const byte = bytes[i] ?? 0;\n\n    if (byte === 0x0a) {\n      lines.push(line);\n      line = \"\";\n      continue;\n    }\n\n    if (byte === 0x0d) {\n      continue;\n    }\n\n    let encoded: string;\n    if (\n      (byte >= 33 && byte <= 60) ||\n      (byte >= 62 && byte <= 126) ||\n      byte === 0x09 ||\n      byte === 0x20\n    ) {\n      encoded = String.fromCharCode(byte);\n    } else {\n      encoded = `=${byte.toString(16).toUpperCase().padStart(2, \"0\")}`;\n    }\n\n    if (line.length + encoded.length > 75) {\n      lines.push(`${line}=`);\n      line = encoded;\n    } else {\n      line += encoded;\n    }\n  }\n\n  if (line.length > 0) {\n    lines.push(line);\n  }\n\n  return lines.join(\"\\r\\n\");\n}\n\n/**\n * Encode an email header value per RFC 2047.\n * Non-ASCII values become: =?UTF-8?B?<base64>?=\n */\nexport function encodeHeader(value: string): string {\n  if (!needsEncoding(value)) {\n    return value;\n  }\n\n  const encoded = encodeBase64(value).replace(/\\r\\n/g, \"\");\n  return `=?UTF-8?B?${encoded}?=`;\n}\n\n/**\n * Returns true if the string contains non-ASCII characters\n * and therefore requires RFC 2047 encoding in headers.\n */\nexport function needsEncoding(text: string): boolean {\n  for (let i = 0; i < text.length; i++) {\n    if (text.charCodeAt(i) > 127) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction base64CharToValue(char: string): number {\n  if (char === \"=\") {\n    return 0;\n  }\n  const index = BASE64_CHARS.indexOf(char);\n  if (index === -1) {\n    throw new Error(`Invalid base64 character: ${char}`);\n  }\n  return index;\n}\n\nfunction wrapBase64Lines(base64: string): string {\n  const lines: string[] = [];\n  for (let i = 0; i < base64.length; i += BASE64_LINE_LENGTH) {\n    lines.push(base64.slice(i, i + BASE64_LINE_LENGTH));\n  }\n  return lines.join(\"\\r\\n\");\n}\n\n/** Decode bytes to UTF-8 string. */\nexport function decodeUtf8(bytes: Uint8Array): string {\n  return decoder.decode(bytes);\n}\n\n/** Encode string to UTF-8 bytes. */\nexport function encodeUtf8(text: string): Uint8Array {\n  return encoder.encode(text);\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "93C9FABDDF825C4864756E2164756E21",
+  "names": []
+}

package/dist/chunk-hdqpvsm8.js

@@ -0,0 +1,116 @@
+import {
+  encodeHeader
+} from "./chunk-794hc3m4.js";
+import {
+  __require
+} from "./chunk-v0bahtg2.js";
+
+// src/core/address.ts
+function parseAddresses(input) {
+  if (Array.isArray(input)) {
+    return input.flatMap((item) => parseAddresses(item));
+  }
+  if (typeof input === "object") {
+    return [{ ...input }];
+  }
+  const trimmed = input.trim();
+  if (!trimmed) {
+    return [];
+  }
+  return splitAddressList(trimmed).map(parseSingleAddress);
+}
+function toMIMEHeader(address) {
+  if (address.name) {
+    const name = encodeHeader(address.name);
+    return `${name} <${address.address}>`;
+  }
+  return address.address;
+}
+function extractEmails(input) {
+  return parseAddresses(input).map((addr) => addr.address);
+}
+function splitAddressList(input) {
+  const parts = [];
+  let current = "";
+  let inQuotes = false;
+  let inAngle = false;
+  for (let i = 0;i < input.length; i++) {
+    const char = input[i] ?? "";
+    if (char === '"' && input[i - 1] !== "\\") {
+      inQuotes = !inQuotes;
+      current += char;
+      continue;
+    }
+    if (char === "<" && !inQuotes) {
+      inAngle = true;
+      current += char;
+      continue;
+    }
+    if (char === ">" && !inQuotes) {
+      inAngle = false;
+      current += char;
+      continue;
+    }
+    if (char === "," && !inQuotes && !inAngle) {
+      if (current.trim()) {
+        parts.push(current.trim());
+      }
+      current = "";
+      continue;
+    }
+    current += char;
+  }
+  if (current.trim()) {
+    parts.push(current.trim());
+  }
+  return parts;
+}
+function parseSingleAddress(input) {
+  const trimmed = input.trim();
+  const angleMatch = trimmed.match(/^(?:"([^"]*)"|([^<]*?))\s*<([^>]+)>$/);
+  if (angleMatch) {
+    const name = (angleMatch[1] ?? angleMatch[2] ?? "").trim();
+    const address = (angleMatch[3] ?? "").trim();
+    if (name) {
+      return { name, address };
+    }
+    return { address };
+  }
+  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+    return { address: trimmed.slice(1, -1) };
+  }
+  return { address: trimmed };
+}
+
+// src/transports/resolve-attachments.ts
+async function resolveAttachments(attachments = []) {
+  const resolved = [];
+  for (const attachment of attachments) {
+    if (attachment.content instanceof Uint8Array) {
+      resolved.push(attachment);
+      continue;
+    }
+    if (attachment.path) {
+      let fs;
+      try {
+        fs = await import("node:fs/promises");
+      } catch {
+        throw new Error("attachment.path is not supported on this runtime — use attachment.content (Uint8Array) instead");
+      }
+      const data = await fs.readFile(attachment.path);
+      const { path: _path, ...rest } = attachment;
+      resolved.push({ ...rest, content: new Uint8Array(data) });
+      continue;
+    }
+    if (typeof attachment.content === "string") {
+      resolved.push(attachment);
+      continue;
+    }
+    resolved.push(attachment);
+  }
+  return resolved;
+}
+
+export { parseAddresses, toMIMEHeader, extractEmails, resolveAttachments };
+
+//# debugId=85211AC1FC8A34D664756E2164756E21

package/dist/chunk-hdqpvsm8.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/address.ts", "../src/transports/resolve-attachments.ts"],
+  "sourcesContent": [
+    "// src/core/address.ts\nimport { encodeHeader } from \"./base64.js\";\nimport type { Address, AddressInput } from \"./types.js\";\n\n/**\n * Normalize any AddressInput form into Address[].\n */\nexport function parseAddresses(input: AddressInput): Address[] {\n  if (Array.isArray(input)) {\n    return input.flatMap((item) => parseAddresses(item));\n  }\n\n  if (typeof input === \"object\") {\n    return [{ ...input }];\n  }\n\n  const trimmed = input.trim();\n  if (!trimmed) {\n    return [];\n  }\n\n  return splitAddressList(trimmed).map(parseSingleAddress);\n}\n\n/**\n * Format an Address for SMTP envelope commands (MAIL FROM / RCPT TO).\n */\nexport function toEnvelope(address: Address): string {\n  return address.address;\n}\n\n/**\n * Format an Address for use in a MIME header (From, To, CC, etc.).\n */\nexport function toMIMEHeader(address: Address): string {\n  if (address.name) {\n    const name = encodeHeader(address.name);\n    return `${name} <${address.address}>`;\n  }\n  return address.address;\n}\n\n/**\n * Extract plain email strings from any AddressInput.\n */\nexport function extractEmails(input: AddressInput): string[] {\n  return parseAddresses(input).map((addr) => addr.address);\n}\n\n/**\n * Basic email format validation (format only, no DNS lookup).\n */\nexport function isValidEmail(email: string): boolean {\n  return /^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$/.test(email);\n}\n\nfunction splitAddressList(input: string): string[] {\n  const parts: string[] = [];\n  let current = \"\";\n  let inQuotes = false;\n  let inAngle = false;\n\n  for (let i = 0; i < input.length; i++) {\n    const char = input[i] ?? \"\";\n    if (char === '\"' && input[i - 1] !== \"\\\\\") {\n      inQuotes = !inQuotes;\n      current += char;\n      continue;\n    }\n    if (char === \"<\" && !inQuotes) {\n      inAngle = true;\n      current += char;\n      continue;\n    }\n    if (char === \">\" && !inQuotes) {\n      inAngle = false;\n      current += char;\n      continue;\n    }\n    if (char === \",\" && !inQuotes && !inAngle) {\n      if (current.trim()) {\n        parts.push(current.trim());\n      }\n      current = \"\";\n      continue;\n    }\n    current += char;\n  }\n\n  if (current.trim()) {\n    parts.push(current.trim());\n  }\n\n  return parts;\n}\n\nfunction parseSingleAddress(input: string): Address {\n  const trimmed = input.trim();\n\n  const angleMatch = trimmed.match(/^(?:\"([^\"]*)\"|([^<]*?))\\s*<([^>]+)>$/);\n  if (angleMatch) {\n    const name = (angleMatch[1] ?? angleMatch[2] ?? \"\").trim();\n    const address = (angleMatch[3] ?? \"\").trim();\n    if (name) {\n      return { name, address };\n    }\n    return { address };\n  }\n\n  if (trimmed.startsWith('\"') && trimmed.endsWith('\"')) {\n    return { address: trimmed.slice(1, -1) };\n  }\n\n  return { address: trimmed };\n}\n",
+    "import type { Attachment } from \"../core/types.js\";\n\n/**\n * Resolve attachment.path to in-memory Uint8Array content.\n * @throws When attachment.path is used on runtimes without node:fs/promises\n */\nexport async function resolveAttachments(attachments: Attachment[] = []): Promise<Attachment[]> {\n  const resolved: Attachment[] = [];\n\n  for (const attachment of attachments) {\n    if (attachment.content instanceof Uint8Array) {\n      resolved.push(attachment);\n      continue;\n    }\n\n    if (attachment.path) {\n      let fs: typeof import(\"node:fs/promises\");\n      try {\n        fs = await import(\"node:fs/promises\");\n      } catch {\n        throw new Error(\n          \"attachment.path is not supported on this runtime — use attachment.content (Uint8Array) instead\",\n        );\n      }\n\n      const data = await fs.readFile(attachment.path);\n      const { path: _path, ...rest } = attachment;\n      resolved.push({ ...rest, content: new Uint8Array(data) });\n      continue;\n    }\n\n    if (typeof attachment.content === \"string\") {\n      resolved.push(attachment);\n      continue;\n    }\n\n    resolved.push(attachment);\n  }\n\n  return resolved;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "85211AC1FC8A34D664756E2164756E21",
+  "names": []
+}