@iskra-bun/mailer-kit 0.1.0 → 0.2.0

package/src/providers/ses.ts

@@ -1,4 +1,5 @@
-import type { EmailAdapter, EmailConfig, EmailMessage, TemplateData } from "../types";
+import type { EmailAdapter, EmailConfig, EmailMessage, TemplateData } from '../types';
+import { checkRecipients, checkReplyTo, formatAddress, formatRecipient } from '../headers';
 
 /**
  * Minimal structural shape of the value returned by
@@ -34,6 +35,7 @@ export class SesEmailAdapter implements EmailAdapter {
     private defaultFrom?: { name?: string; email: string };
     private injectedClient?: SesClient;
     private injectedCommand?: SesCommandFactory;
+    private sdk?: Promise<{ client: SesClient; command: SesCommandFactory }>;
 
     constructor(config: EmailConfig, deps: SesAdapterDeps = {}) {
         // The effective `from` address is validated at send time (it can come
@@ -44,17 +46,25 @@ export class SesEmailAdapter implements EmailAdapter {
         this.injectedCommand = deps.sendEmailCommand;
     }
 
-    private async resolveSdk(): Promise<{ client: SesClient; command: SesCommandFactory }> {
+    private resolveSdk(): Promise<{ client: SesClient; command: SesCommandFactory }> {
         if (this.injectedClient && this.injectedCommand) {
-            return { client: this.injectedClient, command: this.injectedCommand };
+            return Promise.resolve({ client: this.injectedClient, command: this.injectedCommand });
         }
+        // One client per adapter, built on the first send. A failed import is
+        // not cached, so the next send retries it.
+        return (this.sdk ??= this.loadSdk().catch((err: unknown) => {
+            this.sdk = undefined;
+            throw err;
+        }));
+    }
 
+    private async loadSdk(): Promise<{ client: SesClient; command: SesCommandFactory }> {
         // Lazy load only when actually sending so `tsc`/`bun test` stay green
         // without `@aws-sdk/client-sesv2` installed. The specifier is held in a
         // variable so TypeScript does not try to resolve the module at compile
         // time (it is a real runtime dependency, declared in package.json).
-        const sdkModule = "@aws-sdk/client-sesv2";
-        const mod: any = await import(sdkModule);
+        const sdkModule = '@aws-sdk/client-sesv2';
+        const mod = (await import(sdkModule)) as Record<string, unknown>;
         const SESv2Client = mod.SESv2Client as new (cfg: { region?: string }) => SesClient;
         const SendEmailCommand = mod.SendEmailCommand as new (input: unknown) => SesCommand;
 
@@ -66,41 +76,57 @@ export class SesEmailAdapter implements EmailAdapter {
 
     async send(message: EmailMessage): Promise<{ messageId: string; success: boolean }> {
         const from = message.from || this.defaultFrom;
-        if (!from) throw new Error("From address required");
+        if (!from) throw new Error('From address required');
+        // Simple content has no place for them: they used to be dropped while
+        // the send reported success.
+        if (message.attachments?.length) {
+            throw new Error('Attachments are not supported by the ses adapter yet');
+        }
+        if (message.headers && Object.keys(message.headers).length > 0) {
+            throw new Error('Custom headers are not supported by the ses adapter yet');
+        }
 
-        const { client, command } = await this.resolveSdk();
+        // SES parses each entry as an address list: one mailbox per entry.
+        const toAddresses = checkRecipients(message.to).map(formatRecipient);
+        const cc = checkRecipients(message.cc, 'cc recipient').map(formatRecipient);
+        const bcc = checkRecipients(message.bcc, 'bcc recipient').map(formatRecipient);
+        const ccAddresses = cc.length > 0 ? cc : undefined;
+        const bccAddresses = bcc.length > 0 ? bcc : undefined;
+        const replyTo = checkReplyTo(message.replyTo);
 
-        const toAddresses = Array.isArray(message.to) ? message.to : [message.to];
-        const ccAddresses = message.cc ? (Array.isArray(message.cc) ? message.cc : [message.cc]) : undefined;
-        const bccAddresses = message.bcc ? (Array.isArray(message.bcc) ? message.bcc : [message.bcc]) : undefined;
+        const { client, command } = await this.resolveSdk();
 
         const body: Record<string, { Data: string; Charset: string }> = {};
-        if (message.text) body.Text = { Data: message.text, Charset: "UTF-8" };
-        if (message.html) body.Html = { Data: message.html, Charset: "UTF-8" };
+        if (message.text) body.Text = { Data: message.text, Charset: 'UTF-8' };
+        if (message.html) body.Html = { Data: message.html, Charset: 'UTF-8' };
 
         const input = {
-            FromEmailAddress: from.name ? `${from.name} <${from.email}>` : from.email,
+            FromEmailAddress: formatAddress(from),
             Destination: {
                 ToAddresses: toAddresses,
                 ...(ccAddresses ? { CcAddresses: ccAddresses } : {}),
                 ...(bccAddresses ? { BccAddresses: bccAddresses } : {}),
             },
-            ...(message.replyTo ? { ReplyToAddresses: [message.replyTo] } : {}),
+            ...(replyTo ? { ReplyToAddresses: [formatRecipient(replyTo)] } : {}),
             Content: {
                 Simple: {
-                    Subject: { Data: message.subject, Charset: "UTF-8" },
+                    Subject: { Data: message.subject, Charset: 'UTF-8' },
                     Body: body,
                 },
             },
         };
 
         const result = await client.send(command(input));
-        return { messageId: result.MessageId ?? "", success: true };
+        return { messageId: result.MessageId ?? '', success: true };
     }
 
-    async sendTemplate(_templateName: string, _to: string | string[], _data: TemplateData): Promise<{ messageId: string; success: boolean }> {
+    async sendTemplate(
+        _templateName: string,
+        _to: string | string[],
+        _data: TemplateData,
+    ): Promise<{ messageId: string; success: boolean }> {
         // No template engine is implemented yet; fail loudly rather than
         // silently sending a placeholder body that looks like a real send.
-        throw new Error("sendTemplate not supported by ses");
+        throw new Error('sendTemplate not supported by ses');
     }
 }

package/src/providers/smtp.ts

@@ -1,11 +1,15 @@
-import type { EmailAdapter, EmailConfig, EmailMessage, TemplateData } from "../types";
-import * as nodemailer from "nodemailer";
+import type { EmailAdapter, EmailAddress, EmailConfig, EmailMessage, TemplateData } from '../types';
+import * as nodemailer from 'nodemailer';
+import { checkEmail, checkHeaders, checkRecipients, checkReplyTo, cleanName } from '../headers';
+
+/** nodemailer's form of a checked recipient: it quotes or encodes the name itself. */
+const toMailbox = ({ name, address }: EmailAddress) => (name ? { name, address } : address);
 
 export class SmtpEmailAdapter implements EmailAdapter {
     private transporter: nodemailer.Transporter;
 
     constructor(private config: EmailConfig) {
-        if (!config.smtp) throw new Error("SMTP config required");
+        if (!config.smtp) throw new Error('SMTP config required');
         // Implicit TLS on port 465; STARTTLS enforced (requireTLS) elsewhere so
         // credentials never transit in cleartext. An explicit `secure` wins.
         const secure = config.smtp.secure ?? config.smtp.port === 465;
@@ -17,37 +21,51 @@ export class SmtpEmailAdapter implements EmailAdapter {
             tls: { rejectUnauthorized: true },
             auth: {
                 user: config.smtp.username,
-                pass: config.smtp.password
-            }
+                pass: config.smtp.password,
+            },
         });
     }
 
     async send(message: EmailMessage) {
         const from = message.from || this.config.from;
-        if (!from) throw new Error("From address required");
+        if (!from) throw new Error('From address required');
+        // Joined into one string, nodemailer parsed each value as an address
+        // list: one entry could add recipients or a group.
+        const cc = checkRecipients(message.cc, 'cc recipient').map(toMailbox);
+        const bcc = checkRecipients(message.bcc, 'bcc recipient').map(toMailbox);
+        const replyTo = checkReplyTo(message.replyTo);
 
         const info = await this.transporter.sendMail({
-            from: from.name ? `"${from.name}" <${from.email}>` : from.email,
-            to: Array.isArray(message.to) ? message.to.join(", ") : message.to,
+            // An address object: nodemailer quotes or encodes the name, which
+            // interpolated into `"name" <email>` could add another sender.
+            from: { name: from.name ? cleanName(from.name) : '', address: checkEmail(from.email) },
+            to: checkRecipients(message.to).map(toMailbox),
             subject: message.subject,
             text: message.text,
             html: message.html,
-            cc: message.cc ? (Array.isArray(message.cc) ? message.cc.join(", ") : message.cc) : undefined,
-            bcc: message.bcc ? (Array.isArray(message.bcc) ? message.bcc.join(", ") : message.bcc) : undefined,
-            replyTo: message.replyTo,
-            attachments: message.attachments?.map(a => ({
+            cc: cc.length > 0 ? cc : undefined,
+            bcc: bcc.length > 0 ? bcc : undefined,
+            replyTo: replyTo && toMailbox(replyTo),
+            attachments: message.attachments?.map((a) => ({
                 filename: a.filename,
                 content: typeof a.content === 'string' ? a.content : Buffer.from(a.content),
-                contentType: a.contentType
-            }))
+                contentType: a.contentType,
+            })),
+            // Forwarded with the same allowlist as the other providers (it
+            // used to be dropped).
+            headers: checkHeaders(message.headers),
         });
 
-        return { messageId: (info as any).messageId, success: true };
+        return { messageId: info.messageId, success: true };
     }
 
-    async sendTemplate(_templateName: string, _to: string | string[], _data: TemplateData): Promise<{ messageId: string; success: boolean }> {
+    async sendTemplate(
+        _templateName: string,
+        _to: string | string[],
+        _data: TemplateData,
+    ): Promise<{ messageId: string; success: boolean }> {
         // No template engine is implemented yet; fail loudly rather than
         // silently sending a placeholder body that looks like a real send.
-        throw new Error("sendTemplate not supported by smtp");
+        throw new Error('sendTemplate not supported by smtp');
     }
 }

package/src/types.ts

@@ -1,5 +1,5 @@
 export interface EmailConfig {
-    provider: "smtp" | "sendgrid" | "mock" | "mailgun" | "ses";
+    provider: 'smtp' | 'sendgrid' | 'mock' | 'mailgun' | 'ses';
     smtp?: {
         host: string;
         port: number;
@@ -16,15 +16,28 @@ export interface EmailConfig {
     templateDir?: string;
 }
 
+/** An address with an optional display name. */
+export interface EmailAddress {
+    name?: string;
+    address: string;
+}
+
+/** A recipient: a bare address, or `{ name, address }` to give it a display name. */
+export type EmailRecipient = string | EmailAddress;
+
 export interface EmailMessage {
-    to: string | string[];
+    /**
+     * Each entry is one bare address (`a@x.com`), or `{ name, address }` for a
+     * display name: a string with a name, a list or a group is rejected.
+     */
+    to: EmailRecipient | EmailRecipient[];
     from?: { name?: string; email: string };
     subject: string;
     text?: string;
     html?: string;
-    cc?: string | string[];
-    bcc?: string | string[];
-    replyTo?: string;
+    cc?: EmailRecipient | EmailRecipient[];
+    bcc?: EmailRecipient | EmailRecipient[];
+    replyTo?: EmailRecipient;
     attachments?: Array<{ filename: string; content: Uint8Array | string; contentType?: string }>;
     headers?: Record<string, string>;
 }
@@ -35,5 +48,9 @@ export interface TemplateData {
 
 export interface EmailAdapter {
     send(message: EmailMessage): Promise<{ messageId: string; success: boolean }>;
-    sendTemplate(templateName: string, to: string | string[], data: TemplateData): Promise<{ messageId: string; success: boolean }>;
+    sendTemplate(
+        templateName: string,
+        to: EmailRecipient | EmailRecipient[],
+        data: TemplateData,
+    ): Promise<{ messageId: string; success: boolean }>;
 }

package/dist/chunk-4256VN6L.js

@@ -1,40 +0,0 @@
-// src/providers/sendgrid.ts
-import sgMail from "@sendgrid/mail";
-var SendGridEmailAdapter = class {
-  constructor(config) {
-    this.config = config;
-    if (!config.apiKey) throw new Error("SendGrid API Key required");
-    sgMail.setApiKey(config.apiKey);
-  }
-  config;
-  async send(message) {
-    const from = message.from || this.config.from;
-    if (!from) throw new Error("From address required");
-    const msg = {
-      to: message.to,
-      from: from.name ? { email: from.email, name: from.name } : from.email,
-      subject: message.subject,
-      text: message.text,
-      html: message.html,
-      cc: message.cc,
-      bcc: message.bcc,
-      replyTo: message.replyTo,
-      attachments: message.attachments?.map((a) => ({
-        filename: a.filename,
-        content: typeof a.content === "string" ? a.content : Buffer.from(a.content).toString("base64"),
-        type: a.contentType,
-        disposition: "attachment"
-      }))
-    };
-    const [response] = await sgMail.send(msg);
-    return { messageId: response.headers["x-message-id"], success: true };
-  }
-  async sendTemplate(_templateName, _to, _data) {
-    throw new Error("sendTemplate not supported by sendgrid");
-  }
-};
-
-export {
-  SendGridEmailAdapter
-};
-//# sourceMappingURL=chunk-4256VN6L.js.map

package/dist/chunk-4256VN6L.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/sendgrid.ts"],"sourcesContent":["import type { EmailAdapter, EmailConfig, EmailMessage, TemplateData } from \"../types\";\nimport sgMail from \"@sendgrid/mail\";\n\nexport class SendGridEmailAdapter implements EmailAdapter {\n    constructor(private config: EmailConfig) {\n        if (!config.apiKey) throw new Error(\"SendGrid API Key required\");\n        sgMail.setApiKey(config.apiKey);\n    }\n\n    async send(message: EmailMessage) {\n        const from = message.from || this.config.from;\n        if (!from) throw new Error(\"From address required\");\n\n        const msg = {\n            to: message.to,\n            from: from.name ? { email: from.email, name: from.name } : from.email,\n            subject: message.subject,\n            text: message.text,\n            html: message.html,\n            cc: message.cc as any,\n            bcc: message.bcc as any,\n            replyTo: message.replyTo,\n            attachments: message.attachments?.map(a => ({\n                filename: a.filename,\n                content: typeof a.content === 'string' ? a.content : Buffer.from(a.content).toString(\"base64\"),\n                type: a.contentType,\n                disposition: \"attachment\"\n            }))\n        } as any;\n\n        const [response] = await sgMail.send(msg);\n        return { messageId: response.headers[\"x-message-id\"] as string, success: true };\n    }\n\n    async sendTemplate(_templateName: string, _to: string | string[], _data: TemplateData): Promise<{ messageId: string; success: boolean }> {\n        // No template engine is implemented yet; fail loudly rather than\n        // silently sending a placeholder body that looks like a real send.\n        throw new Error(\"sendTemplate not supported by sendgrid\");\n    }\n}\n"],"mappings":";AACA,OAAO,YAAY;AAEZ,IAAM,uBAAN,MAAmD;AAAA,EACtD,YAAoB,QAAqB;AAArB;AAChB,QAAI,CAAC,OAAO,OAAQ,OAAM,IAAI,MAAM,2BAA2B;AAC/D,WAAO,UAAU,OAAO,MAAM;AAAA,EAClC;AAAA,EAHoB;AAAA,EAKpB,MAAM,KAAK,SAAuB;AAC9B,UAAM,OAAO,QAAQ,QAAQ,KAAK,OAAO;AACzC,QAAI,CAAC,KAAM,OAAM,IAAI,MAAM,uBAAuB;AAElD,UAAM,MAAM;AAAA,MACR,IAAI,QAAQ;AAAA,MACZ,MAAM,KAAK,OAAO,EAAE,OAAO,KAAK,OAAO,MAAM,KAAK,KAAK,IAAI,KAAK;AAAA,MAChE,SAAS,QAAQ;AAAA,MACjB,MAAM,QAAQ;AAAA,MACd,MAAM,QAAQ;AAAA,MACd,IAAI,QAAQ;AAAA,MACZ,KAAK,QAAQ;AAAA,MACb,SAAS,QAAQ;AAAA,MACjB,aAAa,QAAQ,aAAa,IAAI,QAAM;AAAA,QACxC,UAAU,EAAE;AAAA,QACZ,SAAS,OAAO,EAAE,YAAY,WAAW,EAAE,UAAU,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,QAAQ;AAAA,QAC7F,MAAM,EAAE;AAAA,QACR,aAAa;AAAA,MACjB,EAAE;AAAA,IACN;AAEA,UAAM,CAAC,QAAQ,IAAI,MAAM,OAAO,KAAK,GAAG;AACxC,WAAO,EAAE,WAAW,SAAS,QAAQ,cAAc,GAAa,SAAS,KAAK;AAAA,EAClF;AAAA,EAEA,MAAM,aAAa,eAAuB,KAAwB,OAAuE;AAGrI,UAAM,IAAI,MAAM,wCAAwC;AAAA,EAC5D;AACJ;","names":[]}

package/dist/chunk-4Y2FQY2L.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/smtp.ts"],"sourcesContent":["import type { EmailAdapter, EmailConfig, EmailMessage, TemplateData } from \"../types\";\nimport * as nodemailer from \"nodemailer\";\n\nexport class SmtpEmailAdapter implements EmailAdapter {\n    private transporter: nodemailer.Transporter;\n\n    constructor(private config: EmailConfig) {\n        if (!config.smtp) throw new Error(\"SMTP config required\");\n        // Implicit TLS on port 465; STARTTLS enforced (requireTLS) elsewhere so\n        // credentials never transit in cleartext. An explicit `secure` wins.\n        const secure = config.smtp.secure ?? config.smtp.port === 465;\n        this.transporter = nodemailer.createTransport({\n            host: config.smtp.host,\n            port: config.smtp.port,\n            secure,\n            requireTLS: secure ? undefined : true,\n            tls: { rejectUnauthorized: true },\n            auth: {\n                user: config.smtp.username,\n                pass: config.smtp.password\n            }\n        });\n    }\n\n    async send(message: EmailMessage) {\n        const from = message.from || this.config.from;\n        if (!from) throw new Error(\"From address required\");\n\n        const info = await this.transporter.sendMail({\n            from: from.name ? `\"${from.name}\" <${from.email}>` : from.email,\n            to: Array.isArray(message.to) ? message.to.join(\", \") : message.to,\n            subject: message.subject,\n            text: message.text,\n            html: message.html,\n            cc: message.cc ? (Array.isArray(message.cc) ? message.cc.join(\", \") : message.cc) : undefined,\n            bcc: message.bcc ? (Array.isArray(message.bcc) ? message.bcc.join(\", \") : message.bcc) : undefined,\n            replyTo: message.replyTo,\n            attachments: message.attachments?.map(a => ({\n                filename: a.filename,\n                content: typeof a.content === 'string' ? a.content : Buffer.from(a.content),\n                contentType: a.contentType\n            }))\n        });\n\n        return { messageId: (info as any).messageId, success: true };\n    }\n\n    async sendTemplate(_templateName: string, _to: string | string[], _data: TemplateData): Promise<{ messageId: string; success: boolean }> {\n        // No template engine is implemented yet; fail loudly rather than\n        // silently sending a placeholder body that looks like a real send.\n        throw new Error(\"sendTemplate not supported by smtp\");\n    }\n}\n"],"mappings":";AACA,YAAY,gBAAgB;AAErB,IAAM,mBAAN,MAA+C;AAAA,EAGlD,YAAoB,QAAqB;AAArB;AAChB,QAAI,CAAC,OAAO,KAAM,OAAM,IAAI,MAAM,sBAAsB;AAGxD,UAAM,SAAS,OAAO,KAAK,UAAU,OAAO,KAAK,SAAS;AAC1D,SAAK,cAAyB,2BAAgB;AAAA,MAC1C,MAAM,OAAO,KAAK;AAAA,MAClB,MAAM,OAAO,KAAK;AAAA,MAClB;AAAA,MACA,YAAY,SAAS,SAAY;AAAA,MACjC,KAAK,EAAE,oBAAoB,KAAK;AAAA,MAChC,MAAM;AAAA,QACF,MAAM,OAAO,KAAK;AAAA,QAClB,MAAM,OAAO,KAAK;AAAA,MACtB;AAAA,IACJ,CAAC;AAAA,EACL;AAAA,EAhBoB;AAAA,EAFZ;AAAA,EAoBR,MAAM,KAAK,SAAuB;AAC9B,UAAM,OAAO,QAAQ,QAAQ,KAAK,OAAO;AACzC,QAAI,CAAC,KAAM,OAAM,IAAI,MAAM,uBAAuB;AAElD,UAAM,OAAO,MAAM,KAAK,YAAY,SAAS;AAAA,MACzC,MAAM,KAAK,OAAO,IAAI,KAAK,IAAI,MAAM,KAAK,KAAK,MAAM,KAAK;AAAA,MAC1D,IAAI,MAAM,QAAQ,QAAQ,EAAE,IAAI,QAAQ,GAAG,KAAK,IAAI,IAAI,QAAQ;AAAA,MAChE,SAAS,QAAQ;AAAA,MACjB,MAAM,QAAQ;AAAA,MACd,MAAM,QAAQ;AAAA,MACd,IAAI,QAAQ,KAAM,MAAM,QAAQ,QAAQ,EAAE,IAAI,QAAQ,GAAG,KAAK,IAAI,IAAI,QAAQ,KAAM;AAAA,MACpF,KAAK,QAAQ,MAAO,MAAM,QAAQ,QAAQ,GAAG,IAAI,QAAQ,IAAI,KAAK,IAAI,IAAI,QAAQ,MAAO;AAAA,MACzF,SAAS,QAAQ;AAAA,MACjB,aAAa,QAAQ,aAAa,IAAI,QAAM;AAAA,QACxC,UAAU,EAAE;AAAA,QACZ,SAAS,OAAO,EAAE,YAAY,WAAW,EAAE,UAAU,OAAO,KAAK,EAAE,OAAO;AAAA,QAC1E,aAAa,EAAE;AAAA,MACnB,EAAE;AAAA,IACN,CAAC;AAED,WAAO,EAAE,WAAY,KAAa,WAAW,SAAS,KAAK;AAAA,EAC/D;AAAA,EAEA,MAAM,aAAa,eAAuB,KAAwB,OAAuE;AAGrI,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACxD;AACJ;","names":[]}

package/dist/chunk-H6SSV4G4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/ses.ts"],"sourcesContent":["import type { EmailAdapter, EmailConfig, EmailMessage, TemplateData } from \"../types\";\n\n/**\n * Minimal structural shape of the value returned by\n * `@aws-sdk/client-sesv2`'s `SendEmailCommand` constructor. We only need\n * an opaque object to hand back to `client.send`, so typing it as an\n * unknown-bearing record keeps `tsc` happy without the SDK installed.\n */\nexport interface SesCommand {\n    readonly input: unknown;\n}\n\n/**\n * Structural type for the SESv2 client. Declared locally so this module\n * type-checks even when `@aws-sdk/client-sesv2` is not installed; the real\n * SDK client satisfies this shape at runtime.\n */\nexport interface SesClient {\n    send(command: SesCommand): Promise<{ MessageId?: string }>;\n}\n\n/** Factory that builds a `SendEmailCommand` from its input object. */\nexport type SesCommandFactory = (input: unknown) => SesCommand;\n\nexport interface SesAdapterDeps {\n    /** Pre-built client (used by tests to avoid importing the real SDK). */\n    client?: SesClient;\n    /** Pre-built command factory (used by tests to avoid importing the real SDK). */\n    sendEmailCommand?: SesCommandFactory;\n}\n\nexport class SesEmailAdapter implements EmailAdapter {\n    private region?: string;\n    private defaultFrom?: { name?: string; email: string };\n    private injectedClient?: SesClient;\n    private injectedCommand?: SesCommandFactory;\n\n    constructor(config: EmailConfig, deps: SesAdapterDeps = {}) {\n        // The effective `from` address is validated at send time (it can come\n        // from the message or the config), so construction stays permissive.\n        this.region = config.region;\n        this.defaultFrom = config.from;\n        this.injectedClient = deps.client;\n        this.injectedCommand = deps.sendEmailCommand;\n    }\n\n    private async resolveSdk(): Promise<{ client: SesClient; command: SesCommandFactory }> {\n        if (this.injectedClient && this.injectedCommand) {\n            return { client: this.injectedClient, command: this.injectedCommand };\n        }\n\n        // Lazy load only when actually sending so `tsc`/`bun test` stay green\n        // without `@aws-sdk/client-sesv2` installed. The specifier is held in a\n        // variable so TypeScript does not try to resolve the module at compile\n        // time (it is a real runtime dependency, declared in package.json).\n        const sdkModule = \"@aws-sdk/client-sesv2\";\n        const mod: any = await import(sdkModule);\n        const SESv2Client = mod.SESv2Client as new (cfg: { region?: string }) => SesClient;\n        const SendEmailCommand = mod.SendEmailCommand as new (input: unknown) => SesCommand;\n\n        const client = this.injectedClient ?? new SESv2Client({ region: this.region });\n        const command: SesCommandFactory = this.injectedCommand ?? ((input) => new SendEmailCommand(input));\n\n        return { client, command };\n    }\n\n    async send(message: EmailMessage): Promise<{ messageId: string; success: boolean }> {\n        const from = message.from || this.defaultFrom;\n        if (!from) throw new Error(\"From address required\");\n\n        const { client, command } = await this.resolveSdk();\n\n        const toAddresses = Array.isArray(message.to) ? message.to : [message.to];\n        const ccAddresses = message.cc ? (Array.isArray(message.cc) ? message.cc : [message.cc]) : undefined;\n        const bccAddresses = message.bcc ? (Array.isArray(message.bcc) ? message.bcc : [message.bcc]) : undefined;\n\n        const body: Record<string, { Data: string; Charset: string }> = {};\n        if (message.text) body.Text = { Data: message.text, Charset: \"UTF-8\" };\n        if (message.html) body.Html = { Data: message.html, Charset: \"UTF-8\" };\n\n        const input = {\n            FromEmailAddress: from.name ? `${from.name} <${from.email}>` : from.email,\n            Destination: {\n                ToAddresses: toAddresses,\n                ...(ccAddresses ? { CcAddresses: ccAddresses } : {}),\n                ...(bccAddresses ? { BccAddresses: bccAddresses } : {}),\n            },\n            ...(message.replyTo ? { ReplyToAddresses: [message.replyTo] } : {}),\n            Content: {\n                Simple: {\n                    Subject: { Data: message.subject, Charset: \"UTF-8\" },\n                    Body: body,\n                },\n            },\n        };\n\n        const result = await client.send(command(input));\n        return { messageId: result.MessageId ?? \"\", success: true };\n    }\n\n    async sendTemplate(_templateName: string, _to: string | string[], _data: TemplateData): Promise<{ messageId: string; success: boolean }> {\n        // No template engine is implemented yet; fail loudly rather than\n        // silently sending a placeholder body that looks like a real send.\n        throw new Error(\"sendTemplate not supported by ses\");\n    }\n}\n"],"mappings":";AA+BO,IAAM,kBAAN,MAA8C;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,QAAqB,OAAuB,CAAC,GAAG;AAGxD,SAAK,SAAS,OAAO;AACrB,SAAK,cAAc,OAAO;AAC1B,SAAK,iBAAiB,KAAK;AAC3B,SAAK,kBAAkB,KAAK;AAAA,EAChC;AAAA,EAEA,MAAc,aAAyE;AACnF,QAAI,KAAK,kBAAkB,KAAK,iBAAiB;AAC7C,aAAO,EAAE,QAAQ,KAAK,gBAAgB,SAAS,KAAK,gBAAgB;AAAA,IACxE;AAMA,UAAM,YAAY;AAClB,UAAM,MAAW,MAAM,OAAO;AAC9B,UAAM,cAAc,IAAI;AACxB,UAAM,mBAAmB,IAAI;AAE7B,UAAM,SAAS,KAAK,kBAAkB,IAAI,YAAY,EAAE,QAAQ,KAAK,OAAO,CAAC;AAC7E,UAAM,UAA6B,KAAK,oBAAoB,CAAC,UAAU,IAAI,iBAAiB,KAAK;AAEjG,WAAO,EAAE,QAAQ,QAAQ;AAAA,EAC7B;AAAA,EAEA,MAAM,KAAK,SAAyE;AAChF,UAAM,OAAO,QAAQ,QAAQ,KAAK;AAClC,QAAI,CAAC,KAAM,OAAM,IAAI,MAAM,uBAAuB;AAElD,UAAM,EAAE,QAAQ,QAAQ,IAAI,MAAM,KAAK,WAAW;AAElD,UAAM,cAAc,MAAM,QAAQ,QAAQ,EAAE,IAAI,QAAQ,KAAK,CAAC,QAAQ,EAAE;AACxE,UAAM,cAAc,QAAQ,KAAM,MAAM,QAAQ,QAAQ,EAAE,IAAI,QAAQ,KAAK,CAAC,QAAQ,EAAE,IAAK;AAC3F,UAAM,eAAe,QAAQ,MAAO,MAAM,QAAQ,QAAQ,GAAG,IAAI,QAAQ,MAAM,CAAC,QAAQ,GAAG,IAAK;AAEhG,UAAM,OAA0D,CAAC;AACjE,QAAI,QAAQ,KAAM,MAAK,OAAO,EAAE,MAAM,QAAQ,MAAM,SAAS,QAAQ;AACrE,QAAI,QAAQ,KAAM,MAAK,OAAO,EAAE,MAAM,QAAQ,MAAM,SAAS,QAAQ;AAErE,UAAM,QAAQ;AAAA,MACV,kBAAkB,KAAK,OAAO,GAAG,KAAK,IAAI,KAAK,KAAK,KAAK,MAAM,KAAK;AAAA,MACpE,aAAa;AAAA,QACT,aAAa;AAAA,QACb,GAAI,cAAc,EAAE,aAAa,YAAY,IAAI,CAAC;AAAA,QAClD,GAAI,eAAe,EAAE,cAAc,aAAa,IAAI,CAAC;AAAA,MACzD;AAAA,MACA,GAAI,QAAQ,UAAU,EAAE,kBAAkB,CAAC,QAAQ,OAAO,EAAE,IAAI,CAAC;AAAA,MACjE,SAAS;AAAA,QACL,QAAQ;AAAA,UACJ,SAAS,EAAE,MAAM,QAAQ,SAAS,SAAS,QAAQ;AAAA,UACnD,MAAM;AAAA,QACV;AAAA,MACJ;AAAA,IACJ;AAEA,UAAM,SAAS,MAAM,OAAO,KAAK,QAAQ,KAAK,CAAC;AAC/C,WAAO,EAAE,WAAW,OAAO,aAAa,IAAI,SAAS,KAAK;AAAA,EAC9D;AAAA,EAEA,MAAM,aAAa,eAAuB,KAAwB,OAAuE;AAGrI,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACvD;AACJ;","names":[]}

package/dist/chunk-P5HWUNVS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/mailgun.ts"],"sourcesContent":["import type { EmailAdapter, EmailMessage, EmailConfig, TemplateData } from \"../types\";\n\n/**\n * Outbound custom mail headers callers are permitted to set. Anything outside\n * this set is rejected so a caller cannot spoof Reply-To / Sender / routing\n * headers via the generic `headers` map.\n */\nconst ALLOWED_HEADERS = new Set([\n    \"reply-to\",\n    \"in-reply-to\",\n    \"references\",\n    \"list-unsubscribe\",\n    \"list-unsubscribe-post\",\n    \"list-id\",\n    \"x-mailgun-variables\",\n    \"x-mailgun-tag\",\n]);\n\n/**\n * Truncate a header value at the first CR/LF. Anything after a line break is an\n * injected header (or folded continuation) and must be dropped, not preserved.\n */\nconst stripCrlf = (value: string): string => value.split(/[\\r\\n]/)[0] ?? \"\";\n\nexport class MailgunEmailAdapter implements EmailAdapter {\n    private apiKey: string;\n    private domain: string;\n    private baseUrl: string;\n    private defaultFrom?: { name?: string; email: string };\n\n    constructor(config: EmailConfig) {\n        if (!config.apiKey) throw new Error(\"Mailgun requires apiKey\");\n        if (!config.domain) throw new Error(\"Mailgun requires domain\");\n\n        this.apiKey = config.apiKey;\n        this.domain = config.domain;\n        this.baseUrl = config.baseUrl || \"https://api.mailgun.net/v3\";\n        this.defaultFrom = config.from;\n    }\n\n    async send(message: EmailMessage): Promise<{ messageId: string; success: boolean }> {\n        const form = new FormData();\n\n        const from = message.from || this.defaultFrom;\n        if (from) {\n            form.append(\"from\", from.name ? `${from.name} <${from.email}>` : from.email);\n        }\n\n        const to = Array.isArray(message.to) ? message.to.join(\",\") : message.to;\n        form.append(\"to\", to);\n        form.append(\"subject\", message.subject);\n\n        if (message.text) form.append(\"text\", message.text);\n        if (message.html) form.append(\"html\", message.html);\n        if (message.cc) form.append(\"cc\", Array.isArray(message.cc) ? message.cc.join(\",\") : message.cc);\n        if (message.bcc) form.append(\"bcc\", Array.isArray(message.bcc) ? message.bcc.join(\",\") : message.bcc);\n        if (message.replyTo) form.append(\"h:Reply-To\", message.replyTo);\n\n        if (message.headers) {\n            for (const [key, value] of Object.entries(message.headers)) {\n                if (!ALLOWED_HEADERS.has(key.toLowerCase())) {\n                    throw new Error(`Header \"${key}\" is not allowed`);\n                }\n                form.append(`h:${key}`, stripCrlf(value));\n            }\n        }\n\n        if (message.attachments) {\n            for (const att of message.attachments) {\n                const content = typeof att.content === \"string\"\n                    ? new TextEncoder().encode(att.content)\n                    : att.content;\n                const bytes = new Uint8Array(content);\n                const blob = new Blob([bytes], { type: att.contentType || \"application/octet-stream\" });\n                form.append(\"attachment\", blob, att.filename);\n            }\n        }\n\n        const response = await fetch(`${this.baseUrl}/${this.domain}/messages`, {\n            method: \"POST\",\n            headers: {\n                Authorization: \"Basic \" + btoa(`api:${this.apiKey}`),\n            },\n            body: form,\n        });\n\n        if (!response.ok) {\n            const errorText = await response.text();\n            throw new Error(`Mailgun API error (${response.status}): ${errorText}`);\n        }\n\n        const result = await response.json() as { id: string; message: string };\n        return { messageId: result.id, success: true };\n    }\n\n    async sendTemplate(_templateName: string, _to: string | string[], _data: TemplateData): Promise<{ messageId: string; success: boolean }> {\n        // No template engine is implemented yet; fail loudly rather than\n        // silently sending a placeholder that looks like a real send.\n        throw new Error(\"sendTemplate not supported by mailgun\");\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/mailgun-CKVSFBJE.js

@@ -1,7 +0,0 @@
-import {
-  MailgunEmailAdapter
-} from "./chunk-P5HWUNVS.js";
-export {
-  MailgunEmailAdapter
-};
-//# sourceMappingURL=mailgun-CKVSFBJE.js.map

package/dist/sendgrid-EYSREU2M.js

@@ -1,7 +0,0 @@
-import {
-  SendGridEmailAdapter
-} from "./chunk-4256VN6L.js";
-export {
-  SendGridEmailAdapter
-};
-//# sourceMappingURL=sendgrid-EYSREU2M.js.map

package/dist/ses-KGJG5IB5.js

@@ -1,7 +0,0 @@
-import {
-  SesEmailAdapter
-} from "./chunk-H6SSV4G4.js";
-export {
-  SesEmailAdapter
-};
-//# sourceMappingURL=ses-KGJG5IB5.js.map

package/dist/smtp-GZ4DZMCQ.js

@@ -1,7 +0,0 @@
-import {
-  SmtpEmailAdapter
-} from "./chunk-4Y2FQY2L.js";
-export {
-  SmtpEmailAdapter
-};
-//# sourceMappingURL=smtp-GZ4DZMCQ.js.map