@bobfrankston/rmfmail 1.1.208 → 1.1.209

package/packages/mailx-store/db.ts

@@ -302,6 +302,23 @@ const SCHEMA = `
         PRIMARY KEY(scope, key)
     );
 
+    -- Prefetch-failure backoff, PERSISTED (was an in-memory Map that every
+    -- daemon restart wiped — so un-fetchable "ghost" UIDs, e.g. stale Outbox
+    -- rows for already-sent messages that return 0 bodies, got re-tried in
+    -- full on every launch and re-clogged the size-asc prefetch queue,
+    -- starving healthy folders. "So much unfetched, never drains" — Bob
+    -- 2026-06-01. Persisting the count+timestamp lets the 5min→12h backoff
+    -- survive restarts so zombies stay sidelined. Pure cache-control state;
+    -- safe to lose (worst case = one extra retry), so no reconstruction needed.
+    CREATE TABLE IF NOT EXISTS prefetch_failures (
+        account_id TEXT NOT NULL,
+        folder_id INTEGER NOT NULL,
+        uid INTEGER NOT NULL,
+        count INTEGER NOT NULL,
+        last_tried INTEGER NOT NULL,
+        PRIMARY KEY(account_id, folder_id, uid)
+    );
+
     -- Audit trail of every destructive DB operation. Writes ONLY — the row
     -- inserted here records the deletion the caller is about to (or just
     -- did) commit on the messages table. Lets the user retroactively answer
@@ -2243,6 +2260,30 @@ export class MailxDB {
         ).all(accountId, ...excludeFolderIds, limit) as any[];
     }
 
+    /** Record a prefetch failure (0-body fetch / store-write fail) for a UID,
+     *  incrementing its backoff count. Persisted so it survives restarts. */
+    recordPrefetchFailure(accountId: string, folderId: number, uid: number): void {
+        this.db.prepare(
+            `INSERT INTO prefetch_failures (account_id, folder_id, uid, count, last_tried)
+             VALUES (?, ?, ?, 1, ?)
+             ON CONFLICT(account_id, folder_id, uid)
+             DO UPDATE SET count = count + 1, last_tried = excluded.last_tried`
+        ).run(accountId, folderId, uid, Date.now());
+    }
+    /** Read a UID's prefetch-failure record (count + lastTried), or null. */
+    getPrefetchFailure(accountId: string, folderId: number, uid: number): { count: number; lastTried: number } | null {
+        const r = this.db.prepare(
+            "SELECT count, last_tried AS lastTried FROM prefetch_failures WHERE account_id = ? AND folder_id = ? AND uid = ?"
+        ).get(accountId, folderId, uid) as any;
+        return r ? { count: r.count, lastTried: r.lastTried } : null;
+    }
+    /** Clear a UID's prefetch-failure record after a successful fetch. */
+    clearPrefetchFailure(accountId: string, folderId: number, uid: number): void {
+        this.db.prepare(
+            "DELETE FROM prefetch_failures WHERE account_id = ? AND folder_id = ? AND uid = ?"
+        ).run(accountId, folderId, uid);
+    }
+
     /** Highest server UID we've seen in this folder. After the
      *  message_folders refactor, this reads from the membership table
      *  rather than messages.uid — a server-side move from this folder

package/packages/mailx-store/package.json

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