@bobfrankston/mailx-imap 0.1.43 → 0.1.44

package/index.d.ts

@@ -67,6 +67,11 @@ export declare class ImapManager extends EventEmitter {
     private accountErrorShown;
     private syncing;
     private inboxSyncing;
+    /** Wall-clock of ImapManager construction. Used by the lazy-folder-sync
+     *  gate so non-priority folders defer their first-sync until ~3 min
+     *  past startup, when the event loop has quieted down. Each restart
+     *  resets this; the gate auto-lifts as time passes. */
+    private _startupAt;
     /** Use native IMAP client instead of imapflow. Set to true to enable. */
     useNativeClient: boolean;
     /** Per-account health counters. Incremented when the server misbehaves

package/index.js

@@ -142,6 +142,11 @@ export class ImapManager extends EventEmitter {
     accountErrorShown = new Set();
     syncing = false;
     inboxSyncing = false;
+    /** Wall-clock of ImapManager construction. Used by the lazy-folder-sync
+     *  gate so non-priority folders defer their first-sync until ~3 min
+     *  past startup, when the event loop has quieted down. Each restart
+     *  resets this; the gate auto-lifts as time passes. */
+    _startupAt = Date.now();
     /** Use native IMAP client instead of imapflow. Set to true to enable. */
     useNativeClient = false;
     // Connection management: see withConnection() below.
@@ -1716,12 +1721,37 @@ export class ImapManager extends EventEmitter {
             // timeout abandons a stalled command instead of waiting out
             // Dovecot's 300s server-side inactivity timer; the next sync tick
             // retries on a fresh socket.
-            const remaining = folders.filter(f => f.specialUse !== "inbox");
+            // 2026-05-13: defer first-sync of non-priority folders by default
+            // (C119 lazy folder sync). On bobma with 90+ folders, doing a
+            // first-sync of every folder on every startup hammers the IMAP
+            // socket buffer and pegs the daemon's event loop processing
+            // FETCH literals — user clicks get a 20+ second IPC delay
+            // because no IPC can squeeze in between FETCH chunks. Now: only
+            // special-use folders (Sent/Drafts/Archive/Junk/Trash) + folders
+            // mailx has previously seen (highestUid > 0, i.e. tracked
+            // across the prior session) sync automatically. First-sync of
+            // a "never-touched" non-special folder is deferred until the
+            // user opens that folder (on-demand syncFolder call) or until
+            // ~3 minutes after startup when the event loop is quiet.
+            const STARTUP_LAZY_DELAY_MS = 3 * 60 * 1000;
+            const startupQuietPoint = (this._startupAt || 0) + STARTUP_LAZY_DELAY_MS;
+            const isLazyEligible = (f) => {
+                if (f.specialUse && priorityOrder.includes(f.specialUse))
+                    return false;
+                if (this.db.getHighestUid(accountId, f.id) > 0)
+                    return false;
+                return true;
+            };
+            const remaining = folders.filter(f => f.specialUse !== "inbox" && !(isLazyEligible(f) && Date.now() < startupQuietPoint));
             remaining.sort((a, b) => {
                 const pa = priorityOrder.indexOf(a.specialUse || "") >= 0 ? priorityOrder.indexOf(a.specialUse || "") : 5;
                 const pb = priorityOrder.indexOf(b.specialUse || "") >= 0 ? priorityOrder.indexOf(b.specialUse || "") : 5;
                 return pa - pb;
             });
+            const deferredCount = folders.filter(f => f.specialUse !== "inbox" && isLazyEligible(f) && Date.now() < startupQuietPoint).length;
+            if (deferredCount > 0) {
+                console.log(`  [sync] ${accountId}: deferring first-sync of ${deferredCount} non-priority folder(s) until ${new Date(startupQuietPoint).toLocaleTimeString()} or user opens them`);
+            }
             const CONCURRENCY = 2;
             // First-sync of a fresh account on a cold Dovecot is dominated by
             // `UID SEARCH SINCE 30-days-ago`, which can take 5+ minutes on a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-imap",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",
@@ -11,7 +11,7 @@
   "dependencies": {
     "@bobfrankston/mailx-types": "^0.1.11",
     "@bobfrankston/mailx-settings": "^0.1.16",
-    "@bobfrankston/mailx-store": "^0.1.23",
+    "@bobfrankston/mailx-store": "^0.1.24",
     "@bobfrankston/iflow-direct": "^0.1.44",
     "@bobfrankston/tcp-transport": "^0.1.6",
     "@bobfrankston/smtp-direct": "^0.1.8",
@@ -39,7 +39,7 @@
     "dependencies": {
       "@bobfrankston/mailx-types": "^0.1.11",
       "@bobfrankston/mailx-settings": "^0.1.16",
-      "@bobfrankston/mailx-store": "^0.1.23",
+      "@bobfrankston/mailx-store": "^0.1.24",
       "@bobfrankston/iflow-direct": "^0.1.44",
       "@bobfrankston/tcp-transport": "^0.1.6",
       "@bobfrankston/smtp-direct": "^0.1.8",