@stacksjs/email 0.70.257 → 0.70.259

package/dist/email.js

@@ -1,198 +1 @@
-import { config } from "@stacksjs/config";
-import { log } from "@stacksjs/logging";
-import { CaptureEmailDriver } from "./drivers/capture";
-import { LogEmailDriver } from "./drivers/log";
-import { MailgunDriver } from "./drivers/mailgun";
-import { MailtrapDriver } from "./drivers/mailtrap";
-import { SendGridDriver } from "./drivers/sendgrid";
-import { SESDriver } from "./drivers/ses";
-import { SMTPDriver } from "./drivers/smtp";
-import { findEmailByIdempotencyKey, recordEmailIdempotency } from "./idempotency";
-import { checkSuppressionFor } from "./suppression";
-
-export class Email {
-  name;
-  subject;
-  to;
-  from;
-  template;
-  handle;
-  onError;
-  onSuccess;
-  constructor(options) {
-    this.name = options.name;
-    this.subject = options.subject;
-    this.to = options.to;
-    this.from = options.from;
-    this.template = options.template;
-    this.handle = options.handle;
-    this.onError = options.onError;
-    this.onSuccess = options.onSuccess;
-  }
-  async renderTemplate() {
-    if (!this.template)
-      return "";
-    try {
-      const { path: p } = await import("@stacksjs/path"), templatePath = p.resourcesPath(`views/emails/${this.template}.html`), file = Bun.file(templatePath);
-      if (await file.exists())
-        return await file.text();
-    } catch {}
-    if (this.template.includes("<"))
-      return this.template;
-    return `<p>${this.template}</p>`;
-  }
-  async send(to) {
-    const target = to ?? this.to, recipients = Array.isArray(target) ? target : target ? [target] : [];
-    if (recipients.length === 0)
-      throw Error("No recipient specified for email");
-    try {
-      await mail.send({
-        to: recipients,
-        from: this.from || {
-          name: config.email.from?.name || "Stacks",
-          address: config.email.from?.address || "no-reply@stacksjs.com"
-        },
-        subject: this.subject,
-        html: await this.renderTemplate()
-      });
-      if (this.onSuccess)
-        this.onSuccess();
-      if (this.handle)
-        return this.handle();
-      return { message: "Email sent" };
-    } catch (error) {
-      if (this.onError)
-        return this.onError(error instanceof Error ? error : Error(String(error)));
-      throw error;
-    }
-  }
-}
-
-export class Mail {
-  drivers = new Map;
-  defaultDriver;
-  constructor(options = {}) {
-    this.defaultDriver = options.defaultDriver || config.email.default || "ses";
-    this.registerDefaultDrivers();
-  }
-  registerDefaultDrivers() {
-    this.drivers.set("log", new LogEmailDriver);
-    this.drivers.set("ses", new SESDriver);
-    this.drivers.set("sendgrid", new SendGridDriver);
-    this.drivers.set("mailgun", new MailgunDriver);
-    this.drivers.set("mailtrap", new MailtrapDriver);
-    this.drivers.set("smtp", new SMTPDriver);
-    this.drivers.set("capture", new CaptureEmailDriver);
-  }
-  async send(message) {
-    const driver = this.drivers.get(this.defaultDriver);
-    if (!driver) {
-      const available = [...this.drivers.keys()].sort().join(", ");
-      throw Error(`Email driver '${this.defaultDriver}' is not registered. Available drivers: [${available}]. Check config.email.default or the MAIL_MAILER environment variable.`);
-    }
-    if (message.idempotencyKey) {
-      const cached = await findEmailByIdempotencyKey(message.idempotencyKey);
-      if (cached)
-        return cached;
-    }
-    const suppressionType = await checkSuppressionForFirstRecipient(message);
-    if (suppressionType)
-      return {
-        success: !1,
-        message: `suppressed:${suppressionType}`,
-        provider: "suppression"
-      };
-    const defaultFrom = {
-      name: config.email.from?.name || "Stacks",
-      address: config.email.from?.address || "no-reply@stacksjs.com"
-    }, result = await driver.send({
-      ...message,
-      from: message.from || defaultFrom
-    });
-    if (message.idempotencyKey)
-      await recordEmailIdempotency(message.idempotencyKey, message, result);
-    return result;
-  }
-  use(driver) {
-    if (!this.drivers.has(driver))
-      throw Error(`Email driver '${driver}' is not available`);
-    return new Mail({ defaultDriver: driver });
-  }
-  async queue(message) {
-    await this.dispatchOrFallback(message, async () => {
-      const { job } = await import("@stacksjs/queue");
-      await job("SendEmail", { message, driver: this.defaultDriver }).onQueue("emails").dispatch();
-    }, { context: "queue" });
-  }
-  async later(delaySeconds, message) {
-    await this.dispatchOrFallback(message, async () => {
-      const { job } = await import("@stacksjs/queue");
-      await job("SendEmail", { message, driver: this.defaultDriver }).onQueue("emails").delay(delaySeconds).dispatch();
-    }, { context: "later", delaySeconds });
-  }
-  async queueOn(queueName, message) {
-    await this.dispatchOrFallback(message, async () => {
-      const { job } = await import("@stacksjs/queue");
-      await job("SendEmail", { message, driver: this.defaultDriver }).onQueue(queueName).dispatch();
-    }, { context: "queueOn", queueName });
-  }
-  async dispatchOrFallback(message, dispatch, logExtra) {
-    try {
-      await dispatch();
-      return;
-    } catch (error) {
-      const reason = error instanceof Error ? error.message : String(error);
-      log.warn("[email] Queue dispatch failed; falling back to synchronous send. " + "Background email pipeline is degraded \u2014 check the queue worker / broker.", { ...logExtra, reason });
-    }
-    await this.send(message);
-  }
-}
-async function checkSuppressionForFirstRecipient(message) {
-  const recipients = collectRecipientAddresses(message);
-  if (recipients.length === 0)
-    return null;
-  for (const addr of recipients) {
-    const matched = await checkSuppressionFor(addr, message.tag);
-    if (matched)
-      return matched;
-  }
-  return null;
-}
-function collectRecipientAddresses(message) {
-  const out = [], pushOne = (v) => {
-    if (typeof v === "string") {
-      out.push(v);
-      return;
-    }
-    if (v && typeof v === "object" && "address" in v && typeof v.address === "string")
-      out.push(v.address);
-  };
-  for (const field of ["to", "cc", "bcc"]) {
-    const v = message[field];
-    if (!v)
-      continue;
-    if (Array.isArray(v))
-      for (const item of v)
-        pushOne(item);
-    else
-      pushOne(v);
-  }
-  return out;
-}
-let _mail;
-function getMail() {
-  if (!_mail) {
-    const driver = config?.email?.default || process.env.MAIL_MAILER || "ses";
-    _mail = new Mail({ defaultDriver: driver });
-  }
-  return _mail;
-}
-export const mail = new Proxy({}, {
-  get(_t, prop) {
-    return getMail()[prop];
-  },
-  set(_t, prop, value) {
-    getMail()[prop] = value;
-    return !0;
-  }
-});
+import{config}from"@stacksjs/config";import{log}from"@stacksjs/logging";import{CaptureEmailDriver}from"./drivers/capture";import{LogEmailDriver}from"./drivers/log";import{MailgunDriver}from"./drivers/mailgun";import{MailtrapDriver}from"./drivers/mailtrap";import{SendGridDriver}from"./drivers/sendgrid";import{SESDriver}from"./drivers/ses";import{SMTPDriver}from"./drivers/smtp";import{findEmailByIdempotencyKey,recordEmailIdempotency}from"./idempotency";import{checkSuppressionFor}from"./suppression";export class Email{name;subject;to;from;template;handle;onError;onSuccess;constructor(options){this.name=options.name;this.subject=options.subject;this.to=options.to;this.from=options.from;this.template=options.template;this.handle=options.handle;this.onError=options.onError;this.onSuccess=options.onSuccess}async renderTemplate(){if(!this.template)return"";try{const{path:p}=await import("@stacksjs/path"),templatePath=p.resourcesPath(`views/emails/${this.template}.html`),file=Bun.file(templatePath);if(await file.exists())return await file.text()}catch{}if(this.template.includes("<"))return this.template;return`<p>${this.template}</p>`}async send(to){const target=to??this.to,recipients=Array.isArray(target)?target:target?[target]:[];if(recipients.length===0)throw Error("No recipient specified for email");try{await mail.send({to:recipients,from:this.from||{name:config.email.from?.name||"Stacks",address:config.email.from?.address||"no-reply@stacksjs.com"},subject:this.subject,html:await this.renderTemplate()});if(this.onSuccess)this.onSuccess();if(this.handle)return this.handle();return{message:"Email sent"}}catch(error){if(this.onError)return this.onError(error instanceof Error?error:Error(String(error)));throw error}}}export class Mail{drivers=new Map;defaultDriver;constructor(options={}){this.defaultDriver=options.defaultDriver||config.email.default||"ses";this.registerDefaultDrivers()}registerDefaultDrivers(){this.drivers.set("log",new LogEmailDriver);this.drivers.set("ses",new SESDriver);this.drivers.set("sendgrid",new SendGridDriver);this.drivers.set("mailgun",new MailgunDriver);this.drivers.set("mailtrap",new MailtrapDriver);this.drivers.set("smtp",new SMTPDriver);this.drivers.set("capture",new CaptureEmailDriver)}async send(message){const driver=this.drivers.get(this.defaultDriver);if(!driver){const available=[...this.drivers.keys()].sort().join(", ");throw Error(`Email driver '${this.defaultDriver}' is not registered. Available drivers: [${available}]. Check config.email.default or the MAIL_MAILER environment variable.`)}if(message.idempotencyKey){const cached=await findEmailByIdempotencyKey(message.idempotencyKey);if(cached)return cached}const suppressionType=await checkSuppressionForFirstRecipient(message);if(suppressionType)return{success:!1,message:`suppressed:${suppressionType}`,provider:"suppression"};const defaultFrom={name:config.email.from?.name||"Stacks",address:config.email.from?.address||"no-reply@stacksjs.com"},result=await driver.send({...message,from:message.from||defaultFrom});if(message.idempotencyKey)await recordEmailIdempotency(message.idempotencyKey,message,result);return result}use(driver){if(!this.drivers.has(driver))throw Error(`Email driver '${driver}' is not available`);return new Mail({defaultDriver:driver})}async queue(message){await this.dispatchOrFallback(message,async()=>{const{job}=await import("@stacksjs/queue");await job("SendEmail",{message,driver:this.defaultDriver}).onQueue("emails").dispatch()},{context:"queue"})}async later(delaySeconds,message){await this.dispatchOrFallback(message,async()=>{const{job}=await import("@stacksjs/queue");await job("SendEmail",{message,driver:this.defaultDriver}).onQueue("emails").delay(delaySeconds).dispatch()},{context:"later",delaySeconds})}async queueOn(queueName,message){await this.dispatchOrFallback(message,async()=>{const{job}=await import("@stacksjs/queue");await job("SendEmail",{message,driver:this.defaultDriver}).onQueue(queueName).dispatch()},{context:"queueOn",queueName})}async dispatchOrFallback(message,dispatch,logExtra){try{await dispatch();return}catch(error){const reason=error instanceof Error?error.message:String(error);log.warn("[email] Queue dispatch failed; falling back to synchronous send. "+"Background email pipeline is degraded \u2014 check the queue worker / broker.",{...logExtra,reason})}await this.send(message)}}async function checkSuppressionForFirstRecipient(message){const recipients=collectRecipientAddresses(message);if(recipients.length===0)return null;for(const addr of recipients){const matched=await checkSuppressionFor(addr,message.tag);if(matched)return matched}return null}function collectRecipientAddresses(message){const out=[],pushOne=(v)=>{if(typeof v==="string"){out.push(v);return}if(v&&typeof v==="object"&&"address"in v&&typeof v.address==="string")out.push(v.address)};for(const field of["to","cc","bcc"]){const v=message[field];if(!v)continue;if(Array.isArray(v))for(const item of v)pushOne(item);else pushOne(v)}return out}let _mail;function getMail(){if(!_mail){const driver=config?.email?.default||process.env.MAIL_MAILER||"ses";_mail=new Mail({defaultDriver:driver})}return _mail}export const mail=new Proxy({},{get(_t,prop){return getMail()[prop]},set(_t,prop,value){getMail()[prop]=value;return!0}});

package/dist/idempotency.js

@@ -1,56 +1 @@
-import { db } from "@stacksjs/database";
-let warnedAboutMissingEmailIdempotencyTable = !1;
-function warnOnceAboutMissingTable() {
-  if (warnedAboutMissingEmailIdempotencyTable)
-    return;
-  warnedAboutMissingEmailIdempotencyTable = !0;
-  console.warn("[email/idempotency] email_idempotency table missing \u2014 idempotency keys are accepted but NOT enforced. " + "Run migrations to enable dedup.");
-}
-function isMissingTableError(err) {
-  const msg = (err?.message ?? "").toLowerCase();
-  return msg.includes("no such table") || msg.includes("doesn't exist") || 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");
-}
-export async function findEmailByIdempotencyKey(key) {
-  try {
-    const row = await db.selectFrom("email_idempotency").where("idempotency_key", "=", key).selectAll().executeTakeFirst();
-    if (!row)
-      return null;
-    return {
-      success: Boolean(row.success),
-      message: `Idempotent replay \u2014 original send recorded ${row.created_at}`,
-      provider: String(row.provider ?? "cache"),
-      messageId: row.message_id ?? void 0
-    };
-  } catch (err) {
-    if (isMissingTableError(err)) {
-      warnOnceAboutMissingTable();
-      return null;
-    }
-    throw err;
-  }
-}
-export async function recordEmailIdempotency(key, message, result) {
-  if (!result.success)
-    return;
-  const recipient = Array.isArray(message.to) ? message.to.map((t) => typeof t === "string" ? t : t.address).join(", ") : typeof message.to === "string" ? message.to : message.to.address;
-  try {
-    await db.insertInto("email_idempotency").values({
-      idempotency_key: key,
-      message_id: result.messageId ?? null,
-      recipient,
-      subject: message.subject,
-      provider: result.provider,
-      success: 1,
-      created_at: new Date().toISOString().slice(0, 19).replace("T", " ")
-    }).execute();
-  } catch (err) {
-    if (isMissingTableError(err)) {
-      warnOnceAboutMissingTable();
-      return;
-    }
-    const msg = err?.message ?? "";
-    if (msg.includes("UNIQUE constraint") || msg.includes("Duplicate entry"))
-      return;
-    throw err;
-  }
-}
+import{db}from"@stacksjs/database";let warnedAboutMissingEmailIdempotencyTable=!1;function warnOnceAboutMissingTable(){if(warnedAboutMissingEmailIdempotencyTable)return;warnedAboutMissingEmailIdempotencyTable=!0;console.warn("[email/idempotency] email_idempotency table missing \u2014 idempotency keys are accepted but NOT enforced. "+"Run migrations to enable dedup.")}function isMissingTableError(err){const msg=(err?.message??"").toLowerCase();return msg.includes("no such table")||msg.includes("doesn't exist")||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")}export async function findEmailByIdempotencyKey(key){try{const row=await db.selectFrom("email_idempotency").where("idempotency_key","=",key).selectAll().executeTakeFirst();if(!row)return null;return{success:Boolean(row.success),message:`Idempotent replay \u2014 original send recorded ${row.created_at}`,provider:String(row.provider??"cache"),messageId:row.message_id??void 0}}catch(err){if(isMissingTableError(err)){warnOnceAboutMissingTable();return null}throw err}}export async function recordEmailIdempotency(key,message,result){if(!result.success)return;const recipient=Array.isArray(message.to)?message.to.map((t)=>typeof t==="string"?t:t.address).join(", "):typeof message.to==="string"?message.to:message.to.address;try{await db.insertInto("email_idempotency").values({idempotency_key:key,message_id:result.messageId??null,recipient,subject:message.subject,provider:result.provider,success:1,created_at:new Date().toISOString().slice(0,19).replace("T"," ")}).execute()}catch(err){if(isMissingTableError(err)){warnOnceAboutMissingTable();return}const msg=err?.message??"";if(msg.includes("UNIQUE constraint")||msg.includes("Duplicate entry"))return;throw err}}

package/dist/index.js

@@ -1,21 +1 @@
-export * from "./drivers";
-export * from "./email";
-export * from "./idempotency";
-export * from "./suppression";
-export * from "./unsubscribe";
-export * from "./webhook-dedup";
-export * from "./webhook-events";
-export * from "./webhook-handlers";
-export * from "./webhook-signatures";
-export * from "./mailable";
-export * from "./mime-preview";
-export * from "./sdk";
-export * from "./template";
-export * from "./types";
-export { inlineCss, shouldInlineByDefault } from "./css-inliner";
-export {
-  discoverMailables,
-  loadSampleProps,
-  renderMailablePreview
-} from "./preview";
-export { renderIndexHtml, renderPreviewHtml } from "./preview-ui";
+export*from"./drivers";export*from"./email";export*from"./idempotency";export*from"./suppression";export*from"./unsubscribe";export*from"./webhook-dedup";export*from"./webhook-events";export*from"./webhook-handlers";export*from"./webhook-signatures";export*from"./mailable";export*from"./mime-preview";export*from"./sdk";export*from"./template";export*from"./types";export{inlineCss,shouldInlineByDefault}from"./css-inliner";export{discoverMailables,loadSampleProps,renderMailablePreview}from"./preview";export{renderIndexHtml,renderPreviewHtml}from"./preview-ui";

package/dist/mailable.js

@@ -1,145 +1 @@
-import { config } from "@stacksjs/config";
-import { mail } from "./email";
-import { template as renderTemplate } from "./template";
-
-export class Mailable {
-  _to = [];
-  _cc = [];
-  _bcc = [];
-  _replyTo;
-  _from;
-  _subject;
-  _text;
-  _html;
-  _template;
-  _attachments = [];
-  to(address) {
-    this._to = normalizeAddresses(address);
-    return this;
-  }
-  cc(address) {
-    this._cc = normalizeAddresses(address);
-    return this;
-  }
-  bcc(address) {
-    this._bcc = normalizeAddresses(address);
-    return this;
-  }
-  replyTo(address) {
-    this._replyTo = typeof address === "string" ? { address } : address;
-    return this;
-  }
-  from(addr) {
-    this._from = addr;
-    return this;
-  }
-  subject(s) {
-    this._subject = s;
-    return this;
-  }
-  text(body) {
-    this._text = body;
-    return this;
-  }
-  html(body) {
-    this._html = body;
-    return this;
-  }
-  template(name, ...rest) {
-    const props = rest[0] ?? {};
-    this._template = { name, props };
-    return this;
-  }
-  inspect() {
-    return {
-      to: this._to,
-      cc: this._cc,
-      bcc: this._bcc,
-      from: this._from,
-      replyTo: this._replyTo,
-      subject: this._subject,
-      text: this._text,
-      html: this._html,
-      template: this._template,
-      attachments: this._attachments
-    };
-  }
-  attach(path, name) {
-    this._attachments.push({
-      filename: name || basename(path),
-      content: `__file__:${path}`,
-      encoding: "binary"
-    });
-    return this;
-  }
-  attachData(buffer, name, mime) {
-    this._attachments.push({
-      filename: name,
-      content: buffer,
-      contentType: mime,
-      encoding: typeof buffer === "string" ? "utf8" : "binary"
-    });
-    return this;
-  }
-  async send(options = {}) {
-    await Promise.resolve(this.build());
-    if (this._to.length === 0)
-      throw Error("[Mailable] no recipients \u2014 call this.to(...) inside build()");
-    if (!this._subject)
-      throw Error("[Mailable] no subject \u2014 call this.subject(...) inside build()");
-    let html = this._html, text = this._text;
-    if (this._template) {
-      const rendered = await renderTemplate(this._template.name, {
-        variables: this._template.props,
-        subject: this._subject
-      });
-      if (!html)
-        html = rendered.html;
-      if (!text)
-        text = rendered.text;
-    }
-    const message = {
-      to: this._to,
-      subject: this._subject,
-      from: this._from || resolveDefaultFrom(),
-      ...this._cc.length ? { cc: this._cc } : {},
-      ...this._bcc.length ? { bcc: this._bcc } : {},
-      ...html ? { html } : {},
-      ...text ? { text } : {},
-      ...this._attachments.length ? { attachments: await materializeAttachments(this._attachments) } : {}
-    };
-    if (this._replyTo)
-      message.replyTo = this._replyTo;
-    return (options.driver ? mail.use(options.driver) : mail).send(message);
-  }
-}
-function normalizeAddresses(input) {
-  const arr = Array.isArray(input) ? input : [input];
-  if (arr.some((a) => typeof a === "object" && a !== null))
-    return arr.map((a) => typeof a === "string" ? { address: a } : a);
-  return arr;
-}
-function resolveDefaultFrom() {
-  return {
-    name: config.email.from?.name || "Stacks",
-    address: config.email.from?.address || "no-reply@stacksjs.com"
-  };
-}
-function basename(p) {
-  const idx = Math.max(p.lastIndexOf("/"), p.lastIndexOf("\\"));
-  return idx === -1 ? p : p.slice(idx + 1);
-}
-async function materializeAttachments(atts) {
-  return Promise.all(atts.map(async (att) => {
-    if (typeof att.content === "string" && att.content.startsWith("__file__:")) {
-      const filePath = att.content.slice(9), file = Bun.file(filePath), buf = new Uint8Array(await file.arrayBuffer());
-      return {
-        ...att,
-        content: buf,
-        contentType: att.contentType || file.type || void 0,
-        encoding: "binary"
-      };
-    }
-    return att;
-  }));
-}
+import{config}from"@stacksjs/config";import{mail}from"./email";import{template as renderTemplate}from"./template";export class Mailable{_to=[];_cc=[];_bcc=[];_replyTo;_from;_subject;_text;_html;_template;_attachments=[];to(address){this._to=normalizeAddresses(address);return this}cc(address){this._cc=normalizeAddresses(address);return this}bcc(address){this._bcc=normalizeAddresses(address);return this}replyTo(address){this._replyTo=typeof address==="string"?{address}:address;return this}from(addr){this._from=addr;return this}subject(s){this._subject=s;return this}text(body){this._text=body;return this}html(body){this._html=body;return this}template(name,...rest){const props=rest[0]??{};this._template={name,props};return this}inspect(){return{to:this._to,cc:this._cc,bcc:this._bcc,from:this._from,replyTo:this._replyTo,subject:this._subject,text:this._text,html:this._html,template:this._template,attachments:this._attachments}}attach(path,name){this._attachments.push({filename:name||basename(path),content:`__file__:${path}`,encoding:"binary"});return this}attachData(buffer,name,mime){this._attachments.push({filename:name,content:buffer,contentType:mime,encoding:typeof buffer==="string"?"utf8":"binary"});return this}async send(options={}){await Promise.resolve(this.build());if(this._to.length===0)throw Error("[Mailable] no recipients \u2014 call this.to(...) inside build()");if(!this._subject)throw Error("[Mailable] no subject \u2014 call this.subject(...) inside build()");let html=this._html,text=this._text;if(this._template){const rendered=await renderTemplate(this._template.name,{variables:this._template.props,subject:this._subject});if(!html)html=rendered.html;if(!text)text=rendered.text}const message={to:this._to,subject:this._subject,from:this._from||resolveDefaultFrom(),...this._cc.length?{cc:this._cc}:{},...this._bcc.length?{bcc:this._bcc}:{},...html?{html}:{},...text?{text}:{},...this._attachments.length?{attachments:await materializeAttachments(this._attachments)}:{}};if(this._replyTo)message.replyTo=this._replyTo;return(options.driver?mail.use(options.driver):mail).send(message)}}function normalizeAddresses(input){const arr=Array.isArray(input)?input:[input];if(arr.some((a)=>typeof a==="object"&&a!==null))return arr.map((a)=>typeof a==="string"?{address:a}:a);return arr}function resolveDefaultFrom(){return{name:config.email.from?.name||"Stacks",address:config.email.from?.address||"no-reply@stacksjs.com"}}function basename(p){const idx=Math.max(p.lastIndexOf("/"),p.lastIndexOf("\\"));return idx===-1?p:p.slice(idx+1)}async function materializeAttachments(atts){return Promise.all(atts.map(async(att)=>{if(typeof att.content==="string"&&att.content.startsWith("__file__:")){const filePath=att.content.slice(9),file=Bun.file(filePath),buf=new Uint8Array(await file.arrayBuffer());return{...att,content:buf,contentType:att.contentType||file.type||void 0,encoding:"binary"}}return att}))}

package/dist/mime-preview.js

@@ -1,70 +1,5 @@
-function splitHeaders(value) {
-  const normalized = value.replace(/\r\n/g, `
-`), separator = normalized.indexOf(`
+function splitHeaders(value){const normalized=value.replace(/\r\n/g,`
+`),separator=normalized.indexOf(`
 
-`);
-  if (separator < 0)
-    return { headers: {}, body: normalized };
-  const headerLines = normalized.slice(0, separator).replace(/\n[ \t]+/g, " ").split(`
-`), headers = {};
-  for (const line of headerLines) {
-    const match = line.match(/^([^:]+):\s*(.*)$/);
-    if (match)
-      headers[match[1].toLowerCase()] = match[2] || "";
-  }
-  return { headers, body: normalized.slice(separator + 2) };
-}
-function decodeQuotedPrintable(value) {
-  const input = value.replace(/=\n/g, ""), bytes = [], encoder = new TextEncoder;
-  for (let index = 0;index < input.length; index++) {
-    const encoded = input.slice(index, index + 3);
-    if (/^=[0-9a-f]{2}$/i.test(encoded)) {
-      bytes.push(Number.parseInt(encoded.slice(1), 16));
-      index += 2;
-    } else
-      bytes.push(...encoder.encode(input[index]));
-  }
-  return new TextDecoder().decode(Uint8Array.from(bytes));
-}
-function decodeBody(body, encoding) {
-  if (encoding === "base64")
-    try {
-      return Buffer.from(body.replace(/\s+/g, ""), "base64").toString("utf8");
-    } catch {
-      return body;
-    }
-  if (encoding === "quoted-printable")
-    return decodeQuotedPrintable(body);
-  return body;
-}
-function mimeParts(value) {
-  const { headers, body } = splitHeaders(value), contentType = (headers["content-type"] || "text/plain").toLowerCase(), boundary = headers["content-type"]?.match(/boundary\s*=\s*(?:"([^"]+)"|([^;\s]+))/i)?.slice(1).find(Boolean);
-  if (contentType.startsWith("multipart/") && boundary)
-    return body.split(`--${boundary}`).slice(1).filter((part) => !part.trimStart().startsWith("--")).flatMap(mimeParts);
-  return [{
-    contentType,
-    encoding: (headers["content-transfer-encoding"] || "").toLowerCase(),
-    body
-  }];
-}
-function stripLegacyMimePreamble(value) {
-  let result = value.trim();
-  result = result.replace(/^[-=_]{2,}[^\s]*\s+/, "");
-  for (let pass = 0;pass < 6; pass++) {
-    const next = result.replace(/^content-transfer-encoding:\s*[^\s]+\s*/i, "").replace(/^mime-version:\s*[^\s]+\s*/i, "").replace(/^content-description:\s*[^\s]+\s*/i, "").replace(/^content-type:\s*[^\s;]+(?:;\s*(?:charset|boundary|name)\s*=\s*(?:"[^"]*"|[^\s]+))*\s*/i, "");
-    if (next === result)
-      break;
-    result = next;
-  }
-  return result.replace(/^[-=_]{4,}[^\s]*\s*/, "");
-}
-function plainText(value) {
-  return decodeQuotedPrintable(stripLegacyMimePreamble(value)).replace(/<style\b[\s\S]*?<\/style>/gi, " ").replace(/<script\b[\s\S]*?<\/script>/gi, " ").replace(/<[^>]+>/g, " ").replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;/gi, "'").replace(/\s+/g, " ").trim();
-}
-export function extractEmailPreview(rawEmail, maxLength = 200) {
-  const parts = mimeParts(rawEmail), selected = parts.find((part) => part.contentType.startsWith("text/plain")) || parts.find((part) => part.contentType.startsWith("text/html"));
-  return plainText(selected ? decodeBody(selected.body, selected.encoding) : rawEmail).slice(0, maxLength);
-}
-export function normalizeEmailPreview(preview, maxLength = 200) {
-  return plainText(preview).slice(0, maxLength);
-}
+`);if(separator<0)return{headers:{},body:normalized};const headerLines=normalized.slice(0,separator).replace(/\n[ \t]+/g," ").split(`
+`),headers={};for(const line of headerLines){const match=line.match(/^([^:]+):\s*(.*)$/);if(match)headers[match[1].toLowerCase()]=match[2]||""}return{headers,body:normalized.slice(separator+2)}}function decodeQuotedPrintable(value){const input=value.replace(/=\n/g,""),bytes=[],encoder=new TextEncoder;for(let index=0;index<input.length;index++){const encoded=input.slice(index,index+3);if(/^=[0-9a-f]{2}$/i.test(encoded)){bytes.push(Number.parseInt(encoded.slice(1),16));index+=2}else bytes.push(...encoder.encode(input[index]))}return new TextDecoder().decode(Uint8Array.from(bytes))}function decodeBody(body,encoding){if(encoding==="base64")try{return Buffer.from(body.replace(/\s+/g,""),"base64").toString("utf8")}catch{return body}if(encoding==="quoted-printable")return decodeQuotedPrintable(body);return body}function mimeParts(value){const{headers,body}=splitHeaders(value),contentType=(headers["content-type"]||"text/plain").toLowerCase(),boundary=headers["content-type"]?.match(/boundary\s*=\s*(?:"([^"]+)"|([^;\s]+))/i)?.slice(1).find(Boolean);if(contentType.startsWith("multipart/")&&boundary)return body.split(`--${boundary}`).slice(1).filter((part)=>!part.trimStart().startsWith("--")).flatMap(mimeParts);return[{contentType,encoding:(headers["content-transfer-encoding"]||"").toLowerCase(),body}]}function stripLegacyMimePreamble(value){let result=value.trim();result=result.replace(/^[-=_]{2,}[^\s]*\s+/,"");for(let pass=0;pass<6;pass++){const next=result.replace(/^content-transfer-encoding:\s*[^\s]+\s*/i,"").replace(/^mime-version:\s*[^\s]+\s*/i,"").replace(/^content-description:\s*[^\s]+\s*/i,"").replace(/^content-type:\s*[^\s;]+(?:;\s*(?:charset|boundary|name)\s*=\s*(?:"[^"]*"|[^\s]+))*\s*/i,"");if(next===result)break;result=next}return result.replace(/^[-=_]{4,}[^\s]*\s*/,"")}function plainText(value){return decodeQuotedPrintable(stripLegacyMimePreamble(value)).replace(/<style\b[\s\S]*?<\/style>/gi," ").replace(/<script\b[\s\S]*?<\/script>/gi," ").replace(/<[^>]+>/g," ").replace(/&nbsp;/gi," ").replace(/&amp;/gi,"&").replace(/&lt;/gi,"<").replace(/&gt;/gi,">").replace(/&quot;/gi,'"').replace(/&#39;/gi,"'").replace(/\s+/g," ").trim()}export function extractEmailPreview(rawEmail,maxLength=200){const parts=mimeParts(rawEmail),selected=parts.find((part)=>part.contentType.startsWith("text/plain"))||parts.find((part)=>part.contentType.startsWith("text/html"));return plainText(selected?decodeBody(selected.body,selected.encoding):rawEmail).slice(0,maxLength)}export function normalizeEmailPreview(preview,maxLength=200){return plainText(preview).slice(0,maxLength)}

package/dist/mime.js

@@ -1,89 +1,3 @@
-import { Buffer } from "node:buffer";
-export function encodeRfc2047IfNeeded(value) {
-  if (/^[\x00-\x7F]*$/.test(value))
-    return value;
-  return `=?UTF-8?B?${Buffer.from(value, "utf-8").toString("base64")}?=`;
-}
-export function buildMimeMessage(options) {
-  const {
-    from,
-    to,
-    cc,
-    replyTo,
-    subject,
-    text,
-    html,
-    attachments,
-    messageIdDomain,
-    customHeaders
-  } = options, lines = [], hasAttachments = !!(attachments && attachments.length > 0), boundary = `----=_Part_${Date.now()}_${Math.random().toString(36).substring(2)}`;
-  lines.push(`From: ${from}`);
-  lines.push(`To: ${to}`);
-  if (cc)
-    lines.push(`Cc: ${cc}`);
-  if (replyTo)
-    lines.push(`Reply-To: ${replyTo}`);
-  lines.push(`Subject: ${encodeRfc2047IfNeeded(subject)}`);
-  lines.push("MIME-Version: 1.0");
-  lines.push(`Date: ${new Date().toUTCString()}`);
-  lines.push(`Message-ID: <${Date.now()}.${Math.random().toString(36).substring(2)}@${messageIdDomain || "localhost"}>`);
-  if (customHeaders)
-    for (const [k, v] of Object.entries(customHeaders))
-      lines.push(`${k}: ${v}`);
-  if (hasAttachments) {
-    const mixedBoundary = boundary, altBoundary = `${boundary}_alt`;
-    lines.push(`Content-Type: multipart/mixed; boundary="${mixedBoundary}"`);
-    lines.push("");
-    lines.push(`--${mixedBoundary}`);
-    pushBodyParts(lines, { text, html, altBoundary });
-    for (const attachment of attachments) {
-      lines.push(`--${mixedBoundary}`);
-      pushAttachmentPart(lines, attachment);
-    }
-    lines.push(`--${mixedBoundary}--`);
-  } else
-    pushBodyParts(lines, { text, html, altBoundary: boundary });
-  return lines.join(`\r
-`);
-}
-function pushBodyParts(lines, options) {
-  const { text, html, altBoundary } = options;
-  if (html && text) {
-    lines.push(`Content-Type: multipart/alternative; boundary="${altBoundary}"`);
-    lines.push("");
-    lines.push(`--${altBoundary}`);
-    lines.push("Content-Type: text/plain; charset=UTF-8");
-    lines.push("Content-Transfer-Encoding: 7bit");
-    lines.push("");
-    lines.push(text);
-    lines.push("");
-    lines.push(`--${altBoundary}`);
-    lines.push("Content-Type: text/html; charset=UTF-8");
-    lines.push("Content-Transfer-Encoding: 7bit");
-    lines.push("");
-    lines.push(html);
-    lines.push("");
-    lines.push(`--${altBoundary}--`);
-  } else if (html) {
-    lines.push("Content-Type: text/html; charset=UTF-8");
-    lines.push("Content-Transfer-Encoding: 7bit");
-    lines.push("");
-    lines.push(html);
-  } else if (text) {
-    lines.push("Content-Type: text/plain; charset=UTF-8");
-    lines.push("Content-Transfer-Encoding: 7bit");
-    lines.push("");
-    lines.push(text);
-  }
-}
-function pushAttachmentPart(lines, attachment) {
-  const contentType = attachment.contentType || "application/octet-stream", safeFilename = encodeRfc2047IfNeeded(attachment.filename.replace(/\\/g, "\\\\").replace(/"/g, "\\\""));
-  lines.push(`Content-Type: ${contentType}; name="${safeFilename}"`);
-  lines.push(`Content-Disposition: attachment; filename="${safeFilename}"`);
-  lines.push("Content-Transfer-Encoding: base64");
-  lines.push("");
-  const raw = typeof attachment.content === "string" ? Buffer.from(attachment.content, "utf-8").toString("base64") : Buffer.from(attachment.content).toString("base64"), wrapped = raw.match(/.{1,76}/g)?.join(`\r
-`) ?? raw;
-  lines.push(wrapped);
-  lines.push("");
-}
+import{Buffer}from"node:buffer";export function encodeRfc2047IfNeeded(value){if(/^[\x00-\x7F]*$/.test(value))return value;return`=?UTF-8?B?${Buffer.from(value,"utf-8").toString("base64")}?=`}export function buildMimeMessage(options){const{from,to,cc,replyTo,subject,text,html,attachments,messageIdDomain,customHeaders}=options,lines=[],hasAttachments=!!(attachments&&attachments.length>0),boundary=`----=_Part_${Date.now()}_${Math.random().toString(36).substring(2)}`;lines.push(`From: ${from}`);lines.push(`To: ${to}`);if(cc)lines.push(`Cc: ${cc}`);if(replyTo)lines.push(`Reply-To: ${replyTo}`);lines.push(`Subject: ${encodeRfc2047IfNeeded(subject)}`);lines.push("MIME-Version: 1.0");lines.push(`Date: ${new Date().toUTCString()}`);lines.push(`Message-ID: <${Date.now()}.${Math.random().toString(36).substring(2)}@${messageIdDomain||"localhost"}>`);if(customHeaders)for(const[k,v]of Object.entries(customHeaders))lines.push(`${k}: ${v}`);if(hasAttachments){const mixedBoundary=boundary,altBoundary=`${boundary}_alt`;lines.push(`Content-Type: multipart/mixed; boundary="${mixedBoundary}"`);lines.push("");lines.push(`--${mixedBoundary}`);pushBodyParts(lines,{text,html,altBoundary});for(const attachment of attachments){lines.push(`--${mixedBoundary}`);pushAttachmentPart(lines,attachment)}lines.push(`--${mixedBoundary}--`)}else pushBodyParts(lines,{text,html,altBoundary:boundary});return lines.join(`\r
+`)}function pushBodyParts(lines,options){const{text,html,altBoundary}=options;if(html&&text){lines.push(`Content-Type: multipart/alternative; boundary="${altBoundary}"`);lines.push("");lines.push(`--${altBoundary}`);lines.push("Content-Type: text/plain; charset=UTF-8");lines.push("Content-Transfer-Encoding: 7bit");lines.push("");lines.push(text);lines.push("");lines.push(`--${altBoundary}`);lines.push("Content-Type: text/html; charset=UTF-8");lines.push("Content-Transfer-Encoding: 7bit");lines.push("");lines.push(html);lines.push("");lines.push(`--${altBoundary}--`)}else if(html){lines.push("Content-Type: text/html; charset=UTF-8");lines.push("Content-Transfer-Encoding: 7bit");lines.push("");lines.push(html)}else if(text){lines.push("Content-Type: text/plain; charset=UTF-8");lines.push("Content-Transfer-Encoding: 7bit");lines.push("");lines.push(text)}}function pushAttachmentPart(lines,attachment){const contentType=attachment.contentType||"application/octet-stream",safeFilename=encodeRfc2047IfNeeded(attachment.filename.replace(/\\/g,"\\\\").replace(/"/g,"\\\""));lines.push(`Content-Type: ${contentType}; name="${safeFilename}"`);lines.push(`Content-Disposition: attachment; filename="${safeFilename}"`);lines.push("Content-Transfer-Encoding: base64");lines.push("");const raw=typeof attachment.content==="string"?Buffer.from(attachment.content,"utf-8").toString("base64"):Buffer.from(attachment.content).toString("base64"),wrapped=raw.match(/.{1,76}/g)?.join(`\r
+`)??raw;lines.push(wrapped);lines.push("")}