@saas-maker/foundry-email 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,77 @@
+/**
+ * Simple {{variable}} template renderer.
+ * No dependencies — just string interpolation.
+ */
+declare function renderTemplate(template: string, data: Record<string, unknown>): string;
+
+/**
+ * @saas-maker/foundry-email
+ *
+ * Lightweight email sending with Resend/SMTP and auto-tracing via @saas-maker/ops.
+ *
+ * @example
+ * ```ts
+ * import { configureEmail, email } from '@saas-maker/foundry-email';
+ *
+ * configureEmail({
+ *   provider: 'resend',
+ *   apiKey: env.RESEND_API_KEY,
+ *   from: 'noreply@yourdomain.com',
+ * });
+ *
+ * await email.send({
+ *   to: 'user@example.com',
+ *   subject: 'Welcome!',
+ *   template: 'Hello {{name}}, welcome to {{product}}!',
+ *   data: { name: 'Sarthak', product: 'Resume Tailor' },
+ * });
+ * ```
+ */
+type EmailProvider = 'resend' | 'smtp';
+interface ResendEmailConfig {
+    provider: 'resend';
+    apiKey: string;
+    from: string;
+}
+interface SmtpEmailConfig {
+    provider: 'smtp';
+    host: string;
+    port?: number;
+    secure?: boolean;
+    auth: {
+        user: string;
+        pass: string;
+    };
+    from: string;
+}
+type EmailConfig = ResendEmailConfig | SmtpEmailConfig;
+declare function configureEmail(config: EmailConfig): void;
+interface SendOptions {
+    to: string | string[];
+    subject: string;
+    /** Raw HTML body. If template is provided, this is ignored. */
+    html?: string;
+    /** Plain text body. */
+    text?: string;
+    /** Template string with {{variable}} placeholders. Rendered with `data`. */
+    template?: string;
+    /** Data to interpolate into template. */
+    data?: Record<string, unknown>;
+    replyTo?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    /** Project name for tracing (defaults to 'email') */
+    project?: string;
+}
+interface SendResult {
+    id: string;
+    provider: EmailProvider;
+}
+declare function sendOne(options: SendOptions): Promise<SendResult>;
+declare function sendBatch(messages: SendOptions[]): Promise<SendResult[]>;
+declare const email: {
+    send: typeof sendOne;
+    batch: typeof sendBatch;
+};
+
+export { type EmailConfig, type EmailProvider, type ResendEmailConfig, type SendOptions, type SendResult, type SmtpEmailConfig, configureEmail, email, renderTemplate };

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Simple {{variable}} template renderer.
+ * No dependencies — just string interpolation.
+ */
+declare function renderTemplate(template: string, data: Record<string, unknown>): string;
+
+/**
+ * @saas-maker/foundry-email
+ *
+ * Lightweight email sending with Resend/SMTP and auto-tracing via @saas-maker/ops.
+ *
+ * @example
+ * ```ts
+ * import { configureEmail, email } from '@saas-maker/foundry-email';
+ *
+ * configureEmail({
+ *   provider: 'resend',
+ *   apiKey: env.RESEND_API_KEY,
+ *   from: 'noreply@yourdomain.com',
+ * });
+ *
+ * await email.send({
+ *   to: 'user@example.com',
+ *   subject: 'Welcome!',
+ *   template: 'Hello {{name}}, welcome to {{product}}!',
+ *   data: { name: 'Sarthak', product: 'Resume Tailor' },
+ * });
+ * ```
+ */
+type EmailProvider = 'resend' | 'smtp';
+interface ResendEmailConfig {
+    provider: 'resend';
+    apiKey: string;
+    from: string;
+}
+interface SmtpEmailConfig {
+    provider: 'smtp';
+    host: string;
+    port?: number;
+    secure?: boolean;
+    auth: {
+        user: string;
+        pass: string;
+    };
+    from: string;
+}
+type EmailConfig = ResendEmailConfig | SmtpEmailConfig;
+declare function configureEmail(config: EmailConfig): void;
+interface SendOptions {
+    to: string | string[];
+    subject: string;
+    /** Raw HTML body. If template is provided, this is ignored. */
+    html?: string;
+    /** Plain text body. */
+    text?: string;
+    /** Template string with {{variable}} placeholders. Rendered with `data`. */
+    template?: string;
+    /** Data to interpolate into template. */
+    data?: Record<string, unknown>;
+    replyTo?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    /** Project name for tracing (defaults to 'email') */
+    project?: string;
+}
+interface SendResult {
+    id: string;
+    provider: EmailProvider;
+}
+declare function sendOne(options: SendOptions): Promise<SendResult>;
+declare function sendBatch(messages: SendOptions[]): Promise<SendResult[]>;
+declare const email: {
+    send: typeof sendOne;
+    batch: typeof sendBatch;
+};
+
+export { type EmailConfig, type EmailProvider, type ResendEmailConfig, type SendOptions, type SendResult, type SmtpEmailConfig, configureEmail, email, renderTemplate };

package/dist/index.js

@@ -0,0 +1,151 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  configureEmail: () => configureEmail,
+  email: () => email,
+  renderTemplate: () => renderTemplate
+});
+module.exports = __toCommonJS(index_exports);
+var import_ops = require("@saas-maker/ops");
+
+// src/providers/resend.ts
+async function sendViaResend(config, params) {
+  const body = {
+    from: config.from,
+    to: Array.isArray(params.to) ? params.to : [params.to],
+    subject: params.subject
+  };
+  if (params.html) body.html = params.html;
+  if (params.text) body.text = params.text;
+  if (params.replyTo) body.reply_to = params.replyTo;
+  if (params.cc) body.cc = Array.isArray(params.cc) ? params.cc : [params.cc];
+  if (params.bcc) body.bcc = Array.isArray(params.bcc) ? params.bcc : [params.bcc];
+  const res = await fetch("https://api.resend.com/emails", {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${config.apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`Resend error ${res.status}: ${text}`);
+  }
+  const data = await res.json();
+  return { id: data.id, provider: "resend" };
+}
+
+// src/providers/smtp.ts
+async function sendViaSmtp(config, params) {
+  const nodemailer = await import("nodemailer");
+  const transporter = nodemailer.createTransport({
+    host: config.host,
+    port: config.port ?? 587,
+    secure: config.secure ?? false,
+    auth: config.auth
+  });
+  const info = await transporter.sendMail({
+    from: config.from,
+    to: Array.isArray(params.to) ? params.to.join(", ") : params.to,
+    subject: params.subject,
+    html: params.html,
+    text: params.text,
+    replyTo: params.replyTo,
+    cc: params.cc,
+    bcc: params.bcc
+  });
+  return { id: info.messageId ?? crypto.randomUUID(), provider: "smtp" };
+}
+
+// src/render.ts
+function renderTemplate(template, data) {
+  return template.replace(/\{\{(\s*[\w.]+\s*)\}\}/g, (_match, key) => {
+    const trimmed = key.trim();
+    const value = trimmed.split(".").reduce((obj, part) => {
+      if (obj && typeof obj === "object") return obj[part];
+      return void 0;
+    }, data);
+    return value != null ? String(value) : "";
+  });
+}
+
+// src/index.ts
+var _config = null;
+function configureEmail(config) {
+  _config = config;
+}
+function getConfig() {
+  if (!_config) {
+    throw new Error(
+      "@saas-maker/foundry-email: call configureEmail() before sending emails"
+    );
+  }
+  return _config;
+}
+async function sendOne(options) {
+  const config = getConfig();
+  const project = options.project ?? "email";
+  const html = options.template ? renderTemplate(options.template, options.data ?? {}) : options.html;
+  const params = {
+    to: options.to,
+    subject: options.subject,
+    html,
+    text: options.text,
+    replyTo: options.replyTo,
+    cc: options.cc,
+    bcc: options.bcc
+  };
+  return (0, import_ops.trace)(
+    "email:send",
+    async () => {
+      if (config.provider === "resend") {
+        return sendViaResend({ apiKey: config.apiKey, from: config.from }, params);
+      }
+      return sendViaSmtp(config, params);
+    },
+    { project, meta: { to: Array.isArray(options.to) ? options.to[0] : options.to } }
+  );
+}
+async function sendBatch(messages) {
+  return Promise.all(messages.map(sendOne));
+}
+var email = {
+  send: sendOne,
+  batch: sendBatch
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  configureEmail,
+  email,
+  renderTemplate
+});

package/dist/index.mjs

@@ -0,0 +1,114 @@
+// src/index.ts
+import { trace } from "@saas-maker/ops";
+
+// src/providers/resend.ts
+async function sendViaResend(config, params) {
+  const body = {
+    from: config.from,
+    to: Array.isArray(params.to) ? params.to : [params.to],
+    subject: params.subject
+  };
+  if (params.html) body.html = params.html;
+  if (params.text) body.text = params.text;
+  if (params.replyTo) body.reply_to = params.replyTo;
+  if (params.cc) body.cc = Array.isArray(params.cc) ? params.cc : [params.cc];
+  if (params.bcc) body.bcc = Array.isArray(params.bcc) ? params.bcc : [params.bcc];
+  const res = await fetch("https://api.resend.com/emails", {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${config.apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`Resend error ${res.status}: ${text}`);
+  }
+  const data = await res.json();
+  return { id: data.id, provider: "resend" };
+}
+
+// src/providers/smtp.ts
+async function sendViaSmtp(config, params) {
+  const nodemailer = await import("nodemailer");
+  const transporter = nodemailer.createTransport({
+    host: config.host,
+    port: config.port ?? 587,
+    secure: config.secure ?? false,
+    auth: config.auth
+  });
+  const info = await transporter.sendMail({
+    from: config.from,
+    to: Array.isArray(params.to) ? params.to.join(", ") : params.to,
+    subject: params.subject,
+    html: params.html,
+    text: params.text,
+    replyTo: params.replyTo,
+    cc: params.cc,
+    bcc: params.bcc
+  });
+  return { id: info.messageId ?? crypto.randomUUID(), provider: "smtp" };
+}
+
+// src/render.ts
+function renderTemplate(template, data) {
+  return template.replace(/\{\{(\s*[\w.]+\s*)\}\}/g, (_match, key) => {
+    const trimmed = key.trim();
+    const value = trimmed.split(".").reduce((obj, part) => {
+      if (obj && typeof obj === "object") return obj[part];
+      return void 0;
+    }, data);
+    return value != null ? String(value) : "";
+  });
+}
+
+// src/index.ts
+var _config = null;
+function configureEmail(config) {
+  _config = config;
+}
+function getConfig() {
+  if (!_config) {
+    throw new Error(
+      "@saas-maker/foundry-email: call configureEmail() before sending emails"
+    );
+  }
+  return _config;
+}
+async function sendOne(options) {
+  const config = getConfig();
+  const project = options.project ?? "email";
+  const html = options.template ? renderTemplate(options.template, options.data ?? {}) : options.html;
+  const params = {
+    to: options.to,
+    subject: options.subject,
+    html,
+    text: options.text,
+    replyTo: options.replyTo,
+    cc: options.cc,
+    bcc: options.bcc
+  };
+  return trace(
+    "email:send",
+    async () => {
+      if (config.provider === "resend") {
+        return sendViaResend({ apiKey: config.apiKey, from: config.from }, params);
+      }
+      return sendViaSmtp(config, params);
+    },
+    { project, meta: { to: Array.isArray(options.to) ? options.to[0] : options.to } }
+  );
+}
+async function sendBatch(messages) {
+  return Promise.all(messages.map(sendOne));
+}
+var email = {
+  send: sendOne,
+  batch: sendBatch
+};
+export {
+  configureEmail,
+  email,
+  renderTemplate
+};

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@saas-maker/foundry-email",
+  "version": "0.1.0",
+  "description": "Foundry email — lightweight email sending with Resend/SMTP and auto-tracing via @saas-maker/ops",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": { "import": "./dist/index.mjs", "require": "./dist/index.js", "types": "./dist/index.d.ts" }
+  },
+  "files": ["dist"],
+  "scripts": { "build": "tsup src/index.ts --format esm,cjs --dts" },
+  "publishConfig": { "access": "public" },
+  "dependencies": {
+    "@saas-maker/ops": "^0.1.1",
+    "nodemailer": "^6.9.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.0",
+    "@types/node": "^22.0.0",
+    "@types/nodemailer": "^6.4.0"
+  }
+}