@bobfrankston/iflow 1.0.2

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(find:*)",
+      "Bash(git init:*)",
+      "WebFetch(domain:imapflow.com)"
+    ],
+    "deny": []
+  }
+}

package/imaplib/ImapClient.d.ts

@@ -0,0 +1,35 @@
+import imapflow from 'imapflow';
+import { ImapClientConfig, FetchedMessage } from './types.js';
+export interface iFetchOptions {
+    source: boolean;
+}
+export declare class ImapClient {
+    private client;
+    private config;
+    private isDestroying;
+    private connectionPromise;
+    constructor(cfg: ImapClientConfig);
+    private init;
+    private handleReconnection;
+    private cleanup;
+    private withConnection;
+    getMessagesCount(mailbox: string): Promise<number>;
+    fetchMessageByDate(mailbox: string, start: Date | number, endingx?: Date | number, options?: iFetchOptions): Promise<FetchedMessage[]>;
+    fetchMessages(mailbox: string, end: number, count: number, options?: iFetchOptions): Promise<FetchedMessage[]>;
+    moveMessage(msg: FetchedMessage, sourceMailbox: string, targetMailbox: string): Promise<void>;
+    getFolderList(): Promise<imapflow.ListResponse[]>;
+    getFolderTree(): Promise<imapflow.ListTreeResponse>;
+    getSpecialFolders(mailboxes: Awaited<ReturnType<ImapClient["getFolderList"]>>): {
+        inbox: string;
+        trash: string;
+        spam: string;
+        sent: string;
+        drafts: string;
+        archive: string;
+        junk: string;
+    };
+    createmailbox(folder: string[] | string): Promise<imapflow.MailboxCreateResponse>;
+    logout(): Promise<void>;
+    connect(): Promise<void>;
+}
+//# sourceMappingURL=ImapClient.d.ts.map

package/imaplib/ImapClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImapClient.d.ts","sourceRoot":"","sources":["ImapClient.ts"],"names":[],"mappings":"AAGA,OAAO,QAAoE,MAAM,UAAU,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAc,MAAM,YAAY,CAAC;AAO1E,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,OAAO,CAAC;CACnB;AAMD,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,iBAAiB,CAA8B;gBAE3C,GAAG,EAAE,gBAAgB;IAKjC,OAAO,CAAC,IAAI;YA4BE,kBAAkB;IAgChC,OAAO,CAAC,OAAO;YAQD,cAAc;IAmCtB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlD,kBAAkB,CACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,IAAI,GAAG,MAAM,EACpB,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE,aAAa;IAmCrB,aAAa,CACf,OAAO,EAAE,MAAM,EAEf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa;IAsCrB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAwB7E,aAAa;IAMb,aAAa;IAMnB,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;eAIlD,MAAM;eACN,MAAM;cACP,MAAM;cACN,MAAM;gBACJ,MAAM;iBACL,MAAM;cACT,MAAM;;IAgD1B,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM;IAQvC,MAAM;IAWN,OAAO;CAwChB"}

package/imaplib/ImapClient.js

@@ -0,0 +1,312 @@
+// copilot: disable all suggestions related to testing frameworks like jest, mocha, etc.
+// copilot: do not include the return type for functions unless necessary
+import { ImapFlow } from 'imapflow';
+import { FetchedMessage } from './types.js';
+import { styleText } from 'util';
+const defaultFetchOptions = {
+    source: true
+};
+export class ImapClient {
+    client;
+    config;
+    isDestroying = false;
+    connectionPromise = null;
+    constructor(cfg) {
+        this.config = cfg;
+        this.init();
+    }
+    init() {
+        this.client = new ImapFlow({
+            host: this.config.server,
+            port: this.config.port,
+            secure: true,
+            auth: {
+                user: this.config.username,
+                pass: this.config.password
+            },
+            logger: false, // Disable internal logging
+        });
+        // Set up error handlers
+        this.client.on('error', (err) => {
+            console.error(`ImapFlow socket error: ${err.message}`);
+            if (!this.isDestroying) {
+                this.handleReconnection();
+            }
+        });
+        this.client.on('close', () => {
+            console.error(`ImapFlow connection closed`);
+            if (!this.isDestroying) {
+                this.handleReconnection();
+            }
+        });
+    }
+    async handleReconnection() {
+        if (this.connectionPromise)
+            return; // Already reconnecting
+        this.connectionPromise = new Promise(async (resolve) => {
+            try {
+                // Clean up old client
+                this.cleanup();
+                // Wait before reconnecting
+                await new Promise(r => setTimeout(r, 1000));
+                // Reinitialize
+                this.init();
+                try {
+                    await this.client.connect();
+                    console.log('Reconnected successfully');
+                }
+                catch (err) {
+                    console.error('Reconnection failed, will retry:', err);
+                    // Will trigger another reconnection attempt via error handler
+                }
+            }
+            catch (err) {
+                console.error('Error during reconnection process:', err);
+            }
+            finally {
+                this.connectionPromise = null;
+                resolve();
+            }
+        });
+        return this.connectionPromise;
+    }
+    cleanup() {
+        if (this.client) {
+            this.client.removeAllListeners('error');
+            this.client.removeAllListeners('close');
+        }
+    }
+    // Wrapper to ensure all operations handle connection errors
+    async withConnection(operation) {
+        try {
+            await this.connect();
+            return await operation();
+        }
+        catch (err) {
+            console.error(`Operation failed: ${err.message}`);
+            // Check if it's a connection-related error
+            if (err.code === 'ECONNRESET' || err.code === 'ENOTFOUND' ||
+                err.code === 'ETIMEDOUT' || err.code === 'ECONNREFUSED' ||
+                err.message.includes('connection') || err.message.includes('socket')) {
+                if (!this.isDestroying) {
+                    console.log('Connection error detected, attempting reconnection...');
+                    await this.handleReconnection();
+                    // Retry the operation once after reconnection
+                    try {
+                        await this.connect();
+                        return await operation();
+                    }
+                    catch (retryErr) {
+                        console.error(`Operation failed after reconnection: ${retryErr}`);
+                        throw retryErr;
+                    }
+                }
+            }
+            throw err;
+        }
+    }
+    // https://imapflow.com/module-imapflow-ImapFlow.html
+    // https://imapflow.com/module-imapflow-ImapFlow.html#search
+    async getMessagesCount(mailbox) {
+        return this.withConnection(async () => {
+            const status = await this.client.status(mailbox, { messages: true });
+            return status.messages;
+        });
+    }
+    async fetchMessageByDate(mailbox, start, endingx, options) {
+        try {
+            options = { ...defaultFetchOptions, ...options }; // Merge with default options
+            await this.connect(); // Ensure connected
+            const startTime = Date.now();
+            const peek = true; // always peek for now
+            await this.client.mailboxOpen(mailbox, { readOnly: peek });
+            if (typeof start === 'number')
+                start = new Date(start);
+            if (endingx && typeof endingx === 'number')
+                endingx = new Date(endingx);
+            const ending = endingx; // Hack for typescript typing
+            const searchCriteria = endingx ? { since: start, before: ending } : { on: start };
+            const fetchQuery = {
+                uid: true,
+                envelope: true,
+                flags: true,
+                headers: true,
+                source: options.source
+            };
+            const messageObjects = await this.client.fetchAll(searchCriteria, fetchQuery);
+            // const messageObjects = await this.client.fetchAll(uids, fetchQuery);
+            const messages = messageObjects.map(msg => new FetchedMessage(msg));
+            // if (this.config.verbose) console.log(`Fetched ${messages.length} messages in ${Date.now() - startTime}ms`);
+            return messages;
+        }
+        catch (error) {
+            console.error(`Error fetching messages by date`, error);
+            debugger;
+            throw error; // rethrow to handle it outside
+        }
+        finally {
+            await this.client.mailboxClose();
+        }
+    }
+    async fetchMessages(mailbox, 
+    // start: number,
+    end, count, options) {
+        try {
+            options = { ...defaultFetchOptions, ...options }; // Merge with default options
+            await this.connect(); // Ensure connected
+            const peek = true; // always peek for now
+            await this.client.mailboxOpen(mailbox, { readOnly: peek });
+            let start = end - count + 1;
+            const range = `${start}:${end}`;
+            const startTime = Date.now();
+            const fetchQuery = {
+                uid: true,
+                envelope: true,
+                flags: true,
+                // bodyStructure: true,
+                headers: true,
+                source: options.source // Fetch the raw RFC822 message
+            };
+            const messageObjects = await this.client.fetchAll(range, fetchQuery);
+            // Testing
+            const messages = messageObjects.map(msg => new FetchedMessage(msg));
+            // console.log(`Fetched ${messages.length} messages in ${Date.now() - startTime}ms`);
+            return messages;
+        }
+        catch (error) {
+            console.error(`Error fetching messages: ${error.message}`);
+            debugger;
+            throw error; // rethrow to handle it outside
+        }
+        finally {
+            await this.client.mailboxClose();
+            // await this.client.logout();
+        }
+    }
+    // async moveMessage(uid: number, sourceMailbox: string, targetMailbox: string) {
+    async moveMessage(msg, sourceMailbox, targetMailbox) {
+        try {
+            await this.connect(); // Ensure connected
+            await this.client.mailboxOpen(sourceMailbox, { readOnly: false }); // Open the source mailbox in read-write mode
+            const result = await this.client.messageMove([msg.uid], targetMailbox, { uid: true });
+            if (result && !result.uidMap) {
+                console.log(styleText(['red', 'bgBlack'], `iflow/iMapClient: NO uidMap: Failed to move message UID ${msg.uid} from ${sourceMailbox} to ${targetMailbox}`));
+                return; // Treat as nonfatal
+            }
+            if (!result || !result.uidMap.has(msg.uid)) {
+                debugger;
+                throw new Error(`Message with UID ${msg.uid} was not moved.`);
+            }
+        }
+        catch (error) {
+            const ermsg = `iflow/iMapClient: Error moving message UID ${msg.uid}: ${error.message}`;
+            console.log(styleText(['red', 'bgBlack'], ermsg));
+            debugger;
+            throw error;
+        }
+        finally {
+            await this.client.mailboxClose();
+        }
+    }
+    async getFolderList() {
+        return this.withConnection(async () => {
+            return await this.client.list();
+        });
+    }
+    async getFolderTree() {
+        return this.withConnection(async () => {
+            return await this.client.listTree();
+        });
+    }
+    getSpecialFolders(mailboxes) {
+        try {
+            // await this.client.connect();
+            const specialFolders = {
+                inbox: null,
+                trash: null,
+                spam: null,
+                sent: null,
+                drafts: null,
+                archive: null,
+                junk: null,
+            };
+            for (const box of mailboxes) {
+                // normalize flags/specialUse
+                const rawFlags = Array.isArray(box.flags)
+                    ? box.flags
+                    : box.flags
+                        ? [box.flags]
+                        : [];
+                const rawSpecial = Array.isArray(box.specialUse)
+                    ? box.specialUse
+                    : box.specialUse
+                        ? [box.specialUse]
+                        : [];
+                const attrs = [...rawFlags, ...rawSpecial];
+                const name = box.path;
+                if (attrs.includes('\\Inbox') || name.toLowerCase() === 'inbox')
+                    specialFolders.inbox = name;
+                if (attrs.includes('\\Trash'))
+                    specialFolders.trash = name;
+                if (attrs.includes('\\Junk') || attrs.includes('\\Spam'))
+                    specialFolders.spam = name;
+                if (attrs.includes('\\Sent'))
+                    specialFolders.sent = name;
+                if (attrs.includes('\\Drafts'))
+                    specialFolders.drafts = name;
+                if (attrs.includes('\\Archive'))
+                    specialFolders.archive = name;
+                if (attrs.includes('\\Junk'))
+                    specialFolders.junk = name;
+                // TODO: Figure out why trash isn't trash
+                // specialFolders.trash = "TRASH"; // for dovcoat
+                7; // Place for breakpoints
+            }
+            return specialFolders;
+        }
+        catch (error) {
+            console.error(`Error getting special folders: ${error.message}`);
+            debugger;
+            throw error;
+        }
+        finally {
+            // await this.client.logout();
+        }
+    }
+    async createmailbox(folder) {
+        return this.withConnection(async () => {
+            let info = await this.client.mailboxCreate(folder);
+            console.log(`Created mailbox: ${info.path}`);
+            return info;
+        });
+    }
+    async logout() {
+        this.isDestroying = true;
+        this.cleanup();
+        try {
+            await this.client.logout();
+        }
+        catch (err) {
+            // Ignore logout errors - connection might already be closed
+            console.log(`Logout error (ignored): ${err.message}`);
+        }
+    }
+    async connect() {
+        try {
+            if (this.connectionPromise) {
+                await this.connectionPromise;
+            }
+            if (!this.client.usable) {
+                await this.client.connect();
+            }
+        }
+        catch (err) {
+            console.error(`Connection failed: ${err.message}`);
+            if (!this.isDestroying) {
+                await this.handleReconnection();
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=ImapClient.js.map

package/imaplib/ImapClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImapClient.js","sourceRoot":"","sources":["ImapClient.ts"],"names":[],"mappings":"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"}

package/imaplib/ImapClient.ts

@@ -0,0 +1,376 @@
+// copilot: disable all suggestions related to testing frameworks like jest, mocha, etc.
+// copilot: do not include the return type for functions unless necessary
+
+import imapflow, { FetchQueryObject, ImapFlow, SearchObject, StatusObject } from 'imapflow';
+import { ImapClientConfig, FetchedMessage, FetchQuery } from './types.js';
+import { styleText } from 'util';
+// Removed dependencies on parent project - these should be passed in or handled differently
+
+// TODO: Create our own range object and allow a nosource flag
+
+
+export interface iFetchOptions {
+    source: boolean;  
+}
+
+const defaultFetchOptions: iFetchOptions = {
+    source: true
+}
+
+export class ImapClient {
+    private client: ImapFlow;
+    private config: ImapClientConfig;
+    private isDestroying: boolean = false;
+    private connectionPromise: Promise<void> | null = null;
+
+    constructor(cfg: ImapClientConfig) {
+        this.config = cfg;
+        this.init();
+    }
+
+    private init() {
+        this.client = new ImapFlow({
+            host: this.config.server,
+            port: this.config.port,
+            secure: true,
+            auth: {
+                user: this.config.username,
+                pass: this.config.password
+            },
+            logger: false, // Disable internal logging
+        });
+
+        // Set up error handlers
+        this.client.on('error', (err: any) => {
+            console.error(`ImapFlow socket error: ${err.message}`);
+            if (!this.isDestroying) {
+                this.handleReconnection();
+            }
+        });
+
+        this.client.on('close', () => {
+            console.error(`ImapFlow connection closed`);
+            if (!this.isDestroying) {
+                this.handleReconnection();
+            }
+        });
+    }
+
+    private async handleReconnection() {
+        if (this.connectionPromise) return; // Already reconnecting
+
+        this.connectionPromise = new Promise(async (resolve) => {
+            try {
+                // Clean up old client
+                this.cleanup();
+
+                // Wait before reconnecting
+                await new Promise(r => setTimeout(r, 1000));
+
+                // Reinitialize
+                this.init();
+
+                try {
+                    await this.client.connect();
+                    console.log('Reconnected successfully');
+                } catch (err) {
+                    console.error('Reconnection failed, will retry:', err);
+                    // Will trigger another reconnection attempt via error handler
+                }
+            } catch (err) {
+                console.error('Error during reconnection process:', err);
+            } finally {
+                this.connectionPromise = null;
+                resolve();
+            }
+        });
+
+        return this.connectionPromise;
+    }
+
+    private cleanup() {
+        if (this.client) {
+            this.client.removeAllListeners('error');
+            this.client.removeAllListeners('close');
+        }
+    }
+
+    // Wrapper to ensure all operations handle connection errors
+    private async withConnection<T>(operation: () => Promise<T>): Promise<T> {
+        try {
+            await this.connect();
+            return await operation();
+        } catch (err: any) {
+            console.error(`Operation failed: ${err.message}`);
+
+            // Check if it's a connection-related error
+            if (err.code === 'ECONNRESET' || err.code === 'ENOTFOUND' ||
+                err.code === 'ETIMEDOUT' || err.code === 'ECONNREFUSED' ||
+                err.message.includes('connection') || err.message.includes('socket')) {
+
+                if (!this.isDestroying) {
+                    console.log('Connection error detected, attempting reconnection...');
+                    await this.handleReconnection();
+
+                    // Retry the operation once after reconnection
+                    try {
+                        await this.connect();
+                        return await operation();
+                    } catch (retryErr) {
+                        console.error(`Operation failed after reconnection: ${retryErr}`);
+                        throw retryErr;
+                    }
+                }
+            }
+
+            throw err;
+        }
+    }
+
+    // https://imapflow.com/module-imapflow-ImapFlow.html
+
+    // https://imapflow.com/module-imapflow-ImapFlow.html#search
+
+    async getMessagesCount(mailbox: string): Promise<number> {
+        return this.withConnection(async () => {
+            const status: StatusObject = await this.client.status(mailbox, { messages: true });
+            return status.messages;
+        });
+    }
+
+    async fetchMessageByDate(
+        mailbox: string,
+        start: Date | number,
+        endingx?: Date | number,
+        options?: iFetchOptions) {
+        try {
+            options = {...defaultFetchOptions, ...options}; // Merge with default options
+            await this.connect(); // Ensure connected
+            const startTime = Date.now();
+
+            const peek = true; // always peek for now
+            await this.client.mailboxOpen(mailbox, { readOnly: peek });
+
+            if (typeof start === 'number') start = new Date(start);
+            if (endingx && typeof endingx === 'number') endingx = new Date(endingx);
+            const ending = endingx as Date; // Hack for typescript typing
+            const searchCriteria: SearchObject = endingx ? { since: start, before: ending } : { on: start }
+
+            const fetchQuery: FetchQueryObject = {
+                uid: true,
+                envelope: true,
+                flags: true,
+                headers: true,
+                source: options.source
+            };
+            const messageObjects = await this.client.fetchAll(searchCriteria, fetchQuery);
+            // const messageObjects = await this.client.fetchAll(uids, fetchQuery);
+            const messages = messageObjects.map(msg => new FetchedMessage(msg));
+            // if (this.config.verbose) console.log(`Fetched ${messages.length} messages in ${Date.now() - startTime}ms`);
+            return messages;
+        } catch (error: any) {
+            console.error(`Error fetching messages by date`, error);
+            debugger;
+            throw error; // rethrow to handle it outside
+        } finally {
+            await this.client.mailboxClose();
+        }
+    }
+
+    async fetchMessages(
+        mailbox: string,
+        // start: number,
+        end: number,
+        count: number,
+        options?: iFetchOptions
+    ) {
+        try {
+            options = {...defaultFetchOptions, ...options}; // Merge with default options
+            await this.connect(); // Ensure connected
+            const peek = true; // always peek for now
+            await this.client.mailboxOpen(mailbox, { readOnly: peek });
+            let start = end - count + 1;
+            const range = `${start}:${end}`;
+            const startTime = Date.now();
+
+            const fetchQuery: FetchQuery = {
+                uid: true,
+                envelope: true,
+                flags: true,
+                // bodyStructure: true,
+                headers: true,
+                source: options.source  // Fetch the raw RFC822 message
+            };
+
+            const messageObjects = await this.client.fetchAll(range, fetchQuery);
+            // Testing
+            const messages = messageObjects.map(msg => new FetchedMessage(msg));
+            // console.log(`Fetched ${messages.length} messages in ${Date.now() - startTime}ms`);
+            return messages;
+        }
+        catch (error: any) {
+            console.error(`Error fetching messages: ${error.message}`);
+            debugger;
+            throw error; // rethrow to handle it outside
+        }
+        finally {
+            await this.client.mailboxClose();
+            // await this.client.logout();
+        }
+    }
+
+    // async moveMessage(uid: number, sourceMailbox: string, targetMailbox: string) {
+    async moveMessage(msg: FetchedMessage, sourceMailbox: string, targetMailbox: string) {
+        try {
+            await this.connect(); // Ensure connected
+            await this.client.mailboxOpen(sourceMailbox, { readOnly: false });            // Open the source mailbox in read-write mode
+            const result = await this.client.messageMove([msg.uid], targetMailbox, { uid: true });
+            if (result && !result.uidMap) {
+                console.log(styleText(['red', 'bgBlack'],
+                    `iflow/iMapClient: NO uidMap: Failed to move message UID ${msg.uid} from ${sourceMailbox} to ${targetMailbox}`));
+                return;     // Treat as nonfatal
+            }
+            if (!result || !result.uidMap.has(msg.uid)) {
+                debugger;
+                throw new Error(`Message with UID ${msg.uid} was not moved.`);
+            }
+        } catch (error: any) {
+            const ermsg = `iflow/iMapClient: Error moving message UID ${msg.uid}: ${error.message}`;
+            console.log(styleText(['red', 'bgBlack'], ermsg));
+            debugger;
+            throw error;
+        } finally {
+            await this.client.mailboxClose();
+        }
+    }
+
+    async getFolderList() {
+        return this.withConnection(async () => {
+            return await this.client.list();
+        });
+    }
+
+    async getFolderTree() {
+        return this.withConnection(async () => {
+            return await this.client.listTree();
+        });
+    }
+
+    getSpecialFolders(mailboxes: Awaited<ReturnType<ImapClient["getFolderList"]>>) {
+        try {
+            // await this.client.connect();
+            const specialFolders = {
+                inbox: null as string,
+                trash: null as string,
+                spam: null as string,
+                sent: null as string,
+                drafts: null as string,
+                archive: null as string,
+                junk: null as string,
+            };
+
+            for (const box of mailboxes) {
+                // normalize flags/specialUse
+                const rawFlags = Array.isArray(box.flags)
+                    ? box.flags
+                    : box.flags
+                        ? [box.flags]
+                        : [];
+                const rawSpecial = Array.isArray(box.specialUse)
+                    ? box.specialUse
+                    : box.specialUse
+                        ? [box.specialUse]
+                        : [];
+                const attrs = [...rawFlags, ...rawSpecial];
+                const name = box.path;
+
+                if (attrs.includes('\\Inbox') || name.toLowerCase() === 'inbox')
+                    specialFolders.inbox = name;
+                if (attrs.includes('\\Trash'))
+                    specialFolders.trash = name;
+                if (attrs.includes('\\Junk') || attrs.includes('\\Spam'))
+                    specialFolders.spam = name;
+                if (attrs.includes('\\Sent'))
+                    specialFolders.sent = name;
+                if (attrs.includes('\\Drafts'))
+                    specialFolders.drafts = name;
+                if (attrs.includes('\\Archive'))
+                    specialFolders.archive = name;
+                if (attrs.includes('\\Junk'))
+                    specialFolders.junk = name;
+
+                // TODO: Figure out why trash isn't trash
+                // specialFolders.trash = "TRASH"; // for dovcoat
+                7; // Place for breakpoints
+            }
+
+            return specialFolders;
+        } catch (error: any) {
+            console.error(`Error getting special folders: ${error.message}`);
+            debugger;
+            throw error;
+        } finally {
+            // await this.client.logout();
+        }
+    }
+
+    async createmailbox(folder: string[] | string) {
+        return this.withConnection(async () => {
+            let info = await this.client.mailboxCreate(folder);
+            console.log(`Created mailbox: ${info.path}`);
+            return info;
+        });
+    }
+
+    async logout() {
+        this.isDestroying = true;
+        this.cleanup();
+        try {
+            await this.client.logout();
+        } catch (err: any) {
+            // Ignore logout errors - connection might already be closed
+            console.log(`Logout error (ignored): ${err.message}`);
+        }
+    }
+
+    async connect() {
+        try {
+            if (this.connectionPromise) {
+                await this.connectionPromise;
+            }
+            if (!this.client.usable) {
+                await this.client.connect();
+            }
+        } catch (err: any) {
+            console.error(`Connection failed: ${err.message}`);
+            if (!this.isDestroying) {
+                await this.handleReconnection();
+            }
+            throw err;
+        }
+    }
+
+    // Getter to access underlying ImapFlow client for advanced operations
+    // get imapFlowClient() {
+    //     if (!this.client) {
+    //         this.init();
+    //     }
+    //     return this.client;
+    // }
+
+    // static async run<T>(config: ImapClientConfig, f: () => Promise<T>) {
+    //     const imap = new ImapClient(config);
+
+    //     try {
+    //         await imap.connect();
+    //         return f();
+    //     }
+    //     catch (error: any) {
+    //         logerr(`Error in ImapClient run`, error);
+    //         debugger;
+    //         throw error;
+    //     } finally {
+    //         await imap.logout();
+    //     }
+    // }
+}

package/imaplib/types.d.ts

@@ -0,0 +1,57 @@
+import imapflow from 'imapflow';
+declare class SimpleMap<T> {
+    private items;
+    add(key: string, value: T): void;
+    get(key: string): T[] | undefined;
+}
+export type MessageEnvelope = imapflow.MessageEnvelopeObject;
+export interface ImapClientConfig {
+    server: string;
+    port: number;
+    username: string;
+    password: string;
+    verbose?: boolean;
+}
+export interface FetchQuery extends imapflow.FetchQueryObject {
+}
+export type FetchPart = keyof imapflow.FetchQueryObject;
+export declare class FetchedMessage {
+    private fmo;
+    parsedHeader: string[][];
+    headerSet: SimpleMap<string>;
+    _source: string;
+    constructor(init: imapflow.FetchMessageObject);
+    get flagged(): boolean;
+    get answered(): boolean;
+    get deleted(): boolean;
+    get seen(): boolean;
+    get unread(): boolean;
+    get draft(): boolean;
+    get hasFlag(): boolean;
+    get to(): imapflow.MessageAddressObject[];
+    get cc(): imapflow.MessageAddressObject[];
+    get bcc(): imapflow.MessageAddressObject[];
+    get from(): imapflow.MessageAddressObject[];
+    get replyTo(): imapflow.MessageAddressObject[];
+    get sender(): imapflow.MessageAddressObject[];
+    get date(): Date;
+    get ymd(): string;
+    get tcsb(): Record<string, string[]>;
+    get seq(): number;
+    get uid(): number;
+    get modseq(): bigint;
+    private get envelope();
+    private get flags();
+    get internalDate(): string | Date;
+    get size(): number;
+    get bodyStructure(): imapflow.MessageStructureObject;
+    get source(): string;
+    get messageId(): string;
+    get listUnsubscribe(): string;
+    get xpriority(): string;
+    get importance(): string;
+    get deliveredTo(): string;
+    get subject(): string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/imaplib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAGhC,cAAM,SAAS,CAAC,CAAC;IACb,OAAO,CAAC,KAAK,CAA2B;IAExC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAMzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,SAAS;CAGpC;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,qBAAqB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAgBD,MAAM,WAAW,UAAW,SAAQ,QAAQ,CAAC,gBAAgB;CAC5D;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC;AAExD,qBAAa,cAAc;IACvB,OAAO,CAAC,GAAG,CAA8B;IACzC,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;IACzB,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;gBAEJ,IAAI,EAAE,QAAQ,CAAC,kBAAkB;IAa7C,IAAI,OAAO,YAA8C;IACzD,IAAI,QAAQ,YAA+C;IAC3D,IAAI,OAAO,YAA8C;IACzD,IAAI,IAAI,YAA2C;IACnD,IAAI,MAAM,YAAyB;IACnC,IAAI,KAAK,YAA4C;IACrD,IAAI,OAAO,YAAsC;IAEjD,IAAI,EAAE,oCAA+B;IACrC,IAAI,EAAE,oCAA+B;IACrC,IAAI,GAAG,oCAAgC;IACvC,IAAI,IAAI,oCAAiC;IACzC,IAAI,OAAO,oCAAoC;IAC/C,IAAI,MAAM,oCAAmC;IAC7C,IAAI,IAAI,SAAiC;IACzC,IAAI,GAAG,WAAkD;IACzD,IAAI,IAAI,IAA4B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAI;IAEhE,IAAI,GAAG,WAA2B;IAClC,IAAI,GAAG,WAA2B;IAClC,IAAI,MAAM,WAA8B;IACxC,OAAO,KAAK,QAAQ,GAAgC;IACpD,OAAO,KAAK,KAAK,GAA6B;IAC9C,IAAI,YAAY,kBAAoC;IACpD,IAAI,IAAI,WAA4B;IACpC,IAAI,aAAa,oCAAqC;IACtD,IAAI,MAAM,WAA2B;IAErC,IAAI,SAAS,WAAsC;IACnD,IAAI,eAAe,WAA0D;IAC7E,IAAI,SAAS,WAAoD;IACjE,IAAI,UAAU,WAAoD;IAElE,IAAI,WAAW,WAAsD;IACrE,IAAI,OAAO,WAAoC;CAKlD"}

package/imaplib/types.js

@@ -0,0 +1,63 @@
+// Simple map implementation to replace maplca dependency
+class SimpleMap {
+    items = {};
+    add(key, value) {
+        const k = key.toLowerCase();
+        if (!this.items[k])
+            this.items[k] = [];
+        this.items[k].push(value);
+    }
+    get(key) {
+        return this.items[key.toLowerCase()];
+    }
+}
+export class FetchedMessage {
+    fmo;
+    parsedHeader;
+    headerSet;
+    _source;
+    constructor(init) {
+        this.fmo = init;
+        this._source = init.source?.toString('utf8');
+        this.parsedHeader = this.fmo.headers.toString('utf8')
+            .replace(/\r\n(\s)/g, '$1')
+            .split('\r\n')
+            .filter(line => line.trim() !== '')
+            .map(line => line.split(': ', 2));
+        this.headerSet = new SimpleMap();
+        this.parsedHeader.forEach(([k, v]) => this.headerSet.add(k, v));
+        delete this.fmo.headers;
+    }
+    get flagged() { return this.fmo.flags.has('\\Flagged'); }
+    get answered() { return this.fmo.flags.has('\\Answered'); }
+    get deleted() { return this.fmo.flags.has('\\Deleted'); }
+    get seen() { return this.fmo.flags.has('\\Seen'); }
+    get unread() { return !this.seen; }
+    get draft() { return this.fmo.flags.has('\\Draft'); }
+    get hasFlag() { return this.fmo.flags.size > 0; }
+    get to() { return this.envelope.to; }
+    get cc() { return this.envelope.cc; }
+    get bcc() { return this.envelope.bcc; }
+    get from() { return this.envelope.from; }
+    get replyTo() { return this.envelope.replyTo; }
+    get sender() { return this.envelope.sender; }
+    get date() { return this.envelope.date; }
+    get ymd() { return this.date?.toLocaleDateString('se'); }
+    get tcsb() { return this; } // tcsb = to, cc, bcc
+    get seq() { return this.fmo.seq; }
+    get uid() { return this.fmo.uid; }
+    get modseq() { return this.fmo.modseq; }
+    get envelope() { return this.fmo.envelope; }
+    get flags() { return this.fmo.flags; }
+    get internalDate() { return this.fmo.internalDate; }
+    get size() { return this.fmo.size; }
+    get bodyStructure() { return this.fmo.bodyStructure; }
+    get source() { return this._source; }
+    get messageId() { return this.envelope.messageId; }
+    get listUnsubscribe() { return this.headerSet.get('List-Unsubscribe')?.[0]; }
+    get xpriority() { return this.headerSet.get('X-Priority')?.[0]; }
+    get importance() { return this.headerSet.get('Importance')?.[0]; }
+    get deliveredTo() { return this.headerSet.get('Delivered-To')?.[0]; }
+    get subject() { return this.envelope.subject; }
+}
+//# sourceMappingURL=types.js.map

package/imaplib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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"}

package/imaplib/types.ts

@@ -0,0 +1,105 @@
+import imapflow from 'imapflow';
+
+// Simple map implementation to replace maplca dependency
+class SimpleMap<T> {
+    private items: Record<string, T[]> = {};
+
+    add(key: string, value: T) {
+        const k = key.toLowerCase();
+        if (!this.items[k]) this.items[k] = [];
+        this.items[k].push(value);
+    }
+
+    get(key: string): T[] | undefined {
+        return this.items[key.toLowerCase()];
+    }
+}
+
+export type MessageEnvelope = imapflow.MessageEnvelopeObject;
+
+export interface ImapClientConfig {
+    server: string;
+    port: number;
+    username: string;
+    password: string;
+    verbose?: boolean;
+}
+
+// export interface ImapClientConfig {
+//     server: string;
+//     port: number;
+//     username: string;
+//     password?: string;  // Make optional for OAuth
+//     oauth?: {
+//         accessToken: string;
+//         refreshToken: string;
+//         clientId: string;
+//         clientSecret: string;
+//     };
+//     verbose?: boolean;
+// }
+
+export interface FetchQuery extends imapflow.FetchQueryObject {
+}
+
+export type FetchPart = keyof imapflow.FetchQueryObject;
+
+export class FetchedMessage {
+    private fmo: imapflow.FetchMessageObject;
+    parsedHeader: string[][];
+    headerSet: SimpleMap<string>;
+    _source: string;
+
+    constructor(init: imapflow.FetchMessageObject) {
+        this.fmo = init;
+        this._source = init.source?.toString('utf8');
+        this.parsedHeader = this.fmo.headers.toString('utf8')
+            .replace(/\r\n(\s)/g, '$1')
+            .split('\r\n')
+            .filter(line => line.trim() !== '')
+            .map(line => line.split(': ', 2));
+        this.headerSet = new SimpleMap<string>();
+        this.parsedHeader.forEach(([k, v]) => this.headerSet.add(k, v));
+        delete this.fmo.headers;
+    }
+
+    get flagged() { return this.fmo.flags.has('\\Flagged'); }
+    get answered() { return this.fmo.flags.has('\\Answered'); }
+    get deleted() { return this.fmo.flags.has('\\Deleted'); }
+    get seen() { return this.fmo.flags.has('\\Seen'); }
+    get unread() { return !this.seen; } 
+    get draft() { return this.fmo.flags.has('\\Draft'); }
+    get hasFlag() { return this.fmo.flags.size > 0; }
+
+    get to() { return this.envelope.to; }
+    get cc() { return this.envelope.cc; }
+    get bcc() { return this.envelope.bcc; }
+    get from() { return this.envelope.from; }
+    get replyTo() { return this.envelope.replyTo; }
+    get sender() { return this.envelope.sender; }
+    get date() { return this.envelope.date; }
+    get ymd() { return this.date?.toLocaleDateString('se'); }
+    get tcsb() { return (this as any as Record<string, string[]>); } // tcsb = to, cc, bcc
+
+    get seq() { return this.fmo.seq; }
+    get uid() { return this.fmo.uid; }
+    get modseq() { return this.fmo.modseq; }
+    private get envelope() { return this.fmo.envelope; }
+    private get flags() { return this.fmo.flags; }
+    get internalDate() { return this.fmo.internalDate; }
+    get size() { return this.fmo.size; }
+    get bodyStructure() { return this.fmo.bodyStructure; }
+    get source() { return this._source; }
+
+    get messageId() { return this.envelope.messageId; }
+    get listUnsubscribe() { return this.headerSet.get('List-Unsubscribe')?.[0]; }
+    get xpriority() { return this.headerSet.get('X-Priority')?.[0]; }
+    get importance() { return this.headerSet.get('Importance')?.[0]; }
+
+    get deliveredTo() { return this.headerSet.get('Delivered-To')?.[0]; }
+    get subject() { return this.envelope.subject; }
+
+    // if you still need raw headers or bodyParts you can add:
+    // get rawHeaders() { return this.fmo.headers; }
+    // get bodyParts() { return this.fmo.bodyParts; }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@bobfrankston/iflow",
+  "version": "1.0.2",
+  "description": "IMAP client wrapper library",
+  "main": "imaplib/ImapClient.js",
+  "types": "imaplib/ImapClient.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc -watch"
+  },
+  "keywords": [
+    "imap",
+    "email",
+    "client"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@types/imapflow": "^1.0.22",
+    "imapflow": "^1.0.187"
+  },
+  "exports": {
+    ".": {
+      "types": "./imaplib/types.ts",
+      "default": "./imaplib/types.js"
+    },
+    "./client": {
+      "types": "./imaplib/ImapClient.ts",
+      "default": "./imaplib/ImapClient.js"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BobFrankston/iflow.git"
+  },
+  "bugs": {
+    "url": "https://github.com/BobFrankston/iflow/issues"
+  },
+  "homepage": "https://github.com/BobFrankston/iflow#readme"
+}