测试邮件
',\n text: '测试邮件',\n cc: 'cc@example.com',\n bcc: 'bcc@example.com',\n replyTo: 'reply@example.com',\n headers: { 'X-Trace': 'demo' },\n tags: [{ name: 'type', value: 'test' }],\n scheduledAt: '2024-12-01T12:00:00Z',\n}, {\n idempotencyKey: 'unique-key-123',\n});\n```\n\n#### `emails.get(id)` / `emails.list(options?)`\n\n```typescript\nawait amail.emails.get('email_id');\nawait amail.emails.list({ limit: 10 });\nawait amail.emails.list({ limit: 10, after: 'email_id' });\n```\n\n#### `emails.update(id, payload)` / `emails.cancel(id)` / `emails.remove(id)`\n\n改期尚未发出的定时邮件；取消排队或定时邮件（`remove` 走 `DELETE`）。\n\n```typescript\nawait amail.emails.update('email_id', { scheduledAt: 'in 10 minutes' });\nawait amail.emails.cancel('email_id');\n```\n\n#### `emails.providers()`\n\n```typescript\nconst { data } = await amail.emails.providers();\n```\n\n### `amail.batch`\n\n#### `batch.send(payload, options?)`\n\n批量发送。等同 `batch.create()`。不支持附件。\n\n```typescript\nconst { data, error } = await amail.batch.send([\n { to: 'user1@example.com', subject: '你好 1', html: '测试邮件 1
' },\n { to: 'user2@example.com', subject: '你好 2', html: '测试邮件 2
' },\n], { batchValidation: 'permissive' });\n```\n\n## 错误\n\nAPI 错误返回 `{ data, error }`。\n\n```typescript\nconst { data, error } = await amail.emails.send({ ... });\n\nif (error) {\n console.log(error.statusCode);\n console.log(error.name);\n console.log(error.message);\n}\n```\n\n## 从 Resend 迁移\n\n```typescript\nimport { Resend } from 'resend';\nconst resend = new Resend('re_xxx');\n\nimport { Amail } from '@wydev/amail';\nconst amail = new Amail('am_xxx', { baseUrl: 'https://amail.your-domain.com' });\n```\n\nAmail 会按通道的「发件人覆盖」填写发件邮箱；`providerId` 默认 `auto`。\n\n## 许可证\n\nMIT\n","readmeFilename":"README.md"}