@bobfrankston/mailx 1.0.171 → 1.0.173

package/packages/mailx-imap/providers/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Mail provider interface — abstraction over IMAP, Gmail API, and Microsoft Graph.
+ * Sync code uses this interface; never calls IMAP/REST directly.
+ */
+export interface ProviderFolder {
+    path: string;
+    name: string;
+    delimiter: string;
+    specialUse: string;
+    flags: string[];
+}
+export interface ProviderMessage {
+    uid: number;
+    messageId: string;
+    providerId: string;
+    date: Date | null;
+    subject: string;
+    from: {
+        name?: string;
+        address?: string;
+    }[];
+    to: {
+        name?: string;
+        address?: string;
+    }[];
+    cc: {
+        name?: string;
+        address?: string;
+    }[];
+    seen: boolean;
+    flagged: boolean;
+    answered: boolean;
+    draft: boolean;
+    size: number;
+    source: string;
+}
+export interface FetchOptions {
+    source?: boolean;
+}
+/**
+ * A mail provider that can list folders, fetch messages, and perform actions.
+ * Implementations: ImapProvider (existing iflow), GmailApiProvider, GraphApiProvider.
+ */
+export interface MailProvider {
+    /** List all folders/labels */
+    listFolders(): Promise<ProviderFolder[]>;
+    /** Fetch messages newer than sinceUid (incremental sync) */
+    fetchSince(folder: string, sinceUid: number, options?: FetchOptions): Promise<ProviderMessage[]>;
+    /** Fetch messages by date range (first sync) */
+    fetchByDate(folder: string, since: Date, before: Date, options?: FetchOptions, onChunk?: (msgs: ProviderMessage[]) => void): Promise<ProviderMessage[]>;
+    /** Fetch specific messages by UID */
+    fetchByUids(folder: string, uids: number[], options?: FetchOptions): Promise<ProviderMessage[]>;
+    /** Fetch a single message by UID */
+    fetchOne(folder: string, uid: number, options?: FetchOptions): Promise<ProviderMessage | null>;
+    /** Get all UIDs in a folder (for reconciliation) */
+    getUids(folder: string): Promise<number[]>;
+    /** Close/cleanup */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/mailx-imap/providers/types.js

@@ -0,0 +1,6 @@
+/**
+ * Mail provider interface — abstraction over IMAP, Gmail API, and Microsoft Graph.
+ * Sync code uses this interface; never calls IMAP/REST directly.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/mailx-store/db.d.ts

@@ -58,6 +58,11 @@ export declare class MailxDB {
     getMessageBodyPath(accountId: string, uid: number): string;
     updateMessageFlags(accountId: string, uid: number, flags: string[]): void;
     updateBodyPath(accountId: string, uid: number, bodyPath: string): void;
+    /** Get messages without cached bodies (for background prefetch) */
+    getMessagesWithoutBody(accountId: string, limit?: number): {
+        uid: number;
+        folderId: number;
+    }[];
     getHighestUid(accountId: string, folderId: number): number;
     getOldestDate(accountId: string, folderId: number): number;
     getMessageCount(accountId: string, folderId: number): number;

package/packages/mailx-store/db.js

@@ -320,6 +320,10 @@ export class MailxDB {
     updateBodyPath(accountId, uid, bodyPath) {
         this.db.prepare("UPDATE messages SET body_path = ? WHERE account_id = ? AND uid = ?").run(bodyPath, accountId, uid);
     }
+    /** Get messages without cached bodies (for background prefetch) */
+    getMessagesWithoutBody(accountId, limit = 50) {
+        return this.db.prepare("SELECT uid, folder_id as folderId FROM messages WHERE account_id = ? AND (body_path IS NULL OR body_path = '') ORDER BY date DESC LIMIT ?").all(accountId, limit);
+    }
     getHighestUid(accountId, folderId) {
         const r = this.db.prepare("SELECT MAX(uid) as maxUid FROM messages WHERE account_id = ? AND folder_id = ?").get(accountId, folderId);
         return r?.maxUid || 0;