This is a test.
')\n .text('Hello! This is a test.')\n .attach('path/to/file.pdf')\n .attachData(Buffer.from('data'), {\n filename: 'document.pdf',\n contentType: 'application/pdf',\n })\n .send()\n```\n\n### Using Views and Templates\n\nRender HTML and text from template files:\n\n```typescript\nexport class NotificationMail extends Mailable {\n constructor(private notification: Notification) {\n super()\n }\n\n build() {\n return this.subject('You have a new notification').view('emails/notification', {\n title: this.notification.title,\n message: this.notification.message,\n actionUrl: this.notification.actionUrl,\n })\n }\n}\n\n// Template file: resources/views/emails/notification.ejs\n//<%= message %>
\n// \">View Details\n```\n\n### HTML and Plain Text Emails\n\nSend both plain text and HTML versions to ensure compatibility:\n\n```typescript\nimport { Mailable } from '@atlex/mail'\n\nexport class MultiFormatMail extends Mailable {\n build() {\n return this.subject('Welcome')\n .html('We are excited to have you.
')\n .text('Welcome to Acme!\\nWe are excited to have you.')\n }\n}\n\n// Or render both from templates\nexport class ReceiptMail extends Mailable {\n constructor(private receipt: Receipt) {\n super()\n }\n\n build() {\n const data = { receipt: this.receipt }\n return this.subject('Your Receipt')\n .view('emails/receipt', data)\n .text('emails/receipt-text', data)\n }\n}\n```\n\n### File Attachments\n\nAttach files from disk or include data as attachments:\n\n```typescript\n// Attach a file from disk\nawait Mail.to('user@example.com')\n .subject('Invoice')\n .html('Please see your invoice attached.
')\n .attach('invoices/2024-001.pdf')\n .send()\n\n// Attach from memory with custom metadata\nawait Mail.to('user@example.com')\n .subject('Report')\n .html('Monthly report attached.
')\n .attachData(reportBuffer, {\n filename: 'report.xlsx',\n contentType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n })\n .send()\n\n// Multiple attachments\nawait Mail.to('user@example.com')\n .subject('Documents')\n .html('Documents enclosed.
')\n .attach('contract.pdf')\n .attach('addendum.pdf')\n .attachData(signatureData, { filename: 'signature.png' })\n .send()\n```\n\n### Raw Email\n\nSend raw RFC 822 formatted email for advanced use cases:\n\n```typescript\nconst rawEmail = `From: sender@example.com\nTo: recipient@example.com\nSubject: Test Email\nContent-Type: text/plain; charset=utf-8\n\nThis is a raw email message.`\n\nawait Mail.raw(rawEmail, 'recipient@example.com')\n```\n\n### Localization\n\nSend emails in different languages using the localization system:\n\n```typescript\nexport class LocalizedMail extends Mailable {\n constructor(private locale: string) {\n super()\n }\n\n build() {\n return this.locale(this.locale)\n .subject('email.welcome.subject')\n .view('emails/welcome')\n .to('user@example.com')\n }\n}\n\n// Send in Spanish\nawait Mail.send(new LocalizedMail('es'))\n\n// Send in French\nawait Mail.send(new LocalizedMail('fr'))\n```\n\n## Available Drivers\n\n### SMTP Driver\n\nSend emails via SMTP protocol:\n\n```typescript\n{\n smtp: {\n host: 'smtp.gmail.com',\n port: 587,\n secure: false,\n auth: {\n user: 'your-email@gmail.com',\n pass: 'your-app-password',\n },\n }\n}\n```\n\n### Mailgun Driver\n\nSend via Mailgun's email API:\n\n```typescript\n{\n mailgun: {\n secret: 'key-xxxxxxxxx',\n domain: 'mg.example.com',\n }\n}\n```\n\n### Amazon SES Driver\n\nSend via AWS Simple Email Service:\n\n```typescript\n{\n ses: {\n key: 'AKIA...',\n secret: 'wJ+...',\n region: 'us-east-1',\n }\n}\n```\n\n### Log Driver\n\nLog emails instead of sending (useful for development and testing):\n\n```typescript\n{\n log: {\n channel: 'single',\n }\n}\n```\n\n### Array Driver\n\nStore emails in memory for testing purposes:\n\n```typescript\n{\n array: {\n }\n}\n\n// Retrieve sent emails in tests\nconst driver = MailManager.driver('array')\nconst messages = driver.getMessages()\n```\n\n## API Reference\n\n### MailManager\n\n```typescript\n// Get the default mailer or a specific one\nstatic mailer(name?: string): Mailer\n\n// Get a driver instance\nstatic driver(name: string): Mailer\n\n// Register a custom driver\nstatic extend(name: string, driver: MailDriver): void\n\n// Set global from address\nstatic alwaysFrom(from: Address | { name: string; address: string }): void\n\n// Set global reply-to address\nstatic alwaysReplyTo(address: string | Address): void\n\n// Add global BCC recipient\nstatic alwaysBcc(address: string | Address): void\n\n// Add global CC recipient\nstatic alwaysTo(address: string | Address): void\n\n// Set locale for all emails\nstatic locale(locale: string): void\n\n// Send a mailable or array of mailables\nstatic send(mailable: Mailable | Mailable[]): Promise