@stacksjs/email 0.70.229 → 0.70.230

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from './webhook-events';
 export * from './webhook-handlers';
 export * from './webhook-signatures';
 export * from './mailable';
+export * from './mime-preview';
 export * from './sdk/index';
 export * from './template';
 export * from './types';

package/dist/index.js

@@ -8,6 +8,7 @@ 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";

package/dist/mime-preview.d.ts

@@ -0,0 +1,2 @@
+export declare function extractEmailPreview(rawEmail: string, maxLength?: number): string;
+export declare function normalizeEmailPreview(preview: string, maxLength?: number): string;

package/dist/mime-preview.js

@@ -0,0 +1,70 @@
+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);
+}

package/dist/sdk/index.js

@@ -144,39 +144,34 @@ export class EmailSDK {
     return results.slice(offset, offset + limit);
   }
   async delete(mailbox, messageId) {
-    try {
-      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"))
-            console.debug(`[email-sdk] Failed to delete ${key}: ${getErrorMessage(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;
-    } catch (error) {
-      console.debug(`[email-sdk] Failed to delete email ${messageId}: ${getErrorMessage(error)}`);
+    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 });
@@ -185,22 +180,17 @@ export class EmailSDK {
     return this.updateEmailStatus(mailbox, messageId, { read: !1 });
   }
   async updateEmailStatus(mailbox, messageId, updates) {
-    try {
-      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;
-    } catch (error) {
-      console.debug(`[email-sdk] Failed to update email status for ${messageId}: ${getErrorMessage(error)}`);
+    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") {

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/email",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.229",
+  "version": "0.70.230",
   "description": "The Stacks Email integration. Painlessly create & manage your inboxes, templates, and send emails.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,10 +58,10 @@
     "@stacksjs/ts-cloud": "^0.7.92"
   },
   "devDependencies": {
-    "@stacksjs/cli": "0.70.229",
-    "@stacksjs/config": "0.70.229",
+    "@stacksjs/cli": "0.70.230",
+    "@stacksjs/config": "0.70.230",
     "better-dx": "^0.2.17",
-    "@stacksjs/error-handling": "0.70.229",
-    "@stacksjs/types": "0.70.229"
+    "@stacksjs/error-handling": "0.70.230",
+    "@stacksjs/types": "0.70.230"
   }
 }