`hono-email/cloudflare` provides `CloudflareEmailAdapter` and connectors for Cloudflare Email Service. ## On Cloudflare Workers Use `WorkersConnector` when running inside a Cloudflare Worker: ```tsx import { Body, Html, Text, sendEmail } from 'hono-email' import { CloudflareEmailAdapter } from 'hono-email/cloudflare' import WorkersConnector from 'hono-email/cloudflare/workers' export default { async fetch(_request: Request, env: Env): Promise { const receipt = await sendEmail({ adapter: CloudflareEmailAdapter({ connector: WorkersConnector }), from: 'sender@example.com', to: 'recipient@example.com', subject: 'Welcome', jsx: ( Hello from Cloudflare Workers. ), }) return Response.json(receipt) }, } ``` ## REST API Use `RESTConnector` from other runtimes: ```tsx import { Body, Html, Text, sendEmail } from 'hono-email' import { CloudflareEmailAdapter, RESTConnector } from 'hono-email/cloudflare' const receipt = await sendEmail({ adapter: CloudflareEmailAdapter({ connector: RESTConnector({ accountId: process.env.CLOUDFLARE_ACCOUNT_ID!, apiToken: process.env.CLOUDFLARE_API_TOKEN!, }), }), from: { address: 'sender@example.com', name: 'Sender' }, to: ['first@example.com', 'second@example.com'], subject: 'Welcome', jsx: ( Hello from the Cloudflare REST API. ), }) if (receipt.successful && receipt.queued) { console.log('Queued recipients:', receipt.queuedRecipients) } ``` For the full list of configuration options, see the [Cloudflare Email Options API Reference](/api/adapter-options/#cloudflare-email-options). ## Shared adapter features Like all provider adapters, Cloudflare Email supports `to`, `cc`, `bcc`, `replyTo`, custom `headers`, and `attachments`. Inline attachments use `cid` when the provider supports content IDs. ## CloudflareEmailAdapter options import { Badge } from '@astrojs/starlight/components' ### `connector` **Type:** `CloudflareEmailConnector` Cloudflare Email connector. Pass `WorkersConnector` when running inside a Cloudflare Worker, or `RESTConnector(...)` from other runtimes. ### `limits.maxAttachmentSize` **Type:** `number` Maximum attachment size in bytes. ## RESTConnector options ```ts import { RESTConnector } from 'hono-email/cloudflare' ``` ### `accountId` **Type:** `string` Your Cloudflare account ID. ### `apiToken` **Type:** `string` Cloudflare API token with Email Routing write permission. ### `apiBaseUrl` **Type:** `string` Override the Cloudflare API base URL. ### `fetch` **Type:** `(input: string, init: RequestInit) => Promise` Custom `fetch` implementation. ## WorkersConnector options ```ts import WorkersConnector from 'hono-email/cloudflare/workers' ``` `WorkersConnector` is a value (not a factory function) — pass it directly. ### `bindingName` **Type:** `string` · **Default:** `'EMAIL'` Name of the Email Workers binding in your `wrangler.toml`.