@bobfrankston/rmfmail 1.0.697 → 1.0.698

package/packages/mailx-imap/index.ts

@@ -166,7 +166,7 @@ function decodeEntities(text: string): string {
 /** Extract a plain-text preview from message source */
 async function extractPreview(source: string): Promise<{ bodyHtml: string; bodyText: string; preview: string; hasAttachments: boolean }> {
     try {
-        const parsed = await parseSerial(source);
+        const parsed = await parseSerial(source, "background");
         const bodyText = parsed.text || "";
         const bodyHtml = parsed.html || "";
         // Use text part; fall back to stripping HTML tags if text is empty
@@ -1007,7 +1007,11 @@ export class ImapManager extends EventEmitter {
         source: string,
         flags: string[],
     ): Promise<void> {
-        const parsed = await parseSerial(source);
+        // insertLocalRowFromSource runs right after sendMessage — that's a
+        // user-initiated path but the parse cost is on the post-send
+        // background work, not the click-through. Tag as background so a
+        // concurrent user-click foreground parse jumps ahead.
+        const parsed = await parseSerial(source, "background");
         // Coerce mailparser AddressObject(s) into the flat `{name, address}[]`
         // shape storeMessages's downstream toEmailAddresses expects.
         // RFC 2047 encoded-word decoding (incl. inside quoted-strings) is

package/packages/mailx-imap/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bobfrankston/mailx-imap",
-  "version": "0.1.41",
+  "version": "0.1.42",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bobfrankston/mailx-imap",
-      "version": "0.1.41",
+      "version": "0.1.42",
       "license": "ISC",
       "dependencies": {
         "@bobfrankston/iflow-direct": "^0.1.27",

package/packages/mailx-imap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-imap",
-  "version": "0.1.41",
+  "version": "0.1.42",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",

package/packages/mailx-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-store",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",

package/packages/mailx-store/parse-serial.d.ts

@@ -27,7 +27,8 @@
  * pool is built.
  */
 import { type ParsedMail, type Source } from "mailparser";
-/** Serialized wrapper around `mailparser.simpleParser`. Drop-in replacement —
- *  same signature, same return value. */
-export declare function parseSerial(source: Source): Promise<ParsedMail>;
+/** Serialized wrapper around `mailparser.simpleParser`. `priority` defaults
+ *  to "foreground" — only sync/background callers should pass "background"
+ *  so user clicks aren't stuck behind a back-fill. */
+export declare function parseSerial(source: Source, priority?: "foreground" | "background"): Promise<ParsedMail>;
 //# sourceMappingURL=parse-serial.d.ts.map

package/packages/mailx-store/parse-serial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-serial.d.ts","sourceRoot":"","sources":["parse-serial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAIxE;yCACyC;AACzC,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAIrE"}
+{"version":3,"file":"parse-serial.d.ts","sourceRoot":"","sources":["parse-serial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAsCxE;;sDAEsD;AACtD,wBAAsB,WAAW,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,YAAY,GAAG,YAA2B,GACrD,OAAO,CAAC,UAAU,CAAC,CAOrB"}

package/packages/mailx-store/parse-serial.js

@@ -27,12 +27,42 @@
  * pool is built.
  */
 import { simpleParser } from "mailparser";
-let _chain = Promise.resolve();
-/** Serialized wrapper around `mailparser.simpleParser`. Drop-in replacement —
- *  same signature, same return value. */
-export async function parseSerial(source) {
-    const queued = _chain.then(() => simpleParser(source));
-    _chain = queued.catch(() => undefined);
-    return queued;
+const _head = []; // UI / foreground — drained first
+const _tail = []; // sync / background
+let _pumping = false;
+async function pump() {
+    if (_pumping)
+        return;
+    _pumping = true;
+    try {
+        for (;;) {
+            const next = _head.shift() ?? _tail.shift();
+            if (!next)
+                break;
+            try {
+                const parsed = await simpleParser(next.source);
+                next.resolve(parsed);
+            }
+            catch (e) {
+                next.reject(e);
+            }
+        }
+    }
+    finally {
+        _pumping = false;
+    }
+}
+/** Serialized wrapper around `mailparser.simpleParser`. `priority` defaults
+ *  to "foreground" — only sync/background callers should pass "background"
+ *  so user clicks aren't stuck behind a back-fill. */
+export async function parseSerial(source, priority = "foreground") {
+    return new Promise((resolve, reject) => {
+        const entry = { source, resolve, reject };
+        if (priority === "foreground")
+            _head.push(entry);
+        else
+            _tail.push(entry);
+        pump();
+    });
 }
 //# sourceMappingURL=parse-serial.js.map

package/packages/mailx-store/parse-serial.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-serial.js","sourceRoot":"","sources":["parse-serial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,YAAY,EAAgC,MAAM,YAAY,CAAC;AAExE,IAAI,MAAM,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;AAEjD;yCACyC;AACzC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC5C,MAAM,MAAM,GAAwB,MAAM,CAAC,IAAI,CAAC,GAAwB,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACjG,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAc,EAAE,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC;AAClB,CAAC"}
+{"version":3,"file":"parse-serial.js","sourceRoot":"","sources":["parse-serial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,YAAY,EAAgC,MAAM,YAAY,CAAC;AAexE,MAAM,KAAK,GAAc,EAAE,CAAC,CAAE,kCAAkC;AAChE,MAAM,KAAK,GAAc,EAAE,CAAC,CAAE,oBAAoB;AAClD,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,KAAK,UAAU,IAAI;IACf,IAAI,QAAQ;QAAE,OAAO;IACrB,QAAQ,GAAG,IAAI,CAAC;IAChB,IAAI,CAAC;QACD,SAAS,CAAC;YACN,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5C,IAAI,CAAC,IAAI;gBAAE,MAAM;YACjB,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;QACL,CAAC;IACL,CAAC;YAAS,CAAC;QACP,QAAQ,GAAG,KAAK,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;sDAEsD;AACtD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,MAAc,EACd,WAAwC,YAAY;IAEpD,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACnD,IAAI,QAAQ,KAAK,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC;IACX,CAAC,CAAC,CAAC;AACP,CAAC"}

package/packages/mailx-store/parse-serial.ts

@@ -29,12 +29,53 @@
 
 import { simpleParser, type ParsedMail, type Source } from "mailparser";
 
-let _chain: Promise<unknown> = Promise.resolve();
+/**
+ * Priority queue. A background pump runs the next pending parse; UI calls
+ * insert at the head of the line, sync calls go to the tail. Without this,
+ * a first-sync of 96 folders × thousands of messages each can queue
+ * thousands of `extractPreview` parses ahead of a single user click — the
+ * preview pane sits on "Loading body…" for minutes while the back-fill
+ * grinds through. Same parses, different order.
+ */
+type Pending = {
+    source: Source;
+    resolve: (m: ParsedMail) => void;
+    reject: (e: unknown) => void;
+};
+const _head: Pending[] = [];  // UI / foreground — drained first
+const _tail: Pending[] = [];  // sync / background
+let _pumping = false;
+
+async function pump(): Promise<void> {
+    if (_pumping) return;
+    _pumping = true;
+    try {
+        for (;;) {
+            const next = _head.shift() ?? _tail.shift();
+            if (!next) break;
+            try {
+                const parsed = await simpleParser(next.source);
+                next.resolve(parsed);
+            } catch (e) {
+                next.reject(e);
+            }
+        }
+    } finally {
+        _pumping = false;
+    }
+}
 
-/** Serialized wrapper around `mailparser.simpleParser`. Drop-in replacement —
- *  same signature, same return value. */
-export async function parseSerial(source: Source): Promise<ParsedMail> {
-    const queued: Promise<ParsedMail> = _chain.then((): Promise<ParsedMail> => simpleParser(source));
-    _chain = queued.catch((): undefined => undefined);
-    return queued;
+/** Serialized wrapper around `mailparser.simpleParser`. `priority` defaults
+ *  to "foreground" — only sync/background callers should pass "background"
+ *  so user clicks aren't stuck behind a back-fill. */
+export async function parseSerial(
+    source: Source,
+    priority: "foreground" | "background" = "foreground",
+): Promise<ParsedMail> {
+    return new Promise<ParsedMail>((resolve, reject) => {
+        const entry: Pending = { source, resolve, reject };
+        if (priority === "foreground") _head.push(entry);
+        else _tail.push(entry);
+        pump();
+    });
 }

package/packages/mailx-imap/node_modules.npmglobalize-stash-43676/.package-lock.json

@@ -1,116 +0,0 @@
-{
-  "name": "@bobfrankston/mailx-imap",
-  "version": "0.1.12",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "../../../../projects/oauth/oauthsupport": {
-      "name": "@bobfrankston/oauthsupport",
-      "version": "1.0.25",
-      "license": "MIT",
-      "devDependencies": {
-        "@types/node": "^25.2.1"
-      },
-      "engines": {
-        "node": ">=18.0.0"
-      }
-    },
-    "../../../MailApps/iflow-direct": {
-      "name": "@bobfrankston/iflow-direct",
-      "version": "0.1.27",
-      "license": "ISC",
-      "dependencies": {
-        "@bobfrankston/tcp-transport": "file:../tcp-transport"
-      },
-      "devDependencies": {
-        "@types/node": "^25.6.0"
-      }
-    },
-    "../../../MailApps/mailx-sync": {
-      "name": "@bobfrankston/mailx-sync",
-      "version": "0.1.10",
-      "license": "ISC",
-      "dependencies": {
-        "@bobfrankston/iflow-direct": "file:../iflow-direct",
-        "@bobfrankston/tcp-transport": "file:../tcp-transport"
-      },
-      "devDependencies": {
-        "@types/node": "^25.6.0"
-      }
-    },
-    "../../../MailApps/smtp-direct": {
-      "name": "@bobfrankston/smtp-direct",
-      "version": "0.1.5",
-      "license": "ISC",
-      "dependencies": {
-        "@bobfrankston/tcp-transport": "file:../tcp-transport"
-      },
-      "devDependencies": {
-        "@types/node": "^25.6.0"
-      }
-    },
-    "../../../MailApps/tcp-transport": {
-      "name": "@bobfrankston/tcp-transport",
-      "version": "0.1.5",
-      "license": "ISC",
-      "devDependencies": {
-        "@types/node": "^25.6.0"
-      }
-    },
-    "../../app/packages/mailx-settings": {
-      "name": "@bobfrankston/mailx-settings",
-      "version": "0.1.6",
-      "license": "ISC",
-      "dependencies": {
-        "@bobfrankston/mailx-types": "file:../mailx-types",
-        "jsonc-parser": "^3.3.1"
-      }
-    },
-    "../../app/packages/mailx-store": {
-      "name": "@bobfrankston/mailx-store",
-      "version": "0.1.5",
-      "license": "ISC",
-      "dependencies": {
-        "@bobfrankston/mailx-settings": "file:../mailx-settings",
-        "@bobfrankston/mailx-types": "file:../mailx-types"
-      }
-    },
-    "../../app/packages/mailx-types": {
-      "name": "@bobfrankston/mailx-types",
-      "version": "0.1.5",
-      "license": "ISC"
-    },
-    "node_modules/@bobfrankston/iflow-direct": {
-      "resolved": "../../../MailApps/iflow-direct",
-      "link": true
-    },
-    "node_modules/@bobfrankston/mailx-settings": {
-      "resolved": "../../app/packages/mailx-settings",
-      "link": true
-    },
-    "node_modules/@bobfrankston/mailx-store": {
-      "resolved": "../../app/packages/mailx-store",
-      "link": true
-    },
-    "node_modules/@bobfrankston/mailx-sync": {
-      "resolved": "../../../MailApps/mailx-sync",
-      "link": true
-    },
-    "node_modules/@bobfrankston/mailx-types": {
-      "resolved": "../../app/packages/mailx-types",
-      "link": true
-    },
-    "node_modules/@bobfrankston/oauthsupport": {
-      "resolved": "../../../../projects/oauth/oauthsupport",
-      "link": true
-    },
-    "node_modules/@bobfrankston/smtp-direct": {
-      "resolved": "../../../MailApps/smtp-direct",
-      "link": true
-    },
-    "node_modules/@bobfrankston/tcp-transport": {
-      "resolved": "../../../MailApps/tcp-transport",
-      "link": true
-    }
-  }
-}