Thank you for joining us.
',\n textContent: 'Welcome! Thank you for joining us.',\n});\n\nif (result.success) {\n console.log('Email sent successfully:', result.messageId);\n} else {\n console.error('Failed to send email:', result.errorMessage);\n}\n```\n\n### SendGrid Configuration\n\n```typescript\nimport { EmailSender } from '@bernierllc/email-sender';\n\nconst config = {\n provider: 'sendgrid' as const,\n apiKey: 'your-sendgrid-api-key',\n fromEmail: 'noreply@yourdomain.com',\n fromName: 'Your App',\n // Optional: point every SendGrid call (mail send, templates, senders) at\n // another host, e.g. a local mock in tests. Give the bare origin; a\n // trailing `/v3` is also accepted. Defaults to https://api.sendgrid.com.\n endpoint: process.env.SENDGRID_API_BASE_URL,\n};\n\nconst emailSender = new EmailSender(config);\n```\n\n### AWS SES Configuration\n\n```typescript\nimport { EmailSender } from '@bernierllc/email-sender';\n\nconst config = {\n provider: 'ses' as const,\n apiKey: 'your-aws-access-key',\n secretKey: 'your-aws-secret-key',\n region: 'us-east-1',\n fromEmail: 'noreply@yourdomain.com',\n fromName: 'Your App',\n sandbox: false, // Set to true if in SES sandbox mode\n};\n\nconst emailSender = new EmailSender(config);\n```\n\n### Mailgun Configuration\n\n```typescript\nimport { EmailSender } from '@bernierllc/email-sender';\n\nconst config = {\n provider: 'mailgun' as const,\n apiKey: 'your-mailgun-api-key',\n domain: 'yourdomain.com',\n region: 'us', // or 'eu' for European region\n fromEmail: 'noreply@yourdomain.com',\n fromName: 'Your App',\n};\n\nconst emailSender = new EmailSender(config);\n```\n\n### Postmark Configuration\n\n```typescript\nimport { EmailSender } from '@bernierllc/email-sender';\n\nconst config = {\n provider: 'postmark' as const,\n apiKey: 'your-postmark-api-key',\n accountToken: 'your-postmark-account-token', // Optional, for template operations\n fromEmail: 'noreply@yourdomain.com',\n fromName: 'Your App',\n};\n\nconst emailSender = new EmailSender(config);\n```\n\n## API Reference\n\n### EmailSender\n\nThe main class for sending emails.\n\n#### Constructor\n\n```typescript\nnew EmailSender(config: EmailProviderConfig)\n```\n\n#### Methods\n\n##### `sendEmail(email: EmailMessage): PromiseThis email will be sent
',\n});\n\n// This will be blocked (not whitelisted)\nconst result = await emailSender.sendEmail({\n toEmail: 'customer@example.com',\n subject: 'Test Email',\n htmlContent: 'This email will be blocked
',\n});\nconsole.log(result.success); // false\nconsole.log(result.errorMessage); // \"Email blocked by safety manager: ...\"\n```\n\n### Staging with Rewrite (Redirect to Test Email)\n\n```typescript\nconst emailSender = new EmailSender({\n provider: 'smtp' as const,\n host: 'smtp.example.com',\n port: 587,\n username: 'user',\n password: 'pass',\n fromEmail: 'sender@example.com',\n stagingSafety: {\n enabled: true,\n environment: 'staging',\n whitelist: ['admin@example.com'], // Admin emails go through normally\n rewriteTo: 'staging-test@example.com', // All other emails redirected here\n blockNonWhitelisted: false,\n logBlocked: true,\n },\n});\n\n// This will be sent to staging-test@example.com instead\nawait emailSender.sendEmail({\n toEmail: 'customer@example.com',\n subject: 'Test Email',\n htmlContent: 'This will be sent to staging-test@example.com
',\n});\n```\n\n### Production (All Emails Allowed)\n\n```typescript\nconst emailSender = new EmailSender({\n provider: 'smtp' as const,\n host: 'smtp.example.com',\n port: 587,\n username: 'user',\n password: 'pass',\n fromEmail: 'sender@example.com',\n stagingSafety: {\n enabled: true,\n environment: 'production',\n whitelist: [], // Not used in production\n blockNonWhitelisted: false,\n logBlocked: false,\n },\n});\n\n// All emails are allowed in production\nawait emailSender.sendEmail({\n toEmail: 'customer@example.com',\n subject: 'Production Email',\n htmlContent: 'This email will be sent
',\n});\n```\n\n### Check Recipient Safety Before Sending\n\n```typescript\nconst safetyResult = emailSender.checkRecipientSafety('test@example.com');\nconsole.log('Safety check result:', safetyResult);\n\nif (safetyResult && !safetyResult.allowed) {\n console.log('Email would be blocked:', safetyResult.reason);\n}\n```\n\n### Dynamic Configuration Based on Environment\n\n```typescript\nconst environment = process.env.NODE_ENV || 'development';\n\nconst emailSender = new EmailSender({\n provider: 'smtp' as const,\n host: 'smtp.example.com',\n port: 587,\n username: 'user',\n password: 'pass',\n fromEmail: 'sender@example.com',\n stagingSafety: {\n enabled: environment !== 'production',\n environment: environment as 'development' | 'staging' | 'production',\n whitelist: environment === 'staging'\n ? ['qa@example.com', 'test@example.com']\n : [],\n rewriteTo: environment === 'development' ? 'dev@example.com' : undefined,\n blockNonWhitelisted: environment === 'staging',\n logBlocked: true,\n },\n});\n\nconsole.log('Current environment:', environment);\nconsole.log('Safety enabled:', emailSender.isSafetyEnabled());\nconsole.log('Safety config:', emailSender.getSafetyConfig());\n```\n\n## Examples\n\n### Send Email with Attachment\n\n```typescript\nimport { EmailSender } from '@bernierllc/email-sender';\nimport fs from 'fs';\n\nconst emailSender = new EmailSender(config);\n\nconst attachment = {\n filename: 'report.pdf',\n content: fs.readFileSync('report.pdf').toString('base64'),\n contentType: 'application/pdf',\n disposition: 'attachment' as const,\n};\n\nconst result = await emailSender.sendEmail({\n toEmail: 'recipient@example.com',\n subject: 'Monthly Report',\n htmlContent: 'Please find the attached report.
',\n attachments: [attachment],\n});\n```\n\n### Send Email with Custom Headers\n\n```typescript\nconst result = await emailSender.sendEmail({\n toEmail: 'recipient@example.com',\n subject: 'Priority Message',\n htmlContent: '