@bobfrankston/mailx 1.0.169 → 1.0.172

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-settings/index.d.ts

@@ -42,6 +42,7 @@ declare const DEFAULT_PREFERENCES: {
     sync: {
         intervalMinutes: number;
         historyDays: number;
+        prefetch: boolean;
     };
     autocomplete: {
         enabled: boolean;
@@ -99,5 +100,7 @@ export declare function initCloudConfig(provider?: "gdrive"): Promise<void>;
 declare const DEFAULT_SETTINGS: MailxSettings;
 /** Get historyDays for an account: per-account override > system override > shared default */
 export declare function getHistoryDays(accountId?: string): number;
+/** Get prefetch setting: download bodies during sync (default true) */
+export declare function getPrefetch(): boolean;
 export { DEFAULT_SETTINGS, DEFAULT_ALLOWLIST, DEFAULT_PREFERENCES, DEFAULT_AUTOCOMPLETE, LOCAL_DIR };
 //# sourceMappingURL=index.d.ts.map

package/packages/mailx-settings/index.js

@@ -338,6 +338,7 @@ const DEFAULT_PREFERENCES = {
     sync: {
         intervalMinutes: 5,
         historyDays: 30,
+        prefetch: true,
     },
     autocomplete: {
         enabled: false,
@@ -633,5 +634,10 @@ export function getHistoryDays(accountId) {
     const prefs = loadPreferences();
     return prefs.sync.historyDays || 0;
 }
+/** Get prefetch setting: download bodies during sync (default true) */
+export function getPrefetch() {
+    const prefs = loadPreferences();
+    return prefs.sync.prefetch !== false;
+}
 export { DEFAULT_SETTINGS, DEFAULT_ALLOWLIST, DEFAULT_PREFERENCES, DEFAULT_AUTOCOMPLETE, LOCAL_DIR };
 //# sourceMappingURL=index.js.map

package/packages/mailx-types/index.d.ts

@@ -191,6 +191,7 @@ export interface MailxSettings {
     sync: {
         intervalMinutes: number;
         historyDays: number; /** 0 = all history */
+        prefetch: boolean; /** Download message bodies during sync (default true) */
     };
     store: {
         basePath: string; /** Where message bodies are stored */