`; `EmailError` lives in
+`unemail` rather than in the types module.
+
+## Tooling
+
+The repo builds with Bun. There is no `pnpm-lock.yaml` and no
+`packageManager` field; `bun install` and `bun run check`. This affects
+contributors, not consumers — the published package is unchanged in how it
+is installed.
diff --git a/README.md b/README.md
index 4a5badd..df24001 100644
--- a/README.md
+++ b/README.md
@@ -1,502 +1,385 @@
+
-
- 
-
- unemail
-
- Driver-based, zero-dependency TypeScript email library.
-
- Send, batch, schedule, dedupe, render, parse, verify, and sign — one unified API across every runtime.
-
- 
- 
- 
- 
- 
+ 
+
-## Design goals
+# unemail
-| Goal | How `unemail` delivers |
-| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **One API, many transports** | `createEmail({ driver })` — 15+ built-in drivers (SMTP, Resend, SES, Postmark, SendGrid, Mailgun, Mailtrap, Brevo, MailerSend, Loops, Zeptomail, MailChannels, Cloudflare Email, …) |
-| **Cross-runtime** | Node, Bun, Deno, Cloudflare Workers, browser — core is zero-dep and Web-API only. No `axios`, ever. |
-| **Compliance-ready** | RFC 8058 one-click List-Unsubscribe, DKIM + ARC signing, suppression/preference stores, DMARC + TLS-RPT + ARF parsers |
-| **Resilient by default** | Idempotency, retry w/ jitter, per-provider rate-limit, circuit breaker, dedupe, dead-letter, provider fallback |
-| **Unified observability** | Structured logging, OpenTelemetry, Prometheus metrics, normalized `EmailEvent` stream across send + webhook paths |
-| **Modern DX** | `{ data, error }` Result discriminated union, typed `Address` primitive, `react:`/`mjml:`/`handlebars:`/`liquid:` props |
-| **Testing-first** | `createTestEmail()` with inbox + `waitFor` + 5 Vitest matchers + snapshot helper |
-
-## Install
-
-```bash
-pnpm add unemail
-```
-
-Rendering, queue, and parser entries pull in optional peer deps only
-when you import them:
-
-```bash
-pnpm add @react-email/render # unemail/render/react
-pnpm add mjml # unemail/render/mjml
-pnpm add handlebars # unemail/render/handlebars
-pnpm add liquidjs # unemail/render/liquid
-pnpm add juice # htmlPipeline(inlineCss())
-pnpm add postal-mime # unemail/parse
-pnpm add @opentelemetry/api # withTelemetry
-pnpm add unstorage # unstorageQueue / unstorageSuppressionStore
-pnpm add bullmq # unemail/queue/bullmq
-pnpm add pg-boss # unemail/queue/pg-boss
-```
-
-## Hello world
+A driver-based email library for TypeScript. ESM-only, zero runtime
+dependencies, and the same code on Node, Bun, Deno, Cloudflare Workers and
+the browser.
```ts
import { createEmail } from "unemail"
-import resend from "unemail/driver/resend"
+import resend from "unemail/drivers/resend"
-const email = createEmail({ driver: resend({ apiKey: process.env.RESEND_KEY! }) })
+const email = createEmail({
+ driver: resend({ apiKey: process.env.RESEND_API_KEY! }),
+ defaults: { from: "Acme " },
+})
const { data, error } = await email.send({
- from: "Acme ",
- to: "user@example.com",
+ to: "ada@example.com",
subject: "Welcome",
- text: "Thanks for signing up.",
+ html: "Glad you are here.
",
})
-if (error) throw error // error: EmailError — typed { code, status, retryable, ... }
-console.log(data.id) // data: EmailResult — TS narrows after the error check
+if (error) console.error(error.code, error.message)
+else console.log("sent", data.id)
```
-Every driver implements the same contract, so swapping providers is a
-one-line change.
-
-### Mailtrap (Email API + Email Sandbox)
-
-```ts
-import mailtrap from "unemail/driver/mailtrap"
-
-const email = createEmail({
- driver: mailtrap({
- apiKey: process.env.MAILTRAP_API_KEY!,
- inboxId: process.env.MAILTRAP_INBOX_ID,
- sandbox: process.env.MAILTRAP_USE_SANDBOX === "true",
- }),
-})
+## Install
-await email.send({ from: "a@b.com", to: "c@d.com", subject: "Test", text: "hi", sandbox: true })
+```sh
+bun add unemail
+# npm install unemail · pnpm add unemail · yarn add unemail
```
-See [docs/drivers.md](docs/drivers.md) for Email API vs sandbox routing.
+```sh
+bun add @react-email/render # only for unemail/render/react
+```
-## Message streams (Postmark-style)
+Requires Node 20.11+ (or any runtime with `fetch` and Web Crypto). There is
+no CommonJS build.
-```ts
-import postmark from "unemail/driver/postmark"
-import ses from "unemail/driver/ses"
+## The idea
-const email = createEmail({ driver: postmark({ token }) })
-email.mount("marketing", ses({ region: "us-east-1" }))
+Three pieces, and nothing else:
-await email.send({ stream: "transactional", to, subject, text })
-await email.send({ stream: "marketing", to, subject, html })
+```
+your code ──▶ normalize ──▶ middleware ──▶ driver ──▶ provider
+ (once) (a list) (a transport)
```
-## Deliverability & compliance
+**Normalize once.** `email.send()` parses every address, validates the
+message, rejects a header containing a line break, and derives
+`List-Unsubscribe`. Drivers receive a frozen `NormalizedMessage` — which is
+why no driver in this repo parses an address, and why your message object
+is never written back into.
-**Gmail + Yahoo 2024 bulk-sender compliance is one line:**
+**One kind of middleware.** Retry, logging, rate limiting, the circuit
+breaker and idempotency are all the same shape:
```ts
-await email.send({
- from,
- to,
- subject,
- html,
- unsubscribe: {
- url: `https://app.com/u?t=${token}`, // RFC 8058 one-click
- mailto: "unsubscribe@acme.com",
- },
-})
-// → auto-injects List-Unsubscribe + List-Unsubscribe-Post headers.
+type SendHandler = (msgs, ctx) => Promise[]>
+type Middleware = { name: string; handle: (next: SendHandler) => SendHandler }
```
-**DKIM sign outbound SMTP** (RSA or Ed25519, pure Web-Crypto):
+**The unit of work is a list.** `send()` is the one-element case. This is
+what lets retry re-send _only_ the messages that failed — even when the
+driver reached the provider in a single batched request. A partial batch
+failure costs one small retry instead of a full re-send with duplicate
+deliveries.
-```ts
-import smtp from "unemail/driver/smtp"
-const driver = smtp({
- host: "smtp.acme.com",
- dkim: { selector: "s1", domain: "acme.com", privateKey: pem },
-})
-```
+## Sending
-**Suppression + preferences** stop sends before they hit the provider:
+### One message
```ts
-import { withSuppression } from "unemail/middleware"
-import { memorySuppressionStore } from "unemail/suppression"
-
-const store = memorySuppressionStore()
-// webhook handler → store.add(recipient, "bounce")
-const email = createEmail({ driver: withSuppression(resend({ apiKey }), { store }) })
+const { data, error } = await email.send({
+ to: ["ada@example.com", { email: "bob@example.com", name: "Bob" }],
+ cc: "Cee ",
+ subject: "Your invoice",
+ text: "Attached.",
+ html: "Attached.
",
+ preheader: "Invoice #1042 · due in 14 days",
+ attachments: [{ filename: "invoice.pdf", content: bytes, contentType: "application/pdf" }],
+ tags: [{ name: "campaign", value: "billing" }],
+})
```
-**Other deliverability utilities:**
-
-- `unemail/verify/arc` — ARC-Set signer (RFC 8617) for forwarders
-- `unemail/dmarc` — aggregate (RUA) XML + gzip parser
-- `unemail/mta-sts` — policy file generator + TLS-RPT JSON parser
-- `unemail/parse/arf` — RFC 5965 feedback-loop (FBL) reports
+`error` is an `EmailError` with a stable `code` (`AUTH`, `RATE_LIMIT`,
+`NETWORK`, `TIMEOUT`, `PROVIDER`, `INVALID_OPTIONS`, `UNSUPPORTED`,
+`CANCELLED`) and a `retryable` flag that means the same thing whichever
+provider produced it.
-## Provider-side templates
+### Many messages
-Eight drivers map `msg.template` into native template APIs:
+`sendBatch` never short-circuits. `results[i]` always corresponds to
+`messages[i]`:
```ts
-await email.send({
- from,
- to,
- subject,
- template: { id: "tpl_welcome", variables: { name: "Ada" } },
-})
-// → SendGrid dynamic_template_data, Postmark TemplateModel,
-// Mailgun h:X-Mailgun-Variables, Brevo params, MailerSend
-// personalization.data, Loops dataVariables, Zeptomail merge_info.
+const batch = await email.sendBatch(users.map((u) => ({ to: u.email, subject, html })))
+
+batch.ok // false if any failed
+batch.sent // the EmailResults that got through
+batch.failed // [{ index, error }] for the rest
```
-## Personalizations & batch
+One invalid address in a batch of a thousand fails its own slot and nothing
+else.
-SendGrid-style per-recipient fan-out — one batched API call when the
-driver supports it, or an automatic loop when it doesn't:
+### Very many messages
```ts
-await email.send({
- from,
- subject: "Welcome",
- personalizations: [
- { to: "ada@x.com", variables: { name: "Ada" } },
- { to: "bob@x.com", variables: { name: "Bob" }, subject: "Just for Bob" },
- ],
- template: { id: "tpl_welcome" },
-})
-
-// Or stream results for huge fan-outs:
-for await (const result of email.sendBatchStream(messages)) {
- if (result.error) report(result.error)
+for await (const result of email.sendStream(rowsFromDatabase(), { chunkSize: 100 })) {
+ if (result.error) await recordFailure(result.error)
}
```
-## Rendering
+Accepts a sync or async iterable, so the source can be a cursor. Nothing
+larger than a chunk is held in memory.
+
+## Middleware
-**React Email / jsx-email / MJML / Handlebars / Liquid** all plug in
-as renderers:
+Registered outermost-first:
```ts
-import { createEmail, withRender } from "unemail"
-import reactRender from "unemail/render/react"
-import { handlebarsRenderer } from "unemail/render/handlebars"
+import {
+ withCircuitBreaker,
+ withLogger,
+ withRateLimit,
+ withRetry,
+ rateLimitPresets,
+} from "unemail/middleware"
-const email = createEmail({ driver }).use(withRender(reactRender(), handlebarsRenderer()))
+const email = createEmail({
+ driver: resend({ apiKey }),
+ defaults: { from },
+ use: [
+ withLogger(), // measures everything below, retries included
+ withCircuitBreaker({ threshold: 5 }), // stops calling a provider that is down
+ withRetry({ retries: 3 }), // re-sends only the failures
+ withRateLimit(rateLimitPresets.resend), // one token per message, batches included
+ ],
+})
```
-**HTML post-processing pipeline** — preheader, dark-mode, CID
-auto-rewrite, juice inlining:
+| Middleware | What it does |
+| -------------------- | -------------------------------------------------------------------------------------- |
+| `withRetry` | Retries the failed indices with backoff. Honors the provider's `Retry-After`. |
+| `withRateLimit` | Token bucket. A 500-message batch takes 500 tokens, not one. |
+| `withCircuitBreaker` | Opens after N failures, probes once after the reset window. Ignores caller errors. |
+| `withLogger` | One structured entry per pipeline trip. Redacts recipients by default. |
+| `withIdempotency` | Returns the previous result for a repeated `idempotencyKey`. Only remembers successes. |
+
+### Writing one
```ts
-import {
- htmlPipeline,
- withPreheader,
- cidRewrite,
- darkModeHook,
- inlineCss,
-} from "unemail/render/pipeline"
-
-email.use(
- htmlPipeline(
- withPreheader(), // reads msg.preheader
- cidRewrite(), // 
→ cid:logo
- darkModeHook({ darkCss: "body{background:#000}" }),
- inlineCss(), // peer: juice
- ),
+import { defineMiddleware } from "unemail"
+
+const stamp = defineMiddleware(
+ "stamp",
+ (next) => (msgs, ctx) =>
+ next(
+ msgs.map((m) => ({ ...m, headers: { ...m.headers, "X-Sent-By": "acme" } })),
+ ctx,
+ ),
)
+
+email.use(stamp)
```
-**i18n** dispatches per-locale renderers:
+Return one result per message. If yours throws, or returns the wrong
+number, the core reports it per message instead of losing the batch.
-```ts
-import { i18nRenderer } from "unemail/render/i18n"
+## Drivers
-email.use(
- withRender(
- i18nRenderer({
- fallback: handlebarsRenderer({
- /* defaults */
- }),
- byLocale: {
- tr: handlebarsRenderer({
- /* tr */
- }),
- en: handlebarsRenderer({
- /* en */
- }),
- },
- }),
- ),
-)
-```
+| Driver | Import | Notes |
+| ----------- | ----------------------------- | --------------------------------------------------------- |
+| Resend | `unemail/drivers/resend` | Native batch, scheduling, cancel, retrieve |
+| Postmark | `unemail/drivers/postmark` | Message streams, templates, per-message batch errors |
+| Amazon SES | `unemail/drivers/ses` | SigV4 over Web Crypto — no `@aws-sdk/*` |
+| SMTP | `unemail/drivers/smtp` | Own protocol implementation, pooling, DKIM. Node/Bun only |
+| Mock | `unemail/drivers/mock` | Records instead of sending |
+| Fallback | `unemail/drivers/fallback` | Composite: try each provider in turn |
+| Round-robin | `unemail/drivers/round-robin` | Composite: spread across providers |
-**Calendar invites** (ICS) attach to any message:
+A driver advertises what it can do, so you gate on capability rather than
+on a name:
```ts
-import { icalEvent } from "unemail/ics"
-
-await email.send({
- from,
- to,
- subject: "Design sync",
- text: "...",
- attachments: [
- icalEvent({
- uid: "evt-1@acme.com",
- start: new Date("2026-05-01T10:00:00Z"),
- end: new Date("2026-05-01T11:00:00Z"),
- summary: "Design sync",
- organizer: { email: "host@acme.com" },
- attendees: [{ email: "ada@acme.com", rsvp: true }],
- }),
- ],
-})
+if (email.driver.features?.scheduling) await email.send({ ...msg, scheduledAt })
```
-## Resilience middleware
+### Failover
```ts
-import {
- withRetry,
- withCircuitBreaker,
- withRateLimit,
- rateLimitPresets,
- withDedupe,
- withLogger,
- withTelemetry,
- withMetrics,
- createMetricsRegistry,
-} from "unemail/middleware"
-import { trace } from "@opentelemetry/api"
+import { wrap } from "unemail"
+import { fallback } from "unemail/drivers/fallback"
-const metrics = createMetricsRegistry()
-
-email
- .use(withDedupe({ strategy: "contentHash", ttlSeconds: 60 }))
- .use(withRetry({ retries: 3, backoff: "full-jitter", deadLetter: dlqDriver }))
- .use(withRateLimit(rateLimitPresets.sendgrid()))
- .use(withCircuitBreaker({ threshold: 5, cooldownMs: 30_000 }))
- .use(withLogger({ redactLocalPart: true }))
- .use(withTelemetry({ tracer: trace.getTracer("unemail") }))
- .use(withMetrics({ registry: metrics }))
-
-// Prometheus exposition:
-app.get("/metrics", () => new Response(metrics.expose()))
+const driver = fallback([
+ wrap(resend({ apiKey }), withRetry()), // retries within the leg
+ ses({ region: "eu-central-1" }), // only sees what Resend could not send
+])
```
-### OAuth2 (Gmail / Microsoft 365)
-
-```ts
-import { oauth2Gmail } from "unemail/middleware"
-
-email.use(
- oauth2Gmail({
- clientId: process.env.GOOGLE_CLIENT_ID!,
- clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
- refreshToken: process.env.GOOGLE_REFRESH_TOKEN!,
- }),
-)
-```
+Failover is per message. If 3 of 500 fail at the primary, only those 3 go
+to the secondary — nobody receives the same mail twice.
-## Provider fallback + composition
+### Streams
```ts
-import fallback from "unemail/driver/fallback"
-import roundRobin from "unemail/driver/round-robin"
-import resend from "unemail/driver/resend"
-import ses from "unemail/driver/ses"
-
const email = createEmail({
- driver: fallback({
- drivers: [resend({ apiKey: process.env.RESEND_KEY! }), ses({ region: "us-east-1" })],
- }),
+ driver: postmark({ token, messageStream: "outbound" }),
+ mounts: { broadcast: postmark({ token: broadcastToken, messageStream: "broadcast" }) },
+ defaults: { from },
})
+
+await email.send({ ...msg, stream: "broadcast" })
```
-## Queues
+A batch spanning several streams is split across their drivers and
+reassembled in order.
-In-memory / unstorage / BullMQ / pg-boss / AWS SQS all implement the
-same `EmailQueue` contract. `msg.scheduledAt` defers the send through
-every backend:
+### Writing one
```ts
-import memoryQueue from "unemail/queue/memory"
-import { startWorker } from "unemail/queue/worker"
+import { defineDriver, ok, err, createError } from "unemail"
-const queue = memoryQueue()
-startWorker(email, queue, { concurrency: 5, maxAttempts: 5 }).start()
-
-await queue.enqueue({
- from,
- to,
- subject,
- scheduledAt: new Date(Date.now() + 60 * 60 * 1000), // send in 1h
-})
+export default defineDriver<{ apiKey: string }>((options) => ({
+ name: "acme",
+ features: { html: true, text: true },
+ async send(msg) {
+ const response = await fetch("https://api.acme.com/send", {
+ method: "POST",
+ headers: { authorization: `Bearer ${options.apiKey}` },
+ body: JSON.stringify({
+ to: msg.to.map((a) => a.email),
+ subject: msg.subject,
+ html: msg.html,
+ }),
+ })
+ if (!response.ok) return err(createError("acme", "PROVIDER", `HTTP ${response.status}`))
+ const body = await response.json()
+ return ok({ id: body.id, driver: "acme", at: new Date() })
+ },
+}))
```
-Swap for `bullmqQueue({ bull })`, `pgBossQueue({ boss })`, or
-`sqsQueue({ sqs, queueUrl })` for durable multi-process sending.
+`msg` arrives normalized. Add `sendBatch` only if the provider has a real
+batch endpoint — it must return one result per input, in order.
-## Inbound + webhooks
+## Rendering
-Pre-normalized handlers for Cloudflare Email, Postmark, SendGrid,
-Mailgun, and SES (via SNS):
+`message.content` is opaque to the core; a renderer claims it by `type`.
+Adding a template language is a package, not a core change.
```ts
-import { defineInboundHandler } from "unemail/inbound"
-import sendgridInbound from "unemail/inbound/sendgrid"
-import { defineSesInboundHandler } from "unemail/inbound/ses"
-
-export default defineInboundHandler({
- providers: [sendgridInbound()],
- onEmail(mail) {
- /* ParsedEmail */
- },
+import { withRender } from "unemail/render"
+import reactRenderer from "unemail/render/react"
+
+email.use(withRender(reactRenderer()))
+
+await email.send({
+ to,
+ subject: "Welcome",
+ content: { type: "react", element: },
})
```
-**Reply-only text extraction** (EN/TR/DE/FR/ES):
+The plain-text alternative is derived from the HTML unless you set `text`
+or the renderer produces one. Your message object is never mutated.
```ts
-import { stripReply } from "unemail/inbound/reply"
-import { threadKey } from "unemail/inbound/thread"
+import { defineTemplate } from "unemail/render"
+
+const welcome = defineTemplate<{ name: string }>(({ name }) => ({
+ subject: `Welcome, ${name}`,
+ content: { type: "react", element: },
+}))
-const { text, quoted } = stripReply(parsed.text ?? "")
-const thread = threadKey(parsed) // canonical root Message-ID
+await email.send({ to, ...welcome({ name: "Ada" }) })
```
-**Webhook signature verification** — Resend, Postmark, Mailgun,
-SendGrid, SES, plus a zero-dep **Standard Webhooks**
-(`standardwebhooks.com`) verifier that's <5 kB (vs Svix's ~1 MB):
+Your own renderer:
```ts
-import { verifyStandardWebhook } from "unemail/webhook/standard"
+import type { Renderer } from "unemail/render"
-const body = await verifyStandardWebhook(request, {
- secret: process.env.WHSEC!,
-})
+const markdown: Renderer = {
+ name: "markdown",
+ type: "markdown",
+ render: (content) => ({ html: toHtml(content.source as string) }),
+}
```
-## Unified event stream
-
-Send events + webhook events converge on one `EmailEvent` shape:
+## Testing
```ts
-import { EventBus, withEvents, memoryEventStore } from "unemail/events"
+import { createEmail } from "unemail"
+import mock from "unemail/drivers/mock"
-const bus = new EventBus()
-const store = memoryEventStore()
-bus.on((e) => store.append(e))
+const driver = mock()
+const email = createEmail({ driver, defaults: { from: "hi@acme.com" } })
-const email = createEmail({ driver: withEvents(resend({ apiKey }), bus) })
+await email.send({ to: "ada@example.com", subject: "hi", text: "hello" })
-// later:
-const timeline = await store.list!(messageId)
-// [send.queued, send.attempt, send.success, delivered, opened, ...]
+const inbox = driver.getInstance()
+inbox.last()?.subject // "hi"
+inbox.find("ada@example.com") // every message addressed to Ada
```
-## Typed addresses
-
-Validate at system boundaries — rejects malformed input before it
-reaches a driver:
+Simulate failures without a network:
```ts
-import { parseAddress } from "unemail/address"
-
-const { data, error } = parseAddress("Ada ")
-if (error) throw error
-data.local // "ada"
-data.domain // "acme.com"
+mock({ fail: { code: "RATE_LIMIT" } }) // everything fails
+mock({ failWhen: (msg, i) => i === 1 }) // partial batch failure
+mock({ latencyMs: 50 }) // slow provider
```
-## Testing
+## API
-```ts
-import { createTestEmail, emailMatchers, toEmailSnapshot } from "unemail/test"
-import { expect } from "vitest"
+### `createEmail(options)`
-expect.extend(emailMatchers)
+| Option | Type | |
+| ---------- | ---------------------------------------------------- | ---------------------------------- |
+| `driver` | `EmailDriver` | Required |
+| `mounts` | `Record` | Routed by `message.stream` |
+| `use` | `Middleware[]` | Outermost first |
+| `defaults` | `{ from, replyTo, headers, tags, metadata, stream }` | Applied to messages that omit them |
+| `signal` | `AbortSignal` | Cancels in-flight sends |
-const email = createTestEmail()
-await onboardingFlow(email, user)
+Returns an `Email` with `send`, `sendBatch`, `sendStream`, `cancel`,
+`retrieve`, `use`, `mount`, `unmount`, `getMount`, `getMounts`,
+`isAvailable` and `dispose`.
-expect(email).toHaveSentTo("ada@acme.com")
-expect(email).toHaveSentWithSubject(/welcome/i)
-expect(email).toHaveSentWithAttachment("invite.ics")
-expect(email).toHaveSentMatching((m) => m.metadata?.userId === user.id)
-expect(toEmailSnapshot(email.last!)).toMatchSnapshot()
-```
+`cancel` and `retrieve` return `UNSUPPORTED` on a driver that lacks them,
+rather than throwing.
-## Authoring a driver
+### Message
-```ts
-import { defineDriver } from "unemail"
+`from` `to` `cc` `bcc` `replyTo` `subject` `preheader` `text` `html`
+`content` `headers` `attachments` `tags` `metadata` `idempotencyKey`
+`scheduledAt` `unsubscribe` `template` `tracking` `sandbox` `raw` `stream`
-export default defineDriver<{ apiKey: string }>((opts) => ({
- name: "my-driver",
- options: opts,
- flags: { html: true, attachments: true, batch: true, cancelable: true },
- async send(msg) {
- const res = await fetch("https://api.example.com/send", {
- method: "POST",
- headers: { authorization: `Bearer ${opts!.apiKey}` },
- body: JSON.stringify(msg),
- })
- if (!res.ok) return { data: null, error: new Error("send failed") as never }
- const body = (await res.json()) as { id: string }
- return { data: { id: body.id, driver: "my-driver", at: new Date() }, error: null }
- },
- async cancel(id) {
- /* optional */
- },
- async retrieve(id) {
- /* optional */
- },
-}))
-```
+Addresses accept `"a@b.com"`, `"Ada "`, `{ email, name }`, or a
+list of any of those.
-## Result helpers
+## Compatibility
-```ts
-import { isOk, isErr, unwrap, unwrapOr, mapOk, tryAsync } from "unemail/result"
+| Runtime | Core | HTTP drivers | SMTP |
+| ------------------ | ---- | ------------ | ---- |
+| Node 20.11+ | ✅ | ✅ | ✅ |
+| Bun | ✅ | ✅ | ✅ |
+| Deno | ✅ | ✅ | — |
+| Cloudflare Workers | ✅ | ✅ | — |
+| Browser | ✅ | ✅ | — |
-const res = await email.send({ ... })
-if (isOk(res)) console.log(res.data.id)
-const id = unwrapOr(res, { id: "offline", driver: "mock", at: new Date() }).id
-```
+SMTP needs `node:net` and `node:tls`. Everything else is `fetch` and Web
+Crypto.
## Docs
-- [docs/drivers.md](./docs/drivers.md) — driver matrix + authoring guide + error taxonomy
-- [docs/rendering.md](./docs/rendering.md) — React Email / jsx-email / MJML / Handlebars / Liquid / i18n / HTML pipeline
-- [docs/inbound.md](./docs/inbound.md) — `unemail/parse` + unified inbound handler + reply stripper + thread stitcher
-- [docs/webhooks.md](./docs/webhooks.md) — signature verification for 6 providers + Standard Webhooks
-- [docs/deliverability.md](./docs/deliverability.md) — DKIM + ARC + List-Unsubscribe + DMARC + MTA-STS + suppression + preferences
-- [docs/testing.md](./docs/testing.md) — `createTestEmail`, `waitFor`, 5 Vitest matchers + snapshots
-- [docs/observability.md](./docs/observability.md) — logging + OTel + Prometheus metrics + unified event stream
-- [docs/queue.md](./docs/queue.md) — memory / unstorage / BullMQ / pg-boss / SQS
-- [docs/rfcs/001-packaging.md](./docs/rfcs/001-packaging.md) — why single package with sub-paths
-- [MIGRATION.md](./MIGRATION.md) — upgrading from v0.x
+- [Architecture](./docs/architecture.md) — the pipeline, and why the unit of
+ work is a list
+- [Drivers](./docs/drivers.md) — every option, provider quirks, capability
+ matrix
+- [Migration](./MIGRATION.md) — upgrading from 0.x
-## License
+## Upgrading from 0.x
+
+v1 is a rewrite. See [MIGRATION.md](./MIGRATION.md).
+
+## Contributing
-Published under the [MIT](./LICENSE) license. Made by
-[@productdevbook](https://github.com/productdevbook) and
-[community](https://github.com/productdevbook/unemail/graphs/contributors).
+```sh
+bun install
+bun run check # lint, typecheck, tests, version consistency
+bun run build
+```
+
+## License
-Architecture inspired by [`unjs/unstorage`](https://github.com/unjs/unstorage).
+[MIT](./LICENSE) © [productdevbook](https://github.com/productdevbook)
diff --git a/bun.lock b/bun.lock
new file mode 100644
index 0000000..75e9870
--- /dev/null
+++ b/bun.lock
@@ -0,0 +1,453 @@
+{
+ "lockfileVersion": 2,
+ "configVersion": 1,
+ "workspaces": {
+ "": {
+ "name": "unemail",
+ "devDependencies": {
+ "@types/node": "^26.0.0",
+ "@typescript/native-preview": "7.0.0-dev.20260707.2",
+ "@vitest/coverage-v8": "^4.1.9",
+ "bumpp": "^12.2.2",
+ "obuild": "^0.4.36",
+ "oxfmt": "^0.66.0",
+ "oxlint": "^1.70.0",
+ "typescript": "^7.0.2",
+ "vitest": "^4.1.9",
+ },
+ "peerDependencies": {
+ "@react-email/render": "*",
+ },
+ "optionalPeers": [
+ "@react-email/render",
+ ],
+ },
+ },
+ "packages": {
+ "@babel/helper-string-parser": ["@babel/helper-string-parser@7.29.7", "", {}, "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw=="],
+
+ "@babel/helper-validator-identifier": ["@babel/helper-validator-identifier@7.29.7", "", {}, "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg=="],
+
+ "@babel/parser": ["@babel/parser@7.29.8", "", { "dependencies": { "@babel/types": "^7.29.8" }, "bin": "./bin/babel-parser.js" }, "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA=="],
+
+ "@babel/types": ["@babel/types@7.29.8", "", { "dependencies": { "@babel/helper-string-parser": "^7.29.7", "@babel/helper-validator-identifier": "^7.29.7" } }, "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg=="],
+
+ "@bcoe/v8-coverage": ["@bcoe/v8-coverage@1.0.2", "", {}, "sha512-6zABk/ECA/QYSCQ1NGiVwwbQerUCZ+TQbp64Q3AgmfNvurHH0j8TtXa1qbShXA6qqkpAj4V5W8pP6mLe1mcMqA=="],
+
+ "@jridgewell/resolve-uri": ["@jridgewell/resolve-uri@3.1.2", "", {}, "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw=="],
+
+ "@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.6.0", "", {}, "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw=="],
+
+ "@jridgewell/trace-mapping": ["@jridgewell/trace-mapping@0.3.31", "", { "dependencies": { "@jridgewell/resolve-uri": "^3.1.0", "@jridgewell/sourcemap-codec": "^1.4.14" } }, "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw=="],
+
+ "@oxc-project/types": ["@oxc-project/types@0.147.0", "", {}, "sha512-IJ3s6ltHLp45S0bh7phkX+gJO7A1Wuz2EaqpAhb8WjqDwbzMiWKHhyyT42tskaWjEYXtHtVCPpnBJVT9+dcRLg=="],
+
+ "@oxfmt/binding-android-arm-eabi": ["@oxfmt/binding-android-arm-eabi@0.66.0", "", { "os": "android", "cpu": "arm" }, "sha512-2Me9eoptv6ERdEuI2P8AOlYdHHraXebJaM6SC0kc2Dfb+mLrep2db+fedBPKaYn673h/vBgvP4tkOdAbaudX6w=="],
+
+ "@oxfmt/binding-android-arm64": ["@oxfmt/binding-android-arm64@0.66.0", "", { "os": "android", "cpu": "arm64" }, "sha512-u7O+bSSF0HGsDKkQQxBqvLGVepu93RA+JKu+ONqvfh4sCnCEbj31wZj4iG5gk3XfRwrmYj0/8catkO2LcblQKQ=="],
+
+ "@oxfmt/binding-darwin-arm64": ["@oxfmt/binding-darwin-arm64@0.66.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-/ikyMIVjX/sdo7KtjxoEsSUosfPzveVhT9RWMx9yGqFDKFJ89JAEKuEeLBmurDjrkb4w8tOnAdSO3SBaplY3bw=="],
+
+ "@oxfmt/binding-darwin-x64": ["@oxfmt/binding-darwin-x64@0.66.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-q5xUsKeFqawa9NXa6ZGXWimFV19m8MogKPdTaSVDAAk2EQKBmBZRDeluwcl1p8ty/OFc9s9888OKEh3xfPVH0g=="],
+
+ "@oxfmt/binding-freebsd-x64": ["@oxfmt/binding-freebsd-x64@0.66.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-CR+x4VzMY0pRXLK/xFQ/RzsSFkP5t2Z2mef0QY6OP/rTRcMUoMLCOM62/3Fp/t0K+UDoBKxvMyeb6D0zPMjleA=="],
+
+ "@oxfmt/binding-linux-arm-gnueabihf": ["@oxfmt/binding-linux-arm-gnueabihf@0.66.0", "", { "os": "linux", "cpu": "arm" }, "sha512-ZEYmO/LbH9tTQCADILHGZE4GeOXOAj2VzedHkASNwjmwlwtutJCLpCJbIs37wRGTFgWRoEcD72jpMX+IBJUGjQ=="],
+
+ "@oxfmt/binding-linux-arm-musleabihf": ["@oxfmt/binding-linux-arm-musleabihf@0.66.0", "", { "os": "linux", "cpu": "arm" }, "sha512-hNtR9/oU0CeTkq7JnRkmBQwqe17v2ZaAMLC4VcN7IIOWeRyWDk0knSPWS9iiLmtbZ2RRBBtsG01jQgkZmKCJeQ=="],
+
+ "@oxfmt/binding-linux-arm64-gnu": ["@oxfmt/binding-linux-arm64-gnu@0.66.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-uwOVQ8i6I1LT/+eDzfsgrrcZp8Fn6NPVUPn8fF5gdFGekFf0PddF+LEuwsD0/pbNUcKZhDj2rQ5UpITh9gF4iQ=="],
+
+ "@oxfmt/binding-linux-arm64-musl": ["@oxfmt/binding-linux-arm64-musl@0.66.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-tTkF2Dmx4nGAjmBlZb+UtTGqR/EK4ZrW9qBfzte07a9XWqzoGGKzpFFlyNDhQe+Uwql94+ReCTeNbhOXscw1Dg=="],
+
+ "@oxfmt/binding-linux-ppc64-gnu": ["@oxfmt/binding-linux-ppc64-gnu@0.66.0", "", { "os": "linux", "cpu": "ppc64" }, "sha512-F3cKHUav4yXOHn6GFnwpBhSYsJOYKKf9eqO/9jlEuqPxNw9zb98E9ZFct79gcg8pibUGkbveEu9WDlmXJpDzKw=="],
+
+ "@oxfmt/binding-linux-riscv64-gnu": ["@oxfmt/binding-linux-riscv64-gnu@0.66.0", "", { "os": "linux", "cpu": "none" }, "sha512-K5fDaNZfDyQMYA/3qL21bqyN0X9T15LLwwbFPt2aHc94+ZG7bh0vZEsy2y7NlRnjjHFSwN+Hzg6ldJtbOriH4Q=="],
+
+ "@oxfmt/binding-linux-riscv64-musl": ["@oxfmt/binding-linux-riscv64-musl@0.66.0", "", { "os": "linux", "cpu": "none" }, "sha512-44Yc+I+qOmTElRcEhm5hUKIUJEQIOugymz4ua4tB0Wox7tGAfIbjzmXz/HDAtw1Ij6gmBwZlzh4hc9679RhWeA=="],
+
+ "@oxfmt/binding-linux-s390x-gnu": ["@oxfmt/binding-linux-s390x-gnu@0.66.0", "", { "os": "linux", "cpu": "s390x" }, "sha512-1e29Eg9hEj2kRBB19M0seIehPbbXHCk35GvImjDvb79rjjYjXCRmtbUNHJcgoktZAMIzXrTbxDBKmTc1V4bg3A=="],
+
+ "@oxfmt/binding-linux-x64-gnu": ["@oxfmt/binding-linux-x64-gnu@0.66.0", "", { "os": "linux", "cpu": "x64" }, "sha512-vODY1UQo10gngn0+D4xHKU84F1Twm1LqrzV4SqPXvmQKSd87paehvZ6jqA5wKs6XQrlWul9clYMDVHcoW9CPMA=="],
+
+ "@oxfmt/binding-linux-x64-musl": ["@oxfmt/binding-linux-x64-musl@0.66.0", "", { "os": "linux", "cpu": "x64" }, "sha512-YDzXx2JsT4+HL4MdkVrYjO55NS5lUKNm8rLC4ZPou8+seu0v0jhecSh+ufoO6+xEa8gccEezMlI2WHJi4ApUgw=="],
+
+ "@oxfmt/binding-openharmony-arm64": ["@oxfmt/binding-openharmony-arm64@0.66.0", "", { "os": "none", "cpu": "arm64" }, "sha512-mJjUYd8lj0+j4JkYyEM+5qKBf1Rnrpgjn/SVYKJhicVDqLz566ooa7Fs8zflPqt+dnZDV7X054rVIQX6ZcQNlQ=="],
+
+ "@oxfmt/binding-win32-arm64-msvc": ["@oxfmt/binding-win32-arm64-msvc@0.66.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-soV+0vESv7e5ntCHWC61x4gg8OSak6IHHnWsZmHrJFlvMj2AK+kmldErCNkVkrvc1Ts2/++rJXn+IuAb2WMXhw=="],
+
+ "@oxfmt/binding-win32-ia32-msvc": ["@oxfmt/binding-win32-ia32-msvc@0.66.0", "", { "os": "win32", "cpu": "ia32" }, "sha512-YCPi23uRIEYuIKTZohAkKbPFpujQ5QBuUM5iDv+UqbCmTPAkaFsxjsSuB8xlBpRT0G7eP/4HMF+cPDSqHtOD9A=="],
+
+ "@oxfmt/binding-win32-x64-msvc": ["@oxfmt/binding-win32-x64-msvc@0.66.0", "", { "os": "win32", "cpu": "x64" }, "sha512-bwTQcv/JVRPkOqQtMF0X7vpvpncDQiBcXHxZ9S2hR12Hlo8bvBdUR5x5XnxzDZ3kM0qoZw1rv7KaD66Ly+pFWA=="],
+
+ "@oxlint/binding-android-arm-eabi": ["@oxlint/binding-android-arm-eabi@1.81.0", "", { "os": "android", "cpu": "arm" }, "sha512-IcCRsXiedJoJopY6mpZUBEeVFsUrutmrG7dZ87zMuKJlhg70Ora9bBl1WcCxZQtyI10YpnVdEso5oCg7YcfSHw=="],
+
+ "@oxlint/binding-android-arm64": ["@oxlint/binding-android-arm64@1.81.0", "", { "os": "android", "cpu": "arm64" }, "sha512-GRrIPyTGVhx3L3h+0T5xT2A0jFAcdPv4+IfuXpGDLIdl6XeYhgg/zw72A5ILZoUgRqZuM8F1y+V/gfDriXSxzQ=="],
+
+ "@oxlint/binding-darwin-arm64": ["@oxlint/binding-darwin-arm64@1.81.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-qNQ9tXRgLuKbqSV1S2h9h4KPHjbovO7RRR2/enUOtHzTkFZ7B9X5zqqHJua8dRyc7dBy7Aoyq5pqTSLFVcAzGQ=="],
+
+ "@oxlint/binding-darwin-x64": ["@oxlint/binding-darwin-x64@1.81.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-q0QTm32jWga2Gv4j7IaVZN0jYMi9UV73sWVgFtDA4iIfqwMCLLZ3ve+9KwfYtsaKZSgQhmPaogeZWqDZpcY1Pw=="],
+
+ "@oxlint/binding-freebsd-x64": ["@oxlint/binding-freebsd-x64@1.81.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-/+8wVWDXEC7wHVAhOc59Fw/SkMc1arLkFD8iQCaSsmzenK1X4doFqquL9H1wrtGUzaiycVqkf/sSpcILK6W1UA=="],
+
+ "@oxlint/binding-linux-arm-gnueabihf": ["@oxlint/binding-linux-arm-gnueabihf@1.81.0", "", { "os": "linux", "cpu": "arm" }, "sha512-4xt422FEgioRq9hAL4Tq7fujGUWnc8z1BJ+Oi8RN8vB8axaP+sdK6a2xdlcQCCYnJg9QMuMFS0AucuIFx/EacA=="],
+
+ "@oxlint/binding-linux-arm-musleabihf": ["@oxlint/binding-linux-arm-musleabihf@1.81.0", "", { "os": "linux", "cpu": "arm" }, "sha512-u3vna8KdGplH4DRCW9K54D68fcMo7IxVrkCJWwXnIhwtBdnDnYrmzOUA/XjmBlPpcLsgw9Z5BNdY4za9+Dj+MQ=="],
+
+ "@oxlint/binding-linux-arm64-gnu": ["@oxlint/binding-linux-arm64-gnu@1.81.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-3j9k+gsYsE7nv71GWotXsqsa2l9/aJenD7dVHNt/CBvsb0SgRjSMnHFeP59IXUAl1wvVFhqGl2wJNMwWU3UBlA=="],
+
+ "@oxlint/binding-linux-arm64-musl": ["@oxlint/binding-linux-arm64-musl@1.81.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-k5iAp3dNxW0/uDCBY+WSm8jKB2szu7SkEQZdgRRpDXvuDd69vvDcqhB3A/pWCfCwXyenjNjFn9Td1fVoyAc+Yg=="],
+
+ "@oxlint/binding-linux-ppc64-gnu": ["@oxlint/binding-linux-ppc64-gnu@1.81.0", "", { "os": "linux", "cpu": "ppc64" }, "sha512-TFqLja3uYmVSte6nof9GWrex9Z8WgdZrNiLC6Te5rXGDqXB2y4j/26iFhwosXiAFqDhE9JJVuuCkDKLwptTn1g=="],
+
+ "@oxlint/binding-linux-riscv64-gnu": ["@oxlint/binding-linux-riscv64-gnu@1.81.0", "", { "os": "linux", "cpu": "none" }, "sha512-UEcySvGS0NOVo7h7n7CYyJL9+6gFAh7Zc/ToDXVScFvzHSTIxtzkMVU30rmQ6+nQ1LF+UdiRDdJajpDu+OylLg=="],
+
+ "@oxlint/binding-linux-riscv64-musl": ["@oxlint/binding-linux-riscv64-musl@1.81.0", "", { "os": "linux", "cpu": "none" }, "sha512-H+diDbhD00+wI1IRP8Kz88x/lat+DgtoBJzoTthS16xkTJGNaEkfb8gzmd1rzc/2uDQQMl7GNl+JFUacVeWxIA=="],
+
+ "@oxlint/binding-linux-s390x-gnu": ["@oxlint/binding-linux-s390x-gnu@1.81.0", "", { "os": "linux", "cpu": "s390x" }, "sha512-8znJ/5TekjOKg1j1Acho4PJMdiAHLtlcXuWEiipOhAMV6rQcXdmDdXCbheyDczN6TjBwiNfjcP81k4AthrKRzw=="],
+
+ "@oxlint/binding-linux-x64-gnu": ["@oxlint/binding-linux-x64-gnu@1.81.0", "", { "os": "linux", "cpu": "x64" }, "sha512-Q2Wj70yFsvn5QjlmifFzbj4H+kJy53bwqc41o1fzoM7MpLV1NIbhg/LpWXRfC6KOkSAdUx1Wd8VJsdPmhp/HRA=="],
+
+ "@oxlint/binding-linux-x64-musl": ["@oxlint/binding-linux-x64-musl@1.81.0", "", { "os": "linux", "cpu": "x64" }, "sha512-cPInHp/ddEe5qkyK2IiyQ8Q3Mp2oLLEhhsGgTK2oZx4L6+llGam1H1yBvJZ7qHfOXj8N3hxBS8sj4tO+gtFlIg=="],
+
+ "@oxlint/binding-openharmony-arm64": ["@oxlint/binding-openharmony-arm64@1.81.0", "", { "os": "none", "cpu": "arm64" }, "sha512-0CQxSX4ajqm07AHBf5U33qQzXKdd7wtq/oTL/7vpY6RNNuxrRi8W4bqUV1Jyu/vj+9KmxQyDhxfeVX1nQL6kfg=="],
+
+ "@oxlint/binding-win32-arm64-msvc": ["@oxlint/binding-win32-arm64-msvc@1.81.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-l0hbeISm9673hVrrQU8j/p2M7YH9Ouoj7p7E/QM55NTrKVLP+P3PF8hLu+OY+x0VtGRW+ggiQKZqmdYps9H+TA=="],
+
+ "@oxlint/binding-win32-ia32-msvc": ["@oxlint/binding-win32-ia32-msvc@1.81.0", "", { "os": "win32", "cpu": "ia32" }, "sha512-ksqPP5jbFXcYreEQ7zdJh06rJQBymCTyGRCdaXjfcf2aG4f8KxUWY5wcgYHmaTK+FJ4bPG5sUAdOX+6trnH1JA=="],
+
+ "@oxlint/binding-win32-x64-msvc": ["@oxlint/binding-win32-x64-msvc@1.81.0", "", { "os": "win32", "cpu": "x64" }, "sha512-IZuUCwGw9emG5JtCp+fYGB+Z4OWEoeEcM8R5BA1pYw63/ieYFVdcU2ylxTpHbVHSenZnsYE+ZZ20uHAJszQ4cA=="],
+
+ "@quansync/fs": ["@quansync/fs@1.0.0", "", { "dependencies": { "quansync": "^1.0.0" } }, "sha512-4TJ3DFtlf1L5LDMaM6CanJ/0lckGNtJcMjQ1NAV6zDmA0tEHKZtxNKin8EgPaVX1YzljbxckyT2tJrpQKAtngQ=="],
+
+ "@rolldown/binding-android-arm-eabi": ["@rolldown/binding-android-arm-eabi@1.2.6", "", { "os": "android", "cpu": "arm" }, "sha512-b+jTcARdTiFLI6jB4a5XjTm0RWd6KcRfQj/I2356fxUZemiho9zQLxo0RtCuMDAyKcLo6cEltkgbQp6d1+sjjQ=="],
+
+ "@rolldown/binding-android-arm64": ["@rolldown/binding-android-arm64@1.2.6", "", { "os": "android", "cpu": "arm64" }, "sha512-lkWU8ZJaRk9q3CIEY1Tc7vIFALp3Xw5NfGJo2hQg5oIqNgxWi1zI+IiDEK3r70BF5Dzol1tcXsnzsRc8NLhG+Q=="],
+
+ "@rolldown/binding-darwin-arm64": ["@rolldown/binding-darwin-arm64@1.2.6", "", { "os": "darwin", "cpu": "arm64" }, "sha512-dgR56NYnvAszm7Ob1B2/Vn0e8bUQYZH2UjVaMMtMVOCKFSfjhfLmuA/9+O+F+ajUdG6B/bSssrKW6JJYASa8jA=="],
+
+ "@rolldown/binding-darwin-x64": ["@rolldown/binding-darwin-x64@1.2.6", "", { "os": "darwin", "cpu": "x64" }, "sha512-vpVxFvUCFioJqug7OTvqptkc4yb8UX0AwfDmJpaR/0sWz+BUmqSVAf7c8JkUgnN8YLspb4a/N6NhTyMAmdyQ7Q=="],
+
+ "@rolldown/binding-freebsd-x64": ["@rolldown/binding-freebsd-x64@1.2.6", "", { "os": "freebsd", "cpu": "x64" }, "sha512-h1wG6Y6K3JlRswxsI64qQJqBAy4vrLuHgRbc8CZMGSWTOFRY6ghMApM1NKzB2I0n5xV1fjkE18SuVl2QpLeNpA=="],
+
+ "@rolldown/binding-linux-arm-gnueabihf": ["@rolldown/binding-linux-arm-gnueabihf@1.2.6", "", { "os": "linux", "cpu": "arm" }, "sha512-tbCiqub0q2MVWJKgF5PoAlNWCtQydiOYSLIkd8sByqK/6MMYLJRcSXSYodqYtd0O+Fw7QaVmKKlS4oL94YRZ0w=="],
+
+ "@rolldown/binding-linux-arm64-gnu": ["@rolldown/binding-linux-arm64-gnu@1.2.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-oxK9+baEBPhZG5HB4URY+uU04zJWeZlH6Tb9rB5DK4DF9XR1uXNLXt5Q5ZsugTKayNCNLhkcwz/ye74hRI98dg=="],
+
+ "@rolldown/binding-linux-arm64-musl": ["@rolldown/binding-linux-arm64-musl@1.2.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-muWCk27FVBEZtv0MsK8gnfSmgczA8KQ0uRVJbTABKhkRfQc38aUrcb7fhi3BNiyseFmgcRsoMfQsSNJ+DbZdSw=="],
+
+ "@rolldown/binding-linux-ppc64-gnu": ["@rolldown/binding-linux-ppc64-gnu@1.2.6", "", { "os": "linux", "cpu": "ppc64" }, "sha512-eWDoSfU7Co2qj3vgB3Dt4lj1mG6CoWbcJQkRMP3XJplyCMtuaq3LHvPFjS9QIPvMGWVadJC04Xiy0IdcVPtnwQ=="],
+
+ "@rolldown/binding-linux-s390x-gnu": ["@rolldown/binding-linux-s390x-gnu@1.2.6", "", { "os": "linux", "cpu": "s390x" }, "sha512-2bWNjRSIayvupRKxXUY2tWG9fYdoUlTqWywHRvE8Eq3GvuQ+f2HeIkve697fIt+IQs/PV8yFsdWuhp1aJ1PdnA=="],
+
+ "@rolldown/binding-linux-x64-gnu": ["@rolldown/binding-linux-x64-gnu@1.2.6", "", { "os": "linux", "cpu": "x64" }, "sha512-KekI0gS0wLxe1UBSQSjenBVwou/JkcQPDzBPICGZjxUv9k3RteHDPBQaiOicZUFKRIH2wKEimGwVpnJsbPzu7w=="],
+
+ "@rolldown/binding-linux-x64-musl": ["@rolldown/binding-linux-x64-musl@1.2.6", "", { "os": "linux", "cpu": "x64" }, "sha512-TvtPnfVr+HtyGiDmPK4VWmlNm7QhNNAcK5Q9A7aOXsI8545yCyaoMaicXrFZ72JzeYjaUVk7yT243zT0jzjFKQ=="],
+
+ "@rolldown/binding-openharmony-arm64": ["@rolldown/binding-openharmony-arm64@1.2.6", "", { "os": "none", "cpu": "arm64" }, "sha512-iOo0VEay2XFhaCcH0sps5XIimkSuOnNaZrf6+ZkoSOQBJPKNU48RkmJv0/lSpipexu5P+ouFgafe5IGr/DiQfg=="],
+
+ "@rolldown/binding-win32-arm64-msvc": ["@rolldown/binding-win32-arm64-msvc@1.2.6", "", { "os": "win32", "cpu": "arm64" }, "sha512-y5NTmmasMS455JlOCO4ZM9krIchv3Mvm1crL1iUPGOPgEzSkves9n0SdC5Sjz6+qWDFhd8/JpfWMH8NSWNHe+A=="],
+
+ "@rolldown/binding-win32-x64-msvc": ["@rolldown/binding-win32-x64-msvc@1.2.6", "", { "os": "win32", "cpu": "x64" }, "sha512-np8iZSLfXlAD4kWhiyq/u0Yt8oZDtRQ8lGhQaCXo2rl37KNjeU0GjJuwr4P3oeZ++ROfofsKNBqR5LTO8aXyWQ=="],
+
+ "@rolldown/pluginutils": ["@rolldown/pluginutils@1.0.1", "", {}, "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw=="],
+
+ "@standard-schema/spec": ["@standard-schema/spec@1.1.0", "", {}, "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w=="],
+
+ "@types/chai": ["@types/chai@5.2.3", "", { "dependencies": { "@types/deep-eql": "*", "assertion-error": "^2.0.1" } }, "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA=="],
+
+ "@types/deep-eql": ["@types/deep-eql@4.0.2", "", {}, "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw=="],
+
+ "@types/estree": ["@types/estree@1.0.9", "", {}, "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg=="],
+
+ "@types/node": ["@types/node@26.4.1", "", { "dependencies": { "undici-types": "~8.3.0" } }, "sha512-k97ENvZWtvA6yqz5/FS6a7duDgOPEeOQOc2iKS/nY6mX6qJUKtLnWzQS+Xj6tXweyj6ZcTAK2Qecetnvi9nCLA=="],
+
+ "@typescript/native-preview": ["@typescript/native-preview@7.0.0-dev.20260707.2", "", { "optionalDependencies": { "@typescript/native-preview-darwin-arm64": "7.0.0-dev.20260707.2", "@typescript/native-preview-darwin-x64": "7.0.0-dev.20260707.2", "@typescript/native-preview-linux-arm": "7.0.0-dev.20260707.2", "@typescript/native-preview-linux-arm64": "7.0.0-dev.20260707.2", "@typescript/native-preview-linux-x64": "7.0.0-dev.20260707.2", "@typescript/native-preview-win32-arm64": "7.0.0-dev.20260707.2", "@typescript/native-preview-win32-x64": "7.0.0-dev.20260707.2" }, "bin": { "tsgo": "bin/tsgo" } }, "sha512-oUGp+Rep/hqMhPunyinsALUwSlzHINSxitifPiSaeqoKOKD2OlR9NE3TaPqwsl4NlGslsOSUXI1JotWQzpYCPg=="],
+
+ "@typescript/native-preview-darwin-arm64": ["@typescript/native-preview-darwin-arm64@7.0.0-dev.20260707.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-wny2pgKjGbiZtnOIHVa3tXC1UfDqxNEFzyPGmiqybedG8hipG2Nfp0l5UxbaKCjkLacUpH/W5bP2hBOMVhCOzg=="],
+
+ "@typescript/native-preview-darwin-x64": ["@typescript/native-preview-darwin-x64@7.0.0-dev.20260707.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-Afc7M5zOwo+GpfcYwz5Z8HMB2tPVsui7nNIqEuuFB73MPdVqNn/Wmpe4tP4MRri0AtJnJknoHBaTJ/VDAp/Jhw=="],
+
+ "@typescript/native-preview-linux-arm": ["@typescript/native-preview-linux-arm@7.0.0-dev.20260707.2", "", { "os": "linux", "cpu": "arm" }, "sha512-hJm/UOqZTr9FHmR7uNm8VGX4oKtfWk0Jem0zPeJFNC8ckGUfSBueyiEYMZB+XmRc1aG4x1E46y3CplP4CLHvGQ=="],
+
+ "@typescript/native-preview-linux-arm64": ["@typescript/native-preview-linux-arm64@7.0.0-dev.20260707.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-iITBa2WjjTI5N9t5l7Z4KoOSI+2zBlhbvFzsD/f8qX8QoKjz/Y4DPyBDgezYi8nkqjjksbgSOJ3/ykzhwrB9cg=="],
+
+ "@typescript/native-preview-linux-x64": ["@typescript/native-preview-linux-x64@7.0.0-dev.20260707.2", "", { "os": "linux", "cpu": "x64" }, "sha512-du0dzi6y97Po5vDNdPJTyyijHCpaS22JLRnKZEJXBDaO9gCIymOv/5QQokFRuOlQm0bWl3i9PF4OVdGP6uAOQA=="],
+
+ "@typescript/native-preview-win32-arm64": ["@typescript/native-preview-win32-arm64@7.0.0-dev.20260707.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-SsAwfhyHJ1akgBc+99z4+hwdbHsdWaKB8EwCNIMA6JfSLMeUjffrYvxu+vfMyxVtOVOz7RrRXRoiDiu4a2sCtg=="],
+
+ "@typescript/native-preview-win32-x64": ["@typescript/native-preview-win32-x64@7.0.0-dev.20260707.2", "", { "os": "win32", "cpu": "x64" }, "sha512-DL4u27stv0fo71sVhOzHSwE+YMZsbBijVI+kg5dLDLilSH79WFTJ8RSQ46vJrCMt+Gjlv/JOZP1PuLJDfioYeQ=="],
+
+ "@typescript/typescript-aix-ppc64": ["@typescript/typescript-aix-ppc64@7.0.2", "", { "os": "aix", "cpu": "ppc64" }, "sha512-MTKKkWB7p/0E9xi1d1tHtZ5PiLkGEMIq88pK2CubZjOsLtYTLqhgIgi6zepFa+9GHZ6h05NMCkQxGKiPXMxXtQ=="],
+
+ "@typescript/typescript-darwin-arm64": ["@typescript/typescript-darwin-arm64@7.0.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-gowzar9MwS/aRWp6f3a4KUqzRjAZjOsmGNCM6LcTgXum+dBfgsBVMN+AgvOCCbguXyick6LJhpBszxMebJ8syA=="],
+
+ "@typescript/typescript-darwin-x64": ["@typescript/typescript-darwin-x64@7.0.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-SZ9xZInqApNlNGc9s0W1VSsktYSOe9cFqNOIqmN1Gs8SmkjKZYFt017G4VwPxASInODuAdbTW7sXiFUf893RgA=="],
+
+ "@typescript/typescript-freebsd-arm64": ["@typescript/typescript-freebsd-arm64@7.0.2", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-W5NH4y/J0plIIS5b2xvTEkU7JFxyqdMAOgf+Ilhl0vHQXKO5dZoxd+C/jEtq56c4F3wk71RB4BMRQ2XdI+bwYQ=="],
+
+ "@typescript/typescript-freebsd-x64": ["@typescript/typescript-freebsd-x64@7.0.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-UMGDx5sTpzNw3WiPebH7l90IWfJggEd+egHt/q6p7/Cm3zqoV7VxkGXt+3DxPIw8CcmvAB0j3sVVfbhX+M4Tpw=="],
+
+ "@typescript/typescript-linux-arm": ["@typescript/typescript-linux-arm@7.0.2", "", { "os": "linux", "cpu": "arm" }, "sha512-gffT3xPz9sR7j/YJExkyPntrI0P2EP9XbOyWzth2/Gs0RstK+90RBcO0ncXoXy/beYll1SXw846Nf2zdnEz0QQ=="],
+
+ "@typescript/typescript-linux-arm64": ["@typescript/typescript-linux-arm64@7.0.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-Qh4eU4/y3yDjnfjjyPYihMj5/ODIlmt+Bzu17OI+fiSRDW57QmU5SiN63exPRNJPKUzcc1INa1NXdrJ+MqHjUQ=="],
+
+ "@typescript/typescript-linux-loong64": ["@typescript/typescript-linux-loong64@7.0.2", "", { "os": "linux", "cpu": "none" }, "sha512-uEHck9i8hoAzXPiYRib1O7miOnz23SxIeVl6F4LXox+qov1K35jHcEW6VHKvZI+pyvl7fZEP4MCU5LYvIq1GuQ=="],
+
+ "@typescript/typescript-linux-mips64el": ["@typescript/typescript-linux-mips64el@7.0.2", "", { "os": "linux", "cpu": "none" }, "sha512-R4KvAMnE43W5Qeqb0Ly56O3mWMWIAgsMyz36DCaycd5nbg/9kzm0liw3JocfRqyJY0KPmzFjbswozXyW0DnIYA=="],
+
+ "@typescript/typescript-linux-ppc64": ["@typescript/typescript-linux-ppc64@7.0.2", "", { "os": "linux", "cpu": "ppc64" }, "sha512-DORx5b3sd/4S7eayxm4FQv+A7CrkUIGRaHiwI8oiHTAI1fAPWhF4J0vAlkC8biAlHSVVwxMQ3tjZ2/DVbnQiiA=="],
+
+ "@typescript/typescript-linux-riscv64": ["@typescript/typescript-linux-riscv64@7.0.2", "", { "os": "linux", "cpu": "none" }, "sha512-wf0jqEDOjrPRnKwYRyyJDRo11KMbvMFrU+q4zqKyChODBzvlkbhNQfKvLxQCcwTpdDaXSHZTVuh0JoCrKCUMHQ=="],
+
+ "@typescript/typescript-linux-s390x": ["@typescript/typescript-linux-s390x@7.0.2", "", { "os": "linux", "cpu": "s390x" }, "sha512-IkwJc3L7yhytWd/ewjyxNDfOmswCm9GWMJT/ue/dU4aZNbwZeYAetq42VyLmsmSjvoX7z74X6ZaYCtzAr0EuGw=="],
+
+ "@typescript/typescript-linux-x64": ["@typescript/typescript-linux-x64@7.0.2", "", { "os": "linux", "cpu": "x64" }, "sha512-EYdf2cNg7rgCWJnxCdJ+F3V39O8ihb37eHAu1LK8oAFizgTQbPOK7zHHXbPt8rX24COqODXeI3sIf0fCXG7H/A=="],
+
+ "@typescript/typescript-netbsd-arm64": ["@typescript/typescript-netbsd-arm64@7.0.2", "", { "os": "none", "cpu": "arm64" }, "sha512-+polYF4MF04aPpO5FTkHran9yUQDSXqy5GiSDKpsll5jy3l3+g9QLhpf39T+ePtefhXLOGrLl0QIjkQP6VnelA=="],
+
+ "@typescript/typescript-netbsd-x64": ["@typescript/typescript-netbsd-x64@7.0.2", "", { "os": "none", "cpu": "x64" }, "sha512-8YIT0EHM/3dq10ZOVF/A7pc/YSMtbcecct4rWtexrnSCHOPcpC2KTLXfTCR6vDpnSiY12heNb1GiN/wu+T/FyA=="],
+
+ "@typescript/typescript-openbsd-arm64": ["@typescript/typescript-openbsd-arm64@7.0.2", "", { "os": "openbsd", "cpu": "arm64" }, "sha512-APT8+ClYnuYm1u9+kgGXoMj2VzWzcymwh2gNSQVySHfkRDGOTVkoWLjCmOQSaO+PoqQ57B0flRp9SA+7GnnkzQ=="],
+
+ "@typescript/typescript-openbsd-x64": ["@typescript/typescript-openbsd-x64@7.0.2", "", { "os": "openbsd", "cpu": "x64" }, "sha512-yX7s+Q0Dln0Dt9tEzZsAjXXR/+ytBM7AlglaqyeMPxQszJ1JhlJdZ6jLA+IzldHtflX81em7lDao1xXu+aRRkg=="],
+
+ "@typescript/typescript-sunos-x64": ["@typescript/typescript-sunos-x64@7.0.2", "", { "os": "sunos", "cpu": "x64" }, "sha512-dLJDGaLZ1D4HPQn62u1n8mBDkJREwMsAkCdkwd4Ieqw+x3TUyTsqY0YiBCtE6H6OzzgGk3iuZ3vFWRS+E8/d1g=="],
+
+ "@typescript/typescript-win32-arm64": ["@typescript/typescript-win32-arm64@7.0.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-Gyl1Vy6OsWesLzmq+EP0Fb7b4Nid5232AvcA2SFcdYreldpNtYFFofPjnt62y9hQy7VTaZp65ICJjuAQRaVcIQ=="],
+
+ "@typescript/typescript-win32-x64": ["@typescript/typescript-win32-x64@7.0.2", "", { "os": "win32", "cpu": "x64" }, "sha512-0BQ3HkAHHlKLSp1qRvf3SUhGpGsDuhB/jgFw75guyqbxJqEaS0Cw/VFO8i2nHglJUzQCRtMMR/IBAKE3ETMC4g=="],
+
+ "@vitest/coverage-v8": ["@vitest/coverage-v8@4.1.11", "", { "dependencies": { "@bcoe/v8-coverage": "^1.0.2", "@vitest/utils": "4.1.11", "ast-v8-to-istanbul": "^1.0.0", "istanbul-lib-coverage": "^3.2.2", "istanbul-lib-report": "^3.0.1", "istanbul-reports": "^3.2.0", "magicast": "^0.5.2", "obug": "^2.1.1", "std-env": "^4.0.0-rc.1", "tinyrainbow": "^3.1.0" }, "peerDependencies": { "@vitest/browser": "4.1.11", "vitest": "4.1.11" }, "optionalPeers": ["@vitest/browser"] }, "sha512-8MVGEFnJIcdGjcbfKmeq8z0pZHH0JlVtoVZH9Q/qwUp6wyFnEJUBMrw9DCaj+ra3vShGmhavjalMIhPNxZAUcw=="],
+
+ "@vitest/expect": ["@vitest/expect@4.1.11", "", { "dependencies": { "@standard-schema/spec": "^1.1.0", "@types/chai": "^5.2.2", "@vitest/spy": "4.1.11", "@vitest/utils": "4.1.11", "chai": "^6.2.2", "tinyrainbow": "^3.1.0" } }, "sha512-VX2x5vNJXET47KAFzwERI+KRMtTTCSWTfSMKsW7JsUsXV4psq++e3DvZpuTDOpHcxytiDs6p2nhVb2tVDiiUYw=="],
+
+ "@vitest/mocker": ["@vitest/mocker@4.1.11", "", { "dependencies": { "@vitest/spy": "4.1.11", "estree-walker": "^3.0.3", "magic-string": "^0.30.21" }, "peerDependencies": { "msw": "^2.4.9", "vite": "^6.0.0 || ^7.0.0 || ^8.0.0" }, "optionalPeers": ["msw", "vite"] }, "sha512-2XJVD55d1o5AZous5CCGKS74g/riOj9odEt2bQpCVZeblHyHdnMeFl4jl0XjU21stf4mbjUkew2eXQZt65g5CQ=="],
+
+ "@vitest/pretty-format": ["@vitest/pretty-format@4.1.11", "", { "dependencies": { "tinyrainbow": "^3.1.0" } }, "sha512-yiZzPbGTS9Sr/JpFl8zHrcIkAofNbFV6k21vIgQN/cY/oxZeXhJv5sc/MBJ5jFKWmWs+oJHw0UXLZjmf931+Vw=="],
+
+ "@vitest/runner": ["@vitest/runner@4.1.11", "", { "dependencies": { "@vitest/utils": "4.1.11", "pathe": "^2.0.3" } }, "sha512-LztvUgdwMNJMIkj3hQnnxiC2Xy1zNxq928W/xhjCLaNCzqTZOudjwbQf6v9IntZGPw132i2Lq2rgTRZHD3JHNw=="],
+
+ "@vitest/snapshot": ["@vitest/snapshot@4.1.11", "", { "dependencies": { "@vitest/pretty-format": "4.1.11", "@vitest/utils": "4.1.11", "magic-string": "^0.30.21", "pathe": "^2.0.3" } }, "sha512-pN7ikn1ON7h8ee4gIAp4AzyK+zBtJPzVbqOgu5LCEh4VaJVbPQcgYQYJIMGQPXVeJJq1fnfazis7a5pFNPahog=="],
+
+ "@vitest/spy": ["@vitest/spy@4.1.11", "", {}, "sha512-apNa/prQy2qCeywhnixOHPRCgGNhvg7T4Dapfl1GahLp/R+uhBm5cPyFoNVyqsNd2h1nJxL6BqqdIjiABL60YA=="],
+
+ "@vitest/utils": ["@vitest/utils@4.1.11", "", { "dependencies": { "@vitest/pretty-format": "4.1.11", "convert-source-map": "^2.0.0", "tinyrainbow": "^3.1.0" } }, "sha512-zTCVGpyFsGWBhllOyKlTw/vnr6D9qxsfSDyfbyZmTyjHw5N/VuvzHpHoQjm2ZJzn4RJgx5w4r7V0er69CmLgPQ=="],
+
+ "@yuku-codegen/binding-android-arm64": ["@yuku-codegen/binding-android-arm64@0.8.7", "", { "os": "android", "cpu": "arm64" }, "sha512-C/0zV5IhgVdYhGJTwrY0v8dknxlhiKwtVJkMUaexu9/QvRmzlV4vfU3hZlUSgqc2BxQHntL1mCVbDq8j0FRFDw=="],
+
+ "@yuku-codegen/binding-darwin-arm64": ["@yuku-codegen/binding-darwin-arm64@0.8.7", "", { "os": "darwin", "cpu": "arm64" }, "sha512-/u+REDMI4a0/lsJXTM4c53/w31OGZLOReZIyg62uhgLs0kc8NHsj/nOcxTdlQjq5gi0zhdkccD9LaLTXcdzPvw=="],
+
+ "@yuku-codegen/binding-darwin-x64": ["@yuku-codegen/binding-darwin-x64@0.8.7", "", { "os": "darwin", "cpu": "x64" }, "sha512-sMMzFOwCo4WXR+/6zIBThOocSC50iIIZZdfiIDbaLvj0Ax/rWt/iavyfEAqajyvzydLyCqR/ZItdLWSRlu1umw=="],
+
+ "@yuku-codegen/binding-freebsd-x64": ["@yuku-codegen/binding-freebsd-x64@0.8.7", "", { "os": "freebsd", "cpu": "x64" }, "sha512-MpdpKXix9P+Y1rKgjvcNeNtGjXeL1CmttNhYINrWls8kRpm4xM/oBGTmn6w7to8lAlwj5jm8q03dQPl5mRv4Qw=="],
+
+ "@yuku-codegen/binding-linux-arm-gnu": ["@yuku-codegen/binding-linux-arm-gnu@0.8.7", "", { "os": "linux", "cpu": "arm" }, "sha512-rr1srFLlPAmC1vtxfc9C1YLDe3iH09YjfSeeIidBqKhzx1MATjOAq4mjlRUOnhr/L27MotWIYOFKwVsd5JZFOg=="],
+
+ "@yuku-codegen/binding-linux-arm-musl": ["@yuku-codegen/binding-linux-arm-musl@0.8.7", "", { "os": "linux", "cpu": "arm" }, "sha512-eAufXh8qBRpiSO6ueaMDL+yyoXIGLhpUce72YbcACtZU2qhExwBIJyEtQf5kH2Ki0X2aqkSjSfog4OPtKXan3Q=="],
+
+ "@yuku-codegen/binding-linux-arm64-gnu": ["@yuku-codegen/binding-linux-arm64-gnu@0.8.7", "", { "os": "linux", "cpu": "arm64" }, "sha512-gw4w6wPoHObBrdIC4duVWLmJOvpdE25j5D7yrM5mACNlK4klRz/lv8hK+ssQk9EJHBgZjSaqZIJVFgqNYbfv7A=="],
+
+ "@yuku-codegen/binding-linux-arm64-musl": ["@yuku-codegen/binding-linux-arm64-musl@0.8.7", "", { "os": "linux", "cpu": "arm64" }, "sha512-L68N6Y4XkqcIaKo3Ra88JEvBEH4AHff44A4INcrxeVWZ8CZtu2tCpfVxe3hR8qQQMcvBSQlDn24KpkCKEhVvfA=="],
+
+ "@yuku-codegen/binding-linux-x64-gnu": ["@yuku-codegen/binding-linux-x64-gnu@0.8.7", "", { "os": "linux", "cpu": "x64" }, "sha512-dzyAbltJmf3Cqlb8HcFuYIf5Yn0fl1vTr3XJ9HiVNNvOlhqPSArOqtw9vI1p6/VTXTjrMLXlU+s+/kNHiIy/Cw=="],
+
+ "@yuku-codegen/binding-linux-x64-musl": ["@yuku-codegen/binding-linux-x64-musl@0.8.7", "", { "os": "linux", "cpu": "x64" }, "sha512-Otw4MH3404q0Bbvl+YTdW9aoUV5vXmUw8260bWvt1XlaoIX/ceSgI4ygheRDMfBPoHt6FDayQaO9OLVUZAgkFA=="],
+
+ "@yuku-codegen/binding-win32-arm64": ["@yuku-codegen/binding-win32-arm64@0.8.7", "", { "os": "win32", "cpu": "arm64" }, "sha512-qo/jyrzryiBuKEsFiuWaBCBe3tRMynQ0qFWFgOEjcCMQeZfBm+wKiVEUEFXXLc7bh8YezguAWp0Mtnhq4ARNyA=="],
+
+ "@yuku-codegen/binding-win32-x64": ["@yuku-codegen/binding-win32-x64@0.8.7", "", { "os": "win32", "cpu": "x64" }, "sha512-D5lDsVDx6m00E6bWySlWdH72Ca4TPSaphDqB6QjU6MpuNLIJqoGoatYyq2rOmBE8Zv/kunot/o58KGL03P3eiA=="],
+
+ "@yuku-parser/binding-android-arm64": ["@yuku-parser/binding-android-arm64@0.8.7", "", { "os": "android", "cpu": "arm64" }, "sha512-eGKYiUDX7Y0V7tDTmg+JTVnXnjMqfXXsorZ+EDf5kxwchQ3Or1HS14MzI2fw+jFhHR85fCWt+mtX33Yao73hIQ=="],
+
+ "@yuku-parser/binding-darwin-arm64": ["@yuku-parser/binding-darwin-arm64@0.8.7", "", { "os": "darwin", "cpu": "arm64" }, "sha512-Re0RHelKLnjEURulY2/KxW+Ngb8zuNA4BRZuMwgGQNzVumT6u4U2N2hc01oeYVNVof0i7GrXE4UCNBgbpRRnjQ=="],
+
+ "@yuku-parser/binding-darwin-x64": ["@yuku-parser/binding-darwin-x64@0.8.7", "", { "os": "darwin", "cpu": "x64" }, "sha512-Hn8DROtQkjlA1ACbPgj4a7eP9IuVOI504oiTwpkWPbpaDWD9KdmnVYCqW+1LfenNK/g7O9NhWGpXEdaCNX7lIA=="],
+
+ "@yuku-parser/binding-freebsd-x64": ["@yuku-parser/binding-freebsd-x64@0.8.7", "", { "os": "freebsd", "cpu": "x64" }, "sha512-bAP2OV8wRuzplX/jYxv9+vvqQT8JxyNphI8fLfXGL054Xs+4/J5u33cIm3y4rxY8rdoLmmdiJs2Tq7r7lrDRfA=="],
+
+ "@yuku-parser/binding-linux-arm-gnu": ["@yuku-parser/binding-linux-arm-gnu@0.8.7", "", { "os": "linux", "cpu": "arm" }, "sha512-kTYwJQQgmZeAWdDIWabiReIZMpmfLueIj1tCmjStUtFGhR1Z0qwxonKVfUC4N7h/VhGGzLZ//7O1kgt1QKqgCg=="],
+
+ "@yuku-parser/binding-linux-arm-musl": ["@yuku-parser/binding-linux-arm-musl@0.8.7", "", { "os": "linux", "cpu": "arm" }, "sha512-uL4jE8HPT2BLlxAXyD10LqgPuXa9eDa0BKpCdSANmzIJghq/2eZo3/gQNtaxPZMupWoxjYzSad9IXrwu7aYPXQ=="],
+
+ "@yuku-parser/binding-linux-arm64-gnu": ["@yuku-parser/binding-linux-arm64-gnu@0.8.7", "", { "os": "linux", "cpu": "arm64" }, "sha512-3gVN4pWSKZmXiNX7cU164dR9MPvesCHnlH6nPfpK+yQsCuYphjKKplcb4SnZBrhiqmXbgb2HR0c2TS0IZUPhgA=="],
+
+ "@yuku-parser/binding-linux-arm64-musl": ["@yuku-parser/binding-linux-arm64-musl@0.8.7", "", { "os": "linux", "cpu": "arm64" }, "sha512-S0mwfEjoLpxzXeZw802Wa4RaELsQiPtWqG6INcy8j4GtvNFtl4LCX3eGO1XLn9pyLAISLzTRyU3zUCBUPin8lg=="],
+
+ "@yuku-parser/binding-linux-x64-gnu": ["@yuku-parser/binding-linux-x64-gnu@0.8.7", "", { "os": "linux", "cpu": "x64" }, "sha512-lnbWdPmerE5D1uH1G4IEZKnPzCrWCStRGrtgpSIe1RibAo5bZIjDbbbPYXmMHCEh4F+x/JaJpElh26a3r+BPbg=="],
+
+ "@yuku-parser/binding-linux-x64-musl": ["@yuku-parser/binding-linux-x64-musl@0.8.7", "", { "os": "linux", "cpu": "x64" }, "sha512-769uwndMvMzUvATWbAcEvyLHKA+DzhHSCl/obBUrRdYfRo26yxui6S8y3z7uJ+Naup7UKrDxrpK7OnQkxkl9KQ=="],
+
+ "@yuku-parser/binding-win32-arm64": ["@yuku-parser/binding-win32-arm64@0.8.7", "", { "os": "win32", "cpu": "arm64" }, "sha512-mEB/9PlaAkisJ6KWGz0zvywXoU6+80dTlR2LwS7s/jcXXoU6fm2+sitBZXtqu3+Q4DcDgPxM45uWMCzPs0TSRw=="],
+
+ "@yuku-parser/binding-win32-x64": ["@yuku-parser/binding-win32-x64@0.8.7", "", { "os": "win32", "cpu": "x64" }, "sha512-8vNB2DP0ou61nGb8tc/qfi41gfyDXz1MHr2zqL3nR+cJ6CEbiuWV/l/a/vv151gCgiZLLAyGkQGENpozdg716w=="],
+
+ "@yuku-toolchain/types": ["@yuku-toolchain/types@0.8.7", "", {}, "sha512-2Z53dNxAJL6UvFoIrDZvYf3zlO8s4VJK4O2hhaB4mXVwwpX/7ajtss3cmfqKvamlNLWyt9FSWs4eoYdlbxpnHA=="],
+
+ "args-tokenizer": ["args-tokenizer@0.3.0", "", {}, "sha512-xXAd7G2Mll5W8uo37GETpQ2VrE84M181Z7ugHFGQnJZ50M2mbOv0osSZ9VsSgPfJQ+LVG0prSi0th+ELMsno7Q=="],
+
+ "assertion-error": ["assertion-error@2.0.1", "", {}, "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA=="],
+
+ "ast-v8-to-istanbul": ["ast-v8-to-istanbul@1.0.5", "", { "dependencies": { "@jridgewell/trace-mapping": "^0.3.31", "estree-walker": "^3.0.3", "js-tokens": "^10.0.0" } }, "sha512-UPAgKJFSEGMWSDr3LX4tqnAb4f7KGT8O40Tyx8wbYmmZ/yn58lNCm8h3svs3eXgiGd5AXxz8NDOvXWvicq+rJA=="],
+
+ "bumpp": ["bumpp@12.2.2", "", { "dependencies": { "args-tokenizer": "^0.3.0", "cac": "^7.0.0", "jsonc-parser": "^3.3.1", "package-manager-detector": "^1.8.0", "tinyexec": "^1.3.0", "tinyglobby": "^0.2.17", "unconfig": "^7.5.0", "verkit": "^0.3.2", "yaml": "^2.9.0" }, "bin": { "bumpp": "bin/bumpp.mjs" } }, "sha512-tS7KZs+e1mRpN+N9mQU2greqHbqMLZrjBA0iQ4qVS/UB8yFPUgcvQHps4dVvRe37AEMNSOyNlnGuhnoklKlacg=="],
+
+ "c12": ["c12@4.0.0-beta.5", "", { "dependencies": { "confbox": "^0.2.4", "defu": "^6.1.7", "exsolve": "^1.0.8", "pathe": "^2.0.3", "pkg-types": "^2.3.1", "rc9": "^3.0.1" }, "peerDependencies": { "chokidar": "^5", "dotenv": "*", "giget": "*", "jiti": "*", "magicast": "*" }, "optionalPeers": ["chokidar", "dotenv", "giget", "jiti", "magicast"] }, "sha512-yWGCPCQGJeFq4R0mFg5HOhC3Rg+B0PCdM+ldXWUhughoGgeeq8/tjRmXh4/lmhKWyhf+KOFxB/JMXf0Yv1Fd5A=="],
+
+ "cac": ["cac@7.0.0", "", {}, "sha512-tixWYgm5ZoOD+3g6UTea91eow5z6AAHaho3g0V9CNSNb45gM8SmflpAc+GRd1InC4AqN/07Unrgp56Y94N9hJQ=="],
+
+ "chai": ["chai@6.2.2", "", {}, "sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg=="],
+
+ "confbox": ["confbox@0.2.4", "", {}, "sha512-ysOGlgTFbN2/Y6Cg3Iye8YKulHw+R2fNXHrgSmXISQdMnomY6eNDprVdW9R5xBguEqI954+S6709UyiO7B+6OQ=="],
+
+ "consola": ["consola@3.4.2", "", {}, "sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA=="],
+
+ "convert-source-map": ["convert-source-map@2.0.0", "", {}, "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg=="],
+
+ "defu": ["defu@6.1.7", "", {}, "sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ=="],
+
+ "destr": ["destr@2.0.5", "", {}, "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA=="],
+
+ "detect-libc": ["detect-libc@2.1.2", "", {}, "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ=="],
+
+ "dts-resolver": ["dts-resolver@3.0.0", "", { "peerDependencies": { "oxc-resolver": ">=11.0.0" }, "optionalPeers": ["oxc-resolver"] }, "sha512-1T1f+z+4tl9XD+m+0HBgWoL/nm0bOIffyWaUuUSBlFg/86IWvfx+wjNaO/ybU0AJzG9/Mi5hBUgGV6zCmWEN7Q=="],
+
+ "es-module-lexer": ["es-module-lexer@2.3.2", "", {}, "sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw=="],
+
+ "estree-walker": ["estree-walker@3.0.3", "", { "dependencies": { "@types/estree": "^1.0.0" } }, "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g=="],
+
+ "expect-type": ["expect-type@1.4.0", "", {}, "sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA=="],
+
+ "exsolve": ["exsolve@1.1.1", "", {}, "sha512-9U/jZUgjnSGyntRr6y5Muu1MJcwFl6kPu7k8qLF0IMNfLqvw0NZ4nnVDq0RVoZ0RvCyumib4Ez3KYrVfilrw+g=="],
+
+ "fdir": ["fdir@6.5.0", "", { "peerDependencies": { "picomatch": "^3 || ^4" }, "optionalPeers": ["picomatch"] }, "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg=="],
+
+ "fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="],
+
+ "get-tsconfig": ["get-tsconfig@5.0.0-beta.5", "", { "dependencies": { "resolve-pkg-maps": "^1.0.0" } }, "sha512-/6gFNr0N04nob252sTQxyFLi3eKFRqIg1I87YcqAMT1i6SQrSF6KujUEQrtrjMV0H/eejTCltLdDSTEMzHbnsQ=="],
+
+ "has-flag": ["has-flag@4.0.0", "", {}, "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="],
+
+ "html-escaper": ["html-escaper@2.0.2", "", {}, "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg=="],
+
+ "istanbul-lib-coverage": ["istanbul-lib-coverage@3.2.2", "", {}, "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg=="],
+
+ "istanbul-lib-report": ["istanbul-lib-report@3.0.1", "", { "dependencies": { "istanbul-lib-coverage": "^3.0.0", "make-dir": "^4.0.0", "supports-color": "^7.1.0" } }, "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw=="],
+
+ "istanbul-reports": ["istanbul-reports@3.2.0", "", { "dependencies": { "html-escaper": "^2.0.0", "istanbul-lib-report": "^3.0.0" } }, "sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA=="],
+
+ "jiti": ["jiti@2.7.0", "", { "bin": { "jiti": "lib/jiti-cli.mjs" } }, "sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ=="],
+
+ "js-tokens": ["js-tokens@10.0.0", "", {}, "sha512-lM/UBzQmfJRo9ABXbPWemivdCW8V2G8FHaHdypQaIy523snUjog0W71ayWXTjiR+ixeMyVHN2XcpnTd/liPg/Q=="],
+
+ "jsonc-parser": ["jsonc-parser@3.3.1", "", {}, "sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ=="],
+
+ "lightningcss": ["lightningcss@1.33.0", "", { "dependencies": { "detect-libc": "^2.0.3" }, "optionalDependencies": { "lightningcss-android-arm64": "1.33.0", "lightningcss-darwin-arm64": "1.33.0", "lightningcss-darwin-x64": "1.33.0", "lightningcss-freebsd-x64": "1.33.0", "lightningcss-linux-arm-gnueabihf": "1.33.0", "lightningcss-linux-arm64-gnu": "1.33.0", "lightningcss-linux-arm64-musl": "1.33.0", "lightningcss-linux-x64-gnu": "1.33.0", "lightningcss-linux-x64-musl": "1.33.0", "lightningcss-win32-arm64-msvc": "1.33.0", "lightningcss-win32-x64-msvc": "1.33.0" } }, "sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA=="],
+
+ "lightningcss-android-arm64": ["lightningcss-android-arm64@1.33.0", "", { "os": "android", "cpu": "arm64" }, "sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg=="],
+
+ "lightningcss-darwin-arm64": ["lightningcss-darwin-arm64@1.33.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg=="],
+
+ "lightningcss-darwin-x64": ["lightningcss-darwin-x64@1.33.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ=="],
+
+ "lightningcss-freebsd-x64": ["lightningcss-freebsd-x64@1.33.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg=="],
+
+ "lightningcss-linux-arm-gnueabihf": ["lightningcss-linux-arm-gnueabihf@1.33.0", "", { "os": "linux", "cpu": "arm" }, "sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ=="],
+
+ "lightningcss-linux-arm64-gnu": ["lightningcss-linux-arm64-gnu@1.33.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg=="],
+
+ "lightningcss-linux-arm64-musl": ["lightningcss-linux-arm64-musl@1.33.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ=="],
+
+ "lightningcss-linux-x64-gnu": ["lightningcss-linux-x64-gnu@1.33.0", "", { "os": "linux", "cpu": "x64" }, "sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg=="],
+
+ "lightningcss-linux-x64-musl": ["lightningcss-linux-x64-musl@1.33.0", "", { "os": "linux", "cpu": "x64" }, "sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw=="],
+
+ "lightningcss-win32-arm64-msvc": ["lightningcss-win32-arm64-msvc@1.33.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA=="],
+
+ "lightningcss-win32-x64-msvc": ["lightningcss-win32-x64-msvc@1.33.0", "", { "os": "win32", "cpu": "x64" }, "sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA=="],
+
+ "magic-string": ["magic-string@0.30.21", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ=="],
+
+ "magicast": ["magicast@0.5.4", "", { "dependencies": { "@babel/parser": "^7.29.7", "@babel/types": "^7.29.7", "source-map-js": "^1.2.1" } }, "sha512-llBEhWm1SacoRwgHUoQJYtwp4PBLF4faQi5TCpIGyGs9n4y5+juI0tDgyKIfpqxckRHaHzouUEph3THklWh03w=="],
+
+ "make-dir": ["make-dir@4.0.0", "", { "dependencies": { "semver": "^7.5.3" } }, "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw=="],
+
+ "nanoid": ["nanoid@3.3.18", "", { "bin": { "nanoid": "bin/nanoid.cjs" } }, "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w=="],
+
+ "obug": ["obug@2.1.4", "", {}, "sha512-4a+OsYv9UktOJKE+l1A4OufDgdRF9PifWj+tJnHURo/P+WOxpG4GzUFL9qCalmWauao6ogiG+QvnCovwPoyAWA=="],
+
+ "obuild": ["obuild@0.4.38", "", { "dependencies": { "c12": "4.0.0-beta.5", "consola": "^3.4.2", "defu": "^6.1.7", "exsolve": "^1.1.0", "magic-string": "^0.30.21", "pathe": "^2.0.3", "rolldown": "^1.1.5", "rolldown-plugin-dts": "^0.27.4", "tinyglobby": "^0.2.17" }, "bin": { "obuild": "dist/cli.mjs" } }, "sha512-82uy8eU+qmdtWkKlJb/jE47caBGMAGO3CrZVwGmc0Mn63hwc5Z4Fb82nBY7lwPzc44Dmv2eMBVuvnESdqHFT6Q=="],
+
+ "oxfmt": ["oxfmt@0.66.0", "", { "dependencies": { "tinypool": "2.1.0" }, "optionalDependencies": { "@oxfmt/binding-android-arm-eabi": "0.66.0", "@oxfmt/binding-android-arm64": "0.66.0", "@oxfmt/binding-darwin-arm64": "0.66.0", "@oxfmt/binding-darwin-x64": "0.66.0", "@oxfmt/binding-freebsd-x64": "0.66.0", "@oxfmt/binding-linux-arm-gnueabihf": "0.66.0", "@oxfmt/binding-linux-arm-musleabihf": "0.66.0", "@oxfmt/binding-linux-arm64-gnu": "0.66.0", "@oxfmt/binding-linux-arm64-musl": "0.66.0", "@oxfmt/binding-linux-ppc64-gnu": "0.66.0", "@oxfmt/binding-linux-riscv64-gnu": "0.66.0", "@oxfmt/binding-linux-riscv64-musl": "0.66.0", "@oxfmt/binding-linux-s390x-gnu": "0.66.0", "@oxfmt/binding-linux-x64-gnu": "0.66.0", "@oxfmt/binding-linux-x64-musl": "0.66.0", "@oxfmt/binding-openharmony-arm64": "0.66.0", "@oxfmt/binding-win32-arm64-msvc": "0.66.0", "@oxfmt/binding-win32-ia32-msvc": "0.66.0", "@oxfmt/binding-win32-x64-msvc": "0.66.0" }, "peerDependencies": { "svelte": "^5.0.0", "vite-plus": "*" }, "optionalPeers": ["svelte", "vite-plus"], "bin": { "oxfmt": "bin/oxfmt" } }, "sha512-FfvqR8RFtV6JJpRrpkfqyVCQ7HDvZ/VriWFx7veftCgL1B5ZO9qNr+1rvPieycMQnNfVG0PWyJQiy7p0hq1I5w=="],
+
+ "oxlint": ["oxlint@1.81.0", "", { "optionalDependencies": { "@oxlint/binding-android-arm-eabi": "1.81.0", "@oxlint/binding-android-arm64": "1.81.0", "@oxlint/binding-darwin-arm64": "1.81.0", "@oxlint/binding-darwin-x64": "1.81.0", "@oxlint/binding-freebsd-x64": "1.81.0", "@oxlint/binding-linux-arm-gnueabihf": "1.81.0", "@oxlint/binding-linux-arm-musleabihf": "1.81.0", "@oxlint/binding-linux-arm64-gnu": "1.81.0", "@oxlint/binding-linux-arm64-musl": "1.81.0", "@oxlint/binding-linux-ppc64-gnu": "1.81.0", "@oxlint/binding-linux-riscv64-gnu": "1.81.0", "@oxlint/binding-linux-riscv64-musl": "1.81.0", "@oxlint/binding-linux-s390x-gnu": "1.81.0", "@oxlint/binding-linux-x64-gnu": "1.81.0", "@oxlint/binding-linux-x64-musl": "1.81.0", "@oxlint/binding-openharmony-arm64": "1.81.0", "@oxlint/binding-win32-arm64-msvc": "1.81.0", "@oxlint/binding-win32-ia32-msvc": "1.81.0", "@oxlint/binding-win32-x64-msvc": "1.81.0" }, "peerDependencies": { "oxlint-tsgolint": ">=7.0.2001", "vite-plus": "*" }, "optionalPeers": ["oxlint-tsgolint", "vite-plus"], "bin": { "oxlint": "bin/oxlint" } }, "sha512-HyrJYqeoOCL0iqaLEzGewGT48ZX99P3hxYh8udAF9RGGIghSamkXE4ClUyBpEDNqasamThgmlPbuMOe7SAZmHg=="],
+
+ "package-manager-detector": ["package-manager-detector@1.8.0", "", {}, "sha512-yQA4H19AmPEoMUeavPMDIe1higySl/gH/yaQrkT/s07Qp+7pp2hYz30N3z2l5BkjVkF9Ow6o0wjJamm2y7Sn0A=="],
+
+ "pathe": ["pathe@2.0.3", "", {}, "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w=="],
+
+ "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
+
+ "picomatch": ["picomatch@4.0.7", "", {}, "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA=="],
+
+ "pkg-types": ["pkg-types@2.3.1", "", { "dependencies": { "confbox": "^0.2.4", "exsolve": "^1.0.8", "pathe": "^2.0.3" } }, "sha512-y+ichcgc2LrADuhLNAx8DFjVfgz91pRxfZdI3UDhxHvcVEZsenLO+7XaU5vOp0u/7V/wZ+plyuQxtrDlZJ+yeg=="],
+
+ "postcss": ["postcss@8.5.26", "", { "dependencies": { "nanoid": "^3.3.17", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ=="],
+
+ "quansync": ["quansync@1.0.0", "", {}, "sha512-5xZacEEufv3HSTPQuchrvV6soaiACMFnq1H8wkVioctoH3TRha9Sz66lOxRwPK/qZj7HPiSveih9yAyh98gvqA=="],
+
+ "rc9": ["rc9@3.0.1", "", { "dependencies": { "defu": "^6.1.6", "destr": "^2.0.5" } }, "sha512-gMDyleLWVE+i6Sgtc0QbbY6pEKqYs97NGi6isHQPqYlLemPoO8dxQ3uGi0f4NiP98c+jMW6cG1Kx9dDwfvqARQ=="],
+
+ "resolve-pkg-maps": ["resolve-pkg-maps@1.0.0", "", {}, "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw=="],
+
+ "rolldown": ["rolldown@1.2.6", "", { "dependencies": { "@oxc-project/types": "=0.147.0", "@rolldown/pluginutils": "^1.0.0" }, "optionalDependencies": { "@rolldown/binding-android-arm-eabi": "1.2.6", "@rolldown/binding-android-arm64": "1.2.6", "@rolldown/binding-darwin-arm64": "1.2.6", "@rolldown/binding-darwin-x64": "1.2.6", "@rolldown/binding-freebsd-x64": "1.2.6", "@rolldown/binding-linux-arm-gnueabihf": "1.2.6", "@rolldown/binding-linux-arm64-gnu": "1.2.6", "@rolldown/binding-linux-arm64-musl": "1.2.6", "@rolldown/binding-linux-ppc64-gnu": "1.2.6", "@rolldown/binding-linux-s390x-gnu": "1.2.6", "@rolldown/binding-linux-x64-gnu": "1.2.6", "@rolldown/binding-linux-x64-musl": "1.2.6", "@rolldown/binding-openharmony-arm64": "1.2.6", "@rolldown/binding-win32-arm64-msvc": "1.2.6", "@rolldown/binding-win32-x64-msvc": "1.2.6" }, "bin": { "rolldown": "./bin/cli.mjs" } }, "sha512-vMM4q3aixf46GiF1Kok8jDPFsEpXgFWGjUHXNkNHNm+Y2adXAG2dbX91jkti3i0ZRsOlcmbuzAz1poObSHCmUA=="],
+
+ "rolldown-plugin-dts": ["rolldown-plugin-dts@0.27.14", "", { "dependencies": { "dts-resolver": "^3.0.0", "get-tsconfig": "5.0.0-beta.5", "obug": "^2.1.4", "yuku-ast": "^0.8.0", "yuku-codegen": "^0.8.0", "yuku-parser": "^0.8.0" }, "peerDependencies": { "@typescript/native-preview": "*", "@volar/typescript": "~2.4.0", "rolldown": "^1.0.0", "typescript": "^5.0.0 || ^6.0.0 || ~7.0.0", "vue-tsc": "~3.2.0 || ~3.3.0" }, "optionalPeers": ["@typescript/native-preview", "@volar/typescript", "typescript", "vue-tsc"] }, "sha512-ZvuDDwoIpRK9RPxDXratCpklFO9QZZWndf/sd0VBFb4LEj0jj07UcHK9OCh7V4XiFz2Z89ziyBC2K6tJiDjrbw=="],
+
+ "semver": ["semver@7.8.5", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA=="],
+
+ "siginfo": ["siginfo@2.0.0", "", {}, "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g=="],
+
+ "source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
+
+ "stackback": ["stackback@0.0.2", "", {}, "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw=="],
+
+ "std-env": ["std-env@4.2.0", "", {}, "sha512-oCUKSupKTHX53EyjDtuZQ64pjLJ6yYCtpmEw0goYxtjG9KpbRe8KAsl2tBUGU9DyMcJ0RwJ8GqJAFzMXcXW1Rw=="],
+
+ "supports-color": ["supports-color@7.2.0", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw=="],
+
+ "tinybench": ["tinybench@2.9.0", "", {}, "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg=="],
+
+ "tinyexec": ["tinyexec@1.3.0", "", {}, "sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ=="],
+
+ "tinyglobby": ["tinyglobby@0.2.17", "", { "dependencies": { "fdir": "^6.5.0", "picomatch": "^4.0.4" } }, "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g=="],
+
+ "tinypool": ["tinypool@2.1.0", "", {}, "sha512-Pugqs6M0m7Lv1I7FtxN4aoyToKg1C4tu+/381vH35y8oENM/Ai7f7C4StcoK4/+BSw9ebcS8jRiVrORFKCALLw=="],
+
+ "tinyrainbow": ["tinyrainbow@3.1.1", "", {}, "sha512-yau8yJdTt989Mm0Bd/236QnzEiPf2xLLTqUZRUJOo/3CB078LSwzei343DgtJVmfJKJE3TMINY1u42SQsP6mXw=="],
+
+ "typescript": ["typescript@7.0.2", "", { "optionalDependencies": { "@typescript/typescript-aix-ppc64": "7.0.2", "@typescript/typescript-darwin-arm64": "7.0.2", "@typescript/typescript-darwin-x64": "7.0.2", "@typescript/typescript-freebsd-arm64": "7.0.2", "@typescript/typescript-freebsd-x64": "7.0.2", "@typescript/typescript-linux-arm": "7.0.2", "@typescript/typescript-linux-arm64": "7.0.2", "@typescript/typescript-linux-loong64": "7.0.2", "@typescript/typescript-linux-mips64el": "7.0.2", "@typescript/typescript-linux-ppc64": "7.0.2", "@typescript/typescript-linux-riscv64": "7.0.2", "@typescript/typescript-linux-s390x": "7.0.2", "@typescript/typescript-linux-x64": "7.0.2", "@typescript/typescript-netbsd-arm64": "7.0.2", "@typescript/typescript-netbsd-x64": "7.0.2", "@typescript/typescript-openbsd-arm64": "7.0.2", "@typescript/typescript-openbsd-x64": "7.0.2", "@typescript/typescript-sunos-x64": "7.0.2", "@typescript/typescript-win32-arm64": "7.0.2", "@typescript/typescript-win32-x64": "7.0.2" }, "bin": { "tsc": "bin/tsc" } }, "sha512-8FYau96o3NKOhbjKi/qNvG/W5jhzxkbdm5sj9AbZ/5T5sWqn3hJgLfGx27sRKZWTvyzCP8dLRBTf5tBTSRVUNA=="],
+
+ "unconfig": ["unconfig@7.5.0", "", { "dependencies": { "@quansync/fs": "^1.0.0", "defu": "^6.1.4", "jiti": "^2.6.1", "quansync": "^1.0.0", "unconfig-core": "7.5.0" } }, "sha512-oi8Qy2JV4D3UQ0PsopR28CzdQ3S/5A1zwsUwp/rosSbfhJ5z7b90bIyTwi/F7hCLD4SGcZVjDzd4XoUQcEanvA=="],
+
+ "unconfig-core": ["unconfig-core@7.5.0", "", { "dependencies": { "@quansync/fs": "^1.0.0", "quansync": "^1.0.0" } }, "sha512-Su3FauozOGP44ZmKdHy2oE6LPjk51M/TRRjHv2HNCWiDvfvCoxC2lno6jevMA91MYAdCdwP05QnWdWpSbncX/w=="],
+
+ "undici-types": ["undici-types@8.3.0", "", {}, "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ=="],
+
+ "verkit": ["verkit@0.3.2", "", {}, "sha512-zj/ob3UsvJGN0whEAKFp53REA5X66hvffVqoCtVQAakJKnKlH+/PcOfMoFwIG/o4rElqLv/ycAFlx8ZlXUorCg=="],
+
+ "vite": ["vite@8.2.2", "", { "dependencies": { "lightningcss": "^1.33.0", "picomatch": "^4.0.5", "postcss": "^8.5.26", "rolldown": "~1.2.4", "tinyglobby": "^0.2.17" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^20.19.0 || >=22.12.0", "@vitejs/devtools": "^0.4.0 || ^0.5.0", "esbuild": "^0.27.0 || ^0.28.0", "jiti": ">=1.21.0", "less": "^4.0.0", "sass": "^1.70.0", "sass-embedded": "^1.70.0", "stylus": ">=0.54.8", "sugarss": "^5.0.0", "terser": "^5.16.0", "tsx": "^4.8.1", "yaml": "^2.4.2" }, "optionalPeers": ["@types/node", "@vitejs/devtools", "esbuild", "jiti", "less", "sass", "sass-embedded", "stylus", "sugarss", "terser", "tsx", "yaml"], "bin": { "vite": "bin/vite.js" } }, "sha512-cFKLV/PRgAUlIRm5WjMjJ86jrftzpqcgH+Us+DS8mI3CDNiH30Whrz8uHL3+MOLPAgqbMBAqWdAHAphOAM+z/Q=="],
+
+ "vitest": ["vitest@4.1.11", "", { "dependencies": { "@vitest/expect": "4.1.11", "@vitest/mocker": "4.1.11", "@vitest/pretty-format": "4.1.11", "@vitest/runner": "4.1.11", "@vitest/snapshot": "4.1.11", "@vitest/spy": "4.1.11", "@vitest/utils": "4.1.11", "es-module-lexer": "^2.0.0", "expect-type": "^1.3.0", "magic-string": "^0.30.21", "obug": "^2.1.1", "pathe": "^2.0.3", "picomatch": "^4.0.3", "std-env": "^4.0.0-rc.1", "tinybench": "^2.9.0", "tinyexec": "^1.0.2", "tinyglobby": "^0.2.15", "tinyrainbow": "^3.1.0", "vite": "^6.0.0 || ^7.0.0 || ^8.0.0", "why-is-node-running": "^2.3.0" }, "peerDependencies": { "@edge-runtime/vm": "*", "@opentelemetry/api": "^1.9.0", "@types/node": "^20.0.0 || ^22.0.0 || >=24.0.0", "@vitest/browser-playwright": "4.1.11", "@vitest/browser-preview": "4.1.11", "@vitest/browser-webdriverio": "4.1.11", "@vitest/coverage-istanbul": "4.1.11", "@vitest/coverage-v8": "4.1.11", "@vitest/ui": "4.1.11", "happy-dom": "*", "jsdom": "*" }, "optionalPeers": ["@edge-runtime/vm", "@opentelemetry/api", "@types/node", "@vitest/browser-playwright", "@vitest/browser-preview", "@vitest/browser-webdriverio", "@vitest/coverage-istanbul", "@vitest/coverage-v8", "@vitest/ui", "happy-dom", "jsdom"], "bin": { "vitest": "./vitest.mjs" } }, "sha512-fhACrNXUidIbGSBr5FlbuBkO7VWC1ZyLl0DO4CU2DrQoAPxX84Ysxs+HeGQpii5lZWV1Q4gBZTTu49mF+A6Edw=="],
+
+ "why-is-node-running": ["why-is-node-running@2.3.0", "", { "dependencies": { "siginfo": "^2.0.0", "stackback": "0.0.2" }, "bin": { "why-is-node-running": "cli.js" } }, "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w=="],
+
+ "yaml": ["yaml@2.9.0", "", { "bin": { "yaml": "bin.mjs" } }, "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA=="],
+
+ "yuku-ast": ["yuku-ast@0.8.7", "", { "dependencies": { "@yuku-toolchain/types": "^0.8.7" } }, "sha512-h6+4bDfyootiMB9vckk5uKo5r5j0GHrkr17FQTDNfEsFT3DWlN9uu1HJwQwc64pgmLCI945fWM3lbTIqxjT3GQ=="],
+
+ "yuku-codegen": ["yuku-codegen@0.8.7", "", { "dependencies": { "@yuku-toolchain/types": "^0.8.7" }, "optionalDependencies": { "@yuku-codegen/binding-android-arm64": "0.8.7", "@yuku-codegen/binding-darwin-arm64": "0.8.7", "@yuku-codegen/binding-darwin-x64": "0.8.7", "@yuku-codegen/binding-freebsd-x64": "0.8.7", "@yuku-codegen/binding-linux-arm-gnu": "0.8.7", "@yuku-codegen/binding-linux-arm-musl": "0.8.7", "@yuku-codegen/binding-linux-arm64-gnu": "0.8.7", "@yuku-codegen/binding-linux-arm64-musl": "0.8.7", "@yuku-codegen/binding-linux-x64-gnu": "0.8.7", "@yuku-codegen/binding-linux-x64-musl": "0.8.7", "@yuku-codegen/binding-win32-arm64": "0.8.7", "@yuku-codegen/binding-win32-x64": "0.8.7" } }, "sha512-adwDZSh8oVDzhE6Du9PwVWxcOxeV0e2EVhUuMKWfhSY4wkrDq9eqixlxFF3l/XGUV1E7UFzhpz9393MUumkyNw=="],
+
+ "yuku-parser": ["yuku-parser@0.8.7", "", { "dependencies": { "@yuku-toolchain/types": "^0.8.7", "yuku-ast": "^0.8.7" }, "optionalDependencies": { "@yuku-parser/binding-android-arm64": "0.8.7", "@yuku-parser/binding-darwin-arm64": "0.8.7", "@yuku-parser/binding-darwin-x64": "0.8.7", "@yuku-parser/binding-freebsd-x64": "0.8.7", "@yuku-parser/binding-linux-arm-gnu": "0.8.7", "@yuku-parser/binding-linux-arm-musl": "0.8.7", "@yuku-parser/binding-linux-arm64-gnu": "0.8.7", "@yuku-parser/binding-linux-arm64-musl": "0.8.7", "@yuku-parser/binding-linux-x64-gnu": "0.8.7", "@yuku-parser/binding-linux-x64-musl": "0.8.7", "@yuku-parser/binding-win32-arm64": "0.8.7", "@yuku-parser/binding-win32-x64": "0.8.7" } }, "sha512-vRD9nwt4L3aYpxNqeSC4WqLv58xrXef0Ong1Mc45CTXTIpvLafx7JO05sczmQZwdLEZvywrLOGdNC5+Rp5N1BQ=="],
+ }
+}
diff --git a/docs/README.md b/docs/README.md
deleted file mode 100644
index 79dc092..0000000
--- a/docs/README.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# Documentation
-
-- [drivers.md](./drivers.md) — built-in drivers + authoring guide + error taxonomy
-- [rendering.md](./rendering.md) — React Email, jsx-email, MJML, `defineTemplate`
-- [inbound.md](./inbound.md) — `unemail/parse` + `unemail/inbound` route handlers
-- [webhooks.md](./webhooks.md) — unified webhook schema + signature verification
-- [testing.md](./testing.md) — `createTestEmail`, `waitFor`, Vitest matchers
-- [observability.md](./observability.md) — logging + OpenTelemetry
-- [queue.md](./queue.md) — background sending + retries + durability
-
-See also:
-
-- [README](../README.md) — hello world + design goals
-- [MIGRATION.md](../MIGRATION.md) — migrating from v0.x
diff --git a/docs/architecture.md b/docs/architecture.md
new file mode 100644
index 0000000..9430566
--- /dev/null
+++ b/docs/architecture.md
@@ -0,0 +1,123 @@
+# Architecture
+
+Three moving parts. Everything else in the repo is one of them.
+
+```
+send(msg) ─┐
+ ├─▶ normalizeMessage ─▶ compose(middleware) ─▶ driverHandler ─▶ provider
+sendBatch ─┘ (once) (a list) (a transport)
+```
+
+## The unit of work is a list
+
+```ts
+type SendHandler = (
+ msgs: readonly NormalizedMessage[],
+ ctx: SendContext,
+) => Promise[]>
+
+interface Middleware {
+ name: string
+ handle: (next: SendHandler) => SendHandler
+}
+```
+
+`send()` is `sendBatch()` with one element. Making the list the primitive
+rather than a special case is what buys the property that matters: retry
+re-sends only the failed indices, even when the driver reached the provider
+in a single request.
+
+```ts
+defineMiddleware("retry", (next) => async (msgs, ctx) => {
+ const results = [...(await next(msgs, ctx))]
+ const pending = results.flatMap((r, i) => (r.error?.retryable ? [i] : []))
+ const redo = await next(
+ pending.map((i) => msgs[i]!),
+ { ...ctx, attempt: 2 },
+ )
+ for (const [slot, i] of pending.entries()) results[i] = redo[slot]!
+ return results
+})
+```
+
+With a single-message handler this is not expressible: once the driver has
+batched, there is no way to reach back and re-send three of five.
+
+The cost is that a middleware that does not care about the batch still has
+to map over it. `perMessage()` lifts a per-message function for that case.
+
+## Normalize once, at the edge
+
+`normalizeMessage()` runs exactly once per message, in `createEmail`. It
+parses addresses, validates them, guarantees the list fields are present,
+rejects a header value containing a line break, derives `List-Unsubscribe`,
+injects the preheader, and freezes the result.
+
+That is why no driver in this repo calls an address parser, and why a
+message object you pass to `send()` is byte-identical afterwards.
+
+Middleware that changes a message returns a new one. `patchMessage()` is
+the supported way:
+
+```ts
+return next(
+ msgs.map((m) => patchMessage(m, { html })),
+ ctx,
+)
+```
+
+## Results, not exceptions
+
+`send()` and `sendBatch()` do not throw. A normalization failure, a driver
+that throws, a middleware with a bug, a driver that returns the wrong
+number of results — each becomes a `Result` in the slot it belongs to.
+
+`sendBatch` is positional by contract: `results[i]` corresponds to
+`messages[i]`, always. A driver whose `sendBatch` breaks that mapping fails
+its whole batch loudly, because every downstream index would otherwise be
+silently wrong.
+
+## Drivers are transports
+
+A driver takes a normalized message and gets it to a provider. It does not
+retry, rate limit, or log — those are middleware, and they work the same
+for every driver.
+
+`fallback` and `roundRobin` are drivers too, not a separate concept: they
+take messages and produce results, and they compose with middleware in
+either direction.
+
+```ts
+fallback([wrap(resend(...), withRetry()), ses(...)]) // retry inside each leg
+createEmail({ driver: fallback([...]), use: [withRetry()] }) // retry around the whole thing
+```
+
+## Initialization
+
+Per driver, at most once, and the promise is stored before it is awaited —
+so two concurrent sends share one initialization instead of racing past a
+half-open connection. Keyed by driver rather than by instance, so a driver
+mounted after the first send is still initialized.
+
+## What lives where
+
+| Path | Contains | Imports Node? |
+| ----------------- | ---------------------------------------------------------- | ------------- |
+| `src/core/` | types, errors, results, addresses, normalization, pipeline | no |
+| `src/drivers/` | transports, one shared `fetch` layer, the MIME builder | `smtp` only |
+| `src/middleware/` | retry, rate limit, circuit breaker, logger, idempotency | no |
+| `src/render/` | the render middleware and the React adapter | no |
+
+`src/core/types.ts` compiles to nothing — it is types only, so importing it
+costs no bytes in a Worker bundle.
+
+## Invariants CI enforces
+
+- **Bundle budgets** (`scripts/bundle-budget.mjs`) — every entry has a
+ ceiling; exceeding one is a deliberate decision, not a drift.
+- **Version consistency** (`scripts/check-version.mjs`) — `package.json`,
+ `jsr.json` and the `version` constant must agree. They drifted in 0.x.
+- **`isolatedDeclarations`** — a file that cannot emit its own `.d.mts`
+ fails typecheck rather than shipping a package with missing types.
+- **ATTW** — the published `exports` map is checked against an ESM-only
+ profile on every release.
diff --git a/docs/drivers.md b/docs/drivers.md
index 2cffb8d..22fb61f 100644
--- a/docs/drivers.md
+++ b/docs/drivers.md
@@ -1,168 +1,142 @@
# Drivers
-Every transport in unemail is a driver — a small module conforming to
-`EmailDriver`. You wire one into `createEmail({ driver })` and never
-touch it again; swapping providers is a one-line change.
-
-## Built-in drivers
-
-| Sub-path | Runtime | Attachments | Batch | Scheduling | Idempotency | Templates | Tags | Streams |
-| ----------------------------------------- | ------------------ | :---------: | :-----: | :--------: | :---------: | :-------: | :--: | :-----: |
-| `unemail/driver/mock` | all | ✓ | ✓ | ✓ | ✓ | – | ✓ | – |
-| `unemail/driver/smtp` | Node + Bun | ✓ | ✓ (seq) | – | – | – | – | – |
-| `unemail/driver/mailcrab` | Node (local only) | ✓ | ✓ | – | – | – | – | – |
-| `unemail/driver/resend` | all | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | – |
-| `unemail/driver/postmark` | all | ✓ | ✓ | – | – | ✓ | ✓ | ✓ |
-| `unemail/driver/ses` | all (Web-Crypto) | ✓ | ✓ (seq) | – | – | – | ✓ | – |
-| `unemail/driver/sendgrid` | all | ✓ | – | ✓ | – | ✓ | ✓ | – |
-| `unemail/driver/mailgun` | all | ✓ | – | ✓ | – | – | ✓ | – |
-| `unemail/driver/mailtrap` | all | ✓ | ✓ | – | – | ✓ | ✓ | – |
-| `unemail/driver/brevo` | all | ✓ | – | ✓ | – | ✓ | ✓ | – |
-| `unemail/driver/mailersend` | all | ✓ | ✓ | ✓ | – | – | ✓ | – |
-| `unemail/driver/loops` | all | – | – | – | – | ✓ | ✓ | – |
-| `unemail/driver/zeptomail` | all | ✓ | – | – | – | – | – | – |
-| `unemail/driver/mailchannels` | all (CF Workers) | ✓ | – | – | – | – | – | – |
-| `unemail/driver/cloudflare-email` | CF Workers binding | ✓ | – | – | – | – | – | – |
-| `unemail/driver/cloudflare-email-service` | CF Workers binding | ✓ | – | – | – | – | – | – |
-| `unemail/driver/http` | all | (custom) | – | (custom) | – | – | – | – |
-
-### Mailtrap (Email API + Email Sandbox)
-
-The Mailtrap driver uses one API token for both environments. Email API sends
-go to `send.api.mailtrap.io`; Email Sandbox (test inbox capture) uses
-`sandbox.api.mailtrap.io` with your inbox ID in the path.
+## Resend — `unemail/drivers/resend`
```ts
-import { createEmail } from "unemail"
-import mailtrap from "unemail/driver/mailtrap"
-
-const email = createEmail({
- driver: mailtrap({
- apiKey: process.env.MAILTRAP_API_KEY!,
- inboxId: process.env.MAILTRAP_INBOX_ID,
- sandbox: process.env.MAILTRAP_USE_SANDBOX === "true",
- }),
-})
+resend({ apiKey: process.env.RESEND_API_KEY!, endpoint?, fetch? })
+```
+
+Native batch (`/emails/batch`), scheduling, `cancel()`, `retrieve()`, and
+provider-side idempotency via the `Idempotency-Key` header when the message
+carries an `idempotencyKey`.
+
+Resend has no metadata field, so `message.metadata` is sent as
+`X-Metadata-*` headers — which is what comes back on its webhook events.
+
+The key is checked for its `re_` prefix at construction.
+
+## Postmark — `unemail/drivers/postmark`
+
+```ts
+postmark({ token, messageStream?, endpoint?, fetch? })
+```
+
+Pass the per-server token, not the account token.
+
+Postmark reports per-message failures inside a `200` batch response; those
+become individual failed results rather than a failed batch. It accepts one
+`Tag` per message, so extra tags carry as metadata instead of being dropped.
+
+Templated and plain messages use different endpoints and cannot be mixed in
+one batch — a mixed batch fails with `INVALID_OPTIONS` before any request
+is made.
+
+Route with `message.stream`, which overrides the driver's `messageStream`.
+
+## Amazon SES — `unemail/drivers/ses`
+
+```ts
+ses({ region, accessKeyId?, secretAccessKey?, sessionToken?,
+ configurationSetName?, fromArn?, endpoint?, fetch? })
+```
-// Sandbox (captured in test inbox)
-await email.send({ from: "a@b.com", to: "c@d.com", subject: "x", text: "hi", sandbox: true })
+No `@aws-sdk/*`: SigV4 is signed with Web Crypto and the message is posted
+as raw MIME, so attachments and inline images work and the driver runs in a
+Worker. Credentials fall back to `AWS_ACCESS_KEY_ID`,
+`AWS_SECRET_ACCESS_KEY` and `AWS_SESSION_TOKEN`.
-// Email API
-await email.send({ from: "a@verified.com", to: "c@d.com", subject: "x", text: "hi" })
+SES reads recipients off the envelope, which is where bcc lives — blind
+recipients reach the provider without appearing in the document.
+
+`__type` is read for classification, so an expired token is `AUTH` and
+throttling is a retryable `RATE_LIMIT` rather than a generic 400.
+
+SES v2 has no raw-MIME bulk endpoint, so there is no `sendBatch`; the core
+sends sequentially.
+
+## SMTP — `unemail/drivers/smtp`
+
+```ts
+smtp({
+ host, port?, secure?, requireTLS?,
+ user?, password?, authMethod?, getAccessToken?,
+ rejectUnauthorized?, tls?, localName?,
+ pool?, maxConnections?, maxMessagesPerConnection?, idleTimeoutMs?,
+ connectionTimeoutMs?, commandTimeoutMs?, disposeGraceMs?,
+ dkim?,
+})
```
-Set `msg.sandbox` per message to override the driver default. `sendBatch`
-works in both modes; all messages in one batch must target the same environment.
-Sandbox sends require `inboxId` (from `mailtrap.io/sandboxes/{id}`).
+Its own protocol implementation — no `nodemailer`, no transitive
+dependencies. `port` defaults to 465 when `secure`, 587 otherwise.
+`rejectUnauthorized` defaults to `true`.
-### Cloudflare: Email Routing vs Email Service
+`AUTO` picks the strongest method the server advertises (`XOAUTH2`,
+`CRAM-MD5`, `PLAIN`, `LOGIN`).
-Cloudflare exposes two send APIs on the same `send_email` binding, so there are
-two drivers:
+With `pool: true` connections are reused; one that fails mid-transaction is
+discarded rather than returned in an unknown protocol state.
-- `unemail/driver/cloudflare-email` — **Email Routing**. Builds raw RFC 5322 and
- hands it to `EmailMessage` from the virtual `cloudflare:email` module. Single
- recipient per send, by construction.
-- `unemail/driver/cloudflare-email-service` — **Email Service** (Email Sending).
- Passes structured fields. No ambient global, no virtual module, no MIME
- builder in your bundle; multiple recipients in one call.
+DKIM signs the assembled document. Pass a function to select a key per
+message for multi-tenant sending:
```ts
-import { createEmail } from "unemail"
-import cloudflareEmailService from "unemail/driver/cloudflare-email-service"
-
-export default {
- async fetch(req: Request, env: Env) {
- const email = createEmail({ driver: cloudflareEmailService({ binding: env.EMAIL }) })
- await email.send({
- from: { email: "welcome@yourdomain.com", name: "Acme" },
- to: ["a@example.com", "b@example.com"],
- subject: "Welcome",
- html: "Welcome
",
- text: "Welcome",
- })
- return new Response("ok")
- },
-}
+smtp({ host, dkim: (msg) => keyFor(msg.from.email.split("@")[1]!) })
```
-Needs `"send_email": [{ "name": "EMAIL" }]` in `wrangler.jsonc` and a sender
-domain onboarded with `wrangler email sending enable `. Combined
-`to` + `cc` + `bcc` is capped at 50 addresses per send by the provider; the
-binding's `E_*` errors are mapped onto the [error taxonomy](#error-taxonomy),
-so rate limits stay retryable while validation failures do not.
+`message.raw` bypasses the MIME builder entirely; the envelope is still
+taken from the message's addresses.
+
+Needs `node:net` and `node:tls` — this is the one driver that does not run
+in a Worker.
-### Meta drivers
+## Mock — `unemail/drivers/mock`
-These wrap other drivers:
+```ts
+mock({ fail?, failWhen?, latencyMs?, inbox? })
+```
-- `unemail/driver/fallback` — try a list of drivers in order
-- `unemail/driver/round-robin` — cycle sends across drivers (with weights)
+`getInstance()` returns the inbox: `messages`, `find(address)`, `last()`,
+`clear()`. Messages are stored normalized, so assertions see what a real
+driver would have seen.
-## Authoring a custom driver
+## Fallback — `unemail/drivers/fallback`
```ts
-import { defineDriver, type EmailDriver } from "unemail"
-
-interface MyOptions {
- apiKey: string
- endpoint?: string
-}
-
-export default defineDriver((opts) => ({
- name: "my-driver",
- options: opts,
- flags: {
- attachments: true,
- html: true,
- text: true,
- replyTo: true,
- },
- async initialize() {
- // Optional: open connections, refresh tokens, etc.
- },
- async isAvailable() {
- return Boolean(opts?.apiKey)
- },
- async send(msg, _ctx) {
- const res = await fetch(opts!.endpoint ?? "https://api.example.com/send", {
- method: "POST",
- headers: { authorization: `Bearer ${opts!.apiKey}` },
- body: JSON.stringify(msg),
- })
- if (!res.ok) {
- return {
- data: null,
- error: new Error(`HTTP ${res.status}`) as never, // use createError for code taxonomy
- }
- }
- const body = (await res.json()) as { id: string }
- return {
- data: { id: body.id, driver: "my-driver", at: new Date() },
- error: null,
- }
- },
- async dispose() {
- // Optional: close connections, flush queues.
- },
-}))
+fallback(drivers, { shouldFailover?, onFailover?, name? })
```
-## Error taxonomy
+Per message, not per batch: only the messages a leg failed reach the next
+one. `INVALID_OPTIONS` and `UNSUPPORTED` do not fail over — the next
+provider would reject them too. Legs initialize lazily as they are reached.
-`EmailError` carries a `code` that's stable across drivers:
+## Round-robin — `unemail/drivers/round-robin`
-| Code | Meaning | Retryable? |
-| ----------------- | ---------------------------------------------- | :--------: |
-| `INVALID_OPTIONS` | user input is wrong (missing field, bad shape) | no |
-| `NETWORK` | transient network or 5xx | yes |
-| `AUTH` | bad credentials | no |
-| `RATE_LIMIT` | 429 or provider rate-limit | yes |
-| `TIMEOUT` | client-side timeout fired | yes |
-| `PROVIDER` | the provider rejected the message | no |
-| `UNSUPPORTED` | driver can't do this (e.g. SMTP on Workers) | no |
-| `CANCELLED` | abort signal or pool disposed | no |
+```ts
+roundRobin(drivers, { weights?, name? })
+```
+
+Spreads sends to stay under each provider's limit, or to warm a second
+sending domain. A batch is partitioned and each partition goes to its
+driver in one request, so native batching survives the split. It does not
+fail over — put it behind `fallback` if you need that.
+
+## Capability matrix
-Use `createError(driver, code, message, { status, retryable, cause })`.
-The retry middleware honors `error.retryable` and Mailgun-style
-`Retry-After` headers.
+| | Resend | Postmark | SES | SMTP | Mock |
+| -------------------- | :----: | :------: | :-: | :--: | :--: |
+| attachments | ✅ | ✅ | ✅ | ✅ | ✅ |
+| html / text | ✅ | ✅ | ✅ | ✅ | ✅ |
+| native batch | ✅ | ✅ | — | — | ✅ |
+| scheduling | ✅ | — | — | — | ✅ |
+| provider idempotency | ✅ | — | — | — | ✅ |
+| templates | — | ✅ | — | — | ✅ |
+| tracking | — | ✅ | — | — | ✅ |
+| tagging | ✅ | ✅ | ✅ | — | ✅ |
+| cancel / retrieve | ✅ | — | — | — | — |
+
+Read it at runtime rather than hard-coding it:
+
+```ts
+if (email.driver.features?.scheduling) await email.send({ ...msg, scheduledAt })
+```
diff --git a/docs/inbound.md b/docs/inbound.md
deleted file mode 100644
index 841d5b5..0000000
--- a/docs/inbound.md
+++ /dev/null
@@ -1,61 +0,0 @@
-# Inbound email
-
-unemail ships two complementary pieces:
-
-- `unemail/parse` — parse raw MIME into a unified `ParsedEmail`
-- `unemail/inbound` — handle provider webhook routes and give you the
- same `ParsedEmail` regardless of which provider delivered the message
-
-## Low-level parsing
-
-```ts
-import { parseEmail } from "unemail/parse"
-
-const mail = await parseEmail(rawMime)
-// { subject, from, to, cc, bcc, text, html, headers, attachments, ... }
-```
-
-`parseEmail` accepts `string`, `Uint8Array`, `ArrayBuffer`, `Blob`, or
-`ReadableStream`. It wraps [postal-mime](https://github.com/postalsys/postal-mime)
-as an optional peer dep — the entry is Workers-parseable even without it
-installed (loaded on first call).
-
-## Unified inbound handler
-
-```ts
-import { defineInboundHandler } from "unemail/inbound"
-import sendgridInbound from "unemail/inbound/sendgrid"
-import mailgunInbound from "unemail/inbound/mailgun"
-import postmarkInbound from "unemail/inbound/postmark"
-import cloudflareInbound from "unemail/inbound/cloudflare"
-
-export default defineInboundHandler({
- providers: [
- sendgridInbound(),
- mailgunInbound({ signingKey: process.env.MG_SIGNING_KEY! }),
- postmarkInbound({ basicAuth: "user:pass" }),
- cloudflareInbound({ secretHeader: "x-secret", secret: process.env.INBOUND_SECRET }),
- ],
- async onEmail(mail, ctx) {
- console.log(`[${ctx.provider}]`, mail.subject, "from", mail.from?.email)
- // mail: ParsedEmail — same shape regardless of provider
- },
-})
-```
-
-The returned handler is a standard `(req: Request) => Promise`
-— drop it into Nitro, a Cloudflare Worker, Hono, Next.js route handlers,
-or a raw `fetch` listener.
-
-### Signature verification
-
-Each adapter accepts provider-specific verification options (shared
-secrets, HMAC keys, Basic auth). Failures return `401` by default; pass
-`onVerificationFailure` to customize.
-
-### SES inbound
-
-AWS SES routes inbound mail through SNS, so it's handled by the SES
-webhook verifier — see [webhooks](./webhooks.md). The SNS payload
-includes the raw MIME when you set up the receipt rule to store the
-message in S3 or pass it through SNS directly.
diff --git a/docs/observability.md b/docs/observability.md
deleted file mode 100644
index 56360a9..0000000
--- a/docs/observability.md
+++ /dev/null
@@ -1,62 +0,0 @@
-# Observability
-
-Two middlewares give you production-grade visibility without extra deps.
-
-## Structured logging
-
-```ts
-import { withLogger } from "unemail"
-
-email.use(withLogger())
-// → `console.info(JSON.stringify(entry))` on each send.start / send.success
-// → `console.error(JSON.stringify(entry))` on send.error
-```
-
-Pipe the output somewhere (Pino, Axiom, Logflare, Datadog) via a custom
-sink:
-
-```ts
-email.use(
- withLogger({
- sink: (entry) => logger.info(entry),
- redactLocalPart: true, // ada@acme.com → a***@acme.com
- includeSubject: false, // subjects can contain PII; turn off if needed
- }),
-)
-```
-
-Entries include `driver`, `stream`, `attempt`, `messageId`, `recipient`,
-`subject`, `durationMs`, `error.{code,message,retryable}`, and any
-`ctx.meta` fields set by other middleware.
-
-## OpenTelemetry tracing
-
-```ts
-import { trace } from "@opentelemetry/api"
-import { withTelemetry } from "unemail"
-
-email.use(withTelemetry({ tracer: trace.getTracer("unemail") }))
-```
-
-Each send produces one span (`email.send`) with attributes:
-
-- `email.driver`, `email.stream`, `email.attempt`
-- `email.to`, `email.subject.length`
-- `email.message_id` (on success)
-- `email.error.code` (on failure)
-
-When no tracer is passed, `withTelemetry()` is a no-op — cheap to leave
-in place for environments that don't have OTel wired up.
-
-## Sampling
-
-```ts
-email.use(
- withTelemetry({
- tracer,
- sample: (attrs) => attrs["email.stream"] !== "health-check",
- }),
-)
-```
-
-Return `false` to skip span creation for a given send.
diff --git a/docs/queue.md b/docs/queue.md
deleted file mode 100644
index 3bca074..0000000
--- a/docs/queue.md
+++ /dev/null
@@ -1,63 +0,0 @@
-# Queue
-
-Background sending is opt-in. Pick a queue driver, start a worker, and
-call `queue.enqueue(msg)` from your app instead of `email.send(msg)`.
-
-## In-memory (single-process)
-
-```ts
-import { createEmail } from "unemail"
-import memoryQueue from "unemail/queue/memory"
-import { startWorker } from "unemail/queue/worker"
-import resend from "unemail/driver/resend"
-
-const email = createEmail({ driver: resend({ apiKey: process.env.RESEND_KEY! }) })
-const queue = memoryQueue()
-const worker = startWorker(email, queue, {
- concurrency: 5,
- maxAttempts: 5,
- backoff: (attempt) => 500 * 2 ** attempt,
-})
-worker.start()
-
-await queue.enqueue({ from, to, subject, text })
-```
-
-## Durable with unstorage
-
-```ts
-import { createStorage } from "unstorage"
-import redisDriver from "unstorage/drivers/redis"
-import unstorageQueue from "unemail/queue/unstorage"
-
-const storage = createStorage({ driver: redisDriver({ url: process.env.REDIS_URL! }) })
-const queue = unstorageQueue({ storage, prefix: "unemail:queue:" })
-```
-
-Any unstorage driver works — Upstash, Cloudflare KV, filesystem, MongoDB,
-Vercel KV. Items survive restarts; restarted workers pick them up.
-
-## Anatomy of an item
-
-```ts
-interface QueueItem {
- id: string
- msg: EmailMessage
- attempts: number
- nextAttemptAt: number // unix ms
- createdAt: number
- lastError?: string
-}
-```
-
-The worker `pull`s items whose `nextAttemptAt` has passed, calls
-`email.send`, and either `ack`s on success or `fail`s on error (updating
-`nextAttemptAt` based on the `backoff` function). After `maxAttempts`
-attempts the item is dropped.
-
-## Custom drivers
-
-Implement `EmailQueue` for any backend (SQS, QStash, Inngest, BullMQ).
-The four methods you need are `enqueue`, `pull`, `ack`, `fail` (+ `size`
-for metrics). The worker loop is intentionally portable — swap the loop
-out entirely if your driver pushes (SQS long-polling, QStash webhooks).
diff --git a/docs/recipes/typed-get-instance.md b/docs/recipes/typed-get-instance.md
deleted file mode 100644
index b9d1ed6..0000000
--- a/docs/recipes/typed-get-instance.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# Typed `getInstance()` — native provider SDK escape hatch
-
-`unemail` wraps what's portable across drivers, but sometimes you need
-a provider-native API that nobody else has (Resend audiences, SES
-templates, SendGrid IP warmup). The `EmailDriver.getInstance()` hook
-is a typed escape hatch.
-
-## Usage
-
-```ts
-import { defineDriver } from "unemail"
-import { Resend } from "resend"
-
-export function resendWithInstance(opts: { apiKey: string }) {
- const client = new Resend(opts.apiKey)
- return defineDriver(() => ({
- name: "resend-native",
- getInstance: () => client,
- async send(msg) {
- const { data, error } = await client.emails.send({
- from: String(msg.from),
- to: String(msg.to),
- subject: msg.subject,
- text: msg.text ?? "",
- })
- if (error) return { data: null, error: new Error(error.message) as never }
- return { data: { id: data!.id, driver: "resend-native", at: new Date() }, error: null }
- },
- }))(opts)
-}
-
-// Consumer code:
-const driver = resendWithInstance({ apiKey: "re_..." })
-const email = createEmail({ driver })
-
-// Typed access to the native SDK for things unemail doesn't wrap:
-const resend = driver.getInstance?.()
-if (resend) {
- await resend.audiences.create({ name: "allhands" })
-}
-```
-
-## When to reach for it
-
-- **Native audiences / broadcasts / contacts** — e.g. Resend's
- `audiences`, SendGrid's `contactdb`.
-- **Suppression / template CRUD** — SES `CreateTemplate`, Mailgun
- routes.
-- **Advanced auth flows** — IdP-signed requests outside the scope of
- `unemail/middleware/oauth2`.
-
-When the feature is portable across 2+ providers it belongs in core
-(file an issue). When it's a single-provider escape hatch,
-`getInstance()` is the right answer.
diff --git a/docs/rendering.md b/docs/rendering.md
deleted file mode 100644
index 9135848..0000000
--- a/docs/rendering.md
+++ /dev/null
@@ -1,90 +0,0 @@
-# Rendering
-
-unemail doesn't have an opinion on templates — you render with whatever
-you already use, and the `withRender` middleware drops the result into
-`msg.html` before the driver sees it.
-
-## React Email
-
-```ts
-import { createEmail, withRender } from "unemail"
-import resend from "unemail/driver/resend"
-import reactRender from "unemail/render/react"
-import { Welcome } from "./emails/welcome.tsx"
-
-const email = createEmail({ driver: resend({ apiKey: process.env.RESEND_KEY! }) })
-email.use(withRender(reactRender()))
-
-await email.send({
- from: "Acme ",
- to: "user@example.com",
- subject: "Welcome",
- react: ,
-})
-```
-
-The `@react-email/render` peer is loaded lazily — the module parses on
-Cloudflare Workers even without it installed.
-
-## jsx-email
-
-```ts
-import jsxRender from "unemail/render/jsx-email"
-
-email.use(withRender(jsxRender({ inlineCss: true })))
-await email.send({ from, to, subject, jsx: })
-```
-
-Peer: `jsx-email`.
-
-## MJML
-
-```ts
-import mjmlRender from "unemail/render/mjml"
-
-email.use(withRender(mjmlRender()))
-await email.send({
- from,
- to,
- subject,
- mjml: `
- Hello Ada
- `,
-})
-```
-
-Peer: `mjml` (or `mjml-browser` in the browser).
-
-## Combining adapters
-
-`withRender` accepts any number of adapters. The first whose `match(msg)`
-returns true wins, so you can register all three safely:
-
-```ts
-email.use(withRender(reactRender(), jsxRender(), mjmlRender()))
-```
-
-## Plain text fallback
-
-When a renderer resolves `msg.html` and you didn't set `msg.text`, the
-middleware derives plain text via `htmlToText` automatically. Disable
-with `withRender(...renderers).options.autoText = false` or set
-`msg.text` yourself.
-
-## Type-safe templates
-
-```ts
-import { defineTemplate } from "unemail"
-import { Welcome } from "./emails/welcome.tsx"
-
-export const welcome = defineTemplate<{ name: string, activationUrl: string }>(
- ({ name, activationUrl }) => ({
- subject: `Welcome, ${name}!`,
- react: ,
- }),
-)
-
-// Compile-time check on variables:
-const rendered = welcome({ name: "Ada", activationUrl: "https://…" })
-await email.send({ from, to, subject: rendered.subject!, react: rendered.react })
-```
diff --git a/docs/rfcs/001-packaging.md b/docs/rfcs/001-packaging.md
deleted file mode 100644
index f6d82d2..0000000
--- a/docs/rfcs/001-packaging.md
+++ /dev/null
@@ -1,83 +0,0 @@
-# RFC-001: Package Structure
-
-**Status:** Decision landed for v1.x. Revisit for v2.
-
-## Context
-
-Upyo (our direct peer) ships each transport as its own package
-(`@upyo/resend`, `@upyo/sendgrid`, `@upyo/smtp`). `unemail` currently
-ships one package with ~50 sub-path exports (e.g.
-`unemail/driver/resend`, `unemail/render/mjml`, `unemail/queue/sqs`).
-
-Both models work. The question is which one minimizes:
-
-1. Install footprint — only paying for what you use.
-2. Peer-dep footprint — `mjml`, `@react-email/render`, `juice`,
- `handlebars`, `liquidjs`, `postal-mime` are all optional.
-3. Discoverability — one import path vs 50 packages.
-4. Maintenance cost — one CHANGELOG + one versioning dance vs 15+
- independent package versions.
-
-## Options
-
-### A. Keep the monorepo single-package model (status quo)
-
-- **Pros:** One `npm install unemail`. One CHANGELOG. Sub-path
- imports already tree-shake well with obuild/ESM. Peer deps are
- truly peer (not installed unless imported).
-- **Cons:** Users must know the sub-path exists. `npm ls` looks
- heavy even if you're only using `unemail/driver/mock`.
-
-### B. Split into ~15 packages under `@unemail/*`
-
-- **Pros:** Tree-shaking becomes obvious at the install level. Users
- discover transports by browsing the `@unemail` scope on npm.
-- **Cons:** 15× release coordination. Cross-package refactors need
- matching version bumps. Contributors have a steeper learning
- curve.
-
-### C. Hybrid — `unemail` stays the single install, but we publish
-
-`@unemail/smtp`, `@unemail/resend`, `@unemail/ses` as thin re-exports
-for users who want the narrow install.
-
-- **Pros:** Zero behaviour change for existing users. New users can
- opt into narrow installs.
-- **Cons:** More publishing steps. Confusing if two import paths
- reach the same code.
-
-## Decision for v1.x
-
-**Stay on Option A.** Reasons:
-
-1. Install size is already competitive (~240 kB dist total, ~5–30 kB
- per sub-path).
-2. Every transport we ship uses `fetch` and has no runtime deps, so
- "install `unemail` and pay for Resend-only code" is already the
- reality — tree-shaking does the rest.
-3. Peer deps (`mjml`, `@react-email/render`, `juice`, `handlebars`,
- `liquidjs`, `postal-mime`, `@opentelemetry/api`, `unstorage`,
- `bullmq`, `pg-boss`, `@aws-sdk/client-sqs`) are all optional and
- lazy-imported. Users who don't import the relevant sub-path never
- see them in `node_modules`.
-4. One version + one CHANGELOG keeps maintenance tractable for a
- solo / small-team OSS project.
-
-## Revisit for v2 if
-
-- Users file more than 5 issues asking for narrow installs.
-- Bundle-size budgets push us past 300 kB total dist.
-- We add a transport with a large required runtime dep (unlikely —
- every new driver should stick to `fetch`).
-
-## Implementation notes (status quo)
-
-- Every driver is a sub-path export: `unemail/driver/`.
-- Render adapters live under `unemail/render/`.
-- Observability + deliverability utilities are lightly grouped:
- `unemail/events`, `unemail/dmarc`, `unemail/mta-sts`,
- `unemail/verify/arc`, `unemail/parse/arf`, `unemail/ics`,
- `unemail/compliance`, `unemail/suppression`, `unemail/preferences`,
- `unemail/address`, `unemail/result`.
-- Package entries are listed in `package.json#exports` and mirrored
- in `jsr.json#exports`.
diff --git a/docs/testing.md b/docs/testing.md
deleted file mode 100644
index d3e5d65..0000000
--- a/docs/testing.md
+++ /dev/null
@@ -1,77 +0,0 @@
-# Testing
-
-`unemail/test` ships an `Email` instance backed by the mock driver so
-you never have to stub providers by hand.
-
-## The test inbox
-
-```ts
-import { createTestEmail } from "unemail/test"
-import { it, expect } from "vitest"
-
-it("sends a welcome email", async () => {
- const email = createTestEmail()
- await signUpUser(email, { email: "ada@acme.com", name: "Ada" })
-
- expect(email.inbox).toHaveLength(1)
- expect(email.last?.subject).toMatch(/welcome/i)
- expect(email.find((m) => m.to === "ada@acme.com")).toBeDefined()
-})
-```
-
-## Waiting for async sends
-
-When the send happens on a timer or a background task:
-
-```ts
-const msg = await email.waitFor((m) => m.subject === "Reminder", {
- timeout: 2000,
- interval: 20,
-})
-expect(msg.text).toContain("you left something in the cart")
-```
-
-## Vitest matchers
-
-```ts
-import { expect } from "vitest"
-import { createTestEmail, emailMatchers } from "unemail/test"
-
-expect.extend(emailMatchers)
-
-declare module "vitest" {
- interface Matchers {
- toHaveSent: (match: {
- from?: string | RegExp
- to?: string | RegExp
- subject?: string | RegExp
- html?: string | RegExp
- text?: string | RegExp
- stream?: string
- }) => R
- }
-}
-
-const email = createTestEmail()
-// …send something…
-expect(email).toHaveSent({ to: "ada@acme.com", subject: /welcome/i })
-```
-
-If you can't use the `expect.extend` augmentation, call
-`matchesEmail(message, match)` directly — it returns
-`{ pass, diff }`.
-
-## Integration tests with MailCrab
-
-When you need a real SMTP server to exercise the full pipeline:
-
-```ts
-import { createEmail } from "unemail"
-import mailcrab from "unemail/driver/mailcrab"
-
-const email = createEmail({ driver: mailcrab({ quiet: true }) })
-await email.send({ from, to, subject, text })
-// Open http://localhost:1080 to inspect
-```
-
-Run `pnpm dlx unemail-mailcrab` to spin up the server via Docker.
diff --git a/docs/webhooks.md b/docs/webhooks.md
deleted file mode 100644
index a107726..0000000
--- a/docs/webhooks.md
+++ /dev/null
@@ -1,77 +0,0 @@
-# Webhooks
-
-unemail normalizes every provider's webhook payload into one shape.
-
-```ts
-type WebhookEvent = {
- type:
- | "sent"
- | "delivered"
- | "bounced"
- | "complained"
- | "opened"
- | "clicked"
- | "unsubscribed"
- | "rejected"
- | "failed"
- | "other"
- id: string
- at: Date
- recipient: string
- provider: string
- raw: unknown // original payload preserved
- url?: string // for "clicked"
- bounce?: "hard" | "soft" | "unknown"
-}
-```
-
-## Wiring it up
-
-```ts
-import { defineWebhookHandler } from "unemail/webhook"
-import resendWebhook from "unemail/webhook/resend"
-import postmarkWebhook from "unemail/webhook/postmark"
-import mailgunWebhook from "unemail/webhook/mailgun"
-import sendgridWebhook from "unemail/webhook/sendgrid"
-import sesWebhook from "unemail/webhook/ses"
-
-export default defineWebhookHandler({
- providers: [
- resendWebhook({ secret: process.env.RESEND_WEBHOOK_SECRET! }),
- postmarkWebhook({ basicAuth: "user:pass" }),
- mailgunWebhook({ signingKey: process.env.MG_SIGNING_KEY! }),
- sendgridWebhook({ publicKey: process.env.SG_PUBLIC_KEY! }),
- sesWebhook({ topicArns: [process.env.SES_TOPIC_ARN!] }),
- ],
- async onEvent(event) {
- console.log(event.type, event.recipient, event.id)
- if (event.type === "bounced" && event.bounce === "hard") {
- await suppressionList.add(event.recipient)
- }
- },
-})
-```
-
-Every verifier runs on Web Crypto — no `node:crypto`, no vendor SDK,
-Cloudflare Workers ready.
-
-## Signature formats
-
-| Provider | Header(s) | Scheme |
-| --------- | ---------------------------------------------------- | -------------------------------------------------- |
-| Resend | `svix-id`, `svix-timestamp`, `svix-signature` | HMAC-SHA256 (base64 secret) |
-| Postmark | `authorization: Basic ...` | HTTP Basic |
-| Mailgun | payload `signature.{timestamp,token,signature}` | HMAC-SHA256 of `ts+token` |
-| SendGrid | `x-twilio-email-event-webhook-{timestamp,signature}` | ECDSA P-256 / SHA-256 |
-| SES (SNS) | `x-amz-sns-message-type` | TopicArn allow-list + optional cert-fetch callback |
-
-## Timestamp windows
-
-Each verifier accepts a `toleranceSeconds` option (default `300`) to
-reject replayed payloads. Missing timestamps fail closed.
-
-## Failure behavior
-
-Returning `[]` from a verifier means "this looks like my payload but the
-signature is bad" — the handler responds `401`. Returning `null` means
-"not my payload" — the handler tries the next provider.
diff --git a/jsr.json b/jsr.json
index c1a1f1c..b73feed 100644
--- a/jsr.json
+++ b/jsr.json
@@ -1,76 +1,20 @@
{
"name": "@productdevbook/unemail",
- "version": "0.5.0",
+ "version": "1.0.0",
"exports": {
".": "./src/index.ts",
- "./driver/mock": "./src/driver/mock.ts",
- "./driver/smtp": "./src/driver/smtp.ts",
- "./driver/postmark": "./src/driver/postmark.ts",
- "./driver/ses": "./src/driver/ses.ts",
- "./driver/http": "./src/driver/http.ts",
- "./driver/zeptomail": "./src/driver/zeptomail.ts",
- "./driver/sendgrid": "./src/driver/sendgrid.ts",
- "./driver/mailgun": "./src/driver/mailgun.ts",
- "./driver/mailtrap": "./src/driver/mailtrap.ts",
- "./driver/brevo": "./src/driver/brevo.ts",
- "./driver/mailersend": "./src/driver/mailersend.ts",
- "./driver/loops": "./src/driver/loops.ts",
- "./driver/mailchannels": "./src/driver/mailchannels.ts",
- "./driver/cloudflare-email": "./src/driver/cloudflare-email.ts",
- "./driver/cloudflare-email-service": "./src/driver/cloudflare-email-service.ts",
- "./driver/mailcrab": "./src/driver/mailcrab.ts",
- "./driver/resend": "./src/driver/resend.ts",
- "./driver/fallback": "./src/driver/fallback.ts",
- "./driver/round-robin": "./src/driver/round-robin.ts",
- "./driver/tee": "./src/driver/tee.ts",
+ "./drivers/mock": "./src/drivers/mock.ts",
+ "./drivers/smtp": "./src/drivers/smtp.ts",
+ "./drivers/resend": "./src/drivers/resend.ts",
+ "./drivers/postmark": "./src/drivers/postmark.ts",
+ "./drivers/ses": "./src/drivers/ses.ts",
+ "./drivers/fallback": "./src/drivers/fallback.ts",
+ "./drivers/round-robin": "./src/drivers/round-robin.ts",
"./middleware": "./src/middleware/index.ts",
"./render": "./src/render/index.ts",
- "./render/react": "./src/render/react.ts",
- "./render/jsx-email": "./src/render/jsx-email.ts",
- "./render/mjml": "./src/render/mjml.ts",
- "./render/pipeline": "./src/render/pipeline.ts",
- "./render/handlebars": "./src/render/handlebars.ts",
- "./render/liquid": "./src/render/liquid.ts",
- "./render/i18n": "./src/render/i18n.ts",
- "./test": "./src/test/index.ts",
- "./parse": "./src/parse/index.ts",
- "./inbound": "./src/inbound/index.ts",
- "./inbound/cloudflare": "./src/inbound/cloudflare.ts",
- "./inbound/postmark": "./src/inbound/postmark.ts",
- "./inbound/sendgrid": "./src/inbound/sendgrid.ts",
- "./inbound/mailgun": "./src/inbound/mailgun.ts",
- "./webhook": "./src/webhook/index.ts",
- "./webhook/resend": "./src/webhook/resend.ts",
- "./webhook/postmark": "./src/webhook/postmark.ts",
- "./webhook/mailgun": "./src/webhook/mailgun.ts",
- "./webhook/sendgrid": "./src/webhook/sendgrid.ts",
- "./webhook/ses": "./src/webhook/ses.ts",
- "./webhook/standard": "./src/webhook/standard.ts",
- "./verify": "./src/verify/index.ts",
- "./queue": "./src/queue/index.ts",
- "./queue/memory": "./src/queue/memory.ts",
- "./queue/unstorage": "./src/queue/unstorage.ts",
- "./queue/worker": "./src/queue/worker.ts",
- "./suppression": "./src/suppression/index.ts",
- "./compliance": "./src/compliance/index.ts",
- "./result": "./src/result/index.ts",
- "./ics": "./src/ics/index.ts",
- "./inbound/reply": "./src/inbound/reply.ts",
- "./inbound/thread": "./src/inbound/thread.ts",
- "./address": "./src/address.ts",
- "./preferences": "./src/preferences/index.ts",
- "./dmarc": "./src/dmarc/index.ts",
- "./verify/arc": "./src/verify/arc.ts",
- "./mta-sts": "./src/mta-sts/index.ts",
- "./parse/arf": "./src/parse/arf.ts",
- "./events": "./src/events/index.ts",
- "./inbound/ses": "./src/inbound/ses.ts",
- "./queue/bullmq": "./src/queue/bullmq.ts",
- "./queue/pg-boss": "./src/queue/pg-boss.ts",
- "./queue/sqs": "./src/queue/sqs.ts"
+ "./render/react": "./src/render/react.ts"
},
"publish": {
- "include": ["src/**/*.ts", "README.md", "LICENSE"],
- "exclude": ["src/**/*.test.ts"]
+ "include": ["src", "README.md", "LICENSE", "jsr.json"]
}
}
diff --git a/package.json b/package.json
index 78dbb72..09de4c2 100644
--- a/package.json
+++ b/package.json
@@ -1,44 +1,25 @@
{
"name": "unemail",
- "version": "0.5.0",
+ "version": "1.0.0",
"private": false,
- "description": "Driver-based TypeScript email library — send, parse, render, verify. Zero-deps core; works on Node, Bun, Deno, Cloudflare Workers, and the browser.",
+ "description": "Driver-based TypeScript email library. Batch-native middleware pipeline, zero dependencies, ESM-only — runs on Node, Bun, Deno, Cloudflare Workers and the browser.",
"keywords": [
"aws-ses",
"batch-email",
- "brevo",
- "cloudflare-email",
- "cloudflare-email-service",
- "cloudflare-workers",
"dkim",
- "dmarc",
"driver",
"driver-pattern",
"email",
- "email-parser",
"email-service",
- "email-templates",
"esm",
"idempotency",
- "jsx-email",
- "mailchannels",
- "mailcrab",
- "mailersend",
- "mailgun",
- "mailtrap",
- "mjml",
- "postal-mime",
+ "middleware",
"postmark",
"react-email",
"resend",
- "scheduled-email",
- "sendgrid",
"smtp",
- "spf",
"transactional-email",
"typescript",
- "webhooks",
- "zeptomail",
"zero-dependencies"
],
"homepage": "https://github.com/productdevbook/unemail#readme",
@@ -62,85 +43,33 @@
"types": "./dist/index.d.mts",
"default": "./dist/index.mjs"
},
- "./driver/mock": {
- "types": "./dist/driver/mock.d.mts",
- "default": "./dist/driver/mock.mjs"
+ "./drivers/mock": {
+ "types": "./dist/drivers/mock.d.mts",
+ "default": "./dist/drivers/mock.mjs"
},
- "./driver/smtp": {
- "types": "./dist/driver/smtp.d.mts",
- "default": "./dist/driver/smtp.mjs"
+ "./drivers/smtp": {
+ "types": "./dist/drivers/smtp.d.mts",
+ "default": "./dist/drivers/smtp.mjs"
},
- "./driver/postmark": {
- "types": "./dist/driver/postmark.d.mts",
- "default": "./dist/driver/postmark.mjs"
+ "./drivers/resend": {
+ "types": "./dist/drivers/resend.d.mts",
+ "default": "./dist/drivers/resend.mjs"
},
- "./driver/ses": {
- "types": "./dist/driver/ses.d.mts",
- "default": "./dist/driver/ses.mjs"
+ "./drivers/postmark": {
+ "types": "./dist/drivers/postmark.d.mts",
+ "default": "./dist/drivers/postmark.mjs"
},
- "./driver/http": {
- "types": "./dist/driver/http.d.mts",
- "default": "./dist/driver/http.mjs"
+ "./drivers/ses": {
+ "types": "./dist/drivers/ses.d.mts",
+ "default": "./dist/drivers/ses.mjs"
},
- "./driver/zeptomail": {
- "types": "./dist/driver/zeptomail.d.mts",
- "default": "./dist/driver/zeptomail.mjs"
+ "./drivers/fallback": {
+ "types": "./dist/drivers/fallback.d.mts",
+ "default": "./dist/drivers/fallback.mjs"
},
- "./driver/sendgrid": {
- "types": "./dist/driver/sendgrid.d.mts",
- "default": "./dist/driver/sendgrid.mjs"
- },
- "./driver/mailgun": {
- "types": "./dist/driver/mailgun.d.mts",
- "default": "./dist/driver/mailgun.mjs"
- },
- "./driver/mailtrap": {
- "types": "./dist/driver/mailtrap.d.mts",
- "default": "./dist/driver/mailtrap.mjs"
- },
- "./driver/brevo": {
- "types": "./dist/driver/brevo.d.mts",
- "default": "./dist/driver/brevo.mjs"
- },
- "./driver/mailersend": {
- "types": "./dist/driver/mailersend.d.mts",
- "default": "./dist/driver/mailersend.mjs"
- },
- "./driver/loops": {
- "types": "./dist/driver/loops.d.mts",
- "default": "./dist/driver/loops.mjs"
- },
- "./driver/mailchannels": {
- "types": "./dist/driver/mailchannels.d.mts",
- "default": "./dist/driver/mailchannels.mjs"
- },
- "./driver/cloudflare-email": {
- "types": "./dist/driver/cloudflare-email.d.mts",
- "default": "./dist/driver/cloudflare-email.mjs"
- },
- "./driver/cloudflare-email-service": {
- "types": "./dist/driver/cloudflare-email-service.d.mts",
- "default": "./dist/driver/cloudflare-email-service.mjs"
- },
- "./driver/mailcrab": {
- "types": "./dist/driver/mailcrab.d.mts",
- "default": "./dist/driver/mailcrab.mjs"
- },
- "./driver/resend": {
- "types": "./dist/driver/resend.d.mts",
- "default": "./dist/driver/resend.mjs"
- },
- "./driver/fallback": {
- "types": "./dist/driver/fallback.d.mts",
- "default": "./dist/driver/fallback.mjs"
- },
- "./driver/round-robin": {
- "types": "./dist/driver/round-robin.d.mts",
- "default": "./dist/driver/round-robin.mjs"
- },
- "./driver/tee": {
- "types": "./dist/driver/tee.d.mts",
- "default": "./dist/driver/tee.mjs"
+ "./drivers/round-robin": {
+ "types": "./dist/drivers/round-robin.d.mts",
+ "default": "./dist/drivers/round-robin.mjs"
},
"./middleware": {
"types": "./dist/middleware/index.d.mts",
@@ -154,174 +83,7 @@
"types": "./dist/render/react.d.mts",
"default": "./dist/render/react.mjs"
},
- "./render/jsx-email": {
- "types": "./dist/render/jsx-email.d.mts",
- "default": "./dist/render/jsx-email.mjs"
- },
- "./render/mjml": {
- "types": "./dist/render/mjml.d.mts",
- "default": "./dist/render/mjml.mjs"
- },
- "./render/pipeline": {
- "types": "./dist/render/pipeline.d.mts",
- "default": "./dist/render/pipeline.mjs"
- },
- "./render/handlebars": {
- "types": "./dist/render/handlebars.d.mts",
- "default": "./dist/render/handlebars.mjs"
- },
- "./render/liquid": {
- "types": "./dist/render/liquid.d.mts",
- "default": "./dist/render/liquid.mjs"
- },
- "./render/i18n": {
- "types": "./dist/render/i18n.d.mts",
- "default": "./dist/render/i18n.mjs"
- },
- "./test": {
- "types": "./dist/test/index.d.mts",
- "default": "./dist/test/index.mjs"
- },
- "./parse": {
- "types": "./dist/parse/index.d.mts",
- "default": "./dist/parse/index.mjs"
- },
- "./inbound": {
- "types": "./dist/inbound/index.d.mts",
- "default": "./dist/inbound/index.mjs"
- },
- "./inbound/cloudflare": {
- "types": "./dist/inbound/cloudflare.d.mts",
- "default": "./dist/inbound/cloudflare.mjs"
- },
- "./inbound/postmark": {
- "types": "./dist/inbound/postmark.d.mts",
- "default": "./dist/inbound/postmark.mjs"
- },
- "./inbound/sendgrid": {
- "types": "./dist/inbound/sendgrid.d.mts",
- "default": "./dist/inbound/sendgrid.mjs"
- },
- "./inbound/mailgun": {
- "types": "./dist/inbound/mailgun.d.mts",
- "default": "./dist/inbound/mailgun.mjs"
- },
- "./inbound/reply": {
- "types": "./dist/inbound/reply.d.mts",
- "default": "./dist/inbound/reply.mjs"
- },
- "./inbound/thread": {
- "types": "./dist/inbound/thread.d.mts",
- "default": "./dist/inbound/thread.mjs"
- },
- "./webhook": {
- "types": "./dist/webhook/index.d.mts",
- "default": "./dist/webhook/index.mjs"
- },
- "./webhook/resend": {
- "types": "./dist/webhook/resend.d.mts",
- "default": "./dist/webhook/resend.mjs"
- },
- "./webhook/postmark": {
- "types": "./dist/webhook/postmark.d.mts",
- "default": "./dist/webhook/postmark.mjs"
- },
- "./webhook/mailgun": {
- "types": "./dist/webhook/mailgun.d.mts",
- "default": "./dist/webhook/mailgun.mjs"
- },
- "./webhook/sendgrid": {
- "types": "./dist/webhook/sendgrid.d.mts",
- "default": "./dist/webhook/sendgrid.mjs"
- },
- "./webhook/ses": {
- "types": "./dist/webhook/ses.d.mts",
- "default": "./dist/webhook/ses.mjs"
- },
- "./webhook/standard": {
- "types": "./dist/webhook/standard.d.mts",
- "default": "./dist/webhook/standard.mjs"
- },
- "./verify": {
- "types": "./dist/verify/index.d.mts",
- "default": "./dist/verify/index.mjs"
- },
- "./queue": {
- "types": "./dist/queue/index.d.mts",
- "default": "./dist/queue/index.mjs"
- },
- "./queue/memory": {
- "types": "./dist/queue/memory.d.mts",
- "default": "./dist/queue/memory.mjs"
- },
- "./queue/unstorage": {
- "types": "./dist/queue/unstorage.d.mts",
- "default": "./dist/queue/unstorage.mjs"
- },
- "./queue/worker": {
- "types": "./dist/queue/worker.d.mts",
- "default": "./dist/queue/worker.mjs"
- },
- "./suppression": {
- "types": "./dist/suppression/index.d.mts",
- "default": "./dist/suppression/index.mjs"
- },
- "./compliance": {
- "types": "./dist/compliance/index.d.mts",
- "default": "./dist/compliance/index.mjs"
- },
- "./result": {
- "types": "./dist/result/index.d.mts",
- "default": "./dist/result/index.mjs"
- },
- "./ics": {
- "types": "./dist/ics/index.d.mts",
- "default": "./dist/ics/index.mjs"
- },
- "./address": {
- "types": "./dist/address.d.mts",
- "default": "./dist/address.mjs"
- },
- "./preferences": {
- "types": "./dist/preferences/index.d.mts",
- "default": "./dist/preferences/index.mjs"
- },
- "./dmarc": {
- "types": "./dist/dmarc/index.d.mts",
- "default": "./dist/dmarc/index.mjs"
- },
- "./verify/arc": {
- "types": "./dist/verify/arc.d.mts",
- "default": "./dist/verify/arc.mjs"
- },
- "./mta-sts": {
- "types": "./dist/mta-sts/index.d.mts",
- "default": "./dist/mta-sts/index.mjs"
- },
- "./parse/arf": {
- "types": "./dist/parse/arf.d.mts",
- "default": "./dist/parse/arf.mjs"
- },
- "./events": {
- "types": "./dist/events/index.d.mts",
- "default": "./dist/events/index.mjs"
- },
- "./inbound/ses": {
- "types": "./dist/inbound/ses.d.mts",
- "default": "./dist/inbound/ses.mjs"
- },
- "./queue/bullmq": {
- "types": "./dist/queue/bullmq.d.mts",
- "default": "./dist/queue/bullmq.mjs"
- },
- "./queue/pg-boss": {
- "types": "./dist/queue/pg-boss.d.mts",
- "default": "./dist/queue/pg-boss.mjs"
- },
- "./queue/sqs": {
- "types": "./dist/queue/sqs.d.mts",
- "default": "./dist/queue/sqs.mjs"
- }
+ "./package.json": "./package.json"
},
"scripts": {
"build": "obuild",
@@ -329,28 +91,36 @@
"lint": "oxlint . && oxfmt --check .",
"lint:fix": "oxlint . --fix && oxfmt .",
"fmt": "oxfmt .",
- "test": "pnpm lint && pnpm typecheck && vitest run",
"typecheck": "tsgo --noEmit",
+ "test": "vitest run",
+ "check": "bun run lint && bun run typecheck && bun run test && bun run check:version",
+ "check:version": "node scripts/check-version.mjs",
"bundle-budget": "node scripts/bundle-budget.mjs",
- "playground": "cd playground && pnpm install && pnpm dev",
- "attw": "pnpm dlx @arethetypeswrong/cli --pack . --profile esm-only",
- "jsr:check": "pnpm dlx jsr publish --dry-run --allow-dirty",
- "release": "pnpm test && pnpm build && pnpm bundle-budget && pnpm attw && pnpm jsr:check && bumpp --commit --tag --push --all",
- "prepack": "pnpm build"
+ "attw": "bunx --bun @arethetypeswrong/cli --pack . --profile esm-only",
+ "jsr:check": "bunx jsr publish --dry-run --allow-dirty",
+ "release": "bun run check && bun run build && bun run bundle-budget && bun run attw && bun run jsr:check && bumpp --commit --tag --push --all",
+ "prepack": "bun run build"
},
"devDependencies": {
"@types/node": "^26.0.0",
- "@typescript/native-preview": "7.0.0-dev.20260619.1",
+ "@typescript/native-preview": "7.0.0-dev.20260707.2",
"@vitest/coverage-v8": "^4.1.9",
- "bumpp": "^11.1.0",
+ "bumpp": "^12.2.2",
"obuild": "^0.4.36",
- "oxfmt": "^0.55.0",
+ "oxfmt": "^0.66.0",
"oxlint": "^1.70.0",
- "typescript": "^6.0.3",
+ "typescript": "^7.0.2",
"vitest": "^4.1.9"
},
+ "peerDependencies": {
+ "@react-email/render": "*"
+ },
+ "peerDependenciesMeta": {
+ "@react-email/render": {
+ "optional": true
+ }
+ },
"engines": {
"node": ">=20.11.1"
- },
- "packageManager": "pnpm@11.8.0"
+ }
}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
deleted file mode 100644
index 0e5dc19..0000000
--- a/pnpm-lock.yaml
+++ /dev/null
@@ -1,2016 +0,0 @@
-lockfileVersion: '9.0'
-
-settings:
- autoInstallPeers: true
- excludeLinksFromLockfile: false
-
-importers:
-
- .:
- devDependencies:
- '@types/node':
- specifier: ^26.0.0
- version: 26.0.0
- '@typescript/native-preview':
- specifier: 7.0.0-dev.20260619.1
- version: 7.0.0-dev.20260619.1
- '@vitest/coverage-v8':
- specifier: ^4.1.9
- version: 4.1.9(vitest@4.1.9)
- bumpp:
- specifier: ^11.1.0
- version: 11.1.0
- obuild:
- specifier: ^0.4.36
- version: 0.4.36(@typescript/native-preview@7.0.0-dev.20260619.1)(jiti@2.7.0)(magicast@0.5.3)(typescript@6.0.3)
- oxfmt:
- specifier: ^0.55.0
- version: 0.55.0
- oxlint:
- specifier: ^1.70.0
- version: 1.70.0
- typescript:
- specifier: ^6.0.3
- version: 6.0.3
- vitest:
- specifier: ^4.1.9
- version: 4.1.9(@types/node@26.0.0)(@vitest/coverage-v8@4.1.9)(vite@8.0.16(@types/node@26.0.0)(jiti@2.7.0)(yaml@2.9.0))
-
-packages:
-
- '@babel/generator@8.0.0-rc.6':
- resolution: {integrity: sha512-6mIzgVK8DgEzvIapoQwhXTMnnkuE4STQmVv9H03i/tZ2ml8oev3TRvZJgTenK2Bsq0YWNtzOrFdTyNzCMFtjJQ==}
- engines: {node: ^22.18.0 || >=24.11.0}
-
- '@babel/helper-string-parser@7.29.7':
- resolution: {integrity: sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==}
- engines: {node: '>=6.9.0'}
-
- '@babel/helper-string-parser@8.0.0':
- resolution: {integrity: sha512-6mJgmFFFIIO82vvoLt9XtRC7/TkzXfts1t/SpRX4IHSzMgqoPYCWesVu1udUPUWioAE/2fcG6WuI8zrkE1gwrg==}
- engines: {node: ^22.18.0 || >=24.11.0}
-
- '@babel/helper-validator-identifier@7.29.7':
- resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==}
- engines: {node: '>=6.9.0'}
-
- '@babel/helper-validator-identifier@8.0.0-rc.6':
- resolution: {integrity: sha512-nVJ+1JcCgntv8d78rRo++o2wuODT0Irknx2BF8Np4Ft2CRgjLqIs4qzSZ8b66yGbBdMWGmZBO9WEZv1hhNiSpg==}
- engines: {node: ^22.18.0 || >=24.11.0}
-
- '@babel/helper-validator-identifier@8.0.2':
- resolution: {integrity: sha512-9Fr9QeyCAyi1BR1jKZ6uYQ24EIhQUx5ReHfQU7drOE+TPOb+w11/dsqLkMOT2U29OdCT71XajrOT8xDc1C7orA==}
- engines: {node: ^22.18.0 || >=24.11.0}
-
- '@babel/parser@7.29.7':
- resolution: {integrity: sha512-hnORnjP/1P/zFEndoeX+n+t1RwWRJiJpM/jO7FW32Kn9r5+sJB2JWOdYo4L6k78j15eCwY3Gm/7364B1EMwtNg==}
- engines: {node: '>=6.0.0'}
- hasBin: true
-
- '@babel/parser@8.0.0':
- resolution: {integrity: sha512-aLxAE+imI9bCcyaPrUDjBv3uSkWieifjLe0kuFOZF0zli0L6GCsTmsePnTr55adbIAgYz2zhN1vnFimCBUYcRQ==}
- engines: {node: ^22.18.0 || >=24.11.0}
- hasBin: true
-
- '@babel/parser@8.0.0-rc.6':
- resolution: {integrity: sha512-rOS8IpdO7mQELkTPlCsTgPejO0bFuZdEDCGQJouYbYf9e1FLTym7Fei2pEjq8q7MWbX0ravcd7QQYKs1TxOuog==}
- engines: {node: ^22.18.0 || >=24.11.0}
- hasBin: true
-
- '@babel/types@7.29.7':
- resolution: {integrity: sha512-4zBIxpPzowiZpusoFkyGVwakdRJUyuH5PxQ/PrqghfdFWWasvnCdPfQXHrenDai+gyLARulZjZowCOj6fjT4pA==}
- engines: {node: '>=6.9.0'}
-
- '@babel/types@8.0.0':
- resolution: {integrity: sha512-K8ponJDxBwDHigkeFqaqT5wLGl4bTlwMafR8k7b5CPxr6Ww+UG9ls8Yx6Tcpboxu97eeGVEEyKcHmEyOwN1vSw==}
- engines: {node: ^22.18.0 || >=24.11.0}
-
- '@bcoe/v8-coverage@1.0.2':
- resolution: {integrity: sha512-6zABk/ECA/QYSCQ1NGiVwwbQerUCZ+TQbp64Q3AgmfNvurHH0j8TtXa1qbShXA6qqkpAj4V5W8pP6mLe1mcMqA==}
- engines: {node: '>=18'}
-
- '@emnapi/core@1.10.0':
- resolution: {integrity: sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==}
-
- '@emnapi/core@1.11.1':
- resolution: {integrity: sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==}
-
- '@emnapi/runtime@1.10.0':
- resolution: {integrity: sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==}
-
- '@emnapi/runtime@1.11.1':
- resolution: {integrity: sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==}
-
- '@emnapi/wasi-threads@1.2.1':
- resolution: {integrity: sha512-uTII7OYF+/Mes/MrcIOYp5yOtSMLBWSIoLPpcgwipoiKbli6k322tcoFsxoIIxPDqW01SQGAgko4EzZi2BNv2w==}
-
- '@emnapi/wasi-threads@1.2.2':
- resolution: {integrity: sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==}
-
- '@jridgewell/gen-mapping@0.3.13':
- resolution: {integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==}
-
- '@jridgewell/resolve-uri@3.1.2':
- resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==}
- engines: {node: '>=6.0.0'}
-
- '@jridgewell/sourcemap-codec@1.5.5':
- resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==}
-
- '@jridgewell/trace-mapping@0.3.31':
- resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
-
- '@napi-rs/wasm-runtime@1.1.5':
- resolution: {integrity: sha512-AWPoBRJ9tsnVhor4sjO7rkni+7p+2IAEFj6cx06UgP10jkQHqay/36uRV/bFkgrh18D9vb4cr8Q0Pthskgzy+Q==}
- peerDependencies:
- '@emnapi/core': ^1.7.1
- '@emnapi/runtime': ^1.7.1
-
- '@oxc-project/types@0.133.0':
- resolution: {integrity: sha512-KzkdCd6Uxqnf6l3HOw1xfatAlUURA0g14cvBYFyJ5SaNOQbOUvBr9PKArcPcrNIeRsBdgcUzOGrhKveVpvOIGA==}
-
- '@oxc-project/types@0.137.0':
- resolution: {integrity: sha512-WT+Gb24i8hmvo85AIv2oEYouEXkRlKAlT9WaCa3TfLgNCN+GhrJOGZuIlMouAh38Qe4QOx26eUOVsq70qXrywA==}
-
- '@oxfmt/binding-android-arm-eabi@0.55.0':
- resolution: {integrity: sha512-+rFDOqQe5LOWgxrAJaZgLRudr6GQm0wGI6gtu7vVkrdLGjNMUSGbAlaCr8j7F2H2Er97vYQCU8WDb30onqMM1g==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm]
- os: [android]
-
- '@oxfmt/binding-android-arm64@0.55.0':
- resolution: {integrity: sha512-ctulLq8s3x8Zmvw6+iccB09TIKERAklRSmbJ10gk8mlAn05qZxoyo52dj3Hi9IJcmDSwF54fQaTVh2CbL6PInw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [android]
-
- '@oxfmt/binding-darwin-arm64@0.55.0':
- resolution: {integrity: sha512-xDQczLH9pw/RBk1h/GH0qcGMm8hQtmtVHBNLSH3lk1gEIR09hZ4L+mJQl4VqiVAvPK9VG9PYrWWuSQLt7xTbiA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [darwin]
-
- '@oxfmt/binding-darwin-x64@0.55.0':
- resolution: {integrity: sha512-JaNoFCkF2CJdGgpPSMbuO9HVyXyoNGIhMHPvp6NYAjeVKw9XEYc0HcUWJLPQa3Q69WV5wMa9m5jPMJPtbLtcRg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [darwin]
-
- '@oxfmt/binding-freebsd-x64@0.55.0':
- resolution: {integrity: sha512-DNbszhpg6S2MIzax5azdHFTTBIVkR5xr8yyRZuA4yoDAwOkzIp3tmldgKZM2+VlT+hJIG0xUksA+elISzMEAfA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [freebsd]
-
- '@oxfmt/binding-linux-arm-gnueabihf@0.55.0':
- resolution: {integrity: sha512-2snoaoRfFFyGnbOcKUK36rREBYxe/Xgz3uHbiA5zbCB/s6R4DQj4mHqYAaWWhgizCUSDxV8cE9zAZ0XleNpKGw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm]
- os: [linux]
-
- '@oxfmt/binding-linux-arm-musleabihf@0.55.0':
- resolution: {integrity: sha512-q1aktHF/WRpSK81BX1dE/9vWrS2jGw1Nax2kb4DBLGAewubCLcoNyp4Zl/NSMgbv3vUS46Z33wIQkBVYOP3PYg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm]
- os: [linux]
-
- '@oxfmt/binding-linux-arm64-gnu@0.55.0':
- resolution: {integrity: sha512-VD0y36aENezl/3tsclA/4G53Cc7iV+7Uoh7gz4yvcOTaEYBtJpQsE6PKDGTtUtOvGS4kv51ybfXY/nWZejO5IA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [linux]
- libc: [glibc]
-
- '@oxfmt/binding-linux-arm64-musl@0.55.0':
- resolution: {integrity: sha512-r8xlKJFcsRmn0H5jZrdORae6RX9jDBrZVvOoxF+bCQtampQJClv80aZEHsv+NsLsp2KCE5ql79O7DpPVzYWpXA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [linux]
- libc: [musl]
-
- '@oxfmt/binding-linux-ppc64-gnu@0.55.0':
- resolution: {integrity: sha512-GRKv/HXHcwIVld/WU61rF0g0R16hl5EJ+ScKdpjevT57lnLnagj/U2YUbXf2mT+2Pg1uCzWC+mvGicPV3CDdLQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [ppc64]
- os: [linux]
- libc: [glibc]
-
- '@oxfmt/binding-linux-riscv64-gnu@0.55.0':
- resolution: {integrity: sha512-rdv57enTiPtpSYRMKfAiEbQb0Puw5t9N7isVinDoo5qeLDScro2gznmZqSgSWbVZRzLisTeCTW8Qwgw0bOHv3A==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [riscv64]
- os: [linux]
- libc: [glibc]
-
- '@oxfmt/binding-linux-riscv64-musl@0.55.0':
- resolution: {integrity: sha512-7v1nNrlD43VY6+sYQ6efYyb3lE6QY182304PD/768ZxTjOmFd/3dQa3u/nGBUAXYdGSWOQc5N3PnS0QzUXyEIA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [riscv64]
- os: [linux]
- libc: [musl]
-
- '@oxfmt/binding-linux-s390x-gnu@0.55.0':
- resolution: {integrity: sha512-f4lJLUSPOgScjFl9LiflKCTocyNRwE25JmTMbN4XQdDjoZzEHjqf3wA3VESF1/csg7i8m7+EQLbrZyYDqe10UQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [s390x]
- os: [linux]
- libc: [glibc]
-
- '@oxfmt/binding-linux-x64-gnu@0.55.0':
- resolution: {integrity: sha512-MihqiPziJNoWy4MqNSV+jVA1g+07iQDjZiR0vaCaDoPgFEiJpCMsxamktzLV07cEeQsSJ04vQaU4CzCQwIvtDA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [linux]
- libc: [glibc]
-
- '@oxfmt/binding-linux-x64-musl@0.55.0':
- resolution: {integrity: sha512-Yqghym7KYAVjP9MmSrNZiDeerMuoejNjo0r3ox5H3GDKk8eAfl8VyJm9i+pWCLDCTnAbcTUMMN2ZKjUYXH1v3g==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [linux]
- libc: [musl]
-
- '@oxfmt/binding-openharmony-arm64@0.55.0':
- resolution: {integrity: sha512-s5SDvVVSbyQl1V5UU3Yl12M+XLUQ3rl5SglNqgAA2K4PXUtQhyNSS00wivONPEnNo5W01rCou8WkDNyvI/RGHg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [openharmony]
-
- '@oxfmt/binding-win32-arm64-msvc@0.55.0':
- resolution: {integrity: sha512-7p9FB5R32tw2KyyNX3wpQrR2WHwEHvMEiBlGXxeTCaRMCVNx3UtFMAUbaQ/pRNWIrEUZmYhJ6tcUH52uPTRYjQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [win32]
-
- '@oxfmt/binding-win32-ia32-msvc@0.55.0':
- resolution: {integrity: sha512-ZYqj3fDnOT1IaVGMP5kpmkQl4F3tQIm2ZyAxvqkJYmI0xgWWak4ss4XYwv3VDfM+TWXeC9K4uQ/wW5jm/5XABA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [ia32]
- os: [win32]
-
- '@oxfmt/binding-win32-x64-msvc@0.55.0':
- resolution: {integrity: sha512-eEYT5tivGnGbPHuOHuQpi6CGLObhh0re/5jcNQHihD2GRYkTM85dyi5a19zjP8Q00t1uqAx+/QGLUGdHeqzWyg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [win32]
-
- '@oxlint/binding-android-arm-eabi@1.70.0':
- resolution: {integrity: sha512-zFh0P4cswmRvw6nkyb89dr18rRanuaCPAsEXsFDoQY8WdaquI8Pt4NWFjaMJg6L23cy5NeN8J9cBnREbWzZhaw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm]
- os: [android]
-
- '@oxlint/binding-android-arm64@1.70.0':
- resolution: {integrity: sha512-qI8o4HZjeGiBrWv+pJv4lH0Yi2Gl/JSp/EumBUApezJprIKa5PS4nU0lQsQngtky8k+SplQIOjv6hwu0SSxeyg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [android]
-
- '@oxlint/binding-darwin-arm64@1.70.0':
- resolution: {integrity: sha512-8KjgVVHI5F9nVwHCRwwA78Ty7zNKP4Wd9OeN5PSv3iu/F/u1RVXoOCgLhWqust6HmwQG6xc8c+RCyaWENy24+w==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [darwin]
-
- '@oxlint/binding-darwin-x64@1.70.0':
- resolution: {integrity: sha512-WVydssv5PSUBXFJTdNBWlmGkbNmvPGaFt/2SUT/EZRB6bq6bEOHmMlbnupZD5jmlEvi9+mZJHi8TCw15lyfSfQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [darwin]
-
- '@oxlint/binding-freebsd-x64@1.70.0':
- resolution: {integrity: sha512-hJucmUf8OlinHNb1R7fI4Fw6WsAstOz7i8nmkWQfiHoZXtbufNm+MxiDTIMk1ggh2Ro4vLzgQ+bKvRY54MZoRA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [freebsd]
-
- '@oxlint/binding-linux-arm-gnueabihf@1.70.0':
- resolution: {integrity: sha512-1BnS7wbCYDSXwWzJJ+mc3NURoha6m6m6RT5c6vgAY3oz7C3OVXP+S0awo2mRq97arrJkVvO3qRQfyAHL+76xtQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm]
- os: [linux]
-
- '@oxlint/binding-linux-arm-musleabihf@1.70.0':
- resolution: {integrity: sha512-yKy/UdbR55+M2yEcuiV5DCNC/gdQAjr/GioUy50QwBzSrKm8ueWADqyRLS9Xk+qjNeCYGg6A8FvUBds56ttfqg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm]
- os: [linux]
-
- '@oxlint/binding-linux-arm64-gnu@1.70.0':
- resolution: {integrity: sha512-0A5XJ4alvmqFUFP/4oYSyaO+qLto/HrKEWTSaegiVl+HOufFngK2BjYw9x4RbwBt/du5QG6l5q1zeWiJYYG5yg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [linux]
- libc: [glibc]
-
- '@oxlint/binding-linux-arm64-musl@1.70.0':
- resolution: {integrity: sha512-JiylyurlB0CLSedNtx1gzv3FvfWPF1h/2Y3BJszPLNt5XQFlBsH5ke0Jle3iJb3uqu5m2e7A/DwzpuCAHdiU+A==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [linux]
- libc: [musl]
-
- '@oxlint/binding-linux-ppc64-gnu@1.70.0':
- resolution: {integrity: sha512-J8VPG7I3/HmgaU4u8pNU2kFx2+0U+vPLS1dXFxXOaR/2TQ0f8AC7DRz0SRGRI1bfphnX2hVYTTtLuhL4nYKL+Q==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [ppc64]
- os: [linux]
- libc: [glibc]
-
- '@oxlint/binding-linux-riscv64-gnu@1.70.0':
- resolution: {integrity: sha512-N2+4lV2KLN+oXTIIIwmWDhwkrnvqf5oX7Hw0zPjk+RuIVgiBQSOlJWF7uQoFx2siEYX0ZQ5cfSbEAHm+J3t7Wg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [riscv64]
- os: [linux]
- libc: [glibc]
-
- '@oxlint/binding-linux-riscv64-musl@1.70.0':
- resolution: {integrity: sha512-1e2L7cFCvx9QDzq6NPP+0tABKb5z6nWHyddWTNKprEsjO9xNrAtPowuCGpjNXxkTdsMiZ4jc8YQ5SstZd4XK6g==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [riscv64]
- os: [linux]
- libc: [musl]
-
- '@oxlint/binding-linux-s390x-gnu@1.70.0':
- resolution: {integrity: sha512-Kwu/l/8GcYibCWA9m9N5pRXMIKVSsL/YbgpLzYkqDhWTiqdRfnNJ/+nqIKRKQiFbHWsdlHEhzMwruJK+qcEruA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [s390x]
- os: [linux]
- libc: [glibc]
-
- '@oxlint/binding-linux-x64-gnu@1.70.0':
- resolution: {integrity: sha512-tap04CsHYOl0nSAQJfPNIuBxqEPB2HnhQqwaOXLg1jnp2XfRo8Fa814dA4QC4zpvTWXCjAAaCY1W5LOORkEQuQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [linux]
- libc: [glibc]
-
- '@oxlint/binding-linux-x64-musl@1.70.0':
- resolution: {integrity: sha512-hzJa/WgvtJpbBD9rgfy0qe+MjbxOXNUT0bfR1S6EQQzfTtBFA9xg5q8KSwRrQ2QfSS+TaP4j+4mVPQrfNc6UNg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [linux]
- libc: [musl]
-
- '@oxlint/binding-openharmony-arm64@1.70.0':
- resolution: {integrity: sha512-xbsaNSNzVSnaJACCUYr1HQMyY/Q/Q1LkePmHG3UvZPvGCYGNxrsZp9OmtA6ick8xH47ltRRbRrPCM1YXYcyC+A==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [openharmony]
-
- '@oxlint/binding-win32-arm64-msvc@1.70.0':
- resolution: {integrity: sha512-icAEsUI7JbW1TMRdEXV83mVAInhRVQYuuAlPpxdGwJ95chNdnCzjloRW8GglT0WvzOEZSio6fnYSk2DJ2Hv7LQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [win32]
-
- '@oxlint/binding-win32-ia32-msvc@1.70.0':
- resolution: {integrity: sha512-FHMSWbVsPVs/f+Jcl04ws4JJ2wUnauyTzlpxWRG/lSO/8GpX08Fo2gQZqdA6CrRFI+zvkxl+N/KwJGWfUwYVZA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [ia32]
- os: [win32]
-
- '@oxlint/binding-win32-x64-msvc@1.70.0':
- resolution: {integrity: sha512-ptOlKwCz7n4AKs5VweMqG6DAg677FmKOK+vBkkL9DMNgFATIQ+upqUYBTOEwRQyRAx1ncGlPlXleV2hIcm3z4g==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [win32]
-
- '@quansync/fs@1.0.0':
- resolution: {integrity: sha512-4TJ3DFtlf1L5LDMaM6CanJ/0lckGNtJcMjQ1NAV6zDmA0tEHKZtxNKin8EgPaVX1YzljbxckyT2tJrpQKAtngQ==}
-
- '@rolldown/binding-android-arm64@1.0.3':
- resolution: {integrity: sha512-454rs7jHngixp/NMxd5srYD57OnzSlZ/eFTETjORQHLwJG1lRtmNOJcBerZlfu4GjKqeq8aCCIQrMdHyhI51Hw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [android]
-
- '@rolldown/binding-android-arm64@1.1.2':
- resolution: {integrity: sha512-2cZ+7xRS+DBcuJBJKnfzsbleumJhBqSlJVpuzHC0nTqfd3QQ7Vx2/x5YR/D7cBamKSeWplwo82Fn9lqYUDEMfA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [android]
-
- '@rolldown/binding-darwin-arm64@1.0.3':
- resolution: {integrity: sha512-PcAhP+ynjURNyy8SKGl5DQP94aGuB/7JrXJb/t7P+hanXvQVMWzUvRRhBAcg/lNRadBhoUPqSoP4xw5tR/KBEA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [darwin]
-
- '@rolldown/binding-darwin-arm64@1.1.2':
- resolution: {integrity: sha512-RkPMJnygxsgOYdkfqgpwY0/Fzm8d0VQe6HGU2/B00Xa9eqdLbrII+DOKAodbJAn3ZL1AJxGHkZRPYazgGY6Ljw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [darwin]
-
- '@rolldown/binding-darwin-x64@1.0.3':
- resolution: {integrity: sha512-9YpfeUvSE2RS7wysJ81uOZkXJz7f7Q55H2Gvp3VEw/EsahqDtrphrZ0EwDLK5vvKOzaCrBsjF8JmnMLcUt78Gg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [darwin]
-
- '@rolldown/binding-darwin-x64@1.1.2':
- resolution: {integrity: sha512-Uiczh6vFhwyfd7WNe7Q7mCA4KxAiLdz7jPE/WGizfRpIieoyFuNVMmM8HqZ9HwudTkY6/AeMQwlNJ9NJijguWw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [darwin]
-
- '@rolldown/binding-freebsd-x64@1.0.3':
- resolution: {integrity: sha512-yB1IlAsSNHncV6SCTL27/MVGR5htvQsoGxIv5KMGXALp+Ll1wYsn+x98M9MW7qa+NdSbvrrY7ANI4wLJ0n1e6g==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [freebsd]
-
- '@rolldown/binding-freebsd-x64@1.1.2':
- resolution: {integrity: sha512-+TpdtTRgHiJFjCVFbw311SuLk3KfytPOQQn+VlAEv+gBxYPtL7E6JS9e/tk+8CwxhIZvemJKo4rTKgfWNsKkkA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [freebsd]
-
- '@rolldown/binding-linux-arm-gnueabihf@1.0.3':
- resolution: {integrity: sha512-Yi30IVAAfLUCy2MseFjbB1jAMDl1VMCAas5StnYp8da9+CKvMd2H2cbEjWcw5NPaPqzvYkVIaF1nNUG+b7u/sw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm]
- os: [linux]
-
- '@rolldown/binding-linux-arm-gnueabihf@1.1.2':
- resolution: {integrity: sha512-4lv1/tkmi7ueIVHnyreaOeUpiZP26BH9rRy6hoYfR9310A2B9nUEVRDvBx69vx64Nr3eTPPRkyciqJJs+j9Jmw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm]
- os: [linux]
-
- '@rolldown/binding-linux-arm64-gnu@1.0.3':
- resolution: {integrity: sha512-jsO7R8To+AdlYgUmN5sHSCZbfhtMBkO0WUx8iORQnPcMMdgr7qM2DQmMwgabs3GhNztdmoKkMKQFHD6DTMCIQw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [linux]
- libc: [glibc]
-
- '@rolldown/binding-linux-arm64-gnu@1.1.2':
- resolution: {integrity: sha512-gBSUVO0eaWgw1JMjK3gB8BMlX2Mk148s2lTiVT3e9vjVxbl7UDfMWWY8CfIaaqiXuM9fVTMxIpUz6CAo/B6Vlw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [linux]
- libc: [glibc]
-
- '@rolldown/binding-linux-arm64-musl@1.0.3':
- resolution: {integrity: sha512-VWkUHwWriDciit80wleYwKILoR/KMvxh/IdwS/paX+ZgpuRpCrKLUdadJbc0NpBEiyhpYawsJ73j9aCvOH+f7Q==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [linux]
- libc: [musl]
-
- '@rolldown/binding-linux-arm64-musl@1.1.2':
- resolution: {integrity: sha512-LjQP/iZLBu8o8PjIfk4x3At0/mT6h282pvz8Z5LAyhGbu/kDezyO7ea62rF5uoqmgnIYqbN/MqJ3Si3Aymi7xQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [linux]
- libc: [musl]
-
- '@rolldown/binding-linux-ppc64-gnu@1.0.3':
- resolution: {integrity: sha512-5f1laC0SlIR0yDbFCd8acUhvJIag6N3zC5P7oUPN6wX0aOma+uKJ0wBDH5aq7I1PVI2ttTlhJwzwRIBnLiSGEg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [ppc64]
- os: [linux]
- libc: [glibc]
-
- '@rolldown/binding-linux-ppc64-gnu@1.1.2':
- resolution: {integrity: sha512-X/7bVLWelEsbyWDUSXt7zVsTniLLPIY2n1rH58qr78l9i7MNbbxBWD8gI2vRfBWf4NUXJCUuQnfZDsp32LqsfQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [ppc64]
- os: [linux]
- libc: [glibc]
-
- '@rolldown/binding-linux-s390x-gnu@1.0.3':
- resolution: {integrity: sha512-Iq4ko0r4XsgbrF/LunNgHtAGLRRVE2kXonAXQ/MV0mC6jQpMOhW1SvtZja2EhC/kd05++bP78dsqBeIQyYJ6Yg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [s390x]
- os: [linux]
- libc: [glibc]
-
- '@rolldown/binding-linux-s390x-gnu@1.1.2':
- resolution: {integrity: sha512-gb6dYKW/1KDorGXyy48glEBJs/sxVSC5pcVrox/pFGV4mvwSFeg2sK5L2tRkVsVlh7kueqOgg4GEcuipJcGuKg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [s390x]
- os: [linux]
- libc: [glibc]
-
- '@rolldown/binding-linux-x64-gnu@1.0.3':
- resolution: {integrity: sha512-B8m6tD5+/N5FeNQFbKlLA/2yVq9ycQP1SeedyEYYKWBNR3ZQbkvIUcNnDNM03lO1l5F2roiiFJGgvoLLyZXtSg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [linux]
- libc: [glibc]
-
- '@rolldown/binding-linux-x64-gnu@1.1.2':
- resolution: {integrity: sha512-JY4w85pU3iAiJVMh5nuk4/Mh9GjMsupe8MrIN53rwxAZW64GKrWeJBuN6SxQg9QTU5uB1cxyhDzW8jqRn1EABw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [linux]
- libc: [glibc]
-
- '@rolldown/binding-linux-x64-musl@1.0.3':
- resolution: {integrity: sha512-pSdpdUJHkuCxun9LE7jvgUB9qsRgaiyNNCX7m/AvHTcq67AiT/Yhoxvw5zPfhrM8k/BfP8ce/hMOpthKDpEUow==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [linux]
- libc: [musl]
-
- '@rolldown/binding-linux-x64-musl@1.1.2':
- resolution: {integrity: sha512-xvpA7o5KCYLB0Rwscmuylb1/zHHSUx4g4xilm4prC5jP76pEUlzBmMbgpbh7bVDbId4NcfT96gN5i6mE6UDaiw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [linux]
- libc: [musl]
-
- '@rolldown/binding-openharmony-arm64@1.0.3':
- resolution: {integrity: sha512-OXXS3RKJgX2uLwM+gYyuH5omcH8fL1LJs96pZGgtetVCahON57+d4SJHzTgZiOjxgGkSnpXpOsWuPDGAKAigEg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [openharmony]
-
- '@rolldown/binding-openharmony-arm64@1.1.2':
- resolution: {integrity: sha512-p/ts6KBLjuk49Bp21XH77poQGt02iNz7ChgHep7tudPOaLinR/De/RHdxF8w8Yj4r/bF/bqXwH6PZrB2sA+Nvw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [openharmony]
-
- '@rolldown/binding-wasm32-wasi@1.0.3':
- resolution: {integrity: sha512-JTtb8BWFynicNSoPrehsCzBtOKjZ6jhMiPFEmOiuXg1Fl8dn2KHQob+GuPSGR0dryQa1PQJbzjF3dqO/whhjLg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [wasm32]
-
- '@rolldown/binding-wasm32-wasi@1.1.2':
- resolution: {integrity: sha512-VMu/wmrZ9hJzYlRhbw7jK5PODlugyKZ5mOdX78+lS8OvuFkWNQdz1pFLrI2p3P0pjXOmUZ7B48o5VnMH9QOGtg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [wasm32]
-
- '@rolldown/binding-win32-arm64-msvc@1.0.3':
- resolution: {integrity: sha512-gEdFFEN70A/jxb2svrWsN3aDL7OUtmvlOy+6fa2jxG8K0wQ1ZbdeLGnidov6Yu5/733dI5ySfzFlQ/cb0bSz1g==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [win32]
-
- '@rolldown/binding-win32-arm64-msvc@1.1.2':
- resolution: {integrity: sha512-xtUJqs8qEkuSviS0n1tsohaPuz3a1SPhZywOji4Oo+sgrJs8daEDMZ0QtqL0OS7dx8PoVpg2J/ZZycPY5I2+Zg==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [arm64]
- os: [win32]
-
- '@rolldown/binding-win32-x64-msvc@1.0.3':
- resolution: {integrity: sha512-eXB7CHuaQdqmJcc3koCNtNPmT/bj2gc999kUFgBxG8Ac0NdgXc4rkCHhqrgrhN3zddvvvrgzj1e90SuSfmyIXA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [win32]
-
- '@rolldown/binding-win32-x64-msvc@1.1.2':
- resolution: {integrity: sha512-85YiLQqjUKgSO/Zjnf9e0XIn5Ymrh1fLDWBeAkZqpuBR/3R8TpfoHXuyblqyQrftSSgWO9qpcHN8mkyKsLraoA==}
- engines: {node: ^20.19.0 || >=22.12.0}
- cpu: [x64]
- os: [win32]
-
- '@rolldown/pluginutils@1.0.1':
- resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==}
-
- '@standard-schema/spec@1.1.0':
- resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==}
-
- '@tybys/wasm-util@0.10.2':
- resolution: {integrity: sha512-RoBvJ2X0wuKlWFIjrwffGw1IqZHKQqzIchKaadZZfnNpsAYp2mM0h36JtPCjNDAHGgYez/15uMBpfGwchhiMgg==}
-
- '@types/chai@5.2.3':
- resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==}
-
- '@types/deep-eql@4.0.2':
- resolution: {integrity: sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==}
-
- '@types/estree@1.0.9':
- resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==}
-
- '@types/jsesc@2.5.1':
- resolution: {integrity: sha512-9VN+6yxLOPLOav+7PwjZbxiID2bVaeq0ED4qSQmdQTdjnXJSaCVKTR58t15oqH1H5t8Ng2ZX1SabJVoN9Q34bw==}
-
- '@types/node@26.0.0':
- resolution: {integrity: sha512-vf2YFi1iY9lHGwNJMs01biZFbKJkrZR1T6/MlzjhJLPdntOHLhTrDSnSVcdtvjihi4VQNlrFRIxLsDBlQpAipA==}
-
- '@typescript/native-preview-darwin-arm64@7.0.0-dev.20260619.1':
- resolution: {integrity: sha512-i07qdTFQEBYotjg/Iy0GAfARSFyKAjXmP5BNPo6+QXGOp5hJNnmXSxGyhIlooqbDXluTQRhESEmzVAuvYryKCA==}
- engines: {node: '>=16.20.0'}
- cpu: [arm64]
- os: [darwin]
-
- '@typescript/native-preview-darwin-x64@7.0.0-dev.20260619.1':
- resolution: {integrity: sha512-WVetqm9ypzLv+b/8+SRYuO6bJDC4AaQmT/1EcYh8iP6y5vZl3h13iscJ+45eHc4Y3yMyoDHOivfOTyTIMH2Vrw==}
- engines: {node: '>=16.20.0'}
- cpu: [x64]
- os: [darwin]
-
- '@typescript/native-preview-linux-arm64@7.0.0-dev.20260619.1':
- resolution: {integrity: sha512-peEnXecjZsnsW24GutRasmZlIgRLbyXPoR0inMkzXT1h7/+Ns5tM8RPnuxelXoC10dg4Ajo8I9BlUAgX45LwEQ==}
- engines: {node: '>=16.20.0'}
- cpu: [arm64]
- os: [linux]
-
- '@typescript/native-preview-linux-arm@7.0.0-dev.20260619.1':
- resolution: {integrity: sha512-mqUzZ9htNWH0su9+A5QqnHJ25hQ+E8Cq5qOOmfdQjiCQnPT69HQZ9MiUozQc1qk0i9/UaXouYDK48Pe0oUvUOw==}
- engines: {node: '>=16.20.0'}
- cpu: [arm]
- os: [linux]
-
- '@typescript/native-preview-linux-x64@7.0.0-dev.20260619.1':
- resolution: {integrity: sha512-vZhIHvtpQE4ZICMIzIrOVOl/YYOLJjA91CsJMyetNNzvuQCCtll7CWUsS6Sp1IdRqJdwM6seJrdDEAtWkEMFkA==}
- engines: {node: '>=16.20.0'}
- cpu: [x64]
- os: [linux]
-
- '@typescript/native-preview-win32-arm64@7.0.0-dev.20260619.1':
- resolution: {integrity: sha512-pRdZDV9Q3IzBKOi5WrIaEnlkVLB0w3zVj2/BliPV/oQ8r8N+4LmSCuyy8PbL5bMw8SznTlmiIfv5gvoEx2SpEw==}
- engines: {node: '>=16.20.0'}
- cpu: [arm64]
- os: [win32]
-
- '@typescript/native-preview-win32-x64@7.0.0-dev.20260619.1':
- resolution: {integrity: sha512-sOvPE+lA/+SU/cnva+MXA1oq70HO0lLajsj9ZA10T1CN1PUGgaC1Zw7V0objTJsZ9ri6I3Ldp+Fh4Onz3mLDXw==}
- engines: {node: '>=16.20.0'}
- cpu: [x64]
- os: [win32]
-
- '@typescript/native-preview@7.0.0-dev.20260619.1':
- resolution: {integrity: sha512-YDmSiD6l+nikPoqrwDKn9wkCFUDFJCfkKcOKrYVycX5plwu6H03JWKyW1h1HjEfrMVw4Mq/Qk12VTsXJWP4TDQ==}
- engines: {node: '>=16.20.0'}
- hasBin: true
-
- '@vitest/coverage-v8@4.1.9':
- resolution: {integrity: sha512-G9/lgqibheLVBDRuya45EbsEXTYcWoSG+TLg7i2axuzx0Eq62eXn+aWXyaVdV5vKvFSWd6ywcX8hA7la9Pvu8g==}
- peerDependencies:
- '@vitest/browser': 4.1.9
- vitest: 4.1.9
- peerDependenciesMeta:
- '@vitest/browser':
- optional: true
-
- '@vitest/expect@4.1.9':
- resolution: {integrity: sha512-vl/rYsUKcBr3SnQn166+XR5ZQcgMx3DQhFWdfli/cWpLnLUmbxZvyrJZotLFUryib+LtArYMSTJ5RbQ57ZqrlA==}
-
- '@vitest/mocker@4.1.9':
- resolution: {integrity: sha512-EVkXzBjrPGM+cK8/ANWgBrkUCfJfb38/EfTSO8h7pWvKkyPkpWxvR7BkD2MyItMF62C97zAEoqdpUixwR/e+Rw==}
- peerDependencies:
- msw: ^2.4.9
- vite: ^6.0.0 || ^7.0.0 || ^8.0.0
- peerDependenciesMeta:
- msw:
- optional: true
- vite:
- optional: true
-
- '@vitest/pretty-format@4.1.9':
- resolution: {integrity: sha512-s0iufns3iIFitdgm+YR7g1whCAaGtXz459VS9/PqyKDEEFgYIhsHOQmXgIgDuYCt7DeQmiZT0Qe2OA2p4ZPu5A==}
-
- '@vitest/runner@4.1.9':
- resolution: {integrity: sha512-KXLMDtc7oe70+3mJfGrPUWPesswH+3sTxAMAMl8DG7I8IUQT4XW718dY5ID3vPUcmlu27CcKfY4P3h3I29SLJg==}
-
- '@vitest/snapshot@4.1.9':
- resolution: {integrity: sha512-Jc7RKGNBo8Z28WYIm0Niej4xdSPByRf6mU58VpHQkd6Zh05rlnA+twjbK5HyeIGHxrzsc3mJgS43uM0CZKzaIA==}
-
- '@vitest/spy@4.1.9':
- resolution: {integrity: sha512-fHpsS6mIi+PiEW+vcRVOMkX1oSaPKne3VOclSFICPcGOmfKgXPU5iAah+wcNcj2xPrCCmfq99IDGf+EojhhvhA==}
-
- '@vitest/utils@4.1.9':
- resolution: {integrity: sha512-A51o8ymO5PpqlWNnBP9ZHPXDIpuMtTLlGSjN7la4US+LJzoUMyhwjA5QXlm39JexgwHKW4Xjs8Z2d3dLCXOeuA==}
-
- args-tokenizer@0.3.0:
- resolution: {integrity: sha512-xXAd7G2Mll5W8uo37GETpQ2VrE84M181Z7ugHFGQnJZ50M2mbOv0osSZ9VsSgPfJQ+LVG0prSi0th+ELMsno7Q==}
-
- assertion-error@2.0.1:
- resolution: {integrity: sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==}
- engines: {node: '>=12'}
-
- ast-kit@3.0.0:
- resolution: {integrity: sha512-8OG92q3R35qjC/4i6BLBMg8IB+fClWu/1PEwg2Z9Rn+BuNaiEgJzpzn+pxWOdHJWDCAwu2JP0wCDTozAM4QirQ==}
- engines: {node: ^22.18.0 || >=24.11.0}
-
- ast-v8-to-istanbul@1.0.4:
- resolution: {integrity: sha512-0bC0/4bTSrnwdhU3IsZDwEdojvuPrSg59OYZfKsLRtJZ0u8VBx9DebfqqG8bRdCC0I7vjgxmPi41P0lpkhJHtA==}
-
- birpc@4.0.0:
- resolution: {integrity: sha512-LShSxJP0KTmd101b6DRyGBj57LZxSDYWKitQNW/mi8GRMvZb078Uf9+pveax1DrVL89vm7mWe+TovdI/UDOuPw==}
-
- bumpp@11.1.0:
- resolution: {integrity: sha512-jdwOGMyX8JIqpQ0N2RMRR87DHZaoJnUtui5lU9LqFfFK5JC0H8qY9uWqXoa+dEWt/K7rOmmsoyiZB8RBM7RPBQ==}
- engines: {node: '>=20.19.0'}
- hasBin: true
-
- c12@4.0.0-beta.5:
- resolution: {integrity: sha512-yWGCPCQGJeFq4R0mFg5HOhC3Rg+B0PCdM+ldXWUhughoGgeeq8/tjRmXh4/lmhKWyhf+KOFxB/JMXf0Yv1Fd5A==}
- peerDependencies:
- chokidar: ^5
- dotenv: '*'
- giget: '*'
- jiti: '*'
- magicast: '*'
- peerDependenciesMeta:
- chokidar:
- optional: true
- dotenv:
- optional: true
- giget:
- optional: true
- jiti:
- optional: true
- magicast:
- optional: true
-
- cac@7.0.0:
- resolution: {integrity: sha512-tixWYgm5ZoOD+3g6UTea91eow5z6AAHaho3g0V9CNSNb45gM8SmflpAc+GRd1InC4AqN/07Unrgp56Y94N9hJQ==}
- engines: {node: '>=20.19.0'}
-
- chai@6.2.2:
- resolution: {integrity: sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==}
- engines: {node: '>=18'}
-
- confbox@0.2.4:
- resolution: {integrity: sha512-ysOGlgTFbN2/Y6Cg3Iye8YKulHw+R2fNXHrgSmXISQdMnomY6eNDprVdW9R5xBguEqI954+S6709UyiO7B+6OQ==}
-
- consola@3.4.2:
- resolution: {integrity: sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA==}
- engines: {node: ^14.18.0 || >=16.10.0}
-
- convert-source-map@2.0.0:
- resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}
-
- defu@6.1.7:
- resolution: {integrity: sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==}
-
- destr@2.0.5:
- resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==}
-
- detect-libc@2.1.2:
- resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
- engines: {node: '>=8'}
-
- dts-resolver@3.0.0:
- resolution: {integrity: sha512-1T1f+z+4tl9XD+m+0HBgWoL/nm0bOIffyWaUuUSBlFg/86IWvfx+wjNaO/ybU0AJzG9/Mi5hBUgGV6zCmWEN7Q==}
- engines: {node: ^22.18.0 || >=24.0.0}
- peerDependencies:
- oxc-resolver: '>=11.0.0'
- peerDependenciesMeta:
- oxc-resolver:
- optional: true
-
- es-module-lexer@2.1.0:
- resolution: {integrity: sha512-n27zTYMjYu1aj4MjCWzSP7G9r75utsaoc8m61weK+W8JMBGGQybd43GstCXZ3WNmSFtGT9wi59qQTW6mhTR5LQ==}
-
- estree-walker@3.0.3:
- resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}
-
- expect-type@1.3.0:
- resolution: {integrity: sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==}
- engines: {node: '>=12.0.0'}
-
- exsolve@1.0.8:
- resolution: {integrity: sha512-LmDxfWXwcTArk8fUEnOfSZpHOJ6zOMUJKOtFLFqJLoKJetuQG874Uc7/Kki7zFLzYybmZhp1M7+98pfMqeX8yA==}
-
- fdir@6.5.0:
- resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
- engines: {node: '>=12.0.0'}
- peerDependencies:
- picomatch: ^3 || ^4
- peerDependenciesMeta:
- picomatch:
- optional: true
-
- fsevents@2.3.3:
- resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
- engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
- os: [darwin]
-
- get-tsconfig@5.0.0-beta.5:
- resolution: {integrity: sha512-/6gFNr0N04nob252sTQxyFLi3eKFRqIg1I87YcqAMT1i6SQrSF6KujUEQrtrjMV0H/eejTCltLdDSTEMzHbnsQ==}
- engines: {node: '>=20.20.0'}
-
- has-flag@4.0.0:
- resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
- engines: {node: '>=8'}
-
- html-escaper@2.0.2:
- resolution: {integrity: sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==}
-
- istanbul-lib-coverage@3.2.2:
- resolution: {integrity: sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==}
- engines: {node: '>=8'}
-
- istanbul-lib-report@3.0.1:
- resolution: {integrity: sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==}
- engines: {node: '>=10'}
-
- istanbul-reports@3.2.0:
- resolution: {integrity: sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==}
- engines: {node: '>=8'}
-
- jiti@2.7.0:
- resolution: {integrity: sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ==}
- hasBin: true
-
- js-tokens@10.0.0:
- resolution: {integrity: sha512-lM/UBzQmfJRo9ABXbPWemivdCW8V2G8FHaHdypQaIy523snUjog0W71ayWXTjiR+ixeMyVHN2XcpnTd/liPg/Q==}
-
- jsesc@3.1.0:
- resolution: {integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==}
- engines: {node: '>=6'}
- hasBin: true
-
- jsonc-parser@3.3.1:
- resolution: {integrity: sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==}
-
- lightningcss-android-arm64@1.32.0:
- resolution: {integrity: sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg==}
- engines: {node: '>= 12.0.0'}
- cpu: [arm64]
- os: [android]
-
- lightningcss-darwin-arm64@1.32.0:
- resolution: {integrity: sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ==}
- engines: {node: '>= 12.0.0'}
- cpu: [arm64]
- os: [darwin]
-
- lightningcss-darwin-x64@1.32.0:
- resolution: {integrity: sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w==}
- engines: {node: '>= 12.0.0'}
- cpu: [x64]
- os: [darwin]
-
- lightningcss-freebsd-x64@1.32.0:
- resolution: {integrity: sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig==}
- engines: {node: '>= 12.0.0'}
- cpu: [x64]
- os: [freebsd]
-
- lightningcss-linux-arm-gnueabihf@1.32.0:
- resolution: {integrity: sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw==}
- engines: {node: '>= 12.0.0'}
- cpu: [arm]
- os: [linux]
-
- lightningcss-linux-arm64-gnu@1.32.0:
- resolution: {integrity: sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ==}
- engines: {node: '>= 12.0.0'}
- cpu: [arm64]
- os: [linux]
- libc: [glibc]
-
- lightningcss-linux-arm64-musl@1.32.0:
- resolution: {integrity: sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==}
- engines: {node: '>= 12.0.0'}
- cpu: [arm64]
- os: [linux]
- libc: [musl]
-
- lightningcss-linux-x64-gnu@1.32.0:
- resolution: {integrity: sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==}
- engines: {node: '>= 12.0.0'}
- cpu: [x64]
- os: [linux]
- libc: [glibc]
-
- lightningcss-linux-x64-musl@1.32.0:
- resolution: {integrity: sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==}
- engines: {node: '>= 12.0.0'}
- cpu: [x64]
- os: [linux]
- libc: [musl]
-
- lightningcss-win32-arm64-msvc@1.32.0:
- resolution: {integrity: sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==}
- engines: {node: '>= 12.0.0'}
- cpu: [arm64]
- os: [win32]
-
- lightningcss-win32-x64-msvc@1.32.0:
- resolution: {integrity: sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q==}
- engines: {node: '>= 12.0.0'}
- cpu: [x64]
- os: [win32]
-
- lightningcss@1.32.0:
- resolution: {integrity: sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==}
- engines: {node: '>= 12.0.0'}
-
- magic-string@0.30.21:
- resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
-
- magicast@0.5.3:
- resolution: {integrity: sha512-pVKE4UdSQ7DvHzivsCIFx2BJn1mHG6KsyrFcaxFx6tONdneEuThrDx0Cj3AMg58KyN4pzYT+LHOotxDQDjNvkw==}
-
- make-dir@4.0.0:
- resolution: {integrity: sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==}
- engines: {node: '>=10'}
-
- nanoid@3.3.13:
- resolution: {integrity: sha512-sPdqC6ByMVVGvF1ynvvMo0/o+oD1VX7DaHhijt1bFgjvBkHBib4t49GoNDhf2NDta4oeUNlaGbSt5K7qjZ955Q==}
- engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
- hasBin: true
-
- obug@2.1.3:
- resolution: {integrity: sha512-9miFgM2OFba7hB+pRgvtV84pYTBaoTHohvmIgiRt6dRIzbwEOIaNaP+dIlGs2fNFoB0SeISs0Jz5WFVRid6Xyg==}
- engines: {node: '>=12.20.0'}
-
- obuild@0.4.36:
- resolution: {integrity: sha512-1kenNV3u2Xo+hsP6RSugfmQWG9sspawGJMQ3zRG1ZcE+vaDCfiWYCR5J9O7ZRRu6t/b82nyDxbHo817ZI8OeJg==}
- hasBin: true
-
- oxfmt@0.55.0:
- resolution: {integrity: sha512-jSj2wCTakwgPMxkfiVZX0jf+nX+Nz6xlyAZjqNE0qXTFdCBPYlP6JAN+ODjmealw7DXBjOzYbdsqwBMAZnPZ6A==}
- engines: {node: ^20.19.0 || >=22.12.0}
- hasBin: true
- peerDependencies:
- svelte: ^5.0.0
- vite-plus: '*'
- peerDependenciesMeta:
- svelte:
- optional: true
- vite-plus:
- optional: true
-
- oxlint@1.70.0:
- resolution: {integrity: sha512-D6JgHtzkhRwvEC+A0Nw5AEc5bk8x5i1pHzvZIEf/a0C4hOzmAACNGtkDGPyFaxxX3ZVGxCPeig3P3rMM8XU3/g==}
- engines: {node: ^20.19.0 || >=22.12.0}
- hasBin: true
- peerDependencies:
- oxlint-tsgolint: '>=0.22.1'
- vite-plus: '*'
- peerDependenciesMeta:
- oxlint-tsgolint:
- optional: true
- vite-plus:
- optional: true
-
- package-manager-detector@1.6.0:
- resolution: {integrity: sha512-61A5ThoTiDG/C8s8UMZwSorAGwMJ0ERVGj2OjoW5pAalsNOg15+iQiPzrLJ4jhZ1HJzmC2PIHT2oEiH3R5fzNA==}
-
- pathe@2.0.3:
- resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
-
- picocolors@1.1.1:
- resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}
-
- picomatch@4.0.4:
- resolution: {integrity: sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==}
- engines: {node: '>=12'}
-
- pkg-types@2.3.1:
- resolution: {integrity: sha512-y+ichcgc2LrADuhLNAx8DFjVfgz91pRxfZdI3UDhxHvcVEZsenLO+7XaU5vOp0u/7V/wZ+plyuQxtrDlZJ+yeg==}
-
- postcss@8.5.15:
- resolution: {integrity: sha512-FfR8sjd4em2T6fb3I2MwAJU7HWVMr9zba+enmQeeWFfCbm+UOC/0X4DS8XtpUTMwWMGbjKYP7xjfNekzyGmB3A==}
- engines: {node: ^10 || ^12 || >=14}
-
- quansync@1.0.0:
- resolution: {integrity: sha512-5xZacEEufv3HSTPQuchrvV6soaiACMFnq1H8wkVioctoH3TRha9Sz66lOxRwPK/qZj7HPiSveih9yAyh98gvqA==}
-
- rc9@3.0.1:
- resolution: {integrity: sha512-gMDyleLWVE+i6Sgtc0QbbY6pEKqYs97NGi6isHQPqYlLemPoO8dxQ3uGi0f4NiP98c+jMW6cG1Kx9dDwfvqARQ==}
-
- resolve-pkg-maps@1.0.0:
- resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
-
- rolldown-plugin-dts@0.25.2:
- resolution: {integrity: sha512-nMhN/R+vmR8GM45ZW1FWMSjRTSDDn/6w4GTf8RNrEFCBdl8B1kySWrU1ixPtbwzXoRlcO+R/S88VgXuJQwfdDg==}
- engines: {node: ^22.18.0 || >=24.0.0}
- peerDependencies:
- '@ts-macro/tsc': ^0.3.6
- '@typescript/native-preview': '>=7.0.0-dev.20260325.1'
- rolldown: ^1.0.0
- typescript: ^5.0.0 || ^6.0.0
- vue-tsc: ~3.2.0
- peerDependenciesMeta:
- '@ts-macro/tsc':
- optional: true
- '@typescript/native-preview':
- optional: true
- typescript:
- optional: true
- vue-tsc:
- optional: true
-
- rolldown@1.0.3:
- resolution: {integrity: sha512-i00lAJ2ks1BYr7rjNjKC7BcqAS7nVfiT3QX1SI5aY+AFHblCmaUf9OE9dbdzDvW6dJxbi2ZCZiy9v3CcwOiX3g==}
- engines: {node: ^20.19.0 || >=22.12.0}
- hasBin: true
-
- rolldown@1.1.2:
- resolution: {integrity: sha512-x0CrQQqCXWGeI8dTvFfN/Dnv3yMKT9hv5jFjlOreKAx9wqLq9wz7VvLLHyaAXC90/CpggTu9SisSbsJJTPSjNQ==}
- engines: {node: ^20.19.0 || >=22.12.0}
- hasBin: true
-
- semver@7.8.4:
- resolution: {integrity: sha512-rUCObTnP32Q08R2uuIrt7r9PlEonuTmtuXYcW6s5kjdlj3xbnwe+21yXptAUYcMAABLkYYTtnmzb3w3EDZfueA==}
- engines: {node: '>=10'}
- hasBin: true
-
- siginfo@2.0.0:
- resolution: {integrity: sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==}
-
- source-map-js@1.2.1:
- resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
- engines: {node: '>=0.10.0'}
-
- stackback@0.0.2:
- resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==}
-
- std-env@4.1.0:
- resolution: {integrity: sha512-Rq7ybcX2RuC55r9oaPVEW7/xu3tj8u4GeBYHBWCychFtzMIr86A7e3PPEBPT37sHStKX3+TiX/Fr/ACmJLVlLQ==}
-
- supports-color@7.2.0:
- resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
- engines: {node: '>=8'}
-
- tinybench@2.9.0:
- resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==}
-
- tinyexec@1.2.4:
- resolution: {integrity: sha512-SHf/r48b7vOrjve9PxJo3MN5v5yuyjHvdUcrQffT3WXMUfnGmHDVbC4k3sHJaJTgZCwpUplIaAo5ANtMyp3YHg==}
- engines: {node: '>=18'}
-
- tinyglobby@0.2.17:
- resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==}
- engines: {node: '>=12.0.0'}
-
- tinypool@2.1.0:
- resolution: {integrity: sha512-Pugqs6M0m7Lv1I7FtxN4aoyToKg1C4tu+/381vH35y8oENM/Ai7f7C4StcoK4/+BSw9ebcS8jRiVrORFKCALLw==}
- engines: {node: ^20.0.0 || >=22.0.0}
-
- tinyrainbow@3.1.0:
- resolution: {integrity: sha512-Bf+ILmBgretUrdJxzXM0SgXLZ3XfiaUuOj/IKQHuTXip+05Xn+uyEYdVg0kYDipTBcLrCVyUzAPz7QmArb0mmw==}
- engines: {node: '>=14.0.0'}
-
- tslib@2.8.1:
- resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
-
- typescript@6.0.3:
- resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==}
- engines: {node: '>=14.17'}
- hasBin: true
-
- unconfig-core@7.5.0:
- resolution: {integrity: sha512-Su3FauozOGP44ZmKdHy2oE6LPjk51M/TRRjHv2HNCWiDvfvCoxC2lno6jevMA91MYAdCdwP05QnWdWpSbncX/w==}
-
- unconfig@7.5.0:
- resolution: {integrity: sha512-oi8Qy2JV4D3UQ0PsopR28CzdQ3S/5A1zwsUwp/rosSbfhJ5z7b90bIyTwi/F7hCLD4SGcZVjDzd4XoUQcEanvA==}
-
- undici-types@8.3.0:
- resolution: {integrity: sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ==}
-
- vite@8.0.16:
- resolution: {integrity: sha512-h9bXPmJichP5fLmVQo3PyaGSDE2n3aPuomeAlVRm0JLmt4rY6zmPKd59HYI4LNW8oTK7tlTsuC7l/m7awx9Jcw==}
- engines: {node: ^20.19.0 || >=22.12.0}
- hasBin: true
- peerDependencies:
- '@types/node': ^20.19.0 || >=22.12.0
- '@vitejs/devtools': ^0.1.18
- esbuild: ^0.27.0 || ^0.28.0
- jiti: '>=1.21.0'
- less: ^4.0.0
- sass: ^1.70.0
- sass-embedded: ^1.70.0
- stylus: '>=0.54.8'
- sugarss: ^5.0.0
- terser: ^5.16.0
- tsx: ^4.8.1
- yaml: ^2.4.2
- peerDependenciesMeta:
- '@types/node':
- optional: true
- '@vitejs/devtools':
- optional: true
- esbuild:
- optional: true
- jiti:
- optional: true
- less:
- optional: true
- sass:
- optional: true
- sass-embedded:
- optional: true
- stylus:
- optional: true
- sugarss:
- optional: true
- terser:
- optional: true
- tsx:
- optional: true
- yaml:
- optional: true
-
- vitest@4.1.9:
- resolution: {integrity: sha512-nE3/LEyc0z87uHYLZebqCUOaJr2hdtuPp7BQ4BosVFnfltxgAvMG08NyrSGlPpOUWvR27c5flSmYFTNr78L9GQ==}
- engines: {node: ^20.0.0 || ^22.0.0 || >=24.0.0}
- hasBin: true
- peerDependencies:
- '@edge-runtime/vm': '*'
- '@opentelemetry/api': ^1.9.0
- '@types/node': ^20.0.0 || ^22.0.0 || >=24.0.0
- '@vitest/browser-playwright': 4.1.9
- '@vitest/browser-preview': 4.1.9
- '@vitest/browser-webdriverio': 4.1.9
- '@vitest/coverage-istanbul': 4.1.9
- '@vitest/coverage-v8': 4.1.9
- '@vitest/ui': 4.1.9
- happy-dom: '*'
- jsdom: '*'
- vite: ^6.0.0 || ^7.0.0 || ^8.0.0
- peerDependenciesMeta:
- '@edge-runtime/vm':
- optional: true
- '@opentelemetry/api':
- optional: true
- '@types/node':
- optional: true
- '@vitest/browser-playwright':
- optional: true
- '@vitest/browser-preview':
- optional: true
- '@vitest/browser-webdriverio':
- optional: true
- '@vitest/coverage-istanbul':
- optional: true
- '@vitest/coverage-v8':
- optional: true
- '@vitest/ui':
- optional: true
- happy-dom:
- optional: true
- jsdom:
- optional: true
-
- why-is-node-running@2.3.0:
- resolution: {integrity: sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==}
- engines: {node: '>=8'}
- hasBin: true
-
- yaml@2.9.0:
- resolution: {integrity: sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==}
- engines: {node: '>= 14.6'}
- hasBin: true
-
-snapshots:
-
- '@babel/generator@8.0.0-rc.6':
- dependencies:
- '@babel/parser': 8.0.0-rc.6
- '@babel/types': 8.0.0
- '@jridgewell/gen-mapping': 0.3.13
- '@jridgewell/trace-mapping': 0.3.31
- '@types/jsesc': 2.5.1
- jsesc: 3.1.0
-
- '@babel/helper-string-parser@7.29.7': {}
-
- '@babel/helper-string-parser@8.0.0': {}
-
- '@babel/helper-validator-identifier@7.29.7': {}
-
- '@babel/helper-validator-identifier@8.0.0-rc.6': {}
-
- '@babel/helper-validator-identifier@8.0.2': {}
-
- '@babel/parser@7.29.7':
- dependencies:
- '@babel/types': 7.29.7
-
- '@babel/parser@8.0.0':
- dependencies:
- '@babel/types': 8.0.0
-
- '@babel/parser@8.0.0-rc.6':
- dependencies:
- '@babel/types': 8.0.0
-
- '@babel/types@7.29.7':
- dependencies:
- '@babel/helper-string-parser': 7.29.7
- '@babel/helper-validator-identifier': 7.29.7
-
- '@babel/types@8.0.0':
- dependencies:
- '@babel/helper-string-parser': 8.0.0
- '@babel/helper-validator-identifier': 8.0.2
-
- '@bcoe/v8-coverage@1.0.2': {}
-
- '@emnapi/core@1.10.0':
- dependencies:
- '@emnapi/wasi-threads': 1.2.1
- tslib: 2.8.1
- optional: true
-
- '@emnapi/core@1.11.1':
- dependencies:
- '@emnapi/wasi-threads': 1.2.2
- tslib: 2.8.1
- optional: true
-
- '@emnapi/runtime@1.10.0':
- dependencies:
- tslib: 2.8.1
- optional: true
-
- '@emnapi/runtime@1.11.1':
- dependencies:
- tslib: 2.8.1
- optional: true
-
- '@emnapi/wasi-threads@1.2.1':
- dependencies:
- tslib: 2.8.1
- optional: true
-
- '@emnapi/wasi-threads@1.2.2':
- dependencies:
- tslib: 2.8.1
- optional: true
-
- '@jridgewell/gen-mapping@0.3.13':
- dependencies:
- '@jridgewell/sourcemap-codec': 1.5.5
- '@jridgewell/trace-mapping': 0.3.31
-
- '@jridgewell/resolve-uri@3.1.2': {}
-
- '@jridgewell/sourcemap-codec@1.5.5': {}
-
- '@jridgewell/trace-mapping@0.3.31':
- dependencies:
- '@jridgewell/resolve-uri': 3.1.2
- '@jridgewell/sourcemap-codec': 1.5.5
-
- '@napi-rs/wasm-runtime@1.1.5(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)':
- dependencies:
- '@emnapi/core': 1.10.0
- '@emnapi/runtime': 1.10.0
- '@tybys/wasm-util': 0.10.2
- optional: true
-
- '@napi-rs/wasm-runtime@1.1.5(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1)':
- dependencies:
- '@emnapi/core': 1.11.1
- '@emnapi/runtime': 1.11.1
- '@tybys/wasm-util': 0.10.2
- optional: true
-
- '@oxc-project/types@0.133.0': {}
-
- '@oxc-project/types@0.137.0': {}
-
- '@oxfmt/binding-android-arm-eabi@0.55.0':
- optional: true
-
- '@oxfmt/binding-android-arm64@0.55.0':
- optional: true
-
- '@oxfmt/binding-darwin-arm64@0.55.0':
- optional: true
-
- '@oxfmt/binding-darwin-x64@0.55.0':
- optional: true
-
- '@oxfmt/binding-freebsd-x64@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-arm-gnueabihf@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-arm-musleabihf@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-arm64-gnu@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-arm64-musl@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-ppc64-gnu@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-riscv64-gnu@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-riscv64-musl@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-s390x-gnu@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-x64-gnu@0.55.0':
- optional: true
-
- '@oxfmt/binding-linux-x64-musl@0.55.0':
- optional: true
-
- '@oxfmt/binding-openharmony-arm64@0.55.0':
- optional: true
-
- '@oxfmt/binding-win32-arm64-msvc@0.55.0':
- optional: true
-
- '@oxfmt/binding-win32-ia32-msvc@0.55.0':
- optional: true
-
- '@oxfmt/binding-win32-x64-msvc@0.55.0':
- optional: true
-
- '@oxlint/binding-android-arm-eabi@1.70.0':
- optional: true
-
- '@oxlint/binding-android-arm64@1.70.0':
- optional: true
-
- '@oxlint/binding-darwin-arm64@1.70.0':
- optional: true
-
- '@oxlint/binding-darwin-x64@1.70.0':
- optional: true
-
- '@oxlint/binding-freebsd-x64@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-arm-gnueabihf@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-arm-musleabihf@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-arm64-gnu@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-arm64-musl@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-ppc64-gnu@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-riscv64-gnu@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-riscv64-musl@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-s390x-gnu@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-x64-gnu@1.70.0':
- optional: true
-
- '@oxlint/binding-linux-x64-musl@1.70.0':
- optional: true
-
- '@oxlint/binding-openharmony-arm64@1.70.0':
- optional: true
-
- '@oxlint/binding-win32-arm64-msvc@1.70.0':
- optional: true
-
- '@oxlint/binding-win32-ia32-msvc@1.70.0':
- optional: true
-
- '@oxlint/binding-win32-x64-msvc@1.70.0':
- optional: true
-
- '@quansync/fs@1.0.0':
- dependencies:
- quansync: 1.0.0
-
- '@rolldown/binding-android-arm64@1.0.3':
- optional: true
-
- '@rolldown/binding-android-arm64@1.1.2':
- optional: true
-
- '@rolldown/binding-darwin-arm64@1.0.3':
- optional: true
-
- '@rolldown/binding-darwin-arm64@1.1.2':
- optional: true
-
- '@rolldown/binding-darwin-x64@1.0.3':
- optional: true
-
- '@rolldown/binding-darwin-x64@1.1.2':
- optional: true
-
- '@rolldown/binding-freebsd-x64@1.0.3':
- optional: true
-
- '@rolldown/binding-freebsd-x64@1.1.2':
- optional: true
-
- '@rolldown/binding-linux-arm-gnueabihf@1.0.3':
- optional: true
-
- '@rolldown/binding-linux-arm-gnueabihf@1.1.2':
- optional: true
-
- '@rolldown/binding-linux-arm64-gnu@1.0.3':
- optional: true
-
- '@rolldown/binding-linux-arm64-gnu@1.1.2':
- optional: true
-
- '@rolldown/binding-linux-arm64-musl@1.0.3':
- optional: true
-
- '@rolldown/binding-linux-arm64-musl@1.1.2':
- optional: true
-
- '@rolldown/binding-linux-ppc64-gnu@1.0.3':
- optional: true
-
- '@rolldown/binding-linux-ppc64-gnu@1.1.2':
- optional: true
-
- '@rolldown/binding-linux-s390x-gnu@1.0.3':
- optional: true
-
- '@rolldown/binding-linux-s390x-gnu@1.1.2':
- optional: true
-
- '@rolldown/binding-linux-x64-gnu@1.0.3':
- optional: true
-
- '@rolldown/binding-linux-x64-gnu@1.1.2':
- optional: true
-
- '@rolldown/binding-linux-x64-musl@1.0.3':
- optional: true
-
- '@rolldown/binding-linux-x64-musl@1.1.2':
- optional: true
-
- '@rolldown/binding-openharmony-arm64@1.0.3':
- optional: true
-
- '@rolldown/binding-openharmony-arm64@1.1.2':
- optional: true
-
- '@rolldown/binding-wasm32-wasi@1.0.3':
- dependencies:
- '@emnapi/core': 1.10.0
- '@emnapi/runtime': 1.10.0
- '@napi-rs/wasm-runtime': 1.1.5(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
- optional: true
-
- '@rolldown/binding-wasm32-wasi@1.1.2':
- dependencies:
- '@emnapi/core': 1.11.1
- '@emnapi/runtime': 1.11.1
- '@napi-rs/wasm-runtime': 1.1.5(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1)
- optional: true
-
- '@rolldown/binding-win32-arm64-msvc@1.0.3':
- optional: true
-
- '@rolldown/binding-win32-arm64-msvc@1.1.2':
- optional: true
-
- '@rolldown/binding-win32-x64-msvc@1.0.3':
- optional: true
-
- '@rolldown/binding-win32-x64-msvc@1.1.2':
- optional: true
-
- '@rolldown/pluginutils@1.0.1': {}
-
- '@standard-schema/spec@1.1.0': {}
-
- '@tybys/wasm-util@0.10.2':
- dependencies:
- tslib: 2.8.1
- optional: true
-
- '@types/chai@5.2.3':
- dependencies:
- '@types/deep-eql': 4.0.2
- assertion-error: 2.0.1
-
- '@types/deep-eql@4.0.2': {}
-
- '@types/estree@1.0.9': {}
-
- '@types/jsesc@2.5.1': {}
-
- '@types/node@26.0.0':
- dependencies:
- undici-types: 8.3.0
-
- '@typescript/native-preview-darwin-arm64@7.0.0-dev.20260619.1':
- optional: true
-
- '@typescript/native-preview-darwin-x64@7.0.0-dev.20260619.1':
- optional: true
-
- '@typescript/native-preview-linux-arm64@7.0.0-dev.20260619.1':
- optional: true
-
- '@typescript/native-preview-linux-arm@7.0.0-dev.20260619.1':
- optional: true
-
- '@typescript/native-preview-linux-x64@7.0.0-dev.20260619.1':
- optional: true
-
- '@typescript/native-preview-win32-arm64@7.0.0-dev.20260619.1':
- optional: true
-
- '@typescript/native-preview-win32-x64@7.0.0-dev.20260619.1':
- optional: true
-
- '@typescript/native-preview@7.0.0-dev.20260619.1':
- optionalDependencies:
- '@typescript/native-preview-darwin-arm64': 7.0.0-dev.20260619.1
- '@typescript/native-preview-darwin-x64': 7.0.0-dev.20260619.1
- '@typescript/native-preview-linux-arm': 7.0.0-dev.20260619.1
- '@typescript/native-preview-linux-arm64': 7.0.0-dev.20260619.1
- '@typescript/native-preview-linux-x64': 7.0.0-dev.20260619.1
- '@typescript/native-preview-win32-arm64': 7.0.0-dev.20260619.1
- '@typescript/native-preview-win32-x64': 7.0.0-dev.20260619.1
-
- '@vitest/coverage-v8@4.1.9(vitest@4.1.9)':
- dependencies:
- '@bcoe/v8-coverage': 1.0.2
- '@vitest/utils': 4.1.9
- ast-v8-to-istanbul: 1.0.4
- istanbul-lib-coverage: 3.2.2
- istanbul-lib-report: 3.0.1
- istanbul-reports: 3.2.0
- magicast: 0.5.3
- obug: 2.1.3
- std-env: 4.1.0
- tinyrainbow: 3.1.0
- vitest: 4.1.9(@types/node@26.0.0)(@vitest/coverage-v8@4.1.9)(vite@8.0.16(@types/node@26.0.0)(jiti@2.7.0)(yaml@2.9.0))
-
- '@vitest/expect@4.1.9':
- dependencies:
- '@standard-schema/spec': 1.1.0
- '@types/chai': 5.2.3
- '@vitest/spy': 4.1.9
- '@vitest/utils': 4.1.9
- chai: 6.2.2
- tinyrainbow: 3.1.0
-
- '@vitest/mocker@4.1.9(vite@8.0.16(@types/node@26.0.0)(jiti@2.7.0)(yaml@2.9.0))':
- dependencies:
- '@vitest/spy': 4.1.9
- estree-walker: 3.0.3
- magic-string: 0.30.21
- optionalDependencies:
- vite: 8.0.16(@types/node@26.0.0)(jiti@2.7.0)(yaml@2.9.0)
-
- '@vitest/pretty-format@4.1.9':
- dependencies:
- tinyrainbow: 3.1.0
-
- '@vitest/runner@4.1.9':
- dependencies:
- '@vitest/utils': 4.1.9
- pathe: 2.0.3
-
- '@vitest/snapshot@4.1.9':
- dependencies:
- '@vitest/pretty-format': 4.1.9
- '@vitest/utils': 4.1.9
- magic-string: 0.30.21
- pathe: 2.0.3
-
- '@vitest/spy@4.1.9': {}
-
- '@vitest/utils@4.1.9':
- dependencies:
- '@vitest/pretty-format': 4.1.9
- convert-source-map: 2.0.0
- tinyrainbow: 3.1.0
-
- args-tokenizer@0.3.0: {}
-
- assertion-error@2.0.1: {}
-
- ast-kit@3.0.0:
- dependencies:
- '@babel/parser': 8.0.0
- estree-walker: 3.0.3
- pathe: 2.0.3
-
- ast-v8-to-istanbul@1.0.4:
- dependencies:
- '@jridgewell/trace-mapping': 0.3.31
- estree-walker: 3.0.3
- js-tokens: 10.0.0
-
- birpc@4.0.0: {}
-
- bumpp@11.1.0:
- dependencies:
- args-tokenizer: 0.3.0
- cac: 7.0.0
- jsonc-parser: 3.3.1
- package-manager-detector: 1.6.0
- semver: 7.8.4
- tinyexec: 1.2.4
- tinyglobby: 0.2.17
- unconfig: 7.5.0
- yaml: 2.9.0
-
- c12@4.0.0-beta.5(jiti@2.7.0)(magicast@0.5.3):
- dependencies:
- confbox: 0.2.4
- defu: 6.1.7
- exsolve: 1.0.8
- pathe: 2.0.3
- pkg-types: 2.3.1
- rc9: 3.0.1
- optionalDependencies:
- jiti: 2.7.0
- magicast: 0.5.3
-
- cac@7.0.0: {}
-
- chai@6.2.2: {}
-
- confbox@0.2.4: {}
-
- consola@3.4.2: {}
-
- convert-source-map@2.0.0: {}
-
- defu@6.1.7: {}
-
- destr@2.0.5: {}
-
- detect-libc@2.1.2: {}
-
- dts-resolver@3.0.0: {}
-
- es-module-lexer@2.1.0: {}
-
- estree-walker@3.0.3:
- dependencies:
- '@types/estree': 1.0.9
-
- expect-type@1.3.0: {}
-
- exsolve@1.0.8: {}
-
- fdir@6.5.0(picomatch@4.0.4):
- optionalDependencies:
- picomatch: 4.0.4
-
- fsevents@2.3.3:
- optional: true
-
- get-tsconfig@5.0.0-beta.5:
- dependencies:
- resolve-pkg-maps: 1.0.0
-
- has-flag@4.0.0: {}
-
- html-escaper@2.0.2: {}
-
- istanbul-lib-coverage@3.2.2: {}
-
- istanbul-lib-report@3.0.1:
- dependencies:
- istanbul-lib-coverage: 3.2.2
- make-dir: 4.0.0
- supports-color: 7.2.0
-
- istanbul-reports@3.2.0:
- dependencies:
- html-escaper: 2.0.2
- istanbul-lib-report: 3.0.1
-
- jiti@2.7.0: {}
-
- js-tokens@10.0.0: {}
-
- jsesc@3.1.0: {}
-
- jsonc-parser@3.3.1: {}
-
- lightningcss-android-arm64@1.32.0:
- optional: true
-
- lightningcss-darwin-arm64@1.32.0:
- optional: true
-
- lightningcss-darwin-x64@1.32.0:
- optional: true
-
- lightningcss-freebsd-x64@1.32.0:
- optional: true
-
- lightningcss-linux-arm-gnueabihf@1.32.0:
- optional: true
-
- lightningcss-linux-arm64-gnu@1.32.0:
- optional: true
-
- lightningcss-linux-arm64-musl@1.32.0:
- optional: true
-
- lightningcss-linux-x64-gnu@1.32.0:
- optional: true
-
- lightningcss-linux-x64-musl@1.32.0:
- optional: true
-
- lightningcss-win32-arm64-msvc@1.32.0:
- optional: true
-
- lightningcss-win32-x64-msvc@1.32.0:
- optional: true
-
- lightningcss@1.32.0:
- dependencies:
- detect-libc: 2.1.2
- optionalDependencies:
- lightningcss-android-arm64: 1.32.0
- lightningcss-darwin-arm64: 1.32.0
- lightningcss-darwin-x64: 1.32.0
- lightningcss-freebsd-x64: 1.32.0
- lightningcss-linux-arm-gnueabihf: 1.32.0
- lightningcss-linux-arm64-gnu: 1.32.0
- lightningcss-linux-arm64-musl: 1.32.0
- lightningcss-linux-x64-gnu: 1.32.0
- lightningcss-linux-x64-musl: 1.32.0
- lightningcss-win32-arm64-msvc: 1.32.0
- lightningcss-win32-x64-msvc: 1.32.0
-
- magic-string@0.30.21:
- dependencies:
- '@jridgewell/sourcemap-codec': 1.5.5
-
- magicast@0.5.3:
- dependencies:
- '@babel/parser': 7.29.7
- '@babel/types': 7.29.7
- source-map-js: 1.2.1
-
- make-dir@4.0.0:
- dependencies:
- semver: 7.8.4
-
- nanoid@3.3.13: {}
-
- obug@2.1.3: {}
-
- obuild@0.4.36(@typescript/native-preview@7.0.0-dev.20260619.1)(jiti@2.7.0)(magicast@0.5.3)(typescript@6.0.3):
- dependencies:
- c12: 4.0.0-beta.5(jiti@2.7.0)(magicast@0.5.3)
- consola: 3.4.2
- defu: 6.1.7
- exsolve: 1.0.8
- magic-string: 0.30.21
- pathe: 2.0.3
- rolldown: 1.1.2
- rolldown-plugin-dts: 0.25.2(@typescript/native-preview@7.0.0-dev.20260619.1)(rolldown@1.1.2)(typescript@6.0.3)
- tinyglobby: 0.2.17
- transitivePeerDependencies:
- - '@ts-macro/tsc'
- - '@typescript/native-preview'
- - chokidar
- - dotenv
- - giget
- - jiti
- - magicast
- - oxc-resolver
- - typescript
- - vue-tsc
-
- oxfmt@0.55.0:
- dependencies:
- tinypool: 2.1.0
- optionalDependencies:
- '@oxfmt/binding-android-arm-eabi': 0.55.0
- '@oxfmt/binding-android-arm64': 0.55.0
- '@oxfmt/binding-darwin-arm64': 0.55.0
- '@oxfmt/binding-darwin-x64': 0.55.0
- '@oxfmt/binding-freebsd-x64': 0.55.0
- '@oxfmt/binding-linux-arm-gnueabihf': 0.55.0
- '@oxfmt/binding-linux-arm-musleabihf': 0.55.0
- '@oxfmt/binding-linux-arm64-gnu': 0.55.0
- '@oxfmt/binding-linux-arm64-musl': 0.55.0
- '@oxfmt/binding-linux-ppc64-gnu': 0.55.0
- '@oxfmt/binding-linux-riscv64-gnu': 0.55.0
- '@oxfmt/binding-linux-riscv64-musl': 0.55.0
- '@oxfmt/binding-linux-s390x-gnu': 0.55.0
- '@oxfmt/binding-linux-x64-gnu': 0.55.0
- '@oxfmt/binding-linux-x64-musl': 0.55.0
- '@oxfmt/binding-openharmony-arm64': 0.55.0
- '@oxfmt/binding-win32-arm64-msvc': 0.55.0
- '@oxfmt/binding-win32-ia32-msvc': 0.55.0
- '@oxfmt/binding-win32-x64-msvc': 0.55.0
-
- oxlint@1.70.0:
- optionalDependencies:
- '@oxlint/binding-android-arm-eabi': 1.70.0
- '@oxlint/binding-android-arm64': 1.70.0
- '@oxlint/binding-darwin-arm64': 1.70.0
- '@oxlint/binding-darwin-x64': 1.70.0
- '@oxlint/binding-freebsd-x64': 1.70.0
- '@oxlint/binding-linux-arm-gnueabihf': 1.70.0
- '@oxlint/binding-linux-arm-musleabihf': 1.70.0
- '@oxlint/binding-linux-arm64-gnu': 1.70.0
- '@oxlint/binding-linux-arm64-musl': 1.70.0
- '@oxlint/binding-linux-ppc64-gnu': 1.70.0
- '@oxlint/binding-linux-riscv64-gnu': 1.70.0
- '@oxlint/binding-linux-riscv64-musl': 1.70.0
- '@oxlint/binding-linux-s390x-gnu': 1.70.0
- '@oxlint/binding-linux-x64-gnu': 1.70.0
- '@oxlint/binding-linux-x64-musl': 1.70.0
- '@oxlint/binding-openharmony-arm64': 1.70.0
- '@oxlint/binding-win32-arm64-msvc': 1.70.0
- '@oxlint/binding-win32-ia32-msvc': 1.70.0
- '@oxlint/binding-win32-x64-msvc': 1.70.0
-
- package-manager-detector@1.6.0: {}
-
- pathe@2.0.3: {}
-
- picocolors@1.1.1: {}
-
- picomatch@4.0.4: {}
-
- pkg-types@2.3.1:
- dependencies:
- confbox: 0.2.4
- exsolve: 1.0.8
- pathe: 2.0.3
-
- postcss@8.5.15:
- dependencies:
- nanoid: 3.3.13
- picocolors: 1.1.1
- source-map-js: 1.2.1
-
- quansync@1.0.0: {}
-
- rc9@3.0.1:
- dependencies:
- defu: 6.1.7
- destr: 2.0.5
-
- resolve-pkg-maps@1.0.0: {}
-
- rolldown-plugin-dts@0.25.2(@typescript/native-preview@7.0.0-dev.20260619.1)(rolldown@1.1.2)(typescript@6.0.3):
- dependencies:
- '@babel/generator': 8.0.0-rc.6
- '@babel/helper-validator-identifier': 8.0.0-rc.6
- '@babel/parser': 8.0.0-rc.6
- ast-kit: 3.0.0
- birpc: 4.0.0
- dts-resolver: 3.0.0
- get-tsconfig: 5.0.0-beta.5
- obug: 2.1.3
- rolldown: 1.1.2
- optionalDependencies:
- '@typescript/native-preview': 7.0.0-dev.20260619.1
- typescript: 6.0.3
- transitivePeerDependencies:
- - oxc-resolver
-
- rolldown@1.0.3:
- dependencies:
- '@oxc-project/types': 0.133.0
- '@rolldown/pluginutils': 1.0.1
- optionalDependencies:
- '@rolldown/binding-android-arm64': 1.0.3
- '@rolldown/binding-darwin-arm64': 1.0.3
- '@rolldown/binding-darwin-x64': 1.0.3
- '@rolldown/binding-freebsd-x64': 1.0.3
- '@rolldown/binding-linux-arm-gnueabihf': 1.0.3
- '@rolldown/binding-linux-arm64-gnu': 1.0.3
- '@rolldown/binding-linux-arm64-musl': 1.0.3
- '@rolldown/binding-linux-ppc64-gnu': 1.0.3
- '@rolldown/binding-linux-s390x-gnu': 1.0.3
- '@rolldown/binding-linux-x64-gnu': 1.0.3
- '@rolldown/binding-linux-x64-musl': 1.0.3
- '@rolldown/binding-openharmony-arm64': 1.0.3
- '@rolldown/binding-wasm32-wasi': 1.0.3
- '@rolldown/binding-win32-arm64-msvc': 1.0.3
- '@rolldown/binding-win32-x64-msvc': 1.0.3
-
- rolldown@1.1.2:
- dependencies:
- '@oxc-project/types': 0.137.0
- '@rolldown/pluginutils': 1.0.1
- optionalDependencies:
- '@rolldown/binding-android-arm64': 1.1.2
- '@rolldown/binding-darwin-arm64': 1.1.2
- '@rolldown/binding-darwin-x64': 1.1.2
- '@rolldown/binding-freebsd-x64': 1.1.2
- '@rolldown/binding-linux-arm-gnueabihf': 1.1.2
- '@rolldown/binding-linux-arm64-gnu': 1.1.2
- '@rolldown/binding-linux-arm64-musl': 1.1.2
- '@rolldown/binding-linux-ppc64-gnu': 1.1.2
- '@rolldown/binding-linux-s390x-gnu': 1.1.2
- '@rolldown/binding-linux-x64-gnu': 1.1.2
- '@rolldown/binding-linux-x64-musl': 1.1.2
- '@rolldown/binding-openharmony-arm64': 1.1.2
- '@rolldown/binding-wasm32-wasi': 1.1.2
- '@rolldown/binding-win32-arm64-msvc': 1.1.2
- '@rolldown/binding-win32-x64-msvc': 1.1.2
-
- semver@7.8.4: {}
-
- siginfo@2.0.0: {}
-
- source-map-js@1.2.1: {}
-
- stackback@0.0.2: {}
-
- std-env@4.1.0: {}
-
- supports-color@7.2.0:
- dependencies:
- has-flag: 4.0.0
-
- tinybench@2.9.0: {}
-
- tinyexec@1.2.4: {}
-
- tinyglobby@0.2.17:
- dependencies:
- fdir: 6.5.0(picomatch@4.0.4)
- picomatch: 4.0.4
-
- tinypool@2.1.0: {}
-
- tinyrainbow@3.1.0: {}
-
- tslib@2.8.1:
- optional: true
-
- typescript@6.0.3: {}
-
- unconfig-core@7.5.0:
- dependencies:
- '@quansync/fs': 1.0.0
- quansync: 1.0.0
-
- unconfig@7.5.0:
- dependencies:
- '@quansync/fs': 1.0.0
- defu: 6.1.7
- jiti: 2.7.0
- quansync: 1.0.0
- unconfig-core: 7.5.0
-
- undici-types@8.3.0: {}
-
- vite@8.0.16(@types/node@26.0.0)(jiti@2.7.0)(yaml@2.9.0):
- dependencies:
- lightningcss: 1.32.0
- picomatch: 4.0.4
- postcss: 8.5.15
- rolldown: 1.0.3
- tinyglobby: 0.2.17
- optionalDependencies:
- '@types/node': 26.0.0
- fsevents: 2.3.3
- jiti: 2.7.0
- yaml: 2.9.0
-
- vitest@4.1.9(@types/node@26.0.0)(@vitest/coverage-v8@4.1.9)(vite@8.0.16(@types/node@26.0.0)(jiti@2.7.0)(yaml@2.9.0)):
- dependencies:
- '@vitest/expect': 4.1.9
- '@vitest/mocker': 4.1.9(vite@8.0.16(@types/node@26.0.0)(jiti@2.7.0)(yaml@2.9.0))
- '@vitest/pretty-format': 4.1.9
- '@vitest/runner': 4.1.9
- '@vitest/snapshot': 4.1.9
- '@vitest/spy': 4.1.9
- '@vitest/utils': 4.1.9
- es-module-lexer: 2.1.0
- expect-type: 1.3.0
- magic-string: 0.30.21
- obug: 2.1.3
- pathe: 2.0.3
- picomatch: 4.0.4
- std-env: 4.1.0
- tinybench: 2.9.0
- tinyexec: 1.2.4
- tinyglobby: 0.2.17
- tinyrainbow: 3.1.0
- vite: 8.0.16(@types/node@26.0.0)(jiti@2.7.0)(yaml@2.9.0)
- why-is-node-running: 2.3.0
- optionalDependencies:
- '@types/node': 26.0.0
- '@vitest/coverage-v8': 4.1.9(vitest@4.1.9)
- transitivePeerDependencies:
- - msw
-
- why-is-node-running@2.3.0:
- dependencies:
- siginfo: 2.0.0
- stackback: 0.0.2
-
- yaml@2.9.0: {}
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
deleted file mode 100644
index a7580cb..0000000
--- a/pnpm-workspace.yaml
+++ /dev/null
@@ -1,10 +0,0 @@
-minimumReleaseAgeExclude:
- - "@types/node@26.0.0"
- - "@typescript/native-preview-darwin-arm64@7.0.0-dev.20260619.1"
- - "@typescript/native-preview-darwin-x64@7.0.0-dev.20260619.1"
- - "@typescript/native-preview-linux-arm64@7.0.0-dev.20260619.1"
- - "@typescript/native-preview-linux-arm@7.0.0-dev.20260619.1"
- - "@typescript/native-preview-linux-x64@7.0.0-dev.20260619.1"
- - "@typescript/native-preview-win32-arm64@7.0.0-dev.20260619.1"
- - "@typescript/native-preview-win32-x64@7.0.0-dev.20260619.1"
- - "@typescript/native-preview@7.0.0-dev.20260619.1"
diff --git a/scripts/bundle-budget.mjs b/scripts/bundle-budget.mjs
index bf319cd..f0c5310 100644
--- a/scripts/bundle-budget.mjs
+++ b/scripts/bundle-budget.mjs
@@ -8,8 +8,11 @@ import { resolve } from "node:path"
const DIST = resolve(process.cwd(), "dist")
const BUDGETS = [
- { glob: /^index\.mjs$/, max: 8192, label: "core" },
- { glob: /^driver\/.+\.mjs$/, max: 16384, label: "driver" },
+ { glob: /^index\.mjs$/, max: 4096, label: "core entry" },
+ { glob: /^core\/.+\.mjs$/, max: 8192, label: "core" },
+ { glob: /^drivers\/[^_].*\.mjs$/, max: 12288, label: "driver" },
+ { glob: /^middleware\/.+\.mjs$/, max: 8192, label: "middleware" },
+ { glob: /^render\/.+\.mjs$/, max: 8192, label: "render" },
]
async function* walk(dir, prefix = "") {
diff --git a/scripts/check-version.mjs b/scripts/check-version.mjs
new file mode 100644
index 0000000..7968ac6
--- /dev/null
+++ b/scripts/check-version.mjs
@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+// The version lives in three places that must agree: npm's manifest, JSR's,
+// and the `version` constant the library reports at runtime. Drift here is
+// silent and only shows up in a user's bug report, so CI checks it.
+
+import { readFile } from "node:fs/promises"
+
+const read = async (path) => JSON.parse(await readFile(new URL(path, import.meta.url), "utf8"))
+
+const pkg = await read("../package.json")
+const jsr = await read("../jsr.json")
+const source = await readFile(new URL("../src/index.ts", import.meta.url), "utf8")
+
+const declared = /export const version = "([^"]+)"/.exec(source)?.[1]
+
+const found = {
+ "package.json": pkg.version,
+ "jsr.json": jsr.version,
+ "src/index.ts": declared,
+}
+
+const distinct = new Set(Object.values(found))
+if (distinct.size === 1 && !distinct.has(undefined)) {
+ console.log(
+ `✅ version ${pkg.version} is consistent across package.json, jsr.json and src/index.ts`,
+ )
+ process.exit(0)
+}
+
+console.error("❌ version mismatch:")
+for (const [file, version] of Object.entries(found)) {
+ console.error(` ${file.padEnd(16)} ${version ?? "(not found)"}`)
+}
+process.exit(1)
diff --git a/scripts/setup-mailcrab.mjs b/scripts/setup-mailcrab.mjs
deleted file mode 100755
index a6f46ac..0000000
--- a/scripts/setup-mailcrab.mjs
+++ /dev/null
@@ -1,360 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * This script helps set up and start MailCrab for local development
- * It checks if Docker is available and then starts MailCrab
- */
-
-import { exec, spawn } from "node:child_process"
-import * as readline from "node:readline"
-
-const MAILCRAB_PORT_SMTP = 1025
-const MAILCRAB_PORT_UI = 1080
-const DOCKER_IMAGE = "marlonb/mailcrab"
-
-// Colors for console output
-const colors = {
- reset: "\x1B[0m",
- bright: "\x1B[1m",
- red: "\x1B[31m",
- green: "\x1B[32m",
- yellow: "\x1B[33m",
- blue: "\x1B[34m",
- cyan: "\x1B[36m",
-}
-
-// Print banner
-console.log(`${colors.bright}${colors.blue}
- _ _ _ _
-| | | | (_) |
-| | | |_ __ ___ _ __ ___ __ _| |
-| | | | '_ \\ / _ \\ '_ \` _ \\/ _\` | |
-| |_| | | | | __/ | | | | | (_| | |
- \\___/|_| |_|\\___|_| |_| |_|\\__,_|_|
-
-${colors.cyan}MailCrab Setup Tool${colors.reset}
-`)
-
-// Check if Docker is installed
-function checkDocker() {
- return new Promise((resolve, reject) => {
- console.log(`${colors.yellow}Checking if Docker is installed...${colors.reset}`)
-
- exec("docker --version", (error, stdout) => {
- if (error) {
- console.log(`${colors.red}❌ Docker is not installed or not in PATH${colors.reset}`)
- console.log(
- `${colors.yellow}Please install Docker from https://www.docker.com/get-started${colors.reset}`,
- )
- reject(new Error("Docker not found"))
- return
- }
-
- console.log(`${colors.green}✅ Docker is installed: ${stdout.trim()}${colors.reset}`)
- resolve()
- })
- })
-}
-
-// Check if ports are available
-function checkPorts() {
- return new Promise((resolve, reject) => {
- console.log(
- `${colors.yellow}Checking if ports ${MAILCRAB_PORT_SMTP} and ${MAILCRAB_PORT_UI} are available...${colors.reset}`,
- )
-
- const netstat = process.platform === "win32" ? "netstat -ano | findstr" : "lsof -i"
-
- exec(`${netstat} :${MAILCRAB_PORT_SMTP}`, (error, stdout) => {
- const smtpInUse = !error && stdout.trim() !== ""
-
- exec(`${netstat} :${MAILCRAB_PORT_UI}`, (error, stdout) => {
- const uiInUse = !error && stdout.trim() !== ""
-
- if (smtpInUse || uiInUse) {
- const portsInUse = []
- if (smtpInUse) portsInUse.push(MAILCRAB_PORT_SMTP)
- if (uiInUse) portsInUse.push(MAILCRAB_PORT_UI)
-
- console.log(
- `${colors.red}❌ Port(s) ${portsInUse.join(", ")} already in use${colors.reset}`,
- )
-
- const confirmChoice = readline.createInterface({
- input: process.stdin,
- output: process.stdout,
- })
-
- confirmChoice.question(
- `${colors.yellow}Do you want to continue anyway? (y/N): ${colors.reset}`,
- (answer) => {
- confirmChoice.close()
-
- if (answer.toLowerCase() === "y") {
- console.log(`${colors.yellow}Continuing despite port conflicts...${colors.reset}`)
- resolve()
- } else {
- reject(new Error("Ports in use"))
- }
- },
- )
- } else {
- console.log(`${colors.green}✅ Ports are available${colors.reset}`)
- resolve()
- }
- })
- })
- })
-}
-
-// Check if MailCrab image is pulled
-function checkMailCrabImage() {
- return new Promise((resolve, reject) => {
- console.log(`${colors.yellow}Checking if MailCrab image is available...${colors.reset}`)
-
- exec(`docker images ${DOCKER_IMAGE} --format "{{.Repository}}"`, (error, stdout) => {
- if (error || stdout.trim() === "") {
- console.log(`${colors.yellow}MailCrab image not found, pulling now...${colors.reset}`)
-
- const pull = spawn("docker", ["pull", DOCKER_IMAGE], { stdio: "inherit" })
-
- pull.on("close", (code) => {
- if (code === 0) {
- console.log(`${colors.green}✅ MailCrab image pulled successfully${colors.reset}`)
- resolve()
- } else {
- console.log(`${colors.red}❌ Failed to pull MailCrab image${colors.reset}`)
- reject(new Error("Failed to pull image"))
- }
- })
- } else {
- console.log(`${colors.green}✅ MailCrab image found${colors.reset}`)
- resolve()
- }
- })
- })
-}
-
-// Check if MailCrab is already running or exists
-function checkExistingContainers() {
- return new Promise((resolve, reject) => {
- console.log(`${colors.yellow}Checking if MailCrab container exists...${colors.reset}`)
-
- // First check for running containers with the MailCrab image
- exec(`docker ps --filter ancestor=${DOCKER_IMAGE} --format "{{.ID}}"`, (error, stdout) => {
- if (error) {
- reject(new Error("Failed to check running containers"))
- return
- }
-
- const runningContainerId = stdout.trim()
-
- if (runningContainerId) {
- console.log(
- `${colors.yellow}MailCrab is already running with container ID: ${runningContainerId}${colors.reset}`,
- )
-
- const confirmChoice = readline.createInterface({
- input: process.stdin,
- output: process.stdout,
- })
-
- confirmChoice.question(
- `${colors.yellow}Do you want to stop it and start a new instance? (y/N): ${colors.reset}`,
- (answer) => {
- confirmChoice.close()
-
- if (answer.toLowerCase() === "y") {
- exec(`docker stop ${runningContainerId}`, (error) => {
- if (error) {
- console.log(
- `${colors.red}❌ Failed to stop MailCrab container: ${error.message}${colors.reset}`,
- )
- reject(error)
- return
- }
-
- console.log(`${colors.green}✅ Stopped existing MailCrab container${colors.reset}`)
- resolve({ action: "create-new" })
- })
- } else {
- console.log(`${colors.green}✅ Using existing MailCrab container${colors.reset}`)
- resolve({ action: "use-existing" })
- }
- },
- )
- } else {
- // No running container, check for stopped container with the name
- exec('docker ps -a --filter name=unemail-mailcrab --format "{{.ID}}"', (error, stdout) => {
- if (error) {
- reject(new Error("Failed to check for stopped containers"))
- return
- }
-
- const stoppedContainerId = stdout.trim()
-
- if (stoppedContainerId) {
- console.log(
- `${colors.yellow}Found stopped MailCrab container with ID: ${stoppedContainerId}${colors.reset}`,
- )
-
- const confirmChoice = readline.createInterface({
- input: process.stdin,
- output: process.stdout,
- })
-
- confirmChoice.question(
- `${colors.yellow}Do you want to (s)tart the existing container, (r)emove it and create a new one, or (c)ancel? (s/r/c): ${colors.reset}`,
- (answer) => {
- confirmChoice.close()
-
- if (answer.toLowerCase() === "s") {
- console.log(
- `${colors.yellow}Starting existing MailCrab container...${colors.reset}`,
- )
-
- exec(`docker start ${stoppedContainerId}`, (error) => {
- if (error) {
- console.log(
- `${colors.red}❌ Failed to start existing MailCrab container: ${error.message}${colors.reset}`,
- )
- reject(error)
- return
- }
-
- console.log(
- `${colors.green}✅ Started existing MailCrab container${colors.reset}`,
- )
- resolve({ action: "use-existing" })
- })
- } else if (answer.toLowerCase() === "r") {
- console.log(
- `${colors.yellow}Removing existing MailCrab container...${colors.reset}`,
- )
-
- exec(`docker rm ${stoppedContainerId}`, (error) => {
- if (error) {
- console.log(
- `${colors.red}❌ Failed to remove existing MailCrab container: ${error.message}${colors.reset}`,
- )
- reject(error)
- return
- }
-
- console.log(
- `${colors.green}✅ Removed existing MailCrab container${colors.reset}`,
- )
- resolve({ action: "create-new" })
- })
- } else {
- console.log(`${colors.yellow}Operation cancelled${colors.reset}`)
- reject(new Error("Operation cancelled"))
- }
- },
- )
- } else {
- console.log(`${colors.green}✅ No MailCrab containers found${colors.reset}`)
- resolve({ action: "create-new" })
- }
- })
- }
- })
- })
-}
-
-// Start MailCrab container
-function startMailCrab() {
- return new Promise((resolve, reject) => {
- console.log(`${colors.yellow}Starting MailCrab container...${colors.reset}`)
-
- const docker = spawn("docker", [
- "run",
- "-d", // Run in detached mode
- "--name",
- "unemail-mailcrab",
- "-p",
- `${MAILCRAB_PORT_SMTP}:1025`,
- "-p",
- `${MAILCRAB_PORT_UI}:1080`,
- DOCKER_IMAGE,
- ])
-
- let output = ""
-
- docker.stdout.on("data", (data) => {
- output += data.toString()
- })
-
- docker.on("data", (data) => {
- console.log(`${colors.red}${data.toString()}${colors.reset}`)
- })
-
- docker.on("close", (code) => {
- if (code === 0) {
- console.log(`${colors.green}✅ MailCrab started successfully${colors.reset}`)
- console.log(`${colors.green}✅ Container ID: ${output.trim()}${colors.reset}`)
- resolve()
- } else {
- console.log(`${colors.red}❌ Failed to start MailCrab container${colors.reset}`)
- reject(new Error("Failed to start container"))
- }
- })
- })
-}
-
-// Show usage instructions
-function showInstructions() {
- console.log(`
-${colors.bright}${colors.green}MailCrab is ready for use!${colors.reset}
-
-${colors.bright}SMTP Server:${colors.reset} localhost:${MAILCRAB_PORT_SMTP}
-${colors.bright}Web Interface:${colors.reset} http://localhost:${MAILCRAB_PORT_UI}
-
-${colors.bright}${colors.blue}Usage with unemail:${colors.reset}
-
-${colors.cyan}import { createEmailService } from 'unemail';
-import smtpProvider from 'unemail/providers/smtp';
-
-const emailService = createEmailService({
- provider: smtpProvider({
- host: 'localhost',
- port: ${MAILCRAB_PORT_SMTP}
- })
-});
-
-// Send a test email
-emailService.sendEmail({
- from: { email: 'sender@example.com', name: 'Sender' },
- to: { email: 'recipient@example.com', name: 'Recipient' },
- subject: 'Test Email',
- text: 'This is a test email sent via unemail using MailCrab'
-});${colors.reset}
-
-${colors.yellow}View sent emails at:${colors.reset} http://localhost:${MAILCRAB_PORT_UI}
-
-${colors.yellow}To stop MailCrab:${colors.reset} docker stop unemail-mailcrab
-${colors.yellow}To restart MailCrab:${colors.reset} docker start unemail-mailcrab
-`)
-}
-
-// Main function
-async function main() {
- try {
- await checkDocker()
- await checkPorts()
- await checkMailCrabImage()
-
- const { action } = await checkExistingContainers()
- if (action === "create-new") {
- await startMailCrab()
- }
-
- showInstructions()
- } catch (error) {
- console.log(`${colors.red}❌ Setup failed: ${error.message}${colors.reset}`)
- process.exit(1)
- }
-}
-
-// Run the script
-main()
diff --git a/src/_define.ts b/src/_define.ts
deleted file mode 100644
index 9da9185..0000000
--- a/src/_define.ts
+++ /dev/null
@@ -1,17 +0,0 @@
-import type { DriverFactory, EmailDriver } from "./types.ts"
-
-/** Identity helper used to declare a driver factory with full type
- * inference. Exists purely for TypeScript — there is no runtime effect.
- *
- * ```ts
- * export default defineDriver((opts) => ({
- * name: "my-driver",
- * send(msg, ctx) { ... }
- * }))
- * ```
- */
-export function defineDriver(
- factory: (options?: TOpts) => EmailDriver,
-): DriverFactory {
- return factory
-}
diff --git a/src/_idempotency.ts b/src/_idempotency.ts
deleted file mode 100644
index 96992ee..0000000
--- a/src/_idempotency.ts
+++ /dev/null
@@ -1,25 +0,0 @@
-import type { EmailResult, IdempotencyStore } from "./types.ts"
-
-/** Default in-memory idempotency store with TTL eviction.
- *
- * Fine for single-instance servers and tests. For multi-process or
- * serverless deployments, plug in an `unstorage`-backed store or a
- * custom `IdempotencyStore` implementation. */
-export function memoryIdempotencyStore(defaultTtlSeconds = 3600): IdempotencyStore {
- const store = new Map()
- return {
- get(key) {
- const entry = store.get(key)
- if (!entry) return null
- if (entry.expiresAt <= Date.now()) {
- store.delete(key)
- return null
- }
- return entry.value
- },
- set(key, value, ttlSeconds) {
- const ttl = (ttlSeconds ?? defaultTtlSeconds) * 1000
- store.set(key, { value, expiresAt: Date.now() + ttl })
- },
- }
-}
diff --git a/src/_normalize.ts b/src/_normalize.ts
deleted file mode 100644
index 8d13498..0000000
--- a/src/_normalize.ts
+++ /dev/null
@@ -1,49 +0,0 @@
-import type { EmailAddress, EmailAddressInput } from "./types.ts"
-
-/**
- * Normalize any accepted address input to an array of `EmailAddress` —
- * drivers should not re-implement this parsing.
- *
- * Accepts:
- * - `"ada@acme.com"`
- * - `"Ada Lovelace "`
- * - `{ email, name? }`
- * - arrays of the above (mixed)
- */
-export function normalizeAddresses(input: EmailAddressInput | undefined): EmailAddress[] {
- if (input == null) return []
- const list = Array.isArray(input) ? input : [input]
- const out: EmailAddress[] = []
- for (const item of list) {
- if (typeof item === "string") {
- out.push(parseAddress(item))
- } else if (item && typeof item === "object" && "email" in item) {
- out.push({ email: String(item.email), name: item.name })
- }
- }
- return out
-}
-
-/** Parse `"Name "` or a bare `"email@x"` into an `EmailAddress`. */
-export function parseAddress(value: string): EmailAddress {
- const match = /^\s*(.*?)\s*<([^>]+)>\s*$/.exec(value)
- if (match) {
- const name = match[1]?.replace(/^"|"$/g, "").trim() || undefined
- return { email: match[2]!.trim(), name }
- }
- return { email: value.trim() }
-}
-
-/** Format an `EmailAddress` back into its canonical header form. */
-export function formatAddress(addr: EmailAddress): string {
- if (!addr.name) return addr.email
- const needsQuote = /["(),:;<>@[\\\]]/.test(addr.name)
- const name = needsQuote ? `"${addr.name.replace(/"/g, '\\"')}"` : addr.name
- return `${name} <${addr.email}>`
-}
-
-/** Basic RFC-5322-ish address syntax validator. Strict enough to catch
- * typos but not so strict that it rejects RFC-valid edge cases. */
-export function isValidEmail(value: string): boolean {
- return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)
-}
diff --git a/src/address.ts b/src/address.ts
deleted file mode 100644
index b12af84..0000000
--- a/src/address.ts
+++ /dev/null
@@ -1,131 +0,0 @@
-/**
- * Strictly-validated RFC 5322 / RFC 6532 (SMTPUTF8) address primitive.
- * Use at system boundaries (user input, API payloads) to reject
- * malformed addresses before they reach a driver.
- *
- * @module
- */
-
-import type { EmailAddress, EmailAddressInput, Result } from "./types.ts"
-import { createError } from "./errors.ts"
-
-/** Opaque tag — callers can rely on `Address.parse` returning a
- * validated instance instead of re-validating. */
-const VALIDATED: unique symbol = Symbol("unemail.Address")
-
-export interface Address extends EmailAddress {
- readonly [VALIDATED]: true
- readonly local: string
- readonly domain: string
- toString: () => string
-}
-
-/** Validate + parse an input string or `EmailAddress`. Returns a
- * `Result` so callers can pattern-match instead of
- * try/catch. SMTPUTF8 allowed when `smtpUtf8` is true (default). */
-export function parseAddress(
- input: string | EmailAddress,
- options: { smtpUtf8?: boolean } = {},
-): Result {
- const smtpUtf8 = options.smtpUtf8 ?? true
- let email: string
- let name: string | undefined
- if (typeof input === "string") {
- const parsed = splitNameAddr(input)
- email = parsed.email
- name = parsed.name
- } else {
- email = input.email
- name = input.name
- }
- email = email.trim()
- if (!email) return err("empty address")
- const at = email.lastIndexOf("@")
- if (at <= 0 || at === email.length - 1) return err(`no local/domain: "${email}"`)
- const local = email.slice(0, at)
- const domain = email.slice(at + 1)
- if (!isValidLocal(local, smtpUtf8)) return err(`invalid local-part: "${local}"`)
- if (!isValidDomain(domain)) return err(`invalid domain: "${domain}"`)
- const addr: Address = {
- email,
- name,
- local,
- domain,
- [VALIDATED]: true,
- toString: () => (name ? `"${escapeName(name)}" <${email}>` : email),
- }
- return { data: addr, error: null }
-}
-
-/** Convenience: throw on failure. Use only when you're certain the
- * input is validated elsewhere. */
-export function mustParseAddress(
- input: string | EmailAddress,
- options: { smtpUtf8?: boolean } = {},
-): Address {
- const result = parseAddress(input, options)
- if (result.error) throw result.error
- return result.data
-}
-
-/** Parse any of the shapes accepted by `EmailAddressInput` into an
- * array of validated `Address`es, short-circuiting on the first
- * failure. */
-export function parseAddresses(
- input: EmailAddressInput,
- options: { smtpUtf8?: boolean } = {},
-): Result {
- const list = Array.isArray(input) ? input : [input]
- const out: Address[] = []
- for (const item of list) {
- const r = parseAddress(item as string | EmailAddress, options)
- if (r.error) return r as Result
- out.push(r.data)
- }
- return { data: out, error: null }
-}
-
-function splitNameAddr(value: string): { email: string; name?: string } {
- const match = /^\s*(?:"((?:[^"\\]|\\.)*)"|([^<]*?))\s*<([^>]+)>\s*$/.exec(value)
- if (match) {
- const name = (match[1] ?? match[2] ?? "").trim()
- return { email: match[3]!.trim(), name: name || undefined }
- }
- return { email: value.trim() }
-}
-
-function isValidLocal(local: string, smtpUtf8: boolean): boolean {
- if (local.length === 0 || local.length > 64) return false
- // Allow quoted-string form
- if (local.startsWith('"') && local.endsWith('"')) return local.length >= 2
- const atom = smtpUtf8
- ? /^[A-Za-z0-9!#$%&'*+\-/=?^_`{|}~.\u0080-\u{10FFFF}]+$/u
- : /^[A-Za-z0-9!#$%&'*+\-/=?^_`{|}~.]+$/
- if (!atom.test(local)) return false
- if (local.startsWith(".") || local.endsWith(".") || local.includes("..")) return false
- return true
-}
-
-function isValidDomain(domain: string): boolean {
- if (domain.length === 0 || domain.length > 253) return false
- if (domain.startsWith("[") && domain.endsWith("]")) return domain.length > 2
- if (domain.includes("..") || domain.startsWith(".") || domain.endsWith(".")) return false
- for (const label of domain.split(".")) {
- if (label.length === 0 || label.length > 63) return false
- if (
- !/^[A-Za-z0-9\u0080-\u{10FFFF}]([A-Za-z0-9\-\u0080-\u{10FFFF}]*[A-Za-z0-9\u0080-\u{10FFFF}])?$/u.test(
- label,
- )
- )
- return false
- }
- return true
-}
-
-function escapeName(name: string): string {
- return name.replace(/\\/g, "\\\\").replace(/"/g, '\\"')
-}
-
-function err(message: string): Result {
- return { data: null, error: createError("unemail", "INVALID_OPTIONS", message) }
-}
diff --git a/src/compliance/index.ts b/src/compliance/index.ts
deleted file mode 100644
index fb1053b..0000000
--- a/src/compliance/index.ts
+++ /dev/null
@@ -1,130 +0,0 @@
-/**
- * Deliverability and compliance helpers. Currently ships primitives for
- * RFC 2369 / RFC 8058 List-Unsubscribe: signing one-click tokens and a
- * framework-agnostic HTTP handler that verifies + dispatches to a
- * suppression store.
- *
- * @module
- */
-
-import type { SuppressionStore } from "../suppression/index.ts"
-
-const encoder = /* @__PURE__ */ new TextEncoder()
-
-/** Base64url encode a byte array without padding. */
-function b64url(bytes: Uint8Array): string {
- let s = ""
- for (const b of bytes) s += String.fromCharCode(b)
- return btoa(s).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "")
-}
-
-function b64urlDecode(s: string): Uint8Array {
- const pad = s.length % 4 === 2 ? "==" : s.length % 4 === 3 ? "=" : ""
- const std = s.replace(/-/g, "+").replace(/_/g, "/") + pad
- const bin = atob(std)
- const buf = new ArrayBuffer(bin.length)
- const out = new Uint8Array(buf)
- for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i)
- return out
-}
-
-async function hmacKey(secret: string): Promise {
- return crypto.subtle.importKey(
- "raw",
- encoder.encode(secret),
- { name: "HMAC", hash: "SHA-256" },
- false,
- ["sign", "verify"],
- )
-}
-
-/** Opaque, tamper-proof token encoding the unsubscribe subject. */
-export interface UnsubscribeTokenPayload {
- recipient: string
- campaign?: string
- /** Expiry as epoch seconds. Omit for non-expiring tokens. */
- exp?: number
-}
-
-/** Sign a one-click unsubscribe token with HMAC-SHA256. */
-export async function signUnsubscribeToken(
- payload: UnsubscribeTokenPayload,
- secret: string,
-): Promise {
- const body = b64url(encoder.encode(JSON.stringify(payload)))
- const key = await hmacKey(secret)
- const sig = new Uint8Array(await crypto.subtle.sign("HMAC", key, encoder.encode(body)))
- return `${body}.${b64url(sig)}`
-}
-
-/** Verify a token. Returns the payload on success, `null` on tamper /
- * expiry. Constant-time via Web Crypto `verify`. */
-export async function verifyUnsubscribeToken(
- token: string,
- secret: string,
- now: () => number = Date.now,
-): Promise {
- const dot = token.indexOf(".")
- if (dot < 0) return null
- const body = token.slice(0, dot)
- const sig = token.slice(dot + 1)
- const key = await hmacKey(secret)
- const sigBytes = b64urlDecode(sig)
- const bodyBytes = encoder.encode(body)
- let ok: boolean
- try {
- ok = await crypto.subtle.verify(
- "HMAC",
- key,
- sigBytes as BufferSource,
- bodyBytes as BufferSource,
- )
- } catch {
- return null
- }
- if (!ok) return null
- let payload: UnsubscribeTokenPayload
- try {
- payload = JSON.parse(new TextDecoder().decode(b64urlDecode(body))) as UnsubscribeTokenPayload
- } catch {
- return null
- }
- if (payload.exp !== undefined && now() / 1000 > payload.exp) return null
- return payload
-}
-
-/** Options for `defineUnsubscribeHandler`. */
-export interface UnsubscribeHandlerOptions {
- secret: string
- /** Query-string key that carries the token. Default: `t`. */
- tokenParam?: string
- /** Suppression store receiving the opt-out. */
- store?: SuppressionStore
- /** Optional hook fired after a successful unsubscribe. */
- onUnsubscribe?: (payload: UnsubscribeTokenPayload) => void | Promise
- /** Custom clock for testing. */
- now?: () => number
-}
-
-/** Framework-agnostic handler — give it a `Request`, it returns a
- * `Response`. RFC 8058 requires 200 OK on POST with no user
- * confirmation; we honor that. GET also works for mail-client URL
- * rendering. */
-export function defineUnsubscribeHandler(
- opts: UnsubscribeHandlerOptions,
-): (request: Request) => Promise {
- const param = opts.tokenParam ?? "t"
- return async (request: Request) => {
- const url = new URL(request.url)
- const token = url.searchParams.get(param)
- if (!token) return new Response("missing token", { status: 400 })
- const payload = await verifyUnsubscribeToken(token, opts.secret, opts.now)
- if (!payload) return new Response("invalid token", { status: 400 })
- await opts.store?.add(payload.recipient, "unsubscribed", payload.campaign)
- await opts.onUnsubscribe?.(payload)
- return new Response("unsubscribed", {
- status: 200,
- headers: { "content-type": "text/plain; charset=utf-8" },
- })
- }
-}
diff --git a/src/core/address.ts b/src/core/address.ts
new file mode 100644
index 0000000..ae189c1
--- /dev/null
+++ b/src/core/address.ts
@@ -0,0 +1,62 @@
+import type { AddressInput, EmailAddress } from "./types.ts"
+
+/** Parse `"Ada Lovelace "` or a bare `"ada@acme.com"`. */
+export function parseAddress(value: string): EmailAddress {
+ const match = /^\s*(.*?)\s*<([^>]+)>\s*$/.exec(value)
+ if (!match) return { email: value.trim() }
+ const name = match[1]?.replace(/^"|"$/g, "").trim()
+ return name ? { email: match[2]!.trim(), name } : { email: match[2]!.trim() }
+}
+
+/** Render an address back into its canonical header form, quoting the
+ * display name when it contains a character RFC 5322 treats as a
+ * delimiter. */
+export function formatAddress(address: EmailAddress): string {
+ if (!address.name) return address.email
+ const needsQuote = /["(),:;<>@[\\\]]/.test(address.name)
+ const name = needsQuote ? `"${address.name.replace(/"/g, '\\"')}"` : address.name
+ return `${name} <${address.email}>`
+}
+
+/** Join a list into one header value. */
+export function formatAddressList(addresses: readonly EmailAddress[]): string {
+ return addresses.map(formatAddress).join(", ")
+}
+
+/** Flatten any accepted address input into a list. Unrecognized entries
+ * are dropped rather than throwing — validation happens once, in
+ * `normalizeMessage()`, where it can name the offending field. */
+export function toAddressList(input: AddressInput | undefined): EmailAddress[] {
+ if (input == null) return []
+ const items = Array.isArray(input) ? input : [input as string | EmailAddress]
+ const out: EmailAddress[] = []
+ for (const item of items) {
+ if (typeof item === "string") {
+ if (item.trim()) out.push(parseAddress(item))
+ } else if (item && typeof item === "object" && typeof item.email === "string") {
+ out.push(
+ item.name ? { email: item.email.trim(), name: item.name } : { email: item.email.trim() },
+ )
+ }
+ }
+ return out
+}
+
+/** Deduplicate by address, keeping the first occurrence's display name. */
+export function dedupeAddresses(addresses: readonly EmailAddress[]): EmailAddress[] {
+ const seen = new Set()
+ const out: EmailAddress[] = []
+ for (const address of addresses) {
+ const key = address.email.toLowerCase()
+ if (seen.has(key)) continue
+ seen.add(key)
+ out.push(address)
+ }
+ return out
+}
+
+/** Loose syntax check — strict enough to catch a typo, lenient enough not
+ * to reject addresses that are legal but unusual. */
+export function isValidEmail(value: string): boolean {
+ return /^[^\s@,;]+@[^\s@,;]+\.[^\s@,;]+$/.test(value)
+}
diff --git a/src/core/define.ts b/src/core/define.ts
new file mode 100644
index 0000000..c01767d
--- /dev/null
+++ b/src/core/define.ts
@@ -0,0 +1,170 @@
+import type {
+ DriverFactory,
+ EmailDriver,
+ EmailResult,
+ Middleware,
+ NormalizedMessage,
+ Result,
+ SendContext,
+ SendHandler,
+} from "./types.ts"
+import { err, ok } from "./result.ts"
+import { toEmailError } from "./error.ts"
+
+/**
+ * Declare a driver. Purely a typing helper — it makes `TOpts` required
+ * when it has required fields, so a missing API key is a compile error
+ * rather than a throw on the first send.
+ *
+ * ```ts
+ * export default defineDriver<{ apiKey: string }>((options) => ({
+ * name: "acme",
+ * features: { html: true },
+ * send: (msg) => post(options.apiKey, msg),
+ * }))
+ * ```
+ */
+export function defineDriver(
+ factory: DriverFactory,
+): DriverFactory {
+ return factory
+}
+
+/**
+ * Declare a middleware. One shape covers retry, logging, rate limiting and
+ * everything else: wrap the next handler and return the results.
+ *
+ * The unit of work is a list, so a middleware sees the whole batch and can
+ * act on part of it — retry re-sends only the failed indices, even when
+ * the driver reached the provider in a single request.
+ *
+ * ```ts
+ * const timing = defineMiddleware("timing", (next) => async (msgs, ctx) => {
+ * const start = Date.now()
+ * const results = await next(msgs, ctx)
+ * ctx.meta.durationMs = Date.now() - start
+ * return results
+ * })
+ * ```
+ */
+export function defineMiddleware(
+ name: string,
+ handle: (next: SendHandler) => SendHandler,
+): Middleware {
+ return { name, handle }
+}
+
+/** Lift a per-message function into a middleware, for the common case
+ * where the batch is irrelevant. Messages are processed concurrently. */
+export function perMessage(
+ name: string,
+ handle: (
+ next: (msg: NormalizedMessage, ctx: SendContext) => Promise>,
+ ) => (msg: NormalizedMessage, ctx: SendContext) => Promise>,
+): Middleware {
+ return defineMiddleware(name, (next) => {
+ const one = handle(async (msg, ctx) => (await next([msg], ctx))[0]!)
+ return async (msgs, ctx) => Promise.all(msgs.map((msg) => one(msg, ctx)))
+ })
+}
+
+/**
+ * Compose middleware around a handler. The first registered middleware is
+ * the outermost, so `use(logger); use(retry)` logs once around all the
+ * retries rather than once per attempt.
+ */
+export function compose(middleware: readonly Middleware[], handler: SendHandler): SendHandler {
+ let composed = handler
+ for (let i = middleware.length - 1; i >= 0; i--) {
+ composed = guard(middleware[i]!.name, middleware[i]!.handle(composed))
+ }
+ return composed
+}
+
+/**
+ * Attach middleware to a single driver rather than a whole instance. This
+ * is what makes retry compose with failover: each leg retries on its own
+ * before the fallback moves to the next.
+ *
+ * ```ts
+ * fallback([wrap(resend(...), withRetry()), wrap(ses(...), withRetry())])
+ * ```
+ */
+export function wrap(
+ driver: EmailDriver,
+ ...middleware: readonly Middleware[]
+): EmailDriver {
+ if (middleware.length === 0) return driver
+ const handler = compose(middleware, driverHandler(driver))
+ return {
+ ...driver,
+ send: async (msg, ctx) => (await handler([msg], ctx))[0]!,
+ sendBatch: (msgs, ctx) => handler(msgs, ctx),
+ }
+}
+
+/**
+ * The terminal handler: hand the list to the driver. Uses `sendBatch` when
+ * the driver has one, otherwise sends sequentially — and either way
+ * returns exactly one result per input.
+ */
+export function driverHandler(driver: EmailDriver): SendHandler {
+ return async (msgs, ctx) => {
+ if (msgs.length === 0) return []
+
+ if (msgs.length > 1 && driver.sendBatch) {
+ let results: readonly Result[]
+ try {
+ results = await driver.sendBatch(msgs, ctx)
+ } catch (error) {
+ const wrapped = err(toEmailError(driver.name, error))
+ return msgs.map(() => wrapped)
+ }
+ if (results.length !== msgs.length) {
+ // A driver that loses the 1:1 mapping makes every downstream
+ // index meaningless, so fail the batch rather than guess.
+ const mismatch = err(
+ toEmailError(
+ driver.name,
+ new Error(`sendBatch returned ${results.length} results for ${msgs.length} messages`),
+ ),
+ )
+ return msgs.map(() => mismatch)
+ }
+ return results
+ }
+
+ const out: Result[] = []
+ for (const msg of msgs) {
+ if (ctx.signal?.aborted) {
+ out.push(err(toEmailError(driver.name, ctx.signal.reason ?? new Error("aborted"))))
+ continue
+ }
+ try {
+ out.push(await driver.send(msg, ctx))
+ } catch (error) {
+ out.push(err(toEmailError(driver.name, error)))
+ }
+ }
+ return out
+ }
+}
+
+/** A middleware that throws must not take the batch down with it — its
+ * failure is reported per message, like any other. */
+function guard(name: string, handler: SendHandler): SendHandler {
+ return async (msgs, ctx) => {
+ try {
+ const results = await handler(msgs, ctx)
+ if (results.length === msgs.length) return results
+ throw new Error(`middleware "${name}" returned ${results.length} of ${msgs.length} results`)
+ } catch (error) {
+ const wrapped = err(toEmailError(ctx.driver, error))
+ return msgs.map(() => wrapped)
+ }
+ }
+}
+
+/** Re-exported so drivers can build results without importing `result.ts`
+ * separately. */
+export { ok, err }
diff --git a/src/core/email.ts b/src/core/email.ts
new file mode 100644
index 0000000..b6a07bb
--- /dev/null
+++ b/src/core/email.ts
@@ -0,0 +1,292 @@
+import type {
+ BatchResult,
+ EmailDriver,
+ EmailMessage,
+ EmailResult,
+ Middleware,
+ NormalizedMessage,
+ Result,
+ SendContext,
+ SendHandler,
+ SendStatus,
+} from "./types.ts"
+import type { MessageDefaults } from "./message.ts"
+import { compose, driverHandler } from "./define.ts"
+import { createUnsupportedError, toEmailError } from "./error.ts"
+import { err, ok, toBatchResult } from "./result.ts"
+import { normalizeMessage } from "./message.ts"
+
+/** Everything `createEmail()` accepts. Only `driver` is required. */
+export interface CreateEmailOptions {
+ /** The driver every message goes to unless `stream` routes it elsewhere. */
+ driver: EmailDriver
+ /** Named drivers, routed by `message.stream`. Same as calling `mount()`. */
+ mounts?: Readonly>
+ /** Middleware, outermost first. Same as calling `use()` in order. */
+ use?: readonly Middleware[]
+ /** Fields applied to every message that does not set them itself. */
+ defaults?: MessageDefaults
+ /** Cancels in-flight sends for the whole instance. */
+ signal?: AbortSignal
+}
+
+/** Options accepted by `sendStream()`. */
+export interface SendStreamOptions {
+ /** Messages handed to the pipeline at once. Larger values let a driver
+ * batch natively; smaller values yield sooner. Default: 50. */
+ chunkSize?: number
+}
+
+/** The handle returned by `createEmail()`. */
+export interface Email {
+ /** The default driver. */
+ readonly driver: EmailDriver
+
+ /** Append middleware. Returns `this`, so calls chain. */
+ use: (middleware: Middleware) => Email
+ /** Route messages carrying this `stream` to `driver`. */
+ mount: (stream: string, driver: EmailDriver) => Email
+ unmount: (stream: string, options?: { dispose?: boolean }) => Promise
+ getMount: (stream?: string) => EmailDriver
+ getMounts: () => readonly { stream: string; driver: EmailDriver }[]
+ /** Whether the driver believes it can send. Never throws. */
+ isAvailable: (stream?: string) => Promise
+
+ send: (message: EmailMessage) => Promise>
+ /** Send many. Never short-circuits: `result.results[i]` always
+ * corresponds to `messages[i]`, failed or not. */
+ sendBatch: (messages: readonly EmailMessage[]) => Promise
+ /** Same as `sendBatch` without holding every result in memory. */
+ sendStream: (
+ messages: Iterable | AsyncIterable,
+ options?: SendStreamOptions,
+ ) => AsyncIterable>
+
+ cancel: (id: string, options?: { stream?: string }) => Promise>
+ retrieve: (id: string, options?: { stream?: string }) => Promise>
+ dispose: () => Promise
+}
+
+/**
+ * Build an email instance.
+ *
+ * ```ts
+ * const email = createEmail({
+ * driver: resend({ apiKey: process.env.RESEND_API_KEY! }),
+ * defaults: { from: "Acme " },
+ * use: [withRetry()],
+ * })
+ *
+ * const { data, error } = await email.send({ to, subject, html })
+ * ```
+ */
+export function createEmail(options: CreateEmailOptions): Email {
+ const mounts = new Map(Object.entries(options.mounts ?? {}))
+ const middleware: Middleware[] = [...(options.use ?? [])]
+ const defaults = options.defaults ?? {}
+
+ // Composition is rebuilt whenever `use()` changes the chain; `revision`
+ // is what invalidates the per-driver cache.
+ const pipelines = new Map()
+ const initializing = new Map>()
+ let revision = 0
+
+ const api: Email = {
+ get driver() {
+ return options.driver
+ },
+
+ use(mw) {
+ middleware.push(mw)
+ revision++
+ return api
+ },
+
+ mount(stream, driver) {
+ mounts.set(stream, driver)
+ return api
+ },
+
+ async unmount(stream, opts = {}) {
+ const driver = mounts.get(stream)
+ if (!driver) return
+ mounts.delete(stream)
+ pipelines.delete(driver)
+ initializing.delete(driver)
+ if (opts.dispose ?? true) await driver.dispose?.()
+ },
+
+ getMount(stream) {
+ return (stream ? mounts.get(stream) : undefined) ?? options.driver
+ },
+
+ getMounts() {
+ return [...mounts].map(([stream, driver]) => ({ stream, driver }))
+ },
+
+ async isAvailable(stream) {
+ const driver = api.getMount(stream)
+ if (!driver.isAvailable) return true
+ try {
+ return await driver.isAvailable()
+ } catch {
+ return false
+ }
+ },
+
+ async send(message) {
+ const results = await dispatch([message])
+ return results[0]!
+ },
+
+ async sendBatch(messages) {
+ return toBatchResult(await dispatch(messages))
+ },
+
+ sendStream(messages, opts = {}) {
+ const chunkSize = Math.max(1, opts.chunkSize ?? 50)
+ return {
+ async *[Symbol.asyncIterator]() {
+ let chunk: EmailMessage[] = []
+ for await (const message of messages) {
+ chunk.push(message)
+ if (chunk.length < chunkSize) continue
+ yield* await dispatch(chunk)
+ chunk = []
+ }
+ if (chunk.length > 0) yield* await dispatch(chunk)
+ },
+ }
+ },
+
+ async cancel(id, opts = {}) {
+ const driver = api.getMount(opts.stream)
+ if (!driver.cancel) return err(createUnsupportedError(driver.name, "cancel()"))
+ try {
+ await ensureInitialized(driver)
+ return await driver.cancel(id)
+ } catch (error) {
+ return err(toEmailError(driver.name, error))
+ }
+ },
+
+ async retrieve(id, opts = {}) {
+ const driver = api.getMount(opts.stream)
+ if (!driver.retrieve) return err(createUnsupportedError(driver.name, "retrieve()"))
+ try {
+ await ensureInitialized(driver)
+ return await driver.retrieve(id)
+ } catch (error) {
+ return err(toEmailError(driver.name, error))
+ }
+ },
+
+ async dispose() {
+ const drivers = new Set([options.driver, ...mounts.values()])
+ mounts.clear()
+ pipelines.clear()
+ initializing.clear()
+ await Promise.all([...drivers].map((driver) => driver.dispose?.()))
+ },
+ }
+
+ /**
+ * Normalize, group by destination driver, run each group through that
+ * driver's pipeline, and stitch the results back into input order.
+ *
+ * A message that fails normalization takes only its own slot with it —
+ * one bad address in a batch of a thousand does not stop the other 999.
+ */
+ async function dispatch(
+ messages: readonly EmailMessage[],
+ ): Promise[]> {
+ // Pre-filled, so a slot no driver claims still reports something
+ // rather than reading back as a hole.
+ const results = Array.from({ length: messages.length }, () =>
+ err(missingResult("unemail")),
+ )
+ const groups = new Map()
+
+ for (const [index, message] of messages.entries()) {
+ let normalized: NormalizedMessage
+ try {
+ normalized = normalizeMessage(message, defaults)
+ } catch (error) {
+ results[index] = err(toEmailError("unemail", error))
+ continue
+ }
+ const driver = api.getMount(normalized.stream)
+ let group = groups.get(driver)
+ if (!group) {
+ group = { indices: [], msgs: [] }
+ groups.set(driver, group)
+ }
+ group.indices.push(index)
+ group.msgs.push(normalized)
+ }
+
+ await Promise.all(
+ [...groups].map(async ([driver, group]) => {
+ const ctx: SendContext = {
+ driver: driver.name,
+ ...(group.msgs[0]?.stream ? { stream: group.msgs[0].stream } : {}),
+ attempt: 1,
+ ...(options.signal ? { signal: options.signal } : {}),
+ meta: {},
+ }
+ let produced: readonly Result[]
+ try {
+ await ensureInitialized(driver)
+ produced = await pipelineFor(driver)(group.msgs, ctx)
+ } catch (error) {
+ const failure = err(toEmailError(driver.name, error))
+ produced = group.msgs.map(() => failure)
+ }
+ for (const [slot, index] of group.indices.entries()) {
+ results[index] = produced[slot] ?? err(missingResult(driver.name))
+ }
+ }),
+ )
+
+ return results
+ }
+
+ function pipelineFor(driver: EmailDriver): SendHandler {
+ const cached = pipelines.get(driver)
+ if (cached && cached.revision === revision) return cached.handler
+ const handler = compose(middleware, driverHandler(driver))
+ pipelines.set(driver, { revision, handler })
+ return handler
+ }
+
+ /**
+ * Initialize a driver at most once, per driver.
+ *
+ * The promise is stored before it is awaited: two concurrent sends share
+ * one initialization instead of racing past a half-open connection. It
+ * is keyed by driver rather than by instance so a driver mounted after
+ * the first send still gets initialized.
+ */
+ function ensureInitialized(driver: EmailDriver): Promise {
+ let pending = initializing.get(driver)
+ if (pending) return pending
+ pending = (async () => {
+ try {
+ await driver.initialize?.()
+ } catch (error) {
+ initializing.delete(driver)
+ throw toEmailError(driver.name, error)
+ }
+ })()
+ initializing.set(driver, pending)
+ return pending
+ }
+
+ return api
+}
+
+function missingResult(driver: string) {
+ return toEmailError(driver, new Error("pipeline produced no result for this message"))
+}
+
+export { ok }
diff --git a/src/core/error.ts b/src/core/error.ts
new file mode 100644
index 0000000..b12ca59
--- /dev/null
+++ b/src/core/error.ts
@@ -0,0 +1,80 @@
+import type { EmailErrorCode } from "./types.ts"
+
+/** Every failure the library reports. Drivers never throw raw errors past
+ * their own boundary — `toEmailError()` wraps whatever they catch, so
+ * `error.code` and `error.retryable` are always meaningful. */
+export class EmailError extends Error {
+ override readonly name = "EmailError"
+ readonly driver: string
+ readonly code: EmailErrorCode
+ readonly status?: number
+ readonly retryable: boolean
+ override readonly cause?: unknown
+
+ constructor(init: {
+ driver: string
+ code: EmailErrorCode
+ message: string
+ status?: number
+ retryable?: boolean
+ cause?: unknown
+ }) {
+ super(init.message)
+ this.driver = init.driver
+ this.code = init.code
+ this.status = init.status
+ this.retryable = init.retryable ?? RETRYABLE_BY_DEFAULT.has(init.code)
+ this.cause = init.cause
+ }
+}
+
+const RETRYABLE_BY_DEFAULT: ReadonlySet = new Set([
+ "NETWORK",
+ "RATE_LIMIT",
+ "TIMEOUT",
+])
+
+/** Build an `EmailError` with the `[unemail] [driver]` prefix, so one
+ * provider's failures are greppable in a mixed log. */
+export function createError(
+ driver: string,
+ code: EmailErrorCode,
+ message: string,
+ init?: { status?: number; retryable?: boolean; cause?: unknown },
+): EmailError {
+ return new EmailError({
+ driver,
+ code,
+ message: `[unemail] [${driver}] ${message}`,
+ status: init?.status,
+ retryable: init?.retryable,
+ cause: init?.cause,
+ })
+}
+
+/** Missing driver options. Raised from the factory so misconfiguration
+ * fails at construction rather than on the first send. */
+export function createRequiredError(driver: string, name: string | readonly string[]): EmailError {
+ const names = Array.isArray(name) ? name.join(", ") : String(name)
+ return createError(driver, "INVALID_OPTIONS", `missing required option(s): ${names}`)
+}
+
+/** Raised when a message asks for something the driver cannot do. */
+export function createUnsupportedError(driver: string, what: string): EmailError {
+ return createError(driver, "UNSUPPORTED", `${what} is not supported by "${driver}"`)
+}
+
+/** Normalize any thrown value. An existing `EmailError` passes through
+ * untouched so its `retryable` and `status` survive re-wrapping. */
+export function toEmailError(driver: string, error: unknown): EmailError {
+ if (error instanceof EmailError) return error
+ if (isAbort(error)) return createError(driver, "CANCELLED", "aborted", { cause: error })
+ if (error instanceof Error) {
+ return createError(driver, "PROVIDER", error.message, { cause: error })
+ }
+ return createError(driver, "PROVIDER", String(error), { cause: error })
+}
+
+function isAbort(error: unknown): boolean {
+ return error instanceof Error && (error.name === "AbortError" || error.name === "TimeoutError")
+}
diff --git a/src/core/message.ts b/src/core/message.ts
new file mode 100644
index 0000000..0679b22
--- /dev/null
+++ b/src/core/message.ts
@@ -0,0 +1,182 @@
+import type { EmailMessage, NormalizedMessage } from "./types.ts"
+import { dedupeAddresses, isValidEmail, toAddressList } from "./address.ts"
+import { createError } from "./error.ts"
+
+/** Fields an instance can supply once instead of on every message. */
+export type MessageDefaults = Pick<
+ EmailMessage,
+ "from" | "replyTo" | "headers" | "tags" | "metadata" | "stream"
+>
+
+const CORE = "unemail"
+
+/**
+ * Turn user input into the shape drivers consume: addresses parsed, lists
+ * always present, headers validated, derived headers applied.
+ *
+ * This runs exactly once per message, at the edge of the library. It is
+ * why no driver in this repo parses an address or guards a header.
+ *
+ * Throws `EmailError(INVALID_OPTIONS)`; `createEmail()` catches and
+ * returns it as a `Result`, so callers still never see a throw.
+ */
+export function normalizeMessage(
+ input: EmailMessage,
+ defaults: MessageDefaults = {},
+): NormalizedMessage {
+ const fromList = toAddressList(input.from ?? defaults.from)
+ const from = fromList[0]
+ if (!from) throw invalid("`from` is required (set it on the message or as an instance default)")
+
+ const to = dedupeAddresses(toAddressList(input.to))
+ if (to.length === 0) throw invalid("`to` must contain at least one recipient")
+
+ const cc = dedupeAddresses(toAddressList(input.cc))
+ const bcc = dedupeAddresses(toAddressList(input.bcc))
+ const replyTo = dedupeAddresses(toAddressList(input.replyTo ?? defaults.replyTo))
+
+ for (const [field, list] of [
+ ["from", [from]],
+ ["to", to],
+ ["cc", cc],
+ ["bcc", bcc],
+ ["replyTo", replyTo],
+ ] as const) {
+ for (const address of list) {
+ if (!isValidEmail(address.email)) {
+ throw invalid(`\`${field}\` contains an invalid address: ${JSON.stringify(address.email)}`)
+ }
+ }
+ }
+
+ if (typeof input.subject !== "string") throw invalid("`subject` is required")
+
+ const hasBody =
+ input.text != null ||
+ input.html != null ||
+ input.content != null ||
+ input.raw != null ||
+ input.template != null
+ if (!hasBody) {
+ throw invalid("message has no body — set one of `text`, `html`, `content`, `template`, `raw`")
+ }
+
+ const headers = buildHeaders(input, defaults)
+ const html =
+ input.preheader && input.html ? injectPreheader(input.html, input.preheader) : input.html
+
+ const message: NormalizedMessage = {
+ ...((input.stream ?? defaults.stream) ? { stream: input.stream ?? defaults.stream } : {}),
+ from,
+ to,
+ cc,
+ bcc,
+ replyTo,
+ subject: input.subject,
+ ...(input.text == null ? {} : { text: input.text }),
+ ...(html == null ? {} : { html }),
+ ...(input.content == null ? {} : { content: input.content }),
+ headers,
+ attachments: input.attachments ?? [],
+ tags: [...(defaults.tags ?? []), ...(input.tags ?? [])],
+ metadata: { ...defaults.metadata, ...input.metadata },
+ ...(input.idempotencyKey == null ? {} : { idempotencyKey: input.idempotencyKey }),
+ ...(input.scheduledAt == null ? {} : { scheduledAt: parseDate(input.scheduledAt) }),
+ ...(input.template == null ? {} : { template: input.template }),
+ ...(input.tracking == null ? {} : { tracking: input.tracking }),
+ ...(input.sandbox == null ? {} : { sandbox: input.sandbox }),
+ ...(input.raw == null ? {} : { raw: input.raw }),
+ }
+
+ return Object.freeze(message)
+}
+
+/** Derive a new message from a normalized one. The only supported way for
+ * middleware to change a message — the caller's object is never touched,
+ * so a template object stays reusable across sends. */
+export function patchMessage(
+ message: NormalizedMessage,
+ patch: Partial,
+): NormalizedMessage {
+ return Object.freeze({ ...message, ...patch })
+}
+
+/** Case-insensitive header lookup, since callers write `Message-ID`,
+ * `message-id`, and `Message-Id` interchangeably. */
+export function getHeader(
+ headers: Readonly>,
+ name: string,
+): string | undefined {
+ const target = name.toLowerCase()
+ for (const [key, value] of Object.entries(headers)) {
+ if (key.toLowerCase() === target) return value
+ }
+ return undefined
+}
+
+/** True when a header is already set under any casing. */
+export function hasHeader(headers: Readonly>, name: string): boolean {
+ return getHeader(headers, name) !== undefined
+}
+
+function buildHeaders(
+ input: EmailMessage,
+ defaults: MessageDefaults,
+): Readonly> {
+ const headers: Record = { ...defaults.headers, ...input.headers }
+
+ for (const [name, value] of Object.entries(headers)) {
+ // A newline in a header value lets a caller append arbitrary headers
+ // (and a body) to the message — RFC 5322 §2.2 forbids it outright.
+ if (/[\r\n]/.test(value) || /[\r\n:]/.test(name)) {
+ throw invalid(`header ${JSON.stringify(name)} contains a line break`)
+ }
+ }
+
+ const unsubscribe = input.unsubscribe
+ if (unsubscribe && (unsubscribe.url || unsubscribe.mailto)) {
+ const parts: string[] = []
+ if (unsubscribe.url) parts.push(`<${unsubscribe.url}>`)
+ if (unsubscribe.mailto) parts.push(``)
+ if (!hasHeader(headers, "list-unsubscribe")) headers["List-Unsubscribe"] = parts.join(", ")
+ const oneClick = unsubscribe.oneClick ?? Boolean(unsubscribe.url)
+ if (oneClick && unsubscribe.url && !hasHeader(headers, "list-unsubscribe-post")) {
+ headers["List-Unsubscribe-Post"] = "List-Unsubscribe=One-Click"
+ }
+ }
+
+ return Object.freeze(headers)
+}
+
+/** Hidden span most clients read as the preview line. The trailing
+ * zero-width joiners stop the client from spilling body text into the
+ * preview after the preheader ends. */
+function injectPreheader(html: string, preheader: string): string {
+ const block =
+ `` +
+ `${escapeHtml(preheader)}${" ".repeat(60)}
`
+ const bodyOpen = /]*>/i.exec(html)
+ if (bodyOpen) {
+ const at = bodyOpen.index + bodyOpen[0].length
+ return html.slice(0, at) + block + html.slice(at)
+ }
+ return block + html
+}
+
+function escapeHtml(value: string): string {
+ return value
+ .replace(/&/g, "&")
+ .replace(//g, ">")
+ .replace(/"/g, """)
+}
+
+function parseDate(value: string | Date): Date {
+ const date = value instanceof Date ? value : new Date(value)
+ if (Number.isNaN(date.getTime())) throw invalid(`\`scheduledAt\` is not a valid date: ${value}`)
+ return date
+}
+
+function invalid(message: string) {
+ return createError(CORE, "INVALID_OPTIONS", message)
+}
diff --git a/src/core/result.ts b/src/core/result.ts
new file mode 100644
index 0000000..a29e640
--- /dev/null
+++ b/src/core/result.ts
@@ -0,0 +1,36 @@
+import type { BatchResult, EmailResult, Result } from "./types.ts"
+import type { EmailError } from "./error.ts"
+
+/** Wrap a value as a success. */
+export function ok(data: T): Result {
+ return { data, error: null }
+}
+
+/** Wrap an error as a failure. */
+export function err(error: EmailError): Result {
+ return { data: null, error }
+}
+
+/** Narrow a `Result` to its success branch. */
+export function isOk(result: Result): result is { data: T; error: null } {
+ return result.error === null
+}
+
+/** Throw on failure, return the value on success. For callers who prefer
+ * exceptions to branching — `const sent = unwrap(await email.send(msg))`. */
+export function unwrap(result: Result): T {
+ if (result.error) throw result.error
+ return result.data
+}
+
+/** Summarize positional per-message results. Never loses a partial
+ * success: `sent` holds what got through even when `ok` is false. */
+export function toBatchResult(results: readonly Result[]): BatchResult {
+ const sent: EmailResult[] = []
+ const failed: { index: number; error: EmailError }[] = []
+ for (const [index, result] of results.entries()) {
+ if (result.error) failed.push({ index, error: result.error })
+ else sent.push(result.data)
+ }
+ return { results, sent, failed, ok: failed.length === 0 }
+}
diff --git a/src/core/types.ts b/src/core/types.ts
new file mode 100644
index 0000000..43556c5
--- /dev/null
+++ b/src/core/types.ts
@@ -0,0 +1,305 @@
+/**
+ * Every type in the public surface. Runtime-free by construction — this
+ * module compiles to nothing, so importing it costs no bytes in a Worker
+ * bundle.
+ *
+ * @module
+ */
+
+import type { EmailError } from "./error.ts"
+
+/** A value that may be returned synchronously or as a promise. */
+export type MaybePromise = T | Promise
+
+// ---------------------------------------------------------------------------
+// Addresses
+// ---------------------------------------------------------------------------
+
+/** A contact: an address plus an optional display name. */
+export interface EmailAddress {
+ readonly email: string
+ readonly name?: string
+}
+
+/** Anything accepted where an address is expected — `"ada@acme.com"`,
+ * `"Ada "`, `{ email, name }`, or a list of those. */
+export type AddressInput = string | EmailAddress | readonly (string | EmailAddress)[]
+
+// ---------------------------------------------------------------------------
+// Message
+// ---------------------------------------------------------------------------
+
+/** A file part. `content` is either raw bytes or a base64 string; set
+ * `cid` to reference it from HTML as `
`. */
+export interface Attachment {
+ readonly filename: string
+ readonly content: string | Uint8Array
+ readonly contentType?: string
+ readonly disposition?: "attachment" | "inline"
+ readonly cid?: string
+}
+
+/** Key-value pair forwarded to provider analytics. */
+export interface EmailTag {
+ readonly name: string
+ readonly value: string
+}
+
+/** RFC 2369 + RFC 8058 unsubscribe configuration. Gmail and Yahoo require
+ * a one-click unsubscribe on bulk mail; setting `url` turns it on. */
+export interface UnsubscribeOptions {
+ readonly url?: string
+ readonly mailto?: string
+ /** Emit `List-Unsubscribe-Post`. Defaults to `true` when `url` is set. */
+ readonly oneClick?: boolean
+}
+
+/** A provider-hosted template. Use `id` where the provider addresses
+ * templates numerically, `alias` where it addresses them by name. */
+export interface TemplateOptions {
+ readonly id?: string
+ readonly alias?: string
+ readonly variables?: Readonly>
+}
+
+/** Per-message open/click tracking. Unset fields defer to the provider's
+ * account-level setting. */
+export interface TrackingOptions {
+ readonly opens?: boolean
+ readonly clicks?: boolean
+}
+
+/** Unrendered body handed to a `Renderer`. The core never inspects
+ * anything but `type`, which is how a renderer claims a message —
+ * so a new template language is a package, not a core change. */
+export interface MessageContent {
+ readonly type: string
+ readonly [key: string]: unknown
+}
+
+/** What you pass to `email.send()`. Every address field is loose; the core
+ * normalizes and validates before a driver sees it. */
+export interface EmailMessage {
+ /** Route to a driver registered with `mount(stream, driver)`. */
+ readonly stream?: string
+
+ readonly from?: AddressInput
+ readonly to: AddressInput
+ readonly cc?: AddressInput
+ readonly bcc?: AddressInput
+ readonly replyTo?: AddressInput
+
+ readonly subject: string
+ /** Preview line most clients show next to the subject. */
+ readonly preheader?: string
+ readonly text?: string
+ readonly html?: string
+ /** Unrendered body — a `Renderer` turns this into `html`. */
+ readonly content?: MessageContent
+
+ readonly headers?: Readonly>
+ readonly attachments?: readonly Attachment[]
+ readonly tags?: readonly EmailTag[]
+ /** Provider-agnostic metadata, echoed back on webhook events. */
+ readonly metadata?: Readonly>
+
+ readonly idempotencyKey?: string
+ readonly scheduledAt?: string | Date
+ readonly unsubscribe?: UnsubscribeOptions
+ readonly template?: TemplateOptions
+ readonly tracking?: TrackingOptions
+ /** Route to the provider's sandbox instead of real delivery. */
+ readonly sandbox?: boolean
+ /** A pre-composed RFC 5322 message. Bypasses the MIME builder; SMTP only. */
+ readonly raw?: string | Uint8Array
+}
+
+/** What a driver receives: validated, address-parsed, header-folded. Lists
+ * are always present (empty rather than `undefined`) so drivers never
+ * branch on nullish, and `from` is guaranteed. */
+export interface NormalizedMessage {
+ readonly stream?: string
+
+ readonly from: EmailAddress
+ readonly to: readonly EmailAddress[]
+ readonly cc: readonly EmailAddress[]
+ readonly bcc: readonly EmailAddress[]
+ readonly replyTo: readonly EmailAddress[]
+
+ readonly subject: string
+ readonly text?: string
+ readonly html?: string
+ readonly content?: MessageContent
+
+ /** Header names are as-cased by the caller; `hasHeader()` compares
+ * case-insensitively. Already includes derived `List-Unsubscribe`. */
+ readonly headers: Readonly>
+ readonly attachments: readonly Attachment[]
+ readonly tags: readonly EmailTag[]
+ readonly metadata: Readonly>
+
+ readonly idempotencyKey?: string
+ readonly scheduledAt?: Date
+ readonly template?: TemplateOptions
+ readonly tracking?: TrackingOptions
+ readonly sandbox?: boolean
+ readonly raw?: string | Uint8Array
+}
+
+// ---------------------------------------------------------------------------
+// Results
+// ---------------------------------------------------------------------------
+
+/** A delivery accepted by the provider. */
+export interface EmailResult {
+ readonly id: string
+ readonly driver: string
+ readonly stream?: string
+ readonly at: Date
+ /** The provider's own response, untouched. */
+ readonly provider?: Readonly>
+}
+
+/** Discriminated union — narrowing on `error` yields typed `data`. */
+export type Result = { data: T; error: null } | { data: null; error: EmailError }
+
+/** Outcome of `sendBatch()`. `results` is positional: `results[i]` is the
+ * outcome of `messages[i]`, always, even when some failed. */
+export interface BatchResult {
+ readonly results: readonly Result[]
+ readonly sent: readonly EmailResult[]
+ readonly failed: readonly { readonly index: number; readonly error: EmailError }[]
+ /** True when every message was accepted. */
+ readonly ok: boolean
+}
+
+/** Lifecycle state of a message, as far as the provider will tell us. */
+export type SendState =
+ | "scheduled"
+ | "queued"
+ | "sent"
+ | "delivered"
+ | "bounced"
+ | "complained"
+ | "opened"
+ | "clicked"
+ | "cancelled"
+ | "failed"
+ | "unknown"
+
+export interface SendStatus {
+ readonly id: string
+ readonly driver: string
+ readonly state: SendState
+ readonly at?: Date
+ readonly provider?: Readonly>
+}
+
+/** Machine-readable failure taxonomy. Stable across every driver. */
+export type EmailErrorCode =
+ | "INVALID_OPTIONS"
+ | "NETWORK"
+ | "AUTH"
+ | "RATE_LIMIT"
+ | "TIMEOUT"
+ | "PROVIDER"
+ | "UNSUPPORTED"
+ | "CANCELLED"
+
+// ---------------------------------------------------------------------------
+// Drivers
+// ---------------------------------------------------------------------------
+
+/** Capabilities a driver advertises. Callers gate on these instead of
+ * string-matching `driver.name`. */
+export interface DriverFeatures {
+ readonly attachments?: boolean
+ readonly html?: boolean
+ readonly text?: boolean
+ /** `sendBatch` reaches the provider in one request. */
+ readonly batch?: boolean
+ readonly scheduling?: boolean
+ /** The provider itself deduplicates on `idempotencyKey`. */
+ readonly idempotency?: boolean
+ readonly tracking?: boolean
+ readonly templates?: boolean
+ readonly tagging?: boolean
+ readonly replyTo?: boolean
+ readonly customHeaders?: boolean
+ readonly sandbox?: boolean
+ readonly cancelable?: boolean
+ readonly retrievable?: boolean
+}
+
+/** Everything a driver is asked to do. Only `name` and `send` are
+ * required; the rest is feature-gated and routed to `UNSUPPORTED`. */
+export interface EmailDriver {
+ readonly name: string
+ readonly features?: DriverFeatures
+ /** The underlying client (a pool, an inbox array, an SDK handle). */
+ readonly getInstance?: () => TInstance
+ readonly initialize?: () => MaybePromise
+ readonly dispose?: () => MaybePromise
+ readonly isAvailable?: () => MaybePromise
+
+ readonly send: (msg: NormalizedMessage, ctx: SendContext) => MaybePromise>
+ /** One request for many messages. Must return one result per input, in
+ * order — the core checks this and fails loudly if it does not. */
+ readonly sendBatch?: (
+ msgs: readonly NormalizedMessage[],
+ ctx: SendContext,
+ ) => MaybePromise[]>
+ readonly cancel?: (id: string) => MaybePromise>
+ readonly retrieve?: (id: string) => MaybePromise>
+}
+
+/** A driver that is guaranteed to expose its underlying client, so callers
+ * reach it without an optional-call guard. */
+export type DriverWithInstance = EmailDriver & {
+ readonly getInstance: () => TInstance
+}
+
+/** The driver shape implied by an instance type. Naming one obliges the
+ * driver to expose it and lets callers reach it unguarded; leaving it
+ * `unknown` keeps `getInstance` optional. */
+export type DriverOf = unknown extends TInstance
+ ? EmailDriver
+ : DriverWithInstance
+
+/** What `defineDriver` returns. Options are required when `TOpts` has a
+ * required field — `resend()` with no key is a type error, not a
+ * runtime surprise. */
+export type DriverFactory = (options: TOpts) => DriverOf
+
+// ---------------------------------------------------------------------------
+// Pipeline
+// ---------------------------------------------------------------------------
+
+/** Ambient state for one trip through the pipeline. `meta` is a shared
+ * mutable bag for middleware to leave notes in; everything else is
+ * replaced, not mutated, when a middleware derives a new context. */
+export interface SendContext {
+ readonly driver: string
+ readonly stream?: string
+ /** 1 on the first try. Retry middleware derives a context per attempt. */
+ readonly attempt: number
+ readonly signal?: AbortSignal
+ readonly meta: Record
+}
+
+/** The one unit of work in this library. Always a list, always one result
+ * per input, in order — `send()` is the single-element case. Making the
+ * list the primitive is what lets retry re-send only the failures even
+ * when the driver batches natively. */
+export type SendHandler = (
+ msgs: readonly NormalizedMessage[],
+ ctx: SendContext,
+) => Promise[]>
+
+/** The one composition primitive. Wrap the next handler, do work around
+ * it, return the results. Register with `email.use()` to cover a whole
+ * instance, or `wrap(driver, ...)` to cover one driver. */
+export interface Middleware {
+ readonly name: string
+ readonly handle: (next: SendHandler) => SendHandler
+}
diff --git a/src/dmarc/index.ts b/src/dmarc/index.ts
deleted file mode 100644
index 19b5e83..0000000
--- a/src/dmarc/index.ts
+++ /dev/null
@@ -1,124 +0,0 @@
-/**
- * Minimal DMARC aggregate (RUA) XML report parser. Zero-dep — we only
- * need the narrow RUA schema Google/Yahoo/Microsoft emit. Input can be
- * raw XML, gzipped bytes, or a fetch Response body.
- *
- * @module
- */
-
-export interface DmarcReport {
- orgName?: string
- email?: string
- reportId?: string
- domain?: string
- dateRange?: { begin: Date; end: Date }
- policy?: {
- p?: "none" | "quarantine" | "reject"
- sp?: "none" | "quarantine" | "reject"
- adkim?: "r" | "s"
- aspf?: "r" | "s"
- pct?: number
- }
- records: ReadonlyArray
-}
-
-export interface DmarcRecord {
- sourceIp?: string
- count: number
- disposition?: "none" | "quarantine" | "reject"
- dkim?: "pass" | "fail"
- spf?: "pass" | "fail"
- headerFrom?: string
-}
-
-/** Parse a DMARC aggregate report. Accepts a plain XML string or a
- * gzipped Uint8Array (detected via magic bytes). */
-export async function parseDmarcAggregate(input: string | Uint8Array): Promise {
- const xml = typeof input === "string" ? input : await gunzipOrUtf8(input)
- return parseReportXml(xml)
-}
-
-async function gunzipOrUtf8(bytes: Uint8Array): Promise {
- if (bytes.length >= 2 && bytes[0] === 0x1f && bytes[1] === 0x8b) {
- // Use DecompressionStream if available, else node:zlib.
- const g = globalThis as { DecompressionStream?: typeof DecompressionStream }
- if (g.DecompressionStream) {
- const stream = new Response(
- new Response(bytes as BufferSource).body!.pipeThrough(new g.DecompressionStream("gzip")),
- )
- return stream.text()
- }
- // Node.js fallback.
- const zlibModule = await import("node:zlib").catch(() => null)
- if (zlibModule) {
- return new Promise((resolve, reject) => {
- zlibModule.gunzip(Buffer.from(bytes), (err, out) => {
- if (err) reject(err)
- else resolve(out.toString("utf8"))
- })
- })
- }
- throw new Error("[unemail/dmarc] gzip input but no DecompressionStream / node:zlib available")
- }
- return new TextDecoder().decode(bytes)
-}
-
-function parseReportXml(xml: string): DmarcReport {
- const out: DmarcReport = { records: [] }
- const records: DmarcRecord[] = []
-
- out.orgName = takeTag(xml, "org_name")
- out.email = takeTag(xml, "email")
- out.reportId = takeTag(xml, "report_id")
- out.domain = takeTag(xml, "domain")
-
- const rangeBlock = takeSection(xml, "date_range")
- if (rangeBlock) {
- const begin = Number(takeTag(rangeBlock, "begin"))
- const end = Number(takeTag(rangeBlock, "end"))
- if (Number.isFinite(begin) && Number.isFinite(end))
- out.dateRange = { begin: new Date(begin * 1000), end: new Date(end * 1000) }
- }
-
- const policyBlock = takeSection(xml, "policy_published")
- if (policyBlock) {
- out.policy = {
- p: takeTag(policyBlock, "p") as DmarcReport["policy"] extends infer P
- ? P extends { p?: infer T }
- ? T
- : never
- : never,
- sp: takeTag(policyBlock, "sp") as "none" | "quarantine" | "reject" | undefined,
- adkim: takeTag(policyBlock, "adkim") as "r" | "s" | undefined,
- aspf: takeTag(policyBlock, "aspf") as "r" | "s" | undefined,
- pct: Number(takeTag(policyBlock, "pct")) || undefined,
- }
- }
-
- const recordRegex = /([\s\S]*?)<\/record>/g
- let m: RegExpExecArray | null
- while ((m = recordRegex.exec(xml)) !== null) {
- const block = m[1]!
- records.push({
- sourceIp: takeTag(block, "source_ip"),
- count: Number(takeTag(block, "count")) || 0,
- disposition: takeTag(block, "disposition") as DmarcRecord["disposition"],
- dkim: takeTag(block, "dkim") as DmarcRecord["dkim"],
- spf: takeTag(block, "spf") as DmarcRecord["spf"],
- headerFrom: takeTag(block, "header_from"),
- })
- }
- return { ...out, records }
-}
-
-function takeTag(block: string, tag: string): string | undefined {
- const re = new RegExp(`<${tag}>([^<]*)<\\/${tag}>`, "i")
- const m = re.exec(block)
- return m ? m[1]!.trim() : undefined
-}
-
-function takeSection(block: string, tag: string): string | undefined {
- const re = new RegExp(`<${tag}>([\\s\\S]*?)<\\/${tag}>`, "i")
- const m = re.exec(block)
- return m ? m[1] : undefined
-}
diff --git a/src/driver/_http.ts b/src/driver/_http.ts
deleted file mode 100644
index 1f8587d..0000000
--- a/src/driver/_http.ts
+++ /dev/null
@@ -1,98 +0,0 @@
-import type { Result } from "../types.ts"
-import { createError, toEmailError } from "../errors.ts"
-
-/** Thin wrapper around `fetch` used by every HTTP-based driver (Resend,
- * Postmark, SendGrid, Mailgun, Mailtrap, Brevo, MailerSend, Loops, Zeptomail,
- * MailChannels, HTTP). Handles JSON encoding, response parsing, and
- * mapping HTTP status codes to our `EmailErrorCode` taxonomy.
- *
- * Drivers pass a tiny `classifyError()` callback when the provider
- * returns richer error codes than plain HTTP (Postmark's `ErrorCode 10`,
- * SendGrid's `errors[].field`, etc.).
- */
-export interface HttpRequestInit {
- fetch: typeof fetch
- driver: string
- url: string
- method?: string
- headers?: Record
- body?: unknown
- /** Return a custom EmailErrorCode classification from the parsed body. */
- classifyError?: (
- status: number,
- body: unknown,
- ) => {
- code: "AUTH" | "RATE_LIMIT" | "NETWORK" | "PROVIDER"
- retryable?: boolean
- message?: string
- } | null
-}
-
-/** Issue a JSON HTTP request and return a `Result` where the
- * data is the parsed response (or null for empty bodies). */
-export async function httpJson(init: HttpRequestInit): Promise> {
- const headers: Record = {
- accept: "application/json",
- "content-type": "application/json",
- ...init.headers,
- }
-
- let res: Response
- try {
- res = await init.fetch(init.url, {
- method: init.method ?? "POST",
- headers,
- body: init.body == null ? undefined : JSON.stringify(init.body),
- })
- } catch (err) {
- return { data: null, error: toEmailError(init.driver, err) }
- }
-
- const text = await res.text()
- const parsed = text ? safeJson(text) : null
-
- if (!res.ok) {
- const custom = init.classifyError?.(res.status, parsed)
- const code = custom?.code ?? defaultCodeForStatus(res.status)
- const message = custom?.message ?? extractMessage(parsed) ?? `HTTP ${res.status}`
- const retryable = custom?.retryable ?? (code === "RATE_LIMIT" || code === "NETWORK")
- return {
- data: null,
- error: createError(init.driver, code, message, {
- status: res.status,
- retryable,
- cause: { headers: res.headers, body: parsed ?? text },
- }),
- }
- }
-
- return { data: parsed, error: null }
-}
-
-function defaultCodeForStatus(status: number): "AUTH" | "RATE_LIMIT" | "NETWORK" | "PROVIDER" {
- if (status === 401 || status === 403) return "AUTH"
- if (status === 429) return "RATE_LIMIT"
- if (status >= 500) return "NETWORK"
- return "PROVIDER"
-}
-
-function extractMessage(body: unknown): string | null {
- if (!body || typeof body !== "object") return null
- const record = body as Record
- // Common shapes: { message }, { Message }, { error }, { errors: [{ message }] }
- const direct = record.message ?? record.Message ?? record.error ?? record.detail
- if (typeof direct === "string") return direct
- if (Array.isArray(record.errors) && record.errors[0] && typeof record.errors[0] === "object") {
- const first = record.errors[0] as Record
- if (typeof first.message === "string") return first.message
- }
- return null
-}
-
-function safeJson(text: string): unknown {
- try {
- return JSON.parse(text)
- } catch {
- return null
- }
-}
diff --git a/src/driver/_smtp/mime.ts b/src/driver/_smtp/mime.ts
deleted file mode 100644
index 99b7d0e..0000000
--- a/src/driver/_smtp/mime.ts
+++ /dev/null
@@ -1,320 +0,0 @@
-import type { Attachment, EmailAddress, EmailMessage } from "../../types.ts"
-import { formatAddress, normalizeAddresses } from "../../_normalize.ts"
-
-/** Inputs used to assemble the MIME document. Kept separate from
- * `EmailMessage` so the builder can be unit-tested in isolation. */
-export interface MimeInput {
- from: EmailAddress
- to: EmailAddress[]
- cc: EmailAddress[]
- bcc: EmailAddress[]
- replyTo: EmailAddress[]
- subject: string
- text?: string
- html?: string
- amp?: string
- headers?: Record
- attachments?: ReadonlyArray
- date?: Date
- messageId?: string
-}
-
-/** Output of `buildMime()` — the serialized RFC 5322 message plus the list
- * of envelope recipients (to/cc/bcc merged) for `RCPT TO`. */
-export interface MimeOutput {
- envelope: {
- from: string
- rcpt: string[]
- }
- body: string
- headers: Record
-}
-
-export function normalizeMimeInput(
- msg: EmailMessage,
- messageId: string,
- date: Date = new Date(),
-): MimeInput {
- const fromList = normalizeAddresses(msg.from)
- const from = fromList[0]
- if (!from) throw new Error("`from` is required")
- return {
- from,
- to: normalizeAddresses(msg.to),
- cc: normalizeAddresses(msg.cc),
- bcc: normalizeAddresses(msg.bcc),
- replyTo: normalizeAddresses(msg.replyTo),
- subject: msg.subject,
- text: msg.text,
- html: msg.html,
- amp: msg.amp,
- headers: msg.headers,
- attachments: msg.attachments,
- date,
- messageId,
- }
-}
-
-export function buildMime(input: MimeInput): MimeOutput {
- const boundary = `----unemail_${randomBoundary()}`
- const altBoundary = `----unemail_alt_${randomBoundary()}`
- const hasAttachments = (input.attachments?.length ?? 0) > 0
- const hasBothBodies = Boolean(input.text && input.html) || Boolean(input.amp)
-
- const headers: Record = {
- From: formatAddress(input.from),
- To: input.to.map(formatAddress).join(", "),
- Subject: encodeHeader(input.subject),
- "Message-ID": input.messageId ?? "",
- Date: (input.date ?? new Date()).toUTCString(),
- "MIME-Version": "1.0",
- }
- if (input.cc.length) headers.Cc = input.cc.map(formatAddress).join(", ")
- if (input.replyTo.length) headers["Reply-To"] = input.replyTo.map(formatAddress).join(", ")
- if (input.headers) {
- for (const [k, v] of Object.entries(input.headers)) headers[k] = v
- }
-
- const body = hasAttachments
- ? buildMultipartMixed(input, boundary, altBoundary, hasBothBodies, headers)
- : hasBothBodies
- ? buildMultipartAlternative(input, altBoundary, headers)
- : buildSinglePart(input, headers)
-
- const rendered = renderHeaders(headers) + "\r\n" + body
-
- return {
- envelope: {
- from: input.from.email,
- rcpt: dedupe([...input.to, ...input.cc, ...input.bcc].map((a) => a.email)),
- },
- headers,
- body: rendered,
- }
-}
-
-function renderHeaders(headers: Record): string {
- const lines: string[] = []
- for (const [name, value] of Object.entries(headers)) {
- if (value === "") continue
- lines.push(`${name}: ${foldHeader(value)}`)
- }
- return lines.join("\r\n") + "\r\n"
-}
-
-function buildSinglePart(input: MimeInput, headers: Record): string {
- if (input.html) {
- headers["Content-Type"] = "text/html; charset=utf-8"
- headers["Content-Transfer-Encoding"] = "quoted-printable"
- return encodeQuotedPrintable(input.html)
- }
- headers["Content-Type"] = "text/plain; charset=utf-8"
- headers["Content-Transfer-Encoding"] = "quoted-printable"
- return encodeQuotedPrintable(input.text ?? "")
-}
-
-function buildMultipartAlternative(
- input: MimeInput,
- boundary: string,
- headers: Record,
-): string {
- headers["Content-Type"] = `multipart/alternative; boundary="${boundary}"`
- const parts: string[] = []
- if (input.text) {
- parts.push(
- [
- `--${boundary}`,
- "Content-Type: text/plain; charset=utf-8",
- "Content-Transfer-Encoding: quoted-printable",
- "",
- encodeQuotedPrintable(input.text),
- ].join("\r\n"),
- )
- }
- if (input.amp) {
- parts.push(
- [
- `--${boundary}`,
- "Content-Type: text/x-amp-html; charset=utf-8",
- "Content-Transfer-Encoding: quoted-printable",
- "",
- encodeQuotedPrintable(input.amp),
- ].join("\r\n"),
- )
- }
- if (input.html) {
- parts.push(
- [
- `--${boundary}`,
- "Content-Type: text/html; charset=utf-8",
- "Content-Transfer-Encoding: quoted-printable",
- "",
- encodeQuotedPrintable(input.html),
- ].join("\r\n"),
- )
- }
- parts.push(`--${boundary}--`)
- return parts.join("\r\n")
-}
-
-function buildMultipartMixed(
- input: MimeInput,
- outerBoundary: string,
- altBoundary: string,
- hasBothBodies: boolean,
- headers: Record,
-): string {
- headers["Content-Type"] = `multipart/mixed; boundary="${outerBoundary}"`
- const parts: string[] = []
-
- const altHeaders: Record = {}
- const bodyPart = hasBothBodies
- ? buildMultipartAlternative(input, altBoundary, altHeaders)
- : buildSinglePart(input, altHeaders)
-
- parts.push(
- [
- `--${outerBoundary}`,
- `Content-Type: ${altHeaders["Content-Type"] ?? "text/plain; charset=utf-8"}`,
- ...(altHeaders["Content-Transfer-Encoding"]
- ? [`Content-Transfer-Encoding: ${altHeaders["Content-Transfer-Encoding"]}`]
- : []),
- "",
- bodyPart,
- ].join("\r\n"),
- )
-
- for (const a of input.attachments ?? []) {
- parts.push(renderAttachment(outerBoundary, a))
- }
- parts.push(`--${outerBoundary}--`)
- return parts.join("\r\n")
-}
-
-function renderAttachment(boundary: string, a: Attachment): string {
- const base64 =
- typeof a.content === "string"
- ? isLikelyBase64(a.content)
- ? a.content
- : toBase64FromString(a.content)
- : toBase64FromBytes(a.content)
- const folded = foldBase64(base64)
- const contentType = a.contentType ?? "application/octet-stream"
- const disposition = a.disposition ?? "attachment"
- const lines = [
- `--${boundary}`,
- `Content-Type: ${contentType}; name="${encodeHeader(a.filename)}"`,
- "Content-Transfer-Encoding: base64",
- `Content-Disposition: ${disposition}; filename="${encodeHeader(a.filename)}"`,
- ]
- if (a.cid) lines.push(`Content-ID: <${a.cid}>`)
- lines.push("", folded)
- return lines.join("\r\n")
-}
-
-/** Dot-stuff a body for DATA transmission per RFC 5321 §4.5.2. Lines that
- * begin with `.` get an extra `.` prepended so the sequence `\r\n.\r\n`
- * never appears inside the payload. Returns a single string with CRLF
- * line endings. */
-export function dotStuff(body: string): string {
- const crlfBody = body.replace(/\r?\n/g, "\r\n")
- return crlfBody.replace(/(^|\r\n)(\.)/g, "$1.$2")
-}
-
-function foldHeader(value: string, max = 76): string {
- if (value.length <= max) return value
- const words = value.split(" ")
- const lines: string[] = []
- let current = ""
- for (const word of words) {
- if (current.length + word.length + 1 > max) {
- lines.push(current)
- current = ` ${word}`
- } else {
- current = current ? `${current} ${word}` : word
- }
- }
- if (current) lines.push(current)
- return lines.join("\r\n")
-}
-
-function encodeHeader(value: string): string {
- if (/^[\x20-\x7E]*$/.test(value)) return value
- const b64 = toBase64FromString(value)
- return `=?utf-8?B?${b64}?=`
-}
-
-function encodeQuotedPrintable(input: string): string {
- const out: string[] = []
- for (const ch of input) {
- const code = ch.codePointAt(0)!
- if (ch === "\n") {
- out.push("\r\n")
- continue
- }
- if (ch === "\r") continue
- if (code === 0x20 || code === 0x09) {
- out.push(ch)
- continue
- }
- if (code >= 0x21 && code <= 0x7e && ch !== "=") {
- out.push(ch)
- continue
- }
- const bytes = new TextEncoder().encode(ch)
- for (const b of bytes) out.push(`=${b.toString(16).toUpperCase().padStart(2, "0")}`)
- }
- return softWrap(out.join(""), 76)
-}
-
-function softWrap(input: string, max: number): string {
- const lines = input.split(/\r\n/)
- return lines
- .map((line) => {
- if (line.length <= max) return line
- const out: string[] = []
- let rest = line
- while (rest.length > max - 1) {
- let cut = max - 1
- while (cut > 0 && (rest[cut - 1] === "=" || (cut >= 2 && rest[cut - 2] === "="))) cut--
- out.push(`${rest.slice(0, cut)}=`)
- rest = rest.slice(cut)
- }
- out.push(rest)
- return out.join("\r\n")
- })
- .join("\r\n")
-}
-
-function toBase64FromString(value: string): string {
- const bytes = new TextEncoder().encode(value)
- return toBase64FromBytes(bytes)
-}
-
-function toBase64FromBytes(bytes: Uint8Array): string {
- const g = globalThis as {
- Buffer?: { from: (b: Uint8Array) => { toString: (enc: string) => string } }
- }
- if (g.Buffer) return g.Buffer.from(bytes).toString("base64")
- let binary = ""
- for (const byte of bytes) binary += String.fromCharCode(byte)
- return btoa(binary)
-}
-
-function isLikelyBase64(value: string): boolean {
- return /^[A-Za-z0-9+/=\r\n]+$/.test(value) && value.length > 0 && value.length % 4 === 0
-}
-
-function foldBase64(b64: string, width = 76): string {
- const chunks: string[] = []
- for (let i = 0; i < b64.length; i += width) chunks.push(b64.slice(i, i + width))
- return chunks.join("\r\n")
-}
-
-function randomBoundary(): string {
- return Math.random().toString(36).slice(2, 12) + Date.now().toString(36)
-}
-
-function dedupe(values: string[]): string[] {
- return [...new Set(values)]
-}
diff --git a/src/driver/brevo.ts b/src/driver/brevo.ts
deleted file mode 100644
index baf56e1..0000000
--- a/src/driver/brevo.ts
+++ /dev/null
@@ -1,123 +0,0 @@
-import type {
- Attachment,
- DriverFactory,
- EmailAddress,
- EmailMessage,
- EmailResult,
- Result,
-} from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { normalizeAddresses } from "../_normalize.ts"
-import { createError, createRequiredError } from "../errors.ts"
-import { httpJson } from "./_http.ts"
-
-export interface BrevoDriverOptions {
- apiKey: string
- endpoint?: string
- fetch?: typeof fetch
-}
-
-const DRIVER = "brevo"
-
-const brevo: DriverFactory = defineDriver((options) => {
- if (!options?.apiKey) throw createRequiredError(DRIVER, "apiKey")
- const endpoint = options.endpoint ?? "https://api.brevo.com"
- const fetchImpl = options.fetch ?? globalThis.fetch
- if (typeof fetchImpl !== "function")
- throw createError(DRIVER, "INVALID_OPTIONS", "fetch is unavailable; pass `fetch` explicitly")
-
- return {
- name: DRIVER,
- options,
- flags: {
- html: true,
- text: true,
- attachments: true,
- tagging: true,
- tracking: true,
- replyTo: true,
- customHeaders: true,
- scheduling: true,
- templates: true,
- },
-
- async isAvailable() {
- return Boolean(options.apiKey)
- },
-
- async send(msg) {
- const payload = buildBrevoPayload(msg)
- const res = await httpJson({
- fetch: fetchImpl,
- driver: DRIVER,
- url: `${endpoint}/v3/smtp/email`,
- headers: { "api-key": options.apiKey },
- body: payload,
- })
- if (res.error) return res as Result
- const body = (res.data ?? {}) as { messageId?: string }
- return {
- data: {
- id: body.messageId ?? `brevo_${Date.now().toString(36)}`,
- driver: DRIVER,
- at: new Date(),
- provider: body as Record,
- },
- error: null,
- }
- },
- }
-})
-
-export default brevo
-
-function buildBrevoPayload(msg: EmailMessage): Record {
- const from = normalizeAddresses(msg.from)[0]
- if (!from) throw createError(DRIVER, "INVALID_OPTIONS", "`from` is required")
-
- const payload: Record = {
- sender: toBrevoAddress(from),
- to: normalizeAddresses(msg.to).map(toBrevoAddress),
- subject: msg.subject,
- }
- if (msg.cc) payload.cc = normalizeAddresses(msg.cc).map(toBrevoAddress)
- if (msg.bcc) payload.bcc = normalizeAddresses(msg.bcc).map(toBrevoAddress)
- if (msg.replyTo) {
- const r = normalizeAddresses(msg.replyTo)[0]
- if (r) payload.replyTo = toBrevoAddress(r)
- }
- if (msg.text) payload.textContent = msg.text
- if (msg.html) payload.htmlContent = msg.html
- if (msg.headers) payload.headers = msg.headers
- if (msg.tags?.length) payload.tags = msg.tags.map((t) => t.name)
- if (msg.scheduledAt) {
- const d = msg.scheduledAt instanceof Date ? msg.scheduledAt : new Date(msg.scheduledAt)
- payload.scheduledAt = d.toISOString()
- }
- if (msg.attachments?.length) payload.attachment = msg.attachments.map(toBrevoAttachment)
- if (msg.template) {
- if (msg.template.id)
- payload.templateId = Number.parseInt(msg.template.id, 10) || msg.template.id
- if (msg.template.variables) payload.params = { ...msg.template.variables }
- }
- return payload
-}
-
-function toBrevoAddress(a: EmailAddress): Record {
- return a.name ? { email: a.email, name: a.name } : { email: a.email }
-}
-
-function toBrevoAttachment(a: Attachment): Record {
- const content = typeof a.content === "string" ? a.content : bytesToBase64(a.content)
- return { name: a.filename, content }
-}
-
-function bytesToBase64(bytes: Uint8Array): string {
- const g = globalThis as {
- Buffer?: { from: (b: Uint8Array) => { toString: (e: string) => string } }
- }
- if (g.Buffer) return g.Buffer.from(bytes).toString("base64")
- let binary = ""
- for (const byte of bytes) binary += String.fromCharCode(byte)
- return btoa(binary)
-}
diff --git a/src/driver/cloudflare-email-service.ts b/src/driver/cloudflare-email-service.ts
deleted file mode 100644
index cebd548..0000000
--- a/src/driver/cloudflare-email-service.ts
+++ /dev/null
@@ -1,185 +0,0 @@
-import type {
- Attachment,
- DriverFactory,
- EmailAddress,
- EmailErrorCode,
- EmailResult,
- Result,
-} from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { createError, createRequiredError, toEmailError } from "../errors.ts"
-import { normalizeAddresses } from "../_normalize.ts"
-
-/** Cloudflare **Email Service** (Email Sending) outbound binding.
- *
- * Distinct from `unemail/driver/cloudflare-email`, which targets the older
- * **Email Routing** API: that one constructs `EmailMessage` from the virtual
- * `cloudflare:email` module and hands the binding raw RFC 5322 text. Email
- * Service takes structured fields on the same `send_email` binding, so this
- * driver needs no ambient global, no virtual module, and no MIME builder.
- * Both are kept — pick the one matching the API your binding speaks.
- *
- * ```ts
- * export default {
- * async fetch(req, env) {
- * const email = createEmail({ driver: cloudflareEmailService({ binding: env.EMAIL }) })
- * await email.send({ from, to, subject, html, text })
- * }
- * }
- * ```
- *
- * Requires a `send_email` binding in `wrangler.jsonc` and a sender domain
- * onboarded via `wrangler email sending enable `. */
-export interface CloudflareEmailServiceDriverOptions {
- binding: CloudflareEmailServiceBinding
-}
-
-export interface CloudflareEmailServiceBinding {
- send: (message: CloudflareEmailServiceMessage) => Promise
-}
-
-/** Structured payload accepted by the binding. Declared locally so the driver
- * depends on neither `@cloudflare/workers-types` nor `cloudflare:email` —
- * when those types are available, prefer them at the call site. */
-export interface CloudflareEmailServiceMessage {
- from: EmailAddress
- to: EmailAddress[]
- subject: string
- text?: string
- html?: string
- cc?: EmailAddress[]
- bcc?: EmailAddress[]
- replyTo?: EmailAddress
- headers?: Record
- attachments?: CloudflareEmailServiceAttachment[]
-}
-
-export interface CloudflareEmailServiceAttachment {
- content: string | Uint8Array
- filename: string
- type: string
- disposition: "attachment" | "inline"
- contentId?: string
-}
-
-export interface CloudflareEmailSendResult {
- messageId?: string
-}
-
-const DRIVER = "cloudflare-email-service"
-
-/** The binding throws `Error`s carrying an `E_*` `code`. Map them onto our
- * taxonomy so `retryable` is meaningful — otherwise the retry middleware
- * would keep re-sending messages that a validation fix, not a retry, cures. */
-const ERROR_CODES: Record = {
- E_VALIDATION_ERROR: "INVALID_OPTIONS",
- E_FIELD_MISSING: "INVALID_OPTIONS",
- E_TOO_MANY_RECIPIENTS: "INVALID_OPTIONS",
- E_TOO_MANY_ATTACHMENTS: "INVALID_OPTIONS",
- E_CONTENT_TOO_LARGE: "INVALID_OPTIONS",
- E_HEADER_NOT_ALLOWED: "INVALID_OPTIONS",
- E_HEADER_USE_API_FIELD: "INVALID_OPTIONS",
- E_HEADER_VALUE_INVALID: "INVALID_OPTIONS",
- E_HEADER_VALUE_TOO_LONG: "INVALID_OPTIONS",
- E_HEADER_NAME_INVALID: "INVALID_OPTIONS",
- E_HEADERS_TOO_LARGE: "INVALID_OPTIONS",
- E_HEADERS_TOO_MANY: "INVALID_OPTIONS",
- E_SENDER_NOT_VERIFIED: "AUTH",
- E_SENDER_DOMAIN_NOT_AVAILABLE: "AUTH",
- E_RECIPIENT_NOT_ALLOWED: "AUTH",
- E_RECIPIENT_SUPPRESSED: "PROVIDER",
- E_RATE_LIMIT_EXCEEDED: "RATE_LIMIT",
- E_DAILY_LIMIT_EXCEEDED: "RATE_LIMIT",
- E_DELIVERY_FAILED: "NETWORK",
- E_INTERNAL_SERVER_ERROR: "NETWORK",
-}
-
-function toDriverError(err: unknown) {
- const code = ERROR_CODES[String((err as { code?: unknown })?.code ?? "")]
- if (!code) return toEmailError(DRIVER, err)
- return createError(DRIVER, code, (err as Error).message, { cause: err })
-}
-
-/** The binding validates every key it receives, so `name` is left out
- * entirely rather than sent as `undefined`. */
-function toAddress(addr: EmailAddress): EmailAddress {
- return addr.name ? { email: addr.email, name: addr.name } : { email: addr.email }
-}
-
-/** Email Service takes structured attachments rather than MIME parts, so the
- * mapping is a rename: `contentType` → `type`, `cid` → `contentId`. */
-function toCloudflareAttachment(file: Attachment): CloudflareEmailServiceAttachment {
- const out: CloudflareEmailServiceAttachment = {
- content: file.content,
- filename: file.filename,
- type: file.contentType ?? "application/octet-stream",
- disposition: file.disposition ?? (file.cid ? "inline" : "attachment"),
- }
- if (file.cid) out.contentId = file.cid
- return out
-}
-
-const cloudflareEmailService: DriverFactory =
- defineDriver((options) => {
- if (!options?.binding) throw createRequiredError(DRIVER, "binding")
-
- return {
- name: DRIVER,
- options,
- flags: {
- html: true,
- text: true,
- attachments: true,
- customHeaders: true,
- replyTo: true,
- },
-
- async isAvailable() {
- return true
- },
-
- async send(msg): Promise> {
- try {
- const from = normalizeAddresses(msg.from)[0]
- const to = normalizeAddresses(msg.to).map(toAddress)
- if (!from || !to.length)
- return {
- data: null,
- error: createError(DRIVER, "INVALID_OPTIONS", "`from` and `to` are required"),
- }
-
- const cc = normalizeAddresses(msg.cc).map(toAddress)
- const bcc = normalizeAddresses(msg.bcc).map(toAddress)
- const replyTo = normalizeAddresses(msg.replyTo)[0]
-
- const result = await options.binding.send({
- from: toAddress(from),
- to,
- subject: msg.subject,
- text: msg.text,
- html: msg.html,
- cc: cc.length ? cc : undefined,
- bcc: bcc.length ? bcc : undefined,
- replyTo: replyTo ? toAddress(replyTo) : undefined,
- headers: msg.headers,
- attachments: msg.attachments?.length
- ? msg.attachments.map(toCloudflareAttachment)
- : undefined,
- })
-
- return {
- data: {
- id: result?.messageId ?? "",
- driver: DRIVER,
- at: new Date(),
- },
- error: null,
- }
- } catch (err) {
- return { data: null, error: toDriverError(err) }
- }
- },
- }
- })
-
-export default cloudflareEmailService
diff --git a/src/driver/cloudflare-email.ts b/src/driver/cloudflare-email.ts
deleted file mode 100644
index ddb2111..0000000
--- a/src/driver/cloudflare-email.ts
+++ /dev/null
@@ -1,95 +0,0 @@
-import type { DriverFactory, EmailResult, Result } from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { buildMime, normalizeMimeInput } from "./_smtp/mime.ts"
-import { createError, createRequiredError, toEmailError } from "../errors.ts"
-import { normalizeAddresses } from "../_normalize.ts"
-
-/** Cloudflare Email Workers outbound binding. Instantiate with the binding
- * object defined in your \`wrangler.toml\` (\`send_email\` rule):
- *
- * ```ts
- * export default {
- * async fetch(req, env) {
- * const email = createEmail({ driver: cloudflareEmail({ binding: env.SEND_EMAIL }) })
- * await email.send({ from, to, subject, text })
- * }
- * }
- * ```
- *
- * The binding accepts a constructed \`EmailMessage\` (see Cloudflare docs —
- * the SDK exposes \`new EmailMessage(from, to, raw)\` via the global
- * \`postalmime\` bindings); we build raw RFC 5322 text ourselves. */
-export interface CloudflareEmailDriverOptions {
- binding: CloudflareEmailBinding
- /** Optional factory for the \`EmailMessage\` class. Defaults to
- * \`globalThis.EmailMessage\`, which Workers injects at runtime. */
- EmailMessage?: CloudflareEmailMessageCtor
-}
-
-export interface CloudflareEmailBinding {
- send: (message: unknown) => Promise | void
-}
-
-export type CloudflareEmailMessageCtor = new (from: string, to: string, raw: string) => unknown
-
-const DRIVER = "cloudflare-email"
-
-const cloudflareEmail: DriverFactory =
- defineDriver((options) => {
- if (!options?.binding) throw createRequiredError(DRIVER, "binding")
- const Ctor =
- options.EmailMessage ??
- (globalThis as { EmailMessage?: CloudflareEmailMessageCtor }).EmailMessage
- if (!Ctor)
- throw createError(
- DRIVER,
- "INVALID_OPTIONS",
- "EmailMessage constructor is unavailable; pass it via options when not running on Cloudflare Workers",
- )
-
- return {
- name: DRIVER,
- options,
- flags: {
- html: true,
- text: true,
- attachments: true,
- customHeaders: true,
- replyTo: true,
- },
-
- async isAvailable() {
- return true
- },
-
- async send(msg): Promise> {
- try {
- const from = normalizeAddresses(msg.from)[0]
- const to = normalizeAddresses(msg.to)[0]
- if (!from || !to)
- return {
- data: null,
- error: createError(DRIVER, "INVALID_OPTIONS", "`from` and `to` are required"),
- }
- const messageId =
- msg.headers?.["Message-ID"] ??
- `<${Date.now().toString(36)}.${Math.random().toString(36).slice(2)}@cloudflare-email>`
- const mime = buildMime(normalizeMimeInput(msg, messageId))
- const message = new Ctor(from.email, to.email, mime.body)
- await options.binding.send(message)
- return {
- data: {
- id: messageId,
- driver: DRIVER,
- at: new Date(),
- },
- error: null,
- }
- } catch (err) {
- return { data: null, error: toEmailError(DRIVER, err) }
- }
- },
- }
- })
-
-export default cloudflareEmail
diff --git a/src/driver/fallback.ts b/src/driver/fallback.ts
deleted file mode 100644
index d5d1deb..0000000
--- a/src/driver/fallback.ts
+++ /dev/null
@@ -1,61 +0,0 @@
-import type { DriverFactory, EmailDriver } from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { createError, toEmailError } from "../errors.ts"
-
-/** Try each wrapped driver in order; move on to the next when the current
- * one returns a retryable error. Non-retryable errors short-circuit.
- *
- * ```ts
- * createEmail({ driver: fallback([resend({...}), ses({...})]) })
- * ```
- */
-export interface FallbackOptions {
- drivers: ReadonlyArray
- /** Override the "is this error worth moving on for" check. */
- shouldAdvance?: (error: NonNullable>["error"]>) => boolean
-}
-
-const fallback: DriverFactory = defineDriver((options) => {
- if (!options || options.drivers.length === 0)
- throw createError("fallback", "INVALID_OPTIONS", "at least one driver is required")
- const drivers = options.drivers
- const shouldAdvance = options.shouldAdvance ?? ((err) => err.retryable)
-
- return {
- name: "fallback",
- options,
- async send(msg, ctx) {
- let lastError: ReturnType | null = null
- for (const driver of drivers) {
- ctx.driver = driver.name
- try {
- const result = await driver.send(msg, ctx)
- if (result.data) return result
- lastError = result.error
- if (!shouldAdvance(result.error)) return result
- } catch (thrown) {
- lastError = toEmailError(driver.name, thrown)
- }
- }
- return {
- data: null,
- error: lastError ?? createError("fallback", "PROVIDER", "all drivers failed"),
- }
- },
- async initialize() {
- await Promise.all(drivers.map((d) => d.initialize?.()))
- },
- async dispose() {
- await Promise.all(drivers.map((d) => d.dispose?.()))
- },
- async isAvailable() {
- for (const d of drivers) {
- if (!d.isAvailable) return true
- if (await d.isAvailable()) return true
- }
- return false
- },
- }
-})
-
-export default fallback
diff --git a/src/driver/http.ts b/src/driver/http.ts
deleted file mode 100644
index 5ef7fbb..0000000
--- a/src/driver/http.ts
+++ /dev/null
@@ -1,146 +0,0 @@
-import type {
- Attachment,
- DriverFactory,
- EmailAddress,
- EmailMessage,
- EmailResult,
- Result,
-} from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { formatAddress, normalizeAddresses } from "../_normalize.ts"
-import { createError, createRequiredError } from "../errors.ts"
-import { httpJson } from "./_http.ts"
-
-/** Options for the generic `http` driver — useful for proxying through
- * your own endpoint (a Next.js route handler, a hosted worker, a test
- * harness, anything JSON-shaped). */
-export interface HttpDriverOptions {
- /** The POST target. */
- endpoint: string
- /** HTTP method. Defaults to POST. */
- method?: string
- /** Bearer token sent as `Authorization: Bearer ` when set. */
- apiKey?: string
- /** Extra headers merged on every request. */
- headers?: Record
- /** Transform the normalized message into the payload shape your API
- * expects. The default emits a sensible object similar to Resend's
- * public shape. */
- transform?: (msg: EmailMessage) => unknown
- /** Extract the provider-assigned id from the response body. Default:
- * looks at \`id\`, \`messageId\`, \`data.id\`, \`data.messageId\`. */
- extractId?: (body: unknown) => string | null
- /** Injected fetch — defaults to global \`fetch\`. */
- fetch?: typeof fetch
-}
-
-const DRIVER = "http"
-
-const http: DriverFactory = defineDriver((options) => {
- if (!options?.endpoint) throw createRequiredError(DRIVER, "endpoint")
- const fetchImpl = options.fetch ?? globalThis.fetch
- if (typeof fetchImpl !== "function")
- throw createError(DRIVER, "INVALID_OPTIONS", "fetch is unavailable; pass `fetch` explicitly")
-
- const transform = options.transform ?? defaultTransform
- const extractId = options.extractId ?? defaultExtractId
-
- return {
- name: DRIVER,
- options,
- flags: {
- html: true,
- text: true,
- attachments: true,
- replyTo: true,
- customHeaders: true,
- },
-
- async isAvailable() {
- return true
- },
-
- async send(msg) {
- const payload = transform(msg)
- const headers: Record = { ...options.headers }
- if (options.apiKey) headers.authorization = `Bearer ${options.apiKey}`
- const res = await httpJson({
- fetch: fetchImpl,
- driver: DRIVER,
- url: options.endpoint,
- method: options.method ?? "POST",
- headers,
- body: payload,
- })
- if (res.error) return res as Result
- const id = extractId(res.data) ?? synthId()
- return {
- data: {
- id,
- driver: DRIVER,
- at: new Date(),
- provider: (res.data ?? null) as Record | undefined,
- },
- error: null,
- }
- },
- }
-})
-
-export default http
-
-function defaultTransform(msg: EmailMessage): Record {
- const from = normalizeAddresses(msg.from)[0]
- const out: Record = {
- from: from ? formatAddress(from) : undefined,
- to: normalizeAddresses(msg.to).map((a: EmailAddress) => formatAddress(a)),
- subject: msg.subject,
- }
- if (msg.cc) out.cc = normalizeAddresses(msg.cc).map(formatAddress)
- if (msg.bcc) out.bcc = normalizeAddresses(msg.bcc).map(formatAddress)
- if (msg.replyTo) out.replyTo = normalizeAddresses(msg.replyTo).map(formatAddress)
- if (msg.text) out.text = msg.text
- if (msg.html) out.html = msg.html
- if (msg.headers) out.headers = msg.headers
- if (msg.attachments?.length) out.attachments = msg.attachments.map(toAttachmentPayload)
- return out
-}
-
-function toAttachmentPayload(a: Attachment): Record {
- const content = typeof a.content === "string" ? a.content : bytesToBase64(a.content)
- const out: Record = {
- filename: a.filename,
- content,
- }
- if (a.contentType) out.contentType = a.contentType
- if (a.disposition) out.disposition = a.disposition
- if (a.cid) out.cid = a.cid
- return out
-}
-
-function defaultExtractId(body: unknown): string | null {
- if (!body || typeof body !== "object") return null
- const r = body as Record
- if (typeof r.id === "string") return r.id
- if (typeof r.messageId === "string") return r.messageId
- if (r.data && typeof r.data === "object") {
- const inner = r.data as Record
- if (typeof inner.id === "string") return inner.id
- if (typeof inner.messageId === "string") return inner.messageId
- }
- return null
-}
-
-function synthId(): string {
- return `http_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`
-}
-
-function bytesToBase64(bytes: Uint8Array): string {
- const g = globalThis as {
- Buffer?: { from: (b: Uint8Array) => { toString: (e: string) => string } }
- }
- if (g.Buffer) return g.Buffer.from(bytes).toString("base64")
- let binary = ""
- for (const byte of bytes) binary += String.fromCharCode(byte)
- return btoa(binary)
-}
diff --git a/src/driver/loops.ts b/src/driver/loops.ts
deleted file mode 100644
index 127abaf..0000000
--- a/src/driver/loops.ts
+++ /dev/null
@@ -1,93 +0,0 @@
-import type { DriverFactory, EmailResult, Result } from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { normalizeAddresses } from "../_normalize.ts"
-import { createError, createRequiredError } from "../errors.ts"
-import { httpJson } from "./_http.ts"
-
-/** The Loops transactional API takes \`transactionalId\` + \`email\` + \`dataVariables\`.
- * Map from our \`EmailMessage\`: \`headers["x-loops-transactional-id"]\` or
- * the driver's default \`transactionalId\` option carries the id;
- * \`dataVariables\` come from \`msg.tags\` (repurposed as vars since Loops
- * doesn't have free-form tag support). */
-export interface LoopsDriverOptions {
- apiKey: string
- /** Default Loops transactionalId if the message doesn't specify one. */
- transactionalId?: string
- endpoint?: string
- fetch?: typeof fetch
-}
-
-const DRIVER = "loops"
-
-const loops: DriverFactory = defineDriver((options) => {
- if (!options?.apiKey) throw createRequiredError(DRIVER, "apiKey")
- const endpoint = options.endpoint ?? "https://app.loops.so"
- const fetchImpl = options.fetch ?? globalThis.fetch
- if (typeof fetchImpl !== "function")
- throw createError(DRIVER, "INVALID_OPTIONS", "fetch is unavailable; pass `fetch` explicitly")
-
- return {
- name: DRIVER,
- options,
- flags: {
- templates: true,
- tracking: true,
- tagging: true,
- },
-
- async isAvailable() {
- return Boolean(options.apiKey)
- },
-
- async send(msg) {
- const transactionalId =
- msg.template?.id ?? msg.headers?.["x-loops-transactional-id"] ?? options.transactionalId
- if (!transactionalId) {
- return {
- data: null,
- error: createError(
- DRIVER,
- "INVALID_OPTIONS",
- "transactionalId is required: pass via msg.template.id, headers['x-loops-transactional-id'] or driver options",
- ),
- }
- }
- const to = normalizeAddresses(msg.to)[0]
- if (!to) {
- return {
- data: null,
- error: createError(DRIVER, "INVALID_OPTIONS", "`to` is required"),
- }
- }
- const dataVariables: Record = {
- ...msg.template?.variables,
- }
- for (const t of msg.tags ?? []) dataVariables[t.name] = t.value
-
- const res = await httpJson({
- fetch: fetchImpl,
- driver: DRIVER,
- url: `${endpoint}/api/v1/transactional`,
- headers: { authorization: `Bearer ${options.apiKey}` },
- body: {
- transactionalId,
- email: to.email,
- dataVariables,
- },
- })
- if (res.error) return res as Result
- const body = (res.data ?? {}) as { success?: boolean }
- return {
- data: {
- id: `loops_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`,
- driver: DRIVER,
- at: new Date(),
- provider: body as Record,
- },
- error: null,
- }
- },
- }
-})
-
-export default loops
diff --git a/src/driver/mailchannels.ts b/src/driver/mailchannels.ts
deleted file mode 100644
index 29630ae..0000000
--- a/src/driver/mailchannels.ts
+++ /dev/null
@@ -1,139 +0,0 @@
-import type {
- Attachment,
- DriverFactory,
- EmailAddress,
- EmailMessage,
- EmailResult,
- Result,
-} from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { normalizeAddresses } from "../_normalize.ts"
-import { createError } from "../errors.ts"
-import { httpJson } from "./_http.ts"
-
-/** MailChannels — free transactional send from Cloudflare Workers (no auth
- * needed when running inside a CF Worker; requires SPF/DKIM configured
- * for your sending domain). Outside Workers you need an API key. */
-export interface MailChannelsDriverOptions {
- /** Required when not running inside a Cloudflare Worker. */
- apiKey?: string
- /** DKIM signing for non-Worker usage. */
- dkim?: {
- domain: string
- selector: string
- privateKey: string
- }
- endpoint?: string
- fetch?: typeof fetch
-}
-
-const DRIVER = "mailchannels"
-
-const mailchannels: DriverFactory =
- defineDriver((options = {}) => {
- const endpoint = options.endpoint ?? "https://api.mailchannels.net"
- const fetchImpl = options.fetch ?? globalThis.fetch
- if (typeof fetchImpl !== "function")
- throw createError(DRIVER, "INVALID_OPTIONS", "fetch is unavailable; pass `fetch` explicitly")
-
- return {
- name: DRIVER,
- options,
- flags: {
- html: true,
- text: true,
- attachments: true,
- replyTo: true,
- customHeaders: true,
- },
-
- async isAvailable() {
- return true
- },
-
- async send(msg) {
- const payload = buildMailChannelsPayload(msg, options)
- const headers: Record = {}
- if (options.apiKey) headers["x-api-key"] = options.apiKey
- const res = await httpJson({
- fetch: fetchImpl,
- driver: DRIVER,
- url: `${endpoint}/tx/v1/send`,
- headers,
- body: payload,
- })
- if (res.error) return res as Result
- return {
- data: {
- id: `mc_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`,
- driver: DRIVER,
- at: new Date(),
- provider: (res.data as Record | null) ?? undefined,
- },
- error: null,
- }
- },
- }
- })
-
-export default mailchannels
-
-function buildMailChannelsPayload(
- msg: EmailMessage,
- options: MailChannelsDriverOptions,
-): Record {
- const from = normalizeAddresses(msg.from)[0]
- if (!from) throw createError(DRIVER, "INVALID_OPTIONS", "`from` is required")
-
- const personalization: Record = {
- to: normalizeAddresses(msg.to).map(toMcAddress),
- }
- if (msg.cc) personalization.cc = normalizeAddresses(msg.cc).map(toMcAddress)
- if (msg.bcc) personalization.bcc = normalizeAddresses(msg.bcc).map(toMcAddress)
- if (msg.headers) personalization.headers = msg.headers
- if (options.dkim) {
- personalization.dkim_domain = options.dkim.domain
- personalization.dkim_selector = options.dkim.selector
- personalization.dkim_private_key = options.dkim.privateKey
- }
-
- const content: Array> = []
- if (msg.text) content.push({ type: "text/plain", value: msg.text })
- if (msg.html) content.push({ type: "text/html", value: msg.html })
-
- const payload: Record = {
- personalizations: [personalization],
- from: toMcAddress(from),
- subject: msg.subject,
- content,
- }
- if (msg.replyTo) {
- const r = normalizeAddresses(msg.replyTo)[0]
- if (r) payload.reply_to = toMcAddress(r)
- }
- if (msg.attachments?.length) payload.attachments = msg.attachments.map(toMcAttachment)
- return payload
-}
-
-function toMcAddress(a: EmailAddress): Record {
- return a.name ? { email: a.email, name: a.name } : { email: a.email }
-}
-
-function toMcAttachment(a: Attachment): Record {
- const content = typeof a.content === "string" ? a.content : bytesToBase64(a.content)
- return {
- filename: a.filename,
- content,
- type: a.contentType ?? "application/octet-stream",
- }
-}
-
-function bytesToBase64(bytes: Uint8Array): string {
- const g = globalThis as {
- Buffer?: { from: (b: Uint8Array) => { toString: (e: string) => string } }
- }
- if (g.Buffer) return g.Buffer.from(bytes).toString("base64")
- let binary = ""
- for (const byte of bytes) binary += String.fromCharCode(byte)
- return btoa(binary)
-}
diff --git a/src/driver/mailcrab.ts b/src/driver/mailcrab.ts
deleted file mode 100644
index 60e0bd3..0000000
--- a/src/driver/mailcrab.ts
+++ /dev/null
@@ -1,56 +0,0 @@
-import type { DriverFactory } from "../types.ts"
-import type { SmtpDriverOptions } from "./smtp.ts"
-import { defineDriver } from "../_define.ts"
-import smtp from "./smtp.ts"
-
-/** MailCrab is a local SMTP sink (the \`unemail-mailcrab\` CLI spins it up
- * via docker). This driver is a thin wrapper over the SMTP driver with
- * MailCrab-friendly defaults so \`createEmail({ driver: mailcrab() })\`
- * Just Works in dev.
- *
- * The web UI lives at \`http://localhost:1080\` — a one-liner pointer is
- * printed on first use so new users find it fast. */
-export interface MailCrabDriverOptions extends Partial {
- /** Defaults to \`localhost\`. */
- host?: string
- /** Defaults to \`1025\` (MailCrab's SMTP port). */
- port?: number
- /** Web UI port, used only for the on-first-send help message. Default 1080. */
- uiPort?: number
- /** Silence the "see messages at …" hint. Default \`false\`. */
- quiet?: boolean
-}
-
-const mailcrab: DriverFactory = defineDriver(
- (options = {}) => {
- const host = options.host ?? "localhost"
- const port = options.port ?? 1025
- const uiPort = options.uiPort ?? 1080
- const delegate = smtp({
- ...options,
- host,
- port,
- secure: false,
- rejectUnauthorized: false,
- commandTimeoutMs: options.commandTimeoutMs ?? 5000,
- connectionTimeoutMs: options.connectionTimeoutMs ?? 5000,
- })
- let hinted = false
-
- return {
- ...delegate,
- name: "mailcrab",
- async send(msg, ctx) {
- if (!hinted && !options.quiet) {
- hinted = true
- console.info(`[unemail] [mailcrab] inspecting messages at http://${host}:${uiPort}`)
- }
- const result = await delegate.send(msg, ctx)
- if (result.data) return { data: { ...result.data, driver: "mailcrab" }, error: null }
- return result
- },
- }
- },
-)
-
-export default mailcrab
diff --git a/src/driver/mailersend.ts b/src/driver/mailersend.ts
deleted file mode 100644
index 6c77e6d..0000000
--- a/src/driver/mailersend.ts
+++ /dev/null
@@ -1,159 +0,0 @@
-import type {
- Attachment,
- DriverFactory,
- EmailAddress,
- EmailMessage,
- EmailResult,
- Result,
-} from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { normalizeAddresses } from "../_normalize.ts"
-import { createError, createRequiredError } from "../errors.ts"
-import { httpJson } from "./_http.ts"
-
-export interface MailerSendDriverOptions {
- apiKey: string
- endpoint?: string
- fetch?: typeof fetch
-}
-
-const DRIVER = "mailersend"
-
-const mailersend: DriverFactory = defineDriver(
- (options) => {
- if (!options?.apiKey) throw createRequiredError(DRIVER, "apiKey")
- const endpoint = options.endpoint ?? "https://api.mailersend.com"
- const fetchImpl = options.fetch ?? globalThis.fetch
- if (typeof fetchImpl !== "function")
- throw createError(DRIVER, "INVALID_OPTIONS", "fetch is unavailable; pass `fetch` explicitly")
-
- return {
- name: DRIVER,
- options,
- flags: {
- html: true,
- text: true,
- attachments: true,
- tagging: true,
- tracking: true,
- replyTo: true,
- customHeaders: true,
- scheduling: true,
- batch: true,
- },
-
- async isAvailable() {
- return Boolean(options.apiKey)
- },
-
- async send(msg) {
- const payload = buildMailerSendPayload(msg)
- const res = await httpJson({
- fetch: fetchImpl,
- driver: DRIVER,
- url: `${endpoint}/v1/email`,
- headers: { authorization: `Bearer ${options.apiKey}` },
- body: payload,
- })
- if (res.error) return res as Result
- // MailerSend returns 202 with `X-Message-Id` header; body is empty.
- const id = `ms_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`
- return {
- data: {
- id,
- driver: DRIVER,
- at: new Date(),
- provider: (res.data as Record | null) ?? undefined,
- },
- error: null,
- }
- },
-
- async sendBatch(msgs) {
- const payload = msgs.map(buildMailerSendPayload)
- const res = await httpJson({
- fetch: fetchImpl,
- driver: DRIVER,
- url: `${endpoint}/v1/bulk-email`,
- headers: { authorization: `Bearer ${options.apiKey}` },
- body: payload,
- })
- if (res.error) return res as never
- const body = (res.data ?? {}) as { bulk_email_id?: string }
- const results: EmailResult[] = msgs.map((_, i) => ({
- id: `${body.bulk_email_id ?? "ms_bulk"}_${i}`,
- driver: DRIVER,
- at: new Date(),
- provider: body as Record,
- }))
- return { data: results, error: null }
- },
- }
- },
-)
-
-export default mailersend
-
-function buildMailerSendPayload(msg: EmailMessage): Record {
- const from = normalizeAddresses(msg.from)[0]
- if (!from) throw createError(DRIVER, "INVALID_OPTIONS", "`from` is required")
-
- const payload: Record = {
- from: toMsAddress(from),
- to: normalizeAddresses(msg.to).map(toMsAddress),
- subject: msg.subject,
- }
- if (msg.cc) payload.cc = normalizeAddresses(msg.cc).map(toMsAddress)
- if (msg.bcc) payload.bcc = normalizeAddresses(msg.bcc).map(toMsAddress)
- if (msg.replyTo) {
- const r = normalizeAddresses(msg.replyTo)[0]
- if (r) payload.reply_to = toMsAddress(r)
- }
- if (msg.text) payload.text = msg.text
- if (msg.html) payload.html = msg.html
- if (msg.tags?.length) payload.tags = msg.tags.map((t) => t.name)
- if (msg.headers)
- payload.headers = Object.entries(msg.headers).map(([name, value]) => ({ name, value }))
- if (msg.scheduledAt) {
- const d = msg.scheduledAt instanceof Date ? msg.scheduledAt : new Date(msg.scheduledAt)
- payload.send_at = Math.floor(d.getTime() / 1000)
- }
- if (msg.attachments?.length) payload.attachments = msg.attachments.map(toMsAttachment)
- if (msg.template) {
- if (msg.template.id) payload.template_id = msg.template.id
- if (msg.template.variables) {
- payload.personalization = [
- {
- email: normalizeAddresses(msg.to)[0]?.email,
- data: { ...msg.template.variables },
- },
- ]
- }
- }
- return payload
-}
-
-function toMsAddress(a: EmailAddress): Record {
- return a.name ? { email: a.email, name: a.name } : { email: a.email }
-}
-
-function toMsAttachment(a: Attachment): Record {
- const content = typeof a.content === "string" ? a.content : bytesToBase64(a.content)
- const out: Record = {
- filename: a.filename,
- content,
- disposition: a.disposition ?? "attachment",
- }
- if (a.cid) out.id = a.cid
- return out
-}
-
-function bytesToBase64(bytes: Uint8Array): string {
- const g = globalThis as {
- Buffer?: { from: (b: Uint8Array) => { toString: (e: string) => string } }
- }
- if (g.Buffer) return g.Buffer.from(bytes).toString("base64")
- let binary = ""
- for (const byte of bytes) binary += String.fromCharCode(byte)
- return btoa(binary)
-}
diff --git a/src/driver/mailgun.ts b/src/driver/mailgun.ts
deleted file mode 100644
index 683a955..0000000
--- a/src/driver/mailgun.ts
+++ /dev/null
@@ -1,179 +0,0 @@
-import type { DriverFactory, EmailMessage, EmailResult, Result } from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { formatAddress, normalizeAddresses } from "../_normalize.ts"
-import { createError, createRequiredError, toEmailError } from "../errors.ts"
-
-export interface MailgunDriverOptions {
- apiKey: string
- domain: string
- /** Region preset — `"us"` (default) or `"eu"`. Maps to the matching
- * Mailgun API endpoint. Overridden by `endpoint`. */
- region?: "us" | "eu"
- /** Explicit API endpoint override (highest precedence). */
- endpoint?: string
- fetch?: typeof fetch
-}
-
-const DRIVER = "mailgun"
-
-const mailgun: DriverFactory = defineDriver(
- (options) => {
- if (!options?.apiKey) throw createRequiredError(DRIVER, "apiKey")
- if (!options?.domain) throw createRequiredError(DRIVER, "domain")
- const endpoint =
- options.endpoint ??
- (options.region === "eu" ? "https://api.eu.mailgun.net" : "https://api.mailgun.net")
- const fetchImpl = options.fetch ?? globalThis.fetch
- if (typeof fetchImpl !== "function")
- throw createError(DRIVER, "INVALID_OPTIONS", "fetch is unavailable; pass `fetch` explicitly")
-
- return {
- name: DRIVER,
- options,
- flags: {
- html: true,
- text: true,
- attachments: true,
- tagging: true,
- tracking: true,
- replyTo: true,
- customHeaders: true,
- scheduling: true,
- },
-
- async isAvailable() {
- return Boolean(options.apiKey && options.domain)
- },
-
- async send(msg) {
- const form = buildMailgunForm(msg)
- return mailgunRequest(
- fetchImpl,
- `${endpoint}/v3/${options.domain}/messages`,
- options.apiKey,
- form,
- )
- },
- }
- },
-)
-
-export default mailgun
-
-function buildMailgunForm(msg: EmailMessage): FormData {
- const from = normalizeAddresses(msg.from)[0]
- if (!from) throw createError(DRIVER, "INVALID_OPTIONS", "`from` is required")
-
- const form = new FormData()
- form.append("from", formatAddress(from))
- for (const t of normalizeAddresses(msg.to)) form.append("to", formatAddress(t))
- for (const c of normalizeAddresses(msg.cc)) form.append("cc", formatAddress(c))
- for (const b of normalizeAddresses(msg.bcc)) form.append("bcc", formatAddress(b))
- form.append("subject", msg.subject)
- if (msg.text) form.append("text", msg.text)
- if (msg.html) form.append("html", msg.html)
- for (const r of normalizeAddresses(msg.replyTo)) form.append("h:Reply-To", formatAddress(r))
- if (msg.headers) {
- for (const [k, v] of Object.entries(msg.headers)) form.append(`h:${k}`, v)
- }
- if (msg.tags?.length) {
- for (const t of msg.tags) form.append("o:tag", t.name)
- }
- if (msg.scheduledAt) {
- const d = msg.scheduledAt instanceof Date ? msg.scheduledAt : new Date(msg.scheduledAt)
- form.append("o:deliverytime", d.toUTCString())
- }
- if (msg.attachments?.length) {
- for (const a of msg.attachments) {
- const blob = new Blob(
- [typeof a.content === "string" ? a.content : (a.content as unknown as BlobPart)],
- { type: a.contentType ?? "application/octet-stream" },
- )
- form.append("attachment", blob, a.filename)
- }
- }
- if (msg.template) {
- if (msg.template.id) form.append("template", msg.template.id)
- if (msg.template.variables)
- form.append("h:X-Mailgun-Variables", JSON.stringify(msg.template.variables))
- }
- if (msg.sandbox) form.append("o:testmode", "yes")
- if (msg.tracking) {
- if (msg.tracking.opens !== undefined)
- form.append("o:tracking-opens", msg.tracking.opens ? "yes" : "no")
- if (msg.tracking.clicks !== undefined)
- form.append("o:tracking-clicks", msg.tracking.clicks ? "yes" : "no")
- if (msg.tracking.opens !== undefined || msg.tracking.clicks !== undefined)
- form.append("o:tracking", "yes")
- }
- if (msg.metadata) {
- for (const [k, v] of Object.entries(msg.metadata)) form.append(`v:${k}`, v)
- }
- return form
-}
-
-async function mailgunRequest(
- fetchImpl: typeof fetch,
- url: string,
- apiKey: string,
- form: FormData,
-): Promise> {
- const auth = `Basic ${basicAuth("api", apiKey)}`
- let res: Response
- try {
- res = await fetchImpl(url, {
- method: "POST",
- headers: { authorization: auth, accept: "application/json" },
- body: form,
- })
- } catch (err) {
- return { data: null, error: toEmailError(DRIVER, err) }
- }
- const text = await res.text()
- const parsed = text ? safeJson(text) : null
- if (!res.ok) {
- const body = (parsed ?? {}) as { message?: string }
- const code =
- res.status === 401 || res.status === 403
- ? "AUTH"
- : res.status === 429
- ? "RATE_LIMIT"
- : res.status >= 500
- ? "NETWORK"
- : "PROVIDER"
- return {
- data: null,
- error: createError(DRIVER, code, body.message ?? `HTTP ${res.status}`, {
- status: res.status,
- retryable: code === "RATE_LIMIT" || code === "NETWORK",
- cause: { headers: res.headers, body: parsed ?? text },
- }),
- }
- }
- const body = (parsed ?? {}) as { id?: string; message?: string }
- const id = body.id ?? `mg_${Date.now().toString(36)}`
- return {
- data: {
- id: id.replace(/^<|>$/g, ""),
- driver: DRIVER,
- at: new Date(),
- provider: body as Record,
- },
- error: null,
- }
-}
-
-function basicAuth(user: string, pass: string): string {
- const raw = `${user}:${pass}`
- const g = globalThis as { Buffer?: { from: (v: string) => { toString: (e: string) => string } } }
- if (g.Buffer) return g.Buffer.from(raw).toString("base64")
- return btoa(raw)
-}
-
-function safeJson(text: string): unknown {
- try {
- return JSON.parse(text)
- } catch {
- return null
- }
-}
diff --git a/src/driver/mailtrap.ts b/src/driver/mailtrap.ts
deleted file mode 100644
index caa1dd8..0000000
--- a/src/driver/mailtrap.ts
+++ /dev/null
@@ -1,391 +0,0 @@
-import type {
- Attachment,
- DriverFactory,
- EmailAddress,
- EmailMessage,
- EmailResult,
- EmailTag,
- Result,
-} from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { normalizeAddresses } from "../_normalize.ts"
-import { createError, createRequiredError } from "../errors.ts"
-import { httpJson } from "./_http.ts"
-
-/** Mailtrap driver — Email API sending and Email Sandbox testing
- * with the same API token. Mirrors the official SDK env pattern:
- * \`MAILTRAP_API_KEY\` → \`apiKey\`, \`MAILTRAP_USE_SANDBOX\` → \`sandbox\`,
- * \`MAILTRAP_INBOX_ID\` → \`inboxId\`. */
-export interface MailtrapDriverOptions {
- apiKey: string
- /** Email API base. Default \`https://send.api.mailtrap.io\`. */
- endpoint?: string
- fetch?: typeof fetch
- /** Used when no \`tags\` entry has \`name: "category"\`. */
- defaultCategory?: string
- /** Mailtrap edge protection may block requests without a User-Agent. */
- userAgent?: string
- /** Default sandbox mode when \`msg.sandbox\` is unset. */
- sandbox?: boolean
- /** Sandbox inbox ID (from mailtrap.io/sandboxes/{id}). Required for sandbox sends. */
- inboxId?: number | string
- /** Sandbox API base. Default \`https://sandbox.api.mailtrap.io\`. */
- sandboxEndpoint?: string
-}
-
-interface MailtrapSendSuccess {
- success?: boolean
- message_ids?: string[]
- errors?: string[]
-}
-
-interface MailtrapBatchItemResponse {
- success?: boolean
- message_ids?: string[]
- errors?: string[]
-}
-
-interface MailtrapBatchSuccess {
- success?: boolean
- responses?: MailtrapBatchItemResponse[]
- errors?: string[]
-}
-
-const DRIVER = "mailtrap"
-const DEFAULT_ENDPOINT = "https://send.api.mailtrap.io"
-const DEFAULT_SANDBOX_ENDPOINT = "https://sandbox.api.mailtrap.io"
-
-const mailtrap: DriverFactory = defineDriver(
- (options) => {
- if (!options?.apiKey) throw createRequiredError(DRIVER, "apiKey")
-
- const sendEndpoint = options.endpoint ?? DEFAULT_ENDPOINT
- const sandboxEndpoint = options.sandboxEndpoint ?? DEFAULT_SANDBOX_ENDPOINT
- const fetchImpl = options.fetch ?? globalThis.fetch
- if (typeof fetchImpl !== "function")
- throw createError(DRIVER, "INVALID_OPTIONS", "fetch is unavailable; pass `fetch` explicitly")
-
- const defaultCategory = options.defaultCategory ?? "transactional"
- const userAgent = options.userAgent ?? "unemail/mailtrap"
-
- const mailtrapHeaders = (): Record => ({
- "api-token": options.apiKey,
- "user-agent": userAgent,
- })
-
- return {
- name: DRIVER,
- options,
- flags: {
- attachments: true,
- html: true,
- text: true,
- batch: true,
- templates: true,
- tagging: true,
- replyTo: true,
- customHeaders: true,
- },
-
- async isAvailable() {
- return Boolean(options.apiKey)
- },
-
- async send(msg) {
- const unsupported = rejectUnsupported(msg)
- if (unsupported) return unsupported
-
- const useSandbox = resolveSandboxMode(msg, options)
- const inboxErr = requireInboxIdForSandbox(useSandbox, options)
- if (inboxErr) return inboxErr as Result
-
- const payload = buildPayload(msg, defaultCategory)
- const res = await httpJson({
- fetch: fetchImpl,
- driver: DRIVER,
- url: resolveApiUrl(useSandbox, "send", options, sendEndpoint, sandboxEndpoint),
- headers: mailtrapHeaders(),
- body: payload,
- classifyError: classifyMailtrapError,
- })
- if (res.error) return res as Result
- return parseSendSuccess(res.data)
- },
-
- async sendBatch(msgs) {
- if (msgs.length === 0) return { data: [], error: null }
- for (const msg of msgs) {
- const unsupported = rejectUnsupported(msg)
- if (unsupported) return unsupported as Result>
- }
-
- const mixed = validateBatchSandboxModes(msgs, options)
- if (mixed) return mixed as Result>
-
- const useSandbox = resolveSandboxMode(msgs[0]!, options)
- const inboxErr = requireInboxIdForSandbox(useSandbox, options)
- if (inboxErr) return inboxErr as Result>
-
- const payload = {
- requests: msgs.map((m) => buildPayload(m, defaultCategory)),
- }
- const res = await httpJson({
- fetch: fetchImpl,
- driver: DRIVER,
- url: resolveApiUrl(useSandbox, "batch", options, sendEndpoint, sandboxEndpoint),
- headers: mailtrapHeaders(),
- body: payload,
- classifyError: classifyMailtrapError,
- })
- if (res.error) return res as never
-
- const body = (res.data ?? {}) as MailtrapBatchSuccess
- if (body.success === false) {
- return {
- data: null,
- error: createError(
- DRIVER,
- "PROVIDER",
- formatErrors(body.errors) ?? "batch request failed",
- { cause: body },
- ),
- }
- }
-
- const responses = body.responses ?? []
- for (let i = 0; i < responses.length; i++) {
- const item = responses[i]
- if (item?.success === false) {
- return {
- data: null,
- error: createError(
- DRIVER,
- "PROVIDER",
- formatErrors(item.errors) || `batch item ${i} failed`,
- { cause: item },
- ),
- }
- }
- }
-
- const results: EmailResult[] = responses.map((item, i) => ({
- id: item?.message_ids?.[0] ?? `mailtrap_${Date.now().toString(36)}_${i}`,
- driver: DRIVER,
- at: new Date(),
- provider: item as unknown as Record,
- }))
- return { data: results, error: null }
- },
- }
- },
-)
-
-export default mailtrap
-
-function resolveSandboxMode(msg: EmailMessage, options: MailtrapDriverOptions): boolean {
- return msg.sandbox ?? options.sandbox ?? false
-}
-
-function isValidInboxId(inboxId: number | string | undefined): boolean {
- if (inboxId === undefined || inboxId === null) return false
- if (typeof inboxId === "number") return true
- return String(inboxId).trim().length > 0
-}
-
-function requireInboxIdForSandbox(
- useSandbox: boolean,
- options: MailtrapDriverOptions,
-): Result | null {
- if (!useSandbox) return null
- if (!isValidInboxId(options.inboxId)) {
- return {
- data: null,
- error: createError(
- DRIVER,
- "INVALID_OPTIONS",
- "`inboxId` is required for Mailtrap Email Sandbox",
- { retryable: false },
- ),
- }
- }
- return null
-}
-
-function resolveApiUrl(
- useSandbox: boolean,
- kind: "send" | "batch",
- options: MailtrapDriverOptions,
- sendEndpoint: string,
- sandboxEndpoint: string,
-): string {
- const host = useSandbox ? sandboxEndpoint : sendEndpoint
- const suffix = useSandbox && isValidInboxId(options.inboxId) ? `/${options.inboxId}` : ""
- return `${host}/api/${kind}${suffix}`
-}
-
-function validateBatchSandboxModes(
- msgs: ReadonlyArray,
- options: MailtrapDriverOptions,
-): Result | null {
- if (msgs.length === 0) return null
- const first = resolveSandboxMode(msgs[0]!, options)
- for (let i = 1; i < msgs.length; i++) {
- if (resolveSandboxMode(msgs[i]!, options) !== first) {
- return {
- data: null,
- error: createError(
- DRIVER,
- "INVALID_OPTIONS",
- "mixed Email Sandbox and Email API messages in one batch",
- { retryable: false },
- ),
- }
- }
- }
- return null
-}
-
-function rejectUnsupported(msg: EmailMessage): Result | null {
- if (msg.scheduledAt) {
- return {
- data: null,
- error: createError(DRIVER, "UNSUPPORTED", "scheduling is not supported by Mailtrap", {
- retryable: false,
- }),
- }
- }
- return null
-}
-
-function parseSendSuccess(data: unknown): Result {
- const body = (data ?? {}) as MailtrapSendSuccess
- if (body.success === false) {
- return {
- data: null,
- error: createError(DRIVER, "PROVIDER", formatErrors(body.errors) ?? "send failed", {
- cause: body,
- }),
- }
- }
- const id = body.message_ids?.[0] ?? `mailtrap_${Date.now().toString(36)}`
- return {
- data: {
- id,
- driver: DRIVER,
- at: new Date(),
- provider: body as Record,
- },
- error: null,
- }
-}
-
-function classifyMailtrapError(
- status: number,
- body: unknown,
-): {
- code: "AUTH" | "RATE_LIMIT" | "NETWORK" | "PROVIDER"
- retryable?: boolean
- message?: string
-} | null {
- const record = body && typeof body === "object" ? (body as Record) : null
- const errors = record?.errors
- const message =
- formatErrors(Array.isArray(errors) ? (errors as string[]) : undefined) ??
- (typeof record?.message === "string" ? record.message : null)
-
- if (status === 401 || status === 403) {
- return { code: "AUTH", retryable: false, message: message ?? undefined }
- }
- if (status === 429) {
- return { code: "RATE_LIMIT", retryable: true, message: message ?? undefined }
- }
- if (status >= 500) {
- return { code: "NETWORK", retryable: true, message: message ?? undefined }
- }
- if (message) return { code: "PROVIDER", retryable: false, message }
- return null
-}
-
-function formatErrors(errors: string[] | undefined): string | null {
- if (!errors?.length) return null
- return errors.join("; ")
-}
-
-function buildPayload(msg: EmailMessage, defaultCategory: string): Record {
- const from = normalizeAddresses(msg.from)[0]
- if (!from) throw createError(DRIVER, "INVALID_OPTIONS", "`from` is required")
-
- const payload: Record = {
- from: toMailtrapAddress(from),
- to: normalizeAddresses(msg.to).map(toMailtrapAddress),
- subject: msg.subject,
- }
- if (msg.cc) payload.cc = normalizeAddresses(msg.cc).map(toMailtrapAddress)
- if (msg.bcc) payload.bcc = normalizeAddresses(msg.bcc).map(toMailtrapAddress)
- if (msg.replyTo) {
- const r = normalizeAddresses(msg.replyTo)[0]
- if (r) payload.reply_to = toMailtrapAddress(r)
- }
- if (msg.text) payload.text = msg.text
- if (msg.html) payload.html = msg.html
- if (msg.headers) payload.headers = msg.headers
- if (msg.attachments?.length) payload.attachments = msg.attachments.map(toMailtrapAttachment)
-
- const customVars: Record = {}
- if (msg.metadata) {
- for (const [k, v] of Object.entries(msg.metadata)) customVars[k] = String(v)
- }
- if (msg.tags?.length) {
- for (const tag of msg.tags) {
- if (tag.name === "category") continue
- customVars[`tag_${tag.name}`] = tag.value ?? ""
- }
- }
- if (Object.keys(customVars).length) payload.custom_variables = customVars
-
- payload.category = resolveCategory(msg.tags, defaultCategory)
-
- if (msg.template) {
- if (msg.template.id) payload.template_uuid = msg.template.id
- if (msg.template.variables) payload.template_variables = { ...msg.template.variables }
- }
-
- if (!msg.template && !msg.text && !msg.html) {
- throw createError(DRIVER, "INVALID_OPTIONS", "`text`, `html`, or `template` is required")
- }
-
- return payload
-}
-
-function resolveCategory(tags: ReadonlyArray | undefined, fallback: string): string {
- const cat = tags?.find((t) => t.name === "category")
- if (cat?.value) return cat.value
- if (cat?.name === "category" && !cat.value) return fallback
- return fallback
-}
-
-function toMailtrapAddress(a: EmailAddress): Record {
- return a.name ? { email: a.email, name: a.name } : { email: a.email }
-}
-
-function toMailtrapAttachment(a: Attachment): Record {
- const content = typeof a.content === "string" ? a.content : bytesToBase64(a.content)
- const out: Record = {
- content,
- filename: a.filename,
- }
- if (a.contentType) out.type = a.contentType
- if (a.disposition) out.disposition = a.disposition
- if (a.cid) out.content_id = a.cid
- return out
-}
-
-function bytesToBase64(bytes: Uint8Array): string {
- const g = globalThis as {
- Buffer?: { from: (b: Uint8Array) => { toString: (e: string) => string } }
- }
- if (g.Buffer) return g.Buffer.from(bytes).toString("base64")
- let binary = ""
- for (const byte of bytes) binary += String.fromCharCode(byte)
- return btoa(binary)
-}
diff --git a/src/driver/mock.ts b/src/driver/mock.ts
deleted file mode 100644
index 1f247a2..0000000
--- a/src/driver/mock.ts
+++ /dev/null
@@ -1,69 +0,0 @@
-import type { DriverFactory, EmailMessage, EmailResult } from "../types.ts"
-import { defineDriver } from "../_define.ts"
-
-/** Options for the `mock` driver — a drop-in replacement used in tests that
- * records every sent message instead of hitting the network. */
-export interface MockDriverOptions {
- /** When true, drivers simulate a rejection on every send — useful for
- * exercising `onError` middleware. */
- fail?: boolean
- /** Inspect or mutate the captured inbox. Exposed via `driver.inbox` too. */
- inbox?: EmailMessage[]
-}
-
-/** Driver with an injected `inbox` you can assert against. Also returned as
- * `driver.getInstance()`. */
-const mock: DriverFactory = defineDriver<
- MockDriverOptions,
- EmailMessage[]
->((options) => {
- const inbox: EmailMessage[] = options?.inbox ?? []
- let counter = 0
-
- return {
- name: "mock",
- options,
- flags: {
- attachments: true,
- html: true,
- text: true,
- batch: true,
- replyTo: true,
- customHeaders: true,
- tagging: true,
- idempotency: true,
- scheduling: true,
- },
- getInstance: () => inbox,
- async isAvailable() {
- return !options?.fail
- },
- send(msg, ctx) {
- if (options?.fail) {
- return {
- data: null,
- error: new (class extends Error {})(`[unemail] [mock] configured to fail`) as never,
- }
- }
- inbox.push(msg)
- const result: EmailResult = {
- id: `mock_${++counter}_${Date.now()}`,
- driver: "mock",
- stream: ctx.stream,
- at: new Date(),
- }
- return { data: result, error: null }
- },
- async sendBatch(msgs, ctx) {
- const out: EmailResult[] = []
- for (const msg of msgs) {
- const r = await this.send(msg, ctx)
- if (r.error) return r as never
- out.push(r.data!)
- }
- return { data: out, error: null }
- },
- }
-})
-
-export default mock
diff --git a/src/driver/postmark.ts b/src/driver/postmark.ts
deleted file mode 100644
index 02d6c51..0000000
--- a/src/driver/postmark.ts
+++ /dev/null
@@ -1,244 +0,0 @@
-import type {
- Attachment,
- DriverFactory,
- EmailAddress,
- EmailMessage,
- EmailResult,
- Result,
-} from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { formatAddress, normalizeAddresses } from "../_normalize.ts"
-import { createError, createRequiredError, toEmailError } from "../errors.ts"
-
-/** Options for the Postmark driver. Postmark is the only mainstream
- * provider with native transactional vs broadcast stream isolation —
- * route by `msg.stream`, or set `messageStream` as a driver-level default. */
-export interface PostmarkDriverOptions {
- /** Server API token (the per-server token, not the account token). */
- token: string
- /** Default \`MessageStream\` if the message doesn't specify \`stream\`. */
- messageStream?: string
- /** Override for self-hosted gateways or test stubs. */
- endpoint?: string
- /** Injected fetch — defaults to global \`fetch\`. */
- fetch?: typeof fetch
-}
-
-const DRIVER = "postmark"
-const DEFAULT_ENDPOINT = "https://api.postmarkapp.com"
-
-const postmark: DriverFactory = defineDriver(
- (options) => {
- if (!options?.token) throw createRequiredError(DRIVER, "token")
- const endpoint = options.endpoint ?? DEFAULT_ENDPOINT
- const fetchImpl = options.fetch ?? globalThis.fetch
- if (typeof fetchImpl !== "function")
- throw createError(DRIVER, "INVALID_OPTIONS", "fetch is unavailable; pass `fetch` explicitly")
-
- return {
- name: DRIVER,
- options,
- flags: {
- attachments: true,
- html: true,
- text: true,
- batch: true,
- tracking: true,
- templates: true,
- tagging: true,
- replyTo: true,
- customHeaders: true,
- },
-
- async isAvailable() {
- return Boolean(options.token)
- },
-
- async send(msg) {
- const payload = buildPayload(msg, options.messageStream)
- const path = msg.template ? "/email/withTemplate" : "/email"
- const res = await request(fetchImpl, endpoint, path, "POST", options.token, payload)
- if (res.error) return res as Result
- const body = res.data as PostmarkSendResponse
- const result: EmailResult = {
- id: body.MessageID,
- driver: DRIVER,
- stream: msg.stream ?? options.messageStream,
- at: parsePostmarkDate(body.SubmittedAt) ?? new Date(),
- provider: body as unknown as Record,
- }
- return { data: result, error: null }
- },
-
- async sendBatch(msgs) {
- const payload = msgs.map((m) => buildPayload(m, options.messageStream))
- const anyTemplate = msgs.some((m) => m.template)
- const path = anyTemplate ? "/email/batchWithTemplates" : "/email/batch"
- const requestBody = anyTemplate ? { Messages: payload } : payload
- const res = await request(fetchImpl, endpoint, path, "POST", options.token, requestBody)
- if (res.error) return res as never
- const responses = res.data as PostmarkSendResponse[]
- const failures = responses.filter((entry) => (entry.ErrorCode ?? 0) !== 0)
- if (failures.length > 0) {
- const first = failures[0]!
- return {
- data: null,
- error: createError(
- DRIVER,
- "PROVIDER",
- first.Message ?? `batch partial failure (${failures.length}/${responses.length})`,
- {
- status: first.ErrorCode,
- cause: responses,
- retryable: false,
- },
- ),
- }
- }
- const results: EmailResult[] = responses.map((entry, i) => ({
- id: entry.MessageID,
- driver: DRIVER,
- stream: msgs[i]?.stream ?? options.messageStream,
- at: parsePostmarkDate(entry.SubmittedAt) ?? new Date(),
- provider: entry as unknown as Record,
- }))
- return { data: results, error: null }
- },
- }
- },
-)
-
-export default postmark
-
-interface PostmarkSendResponse {
- MessageID: string
- SubmittedAt?: string
- To?: string
- ErrorCode?: number
- Message?: string
-}
-
-function buildPayload(msg: EmailMessage, defaultStream?: string): Record {
- const from = normalizeAddresses(msg.from)[0]
- if (!from) throw createError(DRIVER, "INVALID_OPTIONS", "`from` is required")
-
- const body: Record = {
- From: formatAddress(from),
- To: addressList(msg.to),
- Subject: msg.subject,
- }
- if (msg.cc) body.Cc = addressList(msg.cc)
- if (msg.bcc) body.Bcc = addressList(msg.bcc)
- if (msg.replyTo) body.ReplyTo = addressList(msg.replyTo)
- if (msg.text) body.TextBody = msg.text
- if (msg.html) body.HtmlBody = msg.html
- if (msg.headers)
- body.Headers = Object.entries(msg.headers).map(([Name, Value]) => ({ Name, Value }))
- // Postmark treats Metadata as the metadata bag. Prefer msg.metadata; fall back to tags.
- if (msg.metadata) body.Metadata = { ...msg.metadata }
- else if (msg.tags?.length)
- body.Metadata = Object.fromEntries(msg.tags.map((t) => [t.name, t.value]))
- if (msg.tags?.length) body.Tag = msg.tags[0]!.name
- if (msg.tracking?.opens !== undefined) body.TrackOpens = msg.tracking.opens
- if (msg.tracking?.clicks !== undefined)
- body.TrackLinks = msg.tracking.clicks ? "HtmlAndText" : "None"
- if (msg.attachments?.length) body.Attachments = msg.attachments.map(toPostmarkAttachment)
- if (msg.template) {
- if (msg.template.id) body.TemplateId = Number.parseInt(msg.template.id, 10) || msg.template.id
- if (msg.template.alias) body.TemplateAlias = msg.template.alias
- if (msg.template.variables) body.TemplateModel = { ...msg.template.variables }
- }
- const stream = msg.stream ?? defaultStream
- if (stream) body.MessageStream = stream
- return body
-}
-
-function addressList(input: EmailMessage["to"]): string {
- return normalizeAddresses(input)
- .map((a: EmailAddress) => formatAddress(a))
- .join(", ")
-}
-
-function toPostmarkAttachment(a: Attachment): Record {
- const content = typeof a.content === "string" ? a.content : bytesToBase64(a.content)
- const out: Record = {
- Name: a.filename,
- Content: content,
- ContentType: a.contentType ?? "application/octet-stream",
- }
- if (a.cid) out.ContentID = `cid:${a.cid}`
- return out
-}
-
-function bytesToBase64(bytes: Uint8Array): string {
- const g = globalThis as {
- Buffer?: { from: (b: Uint8Array) => { toString: (e: string) => string } }
- }
- if (g.Buffer) return g.Buffer.from(bytes).toString("base64")
- let binary = ""
- for (const byte of bytes) binary += String.fromCharCode(byte)
- return btoa(binary)
-}
-
-function parsePostmarkDate(value?: string): Date | null {
- if (!value) return null
- const d = new Date(value)
- return Number.isNaN(d.getTime()) ? null : d
-}
-
-async function request(
- fetchImpl: typeof fetch,
- endpoint: string,
- path: string,
- method: string,
- token: string,
- body: unknown,
-): Promise> {
- let res: Response
- try {
- res = await fetchImpl(`${endpoint}${path}`, {
- method,
- headers: {
- accept: "application/json",
- "content-type": "application/json",
- "x-postmark-server-token": token,
- },
- body: JSON.stringify(body),
- })
- } catch (err) {
- return { data: null, error: toEmailError(DRIVER, err) }
- }
-
- const text = await res.text()
- const parsed = text ? safeJson(text) : null
-
- if (!res.ok) {
- const apiError = (parsed ?? {}) as { Message?: string; ErrorCode?: number }
- const code =
- res.status === 401 || res.status === 403 || apiError.ErrorCode === 10
- ? "AUTH"
- : res.status === 429
- ? "RATE_LIMIT"
- : res.status >= 500
- ? "NETWORK"
- : "PROVIDER"
- return {
- data: null,
- error: createError(DRIVER, code, apiError.Message ?? `HTTP ${res.status}`, {
- status: res.status,
- cause: { headers: res.headers, body: parsed ?? text },
- retryable: code === "RATE_LIMIT" || code === "NETWORK",
- }),
- }
- }
-
- return { data: parsed, error: null }
-}
-
-function safeJson(text: string): unknown {
- try {
- return JSON.parse(text)
- } catch {
- return null
- }
-}
diff --git a/src/driver/resend.ts b/src/driver/resend.ts
deleted file mode 100644
index bdac3d2..0000000
--- a/src/driver/resend.ts
+++ /dev/null
@@ -1,287 +0,0 @@
-import type {
- Attachment,
- DriverFactory,
- EmailAddress,
- EmailMessage,
- EmailResult,
- EmailTag,
- Result,
- SendStatus,
- SendStatusState,
-} from "../types.ts"
-import { defineDriver } from "../_define.ts"
-import { formatAddress, normalizeAddresses } from "../_normalize.ts"
-import { createError, createRequiredError, toEmailError } from "../errors.ts"
-
-/** Options for the Resend driver. Keep the surface minimal — everything
- * Resend-specific (tags, scheduling, idempotency) is carried on the
- * `EmailMessage` itself. */
-export interface ResendDriverOptions {
- apiKey: string
- /** Override for self-hosted gateways or test stubs. */
- endpoint?: string
- /** Fetch impl — useful for tests. Defaults to the global `fetch`. */
- fetch?: typeof fetch
-}
-
-interface ResendApiSuccess {
- id: string
- [k: string]: unknown
-}
-
-interface ResendApiError {
- name?: string
- message?: string
- statusCode?: number
-}
-
-const DRIVER = "resend"
-const DEFAULT_ENDPOINT = "https://api.resend.com"
-
-const resend: DriverFactory = defineDriver((options) => {
- if (!options?.apiKey) throw createRequiredError(DRIVER, "apiKey")
- if (!options.apiKey.startsWith("re_"))
- throw createError(DRIVER, "INVALID_OPTIONS", "apiKey must start with 're_'")
-
- const endpoint = options.endpoint ?? DEFAULT_ENDPOINT
- const fetchImpl = options.fetch ?? globalThis.fetch
- if (typeof fetchImpl !== "function")
- throw createError(DRIVER, "INVALID_OPTIONS", "fetch is unavailable; pass `fetch` explicitly")
-
- return {
- name: DRIVER,
- options,
- flags: {
- attachments: true,
- html: true,
- text: true,
- batch: true,
- scheduling: true,
- idempotency: true,
- tagging: true,
- replyTo: true,
- customHeaders: true,
- cancelable: true,
- retrievable: true,
- },
-
- async isAvailable() {
- return Boolean(options.apiKey)
- },
-
- async send(msg) {
- const payload = buildPayload(msg)
- const res = await request(fetchImpl, endpoint, "/emails", "POST", options.apiKey, payload, {
- idempotencyKey: msg.idempotencyKey,
- })
- if (res.error) return res as Result
- const data = res.data as ResendApiSuccess
- return {
- data: {
- id: data.id,
- driver: DRIVER,
- at: new Date(),
- provider: data,
- },
- error: null,
- }
- },
-
- async cancel(id) {
- const res = await request(
- fetchImpl,
- endpoint,
- `/emails/${id}/cancel`,
- "POST",
- options.apiKey,
- {},
- )
- if (res.error) return res as Result
- return { data: undefined, error: null }
- },
-
- async retrieve(id) {
- const res = await request(fetchImpl, endpoint, `/emails/${id}`, "GET", options.apiKey, null)
- if (res.error) return res as Result
- const body = (res.data ?? {}) as {
- id?: string
- last_event?: string
- created_at?: string
- }
- return {
- data: {
- id: body.id ?? id,
- driver: DRIVER,
- state: mapResendStatus(body.last_event),
- at: body.created_at ? new Date(body.created_at) : undefined,
- provider: body,
- },
- error: null,
- }
- },
-
- async sendBatch(msgs) {
- const payload = msgs.map((m) => buildPayload(m))
- const res = await request(
- fetchImpl,
- endpoint,
- "/emails/batch",
- "POST",
- options.apiKey,
- payload,
- )
- if (res.error) return res as never
- const body = (res.data ?? {}) as { data?: Array<{ id: string }> }
- const items = body.data ?? []
- return {
- data: items.map((entry) => ({
- id: entry.id,
- driver: DRIVER,
- at: new Date(),
- provider: entry,
- })),
- error: null,
- }
- },
- }
-})
-
-export default resend
-
-function buildPayload(msg: EmailMessage): Record {
- const from = normalizeAddresses(msg.from)[0]
- if (!from) throw createError(DRIVER, "INVALID_OPTIONS", "`from` is required")
-
- const body: Record = {
- from: formatAddress(from),
- to: addressList(msg.to),
- subject: msg.subject,
- }
- if (msg.cc) body.cc = addressList(msg.cc)
- if (msg.bcc) body.bcc = addressList(msg.bcc)
- if (msg.replyTo) body.reply_to = addressList(msg.replyTo)
- if (msg.text) body.text = msg.text
- if (msg.html) body.html = msg.html
- if (msg.headers) body.headers = msg.headers
- if (msg.tags) body.tags = msg.tags.map((t: EmailTag) => ({ name: t.name, value: t.value }))
- if (msg.metadata) {
- const headers = (body.headers as Record