Email SDK

Use @samva/email-sdk to send through Samva from Email SDK. The package exports both a Samva adapter and an adapter plugin, so you can keep Email SDK's routing, retry, fallback, and validation model while Samva delivers the message.

Install

bun add @samva/email-sdk @opencoredev/email-sdk samva

Register the adapter

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

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

const result = await email.send({
  from: "Samva <hello@example.com>",
  to: "ada@example.com",
  subject: "Welcome",
  html: "<p>Your organization is ready.</p>",
  text: "Your organization is ready.",
});

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

The adapter preserves from, to, cc, bcc, replyTo, HTML, text, metadata, in-memory attachments, and idempotency keys. It rejects headers, tags, scheduled sends, reply-to display names, and path or URL attachments before calling Samva instead of silently dropping unsupported fields.

Register the plugin

Use the plugin export when your application registers reusable Email SDK extensions:

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

const email = createEmailClient({
  plugins: [samvaPlugin({ apiKey: process.env.SAMVA_API_KEY! })],
});

Email SDK expands personalized sends into one Samva request per recipient. API and transport failures become typed EmailAdapterError values, with ambiguous delivery classified conservatively so fallback routes do not accidentally send the same message twice.

Cookbook, example, and registry

• Samva and Email SDK cookbook
• examples/email-sdk
• @samva/email-sdk source
• Email SDK community adapter registry