@bobfrankston/iflow-direct 0.1.11 → 0.1.12

package/imap-compat.d.ts

@@ -49,10 +49,20 @@ export declare class CompatImapClient {
     getMessagesCount(mailbox: string): Promise<number>;
     /** Get all UIDs in a mailbox */
     getUids(mailbox: string): Promise<number[]>;
-    /** Fetch messages by UID range string (e.g. "100,200,300" or "100:200") */
+    /** Fetch messages — supports two calling conventions for compatibility:
+     *
+     *    New:  fetchMessages(mailbox, "100:200")           — UID range string
+     *    Old:  fetchMessages(mailbox, endSeq, count)       — sequence-number range (iflow compat)
+     *
+     *  The old form computes UID range "start:end" from (end - count + 1) : end,
+     *  matching the legacy iflow/imapflow fetchMessages(mailbox, end, count) API
+     *  used by the puller. */
     fetchMessages(mailbox: string, uidRange: string, options?: {
         source?: boolean;
     }): Promise<any[]>;
+    fetchMessages(mailbox: string, end: number, count: number, options?: {
+        source?: boolean;
+    }): Promise<any[]>;
     /** Search messages in a mailbox */
     searchMessages(mailbox: string, criteria: any): Promise<number[]>;
     /** Search by header value — returns matching UIDs */

package/imap-compat.js

@@ -160,11 +160,25 @@ export class CompatImapClient {
         await this.native.closeMailbox();
         return uids;
     }
-    /** Fetch messages by UID range string (e.g. "100,200,300" or "100:200") */
-    async fetchMessages(mailbox, uidRange, options) {
+    async fetchMessages(mailbox, rangeOrEnd, countOrOptions, maybeOptions) {
+        let range;
+        let options;
+        if (typeof rangeOrEnd === "number") {
+            // Legacy (iflow) calling convention: (mailbox, endSeq, count, options?)
+            const end = rangeOrEnd;
+            const count = typeof countOrOptions === "number" ? countOrOptions : 1;
+            const start = Math.max(1, end - count + 1);
+            range = `${start}:${end}`;
+            options = maybeOptions;
+        }
+        else {
+            // New calling convention: (mailbox, uidRange, options?)
+            range = rangeOrEnd;
+            options = typeof countOrOptions === "object" ? countOrOptions : undefined;
+        }
         await this.ensureConnected();
         await this.native.select(mailbox);
-        const msgs = await this.native.fetchMessages(uidRange, options);
+        const msgs = await this.native.fetchMessages(range, options);
         await this.native.closeMailbox();
         return msgs.map(toCompatMessage);
     }

package/package.json

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