@bobfrankston/mailx-store 0.1.54 → 0.1.55

package/db.d.ts

@@ -435,6 +435,20 @@ export declare class MailxDB {
      *  here but NOT on the server gets its membership dropped (which
      *  may then GC the messages row if it has no other folders). */
     getUidsForFolder(_accountId: string, folderId: number): number[];
+    /** UIDs we actually have a stored MESSAGE ROW for in this folder — from the
+     *  `messages` table, NOT `message_folders`. The two can diverge: an "orphan
+     *  membership" (a message_folders row whose messages row was never written /
+     *  got deleted) makes getUidsForFolder report a UID we don't truly have.
+     *  The set-diff backfill must diff against THIS so it re-fetches the real
+     *  message data for orphans instead of treating them as present (Bob
+     *  2026-06-20: ~1k old INBOX messages stuck missing — membership said
+     *  "have it", the row didn't exist). */
+    getStoredUids(accountId: string, folderId: number): number[];
+    /** Count of stored MESSAGE ROWS in a folder (messages table). The deficit
+     *  gate compares this to the server's count to decide whether to reconcile;
+     *  using the messages table (not message_folders) means orphan memberships
+     *  don't mask a real "rows are missing" deficit. */
+    getStoredCount(accountId: string, folderId: number): number;
     /** List recent rows in a folder for a Sent-sweep / reconciliation pass.
      *  Returns only the columns the sweeper needs (uid, message_id, date,
      *  subject, size, has_attachments, preview, body_path) for every row in

package/db.js

@@ -2394,6 +2394,26 @@ export class MailxDB {
         const rows = this.db.prepare("SELECT uid FROM message_folders WHERE folder_id = ?").all(folderId);
         return rows.map(r => r.uid);
     }
+    /** UIDs we actually have a stored MESSAGE ROW for in this folder — from the
+     *  `messages` table, NOT `message_folders`. The two can diverge: an "orphan
+     *  membership" (a message_folders row whose messages row was never written /
+     *  got deleted) makes getUidsForFolder report a UID we don't truly have.
+     *  The set-diff backfill must diff against THIS so it re-fetches the real
+     *  message data for orphans instead of treating them as present (Bob
+     *  2026-06-20: ~1k old INBOX messages stuck missing — membership said
+     *  "have it", the row didn't exist). */
+    getStoredUids(accountId, folderId) {
+        const rows = this.db.prepare("SELECT uid FROM messages WHERE account_id = ? AND folder_id = ?").all(accountId, folderId);
+        return rows.map(r => r.uid);
+    }
+    /** Count of stored MESSAGE ROWS in a folder (messages table). The deficit
+     *  gate compares this to the server's count to decide whether to reconcile;
+     *  using the messages table (not message_folders) means orphan memberships
+     *  don't mask a real "rows are missing" deficit. */
+    getStoredCount(accountId, folderId) {
+        const r = this.db.prepare("SELECT count(*) as cnt FROM messages WHERE account_id = ? AND folder_id = ?").get(accountId, folderId);
+        return r?.cnt || 0;
+    }
     /** List recent rows in a folder for a Sent-sweep / reconciliation pass.
      *  Returns only the columns the sweeper needs (uid, message_id, date,
      *  subject, size, has_attachments, preview, body_path) for every row in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-store",
-  "version": "0.1.54",
+  "version": "0.1.55",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",
@@ -10,7 +10,7 @@
   "license": "ISC",
   "dependencies": {
     "@bobfrankston/mailx-types": "^0.1.19",
-    "@bobfrankston/mailx-settings": "^0.1.28",
+    "@bobfrankston/mailx-settings": "^0.1.30",
     "@bobfrankston/mailx-bus": "^0.1.2",
     "mailparser": "^3.7.2"
   },
@@ -30,7 +30,7 @@
   ".transformedSnapshot": {
     "dependencies": {
       "@bobfrankston/mailx-types": "^0.1.19",
-      "@bobfrankston/mailx-settings": "^0.1.28",
+      "@bobfrankston/mailx-settings": "^0.1.30",
       "@bobfrankston/mailx-bus": "^0.1.2",
       "mailparser": "^3.7.2"
     }