@lunora/mail 1.0.0-alpha.2 → 1.0.0-alpha.21

package/dist/packem_shared/capture-transport.d-BJ__iWzS.d.ts

@@ -0,0 +1,117 @@
+import { ReactElement } from 'react';
+/**
+ * Minimal projection of a Cloudflare Queue binding — accepts a JSON payload
+ * via `.send()`. Declared structurally so callers can pass either the real
+ * `Queue` binding or a unit-test double.
+ */
+interface QueueLike {
+  send: (payload: unknown, options?: Record<string, unknown>) => Promise<void>;
+}
+/**
+ * Minimal projection of a transport adapter. Returning `{ id }` follows
+ * Resend's response shape; the real `@visulima/email` `MailManager` flattens
+ * provider responses to the same field for us.
+ */
+interface MailTransport {
+  send: (payload: SendPayload) => Promise<{
+    id: string;
+  }>;
+}
+interface SendPayload {
+  bcc?: string[];
+  cc?: string[];
+  from?: string;
+  headers?: Record<string, string>;
+  html?: string;
+  replyTo?: string;
+  subject: string;
+  text?: string;
+  to: string | string[];
+}
+interface SendOptions {
+  bcc?: string[];
+  cc?: string[];
+  from?: string;
+  headers?: Record<string, string>;
+  html?: string;
+  react?: ReactElement;
+  replyTo?: string;
+  subject: string;
+  text?: string;
+  to: string | string[];
+}
+interface LunoraMailOptions {
+  /** API key for the Resend transport (bring-your-own-provider). Ignored when `transport` or `cloudflareSend` is set. */
+  apiKey?: string;
+  /**
+   * RFC 822 send callback bound to the Worker's `send_email` binding. When set
+   * (and no explicit `transport` is supplied) the default transport is
+   * Cloudflare Email Workers — Lunora's default provider. Ignored when
+   * `transport` is set.
+   */
+  cloudflareSend?: (from: string, to: string, raw: string) => Promise<void>;
+  /** Default sender (`Name &lt;addr@host>` or bare email). */
+  from: string;
+  /** Default queue binding for `mailer.queue()`. */
+  queue?: QueueLike;
+  /** Override the underlying transport. Useful for tests, the dev capture transport, + multi-provider setups. */
+  transport?: MailTransport;
+}
+interface Mailer {
+  queue: (options: SendOptions) => Promise<{
+    queued: true;
+  }>;
+  send: (options: SendOptions) => Promise<{
+    id: string;
+  }>;
+}
+/**
+ * One captured outbound message as persisted by the dev mail catcher. Extends
+ * the rendered, validated {@link SendPayload} with an `id` and a capture
+ * timestamp assigned by the sink (the root-shard mailbox), so the studio inbox
+ * can list and open it.
+ *
+ * **Canonical captured-mail wire type — single source of truth.** Every other
+ * representation of a captured message mirrors this shape; consumers import it
+ * directly wherever the package dependency direction allows.
+ *
+ * `@lunora/studio`'s `CapturedMail` re-exports this (type-only dep on
+ * `@lunora/mail`). `@lunora/do`'s `CapturedMailRow` / `RecordMailInput` are
+ * documented mirrors — the DO runtime stays free of any `@lunora/mail` *runtime*
+ * dep — guarded by a compile-time structural assertion against this type, so a
+ * field added here that isn't mirrored fails the `@lunora/do` build.
+ *
+ * Add or change a captured-mail field here first; the guards will point at the
+ * mirrors that need the matching change.
+ */
+interface CapturedMail extends SendPayload {
+  /** Epoch-ms the message was captured. */
+  capturedAt: number;
+  /** Stable id assigned to the captured message. */
+  id: string;
+}
+/**
+ * Minimal projection of the persistence target the capture transport writes to
+ * (the studio's root-shard mailbox). Declared structurally — like
+ * {@link import("./types").QueueLike} — so `@lunora/mail` stays free of any
+ * Durable Object / runtime dependency. The registry scaffold supplies the
+ * concrete sink that POSTs to the root shard's `__lunora_admin__:recordMail` RPC.
+ */
+interface MailboxSink {
+  record: (mail: SendPayload) => Promise<{
+    id: string;
+  }>;
+}
+/**
+ * Build a capture {@link MailTransport}: instead of delivering, it persists the
+ * fully rendered + validated payload to `sink` and returns the assigned id.
+ *
+ * Wired in dev by the mail registry scaffold so `lunora dev` shows every send in
+ * the studio's Mail inbox — including `@lunora/auth`'s verification and
+ * forgot-password mail — with no provider credentials and nothing leaving the
+ * machine. Address/header validation already ran in `createMailer.buildPayload`
+ * before the payload reaches here, so the captured message is the same one a
+ * real transport would have sent.
+ */
+declare const createCaptureTransport: (sink: MailboxSink) => MailTransport;
+export { CapturedMail as C, LunoraMailOptions as L, MailTransport as M, QueueLike as Q, SendOptions as S, Mailer as a, MailboxSink as b, SendPayload as c, createCaptureTransport as d };

package/dist/packem_shared/consumeQueuedSend-BXrPhND5.mjs

@@ -0,0 +1 @@
+import{LunoraError as c}from"@lunora/errors";const h=t=>({bcc:t.bcc,cc:t.cc,from:t.from,headers:t.headers,html:t.html,replyTo:t.replyTo,subject:t.subject,text:t.text,to:t.to}),b=async(t,s)=>{if(!s||typeof s!="object"||Array.isArray(s))throw new c("INTERNAL","@lunora/mail: queue message body must be an object");const e=s;if(typeof e.subject!="string")throw new TypeError("@lunora/mail: queue message must have a string `subject`");const m=typeof e.to=="string",y=Array.isArray(e.to)&&e.to.every(o=>typeof o=="string");if(!m&&!y)throw new c("INTERNAL","@lunora/mail: queue message `to` must be a string or string[]");const a=(o,r)=>{if(r!==void 0){if(typeof r!="string")throw new TypeError(`@lunora/mail: queue message \`${o}\` must be a string`);return r}},u=(o,r)=>{if(r!==void 0){if(typeof r=="string")return[r];if(Array.isArray(r)&&r.every(n=>typeof n=="string"))return r;throw new TypeError(`@lunora/mail: queue message \`${o}\` must be a string or string[]`)}};let i;if(e.headers!==void 0){if(!e.headers||typeof e.headers!="object"||Array.isArray(e.headers))throw new TypeError("@lunora/mail: queue message `headers` must be an object of string values");const o=Object.entries(e.headers);for(const[r,n]of o)if(typeof n!="string")throw new TypeError(`@lunora/mail: queue message header "${r}" must be a string`);i=e.headers}const f={bcc:u("bcc",e.bcc),cc:u("cc",e.cc),from:a("from",e.from),headers:i,html:a("html",e.html),replyTo:a("replyTo",e.replyTo),subject:e.subject,text:a("text",e.text),to:e.to};return t.send(f)};export{b as consumeQueuedSend,h as toQueuedPayload};

package/dist/packem_shared/createCaptureSink-fVjCTUBC.mjs

@@ -0,0 +1 @@
+import{LunoraError as u}from"@lunora/errors";import{createCaptureTransport as s}from"./createCaptureTransport-BPdMkU0O.mjs";import n from"./createMailer-CsVLrc75.mjs";import{d as l,u as c}from"./shard-CcKsuWAm.mjs";const f="__lunora_admin__:recordMail",p=/^(?:dev(?:elopment)?|local(?:host)?|test)$/iu,m=["CF_ENV","ENVIRONMENT","NODE_ENV","WORKER_ENV"],E=(e,t)=>{const r=e[t];if(typeof r!="string"||r==="")throw new u("INTERNAL",`@lunora/mail: missing env var \`${t}\` — set it in .dev.vars (and \`wrangler secret put ${t}\` for secrets).`);return r},_=e=>{const t=e.LUNORA_MAIL_CAPTURE;if(typeof t=="string"){const r=t.toLowerCase();if(r==="1"||r==="true")return!0;if(r==="0"||r==="false")return!1;console.warn(`@lunora/mail: unrecognized LUNORA_MAIL_CAPTURE value "${t}" — expected "1"/"true" or "0"/"false"; falling back to environment detection.`)}return m.some(r=>{const o=e[r];return typeof o=="string"&&p.test(o)})},N=(e,t=l,r)=>({record:async o=>{const a=e.SHARD,i=typeof e.LUNORA_ADMIN_TOKEN=="string"?e.LUNORA_ADMIN_TOKEN:void 0;if(a===void 0||i===void 0)return{id:"uncaptured"};try{return{id:(await c(a,{adminToken:i,envelope:{args:o,functionPath:f},jurisdiction:r,label:"@lunora/mail: recording captured mail",shardKey:t})).result?.id??"captured"}}catch(d){return console.error("@lunora/mail: failed to record captured mail into the studio inbox —",d),{id:"uncaptured"}}}}),I=(e,t={})=>{const r=E(e,"MAIL_FROM");if(_(e))return n({from:r,transport:s(N(e,t.rootShard,t.jurisdiction))});if(t.cloudflareSend)return n({cloudflareSend:t.cloudflareSend,from:r});const o=typeof e.RESEND_API_KEY=="string"?e.RESEND_API_KEY:void 0;if(o!==void 0&&o!=="")return n({apiKey:o,from:r});throw new u("INTERNAL","@lunora/mail: no transport configured — provide `cloudflareSend` (a SEND_EMAIL binding) or RESEND_API_KEY, or run in a dev environment to capture.")};export{N as createCaptureSink,I as createMailerFromEnv,_ as shouldCaptureMail};

package/dist/packem_shared/createCaptureTransport-BPdMkU0O.mjs

@@ -0,0 +1 @@
+const a=Symbol.for("@lunora/mail.captureTransport"),t=r=>r[a]===!0,o=r=>({[a]:!0,send:async e=>r.record(e)});export{a as CAPTURE_TRANSPORT_BRAND,o as createCaptureTransport,t as isCaptureTransport};

package/dist/packem_shared/createCloudflareTransport-V23CVw7F.mjs

@@ -0,0 +1 @@
+import{LunoraError as t}from"@lunora/errors";import{cloudflareEmailProvider as l}from"@visulima/email/providers/cloudflare-email";import{o as d,c as f,f as u}from"./provider-transport-BZngzyeS.mjs";const g=o=>{const n=l({send:o.send});return{send:async e=>{await n.initialize();const i=e.cc!==void 0&&e.cc.length>0,a=e.bcc!==void 0&&e.bcc.length>0;if(i||a)throw new t("INTERNAL","@lunora/mail: Cloudflare Email Workers does not support cc/bcc — fan out one send per recipient instead");const{first:s,list:r}=d(e.to);if(r.length>1)throw new t("INTERNAL",`@lunora/mail: Cloudflare Email Workers is single-recipient but received ${String(r.length)} \`to\` addresses — fan out one send per recipient instead`);const c=await n.sendEmail(f(e,o.from,s));return u(c)}}};export{g as createCloudflareTransport};

package/dist/packem_shared/createInboundEmailHandler-B7H4h_sK.mjs

@@ -0,0 +1 @@
+import{LunoraError as c}from"@lunora/errors";import{u as d,d as u}from"./shard-CcKsuWAm.mjs";const h="message could not be processed",m=(t,a)=>{console.error("@lunora/mail/inbound: dropping message —",t),a.message.setReject(h)},y=t=>{const a=t.onError??m;return async(e,n,s)=>{const r={ctx:s,env:n,message:e};try{const o=await t.parse(e.raw);if(t.verify&&await t.verify(o,r)===!1)throw new c("INTERNAL","@lunora/mail/inbound: sender verification rejected the message");await t.dispatch(o,r)}catch(o){await a(o,r)}}},i=32768,l=t=>{let a="";for(let e=0;e<t.length;e+=i)a+=String.fromCharCode(...t.subarray(e,e+i));return btoa(a)},f=t=>t.attachments.length===0?t:{...t,attachments:t.attachments.map(a=>{const{content:e}=a;if(typeof e=="string")return a;const n=e instanceof Uint8Array?e:new Uint8Array(e);return{...a,content:l(n),encoding:"base64"}})},N=t=>{const a=t.shardKey??u,e=t.resolveArgs??(n=>f(n));return async(n,s)=>{const r=t.adminToken??(typeof s.env.LUNORA_ADMIN_TOKEN=="string"?s.env.LUNORA_ADMIN_TOKEN:void 0);if(r===void 0||r==="")throw new c("INTERNAL","@lunora/mail/inbound: missing LUNORA_ADMIN_TOKEN — cannot authorize inbound dispatch to the shard RPC.");const o={args:e(n,s),functionPath:t.functionPath,shardKey:a};await d(t.shard,{adminToken:r,envelope:o,jurisdiction:t.jurisdiction,label:`@lunora/mail/inbound: dispatch to \`${t.functionPath}\``,shardKey:a})}};export{y as createInboundEmailHandler,N as dispatchToLunoraFunction};

package/dist/packem_shared/createMailer-CsVLrc75.mjs

@@ -0,0 +1 @@
+import{LunoraError as c}from"@lunora/errors";import{m as s,f}from"./address-Y4Z--6ZO.mjs";import{isCaptureTransport as d}from"./createCaptureTransport-BPdMkU0O.mjs";import{createCloudflareTransport as l}from"./createCloudflareTransport-V23CVw7F.mjs";import{toQueuedPayload as p}from"./consumeQueuedSend-BXrPhND5.mjs";import h from"./renderEmail-DM8_pWKa.mjs";import w from"./createResendTransport-CpSJ4j7C.mjs";const y=e=>{if(e.cloudflareSend)return l({from:e.from,send:e.cloudflareSend});if(e.apiKey)return w(e.apiKey,e.from);throw new c("INTERNAL","@lunora/mail: a transport is required — pass `transport`, `cloudflareSend` (Cloudflare Email Workers, the default), or `apiKey` (Resend)")},L=e=>{if(!e.from)throw new c("INTERNAL","@lunora/mail: `from` is required");const u=e.transport??y(e),n=async r=>{let{html:t}=r,{text:a}=r;if(r.react){const o=await h(r.react);t=t??o.html,a=a??o.text}if(s("subject",r.subject),r.headers)for(const[o,m]of Object.entries(r.headers))s(`header name "${o}"`,o),s(`header "${o}" value`,m);const i=r.from??e.from;return f({bcc:r.bcc,cc:r.cc,from:i,replyTo:r.replyTo,to:r.to}),{bcc:r.bcc,cc:r.cc,from:i,headers:r.headers,html:t,replyTo:r.replyTo,subject:r.subject,text:a,to:r.to}};return{queue:async r=>{if(!e.queue){if(d(u)){const a=await n(r);return await u.send(a),{queued:!0}}throw new c("INTERNAL","@lunora/mail: `queue` binding is required for mailer.queue()")}const t=await n(r);return await e.queue.send(p(t)),{queued:!0}},send:async r=>{const t=await n(r);return u.send(t)}}};export{L as default};

package/dist/packem_shared/createResendTransport-CpSJ4j7C.mjs

@@ -0,0 +1 @@
+import{resendProvider as a}from"@visulima/email/providers/resend";import{o as m,c,f as d}from"./provider-transport-BZngzyeS.mjs";const p=(o,e)=>{const t=a({apiKey:o});return{send:async r=>{await t.initialize();const{first:n,list:i}=m(r.to),s=await t.sendEmail(c(r,e,i.length===1?n:i));return d(s)}}};export{p as default};

package/dist/packem_shared/parseInboundEmail-tJMs3YON.mjs

@@ -0,0 +1 @@
+import l from"postal-mime";import{m as i}from"./address-Y4Z--6ZO.mjs";const s=(n,e)=>{if(e!==void 0)return i(`inbound ${n}`,e),e},m=n=>n.address!==void 0&&n.address!==""?n.name?`${n.name} <${n.address}>`:n.address:n.group?n.group.map(e=>e.address??"").filter(e=>e!=="").join(", "):n.name??"",a=(n,e)=>new RegExp(String.raw`\b${e}=([a-zA-Z]+)`,"i").exec(n)?.[1]?.toLowerCase()??null,p=n=>n===void 0||n===""?{dkim:null,dmarc:null,spf:null}:{dkim:a(n,"dkim"),dmarc:a(n,"dmarc"),spf:a(n,"spf")},g=async n=>{const e=await l.parse(n),d={};for(const o of e.headers)i(`inbound header \`${o.key}\``,o.value),d[o.key]=o.value;const c=e.headers.find(o=>o.key==="authentication-results")?.value,u=(e.to??[]).map(o=>{const r=m(o);return i("inbound to",r),r}),t=e.from?m(e.from):"";return i("inbound from",t),{attachments:e.attachments.map(o=>({content:o.content,disposition:o.disposition,...o.encoding===void 0?{}:{encoding:o.encoding},filename:o.filename,mimeType:o.mimeType})),authentication:p(c),from:t,headers:d,...e.html===void 0?{}:{html:e.html},...s("inReplyTo",e.inReplyTo)===void 0?{}:{inReplyTo:e.inReplyTo},...s("messageId",e.messageId)===void 0?{}:{messageId:e.messageId},...s("references",e.references)===void 0?{}:{references:e.references},...s("subject",e.subject)===void 0?{}:{subject:e.subject},...e.text===void 0?{}:{text:e.text},to:u}};export{g as parseInboundEmail};

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

@@ -0,0 +1 @@
+import{LunoraError as s}from"@lunora/errors";import{i,o as n}from"./address-Y4Z--6ZO.mjs";const e=r=>r instanceof Error?r.message:r==null?"send failed":typeof r=="string"?r:typeof r=="number"||typeof r=="boolean"||typeof r=="bigint"?r.toString():JSON.stringify(r)??"send failed",c=r=>{const o=i(r),[t]=o??[];if(!o||t===void 0)throw new s("INTERNAL","@lunora/mail: at least one recipient is required");return{first:t,list:o}},f=(r,o,t)=>({bcc:i(r.bcc),cc:i(r.cc),from:n(r.from??o),headers:r.headers,html:r.html,replyTo:r.replyTo?n(r.replyTo):void 0,subject:r.subject,text:r.text,to:t}),d=r=>{if(!r.success||!r.data)throw console.error(`@lunora/mail: send failed: ${e(r.error)}`),new s("INTERNAL","@lunora/mail: send failed");return{id:r.data.messageId}};export{f as c,d as f,c as o};

package/dist/packem_shared/renderEmail-DM8_pWKa.mjs

@@ -0,0 +1 @@
+import{render as e}from"@react-email/render";const n=async t=>{const[r,a]=await Promise.all([e(t,{pretty:!1}),e(t,{plainText:!0})]);return{html:r,text:a}};export{n as default};

package/dist/packem_shared/shard-CcKsuWAm.mjs

@@ -0,0 +1 @@
+import{LunoraError as a}from"@lunora/errors";const c="__root__",s=(o,r)=>{if(r===void 0)return o;if(typeof o.jurisdiction!="function")throw new TypeError(`@lunora/mail: Durable Object namespace does not support jurisdiction("${r}") — update @cloudflare/workers-types or remove the jurisdiction option`);return o.jurisdiction(r)},d=async(o,r)=>{const i=s(o,r.jurisdiction),n=await i.get(i.idFromName(r.shardKey)).fetch("https://shard.internal/rpc",{body:JSON.stringify(r.envelope),headers:{authorization:`Bearer ${r.adminToken}`,"content-type":"application/json"},method:"POST"});if(n.ok===!1)throw new a("INTERNAL",`${r.label} failed (HTTP ${String(n.status??"?")}).`);const t=await n.json();if(typeof t=="object"&&t!==null&&"error"in t){const{error:e}=t;if(e!=null)throw new a("INTERNAL",`${r.label} returned an error: ${JSON.stringify(e)}`)}return t};export{c as d,d as u};

package/dist/packem_shared/shard.d-DVADjmEJ.d.mts

@@ -0,0 +1,29 @@
+/** Structural projection of one shard stub — only `fetch` returning a Fetch-`Response`-like object. */
+interface ShardStubLike {
+  fetch: (input: string, init?: {
+    body?: string;
+    headers?: Record<string, string>;
+    method?: string;
+  }) => Promise<{
+    json: () => Promise<unknown>;
+    ok?: boolean;
+    status?: number;
+  }>;
+}
+/**
+ * Cloudflare Durable Object data-residency jurisdiction. Widening union —
+ * Cloudflare adds values over time.
+ * @see https://developers.cloudflare.com/durable-objects/reference/data-location/
+ */
+type DurableObjectJurisdiction = "eu" | "fedramp" | "us";
+/** Structural projection of the `SHARD` Durable Object namespace. */
+interface ShardNamespaceLike {
+  get: (id: unknown) => ShardStubLike;
+  idFromName: (name: string) => unknown;
+  /**
+   * Derive a jurisdiction-restricted subnamespace. Optional because older
+   * workers-types releases (and test doubles) may not expose it.
+   */
+  jurisdiction?: (jurisdiction: DurableObjectJurisdiction) => ShardNamespaceLike;
+}
+export { DurableObjectJurisdiction as D, ShardNamespaceLike as S, ShardStubLike as a };

package/dist/packem_shared/shard.d-DVADjmEJ.d.ts

@@ -0,0 +1,29 @@
+/** Structural projection of one shard stub — only `fetch` returning a Fetch-`Response`-like object. */
+interface ShardStubLike {
+  fetch: (input: string, init?: {
+    body?: string;
+    headers?: Record<string, string>;
+    method?: string;
+  }) => Promise<{
+    json: () => Promise<unknown>;
+    ok?: boolean;
+    status?: number;
+  }>;
+}
+/**
+ * Cloudflare Durable Object data-residency jurisdiction. Widening union —
+ * Cloudflare adds values over time.
+ * @see https://developers.cloudflare.com/durable-objects/reference/data-location/
+ */
+type DurableObjectJurisdiction = "eu" | "fedramp" | "us";
+/** Structural projection of the `SHARD` Durable Object namespace. */
+interface ShardNamespaceLike {
+  get: (id: unknown) => ShardStubLike;
+  idFromName: (name: string) => unknown;
+  /**
+   * Derive a jurisdiction-restricted subnamespace. Optional because older
+   * workers-types releases (and test doubles) may not expose it.
+   */
+  jurisdiction?: (jurisdiction: DurableObjectJurisdiction) => ShardNamespaceLike;
+}
+export { DurableObjectJurisdiction as D, ShardNamespaceLike as S, ShardStubLike as a };

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { C as CapturedMail } from "./packem_shared/capture-transport.d-ChnhdPO2.mjs";
+import { C as CapturedMail } from "./packem_shared/capture-transport.d-BJ__iWzS.mjs";
 import 'react';
 /** Minimal `fetch` projection so a test can inject a stub. */
 type FetchLike = (input: string, init?: {
@@ -33,16 +33,16 @@ interface WaitForMailOptions extends InboxOptions {
 /** 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.
-*/
+ * 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.
-*/
+ * 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;

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { C as CapturedMail } from "./packem_shared/capture-transport.d-ChnhdPO2.js";
+import { C as CapturedMail } from "./packem_shared/capture-transport.d-BJ__iWzS.js";
 import 'react';
 /** Minimal `fetch` projection so a test can inject a stub. */
 type FetchLike = (input: string, init?: {
@@ -33,16 +33,16 @@ interface WaitForMailOptions extends InboxOptions {
 /** 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.
-*/
+ * 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.
-*/
+ * 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;

package/dist/testing.mjs

@@ -1,57 +1 @@
-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 };
+import{LunoraError as e}from"@lunora/errors";const s="__lunora_admin__:getCapturedMail",c="/_lunora/rpc",l=/\/$/,u=async t=>new Promise(i=>{setTimeout(i,t)}),h=t=>Array.isArray(t.to)?t.to:[t.to],m=async t=>{const i=t.fetch??globalThis.fetch,n=`${t.baseUrl.replace(l,"")}${c}`,a=await i(n,{body:JSON.stringify({args:{limit:t.limit??50},functionPath:s}),headers:{authorization:`Bearer ${t.adminToken}`,"content-type":"application/json"},method:"POST"});if(!a.ok)throw new e("INTERNAL",`@lunora/mail/testing: getCapturedMail failed (HTTP ${String(a.status)})`);return(await a.json()).result?.entries??[]},w=async t=>{const i=t.timeoutMs??1e4,n=t.pollMs??250,a=Date.now()+i;for(;;){const o=(await m(t)).find(r=>h(r).includes(t.to)&&(t.subjectMatch===void 0||r.subject.includes(t.subjectMatch)));if(o)return o;if(Date.now()>=a)throw new e("INTERNAL",`@lunora/mail/testing: no mail to "${t.to}"${t.subjectMatch===void 0?"":` matching "${t.subjectMatch}"`} within ${String(i)}ms`);await u(n)}},d=/https?:\/\/[^\s"'<>)]+/g,f=/&(?:amp|#0*38|#x0*26);/giu,g=t=>t.replaceAll(f,"&"),M=(t,i={})=>{for(const n of[t.html,t.text]){if(n===void 0)continue;const a=(n.match(d)??[]).find(o=>i.match===void 0||o.includes(i.match));if(a!==void 0)return g(a)}throw new e("INTERNAL",`@lunora/mail/testing: no link${i.match===void 0?"":` containing "${i.match}"`} found in the captured message`)};export{M as extractLink,m as listCapturedMail,w as waitForMail};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/mail",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.21",
   "description": "Email for Lunora: Resend adapter, TSX templates, and queue-backed sends",
   "keywords": [
     "cloudflare",
@@ -25,7 +25,7 @@
     "directory": "packages/mail"
   },
   "files": [
-    "dist",
+    "./dist",
     "__assets__",
     "README.md",
     "LICENSE.md"
@@ -54,9 +54,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@react-email/render": "2.0.9",
-    "@visulima/email": "1.0.0-alpha.41",
-    "postal-mime": "2.7.4"
+    "@lunora/errors": "1.0.0-alpha.8",
+    "@react-email/render": "2.1.0",
+    "@visulima/email": "2.1.2",
+    "postal-mime": "2.7.5"
   },
   "peerDependencies": {
     "react": "^19.2.7"

package/dist/packem_shared/address-fkXxLKza.mjs

@@ -1,62 +0,0 @@
-const MAX_EMAIL_LENGTH = 320;
-const MAX_NAME_LENGTH = 256;
-const ADDRESS_PATTERN = /^([^<]*)<([^>]*)>\s*$/;
-const assertSafeAddressField = (field, value) => {
-  if (value.includes("\r") || value.includes("\n") || value.includes(",")) {
-    throw new Error(`@lunora/mail: address ${field} must not contain CR, LF, or comma`);
-  }
-};
-const assertSafeHeaderValue = (label, value) => {
-  if (value.includes("\r") || value.includes("\n")) {
-    throw new Error(`@lunora/mail: ${label} must not contain CR or LF`);
-  }
-};
-const toBracketedAddress = (name, email) => {
-  if (name.length > MAX_NAME_LENGTH) {
-    throw new Error(`@lunora/mail: address name must be <= ${String(MAX_NAME_LENGTH)} characters`);
-  }
-  if (email.length > MAX_EMAIL_LENGTH) {
-    throw new Error(`@lunora/mail: address email must be <= ${String(MAX_EMAIL_LENGTH)} characters`);
-  }
-  if (name) {
-    assertSafeAddressField("name", name);
-  }
-  assertSafeAddressField("email", email);
-  return name ? { email, name } : { email };
-};
-const toBareAddress = (input) => {
-  const email = input.trim();
-  if (email.length > MAX_EMAIL_LENGTH) {
-    throw new Error(`@lunora/mail: address email must be <= ${String(MAX_EMAIL_LENGTH)} characters`);
-  }
-  assertSafeAddressField("email", email);
-  return { email };
-};
-const toAddress = (input) => {
-  const match = ADDRESS_PATTERN.exec(input);
-  const email = (match?.[2] ?? "").trim();
-  if (match && email) {
-    return toBracketedAddress((match[1] ?? "").trim(), email);
-  }
-  return toBareAddress(input);
-};
-const toAddressList = (input) => {
-  if (input === void 0) {
-    return void 0;
-  }
-  const list = Array.isArray(input) ? input : [input];
-  return list.map((entry) => toAddress(entry));
-};
-const assertSafeAddresses = (payload) => {
-  toAddressList(payload.to);
-  toAddressList(payload.cc);
-  toAddressList(payload.bcc);
-  if (payload.from !== void 0) {
-    toAddress(payload.from);
-  }
-  if (payload.replyTo !== void 0) {
-    toAddress(payload.replyTo);
-  }
-};
-
-export { assertSafeHeaderValue as a, assertSafeAddresses as b, toAddress as c, toAddressList as t };

package/dist/packem_shared/capture-transport.d-ChnhdPO2.d.mts

@@ -1,117 +0,0 @@
-import { ReactElement } from 'react';
-/**
-* Minimal projection of a Cloudflare Queue binding — accepts a JSON payload
-* via `.send()`. Declared structurally so callers can pass either the real
-* `Queue` binding or a unit-test double.
-*/
-interface QueueLike {
-  send: (payload: unknown, options?: Record<string, unknown>) => Promise<void>;
-}
-/**
-* Minimal projection of a transport adapter. Returning `{ id }` follows
-* Resend's response shape; the real `@visulima/email` `MailManager` flattens
-* provider responses to the same field for us.
-*/
-interface MailTransport {
-  send: (payload: SendPayload) => Promise<{
-    id: string;
-  }>;
-}
-interface SendPayload {
-  bcc?: string[];
-  cc?: string[];
-  from?: string;
-  headers?: Record<string, string>;
-  html?: string;
-  replyTo?: string;
-  subject: string;
-  text?: string;
-  to: string | string[];
-}
-interface SendOptions {
-  bcc?: string[];
-  cc?: string[];
-  from?: string;
-  headers?: Record<string, string>;
-  html?: string;
-  react?: ReactElement;
-  replyTo?: string;
-  subject: string;
-  text?: string;
-  to: string | string[];
-}
-interface LunoraMailOptions {
-  /** API key for the Resend transport (bring-your-own-provider). Ignored when `transport` or `cloudflareSend` is set. */
-  apiKey?: string;
-  /**
-  * RFC 822 send callback bound to the Worker's `send_email` binding. When set
-  * (and no explicit `transport` is supplied) the default transport is
-  * Cloudflare Email Workers — Lunora's default provider. Ignored when
-  * `transport` is set.
-  */
-  cloudflareSend?: (from: string, to: string, raw: string) => Promise<void>;
-  /** Default sender (`Name &lt;addr@host>` or bare email). */
-  from: string;
-  /** Default queue binding for `mailer.queue()`. */
-  queue?: QueueLike;
-  /** Override the underlying transport. Useful for tests, the dev capture transport, + multi-provider setups. */
-  transport?: MailTransport;
-}
-interface Mailer {
-  queue: (options: SendOptions) => Promise<{
-    queued: true;
-  }>;
-  send: (options: SendOptions) => Promise<{
-    id: string;
-  }>;
-}
-/**
-* One captured outbound message as persisted by the dev mail catcher. Extends
-* the rendered, validated {@link SendPayload} with an `id` and a capture
-* timestamp assigned by the sink (the root-shard mailbox), so the studio inbox
-* can list and open it.
-*
-* **Canonical captured-mail wire type — single source of truth.** Every other
-* representation of a captured message mirrors this shape; consumers import it
-* directly wherever the package dependency direction allows.
-*
-* `@lunora/studio`'s `CapturedMail` re-exports this (type-only dep on
-* `@lunora/mail`). `@lunora/do`'s `CapturedMailRow` / `RecordMailInput` are
-* documented mirrors — the DO runtime stays free of any `@lunora/mail` *runtime*
-* dep — guarded by a compile-time structural assertion against this type, so a
-* field added here that isn't mirrored fails the `@lunora/do` build.
-*
-* Add or change a captured-mail field here first; the guards will point at the
-* mirrors that need the matching change.
-*/
-interface CapturedMail extends SendPayload {
-  /** Epoch-ms the message was captured. */
-  capturedAt: number;
-  /** Stable id assigned to the captured message. */
-  id: string;
-}
-/**
-* Minimal projection of the persistence target the capture transport writes to
-* (the studio's root-shard mailbox). Declared structurally — like
-* {@link import("./types").QueueLike} — so `@lunora/mail` stays free of any
-* Durable Object / runtime dependency. The registry scaffold supplies the
-* concrete sink that POSTs to the root shard's `__lunora_admin__:recordMail` RPC.
-*/
-interface MailboxSink {
-  record: (mail: SendPayload) => Promise<{
-    id: string;
-  }>;
-}
-/**
-* Build a capture {@link MailTransport}: instead of delivering, it persists the
-* fully rendered + validated payload to `sink` and returns the assigned id.
-*
-* Wired in dev by the mail registry scaffold so `lunora dev` shows every send in
-* the studio's Mail inbox — including `@lunora/auth`'s verification and
-* forgot-password mail — with no provider credentials and nothing leaving the
-* machine. Address/header validation already ran in `createMailer.buildPayload`
-* before the payload reaches here, so the captured message is the same one a
-* real transport would have sent.
-*/
-declare const createCaptureTransport: (sink: MailboxSink) => MailTransport;
-export { CapturedMail as C, LunoraMailOptions as L, MailTransport as M, QueueLike as Q, SendOptions as S, Mailer as a, MailboxSink as b, SendPayload as c, createCaptureTransport as d };