@bobfrankston/mailx 1.0.168 → 1.0.171

package/client/app.js

@@ -5,7 +5,7 @@
 import { initFolderTree, refreshFolderTree, updateFolderCounts } from "./components/folder-tree.js";
 import { initMessageList, loadMessages, loadUnifiedInbox, loadSearchResults, reloadCurrentFolder, getSelectedMessages } from "./components/message-list.js";
 import { showMessage, getCurrentMessage } from "./components/message-viewer.js";
-import { connectWebSocket, onWsEvent, triggerSync, getAccounts, getFolders, deleteMessages, undeleteMessage, restartServer, rebuildServer, getSyncPending, getVersion, getSettings, saveSettings, getAutocompleteSettings, saveAutocompleteSettings, repairAccounts } from "./lib/api-client.js";
+import { connectWebSocket, onWsEvent, triggerSync, syncAccount, reauthenticate, getAccounts, getFolders, deleteMessages, undeleteMessage, restartServer, rebuildServer, getSyncPending, getVersion, getSettings, saveSettings, getAutocompleteSettings, saveAutocompleteSettings, repairAccounts } from "./lib/api-client.js";
 // ── New message badge (favicon + title) ──
 let baseTitle = "mailx";
 let lastSeenCount = 0;
@@ -641,8 +641,7 @@ onWsEvent((event) => {
                             btn.disabled = true;
                             btn.textContent = "Authenticating...";
                             try {
-                                const res = await fetch(`/api/reauth/${event.accountId}`, { method: "POST" });
-                                const data = await res.json();
+                                const data = await reauthenticate(event.accountId);
                                 if (data.ok) {
                                     hideAlert();
                                     const acctEl = document.getElementById("status-accounts");
@@ -668,8 +667,7 @@ onWsEvent((event) => {
                             btn.disabled = true;
                             btn.textContent = "Syncing...";
                             try {
-                                const res = await fetch(`/api/sync/${event.accountId}`, { method: "POST" });
-                                const data = await res.json();
+                                const data = await syncAccount(event.accountId);
                                 if (data.ok) {
                                     hideAlert();
                                     const acctEl = document.getElementById("status-accounts");

package/client/lib/api-client.js

@@ -6,7 +6,9 @@
  * All server operations MUST go through these centralized methods.
  * Never use fetch("/api/...") directly in components.
  */
-const hasIPC = typeof mailxapi !== "undefined" && mailxapi?.isApp;
+// In popup windows (compose), mailxapi isn't injected — fall back to opener's bridge
+const _ipc = typeof mailxapi !== "undefined" ? mailxapi : window.opener?.mailxapi;
+const hasIPC = _ipc?.isApp === true;
 // ── HTTP fallback ──
 // Abort controller for message-list requests — cancel stale fetches when folder changes
 let messageListAbort = null;
@@ -44,29 +46,29 @@ async function api(path, options) {
 // ── API Methods (IPC or HTTP) ──
 export function getAccounts() {
     if (hasIPC)
-        return mailxapi.getAccounts();
+        return _ipc.getAccounts();
     return api("/accounts");
 }
 export function getFolders(accountId) {
     if (hasIPC)
-        return mailxapi.getFolders(accountId);
+        return _ipc.getFolders(accountId);
     return api(`/folders/${accountId}`);
 }
 export function getMessages(accountId, folderId, page = 1, pageSize = 50) {
     if (hasIPC)
-        return mailxapi.getMessages(accountId, folderId, page, pageSize);
+        return _ipc.getMessages(accountId, folderId, page, pageSize);
     const signal = newMessageListSignal();
     return api(`/messages/${accountId}/${folderId}?page=${page}&pageSize=${pageSize}`, { signal });
 }
 export function getUnifiedInbox(page = 1, pageSize = 50) {
     if (hasIPC)
-        return mailxapi.getUnifiedInbox(page, pageSize);
+        return _ipc.getUnifiedInbox(page, pageSize);
     const signal = newMessageListSignal();
     return api(`/messages/unified/inbox?page=${page}&pageSize=${pageSize}`, { signal });
 }
 export function searchMessages(query, page = 1, pageSize = 50, scope = "all", accountId = "", folderId = 0) {
     if (hasIPC)
-        return mailxapi.searchMessages(query, page, pageSize);
+        return _ipc.searchMessages(query, page, pageSize);
     const params = new URLSearchParams({ q: query, page: String(page), pageSize: String(pageSize), scope });
     if (scope === "current" && accountId) {
         params.set("accountId", accountId);
@@ -80,7 +82,7 @@ export function searchMessages(query, page = 1, pageSize = 50, scope = "all", ac
 }
 export function getMessage(accountId, uid, allowRemote = false, folderId) {
     if (hasIPC)
-        return mailxapi.getMessage(accountId, uid, allowRemote, folderId);
+        return _ipc.getMessage(accountId, uid, allowRemote, folderId);
     const params = new URLSearchParams();
     if (allowRemote)
         params.set("allowRemote", "true");
@@ -91,7 +93,7 @@ export function getMessage(accountId, uid, allowRemote = false, folderId) {
 }
 export function updateFlags(accountId, uid, flags) {
     if (hasIPC)
-        return mailxapi.updateFlags(accountId, uid, flags);
+        return _ipc.updateFlags(accountId, uid, flags);
     return api(`/message/${accountId}/${uid}/flags`, {
         method: "PATCH",
         body: JSON.stringify({ flags })
@@ -99,22 +101,32 @@ export function updateFlags(accountId, uid, flags) {
 }
 export function triggerSync() {
     if (hasIPC)
-        return mailxapi.syncAll();
+        return _ipc.syncAll();
     return api("/sync", { method: "POST" });
 }
+export function syncAccount(accountId) {
+    if (hasIPC)
+        return _ipc.syncAccount(accountId);
+    return api(`/sync/${accountId}`, { method: "POST" });
+}
+export function reauthenticate(accountId) {
+    if (hasIPC)
+        return _ipc.reauthenticate(accountId);
+    return api(`/reauth/${accountId}`, { method: "POST" });
+}
 export function getSyncPending() {
     if (hasIPC)
-        return mailxapi.getSyncPending();
+        return _ipc.getSyncPending();
     return api("/sync/pending");
 }
 export function searchContacts(query) {
     if (hasIPC)
-        return mailxapi.searchContacts(query);
+        return _ipc.searchContacts(query);
     return api(`/contacts?q=${encodeURIComponent(query)}`);
 }
 export function allowRemoteContent(type, value) {
     if (hasIPC)
-        return mailxapi.allowRemoteContent(type, value);
+        return _ipc.allowRemoteContent(type, value);
     return api("/settings/allow-remote", {
         method: "POST",
         body: JSON.stringify({ type, value })
@@ -122,14 +134,14 @@ export function allowRemoteContent(type, value) {
 }
 export function deleteMessage(accountId, uid) {
     if (hasIPC)
-        return mailxapi.deleteMessage?.(accountId, uid);
+        return _ipc.deleteMessage?.(accountId, uid);
     return api(`/message/${accountId}/${uid}`, { method: "DELETE" });
 }
 export function deleteMessages(accountId, uids) {
     if (uids.length === 1)
         return deleteMessage(accountId, uids[0]);
     if (hasIPC)
-        return mailxapi.deleteMessages?.(accountId, uids);
+        return _ipc.deleteMessages?.(accountId, uids);
     return api("/messages/delete", {
         method: "POST", body: JSON.stringify({ accountId, uids })
     });
@@ -138,7 +150,7 @@ export function moveMessages(accountId, uids, targetFolderId, targetAccountId) {
     if (uids.length === 1)
         return moveMessage(accountId, uids[0], targetFolderId, targetAccountId);
     if (hasIPC)
-        return mailxapi.moveMessages?.(accountId, uids, targetFolderId, targetAccountId);
+        return _ipc.moveMessages?.(accountId, uids, targetFolderId, targetAccountId);
     const body = { accountId, uids, targetFolderId };
     if (targetAccountId)
         body.targetAccountId = targetAccountId;
@@ -148,7 +160,7 @@ export function moveMessages(accountId, uids, targetFolderId, targetAccountId) {
 }
 export function undeleteMessage(accountId, uid, folderId) {
     if (hasIPC)
-        return mailxapi.undeleteMessage?.(accountId, uid, folderId);
+        return _ipc.undeleteMessage?.(accountId, uid, folderId);
     return api(`/message/${accountId}/${uid}/undelete`, {
         method: "POST",
         body: JSON.stringify({ folderId })
@@ -156,7 +168,7 @@ export function undeleteMessage(accountId, uid, folderId) {
 }
 export function moveMessage(accountId, uid, targetFolderId, targetAccountId) {
     if (hasIPC)
-        return mailxapi.moveMessage?.(accountId, uid, targetFolderId, targetAccountId);
+        return _ipc.moveMessage?.(accountId, uid, targetFolderId, targetAccountId);
     const body = { targetFolderId };
     if (targetAccountId)
         body.targetAccountId = targetAccountId;
@@ -167,7 +179,7 @@ export function moveMessage(accountId, uid, targetFolderId, targetAccountId) {
 }
 export function restartServer() {
     if (hasIPC)
-        return mailxapi.restart?.();
+        return _ipc.restart?.();
     return api("/restart", { method: "POST" }).catch(() => { });
 }
 export function rebuildServer() {
@@ -175,12 +187,12 @@ export function rebuildServer() {
 }
 export function markFolderRead(accountId, folderId) {
     if (hasIPC)
-        return mailxapi.markFolderRead?.(accountId, folderId);
+        return _ipc.markFolderRead?.(accountId, folderId);
     return api(`/folder/${accountId}/${folderId}/mark-read`, { method: "POST" });
 }
 export function createFolder(accountId, parentPath, name) {
     if (hasIPC)
-        return mailxapi.createFolder?.(accountId, parentPath, name);
+        return _ipc.createFolder?.(accountId, parentPath, name);
     return api(`/folder/${accountId}`, {
         method: "POST",
         body: JSON.stringify({ parentPath, name })
@@ -188,7 +200,7 @@ export function createFolder(accountId, parentPath, name) {
 }
 export function renameFolder(accountId, folderId, newName) {
     if (hasIPC)
-        return mailxapi.renameFolder?.(accountId, folderId, newName);
+        return _ipc.renameFolder?.(accountId, folderId, newName);
     return api(`/folder/${accountId}/${folderId}/rename`, {
         method: "POST",
         body: JSON.stringify({ newName })
@@ -196,22 +208,22 @@ export function renameFolder(accountId, folderId, newName) {
 }
 export function deleteFolder(accountId, folderId) {
     if (hasIPC)
-        return mailxapi.deleteFolder?.(accountId, folderId);
+        return _ipc.deleteFolder?.(accountId, folderId);
     return api(`/folder/${accountId}/${folderId}`, { method: "DELETE" });
 }
 export function emptyFolder(accountId, folderId) {
     if (hasIPC)
-        return mailxapi.emptyFolder?.(accountId, folderId);
+        return _ipc.emptyFolder?.(accountId, folderId);
     return api(`/folder/${accountId}/${folderId}/empty`, { method: "POST" });
 }
 export function sendMessage(body) {
     if (hasIPC)
-        return mailxapi.sendMessage?.(body);
+        return _ipc.sendMessage?.(body);
     return api("/send", { method: "POST", body: JSON.stringify(body) });
 }
 export function saveDraft(body) {
     if (hasIPC)
-        return mailxapi.saveDraft?.(body);
+        return _ipc.saveDraft?.(body);
     return api("/draft", { method: "POST", body: JSON.stringify(body) });
 }
 const eventHandlers = [];
@@ -221,7 +233,7 @@ export function onEvent(handler) {
 export function connectEvents() {
     if (hasIPC) {
         // IPC events come via mailxapi.onEvent
-        mailxapi.onEvent((event) => {
+        _ipc.onEvent((event) => {
             for (const h of eventHandlers)
                 h(event);
         });
@@ -246,47 +258,47 @@ export function connectEvents() {
 // ── Autocomplete ──
 export function autocomplete(body, signal) {
     if (hasIPC)
-        return mailxapi.autocomplete?.(body);
+        return _ipc.autocomplete?.(body);
     return api("/autocomplete", { method: "POST", body: JSON.stringify(body), signal });
 }
 export function getAutocompleteSettings() {
     if (hasIPC)
-        return mailxapi.getAutocompleteSettings?.();
+        return _ipc.getAutocompleteSettings?.();
     return api("/autocomplete/settings");
 }
 export function saveAutocompleteSettings(settings) {
     if (hasIPC)
-        return mailxapi.saveAutocompleteSettings?.(settings);
+        return _ipc.saveAutocompleteSettings?.(settings);
     return api("/autocomplete/settings", { method: "POST", body: JSON.stringify(settings) });
 }
 export function getVersion() {
     if (hasIPC)
-        return mailxapi.getVersion();
+        return _ipc.getVersion();
     return api("/version");
 }
 export function getSettings() {
     if (hasIPC)
-        return mailxapi.getSettings();
+        return _ipc.getSettings();
     return api("/settings");
 }
 export function saveSettings(settings) {
     if (hasIPC)
-        return mailxapi.saveSettingsData?.(settings);
+        return _ipc.saveSettingsData?.(settings);
     return api("/settings", { method: "PUT", body: JSON.stringify(settings) });
 }
 export function repairAccounts() {
     if (hasIPC)
-        return mailxapi.repairAccounts?.();
+        return _ipc.repairAccounts?.();
     return api("/repair-accounts", { method: "POST" });
 }
 export function deleteDraft(accountId, draftUid) {
     if (hasIPC)
-        return mailxapi.deleteDraft?.(accountId, draftUid);
+        return _ipc.deleteDraft?.(accountId, draftUid);
     return api("/draft", { method: "DELETE", body: JSON.stringify({ accountId, draftUid }) });
 }
 export function setupAccount(name, email, password) {
     if (hasIPC)
-        return mailxapi.setupAccount?.(name, email, password);
+        return _ipc.setupAccount?.(name, email, password);
     return api("/setup", { method: "POST", body: JSON.stringify({ name, email, password }) });
 }
 // Legacy exports for backward compatibility

package/client/lib/mailxapi.js

@@ -103,7 +103,9 @@
 
         // Sync
         syncAll: function() { return callNode("syncAll"); },
+        syncAccount: function(accountId) { return callNode("syncAccount", { accountId: accountId }); },
         getSyncPending: function() { return callNode("getSyncPending"); },
+        reauthenticate: function(accountId) { return callNode("reauthenticate", { accountId: accountId }); },
 
         // Bulk operations
         deleteMessages: function(accountId, uids) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx",
-  "version": "1.0.168",
+  "version": "1.0.171",
   "description": "Local-first email client with IMAP sync and standalone native app",
   "type": "module",
   "main": "bin/mailx.js",
@@ -20,11 +20,11 @@
     "postinstall": "node bin/postinstall.js"
   },
   "dependencies": {
-    "@bobfrankston/iflow-direct": "^0.1.2",
+    "@bobfrankston/iflow-direct": "^0.1.3",
     "@bobfrankston/iflow-node": "^0.1.1",
     "@bobfrankston/miscinfo": "^1.0.7",
     "@bobfrankston/oauthsupport": "^1.0.20",
-    "@bobfrankston/msger": "^0.1.218",
+    "@bobfrankston/msger": "^0.1.220",
     "@capacitor/android": "^8.3.0",
     "@capacitor/cli": "^8.3.0",
     "@capacitor/core": "^8.3.0",

package/packages/mailx-imap/index.js

@@ -6,7 +6,7 @@
 import { createAutoImapConfig, CompatImapClient } from "@bobfrankston/iflow-direct";
 import { authenticateOAuth } from "@bobfrankston/oauthsupport";
 import { FileMessageStore } from "@bobfrankston/mailx-store";
-import { loadSettings, getStorePath, getConfigDir, getHistoryDays } from "@bobfrankston/mailx-settings";
+import { loadSettings, getStorePath, getConfigDir, getHistoryDays, getPrefetch } from "@bobfrankston/mailx-settings";
 import { EventEmitter } from "node:events";
 import * as fs from "node:fs";
 import * as path from "node:path";
@@ -412,7 +412,7 @@ export class ImapManager extends EventEmitter {
         return dbFolders;
     }
     /** Store a batch of messages to DB immediately — used by onChunk for incremental sync */
-    storeMessages(accountId, folderId, folder, msgs, highestUid) {
+    async storeMessages(accountId, folderId, folder, msgs, highestUid) {
         let stored = 0;
         this.db.beginTransaction();
         try {
@@ -426,7 +426,14 @@ export class ImapManager extends EventEmitter {
                     continue; // already have it
                 const source = msg.source || "";
                 let bodyPath = "";
-                // Skip body storage during sync — bodies fetched on demand
+                let preview = "";
+                let hasAttachments = false;
+                if (source) {
+                    bodyPath = await this.bodyStore.putMessage(accountId, folderId, msg.uid, Buffer.from(source, "utf-8"));
+                    const parsed = await extractPreview(source);
+                    preview = parsed.preview;
+                    hasAttachments = parsed.hasAttachments;
+                }
                 const flags = [];
                 if (msg.seen)
                     flags.push("\\Seen");
@@ -444,7 +451,7 @@ export class ImapManager extends EventEmitter {
                     from: toEmailAddress(msg.from?.[0] || {}),
                     to: toEmailAddresses(msg.to || []),
                     cc: toEmailAddresses(msg.cc || []),
-                    flags, size: msg.size || 0, hasAttachments: false, preview: "", bodyPath
+                    flags, size: msg.size || 0, hasAttachments, preview, bodyPath
                 });
                 stored++;
             }
@@ -460,6 +467,7 @@ export class ImapManager extends EventEmitter {
     async syncFolder(accountId, folderId, client) {
         if (!client)
             client = this.createClient(accountId);
+        const prefetch = getPrefetch();
         const folders = this.db.getFolders(accountId);
         const folder = folders.find(f => f.id === folderId);
         if (!folder)
@@ -477,8 +485,8 @@ export class ImapManager extends EventEmitter {
             ? new Date(Date.now() - effectiveDays * 86400000)
             : new Date(0);
         if (highestUid > 0) {
-            // Incremental: fetch new messages — metadata only for speed, bodies on demand
-            const fetched = await client.fetchMessagesSinceUid(folder.path, highestUid, { source: false });
+            // Incremental: fetch new messages — prefetch bodies for offline access
+            const fetched = await client.fetchMessagesSinceUid(folder.path, highestUid, { source: prefetch });
             // Filter out the last known message (IMAP * always returns at least one)
             messages = fetched.filter((m) => m.uid > highestUid);
             // Gap detection: check for missing UIDs within the range we've already synced
@@ -499,7 +507,7 @@ export class ImapManager extends EventEmitter {
                         for (let i = 0; i < missingUids.length; i += chunkSize) {
                             const chunk = missingUids.slice(i, i + chunkSize);
                             const range = chunk.join(",");
-                            const recovered = await client.fetchMessages(folder.path, range, { source: false });
+                            const recovered = await client.fetchMessages(folder.path, range, { source: prefetch });
                             messages.push(...recovered);
                         }
                     }
@@ -515,7 +523,7 @@ export class ImapManager extends EventEmitter {
             const oldestDate = this.db.getOldestDate(accountId, folderId);
             if (oldestDate > 0 && startDate.getTime() < oldestDate) {
                 const existingUids = new Set(this.db.getUidsForFolder(accountId, folderId));
-                const backfill = await client.fetchMessageByDate(folder.path, startDate, new Date(oldestDate), { source: false });
+                const backfill = await client.fetchMessageByDate(folder.path, startDate, new Date(oldestDate), { source: prefetch });
                 const newBackfill = backfill.filter((m) => !existingUids.has(m.uid));
                 if (newBackfill.length > 0) {
                     console.log(`  ${folder.path}: backfilling ${newBackfill.length} older messages`);
@@ -526,8 +534,8 @@ export class ImapManager extends EventEmitter {
         else {
             // First sync: fetch in chunks, store each chunk immediately for instant UI
             let totalStored = 0;
-            const onChunk = (chunk) => {
-                const stored = this.storeMessages(accountId, folderId, folder, chunk, highestUid);
+            const onChunk = async (chunk) => {
+                const stored = await this.storeMessages(accountId, folderId, folder, chunk, highestUid);
                 totalStored += stored;
                 if (stored > 0) {
                     this.db.recalcFolderCounts(folderId);
@@ -535,7 +543,7 @@ export class ImapManager extends EventEmitter {
                 }
             };
             const tomorrow = new Date(Date.now() + 86400000); // IMAP BEFORE is exclusive
-            messages = await client.fetchMessageByDate(folder.path, startDate, tomorrow, { source: false }, onChunk);
+            messages = await client.fetchMessageByDate(folder.path, startDate, tomorrow, { source: prefetch }, onChunk);
             if (totalStored > 0) {
                 console.log(`  ${folder.path}: ${totalStored} messages (streamed)`);
                 this.db.recalcFolderCounts(folderId);
@@ -695,19 +703,34 @@ export class ImapManager extends EventEmitter {
             const t0 = Date.now();
             const folders = await this.syncFolders(accountId, client);
             console.log(`  [timing] ${accountId}: folder list ${Date.now() - t0}ms (${folders.length} folders)`);
-            // Step 2: Sync INBOX first
+            // Step 2: Sync INBOX first — keep retrying on failure (most important folder)
             const inbox = folders.find(f => f.specialUse === "inbox");
             if (inbox) {
                 console.log(`  [sync] ${accountId}: starting INBOX sync (folder ${inbox.id})`);
-                try {
-                    client = await this.getOpsClient(accountId);
-                    console.log(`  [sync] ${accountId}: got client, calling syncFolder for INBOX`);
-                    await this.syncFolder(accountId, inbox.id, client);
-                    console.log(`  [sync] ${accountId}: INBOX sync complete`);
+                const maxAttempts = 5;
+                let inboxDone = false;
+                for (let attempt = 1; attempt <= maxAttempts && !inboxDone; attempt++) {
+                    try {
+                        client = await this.getOpsClient(accountId);
+                        if (attempt > 1)
+                            console.log(`  [sync] ${accountId}: INBOX retry #${attempt}`);
+                        await this.syncFolder(accountId, inbox.id, client);
+                        console.log(`  [sync] ${accountId}: INBOX sync complete`);
+                        inboxDone = true;
+                    }
+                    catch (e) {
+                        console.error(`  Inbox sync error for ${accountId} (attempt ${attempt}/${maxAttempts}): ${e.message}`);
+                        await this.reconnectOps(accountId);
+                        if (attempt < maxAttempts) {
+                            const delay = Math.min(attempt * 5000, 15000);
+                            console.log(`  [sync] ${accountId}: waiting ${delay / 1000}s before INBOX retry`);
+                            await new Promise(r => setTimeout(r, delay));
+                        }
+                    }
                 }
-                catch (e) {
-                    console.error(`  Inbox sync error for ${accountId}: ${e.message}`);
-                    await this.reconnectOps(accountId);
+                if (!inboxDone) {
+                    console.error(`  [sync] ${accountId}: INBOX failed after ${maxAttempts} attempts — will retry next sync cycle`);
+                    this.emit("syncError", accountId, `INBOX sync failed after ${maxAttempts} attempts`);
                 }
             }
             else {

package/packages/mailx-service/jsonrpc.js

@@ -82,8 +82,13 @@ async function dispatchAction(svc, action, p) {
         case "syncAll":
             await svc.syncAll();
             return { ok: true };
+        case "syncAccount":
+            await svc.syncAccount(p.accountId);
+            return { ok: true };
         case "getSyncPending":
             return svc.getSyncPending();
+        case "reauthenticate":
+            return { ok: await svc.reauthenticate(p.accountId) };
         // Search & contacts
         case "searchMessages":
             return svc.search(p.query, p.page, p.pageSize, p.scope, p.accountId, p.folderId);

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 */