@porulle/adapter-resend 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @porulle/adapter-resend
+
+Transactional email via [Resend](https://resend.com). Implements the `email.send` callback in `CommerceConfig`.
+
+## Usage
+
+```ts
+import { defineConfig } from "@porulle/core";
+import { resendEmailAdapter } from "@porulle/adapter-resend";
+
+export default defineConfig({
+  email: {
+    send: resendEmailAdapter({
+      apiKey: process.env.RESEND_API_KEY!,
+      from: "Acme Store <orders@acme.com>",
+      // Optional: per-template subject + HTML overrides
+      subjects: {
+        "order-confirmation": (d) => `Your order ${d.orderNumber} is confirmed`,
+      },
+      templates: {
+        "order-confirmation": (d) => `<p>Thanks for ordering ${d.itemCount} items.</p>`,
+      },
+      // Optional: use Resend's server-side templates instead of local HTML
+      resendTemplateIds: {
+        "order-confirmation": "tmpl_abc123",
+      },
+    }),
+  },
+  // …
+});
+```
+
+## What gets sent
+
+The kernel emits emails via the `email.send` callback for:
+
+- `email-verification` — Better Auth signup
+- `password-reset` — Better Auth password reset
+- `order-confirmation` — `orders.afterCreate`
+- (plugins can add their own — see plugin docs)
+
+Templates not in `subjects` / `templates` get a minimal fallback so nothing silently fails to render.
+
+## See also
+
+- [Resend docs](https://resend.com/docs)
+- `@porulle/adapter-ses` — AWS SES alternative

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+export interface ResendAdapterOptions {
+    /** Resend API key (starts with re_). */
+    apiKey: string;
+    /** Default sender address (e.g., "Acme Store <orders@acme.com>"). */
+    from: string;
+    /**
+     * Maps template names to subject line generators.
+     * If a template is not in this map, the subject defaults to the template name.
+     */
+    subjects?: Record<string, (data: Record<string, unknown>) => string>;
+    /**
+     * Maps template names to HTML body generators.
+     * If a template is not in this map, a minimal default is used.
+     */
+    templates?: Record<string, (data: Record<string, unknown>) => string>;
+    /**
+     * Optional Resend template IDs. When provided, the adapter uses
+     * Resend's server-side template rendering instead of local HTML.
+     */
+    resendTemplateIds?: Record<string, string>;
+}
+/**
+ * Creates an email adapter backed by Resend.
+ *
+ * Implements the `config.email.send()` interface consumed by checkout hooks,
+ * auth (password reset, email verification), and appointment plugin notifications.
+ *
+ * @example
+ * ```typescript
+ * import { resendAdapter } from "@porulle/adapter-resend";
+ *
+ * export default defineConfig({
+ *   email: resendAdapter({
+ *     apiKey: process.env.RESEND_API_KEY!,
+ *     from: "Acme Store <orders@acme.com>",
+ *   }),
+ * });
+ * ```
+ */
+export declare function resendAdapter(options: ResendAdapterOptions): {
+    send(input: {
+        template: string;
+        to: string;
+        data?: Record<string, unknown>;
+    }): Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC;IACrE;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC;IACtE;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAgCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG;IAC5D,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9F,CAkDA"}

package/dist/index.js

@@ -0,0 +1,84 @@
+import { Resend } from "resend";
+const DEFAULT_SUBJECTS = {
+    "order-confirmation": (d) => `Order Confirmed${d.orderId ? ` - #${String(d.orderId).slice(0, 8)}` : ""}`,
+    "order-status-change": (d) => `Order Update - ${d.newStatus ?? "Status Changed"}`,
+    "password-reset": () => "Reset Your Password",
+    "email-verification": () => "Verify Your Email Address",
+    "appointment:reminder": (d) => `Appointment Reminder${d.reminderType === "1h" ? " - Starting Soon" : ""}`,
+    "appointment:confirmation-notice": () => "Appointment Confirmed",
+    "appointment:cancellation-notice": () => "Appointment Cancelled",
+    "appointment:no-show-notice": () => "Missed Appointment",
+};
+const DEFAULT_TEMPLATES = {
+    "order-confirmation": (d) => `<h2>Order Confirmed</h2><p>Thank you for your order${d.orderId ? ` <strong>#${String(d.orderId).slice(0, 8)}</strong>` : ""}.</p>${d.total ? `<p>Total: ${d.currency ?? "USD"} ${String(d.total)}</p>` : ""}`,
+    "order-status-change": (d) => `<h2>Order Update</h2><p>Your order${d.orderId ? ` <strong>#${String(d.orderId).slice(0, 8)}</strong>` : ""} status has been updated to <strong>${d.newStatus ?? "unknown"}</strong>.</p>`,
+    "password-reset": (d) => `<h2>Reset Your Password</h2><p>Click the link below to reset your password:</p><p><a href="${d.url ?? "#"}">Reset Password</a></p>`,
+    "email-verification": (d) => `<h2>Verify Your Email</h2><p>Click the link below to verify your email address:</p><p><a href="${d.url ?? "#"}">Verify Email</a></p>`,
+    "appointment:reminder": (d) => `<h2>Appointment Reminder</h2><p>This is a${d.reminderType === "1h" ? " 1-hour" : " 24-hour"} reminder for your upcoming appointment.</p><p>Booking ID: ${d.bookingId ?? "N/A"}</p>`,
+    "appointment:confirmation-notice": (d) => `<h2>Appointment Confirmed</h2><p>Your appointment has been confirmed.</p><p>Booking ID: ${d.bookingId ?? "N/A"}</p>`,
+    "appointment:cancellation-notice": (d) => `<h2>Appointment Cancelled</h2><p>Your appointment has been cancelled.</p><p>Booking ID: ${d.bookingId ?? "N/A"}</p>`,
+    "appointment:no-show-notice": (d) => `<h2>Missed Appointment</h2><p>You missed your appointment. Please contact us to rebook.</p><p>Booking ID: ${d.bookingId ?? "N/A"}</p>`,
+};
+/**
+ * Creates an email adapter backed by Resend.
+ *
+ * Implements the `config.email.send()` interface consumed by checkout hooks,
+ * auth (password reset, email verification), and appointment plugin notifications.
+ *
+ * @example
+ * ```typescript
+ * import { resendAdapter } from "@porulle/adapter-resend";
+ *
+ * export default defineConfig({
+ *   email: resendAdapter({
+ *     apiKey: process.env.RESEND_API_KEY!,
+ *     from: "Acme Store <orders@acme.com>",
+ *   }),
+ * });
+ * ```
+ */
+export function resendAdapter(options) {
+    const resend = new Resend(options.apiKey);
+    const subjects = { ...DEFAULT_SUBJECTS, ...options.subjects };
+    const templates = { ...DEFAULT_TEMPLATES, ...options.templates };
+    return {
+        async send(input) {
+            const data = input.data ?? {};
+            const subjectFn = subjects[input.template];
+            const subject = subjectFn ? subjectFn(data) : input.template;
+            // If a Resend template ID is configured, use server-side template rendering
+            const resendTemplateId = options.resendTemplateIds?.[input.template];
+            if (resendTemplateId) {
+                // Resend's template field is not yet typed in the SDK (upstream type gap).
+                // Cast required because CreateEmailOptions doesn't include `template`.
+                const { error: templateError } = await resend.emails.send({
+                    from: options.from,
+                    to: [input.to],
+                    subject,
+                    template: {
+                        id: resendTemplateId,
+                        variables: data,
+                    },
+                });
+                if (templateError) {
+                    throw new Error(`Resend template email failed: ${templateError.message}`);
+                }
+                return;
+            }
+            // Otherwise, use local HTML template
+            const templateFn = templates[input.template];
+            const html = templateFn
+                ? templateFn(data)
+                : `<p>Notification: ${input.template}</p><pre>${JSON.stringify(data, null, 2)}</pre>`;
+            const { error } = await resend.emails.send({
+                from: options.from,
+                to: [input.to],
+                subject,
+                html,
+            });
+            if (error) {
+                throw new Error(`Resend email failed: ${error.message}`);
+            }
+        },
+    };
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@porulle/adapter-resend",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./src/index.ts"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.build.tsbuildinfo && tsc -p tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 1000",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "resend": "^4.0.0"
+  },
+  "devDependencies": {
+    "@repo/eslint-config": "*",
+    "@repo/typescript-config": "*",
+    "@types/node": "^24.5.2",
+    "eslint": "^9.39.1",
+    "typescript": "5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md"
+  ],
+  "description": "Transactional email via Resend. Implements the email.send callback in CommerceConfig.",
+  "homepage": "https://porulle-docs.vercel.app",
+  "bugs": {
+    "url": "https://github.com/asyncdotengineering/porulle/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/asyncdotengineering/porulle.git",
+    "directory": "packages/adapters/adapter-resend"
+  },
+  "author": "Porulle contributors"
+}

package/src/index.ts

@@ -0,0 +1,125 @@
+import { Resend } from "resend";
+
+export interface ResendAdapterOptions {
+  /** Resend API key (starts with re_). */
+  apiKey: string;
+  /** Default sender address (e.g., "Acme Store <orders@acme.com>"). */
+  from: string;
+  /**
+   * Maps template names to subject line generators.
+   * If a template is not in this map, the subject defaults to the template name.
+   */
+  subjects?: Record<string, (data: Record<string, unknown>) => string>;
+  /**
+   * Maps template names to HTML body generators.
+   * If a template is not in this map, a minimal default is used.
+   */
+  templates?: Record<string, (data: Record<string, unknown>) => string>;
+  /**
+   * Optional Resend template IDs. When provided, the adapter uses
+   * Resend's server-side template rendering instead of local HTML.
+   */
+  resendTemplateIds?: Record<string, string>;
+}
+
+const DEFAULT_SUBJECTS: Record<string, (data: Record<string, unknown>) => string> = {
+  "order-confirmation": (d) => `Order Confirmed${d.orderId ? ` - #${String(d.orderId).slice(0, 8)}` : ""}`,
+  "order-status-change": (d) => `Order Update - ${d.newStatus ?? "Status Changed"}`,
+  "password-reset": () => "Reset Your Password",
+  "email-verification": () => "Verify Your Email Address",
+  "appointment:reminder": (d) => `Appointment Reminder${d.reminderType === "1h" ? " - Starting Soon" : ""}`,
+  "appointment:confirmation-notice": () => "Appointment Confirmed",
+  "appointment:cancellation-notice": () => "Appointment Cancelled",
+  "appointment:no-show-notice": () => "Missed Appointment",
+};
+
+const DEFAULT_TEMPLATES: Record<string, (data: Record<string, unknown>) => string> = {
+  "order-confirmation": (d) =>
+    `<h2>Order Confirmed</h2><p>Thank you for your order${d.orderId ? ` <strong>#${String(d.orderId).slice(0, 8)}</strong>` : ""}.</p>${d.total ? `<p>Total: ${d.currency ?? "USD"} ${String(d.total)}</p>` : ""}`,
+  "order-status-change": (d) =>
+    `<h2>Order Update</h2><p>Your order${d.orderId ? ` <strong>#${String(d.orderId).slice(0, 8)}</strong>` : ""} status has been updated to <strong>${d.newStatus ?? "unknown"}</strong>.</p>`,
+  "password-reset": (d) =>
+    `<h2>Reset Your Password</h2><p>Click the link below to reset your password:</p><p><a href="${d.url ?? "#"}">Reset Password</a></p>`,
+  "email-verification": (d) =>
+    `<h2>Verify Your Email</h2><p>Click the link below to verify your email address:</p><p><a href="${d.url ?? "#"}">Verify Email</a></p>`,
+  "appointment:reminder": (d) =>
+    `<h2>Appointment Reminder</h2><p>This is a${d.reminderType === "1h" ? " 1-hour" : " 24-hour"} reminder for your upcoming appointment.</p><p>Booking ID: ${d.bookingId ?? "N/A"}</p>`,
+  "appointment:confirmation-notice": (d) =>
+    `<h2>Appointment Confirmed</h2><p>Your appointment has been confirmed.</p><p>Booking ID: ${d.bookingId ?? "N/A"}</p>`,
+  "appointment:cancellation-notice": (d) =>
+    `<h2>Appointment Cancelled</h2><p>Your appointment has been cancelled.</p><p>Booking ID: ${d.bookingId ?? "N/A"}</p>`,
+  "appointment:no-show-notice": (d) =>
+    `<h2>Missed Appointment</h2><p>You missed your appointment. Please contact us to rebook.</p><p>Booking ID: ${d.bookingId ?? "N/A"}</p>`,
+};
+
+/**
+ * Creates an email adapter backed by Resend.
+ *
+ * Implements the `config.email.send()` interface consumed by checkout hooks,
+ * auth (password reset, email verification), and appointment plugin notifications.
+ *
+ * @example
+ * ```typescript
+ * import { resendAdapter } from "@porulle/adapter-resend";
+ *
+ * export default defineConfig({
+ *   email: resendAdapter({
+ *     apiKey: process.env.RESEND_API_KEY!,
+ *     from: "Acme Store <orders@acme.com>",
+ *   }),
+ * });
+ * ```
+ */
+export function resendAdapter(options: ResendAdapterOptions): {
+  send(input: { template: string; to: string; data?: Record<string, unknown> }): Promise<void>;
+} {
+  const resend = new Resend(options.apiKey);
+
+  const subjects = { ...DEFAULT_SUBJECTS, ...options.subjects };
+  const templates = { ...DEFAULT_TEMPLATES, ...options.templates };
+
+  return {
+    async send(input) {
+      const data = input.data ?? {};
+      const subjectFn = subjects[input.template];
+      const subject = subjectFn ? subjectFn(data) : input.template;
+
+      // If a Resend template ID is configured, use server-side template rendering
+      const resendTemplateId = options.resendTemplateIds?.[input.template];
+      if (resendTemplateId) {
+        // Resend's template field is not yet typed in the SDK (upstream type gap).
+        // Cast required because CreateEmailOptions doesn't include `template`.
+        const { error: templateError } = await resend.emails.send({
+          from: options.from,
+          to: [input.to],
+          subject,
+          template: {
+            id: resendTemplateId,
+            variables: data as Record<string, string | number>,
+          },
+        } as unknown as Parameters<typeof resend.emails.send>[0]);
+        if (templateError) {
+          throw new Error(`Resend template email failed: ${templateError.message}`);
+        }
+        return;
+      }
+
+      // Otherwise, use local HTML template
+      const templateFn = templates[input.template];
+      const html = templateFn
+        ? templateFn(data)
+        : `<p>Notification: ${input.template}</p><pre>${JSON.stringify(data, null, 2)}</pre>`;
+
+      const { error } = await resend.emails.send({
+        from: options.from,
+        to: [input.to],
+        subject,
+        html,
+      });
+
+      if (error) {
+        throw new Error(`Resend email failed: ${error.message}`);
+      }
+    },
+  };
+}