@stacksjs/email 0.70.258 → 0.70.259

package/dist/preview-ui.js

@@ -1,20 +1,4 @@
-const ROOT = "/_stacks/mail/preview";
-function escape(s) {
-  return String(s ?? "").replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
-}
-function fmtAddresses(addresses) {
-  if (!addresses?.length)
-    return "\u2014";
-  return addresses.map((a) => {
-    if (typeof a === "string")
-      return escape(a);
-    if (a.name)
-      return `${escape(a.name)} &lt;${escape(a.address)}&gt;`;
-    return escape(a.address);
-  }).join(", ");
-}
-function shell(title, body) {
-  return `<!DOCTYPE html>
+const ROOT="/_stacks/mail/preview";function escape(s){return String(s??"").replace(/[&<>"']/g,(c)=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"})[c])}function fmtAddresses(addresses){if(!addresses?.length)return"\u2014";return addresses.map((a)=>{if(typeof a==="string")return escape(a);if(a.name)return`${escape(a.name)} &lt;${escape(a.address)}&gt;`;return escape(a.address)}).join(", ")}function shell(title,body){return`<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
@@ -67,66 +51,55 @@ function shell(title, body) {
   </header>
   <main>${body}</main>
 </body>
-</html>`;
-}
-export function renderIndexHtml(mailables) {
-  if (mailables.length === 0)
-    return shell("Index", `
+</html>`}export function renderIndexHtml(mailables){if(mailables.length===0)return shell("Index",`
       <div class="empty panel">
         <p>No Mailables found in <code>app/Mail/</code>.</p>
         <p class="muted">Run <code>./buddy make:mail Welcome</code> to scaffold one.</p>
       </div>
-    `);
-  const items = mailables.map((m) => `
+    `);const items=mailables.map((m)=>`
     <li>
       <a href="${ROOT}/${escape(m.slug)}">${escape(m.name)}</a>
       <div class="muted">app/Mail/${escape(m.name)}.ts \xB7 template: ${escape(m.slug)}.stx</div>
     </li>
-  `).join("");
-  return shell("Index", `
+  `).join("");return shell("Index",`
     <div class="panel">
-      <p class="muted">${mailables.length} mailable${mailables.length === 1 ? "" : "s"} discovered. Add sample props at
+      <p class="muted">${mailables.length} mailable${mailables.length===1?"":"s"} discovered. Add sample props at
       <code>resources/emails/_previews/&lt;slug&gt;.ts</code> for richer previews.</p>
       <ul class="list">${items}</ul>
     </div>
-  `);
-}
-export function renderPreviewHtml(mailable, preview, view = "desktop") {
-  const { inspection, text, sampleProps, error } = preview, baseUrl = `${ROOT}/${mailable.slug}`, rawUrl = `${baseUrl}/raw`, errorBlock = error ? `<div class="panel"><div class="error"><strong>${escape(mailable.name)} failed to render:</strong> ${escape(error)}</div></div>` : "", iframeBlock = error ? "" : view === "text" ? `<div class="panel"><pre>${escape(text || "(no plain-text body)")}</pre></div>` : `<div class="panel"><iframe src="${rawUrl}" class="${view === "mobile" ? "mobile" : ""}" title="${escape(mailable.name)} body" sandbox="allow-same-origin"></iframe></div>`, sampleHint = sampleProps ? `<dd><code>resources/emails/_previews/${escape(mailable.slug)}.ts</code></dd>` : `<dd class="muted">No sample file \u2014 edit <code>resources/emails/_previews/${escape(mailable.slug)}.ts</code> to customize.</dd>`;
-  return shell(mailable.name, `
+  `)}export function renderPreviewHtml(mailable,preview,view="desktop"){const{inspection,text,sampleProps,error}=preview,baseUrl=`${ROOT}/${mailable.slug}`,rawUrl=`${baseUrl}/raw`,errorBlock=error?`<div class="panel"><div class="error"><strong>${escape(mailable.name)} failed to render:</strong> ${escape(error)}</div></div>`:"",iframeBlock=error?"":view==="text"?`<div class="panel"><pre>${escape(text||"(no plain-text body)")}</pre></div>`:`<div class="panel"><iframe src="${rawUrl}" class="${view==="mobile"?"mobile":""}" title="${escape(mailable.name)} body" sandbox="allow-same-origin"></iframe></div>`,sampleHint=sampleProps?`<dd><code>resources/emails/_previews/${escape(mailable.slug)}.ts</code></dd>`:`<dd class="muted">No sample file \u2014 edit <code>resources/emails/_previews/${escape(mailable.slug)}.ts</code> to customize.</dd>`;return shell(mailable.name,`
     ${errorBlock}
 
     <div class="grid">
       <aside>
         <div class="panel">
           <dl class="meta">
-            <dt>Subject</dt><dd>${escape(inspection.subject || "(no subject)")}</dd>
+            <dt>Subject</dt><dd>${escape(inspection.subject||"(no subject)")}</dd>
             <dt>To</dt><dd>${fmtAddresses(inspection.to)}</dd>
-            ${inspection.cc?.length ? `<dt>Cc</dt><dd>${fmtAddresses(inspection.cc)}</dd>` : ""}
-            ${inspection.bcc?.length ? `<dt>Bcc</dt><dd>${fmtAddresses(inspection.bcc)}</dd>` : ""}
-            ${inspection.from ? `<dt>From</dt><dd>${fmtAddresses([inspection.from])}</dd>` : ""}
-            ${inspection.replyTo ? `<dt>Reply-To</dt><dd>${fmtAddresses([inspection.replyTo])}</dd>` : ""}
-            ${inspection.template ? `<dt>Template</dt><dd>${escape(inspection.template.name)}.stx</dd>` : ""}
-            ${inspection.attachments?.length ? `<dt>Attachments</dt><dd>${inspection.attachments.length}</dd>` : ""}
+            ${inspection.cc?.length?`<dt>Cc</dt><dd>${fmtAddresses(inspection.cc)}</dd>`:""}
+            ${inspection.bcc?.length?`<dt>Bcc</dt><dd>${fmtAddresses(inspection.bcc)}</dd>`:""}
+            ${inspection.from?`<dt>From</dt><dd>${fmtAddresses([inspection.from])}</dd>`:""}
+            ${inspection.replyTo?`<dt>Reply-To</dt><dd>${fmtAddresses([inspection.replyTo])}</dd>`:""}
+            ${inspection.template?`<dt>Template</dt><dd>${escape(inspection.template.name)}.stx</dd>`:""}
+            ${inspection.attachments?.length?`<dt>Attachments</dt><dd>${inspection.attachments.length}</dd>`:""}
           </dl>
         </div>
 
         <div class="panel">
           <h3 style="margin: 0 0 8px; font-size: 13px; font-weight: 600;">Sample props</h3>
           ${sampleHint}
-          ${sampleProps ? `<pre>${escape(JSON.stringify(sampleProps, null, 2))}</pre>` : ""}
+          ${sampleProps?`<pre>${escape(JSON.stringify(sampleProps,null,2))}</pre>`:""}
         </div>
       </aside>
 
       <section>
         <div class="toolbar">
-          <a href="${baseUrl}" class="${view === "desktop" ? "active" : ""}">Desktop</a>
-          <a href="${baseUrl}?view=mobile" class="${view === "mobile" ? "active" : ""}">Mobile</a>
-          <a href="${baseUrl}?view=text" class="${view === "text" ? "active" : ""}">Text</a>
+          <a href="${baseUrl}" class="${view==="desktop"?"active":""}">Desktop</a>
+          <a href="${baseUrl}?view=mobile" class="${view==="mobile"?"active":""}">Mobile</a>
+          <a href="${baseUrl}?view=text" class="${view==="text"?"active":""}">Text</a>
           <span class="muted" style="margin-left: auto;">${escape(mailable.name)}</span>
         </div>
         ${iframeBlock}
       </section>
     </div>
-  `);
-}
+  `)}

package/dist/preview.js

@@ -1,97 +1 @@
-import { readdirSync } from "node:fs";
-import { join } from "node:path";
-import { existsSync } from "@stacksjs/storage";
-import { userEmailsPath, userMailPath } from "@stacksjs/path";
-import { kebabCase } from "@stacksjs/strings";
-import { Mailable } from "./mailable";
-import { template } from "./template";
-export function discoverMailables() {
-  const dir = userMailPath();
-  if (!existsSync(dir))
-    return [];
-  const entries = readdirSync(dir, { withFileTypes: !0 }), out = [];
-  for (const entry of entries) {
-    if (!entry.isFile())
-      continue;
-    if (!entry.name.endsWith(".ts"))
-      continue;
-    if (entry.name.endsWith(".d.ts"))
-      continue;
-    if (entry.name.endsWith(".test.ts"))
-      continue;
-    if (entry.name.endsWith(".spec.ts"))
-      continue;
-    const base = entry.name.replace(/\.ts$/, "");
-    out.push({
-      name: base,
-      path: join(dir, entry.name),
-      slug: kebabCase(base)
-    });
-  }
-  out.sort((a, b) => a.name.localeCompare(b.name));
-  return out;
-}
-export async function loadSampleProps(slug) {
-  const samplePath = userEmailsPath(`_previews/${slug}.ts`);
-  if (!existsSync(samplePath))
-    return null;
-  try {
-    const mod = await import(samplePath), props = mod.default ?? mod.props ?? null;
-    return props && typeof props === "object" ? props : null;
-  } catch (err) {
-    return { __preview_error__: `Failed to load sample props: ${err instanceof Error ? err.message : String(err)}` };
-  }
-}
-export async function renderMailablePreview(mailable) {
-  const empty = {
-    inspection: { to: [], cc: [], bcc: [], attachments: [] },
-    html: "",
-    text: "",
-    sampleProps: null
-  };
-  try {
-    const mod = await import(mailable.path), Cls = pickMailableConstructor(mod);
-    if (!Cls)
-      return { ...empty, error: `No subclass of \`Mailable\` exported from ${mailable.path}.` };
-    const sampleProps = await loadSampleProps(mailable.slug), instance = new Cls(sampleProps ?? {});
-    if (!(instance instanceof Mailable))
-      return { ...empty, sampleProps, error: "Constructor did not produce a Mailable instance." };
-    await instance.build();
-    const inspection = instance.inspect();
-    if (!inspection.template)
-      return {
-        inspection,
-        html: inspection.html ?? "",
-        text: inspection.text ?? "",
-        sampleProps
-      };
-    const rendered = await template(inspection.template.name, {
-      variables: inspection.template.props,
-      subject: inspection.subject
-    });
-    return {
-      inspection,
-      html: rendered.html,
-      text: rendered.text,
-      sampleProps
-    };
-  } catch (err) {
-    return { ...empty, error: err instanceof Error ? `${err.name}: ${err.message}` : String(err) };
-  }
-}
-function pickMailableConstructor(mod) {
-  const candidates = [];
-  if (mod.default)
-    candidates.push(mod.default);
-  for (const key of Object.keys(mod))
-    if (key !== "default")
-      candidates.push(mod[key]);
-  for (const candidate of candidates) {
-    if (typeof candidate !== "function")
-      continue;
-    if (!(candidate.prototype instanceof Mailable))
-      continue;
-    return candidate;
-  }
-  return null;
-}
+import{readdirSync}from"node:fs";import{join}from"node:path";import{existsSync}from"@stacksjs/storage";import{userEmailsPath,userMailPath}from"@stacksjs/path";import{kebabCase}from"@stacksjs/strings";import{Mailable}from"./mailable";import{template}from"./template";export function discoverMailables(){const dir=userMailPath();if(!existsSync(dir))return[];const entries=readdirSync(dir,{withFileTypes:!0}),out=[];for(const entry of entries){if(!entry.isFile())continue;if(!entry.name.endsWith(".ts"))continue;if(entry.name.endsWith(".d.ts"))continue;if(entry.name.endsWith(".test.ts"))continue;if(entry.name.endsWith(".spec.ts"))continue;const base=entry.name.replace(/\.ts$/,"");out.push({name:base,path:join(dir,entry.name),slug:kebabCase(base)})}out.sort((a,b)=>a.name.localeCompare(b.name));return out}export async function loadSampleProps(slug){const samplePath=userEmailsPath(`_previews/${slug}.ts`);if(!existsSync(samplePath))return null;try{const mod=await import(samplePath),props=mod.default??mod.props??null;return props&&typeof props==="object"?props:null}catch(err){return{__preview_error__:`Failed to load sample props: ${err instanceof Error?err.message:String(err)}`}}}export async function renderMailablePreview(mailable){const empty={inspection:{to:[],cc:[],bcc:[],attachments:[]},html:"",text:"",sampleProps:null};try{const mod=await import(mailable.path),Cls=pickMailableConstructor(mod);if(!Cls)return{...empty,error:`No subclass of \`Mailable\` exported from ${mailable.path}.`};const sampleProps=await loadSampleProps(mailable.slug),instance=new Cls(sampleProps??{});if(!(instance instanceof Mailable))return{...empty,sampleProps,error:"Constructor did not produce a Mailable instance."};await instance.build();const inspection=instance.inspect();if(!inspection.template)return{inspection,html:inspection.html??"",text:inspection.text??"",sampleProps};const rendered=await template(inspection.template.name,{variables:inspection.template.props,subject:inspection.subject});return{inspection,html:rendered.html,text:rendered.text,sampleProps}}catch(err){return{...empty,error:err instanceof Error?`${err.name}: ${err.message}`:String(err)}}}function pickMailableConstructor(mod){const candidates=[];if(mod.default)candidates.push(mod.default);for(const key of Object.keys(mod))if(key!=="default")candidates.push(mod[key]);for(const candidate of candidates){if(typeof candidate!=="function")continue;if(!(candidate.prototype instanceof Mailable))continue;return candidate}return null}

package/dist/sdk/index.js

@@ -1,221 +1 @@
-import { email as emailConfig } from "@stacksjs/config";
-import { getErrorMessage } from "@stacksjs/utils";
-
-export class EmailSDK {
-  bucket;
-  region;
-  domain;
-  constructor(options) {
-    const appName = (process.env.APP_NAME || "stacks").toLowerCase().replace(/[^a-z0-9-]/g, "-");
-    this.bucket = options?.bucket || process.env.AWS_BUCKET || `${appName}-production-email`;
-    this.region = options?.region || process.env.AWS_REGION || "us-east-1";
-    const fromAddress = emailConfig?.from?.address, parsedDomain = fromAddress?.includes("@") ? fromAddress.split("@")[1] : void 0;
-    this.domain = options?.domain || parsedDomain || "stacksjs.com";
-  }
-  async send(message) {
-    try {
-      const { SESClient } = await import("@stacksjs/ts-cloud"), ses = new SESClient(this.region), from = this.normalizeAddress(message.from || emailConfig?.from || { address: `noreply@${this.domain}` }), toAddresses = this.normalizeAddresses(message.to), ccAddresses = message.cc ? this.normalizeAddresses(message.cc) : void 0, bccAddresses = message.bcc ? this.normalizeAddresses(message.bcc) : void 0;
-      return {
-        success: !0,
-        messageId: (await ses.sendEmail({
-          FromEmailAddress: typeof from === "string" ? from : `${from.name} <${from.address}>`,
-          Destination: {
-            ToAddresses: toAddresses,
-            CcAddresses: ccAddresses,
-            BccAddresses: bccAddresses
-          },
-          ReplyToAddresses: message.replyTo ? [typeof message.replyTo === "string" ? message.replyTo : message.replyTo.address] : void 0,
-          Content: {
-            Simple: {
-              Subject: {
-                Data: message.subject,
-                Charset: "UTF-8"
-              },
-              Body: {
-                ...message.html && {
-                  Html: {
-                    Data: message.html,
-                    Charset: "UTF-8"
-                  }
-                },
-                ...message.text && {
-                  Text: {
-                    Data: message.text,
-                    Charset: "UTF-8"
-                  }
-                }
-              }
-            }
-          }
-        })).MessageId
-      };
-    } catch (error) {
-      return {
-        success: !1,
-        error: getErrorMessage(error)
-      };
-    }
-  }
-  async sendTemplate(options) {
-    const html = this.renderTemplate(options.template, options.data), subject = options.subject || options.template;
-    return this.send({
-      to: options.to,
-      from: options.from,
-      subject,
-      html
-    });
-  }
-  async getInbox(mailbox, options) {
-    try {
-      const { S3Client } = await import("@stacksjs/ts-cloud"), s3 = new S3Client(this.region), [localPart, domain] = mailbox.includes("@") ? mailbox.split("@") : [mailbox, this.domain], indexKey = `mailboxes/${domain}/${localPart}/inbox.json`, result = await s3.getObject(this.bucket, indexKey);
-      if (!result)
-        return [];
-      let inbox = JSON.parse(result);
-      const offset = options?.offset || 0, limit = options?.limit || 50;
-      return inbox.slice(offset, offset + limit);
-    } catch (error) {
-      if (getErrorMessage(error).includes("NoSuchKey") || getErrorMessage(error).includes("404"))
-        return [];
-      throw error;
-    }
-  }
-  async getInboxStats(mailbox) {
-    const inbox = await this.getInbox(mailbox, { limit: 1000 }), unread = inbox.filter((e) => !e.read).length;
-    return {
-      total: inbox.length,
-      unread,
-      read: inbox.length - unread
-    };
-  }
-  async getUnreadCount(mailbox) {
-    return (await this.getInboxStats(mailbox)).unread;
-  }
-  async getEmail(mailbox, messageId) {
-    try {
-      const { S3Client } = await import("@stacksjs/ts-cloud"), s3 = new S3Client(this.region), [localPart, domain] = mailbox.includes("@") ? mailbox.split("@") : [mailbox, this.domain], email = (await this.getInbox(mailbox, { limit: 1000 })).find((e) => e.messageId === messageId);
-      if (!email)
-        return null;
-      const basePath = email.path, metaResult = await s3.getObject(this.bucket, `${basePath}/metadata.json`);
-      let metadata = {};
-      if (metaResult)
-        try {
-          metadata = JSON.parse(metaResult);
-        } catch (parseError) {
-          console.debug(`[email-sdk] Failed to parse email metadata: ${parseError.message}`);
-        }
-      let html;
-      try {
-        html = await s3.getObject(this.bucket, `${basePath}/body.html`) || void 0;
-      } catch (error) {
-        if (!getErrorMessage(error)?.includes("NoSuchKey") && !getErrorMessage(error)?.includes("404"))
-          console.debug(`[email-sdk] Failed to fetch HTML body: ${getErrorMessage(error)}`);
-      }
-      let text;
-      try {
-        text = await s3.getObject(this.bucket, `${basePath}/body.txt`) || void 0;
-      } catch (error) {
-        if (!getErrorMessage(error)?.includes("NoSuchKey") && !getErrorMessage(error)?.includes("404"))
-          console.debug(`[email-sdk] Failed to fetch text body: ${getErrorMessage(error)}`);
-      }
-      return { metadata, html, text };
-    } catch (error) {
-      if (getErrorMessage(error).includes("NoSuchKey") || getErrorMessage(error).includes("404"))
-        return null;
-      throw error;
-    }
-  }
-  async search(mailbox, options) {
-    let results = await this.getInbox(mailbox, { limit: 1000 });
-    if (options.from) {
-      const fromLower = options.from.toLowerCase();
-      results = results.filter((e) => e.from.toLowerCase().includes(fromLower));
-    }
-    if (options.subject) {
-      const subjectLower = options.subject.toLowerCase();
-      results = results.filter((e) => e.subject.toLowerCase().includes(subjectLower));
-    }
-    if (options.after)
-      results = results.filter((e) => new Date(e.date) >= options.after);
-    if (options.before)
-      results = results.filter((e) => new Date(e.date) <= options.before);
-    if (options.hasAttachments !== void 0)
-      results = results.filter((e) => e.hasAttachments === options.hasAttachments);
-    const offset = options.offset || 0, limit = options.limit || 50;
-    return results.slice(offset, offset + limit);
-  }
-  async delete(mailbox, messageId) {
-    const { S3Client } = await import("@stacksjs/ts-cloud"), s3 = new S3Client(this.region), [localPart, domain] = mailbox.includes("@") ? mailbox.split("@") : [mailbox, this.domain], inbox = await this.getInbox(mailbox, { limit: 1000 }), emailIndex = inbox.findIndex((e) => e.messageId === messageId);
-    if (emailIndex === -1)
-      return !1;
-    const email = inbox[emailIndex];
-    if (!email)
-      return !1;
-    const basePath = email.path, keysToDelete = [
-      `${basePath}/metadata.json`,
-      `${basePath}/raw.eml`,
-      `${basePath}/body.html`,
-      `${basePath}/body.txt`,
-      `${basePath}/preview.txt`
-    ];
-    for (const key of keysToDelete)
-      try {
-        await s3.deleteObject(this.bucket, key);
-      } catch (error) {
-        if (!getErrorMessage(error)?.includes("NoSuchKey") && !getErrorMessage(error)?.includes("404"))
-          throw error;
-      }
-    inbox.splice(emailIndex, 1);
-    await s3.putObject({
-      bucket: this.bucket,
-      key: `mailboxes/${domain}/${localPart}/inbox.json`,
-      body: JSON.stringify(inbox, null, 2),
-      contentType: "application/json"
-    });
-    return !0;
-  }
-  async markAsRead(mailbox, messageId) {
-    return this.updateEmailStatus(mailbox, messageId, { read: !0 });
-  }
-  async markAsUnread(mailbox, messageId) {
-    return this.updateEmailStatus(mailbox, messageId, { read: !1 });
-  }
-  async updateEmailStatus(mailbox, messageId, updates) {
-    const { S3Client } = await import("@stacksjs/ts-cloud"), s3 = new S3Client(this.region), [localPart, domain] = mailbox.includes("@") ? mailbox.split("@") : [mailbox, this.domain], inbox = await this.getInbox(mailbox, { limit: 1000 }), emailIndex = inbox.findIndex((e) => e.messageId === messageId);
-    if (emailIndex === -1)
-      return !1;
-    Object.assign(inbox[emailIndex], updates);
-    await s3.putObject({
-      bucket: this.bucket,
-      key: `mailboxes/${domain}/${localPart}/inbox.json`,
-      body: JSON.stringify(inbox, null, 2),
-      contentType: "application/json"
-    });
-    return !0;
-  }
-  normalizeAddress(addr) {
-    if (typeof addr === "string") {
-      const match = addr.match(/^(.+?)\s*<(.+)>$/);
-      if (match)
-        return { name: match[1].trim(), address: match[2].trim() };
-      return { address: addr };
-    }
-    return addr;
-  }
-  normalizeAddresses(addrs) {
-    return (Array.isArray(addrs) ? addrs : [addrs]).map((a) => {
-      if (typeof a === "string")
-        return a;
-      return a.name ? `${a.name} <${a.address}>` : a.address;
-    });
-  }
-  renderTemplate(template, data) {
-    let result = template;
-    for (const [key, value] of Object.entries(data)) {
-      const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-      result = result.replace(new RegExp(`{{\\s*${escapedKey}\\s*}}`, "g"), String(value));
-    }
-    return result;
-  }
-}
-export const emailSDK = new EmailSDK, sendEmail = (message) => emailSDK.send(message), getInbox = (mailbox, options) => emailSDK.getInbox(mailbox, options), getInboxStats = (mailbox) => emailSDK.getInboxStats(mailbox), getUnreadCount = (mailbox) => emailSDK.getUnreadCount(mailbox), searchEmails = (mailbox, options) => emailSDK.search(mailbox, options), deleteEmail = (mailbox, messageId) => emailSDK.delete(mailbox, messageId);
-export default EmailSDK;
+import{email as emailConfig}from"@stacksjs/config";import{getErrorMessage}from"@stacksjs/utils";export class EmailSDK{bucket;region;domain;constructor(options){const appName=(process.env.APP_NAME||"stacks").toLowerCase().replace(/[^a-z0-9-]/g,"-");this.bucket=options?.bucket||process.env.AWS_BUCKET||`${appName}-production-email`;this.region=options?.region||process.env.AWS_REGION||"us-east-1";const fromAddress=emailConfig?.from?.address,parsedDomain=fromAddress?.includes("@")?fromAddress.split("@")[1]:void 0;this.domain=options?.domain||parsedDomain||"stacksjs.com"}async send(message){try{const{SESClient}=await import("@stacksjs/ts-cloud"),ses=new SESClient(this.region),from=this.normalizeAddress(message.from||emailConfig?.from||{address:`noreply@${this.domain}`}),toAddresses=this.normalizeAddresses(message.to),ccAddresses=message.cc?this.normalizeAddresses(message.cc):void 0,bccAddresses=message.bcc?this.normalizeAddresses(message.bcc):void 0;return{success:!0,messageId:(await ses.sendEmail({FromEmailAddress:typeof from==="string"?from:`${from.name} <${from.address}>`,Destination:{ToAddresses:toAddresses,CcAddresses:ccAddresses,BccAddresses:bccAddresses},ReplyToAddresses:message.replyTo?[typeof message.replyTo==="string"?message.replyTo:message.replyTo.address]:void 0,Content:{Simple:{Subject:{Data:message.subject,Charset:"UTF-8"},Body:{...message.html&&{Html:{Data:message.html,Charset:"UTF-8"}},...message.text&&{Text:{Data:message.text,Charset:"UTF-8"}}}}}})).MessageId}}catch(error){return{success:!1,error:getErrorMessage(error)}}}async sendTemplate(options){const html=this.renderTemplate(options.template,options.data),subject=options.subject||options.template;return this.send({to:options.to,from:options.from,subject,html})}async getInbox(mailbox,options){try{const{S3Client}=await import("@stacksjs/ts-cloud"),s3=new S3Client(this.region),[localPart,domain]=mailbox.includes("@")?mailbox.split("@"):[mailbox,this.domain],indexKey=`mailboxes/${domain}/${localPart}/inbox.json`,result=await s3.getObject(this.bucket,indexKey);if(!result)return[];let inbox=JSON.parse(result);const offset=options?.offset||0,limit=options?.limit||50;return inbox.slice(offset,offset+limit)}catch(error){if(getErrorMessage(error).includes("NoSuchKey")||getErrorMessage(error).includes("404"))return[];throw error}}async getInboxStats(mailbox){const inbox=await this.getInbox(mailbox,{limit:1000}),unread=inbox.filter((e)=>!e.read).length;return{total:inbox.length,unread,read:inbox.length-unread}}async getUnreadCount(mailbox){return(await this.getInboxStats(mailbox)).unread}async getEmail(mailbox,messageId){try{const{S3Client}=await import("@stacksjs/ts-cloud"),s3=new S3Client(this.region),[localPart,domain]=mailbox.includes("@")?mailbox.split("@"):[mailbox,this.domain],email=(await this.getInbox(mailbox,{limit:1000})).find((e)=>e.messageId===messageId);if(!email)return null;const basePath=email.path,metaResult=await s3.getObject(this.bucket,`${basePath}/metadata.json`);let metadata={};if(metaResult)try{metadata=JSON.parse(metaResult)}catch(parseError){console.debug(`[email-sdk] Failed to parse email metadata: ${parseError.message}`)}let html;try{html=await s3.getObject(this.bucket,`${basePath}/body.html`)||void 0}catch(error){if(!getErrorMessage(error)?.includes("NoSuchKey")&&!getErrorMessage(error)?.includes("404"))console.debug(`[email-sdk] Failed to fetch HTML body: ${getErrorMessage(error)}`)}let text;try{text=await s3.getObject(this.bucket,`${basePath}/body.txt`)||void 0}catch(error){if(!getErrorMessage(error)?.includes("NoSuchKey")&&!getErrorMessage(error)?.includes("404"))console.debug(`[email-sdk] Failed to fetch text body: ${getErrorMessage(error)}`)}return{metadata,html,text}}catch(error){if(getErrorMessage(error).includes("NoSuchKey")||getErrorMessage(error).includes("404"))return null;throw error}}async search(mailbox,options){let results=await this.getInbox(mailbox,{limit:1000});if(options.from){const fromLower=options.from.toLowerCase();results=results.filter((e)=>e.from.toLowerCase().includes(fromLower))}if(options.subject){const subjectLower=options.subject.toLowerCase();results=results.filter((e)=>e.subject.toLowerCase().includes(subjectLower))}if(options.after)results=results.filter((e)=>new Date(e.date)>=options.after);if(options.before)results=results.filter((e)=>new Date(e.date)<=options.before);if(options.hasAttachments!==void 0)results=results.filter((e)=>e.hasAttachments===options.hasAttachments);const offset=options.offset||0,limit=options.limit||50;return results.slice(offset,offset+limit)}async delete(mailbox,messageId){const{S3Client}=await import("@stacksjs/ts-cloud"),s3=new S3Client(this.region),[localPart,domain]=mailbox.includes("@")?mailbox.split("@"):[mailbox,this.domain],inbox=await this.getInbox(mailbox,{limit:1000}),emailIndex=inbox.findIndex((e)=>e.messageId===messageId);if(emailIndex===-1)return!1;const email=inbox[emailIndex];if(!email)return!1;const basePath=email.path,keysToDelete=[`${basePath}/metadata.json`,`${basePath}/raw.eml`,`${basePath}/body.html`,`${basePath}/body.txt`,`${basePath}/preview.txt`];for(const key of keysToDelete)try{await s3.deleteObject(this.bucket,key)}catch(error){if(!getErrorMessage(error)?.includes("NoSuchKey")&&!getErrorMessage(error)?.includes("404"))throw error}inbox.splice(emailIndex,1);await s3.putObject({bucket:this.bucket,key:`mailboxes/${domain}/${localPart}/inbox.json`,body:JSON.stringify(inbox,null,2),contentType:"application/json"});return!0}async markAsRead(mailbox,messageId){return this.updateEmailStatus(mailbox,messageId,{read:!0})}async markAsUnread(mailbox,messageId){return this.updateEmailStatus(mailbox,messageId,{read:!1})}async updateEmailStatus(mailbox,messageId,updates){const{S3Client}=await import("@stacksjs/ts-cloud"),s3=new S3Client(this.region),[localPart,domain]=mailbox.includes("@")?mailbox.split("@"):[mailbox,this.domain],inbox=await this.getInbox(mailbox,{limit:1000}),emailIndex=inbox.findIndex((e)=>e.messageId===messageId);if(emailIndex===-1)return!1;Object.assign(inbox[emailIndex],updates);await s3.putObject({bucket:this.bucket,key:`mailboxes/${domain}/${localPart}/inbox.json`,body:JSON.stringify(inbox,null,2),contentType:"application/json"});return!0}normalizeAddress(addr){if(typeof addr==="string"){const match=addr.match(/^(.+?)\s*<(.+)>$/);if(match)return{name:match[1].trim(),address:match[2].trim()};return{address:addr}}return addr}normalizeAddresses(addrs){return(Array.isArray(addrs)?addrs:[addrs]).map((a)=>{if(typeof a==="string")return a;return a.name?`${a.name} <${a.address}>`:a.address})}renderTemplate(template,data){let result=template;for(const[key,value]of Object.entries(data)){const escapedKey=key.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");result=result.replace(new RegExp(`{{\\s*${escapedKey}\\s*}}`,"g"),String(value))}return result}}export const emailSDK=new EmailSDK,sendEmail=(message)=>emailSDK.send(message),getInbox=(mailbox,options)=>emailSDK.getInbox(mailbox,options),getInboxStats=(mailbox)=>emailSDK.getInboxStats(mailbox),getUnreadCount=(mailbox)=>emailSDK.getUnreadCount(mailbox),searchEmails=(mailbox,options)=>emailSDK.search(mailbox,options),deleteEmail=(mailbox,messageId)=>emailSDK.delete(mailbox,messageId);export default EmailSDK;

package/dist/suppression.js

@@ -1,104 +1 @@
-import { db } from "@stacksjs/database";
-let warnedAboutMissingTable = !1;
-function warnOnceAboutMissingTable() {
-  if (warnedAboutMissingTable)
-    return;
-  warnedAboutMissingTable = !0;
-  console.warn("[email/suppression] email_suppressions table missing \u2014 suppression checks accepted but NOT enforced. " + "Run migrations to enable enforcement.");
-}
-export function isMissingTableError(err) {
-  const e = err, msg = e?.message ?? "";
-  return e?.code === "42P01" || msg.includes("no such table") || msg.includes("doesn't exist") || /relation "[^"]*" does not exist/i.test(msg);
-}
-function isSuppressionStoreUnavailable(err) {
-  if (isMissingTableError(err))
-    return !0;
-  const msg = (err?.message ?? "").toLowerCase();
-  return msg.includes("connection closed") || msg.includes("unable to open database") || msg.includes("econnrefused") || msg.includes("connection terminated") || msg.includes("no database") || msg.includes("database connection");
-}
-function canonicalize(email) {
-  return String(email).trim().toLowerCase();
-}
-export async function isSuppressed(email, type) {
-  const canon = canonicalize(email);
-  try {
-    let query = db.selectFrom("email_suppressions").where("email", "=", canon).select(["email"]);
-    if (type)
-      query = query.where("type", "=", type);
-    const row = await query.executeTakeFirst();
-    return Boolean(row);
-  } catch (err) {
-    if (isSuppressionStoreUnavailable(err)) {
-      warnOnceAboutMissingTable();
-      return !1;
-    }
-    throw err;
-  }
-}
-export async function getSuppressions(email) {
-  const canon = canonicalize(email);
-  try {
-    return await db.selectFrom("email_suppressions").where("email", "=", canon).selectAll().execute() ?? [];
-  } catch (err) {
-    if (isSuppressionStoreUnavailable(err)) {
-      warnOnceAboutMissingTable();
-      return [];
-    }
-    throw err;
-  }
-}
-export async function suppress(email, type, reason) {
-  const canon = canonicalize(email), createdAt = new Date().toISOString().slice(0, 19).replace("T", " ");
-  try {
-    await db.insertInto("email_suppressions").values({
-      email: canon,
-      type,
-      reason: reason ?? null,
-      created_at: createdAt
-    }).execute();
-  } catch (err) {
-    if (isSuppressionStoreUnavailable(err)) {
-      warnOnceAboutMissingTable();
-      return;
-    }
-    const msg = err?.message ?? "";
-    if (msg.includes("UNIQUE constraint") || msg.includes("Duplicate entry"))
-      return;
-    throw err;
-  }
-}
-export async function unsuppress(email, type) {
-  const canon = canonicalize(email);
-  try {
-    await db.deleteFrom("email_suppressions").where("email", "=", canon).where("type", "=", type).execute();
-  } catch (err) {
-    if (isSuppressionStoreUnavailable(err)) {
-      warnOnceAboutMissingTable();
-      return;
-    }
-    throw err;
-  }
-}
-export async function getSuppressionPolicy() {
-  try {
-    const { config } = await import("@stacksjs/config"), policy = config?.email?.suppressionPolicy;
-    if (policy === "strict" || policy === "transactional-allowed" || policy === "off")
-      return policy;
-  } catch {}
-  return "strict";
-}
-export async function checkSuppressionFor(email, tag) {
-  const policy = await getSuppressionPolicy();
-  if (policy === "off")
-    return null;
-  if (policy === "transactional-allowed" && tag === "transactional")
-    return null;
-  const suppressions = await getSuppressions(email);
-  if (suppressions.length === 0)
-    return null;
-  const priority = ["unsubscribe", "complaint", "bounce", "manual"];
-  for (const p of priority)
-    if (suppressions.some((s) => s.type === p))
-      return p;
-  return suppressions[0].type;
-}
+import{db}from"@stacksjs/database";let warnedAboutMissingTable=!1;function warnOnceAboutMissingTable(){if(warnedAboutMissingTable)return;warnedAboutMissingTable=!0;console.warn("[email/suppression] email_suppressions table missing \u2014 suppression checks accepted but NOT enforced. "+"Run migrations to enable enforcement.")}export function isMissingTableError(err){const e=err,msg=e?.message??"";return e?.code==="42P01"||msg.includes("no such table")||msg.includes("doesn't exist")||/relation "[^"]*" does not exist/i.test(msg)}function isSuppressionStoreUnavailable(err){if(isMissingTableError(err))return!0;const msg=(err?.message??"").toLowerCase();return msg.includes("connection closed")||msg.includes("unable to open database")||msg.includes("econnrefused")||msg.includes("connection terminated")||msg.includes("no database")||msg.includes("database connection")}function canonicalize(email){return String(email).trim().toLowerCase()}export async function isSuppressed(email,type){const canon=canonicalize(email);try{let query=db.selectFrom("email_suppressions").where("email","=",canon).select(["email"]);if(type)query=query.where("type","=",type);const row=await query.executeTakeFirst();return Boolean(row)}catch(err){if(isSuppressionStoreUnavailable(err)){warnOnceAboutMissingTable();return!1}throw err}}export async function getSuppressions(email){const canon=canonicalize(email);try{return await db.selectFrom("email_suppressions").where("email","=",canon).selectAll().execute()??[]}catch(err){if(isSuppressionStoreUnavailable(err)){warnOnceAboutMissingTable();return[]}throw err}}export async function suppress(email,type,reason){const canon=canonicalize(email),createdAt=new Date().toISOString().slice(0,19).replace("T"," ");try{await db.insertInto("email_suppressions").values({email:canon,type,reason:reason??null,created_at:createdAt}).execute()}catch(err){if(isSuppressionStoreUnavailable(err)){warnOnceAboutMissingTable();return}const msg=err?.message??"";if(msg.includes("UNIQUE constraint")||msg.includes("Duplicate entry"))return;throw err}}export async function unsuppress(email,type){const canon=canonicalize(email);try{await db.deleteFrom("email_suppressions").where("email","=",canon).where("type","=",type).execute()}catch(err){if(isSuppressionStoreUnavailable(err)){warnOnceAboutMissingTable();return}throw err}}export async function getSuppressionPolicy(){try{const{config}=await import("@stacksjs/config"),policy=config?.email?.suppressionPolicy;if(policy==="strict"||policy==="transactional-allowed"||policy==="off")return policy}catch{}return"strict"}export async function checkSuppressionFor(email,tag){const policy=await getSuppressionPolicy();if(policy==="off")return null;if(policy==="transactional-allowed"&&tag==="transactional")return null;const suppressions=await getSuppressions(email);if(suppressions.length===0)return null;const priority=["unsubscribe","complaint","bounce","manual"];for(const p of priority)if(suppressions.some((s)=>s.type===p))return p;return suppressions[0].type}