@bobfrankston/iflow-direct 0.1.67 → 0.1.69

package/imap-compat.d.ts

@@ -65,6 +65,13 @@ export declare class CompatImapClient {
     }): Promise<FetchedMessage | null>;
     /** Get message count via STATUS (does not require SELECT) */
     getMessagesCount(mailbox: string): Promise<number>;
+    /** Mailbox size in octets + message count. STATUS=SIZE when the server has it, else a
+     *  size-only UID FETCH. See NativeImapClient.getFolderSize. (2026-09-16, Claude Code) */
+    getFolderSize(mailbox: string): Promise<{
+        messages: number;
+        bytes: number;
+        method: "status" | "fetch";
+    }>;
     /** Get all UIDs in a mailbox */
     getUids(mailbox: string): Promise<number[]>;
     /** Get UIDs whose INTERNALDATE is on/after `since`. Bounded version of

package/imap-compat.js

@@ -160,6 +160,12 @@ export class CompatImapClient {
         await this.ensureConnected();
         return this.native.getMessageCount(mailbox);
     }
+    /** Mailbox size in octets + message count. STATUS=SIZE when the server has it, else a
+     *  size-only UID FETCH. See NativeImapClient.getFolderSize. (2026-09-16, Claude Code) */
+    async getFolderSize(mailbox) {
+        await this.ensureConnected();
+        return this.native.getFolderSize(mailbox);
+    }
     /** Get all UIDs in a mailbox */
     async getUids(mailbox) {
         await this.ensureConnected();

package/imap-native.d.ts

@@ -192,7 +192,24 @@ export declare class NativeImapClient {
     /** Close the currently selected mailbox */
     closeMailbox(): Promise<void>;
     listFolders(): Promise<NativeFolder[]>;
-    getStatus(mailbox: string): Promise<proto.StatusData>;
+    getStatus(mailbox: string, items?: string[]): Promise<proto.StatusData>;
+    /**
+     * Total size of a mailbox in octets plus its message count (for imail -sizes; added
+     * 2026-09-16 by Claude Code, Fable 5.1, at Bob's direction).
+     *
+     * Fast path: RFC 8438 `STATUS (MESSAGES SIZE)` — one round trip, no message traffic —
+     * when the server advertises STATUS=SIZE (Dovecot, Gmail do).
+     * Fallback: EXAMINE (read-only) + `UID FETCH 1:* (UID RFC822.SIZE)` summed here. That
+     * is one FETCH line per message but no envelopes or headers, so it stays cheap even
+     * on a folder of tens of thousands of messages.
+     *
+     * `method` says which path produced the number so a log can show it.
+     */
+    getFolderSize(mailbox: string): Promise<{
+        messages: number;
+        bytes: number;
+        method: "status" | "fetch";
+    }>;
     createMailbox(mailbox: string): Promise<void>;
     deleteMailbox(mailbox: string): Promise<void>;
     renameMailbox(from: string, to: string): Promise<void>;

package/imap-native.js

@@ -469,9 +469,11 @@ export class NativeImapClient {
             console.error(`  [imap] ${unparsed} LIST responses could not be parsed (${responses.length} total responses)`);
         return folders;
     }
-    async getStatus(mailbox) {
+    // 2026-09-16 — Claude Code (Fable 5.1), at Bob's direction: `items` parameter added so a
+    // caller can ask for RFC 8438 SIZE. Default unchanged, so existing callers see no difference.
+    async getStatus(mailbox, items = ["MESSAGES", "UIDNEXT", "UNSEEN"]) {
         const tag = proto.nextTag();
-        const responses = await this.sendCommand(tag, proto.statusCommand(tag, mailbox, ["MESSAGES", "UIDNEXT", "UNSEEN"]));
+        const responses = await this.sendCommand(tag, proto.statusCommand(tag, mailbox, items));
         for (const r of responses) {
             if (r.tag === "*" && r.type === "STATUS") {
                 const data = proto.parseStatusResponse(r.text);
@@ -481,6 +483,46 @@ export class NativeImapClient {
         }
         return {};
     }
+    /**
+     * Total size of a mailbox in octets plus its message count (for imail -sizes; added
+     * 2026-09-16 by Claude Code, Fable 5.1, at Bob's direction).
+     *
+     * Fast path: RFC 8438 `STATUS (MESSAGES SIZE)` — one round trip, no message traffic —
+     * when the server advertises STATUS=SIZE (Dovecot, Gmail do).
+     * Fallback: EXAMINE (read-only) + `UID FETCH 1:* (UID RFC822.SIZE)` summed here. That
+     * is one FETCH line per message but no envelopes or headers, so it stays cheap even
+     * on a folder of tens of thousands of messages.
+     *
+     * `method` says which path produced the number so a log can show it.
+     */
+    async getFolderSize(mailbox) {
+        if (this.capabilities.has("STATUS=SIZE")) {
+            const st = await this.getStatus(mailbox, ["MESSAGES", "SIZE"]);
+            if (typeof st.size === "number")
+                return { messages: st.messages || 0, bytes: st.size, method: "status" };
+            // Server claimed STATUS=SIZE but answered without SIZE — fall through to counting.
+        }
+        const info = await this.examine(mailbox);
+        try {
+            if (!info.exists)
+                return { messages: 0, bytes: 0, method: "fetch" };
+            let messages = 0, bytes = 0;
+            const tag = proto.nextTag();
+            await this.sendCommand(tag, proto.fetchCommand(tag, "1:*", ["UID", "RFC822.SIZE"]), (r) => {
+                if (r.tag !== "*" || r.type !== "FETCH")
+                    return;
+                const m = r.text.match(/RFC822\.SIZE\s+(\d+)/);
+                if (!m)
+                    return;
+                messages++;
+                bytes += parseInt(m[1]);
+            });
+            return { messages, bytes, method: "fetch" };
+        }
+        finally {
+            await this.closeMailbox();
+        }
+    }
     async createMailbox(mailbox) {
         const tag = proto.nextTag();
         const responses = await this.sendCommand(tag, proto.createCommand(tag, mailbox));

package/imap-protocol.d.ts

@@ -58,6 +58,9 @@ export interface StatusData {
     uidNext?: number;
     uidValidity?: number;
     unseen?: number;
+    /** Total mailbox size in octets — RFC 8438 `STATUS (SIZE)`, only when the
+     *  server advertises STATUS=SIZE and the caller asked for it. */
+    size?: number;
 }
 /** Generate a unique command tag */
 export declare function nextTag(): string;

package/imap-protocol.js

@@ -239,6 +239,9 @@ export function parseStatusResponse(text) {
             data.uidValidity = val;
         else if (key === "UNSEEN")
             data.unseen = val;
+        // 2026-09-16 — Claude Code (Fable 5.1), at Bob's direction: RFC 8438 SIZE, for imail -sizes.
+        else if (key === "SIZE")
+            data.size = val;
     }
     return data;
 }
@@ -267,6 +270,8 @@ export function parseStatusResponseFull(text) {
             data.uidValidity = val;
         else if (key === "UNSEEN")
             data.unseen = val;
+        else if (key === "SIZE")
+            data.size = val; // RFC 8438 (2026-09-16)
     }
     return { mailbox, data };
 }

package/package.json

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