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

package/dist/scaleway.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/scaleway.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  checkNoInline,\n  readJson,\n  responseError,\n  stringOf,\n  type HttpProviderOptions,\n} from './http.js'\n\n/** Options of `createScalewayProvider()`. */\nexport interface ScalewayProviderOptions extends HttpProviderOptions {\n  /** Secret key of an API key with access to Transactional Email. */\n  secretKey: string\n  /** ID of the Project of the sending domain. */\n  projectId: string\n  /** Region of the sending domain. Defaults to `fr-par`. */\n  region?: string | undefined\n  /** Base URL of the API. Defaults to `https://api.scaleway.com`. */\n  baseUrl?: string | undefined\n}\n\nconst DEFAULT_BASE_URL = 'https://api.scaleway.com'\nconst DEFAULT_REGION = 'fr-par'\nconst MAX_SUBJECT_LENGTH = 998\n\nconst toAddress = ({ name, address }: Address) =>\n  name ? { email: address, name } : { email: address }\n\n/** Checks the limits of the API. */\nconst checkLimits = (message: MailMessage) => {\n  checkNoInline('Scaleway', message.attachments)\n  if (message.subject.length > MAX_SUBJECT_LENGTH) {\n    throw new MailMessageError(\n      `Scaleway accepts subjects of at most ${MAX_SUBJECT_LENGTH} characters, got ${message.subject.length}.`\n    )\n  }\n  const empty = Object.entries(message.headers).find(\n    ([, value]) => value === ''\n  )\n  if (empty) {\n    throw new MailMessageError(\n      `Scaleway does not accept empty header values (${empty[0]}).`\n    )\n  }\n}\n\n/**\n * Body of the Transactional Email API (v1alpha1), as serialized by the\n * official Scaleway SDK.\n */\nconst toBody = (message: MailMessage, projectId: string) => {\n  checkLimits(message)\n  const { cc, bcc, replyTo, attachments } = message\n  // No Reply-To field: it is an additional header.\n  const headers = [\n    ...(replyTo.length > 0\n      ? [{ key: 'Reply-To', value: replyTo.map(formatAddress).join(', ') }]\n      : []),\n    ...Object.entries(message.headers).map(([key, value]) => ({ key, value })),\n  ]\n  return {\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    subject: message.subject,\n    text: message.text,\n    html: message.html ?? '',\n    project_id: projectId,\n    ...(attachments.length > 0\n      ? {\n          attachments: attachments.map(\n            ({ filename, content, contentType }) => ({\n              name: filename,\n              type: contentType ?? 'application/octet-stream',\n              content: base64(content),\n            })\n          ),\n        }\n      : {}),\n    ...(headers.length > 0 ? { additional_headers: headers } : {}),\n  }\n}\n\n/** Message of an API error, with its invalid fields. */\nconst errorDetail = (result: unknown) => {\n  const message = stringOf(result, 'message')\n  const fields = (result as { fields?: unknown } | undefined)?.fields\n  if (message === undefined || typeof fields !== 'object' || fields === null) {\n    return message\n  }\n  const details = Object.entries(fields)\n    .filter(([, list]) => Array.isArray(list))\n    .map(([name, list]) => `${name} (${(list as unknown[]).join(', ')})`)\n  return details.length > 0 ? `${message}: ${details.join(', ')}` : message\n}\n\n/**\n * Creates a provider that sends messages with\n * [Scaleway Transactional Email](https://www.scaleway.com/en/transactional-email-tem/),\n * through `fetch`: no dependency.\n *\n * ```ts\n * const provider = createScalewayProvider({\n *   secretKey: process.env.SCW_SECRET_KEY!,\n *   projectId: process.env.SCW_DEFAULT_PROJECT_ID!,\n * })\n * ```\n */\nexport const createScalewayProvider = (\n  options: ScalewayProviderOptions\n): MailProvider => {\n  const { values, baseUrl, fetch } = checkHttpOptions(\n    'createScalewayProvider()',\n    options,\n    ['secretKey', 'projectId'],\n    DEFAULT_BASE_URL,\n    ['region']\n  )\n  const { region = DEFAULT_REGION } = values\n  if (typeof region !== 'string' || !/^[a-z]{2}-[a-z]{3}$/.test(region)) {\n    throw new TypeError(\n      'createScalewayProvider(): region must be a Scaleway region, like fr-par.'\n    )\n  }\n  const url = `${baseUrl}/transactional-email/v1alpha1/regions/${region}/emails`\n\n  return {\n    name: 'scaleway',\n    send: async (message) => {\n      const body = JSON.stringify(toBody(message, values.projectId))\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: {\n          'content-type': 'application/json',\n          'x-auth-token': values.secretKey,\n        },\n        body,\n      })\n      const result = await readJson(response)\n      if (!response.ok) {\n        throw responseError('scaleway', response, errorDetail(result))\n      }\n      // One email per recipient: the first one identifies the message.\n      const [email] =\n        (result as { emails?: unknown[] } | undefined)?.emails ?? []\n      return { messageId: stringOf(email, 'id') }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/sendgrid.d.ts

@@ -0,0 +1,26 @@
+import { MailProvider } from './index.js';
+import { HttpProviderOptions } from './index.js';
+import 'zod';
+
+/** Options of `createSendgridProvider()`. */
+interface SendgridProviderOptions extends HttpProviderOptions {
+    /** API key, with the Mail Send permission. */
+    apiKey: string;
+    /**
+     * Base URL of the API. Defaults to `https://api.sendgrid.com`; use
+     * `https://api.eu.sendgrid.com` for EU regional subusers.
+     */
+    baseUrl?: string | undefined;
+}
+/**
+ * Creates a provider that sends messages with the Mail Send API (v3) of
+ * Twilio SendGrid, through `fetch`: no dependency.
+ *
+ * ```ts
+ * const provider = createSendgridProvider({ apiKey: process.env.SENDGRID_API_KEY! })
+ * ```
+ */
+declare const createSendgridProvider: (options: SendgridProviderOptions) => MailProvider;
+
+export { createSendgridProvider };
+export type { SendgridProviderOptions };

package/dist/sendgrid.js

@@ -0,0 +1,121 @@
+import {
+  checkHttpOptions,
+  jsonBody,
+  readJson,
+  responseError,
+  stringOf
+} from "./chunk-FRMKUAF4.js";
+import {
+  base64,
+  utf8
+} from "./chunk-2ZABFOZQ.js";
+import {
+  MailMessageError
+} from "./chunk-QYVN5N3B.js";
+
+// src/providers/sendgrid.ts
+var DEFAULT_BASE_URL = "https://api.sendgrid.com";
+var toAddress = ({ name, address }) => name ? { email: address, name } : { email: address };
+var MAX_CATEGORIES = 10;
+var MAX_CATEGORY_LENGTH = 255;
+var MAX_CUSTOM_ARGS_BYTES = 1e4;
+var MAX_REQUEST_BYTES = 3e7;
+var checkTags = ({ tags, metadata }) => {
+  if (tags.length > MAX_CATEGORIES) {
+    throw new MailMessageError(
+      `SendGrid accepts at most ${MAX_CATEGORIES} tags (categories), got ${tags.length}.`
+    );
+  }
+  const long = tags.find((tag) => tag.length > MAX_CATEGORY_LENGTH);
+  if (long !== void 0) {
+    throw new MailMessageError(
+      `SendGrid accepts tags (categories) of at most ${MAX_CATEGORY_LENGTH} characters: "${long.slice(0, 20)}\u2026" has ${long.length}.`
+    );
+  }
+  const size = utf8(JSON.stringify(metadata)).byteLength;
+  if (size > MAX_CUSTOM_ARGS_BYTES) {
+    throw new MailMessageError(
+      `SendGrid accepts at most ${MAX_CUSTOM_ARGS_BYTES} bytes of metadata (custom_args), got ${size}.`
+    );
+  }
+  return { tags, metadata };
+};
+var toBody = (message) => {
+  const { to, cc, bcc, replyTo, html, text, attachments, headers } = message;
+  const { tags, metadata } = checkTags(message);
+  return {
+    personalizations: [
+      {
+        to: to.map(toAddress),
+        ...cc.length > 0 ? { cc: cc.map(toAddress) } : {},
+        ...bcc.length > 0 ? { bcc: bcc.map(toAddress) } : {},
+        ...Object.keys(metadata).length > 0 ? { custom_args: { ...metadata } } : {}
+      }
+    ],
+    from: toAddress(message.from),
+    // reply_to and reply_to_list are mutually exclusive.
+    ...replyTo.length === 1 ? { reply_to: toAddress(replyTo[0]) } : {},
+    ...replyTo.length > 1 ? { reply_to_list: replyTo.map(toAddress) } : {},
+    subject: message.subject,
+    // text/plain first; empty values are rejected by the API.
+    content: [
+      ...text === "" ? [] : [{ type: "text/plain", value: text }],
+      ...html === void 0 || html === "" ? [] : [{ type: "text/html", value: html }]
+    ],
+    ...attachments.length > 0 ? {
+      attachments: attachments.map(
+        ({ filename, content, contentType, contentId }) => ({
+          content: base64(content),
+          filename,
+          ...contentType === void 0 ? {} : { type: contentType },
+          ...contentId === void 0 ? { disposition: "attachment" } : { disposition: "inline", content_id: contentId }
+        })
+      )
+    } : {},
+    ...Object.keys(headers).length > 0 ? { headers: { ...headers } } : {},
+    ...tags.length > 0 ? { categories: [...tags] } : {}
+  };
+};
+var errorDetail = (body) => {
+  const { errors } = body ?? {};
+  if (!Array.isArray(errors)) return void 0;
+  const messages = errors.map((error) => stringOf(error, "message")).filter((message) => message !== void 0);
+  return messages.length > 0 ? messages.join("; ") : void 0;
+};
+var createSendgridProvider = (options) => {
+  const { values, baseUrl, fetch } = checkHttpOptions(
+    "createSendgridProvider()",
+    options,
+    ["apiKey"],
+    DEFAULT_BASE_URL
+  );
+  const { apiKey } = values;
+  const url = `${baseUrl}/v3/mail/send`;
+  return {
+    name: "sendgrid",
+    send: async (message) => {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          authorization: `Bearer ${apiKey}`,
+          "content-type": "application/json"
+        },
+        // 30 MB per message, attachments included.
+        body: jsonBody("SendGrid", toBody(message), MAX_REQUEST_BYTES)
+      });
+      if (!response.ok) {
+        throw responseError(
+          "sendgrid",
+          response,
+          errorDetail(await readJson(response))
+        );
+      }
+      await response.body?.cancel();
+      return { messageId: response.headers.get("x-message-id") ?? void 0 };
+    }
+  };
+};
+export {
+  createSendgridProvider
+};
+//# sourceMappingURL=sendgrid.js.map

package/dist/sendgrid.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/sendgrid.ts"],"sourcesContent":["import { base64, utf8 } from '../encoding.js'\nimport { MailMessageError } from '../errors.js'\nimport type { MailProvider } from '../mailer.js'\nimport type { Address, 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 `createSendgridProvider()`. */\nexport interface SendgridProviderOptions extends HttpProviderOptions {\n  /** API key, with the Mail Send permission. */\n  apiKey: string\n  /**\n   * Base URL of the API. Defaults to `https://api.sendgrid.com`; use\n   * `https://api.eu.sendgrid.com` for EU regional subusers.\n   */\n  baseUrl?: string | undefined\n}\n\nconst DEFAULT_BASE_URL = 'https://api.sendgrid.com'\n\ninterface SendgridAddress {\n  email: string\n  name?: string\n}\n\nconst toAddress = ({ name, address }: Address): SendgridAddress =>\n  name ? { email: address, name } : { email: address }\n\nconst MAX_CATEGORIES = 10\nconst MAX_CATEGORY_LENGTH = 255\nconst MAX_CUSTOM_ARGS_BYTES = 10_000\nconst MAX_REQUEST_BYTES = 30_000_000\n\n/** Limits of the API on categories (tags) and custom_args (metadata). */\nconst checkTags = ({ tags, metadata }: MailMessage) => {\n  if (tags.length > MAX_CATEGORIES) {\n    throw new MailMessageError(\n      `SendGrid accepts at most ${MAX_CATEGORIES} tags (categories), got ${tags.length}.`\n    )\n  }\n  const long = tags.find((tag) => tag.length > MAX_CATEGORY_LENGTH)\n  if (long !== undefined) {\n    throw new MailMessageError(\n      `SendGrid accepts tags (categories) of at most ${MAX_CATEGORY_LENGTH} characters: \"${long.slice(0, 20)}…\" has ${long.length}.`\n    )\n  }\n  const size = utf8(JSON.stringify(metadata)).byteLength\n  if (size > MAX_CUSTOM_ARGS_BYTES) {\n    throw new MailMessageError(\n      `SendGrid accepts at most ${MAX_CUSTOM_ARGS_BYTES} bytes of metadata (custom_args), got ${size}.`\n    )\n  }\n  return { tags, metadata }\n}\n\n/**\n * Body of the Mail Send API (v3), see\n * https://www.twilio.com/docs/sendgrid/api-reference/mail-send/mail-send\n */\nconst toBody = (message: MailMessage) => {\n  const { to, cc, bcc, replyTo, html, text, attachments, headers } = message\n  const { tags, metadata } = checkTags(message)\n  return {\n    personalizations: [\n      {\n        to: to.map(toAddress),\n        ...(cc.length > 0 ? { cc: cc.map(toAddress) } : {}),\n        ...(bcc.length > 0 ? { bcc: bcc.map(toAddress) } : {}),\n        ...(Object.keys(metadata).length > 0\n          ? { custom_args: { ...metadata } }\n          : {}),\n      },\n    ],\n    from: toAddress(message.from),\n    // reply_to and reply_to_list are mutually exclusive.\n    ...(replyTo.length === 1 ? { reply_to: toAddress(replyTo[0]!) } : {}),\n    ...(replyTo.length > 1 ? { reply_to_list: replyTo.map(toAddress) } : {}),\n    subject: message.subject,\n    // text/plain first; empty values are rejected by the API.\n    content: [\n      ...(text === '' ? [] : [{ type: 'text/plain', value: text }]),\n      ...(html === undefined || html === ''\n        ? []\n        : [{ type: 'text/html', value: html }]),\n    ],\n    ...(attachments.length > 0\n      ? {\n          attachments: attachments.map(\n            ({ filename, content, contentType, contentId }) => ({\n              content: base64(content),\n              filename,\n              ...(contentType === undefined ? {} : { type: contentType }),\n              ...(contentId === undefined\n                ? { disposition: 'attachment' }\n                : { disposition: 'inline', content_id: contentId }),\n            })\n          ),\n        }\n      : {}),\n    ...(Object.keys(headers).length > 0 ? { headers: { ...headers } } : {}),\n    ...(tags.length > 0 ? { categories: [...tags] } : {}),\n  }\n}\n\n/** Error messages of an API response (`errors[].message`), if any. */\nconst errorDetail = (body: unknown) => {\n  const { errors } = (body ?? {}) as { errors?: unknown }\n  if (!Array.isArray(errors)) return undefined\n  const messages = errors\n    .map((error) => stringOf(error, 'message'))\n    .filter((message) => message !== undefined)\n  return messages.length > 0 ? messages.join('; ') : undefined\n}\n\n/**\n * Creates a provider that sends messages with the Mail Send API (v3) of\n * Twilio SendGrid, through `fetch`: no dependency.\n *\n * ```ts\n * const provider = createSendgridProvider({ apiKey: process.env.SENDGRID_API_KEY! })\n * ```\n */\nexport const createSendgridProvider = (\n  options: SendgridProviderOptions\n): MailProvider => {\n  const { values, baseUrl, fetch } = checkHttpOptions(\n    'createSendgridProvider()',\n    options,\n    ['apiKey'],\n    DEFAULT_BASE_URL\n  )\n  const { apiKey } = values\n  const url = `${baseUrl}/v3/mail/send`\n\n  return {\n    name: 'sendgrid',\n    send: async (message) => {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: {\n          authorization: `Bearer ${apiKey}`,\n          'content-type': 'application/json',\n        },\n        // 30 MB per message, attachments included.\n        body: jsonBody('SendGrid', toBody(message), MAX_REQUEST_BYTES),\n      })\n      if (!response.ok) {\n        throw responseError(\n          'sendgrid',\n          response,\n          errorDetail(await readJson(response))\n        )\n      }\n      // 202 Accepted, without body.\n      await response.body?.cancel()\n      return { messageId: response.headers.get('x-message-id') ?? undefined }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/smtp.d.ts

@@ -0,0 +1,45 @@
+import { SendMailOptions, SMTPTransportOptions, SMTPPoolOptions } from 'nodemailer';
+import { MailProvider } from './index.js';
+import 'zod';
+
+/** A nodemailer transporter, or any object with the same methods. */
+interface NodemailerTransporter {
+    sendMail(options: SendMailOptions): Promise<{
+        messageId?: unknown;
+    }>;
+    close?(): void;
+}
+/** Provider based on nodemailer: SMTP, or another nodemailer transport. */
+interface NodemailerProvider extends MailProvider {
+    /** Closes the connections of the transporter (`pool: true`). */
+    close(): void;
+}
+/**
+ * Options of `createSmtpProvider()`: the SMTP options of nodemailer
+ * (`host`, `port`, `secure`, `auth`, `pool`…), or a connection URL like
+ * `smtps://user:password@smtp.example.com`.
+ */
+type SmtpProviderOptions = SMTPTransportOptions | SMTPPoolOptions | string;
+/**
+ * Creates a provider from a nodemailer transporter: SMTP, sendmail,
+ * Amazon SES through nodemailer, or a stream transport for tests.
+ */
+declare const createNodemailerProvider: (transporter: NodemailerTransporter, name?: string) => NodemailerProvider;
+/**
+ * Creates a provider that sends messages to an SMTP server, through
+ * nodemailer (peer dependency). Also works with the SMTP interface of
+ * Amazon SES, Postmark, Mailgun, Brevo, Mailjet…
+ *
+ * ```ts
+ * const provider = createSmtpProvider({
+ *   host: 'smtp.example.com',
+ *   port: 465,
+ *   secure: true,
+ *   auth: { user: process.env.SMTP_USER, pass: process.env.SMTP_PASSWORD },
+ * })
+ * ```
+ */
+declare const createSmtpProvider: (options: SmtpProviderOptions) => NodemailerProvider;
+
+export { createNodemailerProvider, createSmtpProvider };
+export type { NodemailerProvider, NodemailerTransporter, SmtpProviderOptions };

package/dist/smtp.js

@@ -0,0 +1,61 @@
+// src/providers/smtp.ts
+import nodemailer from "nodemailer";
+var toAddress = ({ name, address }) => name ? { name, address } : address;
+var toAttachment = ({
+  filename,
+  content,
+  contentType,
+  contentId
+}) => ({
+  filename,
+  // nodemailer takes Buffers, not plain Uint8Arrays (no copy).
+  content: typeof content === "string" ? content : Buffer.from(content.buffer, content.byteOffset, content.byteLength),
+  ...contentType === void 0 ? {} : { contentType },
+  // nodemailer defaults to `attachment`.
+  ...contentId === void 0 ? {} : { cid: contentId, contentDisposition: "inline" }
+});
+var toNodemailerMessage = (message) => ({
+  from: toAddress(message.from),
+  to: message.to.map(toAddress),
+  cc: message.cc.map(toAddress),
+  bcc: message.bcc.map(toAddress),
+  replyTo: message.replyTo.map(toAddress),
+  subject: message.subject,
+  text: message.text,
+  html: message.html,
+  attachments: message.attachments.map(toAttachment),
+  headers: { ...message.headers }
+});
+var createNodemailerProvider = (transporter, name = "nodemailer") => {
+  if (typeof transporter?.sendMail !== "function") {
+    throw new TypeError(
+      "createNodemailerProvider(): expected a nodemailer transporter."
+    );
+  }
+  return {
+    name,
+    send: async (message) => {
+      const { messageId } = await transporter.sendMail(
+        toNodemailerMessage(message)
+      );
+      return { messageId };
+    },
+    close: () => transporter.close?.()
+  };
+};
+var createSmtpProvider = (options) => {
+  if (typeof options !== "string" && (typeof options !== "object" || options === null)) {
+    throw new TypeError(
+      "createSmtpProvider(): expected SMTP options or a connection URL."
+    );
+  }
+  const transporter = nodemailer.createTransport(
+    options
+  );
+  return createNodemailerProvider(transporter, "smtp");
+};
+export {
+  createNodemailerProvider,
+  createSmtpProvider
+};
+//# sourceMappingURL=smtp.js.map

package/dist/smtp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/smtp.ts"],"sourcesContent":["// nodemailer runs on Node.js only: Buffer is available.\n/// <reference types=\"node\" />\nimport nodemailer, {\n  type SendMailOptions,\n  type SMTPPoolOptions,\n  type SMTPTransportOptions,\n  type Transporter,\n} from 'nodemailer'\nimport type { MailProvider } from '../mailer.js'\nimport type { Address, MailAttachment, MailMessage } from '../message.js'\n\n/** A nodemailer transporter, or any object with the same methods. */\nexport interface NodemailerTransporter {\n  sendMail(options: SendMailOptions): Promise<{ messageId?: unknown }>\n  close?(): void\n}\n\n/** Provider based on nodemailer: SMTP, or another nodemailer transport. */\nexport interface NodemailerProvider extends MailProvider {\n  /** Closes the connections of the transporter (`pool: true`). */\n  close(): void\n}\n\n/**\n * Options of `createSmtpProvider()`: the SMTP options of nodemailer\n * (`host`, `port`, `secure`, `auth`, `pool`…), or a connection URL like\n * `smtps://user:password@smtp.example.com`.\n */\nexport type SmtpProviderOptions =\n  SMTPTransportOptions | SMTPPoolOptions | string\n\nconst toAddress = ({ name, address }: Address) =>\n  name ? { name, address } : address\n\nconst toAttachment = ({\n  filename,\n  content,\n  contentType,\n  contentId,\n}: MailAttachment) => ({\n  filename,\n  // nodemailer takes Buffers, not plain Uint8Arrays (no copy).\n  content:\n    typeof content === 'string'\n      ? content\n      : Buffer.from(content.buffer, content.byteOffset, content.byteLength),\n  ...(contentType === undefined ? {} : { contentType }),\n  // nodemailer defaults to `attachment`.\n  ...(contentId === undefined\n    ? {}\n    : { cid: contentId, contentDisposition: 'inline' as const }),\n})\n\n/** nodemailer options of a message. */\nconst toNodemailerMessage = (message: MailMessage): SendMailOptions => ({\n  from: toAddress(message.from),\n  to: message.to.map(toAddress),\n  cc: message.cc.map(toAddress),\n  bcc: message.bcc.map(toAddress),\n  replyTo: message.replyTo.map(toAddress),\n  subject: message.subject,\n  text: message.text,\n  html: message.html,\n  attachments: message.attachments.map(toAttachment),\n  headers: { ...message.headers },\n})\n\n/**\n * Creates a provider from a nodemailer transporter: SMTP, sendmail,\n * Amazon SES through nodemailer, or a stream transport for tests.\n */\nexport const createNodemailerProvider = (\n  transporter: NodemailerTransporter,\n  name = 'nodemailer'\n): NodemailerProvider => {\n  if (typeof transporter?.sendMail !== 'function') {\n    throw new TypeError(\n      'createNodemailerProvider(): expected a nodemailer transporter.'\n    )\n  }\n  return {\n    name,\n    send: async (message) => {\n      const { messageId } = await transporter.sendMail(\n        toNodemailerMessage(message)\n      )\n      // Checked by the mailer.\n      return { messageId: messageId as string | undefined }\n    },\n    close: () => transporter.close?.(),\n  }\n}\n\n/**\n * Creates a provider that sends messages to an SMTP server, through\n * nodemailer (peer dependency). Also works with the SMTP interface of\n * Amazon SES, Postmark, Mailgun, Brevo, Mailjet…\n *\n * ```ts\n * const provider = createSmtpProvider({\n *   host: 'smtp.example.com',\n *   port: 465,\n *   secure: true,\n *   auth: { user: process.env.SMTP_USER, pass: process.env.SMTP_PASSWORD },\n * })\n * ```\n */\nexport const createSmtpProvider = (\n  options: SmtpProviderOptions\n): NodemailerProvider => {\n  if (\n    typeof options !== 'string' &&\n    (typeof options !== 'object' || options === null)\n  ) {\n    throw new TypeError(\n      'createSmtpProvider(): expected SMTP options or a connection URL.'\n    )\n  }\n  const transporter: Transporter = nodemailer.createTransport(\n    options as SMTPTransportOptions\n  )\n  return createNodemailerProvider(transporter, 'smtp')\n}\n"],"mappings":";AAEA,OAAO,gBAKA;AAwBP,IAAM,YAAY,CAAC,EAAE,MAAM,QAAQ,MACjC,OAAO,EAAE,MAAM,QAAQ,IAAI;AAE7B,IAAM,eAAe,CAAC;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,OAAuB;AAAA,EACrB;AAAA;AAAA,EAEA,SACE,OAAO,YAAY,WACf,UACA,OAAO,KAAK,QAAQ,QAAQ,QAAQ,YAAY,QAAQ,UAAU;AAAA,EACxE,GAAI,gBAAgB,SAAY,CAAC,IAAI,EAAE,YAAY;AAAA;AAAA,EAEnD,GAAI,cAAc,SACd,CAAC,IACD,EAAE,KAAK,WAAW,oBAAoB,SAAkB;AAC9D;AAGA,IAAM,sBAAsB,CAAC,aAA2C;AAAA,EACtE,MAAM,UAAU,QAAQ,IAAI;AAAA,EAC5B,IAAI,QAAQ,GAAG,IAAI,SAAS;AAAA,EAC5B,IAAI,QAAQ,GAAG,IAAI,SAAS;AAAA,EAC5B,KAAK,QAAQ,IAAI,IAAI,SAAS;AAAA,EAC9B,SAAS,QAAQ,QAAQ,IAAI,SAAS;AAAA,EACtC,SAAS,QAAQ;AAAA,EACjB,MAAM,QAAQ;AAAA,EACd,MAAM,QAAQ;AAAA,EACd,aAAa,QAAQ,YAAY,IAAI,YAAY;AAAA,EACjD,SAAS,EAAE,GAAG,QAAQ,QAAQ;AAChC;AAMO,IAAM,2BAA2B,CACtC,aACA,OAAO,iBACgB;AACvB,MAAI,OAAO,aAAa,aAAa,YAAY;AAC/C,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,OAAO,YAAY;AACvB,YAAM,EAAE,UAAU,IAAI,MAAM,YAAY;AAAA,QACtC,oBAAoB,OAAO;AAAA,MAC7B;AAEA,aAAO,EAAE,UAA2C;AAAA,IACtD;AAAA,IACA,OAAO,MAAM,YAAY,QAAQ;AAAA,EACnC;AACF;AAgBO,IAAM,qBAAqB,CAChC,YACuB;AACvB,MACE,OAAO,YAAY,aAClB,OAAO,YAAY,YAAY,YAAY,OAC5C;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,QAAM,cAA2B,WAAW;AAAA,IAC1C;AAAA,EACF;AACA,SAAO,yBAAyB,aAAa,MAAM;AACrD;","names":[]}

package/package.json

@@ -1,6 +1,142 @@
 {
   "name": "@dotpress/mailer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.0.0-alpha.0",
+  "description": "Typed, multilingual email templates (MJML or HTML) and interchangeable providers",
+  "author": "Renaud Guyon",
+  "license": "MIT",
+  "homepage": "https://dotpress.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dotpressjs/dotpress.git",
+    "directory": "packages/mailer"
+  },
+  "bugs": {
+    "url": "https://github.com/dotpressjs/dotpress/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "default": "./dist/plugin.js"
+    },
+    "./smtp": {
+      "types": "./dist/smtp.d.ts",
+      "default": "./dist/smtp.js"
+    },
+    "./aws-ses": {
+      "types": "./dist/aws-ses.d.ts",
+      "default": "./dist/aws-ses.js"
+    },
+    "./resend": {
+      "types": "./dist/resend.d.ts",
+      "default": "./dist/resend.js"
+    },
+    "./sendgrid": {
+      "types": "./dist/sendgrid.d.ts",
+      "default": "./dist/sendgrid.js"
+    },
+    "./postmark": {
+      "types": "./dist/postmark.d.ts",
+      "default": "./dist/postmark.js"
+    },
+    "./brevo": {
+      "types": "./dist/brevo.d.ts",
+      "default": "./dist/brevo.js"
+    },
+    "./mailjet": {
+      "types": "./dist/mailjet.d.ts",
+      "default": "./dist/mailjet.js"
+    },
+    "./mailgun": {
+      "types": "./dist/mailgun.d.ts",
+      "default": "./dist/mailgun.js"
+    },
+    "./scaleway": {
+      "types": "./dist/scaleway.d.ts",
+      "default": "./dist/scaleway.js"
+    }
+  },
+  "engines": {
+    "node": ">=22.12"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-sesv2": "^3.782.0",
+    "@dotpress/core": "^2.0.0-alpha.0",
+    "mjml": "^5.0.0",
+    "nodemailer": "^10.0.0",
+    "resend": "^6.0.0",
+    "zod": "^4.6.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-sesv2": {
+      "optional": true
+    },
+    "@dotpress/core": {
+      "optional": true
+    },
+    "mjml": {
+      "optional": true
+    },
+    "nodemailer": {
+      "optional": true
+    },
+    "resend": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "html-to-text": "^10.0.1",
+    "mustache": "^4.2.0"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-sesv2": "^3.1164.0",
+    "@dotpress/core": "2.0.0-alpha.0",
+    "@dotpress/testing": "2.0.0-alpha.0",
+    "@types/html-to-text": "^9.0.4",
+    "@types/mjml": "^5.4.2",
+    "@types/mustache": "^4.2.6",
+    "mjml": "^5.4.1",
+    "nodemailer": "^10.4.0",
+    "resend": "^6.37.0",
+    "smtp-server": "^3.21.3",
+    "zod": "^4.6.7"
+  },
+  "keywords": [
+    "dotpress",
+    "email",
+    "mailer",
+    "plugin",
+    "mjml",
+    "i18n",
+    "templates",
+    "typescript",
+    "smtp",
+    "nodemailer",
+    "aws-ses",
+    "aws",
+    "resend",
+    "sendgrid",
+    "postmark",
+    "brevo",
+    "mailjet",
+    "mailgun",
+    "scaleway"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "lint": "eslint src test",
+    "test": "vitest run",
+    "test:watch": "vitest watch"
+  }
 }