@dotpress/mailer 0.0.0-stage → 2.0.0-alpha.0

package/dist/mailjet.js

@@ -0,0 +1,104 @@
+import {
+  checkHttpOptions,
+  checkSingleReplyTo,
+  jsonBody,
+  readJson,
+  responseError,
+  stringOf
+} from "./chunk-FRMKUAF4.js";
+import {
+  base64
+} from "./chunk-2ZABFOZQ.js";
+import {
+  MailSendError
+} from "./chunk-QYVN5N3B.js";
+
+// src/providers/mailjet.ts
+var DEFAULT_BASE_URL = "https://api.mailjet.com";
+var MAX_REQUEST_BYTES = 15e6;
+var toAddress = ({ name, address }) => name ? { Email: address, Name: name } : { Email: address };
+var toBody = (message) => {
+  checkSingleReplyTo("Mailjet", message.replyTo.length);
+  const { cc, bcc, replyTo, html, text, headers, metadata } = message;
+  const attachments = message.attachments.map(
+    ({ filename, content, contentType, contentId }) => ({
+      ContentType: contentType ?? "application/octet-stream",
+      Filename: filename,
+      Base64Content: base64(content),
+      ...contentId === void 0 ? {} : { ContentID: contentId }
+    })
+  );
+  const regular = attachments.filter((item) => !("ContentID" in item));
+  const inline = attachments.filter((item) => "ContentID" in item);
+  return {
+    Messages: [
+      {
+        From: toAddress(message.from),
+        To: message.to.map(toAddress),
+        ...cc.length > 0 ? { Cc: cc.map(toAddress) } : {},
+        ...bcc.length > 0 ? { Bcc: bcc.map(toAddress) } : {},
+        ...replyTo.length > 0 ? { ReplyTo: toAddress(replyTo[0]) } : {},
+        Subject: message.subject,
+        ...text === "" ? {} : { TextPart: text },
+        ...html === void 0 || html === "" ? {} : { HTMLPart: html },
+        ...Object.keys(headers).length > 0 ? { Headers: { ...headers } } : {},
+        ...regular.length > 0 ? { Attachments: regular } : {},
+        ...inline.length > 0 ? { InlinedAttachments: inline } : {},
+        // Mailjet has no tags; metadata is returned by the event webhooks.
+        ...Object.keys(metadata).length > 0 ? { EventPayload: JSON.stringify(metadata) } : {}
+      }
+    ]
+  };
+};
+var errorsOf = (result) => {
+  const [first] = result?.Messages ?? [];
+  const messages = (first?.Errors ?? []).map((error) => stringOf(error, "ErrorMessage")).filter((message) => message !== void 0);
+  if (messages.length > 0) return messages.join("; ");
+  return stringOf(result, "ErrorMessage");
+};
+var messageIdOf = (result) => {
+  const [first] = result?.Messages ?? [];
+  const recipient = first?.To?.[0];
+  if (typeof recipient?.MessageUUID === "string") return recipient.MessageUUID;
+  return typeof recipient?.MessageID === "number" ? String(recipient.MessageID) : void 0;
+};
+var createMailjetProvider = (options) => {
+  const { values, baseUrl, fetch } = checkHttpOptions(
+    "createMailjetProvider()",
+    options,
+    ["apiKey", "apiSecret"],
+    DEFAULT_BASE_URL
+  );
+  const url = `${baseUrl}/v3.1/send`;
+  const authorization = `Basic ${base64(`${values.apiKey}:${values.apiSecret}`)}`;
+  return {
+    name: "mailjet",
+    send: async (message) => {
+      const body = jsonBody("Mailjet", toBody(message), MAX_REQUEST_BYTES);
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { authorization, "content-type": "application/json" },
+        body
+      });
+      const result = await readJson(response);
+      if (!response.ok) {
+        throw responseError("mailjet", response, errorsOf(result));
+      }
+      const [first] = result?.Messages ?? [];
+      if (first?.Status === "error") {
+        const code = first.Errors?.[0]?.StatusCode;
+        const status = typeof code === "number" ? code : void 0;
+        throw new MailSendError(
+          "mailjet",
+          `${status ?? ""} ${errorsOf(result) ?? "message rejected"}`.trim(),
+          { status }
+        );
+      }
+      return { messageId: messageIdOf(result) };
+    }
+  };
+};
+export {
+  createMailjetProvider
+};
+//# sourceMappingURL=mailjet.js.map

package/dist/mailjet.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/mailjet.ts"],"sourcesContent":["import { base64 } from '../encoding.js'\nimport { MailSendError } from '../errors.js'\nimport type { MailProvider } from '../mailer.js'\nimport type { Address, MailMessage } from '../message.js'\nimport {\n  checkHttpOptions,\n  checkSingleReplyTo,\n  jsonBody,\n  readJson,\n  responseError,\n  stringOf,\n  type HttpProviderOptions,\n} from './http.js'\n\n/** Options of `createMailjetProvider()`. */\nexport interface MailjetProviderOptions extends HttpProviderOptions {\n  /** API key (public). */\n  apiKey: string\n  /** Secret key (private). */\n  apiSecret: string\n  /** Base URL of the API. Defaults to `https://api.mailjet.com`. */\n  baseUrl?: string | undefined\n}\n\nconst DEFAULT_BASE_URL = 'https://api.mailjet.com'\nconst MAX_REQUEST_BYTES = 15_000_000\n\nconst toAddress = ({ name, address }: Address) =>\n  name ? { Email: address, Name: name } : { Email: address }\n\n/** Body of the Send API v3.1, see https://dev.mailjet.com/email/reference/send-emails/ */\nconst toBody = (message: MailMessage) => {\n  checkSingleReplyTo('Mailjet', message.replyTo.length)\n  const { cc, bcc, replyTo, html, text, headers, metadata } = message\n  const attachments = message.attachments.map(\n    ({ filename, content, contentType, contentId }) => ({\n      ContentType: contentType ?? 'application/octet-stream',\n      Filename: filename,\n      Base64Content: base64(content),\n      ...(contentId === undefined ? {} : { ContentID: contentId }),\n    })\n  )\n  const regular = attachments.filter((item) => !('ContentID' in item))\n  const inline = attachments.filter((item) => 'ContentID' in item)\n  return {\n    Messages: [\n      {\n        From: toAddress(message.from),\n        To: message.to.map(toAddress),\n        ...(cc.length > 0 ? { Cc: cc.map(toAddress) } : {}),\n        ...(bcc.length > 0 ? { Bcc: bcc.map(toAddress) } : {}),\n        ...(replyTo.length > 0 ? { ReplyTo: toAddress(replyTo[0]!) } : {}),\n        Subject: message.subject,\n        ...(text === '' ? {} : { TextPart: text }),\n        ...(html === undefined || html === '' ? {} : { HTMLPart: html }),\n        ...(Object.keys(headers).length > 0 ? { Headers: { ...headers } } : {}),\n        ...(regular.length > 0 ? { Attachments: regular } : {}),\n        ...(inline.length > 0 ? { InlinedAttachments: inline } : {}),\n        // Mailjet has no tags; metadata is returned by the event webhooks.\n        ...(Object.keys(metadata).length > 0\n          ? { EventPayload: JSON.stringify(metadata) }\n          : {}),\n      },\n    ],\n  }\n}\n\ninterface MailjetError {\n  ErrorMessage?: unknown\n  StatusCode?: unknown\n}\n\n/** Errors of the response, at the message level or at the top level. */\nconst errorsOf = (result: unknown): string | undefined => {\n  const [first] =\n    (result as { Messages?: { Errors?: MailjetError[] }[] } | undefined)\n      ?.Messages ?? []\n  const messages = (first?.Errors ?? [])\n    .map((error) => stringOf(error, 'ErrorMessage'))\n    .filter((message) => message !== undefined)\n  if (messages.length > 0) return messages.join('; ')\n  return stringOf(result, 'ErrorMessage')\n}\n\n/** Identifier of the message for the first recipient of `to`. */\nconst messageIdOf = (result: unknown) => {\n  const [first] =\n    (\n      result as\n        | {\n            Messages?: {\n              To?: { MessageUUID?: unknown; MessageID?: unknown }[]\n            }[]\n          }\n        | undefined\n    )?.Messages ?? []\n  const recipient = first?.To?.[0]\n  if (typeof recipient?.MessageUUID === 'string') return recipient.MessageUUID\n  return typeof recipient?.MessageID === 'number'\n    ? String(recipient.MessageID)\n    : undefined\n}\n\n/**\n * Creates a provider that sends messages with the Send API v3.1 of\n * [Mailjet](https://www.mailjet.com), through `fetch`: no dependency.\n *\n * ```ts\n * const provider = createMailjetProvider({\n *   apiKey: process.env.MAILJET_API_KEY!,\n *   apiSecret: process.env.MAILJET_API_SECRET!,\n * })\n * ```\n */\nexport const createMailjetProvider = (\n  options: MailjetProviderOptions\n): MailProvider => {\n  const { values, baseUrl, fetch } = checkHttpOptions(\n    'createMailjetProvider()',\n    options,\n    ['apiKey', 'apiSecret'],\n    DEFAULT_BASE_URL\n  )\n  const url = `${baseUrl}/v3.1/send`\n  const authorization = `Basic ${base64(`${values.apiKey}:${values.apiSecret}`)}`\n\n  return {\n    name: 'mailjet',\n    send: async (message) => {\n      const body = jsonBody('Mailjet', toBody(message), MAX_REQUEST_BYTES)\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { authorization, 'content-type': 'application/json' },\n        body,\n      })\n      const result = await readJson(response)\n      if (!response.ok) {\n        throw responseError('mailjet', response, errorsOf(result))\n      }\n      const [first] =\n        (\n          result as\n            | { Messages?: { Status?: unknown; Errors?: MailjetError[] }[] }\n            | undefined\n        )?.Messages ?? []\n      // A message can fail in a successful response.\n      if (first?.Status === 'error') {\n        const code = first.Errors?.[0]?.StatusCode\n        const status = typeof code === 'number' ? code : undefined\n        throw new MailSendError(\n          'mailjet',\n          `${status ?? ''} ${errorsOf(result) ?? 'message rejected'}`.trim(),\n          { status }\n        )\n      }\n      return { messageId: messageIdOf(result) }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/plugin.d.ts

@@ -0,0 +1,33 @@
+import * as _dotpress_core from '@dotpress/core';
+import { Mailer } from './index.js';
+import 'zod';
+
+declare module '@dotpress/core' {
+    interface RequestContext {
+        /** Mailer (`mailerPlugin`), logging with the request logger. */
+        mailer: Mailer;
+    }
+}
+/**
+ * Provides `ctx.mailer` to routes and middlewares. Sent messages are
+ * logged with the request logger (request ID).
+ *
+ * ```ts
+ * await createApp({ adapter, plugins: [mailerPlugin(mailer)] })
+ *
+ * defineRoute({
+ *   method: 'post',
+ *   path: '/invitations',
+ *   handler: async ({ mailer, body }) => {
+ *     await mailer.send(invitation, { to: body.email, data: { … } })
+ *   },
+ * })
+ * ```
+ */
+declare const mailerPlugin: (mailer: Mailer) => {
+    readonly name: "mailer";
+    readonly mailer: Mailer;
+    readonly setup: (api: _dotpress_core.PluginAPI) => void;
+};
+
+export { mailerPlugin };

package/dist/plugin.js

@@ -0,0 +1,21 @@
+// src/plugin.ts
+import { declareContextKey, definePlugin } from "@dotpress/core";
+declareContextKey("mailer", "mailerPlugin");
+var mailerPlugin = (mailer) => {
+  if (typeof mailer?.withLogger !== "function") {
+    throw new TypeError(
+      "mailerPlugin(): expected a mailer created by createMailer()."
+    );
+  }
+  return definePlugin({
+    name: "mailer",
+    mailer,
+    setup(api) {
+      api.decorateContext("mailer", (ctx) => mailer.withLogger(ctx.logger));
+    }
+  });
+};
+export {
+  mailerPlugin
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import { declareContextKey, definePlugin } from '@dotpress/core'\nimport type { Mailer } from './mailer.js'\n\ndeclare module '@dotpress/core' {\n  interface RequestContext {\n    /** Mailer (`mailerPlugin`), logging with the request logger. */\n    mailer: Mailer\n  }\n}\n\n// Accessing ctx.mailer without the plugin throws an explicit error.\ndeclareContextKey('mailer', 'mailerPlugin')\n\n/**\n * Provides `ctx.mailer` to routes and middlewares. Sent messages are\n * logged with the request logger (request ID).\n *\n * ```ts\n * await createApp({ adapter, plugins: [mailerPlugin(mailer)] })\n *\n * defineRoute({\n *   method: 'post',\n *   path: '/invitations',\n *   handler: async ({ mailer, body }) => {\n *     await mailer.send(invitation, { to: body.email, data: { … } })\n *   },\n * })\n * ```\n */\nexport const mailerPlugin = (mailer: Mailer) => {\n  if (typeof mailer?.withLogger !== 'function') {\n    throw new TypeError(\n      'mailerPlugin(): expected a mailer created by createMailer().'\n    )\n  }\n  return definePlugin({\n    name: 'mailer',\n    mailer,\n    setup(api) {\n      api.decorateContext('mailer', (ctx) => mailer.withLogger(ctx.logger))\n    },\n  })\n}\n"],"mappings":";AAAA,SAAS,mBAAmB,oBAAoB;AAWhD,kBAAkB,UAAU,cAAc;AAkBnC,IAAM,eAAe,CAAC,WAAmB;AAC9C,MAAI,OAAO,QAAQ,eAAe,YAAY;AAC5C,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO,aAAa;AAAA,IAClB,MAAM;AAAA,IACN;AAAA,IACA,MAAM,KAAK;AACT,UAAI,gBAAgB,UAAU,CAAC,QAAQ,OAAO,WAAW,IAAI,MAAM,CAAC;AAAA,IACtE;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/postmark.d.ts

@@ -0,0 +1,27 @@
+import { MailProvider } from './index.js';
+import { HttpProviderOptions } from './index.js';
+import 'zod';
+
+/** Options of `createPostmarkProvider()`. */
+interface PostmarkProviderOptions extends HttpProviderOptions {
+    /** Server API token. `POSTMARK_API_TEST` sends nothing (test mode). */
+    serverToken: string;
+    /** Message stream. Defaults to the transactional stream (`outbound`). */
+    messageStream?: string | undefined;
+    /** Base URL of the API. Defaults to `https://api.postmarkapp.com`. */
+    baseUrl?: string | undefined;
+}
+/**
+ * Creates a provider that sends messages with the Email API of
+ * [Postmark](https://postmarkapp.com), through `fetch`: no dependency.
+ *
+ * ```ts
+ * const provider = createPostmarkProvider({
+ *   serverToken: process.env.POSTMARK_SERVER_TOKEN!,
+ * })
+ * ```
+ */
+declare const createPostmarkProvider: (options: PostmarkProviderOptions) => MailProvider;
+
+export { createPostmarkProvider };
+export type { PostmarkProviderOptions };

package/dist/postmark.js

@@ -0,0 +1,149 @@
+import {
+  checkHttpOptions,
+  jsonBody,
+  readJson,
+  responseError,
+  stringOf
+} from "./chunk-FRMKUAF4.js";
+import {
+  base64
+} from "./chunk-2ZABFOZQ.js";
+import {
+  MailMessageError,
+  formatAddress
+} from "./chunk-QYVN5N3B.js";
+
+// src/providers/postmark.ts
+var DEFAULT_BASE_URL = "https://api.postmarkapp.com";
+var MAX_RECIPIENTS = 50;
+var MAX_ADDRESS_LENGTH = 254;
+var MAX_FROM_LENGTH = 255;
+var MAX_SUBJECT_LENGTH = 2e3;
+var MAX_REQUEST_BYTES = 1e7;
+var FORBIDDEN_EXTENSIONS = new Set(
+  "vbs exe bin bat chm com cpl crt hlp hta inf ins isp jse lnk mdb pcd pif reg scr sct shs vbe vba wsf wsh wsl msc msi msp mst".split(
+    " "
+  )
+);
+var fail = (message) => {
+  throw new MailMessageError(`Postmark ${message}`);
+};
+var checkLimits = (message) => {
+  const recipients = [...message.to, ...message.cc, ...message.bcc];
+  if (recipients.length > MAX_RECIPIENTS) {
+    fail(
+      `accepts at most ${MAX_RECIPIENTS} recipients (to, cc and bcc), got ${recipients.length}.`
+    );
+  }
+  const long = [...recipients, ...message.replyTo].find(
+    ({ address }) => address.length > MAX_ADDRESS_LENGTH
+  );
+  if (long) {
+    fail(
+      `accepts addresses of at most ${MAX_ADDRESS_LENGTH} characters: ${long.address.slice(0, 20)}\u2026 has ${long.address.length}.`
+    );
+  }
+  if (formatAddress(message.from).length > MAX_FROM_LENGTH) {
+    fail(`accepts a sender of at most ${MAX_FROM_LENGTH} characters.`);
+  }
+  if (message.subject.length > MAX_SUBJECT_LENGTH) {
+    fail(
+      `accepts subjects of at most ${MAX_SUBJECT_LENGTH} characters, got ${message.subject.length}.`
+    );
+  }
+  if (message.tags.length > 1) {
+    fail(`accepts a single tag, got ${message.tags.length}.`);
+  }
+  for (const { filename } of message.attachments) {
+    const extension = /\.([^.]+)$/.exec(filename)?.[1]?.toLowerCase();
+    if (extension && FORBIDDEN_EXTENSIONS.has(extension)) {
+      fail(`does not accept .${extension} attachments (${filename}).`);
+    }
+  }
+};
+var list = (addresses) => addresses.map(formatAddress).join(", ");
+var toBody = (message, messageStream) => {
+  checkLimits(message);
+  const { cc, bcc, replyTo, html, text, attachments, headers } = message;
+  const [tag] = message.tags;
+  return {
+    From: formatAddress(message.from),
+    To: list(message.to),
+    ...cc.length > 0 ? { Cc: list(cc) } : {},
+    ...bcc.length > 0 ? { Bcc: list(bcc) } : {},
+    ...replyTo.length > 0 ? { ReplyTo: list(replyTo) } : {},
+    Subject: message.subject,
+    ...text === "" ? {} : { TextBody: text },
+    ...html === void 0 || html === "" ? {} : { HtmlBody: html },
+    ...Object.keys(headers).length > 0 ? {
+      Headers: Object.entries(headers).map(([Name, Value]) => ({
+        Name,
+        Value
+      }))
+    } : {},
+    ...attachments.length > 0 ? {
+      Attachments: attachments.map(
+        ({ filename, content, contentType, contentId }) => ({
+          Name: filename,
+          Content: base64(content),
+          ContentType: contentType ?? "application/octet-stream",
+          ...contentId === void 0 ? {} : { ContentID: `cid:${contentId}` }
+        })
+      )
+    } : {},
+    // Left out of the JSON when undefined.
+    Tag: tag,
+    ...Object.keys(message.metadata).length > 0 ? { Metadata: { ...message.metadata } } : {},
+    ...messageStream === void 0 ? {} : { MessageStream: messageStream }
+  };
+};
+var createPostmarkProvider = (options) => {
+  const { values, baseUrl, fetch } = checkHttpOptions(
+    "createPostmarkProvider()",
+    options,
+    ["serverToken"],
+    DEFAULT_BASE_URL,
+    ["messageStream"]
+  );
+  const { serverToken, messageStream } = values;
+  if (messageStream !== void 0 && (typeof messageStream !== "string" || messageStream === "")) {
+    throw new TypeError(
+      "createPostmarkProvider(): messageStream must be a non-empty string."
+    );
+  }
+  const url = `${baseUrl}/email`;
+  return {
+    name: "postmark",
+    send: async (message) => {
+      const body = jsonBody(
+        "Postmark",
+        toBody(message, messageStream),
+        MAX_REQUEST_BYTES
+      );
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          accept: "application/json",
+          "content-type": "application/json",
+          "x-postmark-server-token": serverToken
+        },
+        body
+      });
+      const result = await readJson(response);
+      if (!response.ok) {
+        const detail = stringOf(result, "Message");
+        const code = result?.ErrorCode;
+        throw responseError(
+          "postmark",
+          response,
+          detail && typeof code === "number" ? `${detail} (ErrorCode ${code})` : detail
+        );
+      }
+      return { messageId: stringOf(result, "MessageID") };
+    }
+  };
+};
+export {
+  createPostmarkProvider
+};
+//# sourceMappingURL=postmark.js.map

package/dist/postmark.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/postmark.ts"],"sourcesContent":["import { base64 } from '../encoding.js'\nimport { MailMessageError } from '../errors.js'\nimport type { MailProvider } from '../mailer.js'\nimport { formatAddress, type Address, type MailMessage } from '../message.js'\nimport {\n  checkHttpOptions,\n  jsonBody,\n  readJson,\n  responseError,\n  stringOf,\n  type HttpProviderOptions,\n} from './http.js'\n\n/** Options of `createPostmarkProvider()`. */\nexport interface PostmarkProviderOptions extends HttpProviderOptions {\n  /** Server API token. `POSTMARK_API_TEST` sends nothing (test mode). */\n  serverToken: string\n  /** Message stream. Defaults to the transactional stream (`outbound`). */\n  messageStream?: string | undefined\n  /** Base URL of the API. Defaults to `https://api.postmarkapp.com`. */\n  baseUrl?: string | undefined\n}\n\nconst DEFAULT_BASE_URL = 'https://api.postmarkapp.com'\n\n// Limits of the Email API.\nconst MAX_RECIPIENTS = 50\nconst MAX_ADDRESS_LENGTH = 254\nconst MAX_FROM_LENGTH = 255\nconst MAX_SUBJECT_LENGTH = 2000\nconst MAX_REQUEST_BYTES = 10_000_000\nconst FORBIDDEN_EXTENSIONS = new Set(\n  'vbs exe bin bat chm com cpl crt hlp hta inf ins isp jse lnk mdb pcd pif reg scr sct shs vbe vba wsf wsh wsl msc msi msp mst'.split(\n    ' '\n  )\n)\n\nconst fail = (message: string): never => {\n  throw new MailMessageError(`Postmark ${message}`)\n}\n\n/** Checks the limits of the Email API. */\nconst checkLimits = (message: MailMessage) => {\n  const recipients = [...message.to, ...message.cc, ...message.bcc]\n  if (recipients.length > MAX_RECIPIENTS) {\n    fail(\n      `accepts at most ${MAX_RECIPIENTS} recipients (to, cc and bcc), got ${recipients.length}.`\n    )\n  }\n  const long = [...recipients, ...message.replyTo].find(\n    ({ address }) => address.length > MAX_ADDRESS_LENGTH\n  )\n  if (long) {\n    fail(\n      `accepts addresses of at most ${MAX_ADDRESS_LENGTH} characters: ${long.address.slice(0, 20)}… has ${long.address.length}.`\n    )\n  }\n  if (formatAddress(message.from).length > MAX_FROM_LENGTH) {\n    fail(`accepts a sender of at most ${MAX_FROM_LENGTH} characters.`)\n  }\n  if (message.subject.length > MAX_SUBJECT_LENGTH) {\n    fail(\n      `accepts subjects of at most ${MAX_SUBJECT_LENGTH} characters, got ${message.subject.length}.`\n    )\n  }\n  if (message.tags.length > 1) {\n    fail(`accepts a single tag, got ${message.tags.length}.`)\n  }\n  for (const { filename } of message.attachments) {\n    const extension = /\\.([^.]+)$/.exec(filename)?.[1]?.toLowerCase()\n    if (extension && FORBIDDEN_EXTENSIONS.has(extension)) {\n      fail(`does not accept .${extension} attachments (${filename}).`)\n    }\n  }\n}\n\nconst list = (addresses: readonly Address[]) =>\n  addresses.map(formatAddress).join(', ')\n\n/** Body of the Email API, see https://postmarkapp.com/developer/api/email-api */\nconst toBody = (message: MailMessage, messageStream: string | undefined) => {\n  checkLimits(message)\n  const { cc, bcc, replyTo, html, text, attachments, headers } = message\n  const [tag] = message.tags\n  return {\n    From: formatAddress(message.from),\n    To: list(message.to),\n    ...(cc.length > 0 ? { Cc: list(cc) } : {}),\n    ...(bcc.length > 0 ? { Bcc: list(bcc) } : {}),\n    ...(replyTo.length > 0 ? { ReplyTo: list(replyTo) } : {}),\n    Subject: message.subject,\n    ...(text === '' ? {} : { TextBody: text }),\n    ...(html === undefined || html === '' ? {} : { HtmlBody: html }),\n    ...(Object.keys(headers).length > 0\n      ? {\n          Headers: Object.entries(headers).map(([Name, Value]) => ({\n            Name,\n            Value,\n          })),\n        }\n      : {}),\n    ...(attachments.length > 0\n      ? {\n          Attachments: attachments.map(\n            ({ filename, content, contentType, contentId }) => ({\n              Name: filename,\n              Content: base64(content),\n              ContentType: contentType ?? 'application/octet-stream',\n              ...(contentId === undefined\n                ? {}\n                : { ContentID: `cid:${contentId}` }),\n            })\n          ),\n        }\n      : {}),\n    // Left out of the JSON when undefined.\n    Tag: tag,\n    ...(Object.keys(message.metadata).length > 0\n      ? { Metadata: { ...message.metadata } }\n      : {}),\n    ...(messageStream === undefined ? {} : { MessageStream: messageStream }),\n  }\n}\n\n/**\n * Creates a provider that sends messages with the Email API of\n * [Postmark](https://postmarkapp.com), through `fetch`: no dependency.\n *\n * ```ts\n * const provider = createPostmarkProvider({\n *   serverToken: process.env.POSTMARK_SERVER_TOKEN!,\n * })\n * ```\n */\nexport const createPostmarkProvider = (\n  options: PostmarkProviderOptions\n): MailProvider => {\n  const { values, baseUrl, fetch } = checkHttpOptions(\n    'createPostmarkProvider()',\n    options,\n    ['serverToken'],\n    DEFAULT_BASE_URL,\n    ['messageStream']\n  )\n  const { serverToken, messageStream } = values\n  if (\n    messageStream !== undefined &&\n    (typeof messageStream !== 'string' || messageStream === '')\n  ) {\n    throw new TypeError(\n      'createPostmarkProvider(): messageStream must be a non-empty string.'\n    )\n  }\n  const url = `${baseUrl}/email`\n\n  return {\n    name: 'postmark',\n    send: async (message) => {\n      const body = jsonBody(\n        'Postmark',\n        toBody(message, messageStream as string | undefined),\n        MAX_REQUEST_BYTES\n      )\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: {\n          accept: 'application/json',\n          'content-type': 'application/json',\n          'x-postmark-server-token': serverToken,\n        },\n        body,\n      })\n      const result = await readJson(response)\n      if (!response.ok) {\n        const detail = stringOf(result, 'Message')\n        const code = (result as { ErrorCode?: unknown } | undefined)?.ErrorCode\n        throw responseError(\n          'postmark',\n          response,\n          detail && typeof code === 'number'\n            ? `${detail} (ErrorCode ${code})`\n            : detail\n        )\n      }\n      return { messageId: stringOf(result, 'MessageID') }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/resend.d.ts

@@ -0,0 +1,31 @@
+import { CreateEmailOptions, CreateEmailResponse } from 'resend';
+import { MailProvider } from './index.js';
+import 'zod';
+
+/** A Resend client, or any object with the same `emails.send()` method. */
+interface ResendClient {
+    emails: {
+        send(payload: CreateEmailOptions): Promise<CreateEmailResponse>;
+    };
+}
+/** Options of `createResendProvider()`. */
+interface ResendProviderOptions {
+    /** API key. Defaults to the `RESEND_API_KEY` environment variable. */
+    apiKey?: string | undefined;
+    /** Base URL of the API, for the created client. */
+    baseUrl?: string | undefined;
+    /** Existing client, instead of `apiKey` and `baseUrl`. */
+    client?: ResendClient | undefined;
+}
+/**
+ * Creates a provider that sends messages with [Resend](https://resend.com),
+ * through its SDK (`resend`, peer dependency).
+ *
+ * ```ts
+ * const provider = createResendProvider({ apiKey: process.env.RESEND_API_KEY })
+ * ```
+ */
+declare const createResendProvider: (options?: ResendProviderOptions) => MailProvider;
+
+export { createResendProvider };
+export type { ResendClient, ResendProviderOptions };

package/dist/resend.js

@@ -0,0 +1,92 @@
+import {
+  keyValueTags
+} from "./chunk-GOAXQ2GE.js";
+import {
+  base64
+} from "./chunk-2ZABFOZQ.js";
+import {
+  MailSendError,
+  checkKeys,
+  formatAddress
+} from "./chunk-QYVN5N3B.js";
+
+// src/providers/resend.ts
+import {
+  Resend
+} from "resend";
+var OPTIONS = /* @__PURE__ */ new Set(["apiKey", "baseUrl", "client"]);
+var isNonEmptyString = (value) => typeof value === "string" && value !== "";
+var tagsOf = (message) => {
+  const tags = keyValueTags(message, "Resend");
+  return tags.length > 0 ? { tags } : {};
+};
+var toPayload = (message) => ({
+  from: formatAddress(message.from),
+  to: message.to.map(formatAddress),
+  ...message.cc.length > 0 ? { cc: message.cc.map(formatAddress) } : {},
+  ...message.bcc.length > 0 ? { bcc: message.bcc.map(formatAddress) } : {},
+  ...message.replyTo.length > 0 ? { replyTo: message.replyTo.map(formatAddress) } : {},
+  subject: message.subject,
+  text: message.text,
+  ...message.html === void 0 ? {} : { html: message.html },
+  ...message.attachments.length > 0 ? {
+    attachments: message.attachments.map(
+      ({ filename, content, contentType, contentId }) => ({
+        filename,
+        // Base64 works with every version of the SDK.
+        content: base64(content),
+        ...contentType === void 0 ? {} : { contentType },
+        ...contentId === void 0 ? {} : { contentId }
+      })
+    )
+  } : {},
+  ...Object.keys(message.headers).length > 0 ? { headers: { ...message.headers } } : {},
+  ...tagsOf(message)
+});
+var createResendProvider = (options = {}) => {
+  const { apiKey, baseUrl, client } = checkKeys(
+    "createResendProvider()",
+    options,
+    OPTIONS
+  );
+  if (client !== void 0) {
+    if (apiKey !== void 0 || baseUrl !== void 0) {
+      throw new TypeError(
+        "createResendProvider(): set client, or apiKey and baseUrl, not both."
+      );
+    }
+    if (typeof client?.emails?.send !== "function") {
+      throw new TypeError(
+        "createResendProvider(): client must have an emails.send() method."
+      );
+    }
+  }
+  for (const [key, value] of [
+    ["apiKey", apiKey],
+    ["baseUrl", baseUrl]
+  ]) {
+    if (value !== void 0 && !isNonEmptyString(value)) {
+      throw new TypeError(
+        `createResendProvider(): ${key} must be a non-empty string.`
+      );
+    }
+  }
+  const resend = client ?? new Resend(apiKey, baseUrl === void 0 ? void 0 : { baseUrl });
+  return {
+    name: "resend",
+    send: async (message) => {
+      const { data, error } = await resend.emails.send(toPayload(message));
+      if (error) {
+        throw new MailSendError("resend", `${error.name}: ${error.message}`, {
+          status: error.statusCode ?? void 0,
+          cause: error
+        });
+      }
+      return { messageId: data?.id };
+    }
+  };
+};
+export {
+  createResendProvider
+};
+//# sourceMappingURL=resend.js.map

package/dist/resend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/resend.ts"],"sourcesContent":["import {\n  Resend,\n  type CreateEmailOptions,\n  type CreateEmailResponse,\n} from 'resend'\nimport { base64 } from '../encoding.js'\nimport { MailSendError } from '../errors.js'\nimport type { MailProvider } from '../mailer.js'\nimport { checkKeys, formatAddress, type MailMessage } from '../message.js'\nimport { keyValueTags } from './key-value-tags.js'\n\n/** A Resend client, or any object with the same `emails.send()` method. */\nexport interface ResendClient {\n  emails: {\n    send(payload: CreateEmailOptions): Promise<CreateEmailResponse>\n  }\n}\n\n/** Options of `createResendProvider()`. */\nexport interface ResendProviderOptions {\n  /** API key. Defaults to the `RESEND_API_KEY` environment variable. */\n  apiKey?: string | undefined\n  /** Base URL of the API, for the created client. */\n  baseUrl?: string | undefined\n  /** Existing client, instead of `apiKey` and `baseUrl`. */\n  client?: ResendClient | undefined\n}\n\nconst OPTIONS = new Set(['apiKey', 'baseUrl', 'client'])\n\nconst isNonEmptyString = (value: unknown) =>\n  typeof value === 'string' && value !== ''\n\n/** Tags and metadata as Resend tags. */\nconst tagsOf = (message: MailMessage) => {\n  const tags = keyValueTags(message, 'Resend')\n  return tags.length > 0 ? { tags } : {}\n}\n\n/** Payload of the Resend API. */\nconst toPayload = (message: MailMessage): CreateEmailOptions => ({\n  from: formatAddress(message.from),\n  to: message.to.map(formatAddress),\n  ...(message.cc.length > 0 ? { cc: message.cc.map(formatAddress) } : {}),\n  ...(message.bcc.length > 0 ? { bcc: message.bcc.map(formatAddress) } : {}),\n  ...(message.replyTo.length > 0\n    ? { replyTo: message.replyTo.map(formatAddress) }\n    : {}),\n  subject: message.subject,\n  text: message.text,\n  ...(message.html === undefined ? {} : { html: message.html }),\n  ...(message.attachments.length > 0\n    ? {\n        attachments: message.attachments.map(\n          ({ filename, content, contentType, contentId }) => ({\n            filename,\n            // Base64 works with every version of the SDK.\n            content: base64(content),\n            ...(contentType === undefined ? {} : { contentType }),\n            ...(contentId === undefined ? {} : { contentId }),\n          })\n        ),\n      }\n    : {}),\n  ...(Object.keys(message.headers).length > 0\n    ? { headers: { ...message.headers } }\n    : {}),\n  ...tagsOf(message),\n})\n\n/**\n * Creates a provider that sends messages with [Resend](https://resend.com),\n * through its SDK (`resend`, peer dependency).\n *\n * ```ts\n * const provider = createResendProvider({ apiKey: process.env.RESEND_API_KEY })\n * ```\n */\nexport const createResendProvider = (\n  options: ResendProviderOptions = {}\n): MailProvider => {\n  const { apiKey, baseUrl, client } = checkKeys(\n    'createResendProvider()',\n    options,\n    OPTIONS\n  ) as ResendProviderOptions\n  if (client !== undefined) {\n    if (apiKey !== undefined || baseUrl !== undefined) {\n      throw new TypeError(\n        'createResendProvider(): set client, or apiKey and baseUrl, not both.'\n      )\n    }\n    if (typeof client?.emails?.send !== 'function') {\n      throw new TypeError(\n        'createResendProvider(): client must have an emails.send() method.'\n      )\n    }\n  }\n  for (const [key, value] of [\n    ['apiKey', apiKey],\n    ['baseUrl', baseUrl],\n  ] as const) {\n    if (value !== undefined && !isNonEmptyString(value)) {\n      throw new TypeError(\n        `createResendProvider(): ${key} must be a non-empty string.`\n      )\n    }\n  }\n\n  const resend =\n    client ??\n    new Resend(apiKey, baseUrl === undefined ? undefined : { baseUrl })\n\n  return {\n    name: 'resend',\n    send: async (message) => {\n      const { data, error } = await resend.emails.send(toPayload(message))\n      if (error) {\n        throw new MailSendError('resend', `${error.name}: ${error.message}`, {\n          status: error.statusCode ?? undefined,\n          cause: error,\n        })\n      }\n      return { messageId: data?.id }\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,OAGK;AAwBP,IAAM,UAAU,oBAAI,IAAI,CAAC,UAAU,WAAW,QAAQ,CAAC;AAEvD,IAAM,mBAAmB,CAAC,UACxB,OAAO,UAAU,YAAY,UAAU;AAGzC,IAAM,SAAS,CAAC,YAAyB;AACvC,QAAM,OAAO,aAAa,SAAS,QAAQ;AAC3C,SAAO,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC;AACvC;AAGA,IAAM,YAAY,CAAC,aAA8C;AAAA,EAC/D,MAAM,cAAc,QAAQ,IAAI;AAAA,EAChC,IAAI,QAAQ,GAAG,IAAI,aAAa;AAAA,EAChC,GAAI,QAAQ,GAAG,SAAS,IAAI,EAAE,IAAI,QAAQ,GAAG,IAAI,aAAa,EAAE,IAAI,CAAC;AAAA,EACrE,GAAI,QAAQ,IAAI,SAAS,IAAI,EAAE,KAAK,QAAQ,IAAI,IAAI,aAAa,EAAE,IAAI,CAAC;AAAA,EACxE,GAAI,QAAQ,QAAQ,SAAS,IACzB,EAAE,SAAS,QAAQ,QAAQ,IAAI,aAAa,EAAE,IAC9C,CAAC;AAAA,EACL,SAAS,QAAQ;AAAA,EACjB,MAAM,QAAQ;AAAA,EACd,GAAI,QAAQ,SAAS,SAAY,CAAC,IAAI,EAAE,MAAM,QAAQ,KAAK;AAAA,EAC3D,GAAI,QAAQ,YAAY,SAAS,IAC7B;AAAA,IACE,aAAa,QAAQ,YAAY;AAAA,MAC/B,CAAC,EAAE,UAAU,SAAS,aAAa,UAAU,OAAO;AAAA,QAClD;AAAA;AAAA,QAEA,SAAS,OAAO,OAAO;AAAA,QACvB,GAAI,gBAAgB,SAAY,CAAC,IAAI,EAAE,YAAY;AAAA,QACnD,GAAI,cAAc,SAAY,CAAC,IAAI,EAAE,UAAU;AAAA,MACjD;AAAA,IACF;AAAA,EACF,IACA,CAAC;AAAA,EACL,GAAI,OAAO,KAAK,QAAQ,OAAO,EAAE,SAAS,IACtC,EAAE,SAAS,EAAE,GAAG,QAAQ,QAAQ,EAAE,IAClC,CAAC;AAAA,EACL,GAAG,OAAO,OAAO;AACnB;AAUO,IAAM,uBAAuB,CAClC,UAAiC,CAAC,MACjB;AACjB,QAAM,EAAE,QAAQ,SAAS,OAAO,IAAI;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,MAAI,WAAW,QAAW;AACxB,QAAI,WAAW,UAAa,YAAY,QAAW;AACjD,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,QAAI,OAAO,QAAQ,QAAQ,SAAS,YAAY;AAC9C,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,aAAW,CAAC,KAAK,KAAK,KAAK;AAAA,IACzB,CAAC,UAAU,MAAM;AAAA,IACjB,CAAC,WAAW,OAAO;AAAA,EACrB,GAAY;AACV,QAAI,UAAU,UAAa,CAAC,iBAAiB,KAAK,GAAG;AACnD,YAAM,IAAI;AAAA,QACR,2BAA2B,GAAG;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SACJ,UACA,IAAI,OAAO,QAAQ,YAAY,SAAY,SAAY,EAAE,QAAQ,CAAC;AAEpE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,OAAO,YAAY;AACvB,YAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,OAAO,KAAK,UAAU,OAAO,CAAC;AACnE,UAAI,OAAO;AACT,cAAM,IAAI,cAAc,UAAU,GAAG,MAAM,IAAI,KAAK,MAAM,OAAO,IAAI;AAAA,UACnE,QAAQ,MAAM,cAAc;AAAA,UAC5B,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AACA,aAAO,EAAE,WAAW,MAAM,GAAG;AAAA,IAC/B;AAAA,EACF;AACF;","names":[]}

package/dist/scaleway.d.ts

@@ -0,0 +1,31 @@
+import { MailProvider } from './index.js';
+import { HttpProviderOptions } from './index.js';
+import 'zod';
+
+/** Options of `createScalewayProvider()`. */
+interface ScalewayProviderOptions extends HttpProviderOptions {
+    /** Secret key of an API key with access to Transactional Email. */
+    secretKey: string;
+    /** ID of the Project of the sending domain. */
+    projectId: string;
+    /** Region of the sending domain. Defaults to `fr-par`. */
+    region?: string | undefined;
+    /** Base URL of the API. Defaults to `https://api.scaleway.com`. */
+    baseUrl?: string | undefined;
+}
+/**
+ * Creates a provider that sends messages with
+ * [Scaleway Transactional Email](https://www.scaleway.com/en/transactional-email-tem/),
+ * through `fetch`: no dependency.
+ *
+ * ```ts
+ * const provider = createScalewayProvider({
+ *   secretKey: process.env.SCW_SECRET_KEY!,
+ *   projectId: process.env.SCW_DEFAULT_PROJECT_ID!,
+ * })
+ * ```
+ */
+declare const createScalewayProvider: (options: ScalewayProviderOptions) => MailProvider;
+
+export { createScalewayProvider };
+export type { ScalewayProviderOptions };

package/dist/scaleway.js

@@ -0,0 +1,113 @@
+import {
+  checkHttpOptions,
+  checkNoInline,
+  readJson,
+  responseError,
+  stringOf
+} from "./chunk-FRMKUAF4.js";
+import {
+  base64
+} from "./chunk-2ZABFOZQ.js";
+import {
+  MailMessageError,
+  formatAddress
+} from "./chunk-QYVN5N3B.js";
+
+// src/providers/scaleway.ts
+var DEFAULT_BASE_URL = "https://api.scaleway.com";
+var DEFAULT_REGION = "fr-par";
+var MAX_SUBJECT_LENGTH = 998;
+var toAddress = ({ name, address }) => name ? { email: address, name } : { email: address };
+var checkLimits = (message) => {
+  checkNoInline("Scaleway", message.attachments);
+  if (message.subject.length > MAX_SUBJECT_LENGTH) {
+    throw new MailMessageError(
+      `Scaleway accepts subjects of at most ${MAX_SUBJECT_LENGTH} characters, got ${message.subject.length}.`
+    );
+  }
+  const empty = Object.entries(message.headers).find(
+    ([, value]) => value === ""
+  );
+  if (empty) {
+    throw new MailMessageError(
+      `Scaleway does not accept empty header values (${empty[0]}).`
+    );
+  }
+};
+var toBody = (message, projectId) => {
+  checkLimits(message);
+  const { cc, bcc, replyTo, attachments } = message;
+  const headers = [
+    ...replyTo.length > 0 ? [{ key: "Reply-To", value: replyTo.map(formatAddress).join(", ") }] : [],
+    ...Object.entries(message.headers).map(([key, value]) => ({ key, value }))
+  ];
+  return {
+    from: toAddress(message.from),
+    to: message.to.map(toAddress),
+    ...cc.length > 0 ? { cc: cc.map(toAddress) } : {},
+    ...bcc.length > 0 ? { bcc: bcc.map(toAddress) } : {},
+    subject: message.subject,
+    text: message.text,
+    html: message.html ?? "",
+    project_id: projectId,
+    ...attachments.length > 0 ? {
+      attachments: attachments.map(
+        ({ filename, content, contentType }) => ({
+          name: filename,
+          type: contentType ?? "application/octet-stream",
+          content: base64(content)
+        })
+      )
+    } : {},
+    ...headers.length > 0 ? { additional_headers: headers } : {}
+  };
+};
+var errorDetail = (result) => {
+  const message = stringOf(result, "message");
+  const fields = result?.fields;
+  if (message === void 0 || typeof fields !== "object" || fields === null) {
+    return message;
+  }
+  const details = Object.entries(fields).filter(([, list]) => Array.isArray(list)).map(([name, list]) => `${name} (${list.join(", ")})`);
+  return details.length > 0 ? `${message}: ${details.join(", ")}` : message;
+};
+var createScalewayProvider = (options) => {
+  const { values, baseUrl, fetch } = checkHttpOptions(
+    "createScalewayProvider()",
+    options,
+    ["secretKey", "projectId"],
+    DEFAULT_BASE_URL,
+    ["region"]
+  );
+  const { region = DEFAULT_REGION } = values;
+  if (typeof region !== "string" || !/^[a-z]{2}-[a-z]{3}$/.test(region)) {
+    throw new TypeError(
+      "createScalewayProvider(): region must be a Scaleway region, like fr-par."
+    );
+  }
+  const url = `${baseUrl}/transactional-email/v1alpha1/regions/${region}/emails`;
+  return {
+    name: "scaleway",
+    send: async (message) => {
+      const body = JSON.stringify(toBody(message, values.projectId));
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          "x-auth-token": values.secretKey
+        },
+        body
+      });
+      const result = await readJson(response);
+      if (!response.ok) {
+        throw responseError("scaleway", response, errorDetail(result));
+      }
+      const [email] = result?.emails ?? [];
+      return { messageId: stringOf(email, "id") };
+    }
+  };
+};
+export {
+  createScalewayProvider
+};
+//# sourceMappingURL=scaleway.js.map