Quickstart

Set a server-only Resend key:

.env.local

RESEND_API_KEY=re_xxx

Then create the client and send:

src/send-welcome.ts

import { createEmailClient } from "@opencoredev/email-sdk";
import { resend } from "@opencoredev/email-sdk/resend";

const email = createEmailClient({
  adapters: [resend({ apiKey: process.env.RESEND_API_KEY! })],
});

const result = await email.send({
  from: "Acme <hello@acme.com>",
  to: "user@example.com",
  subject: "Welcome",
  text: "Your account is ready.",
});

console.log(result.adapter, result.id);

That is the whole happy path. The result tells you which adapter ran and includes the provider receipt when one is available.

Check a message without sending

Use validate when you want the same message and routing checks without a provider send request:

await email.validate({
  from: "Acme <hello@acme.com>",
  to: "user@example.com",
  subject: "Welcome",
  text: "Your account is ready.",
});

Check from the CLI

--dry-run runs the same validation without sending email.

EMAIL_SDK_TELEMETRY=0 npx --package @opencoredev/email-sdk email-sdk send \
  --adapter resend \
  --from "Acme <hello@acme.com>" \
  --to user@example.com \
  --subject "Welcome" \
  --text "Your account is ready." \
  --dry-run

Standalone starter

A runnable copy of this page for Node 20+ or Bun, with .env loading.

Add retries and fallback

Choose retry counts and unknown-delivery policy deliberately.

Schedule an email

Use provider scheduling now, or an app-owned queue when you need more control.

Test without a provider

Capture sends with the memory adapter and capture plugin.