@matthesketh/utopia-email 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Hesketh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# @matthesketh/utopia-email
+
+Template-based email rendering for UtopiaJS. Render `.utopia` components to email-safe HTML with CSS inlining and plain text fallback. Adapter pattern for sending via SMTP, Resend, or SendGrid.
+
+## Install
+
+```bash
+pnpm add @matthesketh/utopia-email
+```
+
+Install a provider SDK as needed:
+
+```bash
+pnpm add nodemailer     # for SMTP
+pnpm add resend         # for Resend
+pnpm add @sendgrid/mail # for SendGrid
+```
+
+## Usage
+
+```ts
+import { createMailer } from '@matthesketh/utopia-email';
+import { smtpAdapter } from '@matthesketh/utopia-email/smtp';
+import WelcomeEmail from './emails/Welcome.utopia';
+
+const mailer = createMailer(smtpAdapter({
+  host: 'smtp.example.com',
+  port: 587,
+  auth: { user: 'user', pass: 'pass' },
+}));
+
+await mailer.send({
+  to: 'user@example.com',
+  from: 'noreply@example.com',
+  subject: 'Welcome!',
+  component: WelcomeEmail,
+  props: { name: 'Alice' },
+});
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `createMailer(adapter)` | Create a mailer instance |
+| `renderEmail(component, props?, options?)` | Render to `{ html, text, subject }` without sending |
+| `inlineCSS(html, css)` | Inline CSS into `style=""` attributes |
+| `htmlToText(html)` | Convert HTML to plain text |
+
+**Built-in components:** `EmailLayout`, `EmailButton`, `EmailCard`, `EmailDivider`, `EmailHeading`, `EmailText`, `EmailImage`, `EmailColumns`, `EmailSpacer`.
+
+**Adapters:** `@matthesketh/utopia-email/smtp`, `@matthesketh/utopia-email/resend`, `@matthesketh/utopia-email/sendgrid`.
+
+See [docs/email.md](../../docs/email.md) for the full rendering pipeline, component reference, and type documentation.
+
+## License
+
+MIT

package/dist/adapters/resend.cjs

@@ -0,0 +1,88 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/resend.ts
+var resend_exports = {};
+__export(resend_exports, {
+  resendAdapter: () => resendAdapter
+});
+module.exports = __toCommonJS(resend_exports);
+function resendAdapter(config) {
+  let client = null;
+  async function getClient() {
+    if (client) return client;
+    let Resend;
+    try {
+      const mod = await import("resend");
+      Resend = mod.Resend ?? mod.default;
+    } catch {
+      throw new Error(
+        '@matthesketh/utopia-email: "resend" package is required for the Resend adapter. Install it with: npm install resend'
+      );
+    }
+    client = new Resend(config.apiKey);
+    return client;
+  }
+  return {
+    async send(message) {
+      try {
+        const resend = await getClient();
+        const result = await resend.emails.send({
+          from: message.from,
+          to: Array.isArray(message.to) ? message.to : [message.to],
+          cc: message.cc ? Array.isArray(message.cc) ? message.cc : [message.cc] : void 0,
+          bcc: message.bcc ? Array.isArray(message.bcc) ? message.bcc : [message.bcc] : void 0,
+          reply_to: message.replyTo,
+          subject: message.subject,
+          html: message.html,
+          text: message.text,
+          headers: message.headers,
+          attachments: message.attachments?.map((a) => ({
+            filename: a.filename,
+            content: a.content,
+            content_type: a.contentType
+          }))
+        });
+        return {
+          success: true,
+          messageId: result.data?.id ?? result.id
+        };
+      } catch (err) {
+        return {
+          success: false,
+          error: err.message ?? String(err)
+        };
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  resendAdapter
+});

package/dist/adapters/resend.d.cts

@@ -0,0 +1,10 @@
+import { e as ResendConfig, E as EmailAdapter } from '../types-C3uNsSmw.cjs';
+
+/**
+ * Create a Resend email adapter.
+ *
+ * Requires `resend` as a peer dependency.
+ */
+declare function resendAdapter(config: ResendConfig): EmailAdapter;
+
+export { resendAdapter };

package/dist/adapters/resend.d.ts

@@ -0,0 +1,10 @@
+import { e as ResendConfig, E as EmailAdapter } from '../types-C3uNsSmw.js';
+
+/**
+ * Create a Resend email adapter.
+ *
+ * Requires `resend` as a peer dependency.
+ */
+declare function resendAdapter(config: ResendConfig): EmailAdapter;
+
+export { resendAdapter };

package/dist/adapters/resend.js

@@ -0,0 +1,53 @@
+// src/adapters/resend.ts
+function resendAdapter(config) {
+  let client = null;
+  async function getClient() {
+    if (client) return client;
+    let Resend;
+    try {
+      const mod = await import("resend");
+      Resend = mod.Resend ?? mod.default;
+    } catch {
+      throw new Error(
+        '@matthesketh/utopia-email: "resend" package is required for the Resend adapter. Install it with: npm install resend'
+      );
+    }
+    client = new Resend(config.apiKey);
+    return client;
+  }
+  return {
+    async send(message) {
+      try {
+        const resend = await getClient();
+        const result = await resend.emails.send({
+          from: message.from,
+          to: Array.isArray(message.to) ? message.to : [message.to],
+          cc: message.cc ? Array.isArray(message.cc) ? message.cc : [message.cc] : void 0,
+          bcc: message.bcc ? Array.isArray(message.bcc) ? message.bcc : [message.bcc] : void 0,
+          reply_to: message.replyTo,
+          subject: message.subject,
+          html: message.html,
+          text: message.text,
+          headers: message.headers,
+          attachments: message.attachments?.map((a) => ({
+            filename: a.filename,
+            content: a.content,
+            content_type: a.contentType
+          }))
+        });
+        return {
+          success: true,
+          messageId: result.data?.id ?? result.id
+        };
+      } catch (err) {
+        return {
+          success: false,
+          error: err.message ?? String(err)
+        };
+      }
+    }
+  };
+}
+export {
+  resendAdapter
+};

package/dist/adapters/sendgrid.cjs

@@ -0,0 +1,101 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/sendgrid.ts
+var sendgrid_exports = {};
+__export(sendgrid_exports, {
+  sendgridAdapter: () => sendgridAdapter
+});
+module.exports = __toCommonJS(sendgrid_exports);
+function sendgridAdapter(config) {
+  let client = null;
+  async function getClient() {
+    if (client) return client;
+    let sgMail;
+    try {
+      const mod = await import("@sendgrid/mail");
+      sgMail = mod.default ?? mod;
+    } catch {
+      throw new Error(
+        '@matthesketh/utopia-email: "@sendgrid/mail" package is required for the SendGrid adapter. Install it with: npm install @sendgrid/mail'
+      );
+    }
+    sgMail.setApiKey(config.apiKey);
+    client = sgMail;
+    return client;
+  }
+  return {
+    async send(message) {
+      try {
+        const sg = await getClient();
+        const msg = {
+          to: Array.isArray(message.to) ? message.to : [message.to],
+          from: message.from,
+          subject: message.subject,
+          html: message.html,
+          text: message.text
+        };
+        if (message.cc) {
+          msg.cc = Array.isArray(message.cc) ? message.cc : [message.cc];
+        }
+        if (message.bcc) {
+          msg.bcc = Array.isArray(message.bcc) ? message.bcc : [message.bcc];
+        }
+        if (message.replyTo) {
+          msg.replyTo = message.replyTo;
+        }
+        if (message.headers) {
+          msg.headers = message.headers;
+        }
+        if (message.attachments) {
+          msg.attachments = message.attachments.map((a) => ({
+            filename: a.filename,
+            content: typeof a.content === "string" ? a.content : a.content.toString("base64"),
+            type: a.contentType,
+            disposition: "attachment"
+          }));
+        }
+        const [response] = await sg.send(msg);
+        return {
+          success: true,
+          messageId: response?.headers?.["x-message-id"]
+        };
+      } catch (err) {
+        return {
+          success: false,
+          error: err.message ?? String(err)
+        };
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sendgridAdapter
+});

package/dist/adapters/sendgrid.d.cts

@@ -0,0 +1,10 @@
+import { S as SendGridConfig, E as EmailAdapter } from '../types-C3uNsSmw.cjs';
+
+/**
+ * Create a SendGrid email adapter.
+ *
+ * Requires `@sendgrid/mail` as a peer dependency.
+ */
+declare function sendgridAdapter(config: SendGridConfig): EmailAdapter;
+
+export { sendgridAdapter };

package/dist/adapters/sendgrid.d.ts

@@ -0,0 +1,10 @@
+import { S as SendGridConfig, E as EmailAdapter } from '../types-C3uNsSmw.js';
+
+/**
+ * Create a SendGrid email adapter.
+ *
+ * Requires `@sendgrid/mail` as a peer dependency.
+ */
+declare function sendgridAdapter(config: SendGridConfig): EmailAdapter;
+
+export { sendgridAdapter };

package/dist/adapters/sendgrid.js

@@ -0,0 +1,66 @@
+// src/adapters/sendgrid.ts
+function sendgridAdapter(config) {
+  let client = null;
+  async function getClient() {
+    if (client) return client;
+    let sgMail;
+    try {
+      const mod = await import("@sendgrid/mail");
+      sgMail = mod.default ?? mod;
+    } catch {
+      throw new Error(
+        '@matthesketh/utopia-email: "@sendgrid/mail" package is required for the SendGrid adapter. Install it with: npm install @sendgrid/mail'
+      );
+    }
+    sgMail.setApiKey(config.apiKey);
+    client = sgMail;
+    return client;
+  }
+  return {
+    async send(message) {
+      try {
+        const sg = await getClient();
+        const msg = {
+          to: Array.isArray(message.to) ? message.to : [message.to],
+          from: message.from,
+          subject: message.subject,
+          html: message.html,
+          text: message.text
+        };
+        if (message.cc) {
+          msg.cc = Array.isArray(message.cc) ? message.cc : [message.cc];
+        }
+        if (message.bcc) {
+          msg.bcc = Array.isArray(message.bcc) ? message.bcc : [message.bcc];
+        }
+        if (message.replyTo) {
+          msg.replyTo = message.replyTo;
+        }
+        if (message.headers) {
+          msg.headers = message.headers;
+        }
+        if (message.attachments) {
+          msg.attachments = message.attachments.map((a) => ({
+            filename: a.filename,
+            content: typeof a.content === "string" ? a.content : a.content.toString("base64"),
+            type: a.contentType,
+            disposition: "attachment"
+          }));
+        }
+        const [response] = await sg.send(msg);
+        return {
+          success: true,
+          messageId: response?.headers?.["x-message-id"]
+        };
+      } catch (err) {
+        return {
+          success: false,
+          error: err.message ?? String(err)
+        };
+      }
+    }
+  };
+}
+export {
+  sendgridAdapter
+};

package/dist/adapters/smtp.cjs

@@ -0,0 +1,93 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/smtp.ts
+var smtp_exports = {};
+__export(smtp_exports, {
+  smtpAdapter: () => smtpAdapter
+});
+module.exports = __toCommonJS(smtp_exports);
+function smtpAdapter(config) {
+  let transporter = null;
+  async function getTransporter() {
+    if (transporter) return transporter;
+    let nodemailer;
+    try {
+      nodemailer = await import("nodemailer");
+    } catch {
+      throw new Error(
+        '@matthesketh/utopia-email: "nodemailer" package is required for the SMTP adapter. Install it with: npm install nodemailer'
+      );
+    }
+    transporter = nodemailer.createTransport({
+      host: config.host,
+      port: config.port,
+      secure: config.secure ?? config.port === 465,
+      auth: config.auth
+    });
+    return transporter;
+  }
+  return {
+    async send(message) {
+      try {
+        const transport = await getTransporter();
+        const info = await transport.sendMail({
+          from: message.from,
+          to: Array.isArray(message.to) ? message.to.join(", ") : message.to,
+          cc: message.cc ? Array.isArray(message.cc) ? message.cc.join(", ") : message.cc : void 0,
+          bcc: message.bcc ? Array.isArray(message.bcc) ? message.bcc.join(", ") : message.bcc : void 0,
+          replyTo: message.replyTo,
+          subject: message.subject,
+          html: message.html,
+          text: message.text,
+          headers: message.headers,
+          attachments: message.attachments?.map((a) => ({
+            filename: a.filename,
+            content: a.content,
+            contentType: a.contentType,
+            encoding: a.encoding
+          }))
+        });
+        return {
+          success: true,
+          messageId: info.messageId
+        };
+      } catch (err) {
+        return {
+          success: false,
+          error: err.message ?? String(err)
+        };
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  smtpAdapter
+});

package/dist/adapters/smtp.d.cts

@@ -0,0 +1,10 @@
+import { f as SmtpConfig, E as EmailAdapter } from '../types-C3uNsSmw.cjs';
+
+/**
+ * Create an SMTP email adapter using nodemailer.
+ *
+ * Requires `nodemailer` as a peer dependency.
+ */
+declare function smtpAdapter(config: SmtpConfig): EmailAdapter;
+
+export { smtpAdapter };

package/dist/adapters/smtp.d.ts

@@ -0,0 +1,10 @@
+import { f as SmtpConfig, E as EmailAdapter } from '../types-C3uNsSmw.js';
+
+/**
+ * Create an SMTP email adapter using nodemailer.
+ *
+ * Requires `nodemailer` as a peer dependency.
+ */
+declare function smtpAdapter(config: SmtpConfig): EmailAdapter;
+
+export { smtpAdapter };

package/dist/adapters/smtp.js

@@ -0,0 +1,58 @@
+// src/adapters/smtp.ts
+function smtpAdapter(config) {
+  let transporter = null;
+  async function getTransporter() {
+    if (transporter) return transporter;
+    let nodemailer;
+    try {
+      nodemailer = await import("nodemailer");
+    } catch {
+      throw new Error(
+        '@matthesketh/utopia-email: "nodemailer" package is required for the SMTP adapter. Install it with: npm install nodemailer'
+      );
+    }
+    transporter = nodemailer.createTransport({
+      host: config.host,
+      port: config.port,
+      secure: config.secure ?? config.port === 465,
+      auth: config.auth
+    });
+    return transporter;
+  }
+  return {
+    async send(message) {
+      try {
+        const transport = await getTransporter();
+        const info = await transport.sendMail({
+          from: message.from,
+          to: Array.isArray(message.to) ? message.to.join(", ") : message.to,
+          cc: message.cc ? Array.isArray(message.cc) ? message.cc.join(", ") : message.cc : void 0,
+          bcc: message.bcc ? Array.isArray(message.bcc) ? message.bcc.join(", ") : message.bcc : void 0,
+          replyTo: message.replyTo,
+          subject: message.subject,
+          html: message.html,
+          text: message.text,
+          headers: message.headers,
+          attachments: message.attachments?.map((a) => ({
+            filename: a.filename,
+            content: a.content,
+            contentType: a.contentType,
+            encoding: a.encoding
+          }))
+        });
+        return {
+          success: true,
+          messageId: info.messageId
+        };
+      } catch (err) {
+        return {
+          success: false,
+          error: err.message ?? String(err)
+        };
+      }
+    }
+  };
+}
+export {
+  smtpAdapter
+};