@bobfrankston/mailx 1.0.229 → 1.0.230

package/bin/mailx.js

@@ -775,6 +775,9 @@ async function main() {
     imapManager.on("accountError", (accountId, error, hint, isOAuth) => {
         handle.send({ _event: "accountError", type: "accountError", accountId, error, hint, isOAuth });
     });
+    imapManager.on("configChanged", (filename) => {
+        handle.send({ _event: "configChanged", type: "configChanged", filename });
+    });
     // Brief pause for WebView2 to initialize before starting IMAP (avoids stdin writes during init)
     await new Promise(r => setTimeout(r, 500));
     // Register all accounts (OAuth may open browser for Gmail — event loop stays free for IPC)
@@ -797,6 +800,7 @@ async function main() {
     }
     imapManager.startPeriodicSync(settings.sync.intervalMinutes);
     imapManager.startOutboxWorker();
+    imapManager.watchConfigFiles();
     // Graceful shutdown — close IMAP connections, stop timers, close DB
     let shuttingDown = false;
     async function gracefulShutdown(reason) {

package/client/app.js

@@ -866,6 +866,11 @@ onWsEvent((event) => {
         case "reload":
             location.reload();
             break;
+        case "configChanged":
+            // A watched config file (accounts.jsonc etc.) was modified externally.
+            // Show a banner telling the user to restart for changes to take effect.
+            showAlert(`${event.filename} was updated — restart mailx to apply changes`, `config-${event.filename}`);
+            break;
         case "error":
             if (statusSync)
                 statusSync.textContent = `Error: ${event.message}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx",
-  "version": "1.0.229",
+  "version": "1.0.230",
   "description": "Local-first email client with IMAP sync and standalone native app",
   "type": "module",
   "main": "bin/mailx.js",
@@ -24,7 +24,7 @@
     "@bobfrankston/iflow-node": "^0.1.2",
     "@bobfrankston/miscinfo": "^1.0.8",
     "@bobfrankston/oauthsupport": "^1.0.22",
-    "@bobfrankston/msger": "^0.1.291",
+    "@bobfrankston/msger": "^0.1.292",
     "@capacitor/android": "^8.3.0",
     "@capacitor/cli": "^8.3.0",
     "@capacitor/core": "^8.3.0",
@@ -78,7 +78,7 @@
       "@bobfrankston/iflow-node": "^0.1.2",
       "@bobfrankston/miscinfo": "^1.0.8",
       "@bobfrankston/oauthsupport": "^1.0.22",
-      "@bobfrankston/msger": "^0.1.291",
+      "@bobfrankston/msger": "^0.1.292",
       "@capacitor/android": "^8.3.0",
       "@capacitor/cli": "^8.3.0",
       "@capacitor/core": "^8.3.0",

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

@@ -18,6 +18,7 @@ export interface ImapManagerEvents {
         unread: number;
     }>) => void;
     accountError: (accountId: string, error: string, hint: string, isOAuth: boolean) => void;
+    configChanged: (filename: string) => void;
 }
 export declare class ImapManager extends EventEmitter {
     private configs;
@@ -205,6 +206,13 @@ export declare class ImapManager extends EventEmitter {
     startOutboxWorker(): void;
     /** Stop Outbox worker */
     stopOutboxWorker(): void;
+    private configWatchers;
+    /** Watch the local config files for external changes. On change, emit
+     *  configChanged so the UI can show a "restart to apply" banner. Uses
+     *  a debounce to coalesce rapid writes from save tools. */
+    watchConfigFiles(): void;
+    /** Stop all config file watchers */
+    stopWatchingConfig(): void;
     private contactsSyncToken;
     /** Get an OAuth token for Google APIs (contacts, calendar, etc.)
      *  Uses the SAME token as IMAP — scopes are combined in one grant */

package/packages/mailx-imap/index.js

@@ -2116,6 +2116,47 @@ export class ImapManager extends EventEmitter {
             this.outboxInterval = null;
         }
     }
+    // ── Config file watcher ──
+    configWatchers = [];
+    /** Watch the local config files for external changes. On change, emit
+     *  configChanged so the UI can show a "restart to apply" banner. Uses
+     *  a debounce to coalesce rapid writes from save tools. */
+    watchConfigFiles() {
+        const files = ["accounts.jsonc", "allowlist.jsonc", "clients.jsonc", "config.jsonc"];
+        const configDir = getConfigDir();
+        const debounce = new Map();
+        for (const filename of files) {
+            const full = path.join(configDir, filename);
+            if (!fs.existsSync(full))
+                continue;
+            try {
+                const watcher = fs.watch(full, () => {
+                    const prev = debounce.get(filename);
+                    if (prev)
+                        clearTimeout(prev);
+                    debounce.set(filename, setTimeout(() => {
+                        debounce.delete(filename);
+                        console.log(`  [watch] ${filename} changed`);
+                        this.emit("configChanged", filename);
+                    }, 500));
+                });
+                this.configWatchers.push(watcher);
+            }
+            catch (e) {
+                console.error(`  [watch] Failed to watch ${filename}: ${e.message}`);
+            }
+        }
+    }
+    /** Stop all config file watchers */
+    stopWatchingConfig() {
+        for (const w of this.configWatchers) {
+            try {
+                w.close();
+            }
+            catch { /* ignore */ }
+        }
+        this.configWatchers = [];
+    }
     // ── Google Contacts Sync ──
     contactsSyncToken = null;
     /** Get an OAuth token for Google APIs (contacts, calendar, etc.)