@bobfrankston/iflow-direct 0.1.43 → 0.1.44

package/fetched-message.d.ts

@@ -35,6 +35,7 @@ export declare class FetchedMessage implements NativeFetchedMessage {
     flagged: boolean;
     answered: boolean;
     draft: boolean;
+    modSeq?: number;
     parsedHeader: string[][];
     headerSet: HeaderMap;
     constructor(init: NativeFetchedMessage);

package/fetched-message.js

@@ -40,6 +40,7 @@ export class FetchedMessage {
     flagged;
     answered;
     draft;
+    modSeq;
     // Parsed-header state
     parsedHeader;
     headerSet;

package/imap-compat.d.ts

@@ -106,6 +106,16 @@ export declare class CompatImapClient {
     /** Cached CAPABILITY set parsed at connect/login. Callers gate
      *  optional features (NOTIFY, QRESYNC, MOVE, ...) on this. */
     getCapabilities(): Set<string>;
+    /** Snapshot of the most recently SELECTed mailbox's info. Callers use this
+     *  to read `highestModSeq` after any operation that did a SELECT — useful
+     *  for seeding the QRESYNC modSeq watermark on the very first sync of a
+     *  folder (before the QRESYNC path is eligible). */
+    getCurrentMailboxInfo(): {
+        uidValidity: number;
+        uidNext: number;
+        exists: number;
+        highestModSeq?: number;
+    };
     /** RFC 5161 ENABLE — activates an IMAP extension for the remainder of
      *  the session. QRESYNC must be enabled before any SELECT for
      *  `* VANISHED` responses + automatic `MODSEQ` to start flowing.

package/imap-compat.js

@@ -279,6 +279,14 @@ export class CompatImapClient {
     getCapabilities() {
         return this.native.getCapabilities();
     }
+    /** Snapshot of the most recently SELECTed mailbox's info. Callers use this
+     *  to read `highestModSeq` after any operation that did a SELECT — useful
+     *  for seeding the QRESYNC modSeq watermark on the very first sync of a
+     *  folder (before the QRESYNC path is eligible). */
+    getCurrentMailboxInfo() {
+        const info = this.native.getMailboxInfo?.();
+        return info || { uidValidity: 0, uidNext: 0, exists: 0 };
+    }
     /** RFC 5161 ENABLE — activates an IMAP extension for the remainder of
      *  the session. QRESYNC must be enabled before any SELECT for
      *  `* VANISHED` responses + automatic `MODSEQ` to start flowing.
@@ -319,12 +327,7 @@ export class CompatImapClient {
     async resyncFolder(mailbox, uidValidity, modSeq) {
         await this.ensureConnected();
         const result = await this.native.select(mailbox, { uidValidity, modSeq });
-        // Untagged FETCH responses emitted during a QRESYNC SELECT are
-        // pre-parsed by the native layer into NativeFetchedMessage objects;
-        // expose them as FetchedMessage to compat callers. (The native
-        // select() doesn't currently surface these — that wiring is in
-        // imap-native.ts:select via the FETCH-during-select case.)
-        const changedMessages = result.changedMessages?.map((m) => new FetchedMessage(m)) || [];
+        const changedMessages = result.changedMessages.map(m => new FetchedMessage(m));
         return {
             uidValidityChanged: result.uidValidityChanged,
             vanishedUids: result.vanishedUids,

package/imap-native.d.ts

@@ -67,10 +67,15 @@ export interface QresyncParams {
     knownUids?: string;
 }
 /** Result of a QRESYNC-enabled SELECT. The caller drains `vanishedUids`
- *  (delete from local store), processes any FETCH responses (upsert state
+ *  (delete from local store), processes `changedMessages` (upsert state
  *  changes), and saves the new `highestModSeq` for the next resync. */
 export interface SelectResult extends MailboxInfo {
     vanishedUids: number[];
+    /** Untagged `* FETCH` responses the server emitted during the QRESYNC
+     *  SELECT — typically flag/MODSEQ changes for messages whose state
+     *  shifted between the caller's previous modSeq and now. Empty for
+     *  non-QRESYNC SELECTs. */
+    changedMessages: NativeFetchedMessage[];
     /** True if the server's UIDVALIDITY changed since the caller's last
      *  visit — in that case knownUids/modSeq are invalid and the caller
      *  must full-resync from scratch. */
@@ -146,6 +151,15 @@ export declare class NativeImapClient {
      *  without re-issuing CAPABILITY. Returns a defensive copy so callers
      *  can't mutate internal state. */
     getCapabilities(): Set<string>;
+    /** Snapshot of the currently-SELECTed mailbox's info. Lets the compat
+     *  client read `highestModSeq` etc. after any select-implying operation
+     *  (fetchMessagesSinceUid, etc.) without re-issuing SELECT. */
+    getMailboxInfo(): {
+        uidValidity: number;
+        uidNext: number;
+        exists: number;
+        highestModSeq?: number;
+    };
     private parseCapabilities;
     logout(): Promise<void>;
     /** SELECT a mailbox. Optional QRESYNC params trigger RFC 7162 fast resync —

package/imap-native.js

@@ -236,6 +236,17 @@ export class NativeImapClient {
     getCapabilities() {
         return new Set(this.capabilities);
     }
+    /** Snapshot of the currently-SELECTed mailbox's info. Lets the compat
+     *  client read `highestModSeq` etc. after any select-implying operation
+     *  (fetchMessagesSinceUid, etc.) without re-issuing SELECT. */
+    getMailboxInfo() {
+        return {
+            uidValidity: this.mailboxInfo.uidValidity,
+            uidNext: this.mailboxInfo.uidNext,
+            exists: this.mailboxInfo.exists,
+            highestModSeq: this.mailboxInfo.highestModSeq,
+        };
+    }
     parseCapabilities(text) {
         const caps = text.replace(/^CAPABILITY\s*/i, "").split(/\s+/);
         this.capabilities.clear();
@@ -271,6 +282,10 @@ export class NativeImapClient {
         this.mailboxInfo.highestModSeq = undefined;
         const vanishedUids = [];
         const priorUidValidity = qresync?.uidValidity;
+        // Untagged FETCH responses emitted during a QRESYNC SELECT carry
+        // state-change deltas the server is volunteering up-front; parse
+        // them through the same path as normal FETCH so the shape matches.
+        const fetchResponses = responses.filter(r => r.tag === "*" && r.type === "FETCH");
         for (const r of responses) {
             if (r.tag !== "*")
                 continue;
@@ -311,9 +326,13 @@ export class NativeImapClient {
         this.selectedMailbox = mailbox;
         const uidValidityChanged = priorUidValidity !== undefined
             && this.mailboxInfo.uidValidity !== priorUidValidity;
+        const changedMessages = fetchResponses.length > 0
+            ? this.parseFetchResponses(fetchResponses)
+            : [];
         return {
             ...this.mailboxInfo,
             vanishedUids,
+            changedMessages,
             uidValidityChanged,
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/iflow-direct",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "description": "Direct IMAP client — transport-agnostic, no Node.js dependencies, browser-ready",
   "main": "index.js",
   "types": "index.ts",