@kubun/connector-google-mail 0.17.0 → 0.17.1

package/lib/provider.d.ts

@@ -3,6 +3,7 @@ import type { Credential } from '@kubun/credential-types';
 export declare const DEFAULT_QUERY = "in:inbox";
 export type MailCheckpoint = {
     historyId: string;
+    windowStart?: number;
 };
 export type GoogleMailProviderConfig = {
     credential: Credential;

package/lib/provider.js

@@ -17,12 +17,22 @@ async function fetchJSON(url, credential, fetchFn, signal) {
     }
     return await response.json();
 }
-function applyMaxAge(query, boundary) {
-    if (boundary?.maxAge == null) return query;
+/**
+ * The absolute lower bound (epoch seconds) for a full message listing: a window
+ * already frozen in the checkpoint, else `now − maxAge` computed once. Null when
+ * the boundary carries no `maxAge` (no floor).
+ */ function windowStartSeconds(boundary, frozen) {
+    if (frozen != null) return frozen;
+    if (boundary?.maxAge == null) return null;
     const match = /^P(\d+)D$/i.exec(boundary.maxAge);
-    if (match == null) return query;
+    if (match?.[1] == null) return null;
+    const days = Number.parseInt(match[1], 10);
+    return Math.floor((Date.now() - days * 86_400_000) / 1000);
+}
+/** Appends an absolute `after:<epoch seconds>` floor to a Gmail search query. */ function applyAfter(query, windowStart) {
+    if (windowStart == null) return query;
     if (/\b(newer_than:|after:)/i.test(query)) return query;
-    return `${query} newer_than:${match[1]}d`;
+    return `${query} after:${windowStart}`;
 }
 function maxHistoryId(messages) {
     let max = -1;
@@ -69,7 +79,11 @@ export function createGoogleMailProvider(config) {
     }
     async function* fetchAllEntities(params) {
         yield await labelBatch(params.signal);
-        const query = applyMaxAge(config.query ?? DEFAULT_QUERY, params.boundary);
+        // Reuse a window frozen by a prior sync (carried in a checkpoint on the 404
+        // resync path, or a re-driven initial); only a genuine first sync computes it.
+        const prior = params.checkpoint;
+        const windowStart = windowStartSeconds(params.boundary, prior?.windowStart);
+        const query = applyAfter(config.query ?? DEFAULT_QUERY, windowStart);
         const ids = await listMessageIDs(query, params.signal);
         const messages = [];
         for (const { id } of ids){
@@ -90,7 +104,10 @@ export function createGoogleMailProvider(config) {
             hasMore: true
         };
         const checkpoint = {
-            historyId: maxHistoryId(messages) ?? await profileHistoryId(params.signal)
+            historyId: maxHistoryId(messages) ?? await profileHistoryId(params.signal),
+            ...windowStart != null ? {
+                windowStart
+            } : {}
         };
         yield {
             modelID: MESSAGE_MODEL_ID,
@@ -176,7 +193,10 @@ export function createGoogleMailProvider(config) {
                 })),
             hasMore: false,
             checkpoint: {
-                historyId: latestHistoryId
+                historyId: latestHistoryId,
+                ...checkpoint.windowStart != null ? {
+                    windowStart: checkpoint.windowStart
+                } : {}
             }
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/connector-google-mail",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "keywords": [],
   "license": "see LICENSE.md",
   "sideEffects": false,
@@ -15,7 +15,7 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@kubun/connector": "^0.17.0",
+    "@kubun/connector": "^0.17.1",
     "@kubun/credential-types": "^0.17.0",
     "@kubun/models": "^0.17.0",
     "@kubun/protocol": "^0.17.0",