@bobfrankston/mailx-sync 0.1.23 → 0.1.25

package/gmail.js

@@ -322,7 +322,18 @@ export class GmailApiProvider {
         // is self-limiting. Otherwise cap at the recent 200.
         const cap = options.since ? 0 : 200;
         const ids = await this.listMessageIds(query, cap);
-        return this.batchFetch(ids, options);
+        // Skip IDs already in the local store: the listing above is one cheap
+        // call, but fetching each message's metadata is a sequential per-ID GET
+        // (~200ms). Without this, a routine sync re-fetched all ~200 recent
+        // messages every time (~40s) just to discover nothing was new. With the
+        // caller's known-UID set, steady state fetches zero (Bob 2026-06-27).
+        const fresh = options.knownUids
+            ? ids.filter(id => !options.knownUids.has(idToUid(id)))
+            : ids;
+        if (options.knownUids) {
+            console.log(`[gmail] fetchSince ${folder}: ${ids.length} listed, ${ids.length - fresh.length} already stored, fetching ${fresh.length}`);
+        }
+        return this.batchFetch(fresh, options);
     }
     async fetchByDate(folder, since, before, options = {}, onChunk) {
         const afterDate = this.formatDate(since);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-sync",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "Platform-agnostic mail provider implementations + sync orchestration. Single source of truth for Gmail/IMAP/Outlook protocol code, consumed by both desktop (Node) and Android (WebView) — eliminates the parallel mailx-imap/mailx-store-web Gmail providers that drifted in practice.",
   "main": "index.js",
   "types": "index.ts",

package/types.d.ts

@@ -47,6 +47,14 @@ export interface FetchOptions {
      *  the default page-count cap doesn't silently truncate a large folder
      *  to the last ~200 messages. */
     since?: Date;
+    /** UIDs already present in the local store for this folder. Providers whose
+     *  incremental sync re-lists a fixed recent page (Gmail — IDs aren't
+     *  monotonic, so it can't use a high-water mark) use this to SKIP fetching
+     *  metadata for messages already stored: list IDs (one cheap call), drop the
+     *  known ones, fetch only the genuinely-new. Steady state (nothing new) then
+     *  costs one list call and zero per-message GETs instead of re-fetching 200
+     *  one-by-one (~40s on mobile → near-instant) (Bob 2026-06-27). */
+    knownUids?: Set<number>;
 }
 /**
  * A mail provider that can list folders, fetch messages, and perform actions.