Welcome to our platform!
',\n text: 'Welcome to our platform!',\n});\n\nconsole.log('Email queued:', response.id);\n```\n\n### Multiple Recipients\n\n```typescript\nawait mesa.send({\n to: [\n { email: 'user1@example.com', name: 'User One' },\n { email: 'user2@example.com', name: 'User Two' },\n ],\n cc: 'manager@example.com',\n bcc: ['audit@example.com'],\n subject: 'Team Update',\n html: 'Important announcement...
',\n});\n```\n\n### Using Templates\n\n```typescript\nawait mesa.send({\n to: 'user@example.com',\n subject: 'Order Confirmation',\n templateId: 'order-confirmation',\n templateData: {\n orderNumber: 'ORD-12345',\n items: [\n { name: 'Widget', quantity: 2, price: 29.99 },\n ],\n total: 59.98,\n },\n});\n```\n\n### With Attachments\n\n```typescript\nimport { readFileSync } from 'fs';\n\nawait mesa.send({\n to: 'user@example.com',\n subject: 'Your Invoice',\n html: 'Please find your invoice attached.
',\n attachments: [\n {\n filename: 'invoice.pdf',\n content: readFileSync('./invoice.pdf').toString('base64'),\n contentType: 'application/pdf',\n },\n ],\n});\n```\n\n### Scheduled Send\n\n```typescript\nawait mesa.send({\n to: 'user@example.com',\n subject: 'Reminder',\n html: 'Don\\'t forget about your appointment!
',\n scheduledAt: '2024-01-15T09:00:00Z',\n});\n```\n\n### Override Tracking per Email\n\n```typescript\nawait mesa.send({\n to: 'user@example.com',\n subject: 'Sensitive Information',\n html: 'Your password reset link...
',\n tracking: {\n clicks: false, // Disable click tracking for this email\n opens: false, // Disable open tracking for this email\n },\n});\n```\n\n## Batch Sending\n\n```typescript\nconst responses = await mesa.sendBatch([\n { to: 'user1@example.com', subject: 'Hello User 1', html: '...' },\n { to: 'user2@example.com', subject: 'Hello User 2', html: '...' },\n { to: 'user3@example.com', subject: 'Hello User 3', html: '...' },\n]);\n\nresponses.forEach((res) => console.log('Sent:', res.id));\n```\n\n## Check Email Status\n\n```typescript\nconst status = await mesa.getStatus('email-id-here');\nconsole.log(status);\n```\n\n## Webhook Handling\n\n### Verify Webhook Signature\n\n```typescript\nimport express from 'express';\n\nconst app = express();\n\napp.post('/webhooks/mesa', express.raw({ type: 'application/json' }), (req, res) => {\n const signature = req.headers['x-mesa-signature'] as string;\n const payload = req.body.toString();\n\n if (!mesa.verifyWebhook(payload, signature, process.env.WEBHOOK_SECRET!)) {\n return res.status(401).send('Invalid signature');\n }\n\n const event = mesa.parseWebhook(payload);\n\n switch (event.event) {\n case 'email.delivered':\n console.log('Email delivered:', event.messageId);\n break;\n case 'email.bounced':\n console.log('Email bounced:', event.messageId, event.data);\n break;\n case 'email.opened':\n console.log('Email opened:', event.messageId);\n break;\n case 'email.clicked':\n console.log('Link clicked:', event.data.url);\n break;\n }\n\n res.status(200).send('OK');\n});\n```\n\n## Runtime Configuration Updates\n\n```typescript\n// Update mail config at runtime\nmesa.updateMailConfig({\n sandbox: true, // Enable sandbox mode\n});\n\n// Get current config\nconst config = mesa.getMailConfig();\n```\n\n## Error Handling\n\n```typescript\nimport { MesaClient, MesaAPIError, MesaValidationError } from '@armco/mesa-sdk';\n\ntry {\n await mesa.send({ /* ... */ });\n} catch (error) {\n if (error instanceof MesaValidationError) {\n console.error('Validation error:', error.message, 'Field:', error.field);\n } else if (error instanceof MesaAPIError) {\n console.error('API error:', error.message);\n console.error('Status:', error.statusCode);\n console.error('Code:', error.code);\n console.error('Details:', error.details);\n } else {\n console.error('Unknown error:', error);\n }\n}\n```\n\n## TypeScript Support\n\nFull TypeScript support with exported types:\n\n```typescript\nimport type {\n MesaConfig,\n MailConfig,\n SendEmailOptions,\n SendEmailResponse,\n EmailAddress,\n Attachment,\n WebhookEvent,\n WebhookPayload,\n} from '@armco/mesa-sdk';\n```\n\n## Environment Variables\n\nRecommended setup:\n\n```bash\n# .env\nMESA_API_KEY=your-api-key\nMESA_API_URL=https://api.sandesh.armco.dev # Optional\nWEBHOOK_SECRET=your-webhook-secret\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}