Skip to content
Corven Email SDK
Esc
↑↓navigate↵open⌘Jpreview
On this page

JetEmail

Configure JetEmail transactional credentials, domain settings and idempotency key forwarding.

Import jetemailEmailLayer from @corven/email-sdk/jetemail to provide the common Email service for this account.

Configure the account

import { Layer } from "effect";
import type { Redacted } from "effect";
import { jetemailEmailLayer } from "@corven/email-sdk/jetemail";
import { emailHttpLayer } from "./sending.js";

export const configuredJetemailAccount = (apiKey: Redacted.Redacted) =>
  jetemailEmailLayer({
    apiKey,
    automaticBcc: "DomainDisabled",
    tracking: "DomainDisabled",
    deliveryRegion: "ProviderSelected",
  }).pipe(Layer.provide(emailHttpLayer));

The example reuses the explicit HTTP Layer. Acquire credentials in trusted host code, then provide this account Layer to your sending program.

Message behavior

  • Use a transactional_ submission token. Attest that domain automatic BCC and tracking are disabled before supplying these options.
  • The sender requires an explicit display name; to recipients use plain mailboxes. Scheduled instants require whole seconds.
  • Attachments use ProviderSelected MIME selection. Inline attachments, common metadata and tags are unsupported.
  • deliveryRegion may be ProviderSelected or Europe; it does not establish cross-account deduplication.

Idempotency

The adapter forwards keys of up to 256 characters. Its idempotency declaration is KeyForwarding. The SDK does not retry requests with unknown submission outcomes.

Read field support before switching accounts, and receipts and retries before adding recovery behavior. Configuration and local validation do not authenticate the account or prove delivery.