@lunora/mail 0.0.0 → 1.0.0-alpha.1

package/dist/packem_shared/provider-transport-C5CVbjRF.mjs

@@ -0,0 +1,47 @@
+import { t as toAddressList, c as toAddress } from './address-fkXxLKza.mjs';
+
+const reasonOf = (rawError) => {
+  if (rawError instanceof Error) {
+    return rawError.message;
+  }
+  if (rawError === null || rawError === void 0) {
+    return "send failed";
+  }
+  if (typeof rawError === "string") {
+    return rawError;
+  }
+  if (typeof rawError === "number" || typeof rawError === "boolean" || typeof rawError === "bigint") {
+    return rawError.toString();
+  }
+  return JSON.stringify(rawError) ?? "send failed";
+};
+const requireRecipients = (to) => {
+  const list = toAddressList(to);
+  const [first] = list ?? [];
+  if (!list || first === void 0) {
+    throw new Error("@lunora/mail: at least one recipient is required");
+  }
+  return { first, list };
+};
+const toProviderEmail = (payload, defaultFrom, to) => {
+  return {
+    bcc: toAddressList(payload.bcc),
+    cc: toAddressList(payload.cc),
+    from: toAddress(payload.from ?? defaultFrom),
+    headers: payload.headers,
+    html: payload.html,
+    replyTo: payload.replyTo ? toAddress(payload.replyTo) : void 0,
+    subject: payload.subject,
+    text: payload.text,
+    to
+  };
+};
+const interpretSendResult = (result) => {
+  if (!result.success || !result.data) {
+    console.error(`@lunora/mail: send failed: ${reasonOf(result.error)}`);
+    throw new Error("@lunora/mail: send failed");
+  }
+  return { id: result.data.messageId };
+};
+
+export { interpretSendResult as i, requireRecipients as r, toProviderEmail as t };

package/dist/packem_shared/renderEmail-hyS1bpVP.mjs

@@ -0,0 +1,8 @@
+import { render } from '@react-email/render';
+
+const renderEmail = async (element) => {
+  const [html, text] = await Promise.all([render(element, { pretty: false }), render(element, { plainText: true })]);
+  return { html, text };
+};
+
+export { renderEmail as default };

package/dist/packem_shared/toQueuedPayload-BEKOdaxU.mjs

@@ -0,0 +1,75 @@
+const toQueuedPayload = (options) => {
+  return {
+    bcc: options.bcc,
+    cc: options.cc,
+    from: options.from,
+    headers: options.headers,
+    html: options.html,
+    replyTo: options.replyTo,
+    subject: options.subject,
+    text: options.text,
+    to: options.to
+  };
+};
+const consumeQueuedSend = async (mailer, payload) => {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    throw new Error("@lunora/mail: queue message body must be an object");
+  }
+  const candidate = payload;
+  if (typeof candidate.subject !== "string") {
+    throw new TypeError("@lunora/mail: queue message must have a string `subject`");
+  }
+  const recipientIsString = typeof candidate.to === "string";
+  const recipientIsStringArray = Array.isArray(candidate.to) && candidate.to.every((value) => typeof value === "string");
+  if (!recipientIsString && !recipientIsStringArray) {
+    throw new Error("@lunora/mail: queue message `to` must be a string or string[]");
+  }
+  const assertOptionalString = (field, value) => {
+    if (value === void 0) {
+      return void 0;
+    }
+    if (typeof value !== "string") {
+      throw new TypeError(`@lunora/mail: queue message \`${field}\` must be a string`);
+    }
+    return value;
+  };
+  const assertOptionalStringList = (field, value) => {
+    if (value === void 0) {
+      return void 0;
+    }
+    if (typeof value === "string") {
+      return [value];
+    }
+    if (Array.isArray(value) && value.every((entry) => typeof entry === "string")) {
+      return value;
+    }
+    throw new TypeError(`@lunora/mail: queue message \`${field}\` must be a string or string[]`);
+  };
+  let headers;
+  if (candidate.headers !== void 0) {
+    if (!candidate.headers || typeof candidate.headers !== "object" || Array.isArray(candidate.headers)) {
+      throw new TypeError("@lunora/mail: queue message `headers` must be an object of string values");
+    }
+    const entries = Object.entries(candidate.headers);
+    for (const [key, value] of entries) {
+      if (typeof value !== "string") {
+        throw new TypeError(`@lunora/mail: queue message header "${key}" must be a string`);
+      }
+    }
+    headers = candidate.headers;
+  }
+  const options = {
+    bcc: assertOptionalStringList("bcc", candidate.bcc),
+    cc: assertOptionalStringList("cc", candidate.cc),
+    from: assertOptionalString("from", candidate.from),
+    headers,
+    html: assertOptionalString("html", candidate.html),
+    replyTo: assertOptionalString("replyTo", candidate.replyTo),
+    subject: candidate.subject,
+    text: assertOptionalString("text", candidate.text),
+    to: candidate.to
+  };
+  return mailer.send(options);
+};
+
+export { consumeQueuedSend, toQueuedPayload };

package/dist/testing.d.mts

@@ -0,0 +1,49 @@
+import { C as CapturedMail } from "./packem_shared/capture-transport.d-ChnhdPO2.mjs";
+import 'react';
+/** Minimal `fetch` projection so a test can inject a stub. */
+type FetchLike = (input: string, init?: {
+  body?: string;
+  headers?: Record<string, string>;
+  method?: string;
+}) => Promise<{
+  json: () => Promise<unknown>;
+  ok: boolean;
+  status: number;
+}>;
+interface InboxOptions {
+  /** Admin bearer token (`LUNORA_ADMIN_TOKEN`) the worker gates introspection behind. */
+  adminToken: string;
+  /** App base URL, e.g. `http://localhost:8787`. */
+  baseUrl: string;
+  /** Inject a `fetch` implementation (defaults to the global). */
+  fetch?: FetchLike;
+  /** Newest-N to read (default 50). */
+  limit?: number;
+}
+interface WaitForMailOptions extends InboxOptions {
+  /** Poll interval in ms (default 250). */
+  pollMs?: number;
+  /** Only match a message whose subject contains this substring. */
+  subjectMatch?: string;
+  /** Give up after this many ms (default 10000). */
+  timeoutMs?: number;
+  /** Recipient address the message must be addressed to. */
+  to: string;
+}
+/** Read the captured-mail inbox (newest first). */
+declare const listCapturedMail: (options: InboxOptions) => Promise<CapturedMail[]>;
+/**
+* Poll the captured-mail inbox until a message addressed to `to` (optionally
+* matching `subjectMatch`) appears, then return it. Throws on timeout. Entries
+* are newest-first, so the most recent matching message wins.
+*/
+declare const waitForMail: (options: WaitForMailOptions) => Promise<CapturedMail>;
+/**
+* Pull the first link out of a captured message — html first, then text. Pass
+* `match` to require the URL contain a substring (e.g. `"/reset-password"`),
+* which disambiguates the action link from a logo/footer URL.
+*/
+declare const extractLink: (mail: CapturedMail, options?: {
+  match?: string;
+}) => string;
+export { type InboxOptions, type WaitForMailOptions, extractLink, listCapturedMail, waitForMail };

package/dist/testing.d.ts

@@ -0,0 +1,49 @@
+import { C as CapturedMail } from "./packem_shared/capture-transport.d-ChnhdPO2.js";
+import 'react';
+/** Minimal `fetch` projection so a test can inject a stub. */
+type FetchLike = (input: string, init?: {
+  body?: string;
+  headers?: Record<string, string>;
+  method?: string;
+}) => Promise<{
+  json: () => Promise<unknown>;
+  ok: boolean;
+  status: number;
+}>;
+interface InboxOptions {
+  /** Admin bearer token (`LUNORA_ADMIN_TOKEN`) the worker gates introspection behind. */
+  adminToken: string;
+  /** App base URL, e.g. `http://localhost:8787`. */
+  baseUrl: string;
+  /** Inject a `fetch` implementation (defaults to the global). */
+  fetch?: FetchLike;
+  /** Newest-N to read (default 50). */
+  limit?: number;
+}
+interface WaitForMailOptions extends InboxOptions {
+  /** Poll interval in ms (default 250). */
+  pollMs?: number;
+  /** Only match a message whose subject contains this substring. */
+  subjectMatch?: string;
+  /** Give up after this many ms (default 10000). */
+  timeoutMs?: number;
+  /** Recipient address the message must be addressed to. */
+  to: string;
+}
+/** Read the captured-mail inbox (newest first). */
+declare const listCapturedMail: (options: InboxOptions) => Promise<CapturedMail[]>;
+/**
+* Poll the captured-mail inbox until a message addressed to `to` (optionally
+* matching `subjectMatch`) appears, then return it. Throws on timeout. Entries
+* are newest-first, so the most recent matching message wins.
+*/
+declare const waitForMail: (options: WaitForMailOptions) => Promise<CapturedMail>;
+/**
+* Pull the first link out of a captured message — html first, then text. Pass
+* `match` to require the URL contain a substring (e.g. `"/reset-password"`),
+* which disambiguates the action link from a logo/footer URL.
+*/
+declare const extractLink: (mail: CapturedMail, options?: {
+  match?: string;
+}) => string;
+export { type InboxOptions, type WaitForMailOptions, extractLink, listCapturedMail, waitForMail };

package/dist/testing.mjs

@@ -0,0 +1,57 @@
+const GET_CAPTURED_MAIL_OP = "__lunora_admin__:getCapturedMail";
+const DEFAULT_RPC_PATH = "/_lunora/rpc";
+const TRAILING_SLASH = /\/$/;
+const sleep = async (ms) => new Promise((resolve) => {
+  setTimeout(resolve, ms);
+});
+const recipients = (mail) => Array.isArray(mail.to) ? mail.to : [mail.to];
+const listCapturedMail = async (options) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const endpoint = `${options.baseUrl.replace(TRAILING_SLASH, "")}${DEFAULT_RPC_PATH}`;
+  const response = await fetchImpl(endpoint, {
+    body: JSON.stringify({ args: { limit: options.limit ?? 50 }, functionPath: GET_CAPTURED_MAIL_OP }),
+    headers: { authorization: `Bearer ${options.adminToken}`, "content-type": "application/json" },
+    method: "POST"
+  });
+  if (!response.ok) {
+    throw new Error(`@lunora/mail/testing: getCapturedMail failed (HTTP ${String(response.status)})`);
+  }
+  const body = await response.json();
+  return body.result?.entries ?? [];
+};
+const waitForMail = async (options) => {
+  const timeoutMs = options.timeoutMs ?? 1e4;
+  const pollMs = options.pollMs ?? 250;
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    const entries = await listCapturedMail(options);
+    const match = entries.find(
+      (mail) => recipients(mail).includes(options.to) && (options.subjectMatch === void 0 || mail.subject.includes(options.subjectMatch))
+    );
+    if (match) {
+      return match;
+    }
+    if (Date.now() >= deadline) {
+      throw new Error(
+        `@lunora/mail/testing: no mail to "${options.to}"${options.subjectMatch === void 0 ? "" : ` matching "${options.subjectMatch}"`} within ${String(timeoutMs)}ms`
+      );
+    }
+    await sleep(pollMs);
+  }
+};
+const URL_PATTERN = /https?:\/\/[^\s"'<>)]+/g;
+const extractLink = (mail, options = {}) => {
+  for (const source of [mail.html, mail.text]) {
+    if (source === void 0) {
+      continue;
+    }
+    const matches = source.match(URL_PATTERN) ?? [];
+    const link = matches.find((candidate) => options.match === void 0 || candidate.includes(options.match));
+    if (link !== void 0) {
+      return link;
+    }
+  }
+  throw new Error(`@lunora/mail/testing: no link${options.match === void 0 ? "" : ` containing "${options.match}"`} found in the captured message`);
+};
+
+export { extractLink, listCapturedMail, waitForMail };

package/package.json

@@ -1,31 +1,72 @@
 {
   "name": "@lunora/mail",
-  "version": "0.0.0",
+  "version": "1.0.0-alpha.1",
   "description": "Email for Lunora: Resend adapter, TSX templates, and queue-backed sends",
-  "license": "FSL-1.1-Apache-2.0",
-  "homepage": "https://lunora.sh",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/anolilab/lunora.git",
-    "directory": "packages/mail"
-  },
-  "bugs": {
-    "url": "https://github.com/anolilab/lunora/issues"
-  },
   "keywords": [
-    "lunora",
     "cloudflare",
-    "workers",
     "durable-objects",
     "email",
+    "lunora",
     "mail",
+    "react-email",
     "resend",
-    "react-email"
+    "workers"
   ],
+  "homepage": "https://lunora.sh",
+  "bugs": "https://github.com/anolilab/lunora/issues",
+  "license": "FSL-1.1-Apache-2.0",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anolilab/lunora.git",
+    "directory": "packages/mail"
+  },
+  "files": [
+    "dist",
+    "__assets__",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./inbound": {
+      "types": "./dist/inbound/index.d.ts",
+      "import": "./dist/inbound/index.mjs"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.mjs"
+    },
+    "./package.json": "./package.json"
+  },
   "publishConfig": {
     "access": "public"
   },
-  "files": [
-    "README.md"
-  ]
+  "dependencies": {
+    "@react-email/render": "2.0.9",
+    "@visulima/email": "1.0.0-alpha.41",
+    "postal-mime": "2.7.4"
+  },
+  "peerDependencies": {
+    "react": "^19.2.7"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": "^22.15.0 || >=24.11.0"
+  }
 }