@workermailer/smtp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 André Ribas
+
+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,539 @@
+# Worker Mailer
+
+[English](./README.md) | [Português](./README_pt-BR.md)
+
+[![npm version](https://badge.fury.io/js/@ribassu%2Fworker-mailer.svg)](https://badge.fury.io/js/@ribassu%2Fworker-mailer)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Worker Mailer is an SMTP client that runs on Cloudflare Workers. It leverages [Cloudflare TCP Sockets](https://developers.cloudflare.com/workers/runtime-apis/tcp-sockets/) and doesn't rely on any other dependencies.
+
+## Features
+
+- 🚀 Completely built on the Cloudflare Workers runtime with no other dependencies
+- 📝 Full TypeScript type support
+- 📧 Supports sending plain text and HTML emails with attachments
+- �️ Inline image attachments with Content-ID (CID) support
+- 🔒 Supports multiple SMTP authentication methods: `plain`, `login`, and `CRAM-MD5`
+- ✅ Email address validation (RFC 5322 compliant)
+- 🎯 Custom error classes for better error handling
+- 🪝 Lifecycle hooks for monitoring email operations
+- 📅 DSN support
+- 📬 Optional Cloudflare Queues integration for async email processing
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+- [Inline Images (CID)](#inline-images-cid)
+- [Lifecycle Hooks](#lifecycle-hooks)
+- [Error Handling](#error-handling)
+- [Cloudflare Queues Integration](#cloudflare-queues-integration)
+- [Limitations](#limitations)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Installation
+
+```shell
+npm i @ribassu/worker-mailer
+```
+
+## Quick Start
+
+1. Configure your `wrangler.toml`:
+
+```toml
+compatibility_flags = ["nodejs_compat"]
+# or compatibility_flags = ["nodejs_compat_v2"]
+```
+
+2. Use in your code:
+
+```typescript
+import { WorkerMailer } from '@ribassu/worker-mailer'
+
+// Connect to SMTP server
+const mailer = await WorkerMailer.connect({
+  credentials: {
+    username: 'bob@acme.com',
+    password: 'password',
+  },
+  authType: 'plain',
+  host: 'smtp.acme.com',
+  port: 587,
+  secure: true,
+})
+
+// Send email
+await mailer.send({
+  from: { name: 'Bob', email: 'bob@acme.com' },
+  to: { name: 'Alice', email: 'alice@acme.com' },
+  subject: 'Hello from Worker Mailer',
+  text: 'This is a plain text message',
+  html: '<h1>Hello</h1><p>This is an HTML message</p>',
+})
+```
+
+3. Using with modern JavaScript frameworks (Next.js, Nuxt, SvelteKit, etc.)
+
+When working with frameworks that use Node.js as their development runtime, you'll need to handle the fact that Cloudflare Workers-specific APIs (like `cloudflare:sockets`) aren't available during local development.
+
+The recommended approach is to use conditional dynamic imports. Here's an example for Nuxt.js:
+
+```typescript
+export default defineEventHandler(async event => {
+  // Check if running in development environment
+  if (import.meta.dev) {
+    // Development: Use nodemailer (or any Node.js compatible email library)
+    const nodemailer = await import('nodemailer')
+    const transporter = nodemailer.default.createTransport()
+    return await transporter.sendMail()
+  } else {
+    // Production: Use worker-mailer in Cloudflare Workers environment
+    const { WorkerMailer } = await import('@ribassu/worker-mailer')
+    const mailer = await WorkerMailer.connect()
+    return await mailer.send()
+  }
+})
+```
+
+This pattern ensures your application works seamlessly in both development and production environments.
+
+## API Reference
+
+### WorkerMailer.connect(options)
+
+Creates a new SMTP connection.
+
+```typescript
+type WorkerMailerOptions = {
+  host: string // SMTP server hostname
+  port: number // SMTP server port (usually 587 or 465)
+  secure?: boolean // Use TLS (default: false)
+  startTls?: boolean // Upgrade to TLS if SMTP server supports (default: true)
+  credentials?: {
+    // SMTP authentication credentials
+    username: string
+    password: string
+  }
+  authType?:
+    | 'plain'
+    | 'login'
+    | 'cram-md5'
+    | Array<'plain' | 'login' | 'cram-md5'>
+  logLevel?: LogLevel // Logging level (default: LogLevel.INFO)
+  socketTimeoutMs?: number // Socket timeout in milliseconds
+  responseTimeoutMs?: number // Server response timeout in milliseconds
+  hooks?: WorkerMailerHooks // Lifecycle hooks for monitoring
+  dsn?: {
+    RET?: {
+      HEADERS?: boolean
+      FULL?: boolean
+    }
+    NOTIFY?: {
+      DELAY?: boolean
+      FAILURE?: boolean
+      SUCCESS?: boolean
+    }
+  }
+}
+```
+
+### mailer.send(options)
+
+Sends an email.
+
+```typescript
+type EmailOptions = {
+  from:
+    | string
+    | {
+        // Sender's email
+        name?: string
+        email: string
+      }
+  to:
+    | string
+    | string[]
+    | {
+        // Recipients (TO)
+        name?: string
+        email: string
+      }
+    | Array<{ name?: string; email: string }>
+  reply?:
+    | string
+    | {
+        // Reply-To address
+        name?: string
+        email: string
+      }
+  cc?:
+    | string
+    | string[]
+    | {
+        // Carbon Copy recipients
+        name?: string
+        email: string
+      }
+    | Array<{ name?: string; email: string }>
+  bcc?:
+    | string
+    | string[]
+    | {
+        // Blind Carbon Copy recipients
+        name?: string
+        email: string
+      }
+    | Array<{ name?: string; email: string }>
+  subject: string // Email subject
+  text?: string // Plain text content
+  html?: string // HTML content
+  headers?: Record<string, string> // Custom email headers
+  attachments?: Attachment[] // Attachments
+  dsnOverride?: {
+    // Overrides dsn defined in WorkerMailer
+    envelopeId?: string | undefined
+    RET?: {
+      HEADERS?: boolean
+      FULL?: boolean
+    }
+    NOTIFY?: {
+      DELAY?: boolean
+      FAILURE?: boolean
+      SUCCESS?: boolean
+    }
+  }
+}
+
+type Attachment = {
+  filename: string
+  content: string // Base64-encoded content
+  mimeType?: string // MIME type (auto-detected if not set)
+  cid?: string // Content-ID for inline images
+  inline?: boolean // If true, attachment will be inline
+}
+```
+
+### Static Method: WorkerMailer.send()
+
+Send a one-off email without maintaining the connection.
+
+```typescript
+await WorkerMailer.send(
+  {
+    // WorkerMailerOptions
+    host: 'smtp.acme.com',
+    port: 587,
+    credentials: {
+      username: 'user',
+      password: 'pass',
+    },
+  },
+  {
+    // EmailOptions
+    from: 'sender@acme.com',
+    to: 'recipient@acme.com',
+    subject: 'Test',
+    text: 'Hello',
+    attachments: [
+      {
+        filename: 'test.txt',
+        content: 'SGVsbG8gV29ybGQ=', // base64-encoded string for "Hello World"
+        mimeType: 'text/plain',
+      },
+    ],
+  },
+)
+```
+
+## Inline Images (CID)
+
+You can embed images directly in HTML emails using Content-ID (CID):
+
+```typescript
+import { WorkerMailer } from '@ribassu/worker-mailer'
+
+const mailer = await WorkerMailer.connect({
+  host: 'smtp.acme.com',
+  port: 587,
+  credentials: { username: 'user', password: 'pass' },
+})
+
+await mailer.send({
+  from: 'sender@acme.com',
+  to: 'recipient@acme.com',
+  subject: 'Email with embedded image',
+  html: `
+    <h1>Hello!</h1>
+    <p>Here's our logo:</p>
+    <img src="cid:company-logo" alt="Company Logo">
+  `,
+  attachments: [
+    {
+      filename: 'logo.png',
+      content: logoBase64, // Base64-encoded image
+      mimeType: 'image/png',
+      cid: 'company-logo', // Referenced in HTML as cid:company-logo
+      inline: true,
+    },
+  ],
+})
+```
+
+## Lifecycle Hooks
+
+Monitor email operations with lifecycle hooks:
+
+```typescript
+import { WorkerMailer } from '@ribassu/worker-mailer'
+
+const mailer = await WorkerMailer.connect({
+  host: 'smtp.acme.com',
+  port: 587,
+  credentials: { username: 'user', password: 'pass' },
+  hooks: {
+    onConnect: () => {
+      console.log('Connected to SMTP server')
+    },
+    onSent: (email, response) => {
+      console.log(`Email sent to ${email.to}:`, response)
+    },
+    onError: (email, error) => {
+      console.error(`Failed to send email:`, error)
+      // Send to error tracking service, etc.
+    },
+    onClose: error => {
+      if (error) {
+        console.error('Connection closed with error:', error)
+      } else {
+        console.log('Connection closed')
+      }
+    },
+  },
+})
+```
+
+## Error Handling
+
+Worker Mailer provides custom error classes for better error handling:
+
+```typescript
+import {
+  WorkerMailer,
+  InvalidEmailError,
+  SmtpAuthError,
+  SmtpConnectionError,
+  SmtpRecipientError,
+  SmtpTimeoutError,
+  InvalidContentError,
+} from '@ribassu/worker-mailer'
+
+try {
+  const mailer = await WorkerMailer.connect({
+    host: 'smtp.acme.com',
+    port: 587,
+    credentials: { username: 'user', password: 'wrong-password' },
+  })
+
+  await mailer.send({
+    from: 'invalid-email', // This will throw InvalidEmailError
+    to: 'recipient@acme.com',
+    subject: 'Test',
+    text: 'Hello',
+  })
+} catch (error) {
+  if (error instanceof InvalidEmailError) {
+    console.error('Invalid emails:', error.invalidEmails)
+  } else if (error instanceof SmtpAuthError) {
+    console.error('Authentication failed')
+  } else if (error instanceof SmtpConnectionError) {
+    console.error('Could not connect to SMTP server')
+  } else if (error instanceof SmtpRecipientError) {
+    console.error('Recipient rejected:', error.recipient)
+  } else if (error instanceof SmtpTimeoutError) {
+    console.error('Operation timed out')
+  } else if (error instanceof InvalidContentError) {
+    console.error('Invalid email content (missing text or html)')
+  }
+}
+```
+
+## Cloudflare Queues Integration
+
+For high-volume email sending, you can use Cloudflare Queues for async processing:
+
+### Setup
+
+1. Add a Queue binding in `wrangler.toml`:
+
+```toml
+[[queues.producers]]
+queue = "email-queue"
+binding = "EMAIL_QUEUE"
+
+[[queues.consumers]]
+queue = "email-queue"
+max_batch_size = 10
+max_retries = 3
+```
+
+2. Create your worker with queue handler:
+
+```typescript
+import { WorkerMailer } from '@ribassu/worker-mailer'
+import {
+  createQueueHandler,
+  enqueueEmail,
+  type QueueEmailMessage,
+} from '@ribassu/worker-mailer/queue'
+
+interface Env {
+  EMAIL_QUEUE: Queue<QueueEmailMessage>
+}
+
+export default {
+  // Handle HTTP requests - enqueue emails
+  async fetch(request: Request, env: Env): Promise<Response> {
+    await enqueueEmail(env.EMAIL_QUEUE, {
+      mailerOptions: {
+        host: 'smtp.acme.com',
+        port: 587,
+        credentials: { username: 'user', password: 'pass' },
+        authType: 'plain',
+      },
+      emailOptions: {
+        from: 'sender@acme.com',
+        to: 'recipient@acme.com',
+        subject: 'Hello from Queue',
+        text: 'This email was sent via Cloudflare Queues!',
+      },
+    })
+
+    return new Response('Email queued successfully')
+  },
+
+  // Process queued emails
+  async queue(batch: MessageBatch<QueueEmailMessage>, env: Env): Promise<void> {
+    const handler = createQueueHandler({
+      onSuccess: result => console.log('Email sent:', result.emailOptions.to),
+      onError: result => console.error('Failed:', result.error),
+    })
+
+    await handler(batch)
+  },
+}
+```
+
+### Queue Helper Functions
+
+```typescript
+import {
+  enqueueEmail,
+  enqueueEmails,
+  type QueueEmailMessage,
+} from '@ribassu/worker-mailer/queue'
+
+// Enqueue a single email
+await enqueueEmail(env.EMAIL_QUEUE, {
+  mailerOptions: { host: 'smtp.acme.com', port: 587 /* ... */ },
+  emailOptions: {
+    from: 'a@b.com',
+    to: 'c@d.com',
+    subject: 'Hi',
+    text: 'Hello',
+  },
+})
+
+// Enqueue multiple emails at once
+await enqueueEmails(env.EMAIL_QUEUE, [
+  {
+    mailerOptions: {
+      /* ... */
+    },
+    emailOptions: {
+      /* ... */
+    },
+  },
+  {
+    mailerOptions: {
+      /* ... */
+    },
+    emailOptions: {
+      /* ... */
+    },
+  },
+])
+```
+
+## Limitations
+
+- **Port Restrictions:** Cloudflare Workers cannot make outbound connections on port 25. You won't be able to send emails via port 25, but common ports like 587 and 465 are supported.
+- **Connection Limits:** Each Worker instance has a limit on the number of concurrent TCP connections. Make sure to properly close connections when done.
+
+## Contributing
+
+### Development Workflow
+
+> For major changes, please open an issue first to discuss what you would like to change.
+
+1. Fork and clone the repository
+2. Install dependencies:
+   ```bash
+   bun install
+   ```
+3. Create a new branch for your feature from `develop`:
+   ```bash
+   git checkout -b feat/your-feature-name
+   ```
+4. Make your changes and make sure all tests pass
+5. Update README.md & changelog `bun changeset` if needed
+6. Push your changes to your fork and create a pull request from your branch to `develop`
+
+### Testing
+
+1. Unit Tests:
+   ```bash
+   bun test
+   ```
+2. Integration Tests:
+   ```bash
+   bunx wrangler dev ./test/worker.ts
+   ```
+   Then, send a POST request to `http://127.0.0.1:8787` with the following JSON body:
+   ```json
+   {
+     "config": {
+       "credentials": {
+         "username": "xxx@xx.com",
+         "password": "xxxx"
+       },
+       "authType": "plain",
+       "host": "smtp.acme.com",
+       "port": 587,
+       "secure": false,
+       "startTls": true
+     },
+     "email": {
+       "from": "xxx@xx.com",
+       "to": "yyy@yy.com",
+       "subject": "Test Email",
+       "text": "Hello World"
+     }
+   }
+   ```
+
+### Reporting Issues
+
+When reporting issues, please include:
+
+- Version of worker-mailer you're using
+- A clear description of the problem
+- Steps to reproduce the issue
+- Expected vs actual behavior
+- Any relevant code snippets or error messages
+
+## License
+
+This project is licensed under the MIT License.

package/dist/chunk-TXGT6IDZ.mjs

@@ -0,0 +1,54 @@
+var S=class{values=[];resolvers=[];enqueue(e){this.resolvers.length||this.addWrapper(),this.resolvers.shift()(e)}async dequeue(){return this.values.length||this.addWrapper(),this.values.shift()}get length(){return this.values.length}clear(){this.values=[],this.resolvers=[]}addWrapper(){this.values.push(new Promise(e=>{this.resolvers.push(e)}))}};function p(s){if(!s||typeof s!="string"||!/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/.test(s))return!1;let[t,i]=s.split("@");if(t.length>64||i.length>255||!i.includes("."))return!1;let a=i.split(".").pop();return!(!a||a.length<2)}function W(s){return s.filter(e=>!p(e))}async function L(s,e,t){return Promise.race([s,new Promise((i,a)=>setTimeout(()=>a(t),e))])}var F=new TextEncoder;function u(s){return F.encode(s)}var D=new TextDecoder("utf-8");function U(s){return D.decode(s)}function R(s,e=76){let t=u(s),i="",a=0,n=0;for(;n<t.length;){let l=t[n],h;if(l===10){i+=`\r
+`,a=0,n++;continue}else if(l===13)if(n+1<t.length&&t[n+1]===10){i+=`\r
+`,a=0,n+=2;continue}else h="=0D";if(h===void 0){let m=l===32||l===9,f=n+1>=t.length||t[n+1]===10||t[n+1]===13;l<32&&!m||l>126||l===61||m&&f?h=`=${l.toString(16).toUpperCase().padStart(2,"0")}`:h=String.fromCharCode(l)}a+h.length>e-3&&(i+=`=\r
+`,a=0),i+=h,a+=h.length,n++}return i}var c=class extends Error{code;constructor(e,t){super(e),this.name="WorkerMailerError",this.code=t}},A=class extends c{invalidEmails;constructor(e,t=[]){super(e,"INVALID_EMAIL"),this.name="InvalidEmailError",this.invalidEmails=t}},d=class extends c{constructor(e){super(e,"AUTH_FAILED"),this.name="SmtpAuthError"}},C=class extends c{constructor(e){super(e,"CONNECTION_FAILED"),this.name="SmtpConnectionError"}},O=class extends c{recipient;constructor(e,t){super(e,"RECIPIENT_REJECTED"),this.name="SmtpRecipientError",this.recipient=t}},v=class extends c{constructor(e){super(e,"TIMEOUT"),this.name="SmtpTimeoutError"}},x=class extends c{constructor(e){super(e,"INVALID_CONTENT"),this.name="InvalidContentError"}};function g(s){if(!/[^\x00-\x7F]/.test(s))return s;let e=u(s),t="";for(let i of e)i>=33&&i<=126&&i!==63&&i!==61&&i!==95?t+=String.fromCharCode(i):i===32?t+="_":t+=`=${i.toString(16).toUpperCase().padStart(2,"0")}`;return`=?UTF-8?Q?${t}?=`}var $=class s{from;to;reply;cc;bcc;subject;text;html;dsnOverride;attachments;headers;setSent;setSentError;sent=new Promise((e,t)=>{this.setSent=e,this.setSentError=t});constructor(e){if(!e.text&&!e.html)throw new x("At least one of text or html must be provided");typeof e.from=="string"?this.from={email:e.from}:this.from=e.from,typeof e.reply=="string"?this.reply={email:e.reply}:this.reply=e.reply,this.to=s.toUsers(e.to),this.cc=s.toUsers(e.cc),this.bcc=s.toUsers(e.bcc),this.validateEmails(),this.subject=e.subject,this.text=e.text,this.html=e.html,this.attachments=e.attachments,this.dsnOverride=e.dsnOverride,this.headers=e.headers||{}}static toUsers(e){if(e)return typeof e=="string"?[{email:e}]:Array.isArray(e)?e.map(t=>typeof t=="string"?{email:t}:t):[e]}validateEmails(){let e=[];p(this.from.email)||e.push(this.from.email);for(let t of this.to)p(t.email)||e.push(t.email);if(this.reply&&!p(this.reply.email)&&e.push(this.reply.email),this.cc)for(let t of this.cc)p(t.email)||e.push(t.email);if(this.bcc)for(let t of this.bcc)p(t.email)||e.push(t.email);if(e.length>0)throw new A(`Invalid email address(es): ${e.join(", ")}`,e)}getEmailData(){this.resolveHeader();let e=["MIME-Version: 1.0"];for(let[o,T]of Object.entries(this.headers))e.push(`${o}: ${T}`);let t=this.generateSafeBoundary("mixed_"),i=this.generateSafeBoundary("related_"),a=this.generateSafeBoundary("alternative_"),n=this.attachments?.filter(o=>o.cid)||[],l=this.attachments?.filter(o=>!o.cid)||[],h=n.length>0,m=l.length>0;e.push(`Content-Type: multipart/mixed; boundary="${t}"`);let r=`${e.join(`\r
+`)}\r
+\r
+`;if(r+=`--${t}\r
+`,h&&(r+=`Content-Type: multipart/related; boundary="${i}"\r
+\r
+`,r+=`--${i}\r
+`),r+=`Content-Type: multipart/alternative; boundary="${a}"\r
+\r
+`,this.text){r+=`--${a}\r
+`,r+=`Content-Type: text/plain; charset="UTF-8"\r
+`,r+=`Content-Transfer-Encoding: quoted-printable\r
+\r
+`;let o=R(this.text);r+=`${o}\r
+\r
+`}if(this.html){r+=`--${a}\r
+`,r+=`Content-Type: text/html; charset="UTF-8"\r
+`,r+=`Content-Transfer-Encoding: quoted-printable\r
+\r
+`;let o=R(this.html);r+=`${o}\r
+\r
+`}if(r+=`--${a}--\r
+`,h){for(let o of n){let T=o.mimeType||this.getMimeType(o.filename);r+=`--${i}\r
+`,r+=`Content-Type: ${T}; name="${o.filename}"\r
+`,r+=`Content-Transfer-Encoding: base64\r
+`,r+=`Content-ID: <${o.cid}>\r
+`,r+=`Content-Disposition: inline; filename="${o.filename}"\r
+\r
+`;let y=o.content.match(/.{1,72}/g);y?r+=`${y.join(`\r
+`)}`:r+=`${o.content}`,r+=`\r
+\r
+`}r+=`--${i}--\r
+`}if(m)for(let o of l){let T=o.mimeType||this.getMimeType(o.filename);r+=`--${t}\r
+`,r+=`Content-Type: ${T}; name="${o.filename}"\r
+`,r+=`Content-Description: ${o.filename}\r
+`,r+=`Content-Disposition: attachment; filename="${o.filename}";\r
+`,r+=`    creation-date="${new Date().toUTCString()}";\r
+`,r+=`Content-Transfer-Encoding: base64\r
+\r
+`;let y=o.content.match(/.{1,72}/g);y?r+=`${y.join(`\r
+`)}`:r+=`${o.content}`,r+=`\r
+\r
+`}return r+=`--${t}--\r
+`,`${this.applyDotStuffing(r)}\r
+.\r
+`}applyDotStuffing(e){let t=e.replace(/\r\n\./g,`\r
+..`);return t.startsWith(".")&&(t=`.${t}`),t}generateSafeBoundary(e){let t=new Uint8Array(28);crypto.getRandomValues(t);let i=Array.from(t).map(n=>n.toString(16).padStart(2,"0")).join(""),a=e+i;return a=a.replace(/[<>@,;:\\/[\]?=" ]/g,"_"),a}getMimeType(e){let t=e.split(".").pop()?.toLowerCase();return{txt:"text/plain",html:"text/html",csv:"text/csv",pdf:"application/pdf",png:"image/png",jpg:"image/jpeg",jpeg:"image/jpeg",gif:"image/gif",zip:"application/zip"}[t||"txt"]||"application/octet-stream"}resolveHeader(){this.resolveFrom(),this.resolveTo(),this.resolveReply(),this.resolveCC(),this.resolveBCC(),this.resolveSubject(),this.headers.Date=this.headers.Date??new Date().toUTCString(),this.headers["Message-ID"]=this.headers["Message-ID"]??`<${crypto.randomUUID()}@${this.from.email.split("@").pop()}>`}resolveFrom(){if(this.headers.From)return;let e=this.from.email;this.from.name&&(e=`"${g(this.from.name)}" <${e}>`),this.headers.From=e}resolveTo(){if(this.headers.To)return;let e=this.to.map(t=>t.name?`"${g(t.name)}" <${t.email}>`:t.email);this.headers.To=e.join(", ")}resolveSubject(){this.headers.Subject||this.subject&&(this.headers.Subject=g(this.subject))}resolveReply(){if(!this.headers["Reply-To"]&&this.reply){let e=this.reply.email;this.reply.name&&(e=`"${g(this.reply.name)}" <${e}>`),this.headers["Reply-To"]=e}}resolveCC(){if(!this.headers.CC&&this.cc){let e=this.cc.map(t=>t.name?`"${g(t.name)}" <${t.email}>`:t.email);this.headers.CC=e.join(", ")}}resolveBCC(){if(!this.headers.BCC&&this.bcc){let e=this.bcc.map(t=>t.name?`"${g(t.name)}" <${t.email}>`:t.email);this.headers.BCC=e.join(", ")}}};var k=(n=>(n[n.DEBUG=0]="DEBUG",n[n.INFO=1]="INFO",n[n.WARN=2]="WARN",n[n.ERROR=3]="ERROR",n[n.NONE=4]="NONE",n))(k||{}),w=class{constructor(e=1,t){this.level=e;this.prefix=t}level;prefix;debug(e,...t){this.level<=0&&console.debug(this.prefix+e,...t)}info(e,...t){this.level<=1&&console.info(this.prefix+e,...t)}warn(e,...t){this.level<=2&&console.warn(this.prefix+e,...t)}error(e,...t){this.level<=3&&console.error(this.prefix+e,...t)}};import{connect as M}from"cloudflare:sockets";var I=class s{socket;host;port;secure;startTls;authType;credentials;socketTimeoutMs;responseTimeoutMs;reader;writer;logger;dsn;sendNotificationsTo;hooks;active=!1;emailSending=null;emailSendingOptions=null;emailToBeSent=new S;supportsDSN=!1;allowAuth=!1;authTypeSupported=[];supportsStartTls=!1;constructor(e){this.port=e.port,this.host=e.host,this.secure=!!e.secure,Array.isArray(e.authType)?this.authType=e.authType:typeof e.authType=="string"?this.authType=[e.authType]:this.authType=[],this.startTls=e.startTls===void 0?!0:e.startTls,this.credentials=e.credentials,this.dsn=e.dsn||{},this.hooks=e.hooks||{},this.socketTimeoutMs=e.socketTimeoutMs||6e4,this.responseTimeoutMs=e.responseTimeoutMs||3e4,this.socket=M({hostname:this.host,port:this.port},{secureTransport:this.secure?"on":this.startTls?"starttls":"off",allowHalfOpen:!1}),this.reader=this.socket.readable.getReader(),this.writer=this.socket.writable.getWriter(),this.logger=new w(e.logLevel,`[WorkerMailer:${this.host}:${this.port}]`)}static async connect(e){let t=new s(e);return await t.initializeSmtpSession(),t.start().catch(console.error),t}send(e){let t=new $(e);return this.emailToBeSent.enqueue({email:t,options:e}),t.sent}static async send(e,t){let i=await s.connect(e);await i.send(t),await i.close()}async readTimeout(){return L(this.read(),this.responseTimeoutMs,new v("Timeout while waiting for smtp server response"))}async read(){let e="";for(;;){let{value:t}=await this.reader.read();if(!t)continue;let i=U(t).toString();if(this.logger.debug(`SMTP server response:
+`+i),e=e+i,!e.endsWith(`
+`))continue;let a=e.split(/\r?\n/),n=a[a.length-2];if(!/^\d+-/.test(n))return e}}async writeLine(e){await this.write(`${e}\r
+`)}async write(e){this.logger.debug(`Write to socket:
+`+e),await this.writer.write(u(e))}async initializeSmtpSession(){await this.waitForSocketConnected(),await this.greet(),await this.ehlo(),this.startTls&&!this.secure&&this.supportsStartTls&&(await this.tls(),await this.ehlo()),await this.auth(),this.active=!0,await this.hooks.onConnect?.()}async start(){for(;this.active;){let{email:e,options:t}=await this.emailToBeSent.dequeue();this.emailSending=e,this.emailSendingOptions=t;try{await this.mail(),await this.rcpt(),await this.data();let i=await this.body();this.emailSending.setSent(),await this.hooks.onSent?.(t,i)}catch(i){if(this.logger.error("Failed to send email: "+i.message),!this.active)return;this.emailSending.setSentError(i),await this.hooks.onError?.(t,i);try{await this.rset()}catch(a){await this.close(a)}}this.emailSending=null,this.emailSendingOptions=null}}async close(e){for(this.active=!1,this.logger.info("WorkerMailer is closed",e?.message||""),this.emailSending?.setSentError?.(e||new Error("WorkerMailer is shutting down"));this.emailToBeSent.length;){let{email:t}=await this.emailToBeSent.dequeue();t.setSentError(e||new Error("WorkerMailer is shutting down"))}try{await this.writeLine("QUIT"),await this.readTimeout(),this.socket.close().catch(()=>this.logger.error("Failed to close socket"))}catch{}await this.hooks.onClose?.(e)}async waitForSocketConnected(){this.logger.info("Connecting to SMTP server"),await L(this.socket.opened,this.socketTimeoutMs,new v("Socket timeout!")),this.logger.info("SMTP server connected")}async greet(){let e=await this.readTimeout();if(!e.startsWith("220"))throw new C("Failed to connect to SMTP server: "+e)}async ehlo(){await this.writeLine("EHLO 127.0.0.1");let e=await this.readTimeout();if(e.startsWith("421"))throw new Error(`Failed to EHLO. ${e}`);if(!e.startsWith("2")){await this.helo();return}this.parseCapabilities(e)}async helo(){await this.writeLine("HELO 127.0.0.1");let e=await this.readTimeout();if(!e.startsWith("2"))throw new Error(`Failed to HELO. ${e}`)}async tls(){await this.writeLine("STARTTLS");let e=await this.readTimeout();if(!e.startsWith("220"))throw new Error("Failed to start TLS: "+e);this.reader.releaseLock(),this.writer.releaseLock(),this.socket=this.socket.startTls(),this.reader=this.socket.readable.getReader(),this.writer=this.socket.writable.getWriter()}parseCapabilities(e){/[ -]AUTH\b/i.test(e)&&(this.allowAuth=!0),/[ -]AUTH(?:(\s+|=)[^\n]*\s+|\s+|=)PLAIN/i.test(e)&&this.authTypeSupported.push("plain"),/[ -]AUTH(?:(\s+|=)[^\n]*\s+|\s+|=)LOGIN/i.test(e)&&this.authTypeSupported.push("login"),/[ -]AUTH(?:(\s+|=)[^\n]*\s+|\s+|=)CRAM-MD5/i.test(e)&&this.authTypeSupported.push("cram-md5"),/[ -]STARTTLS\b/i.test(e)&&(this.supportsStartTls=!0),/[ -]DSN\b/i.test(e)&&(this.supportsDSN=!0)}async auth(){if(this.allowAuth){if(!this.credentials)throw new d("smtp server requires authentication, but no credentials found");if(this.authTypeSupported.includes("plain")&&this.authType.includes("plain"))await this.authWithPlain();else if(this.authTypeSupported.includes("login")&&this.authType.includes("login"))await this.authWithLogin();else if(this.authTypeSupported.includes("cram-md5")&&this.authType.includes("cram-md5"))await this.authWithCramMD5();else throw new d("No supported auth method found.")}}async authWithPlain(){let e=btoa(`\0${this.credentials.username}\0${this.credentials.password}`);await this.writeLine(`AUTH PLAIN ${e}`);let t=await this.readTimeout();if(!t.startsWith("2"))throw new d(`Failed to plain authentication: ${t}`)}async authWithLogin(){await this.writeLine("AUTH LOGIN");let e=await this.readTimeout();if(!e.startsWith("3"))throw new d("Invalid login: "+e);let t=btoa(this.credentials.username);await this.writeLine(t);let i=await this.readTimeout();if(!i.startsWith("3"))throw new d("Failed to login authentication: "+i);let a=btoa(this.credentials.password);await this.writeLine(a);let n=await this.readTimeout();if(!n.startsWith("2"))throw new d("Failed to login authentication: "+n)}async authWithCramMD5(){await this.writeLine("AUTH CRAM-MD5");let e=await this.readTimeout(),t=e.match(/^334\s+(.+)$/)?.pop();if(!t)throw new d("Invalid CRAM-MD5 challenge: "+e);let i=atob(t),a=u(this.credentials.password),n=await crypto.subtle.importKey("raw",a,{name:"HMAC",hash:"MD5"},!1,["sign"]),l=u(i),h=await crypto.subtle.sign("HMAC",n,l),m=Array.from(new Uint8Array(h)).map(r=>r.toString(16).padStart(2,"0")).join("");await this.writeLine(btoa(`${this.credentials.username} ${m}`));let f=await this.readTimeout();if(!f.startsWith("2"))throw new d("Failed to cram-md5 authentication: "+f)}async mail(){let e=`MAIL FROM: <${this.emailSending.from.email}>`;this.supportsDSN&&(e+=` ${this.retBuilder()}`,this.emailSending?.dsnOverride?.envelopeId&&(e+=` ENVID=${this.emailSending?.dsnOverride?.envelopeId}`)),await this.writeLine(e);let t=await this.readTimeout();if(!t.startsWith("2"))throw new Error(`Invalid ${e} ${t}`)}async rcpt(){let e=[...this.emailSending.to,...this.emailSending.cc||[],...this.emailSending.bcc||[]];for(let t of e){let i=`RCPT TO: <${t.email}>`;this.supportsDSN&&(i+=this.notificationBuilder()),await this.writeLine(i);let a=await this.readTimeout();if(!a.startsWith("2"))throw new O(`Invalid ${i} ${a}`,t.email)}}async data(){await this.writeLine("DATA");let e=await this.readTimeout();if(!e.startsWith("3"))throw new Error(`Failed to send DATA: ${e}`)}async body(){await this.write(this.emailSending.getEmailData());let e=await this.readTimeout();if(!e.startsWith("2"))throw new Error("Failed send email body: "+e);return e}async rset(){await this.writeLine("RSET");let e=await this.readTimeout();if(!e.startsWith("2"))throw new Error(`Failed to reset: ${e}`)}notificationBuilder(){let e=[];return(this.emailSending?.dsnOverride?.NOTIFY&&this.emailSending?.dsnOverride?.NOTIFY?.SUCCESS||!this.emailSending?.dsnOverride?.NOTIFY&&this.dsn?.NOTIFY?.SUCCESS)&&e.push("SUCCESS"),(this.emailSending?.dsnOverride?.NOTIFY&&this.emailSending?.dsnOverride?.NOTIFY?.FAILURE||!this.emailSending?.dsnOverride?.NOTIFY&&this.dsn?.NOTIFY?.FAILURE)&&e.push("FAILURE"),(this.emailSending?.dsnOverride?.NOTIFY&&this.emailSending?.dsnOverride?.NOTIFY?.DELAY||!this.emailSending?.dsnOverride?.NOTIFY&&this.dsn?.NOTIFY?.DELAY)&&e.push("DELAY"),e.length>0?` NOTIFY=${e.join(",")}`:" NOTIFY=NEVER"}retBuilder(){let e=[];return(this.emailSending?.dsnOverride?.RET&&this.emailSending?.dsnOverride?.RET?.HEADERS||!this.emailSending?.dsnOverride?.RET&&this.dsn?.RET?.HEADERS)&&e.push("HDRS"),(this.emailSending?.dsnOverride?.RET&&this.emailSending?.dsnOverride?.RET?.FULL||!this.emailSending?.dsnOverride?.RET&&this.dsn?.RET?.FULL)&&e.push("FULL"),e.length>0?`RET=${e.join(",")}`:""}};export{p as a,W as b,c,A as d,d as e,C as f,O as g,v as h,x as i,g as j,$ as k,k as l,I as m};