@bobfrankston/iflow-direct 0.1.69 → 0.1.71

package/imap-compat.d.ts

@@ -105,6 +105,9 @@ export declare class CompatImapClient {
     searchByHeader(mailbox: string, headerName: string, headerValue: string): Promise<number[]>;
     /** Delete a message by UID */
     deleteMessageByUid(mailbox: string, uid: number): Promise<void>;
+    /** Delete many messages by UID in one mailbox — chunked STORE + one
+     *  EXPUNGE (see ImapNative.deleteMessages). 2026-09-16 Claude Code. */
+    deleteMessagesByUid(mailbox: string, uids: number[]): Promise<void>;
     /** Move a message between mailboxes (same server) */
     moveMessage(msg: any, fromMailbox: string, toMailbox: string): Promise<void>;
     /** Add flags to a message */

package/imap-compat.js

@@ -239,6 +239,20 @@ export class CompatImapClient {
         await this.native.deleteMessage(uid);
         await this.native.closeMailbox();
     }
+    /** Delete many messages by UID in one mailbox — chunked STORE + one
+     *  EXPUNGE (see ImapNative.deleteMessages). 2026-09-16 Claude Code. */
+    async deleteMessagesByUid(mailbox, uids) {
+        if (!uids.length)
+            return;
+        await this.ensureConnected();
+        await this.native.select(mailbox);
+        try {
+            await this.native.deleteMessages(uids);
+        }
+        finally {
+            await this.native.closeMailbox();
+        }
+    }
     /** Move a message between mailboxes (same server) */
     async moveMessage(msg, fromMailbox, toMailbox) {
         await this.ensureConnected();

package/imap-native.d.ts

@@ -273,6 +273,14 @@ export declare class NativeImapClient {
     moveMessage(uid: number, destination: string): Promise<void>;
     /** Delete a message by UID (flag + expunge) */
     deleteMessage(uid: number): Promise<void>;
+    /** Delete many messages in the selected mailbox: one `UID STORE <set>
+     *  +FLAGS.SILENT (\Deleted)` per chunk, then a single EXPUNGE.
+     *  2026-09-16 — Claude Code (Fable 5.1), at Bob's direction. Emptying
+     *  Trash looped deleteMessage() per UID — a STORE and an EXPUNGE round
+     *  trip for every message — so a large Trash took minutes and the
+     *  caller's IPC timed out ("mailxapi timeout: emptyFolder"). Chunked so a
+     *  ten-thousand-UID set never produces a command line the server rejects. */
+    deleteMessages(uids: number[], chunkSize?: number): Promise<void>;
     /** Expunge deleted messages */
     expunge(): Promise<void>;
     /** Append a message to a mailbox */

package/imap-native.js

@@ -828,6 +828,26 @@ export class NativeImapClient {
         await this.addFlags(uid, ["\\Deleted"]);
         await this.expunge();
     }
+    /** Delete many messages in the selected mailbox: one `UID STORE <set>
+     *  +FLAGS.SILENT (\Deleted)` per chunk, then a single EXPUNGE.
+     *  2026-09-16 — Claude Code (Fable 5.1), at Bob's direction. Emptying
+     *  Trash looped deleteMessage() per UID — a STORE and an EXPUNGE round
+     *  trip for every message — so a large Trash took minutes and the
+     *  caller's IPC timed out ("mailxapi timeout: emptyFolder"). Chunked so a
+     *  ten-thousand-UID set never produces a command line the server rejects. */
+    async deleteMessages(uids, chunkSize = 1000) {
+        if (!uids.length)
+            return;
+        for (let i = 0; i < uids.length; i += chunkSize) {
+            const set = proto.uidSequenceSet(uids.slice(i, i + chunkSize));
+            const tag = proto.nextTag();
+            const responses = await this.sendCommand(tag, proto.storeCommand(tag, set, "+FLAGS.SILENT", ["\\Deleted"]));
+            const tagged = responses.find(r => r.tag === tag);
+            if (!tagged || tagged.type !== "OK")
+                throw new Error(`STORE +FLAGS \\Deleted (${uids.length} uids) failed: ${tagged?.text || "unknown"}`);
+        }
+        await this.expunge();
+    }
     /** Expunge deleted messages */
     async expunge() {
         const tag = proto.nextTag();

package/imap-protocol.d.ts

@@ -107,7 +107,12 @@ export declare function seqFetchCommand(tag: string, range: string, items: strin
 /** Build UID SEARCH command */
 export declare function searchCommand(tag: string, criteria: string): string;
 /** Build UID STORE command (set/add/remove flags) */
-export declare function storeCommand(tag: string, uid: number, action: string, flags: string[]): string;
+/** `uid` may be a single UID or an RFC 3501 sequence set ("1:500,502") —
+ *  2026-09-16 Claude Code (Fable 5.1): needed so one STORE can flag a whole
+ *  folder for deletion instead of one round trip per message. */
+export declare function storeCommand(tag: string, uid: number | string, action: string, flags: string[]): string;
+/** Compress sorted UIDs into an RFC 3501 sequence set: [1,2,3,7,9,10] → "1:3,7,9:10". */
+export declare function uidSequenceSet(uids: number[]): string;
 /** Build UID COPY command */
 export declare function copyCommand(tag: string, uid: number, destination: string): string;
 /** Build UID MOVE command */

package/imap-protocol.js

@@ -110,9 +110,25 @@ export function searchCommand(tag, criteria) {
     return buildCommand(tag, `UID SEARCH ${criteria}`);
 }
 /** Build UID STORE command (set/add/remove flags) */
+/** `uid` may be a single UID or an RFC 3501 sequence set ("1:500,502") —
+ *  2026-09-16 Claude Code (Fable 5.1): needed so one STORE can flag a whole
+ *  folder for deletion instead of one round trip per message. */
 export function storeCommand(tag, uid, action, flags) {
     return buildCommand(tag, `UID STORE ${uid} ${action} (${flags.join(" ")})`);
 }
+/** Compress sorted UIDs into an RFC 3501 sequence set: [1,2,3,7,9,10] → "1:3,7,9:10". */
+export function uidSequenceSet(uids) {
+    const sorted = Array.from(new Set(uids)).sort((a, b) => a - b);
+    const parts = [];
+    for (let i = 0; i < sorted.length;) {
+        let j = i;
+        while (j + 1 < sorted.length && sorted[j + 1] === sorted[j] + 1)
+            j++;
+        parts.push(j > i ? `${sorted[i]}:${sorted[j]}` : String(sorted[i]));
+        i = j + 1;
+    }
+    return parts.join(",");
+}
 /** Build UID COPY command */
 export function copyCommand(tag, uid, destination) {
     return buildCommand(tag, `UID COPY ${uid} ${quoteMailbox(destination)}`);

package/package.json

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