@bobfrankston/mailx-settings 0.1.16 → 0.1.18

package/cloud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["cloud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0JH;;;;;;;;;oDASoD;AACpD,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BnF;AAcD;;;;;;;;;;;;;;;;;6CAiB6C;AAC7C,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBvE;AA4ED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,SAAS;IACtB,kFAAkF;IAClF,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,uGAAuG;IACvG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,8BAA8B;IAC9B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAuBtF;AAED;;;;2DAI2D;AAC3D,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAoBvG"}
+{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["cloud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0JH;;;;;;;;;oDASoD;AACpD,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BnF;AAcD;;;;;;;;;;;;;;;;;6CAiB6C;AAC7C,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBvE;AA6FD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,SAAS;IACtB,kFAAkF;IAClF,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,uGAAuG;IACvG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,8BAA8B;IAC9B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAuBtF;AAED;;;;2DAI2D;AAC3D,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAoBvG"}

package/cloud.js

@@ -278,6 +278,22 @@ export async function gDriveFindOrCreateFolder() {
         return null;
     }
 }
+/** Google Drive allows two files with the SAME name in one folder (a sync
+ *  conflict or a double-create produces them; the desktop mount can only
+ *  show one, so the user never sees the stray). A blind `files[0]` then
+ *  picks arbitrarily — and reading an empty duplicate over a real 1.5 MB
+ *  config file silently wipes contacts/accounts. Pick the LARGEST match (an
+ *  empty stub must never beat the real file) and warn so the dup gets
+ *  cleaned up. */
+function pickDriveFile(files, fileName) {
+    if (!files || files.length === 0)
+        return undefined;
+    if (files.length === 1)
+        return files[0].id;
+    const sorted = [...files].sort((a, b) => parseInt(b.size || "0", 10) - parseInt(a.size || "0", 10));
+    console.warn(`  [cloud] ${files.length} files named '${fileName}' in the folder — using the largest (${sorted[0].size || "?"} bytes). DELETE the duplicate(s) in Google Drive — ids: ${sorted.slice(1).map(f => f.id).join(", ")}`);
+    return sorted[0].id;
+}
 /** Read a file by name from a folder (by ID) */
 async function gDriveReadFromFolder(folderId, fileName) {
     const token = await getGoogleDriveToken();
@@ -288,7 +304,7 @@ async function gDriveReadFromFolder(folderId, fileName) {
     try {
         // Find file in folder
         const query = `name='${fileName}' and '${folderId}' in parents and trashed=false`;
-        const res = await fetch(`https://www.googleapis.com/drive/v3/files?q=${encodeURIComponent(query)}&fields=files(id)`, {
+        const res = await fetch(`https://www.googleapis.com/drive/v3/files?q=${encodeURIComponent(query)}&fields=files(id,name,size)`, {
             headers: { Authorization: `Bearer ${token}` },
         });
         if (!res.ok) {
@@ -296,7 +312,7 @@ async function gDriveReadFromFolder(folderId, fileName) {
             return null;
         }
         const data = await res.json();
-        const fileId = data.files?.[0]?.id;
+        const fileId = pickDriveFile(data.files, fileName);
         if (!fileId)
             return null;
         // Download content
@@ -322,7 +338,7 @@ async function gDriveWriteToFolder(folderId, fileName, content) {
         throw new Error("Google Drive: no auth token (OAuth not granted or expired)");
     // Check if file exists in folder
     const query = `name='${fileName}' and '${folderId}' in parents and trashed=false`;
-    const findRes = await fetch(`https://www.googleapis.com/drive/v3/files?q=${encodeURIComponent(query)}&fields=files(id)`, {
+    const findRes = await fetch(`https://www.googleapis.com/drive/v3/files?q=${encodeURIComponent(query)}&fields=files(id,name,size)`, {
         headers: { Authorization: `Bearer ${token}` },
     });
     if (!findRes.ok) {
@@ -330,7 +346,9 @@ async function gDriveWriteToFolder(folderId, fileName, content) {
         throw new Error(`Google Drive: lookup '${fileName}' failed (${findRes.status} ${findRes.statusText}) ${body.slice(0, 200)}`);
     }
     const findData = await findRes.json();
-    const existingId = findData.files?.[0]?.id;
+    // Write to the SAME file a read would pick (largest), so read/write stay
+    // consistent when a duplicate exists.
+    const existingId = pickDriveFile(findData.files, fileName);
     if (existingId) {
         // Update existing file
         const res = await fetch(`https://www.googleapis.com/upload/drive/v3/files/${existingId}?uploadType=media`, {

package/docs/accounts.md

@@ -47,7 +47,7 @@
 - **imap / smtp** — explicit server config. Omit for known providers (Gmail / Outlook / Yahoo / iCloud / Google Workspace are detected from the email domain via MX records).
 - **auth** — `"password"` for traditional IMAP/SMTP, `"oauth2"` for Gmail/Google Workspace/Outlook.
 - **enabled** — set `false` to keep the account record but skip sync at startup.
-- **identityDomains** — addresses you receive at on alternative domains. When you Reply, rmfmail picks the matching identity address as From instead of the account's primary.
+- **identityDomains** — domains you treat as "yours" for Reply-From detection. When you Reply, rmfmail looks at the original message's To/Cc; if any address is on one of these domains (exact match OR any subdomain), Reply uses that address as the From. Default if omitted is just the domain of `email` above. Matching is case-insensitive. Subdomain folding is automatic — listing both `frankston.com` and `bobf.frankston.com` is the same as listing just `frankston.com` (the longer entry is dropped at load time). Different domains (`bobfrankston.com` vs `frankston.com` — distinct DNS, no subsumption) stay separate. Example: `"identityDomains": ["bob.ma", "bobfrankston.com", "frankston.com"]`.
 - **sig** — per-account signature for *new* messages (skipped on reply / forward / draft-resume). `text` is the plain-text body, HTML-escaped at insertion with `\n` → `<br>`. The optional `html` flag is reserved for "trust as raw HTML"; leave it `false` (or omit) for now. Specify either `sig` or `signature`, not both — `sig` wins if both are present and the message is new. May also be specified at the **file level** (alongside `name`) to apply across every account that doesn't define its own; per-account always wins over file-level.
 - **signature** — legacy alternative: an HTML string applied to *new + reply + forward* (positioned before the quote on replies, at the end for new messages). Useful when you want the signature on every outgoing message regardless of context. Also supported at the **file level** as a global fallback.
 - **keys.anthropic / keys.openai** — API keys for the AI features (translate / proofread / summarize / autocomplete). Lives at the file's top level alongside `accounts:` so you set it once across all your devices. Generated at console.anthropic.com or platform.openai.com. Provider selection is in `preferences.jsonc`; the key here is read based on which provider is active. Empty string means "not configured" — the AI feature silently no-ops. Local Ollama provider needs no key.

package/docs/multi-view.md

@@ -0,0 +1,81 @@
+# Multi-view: tabs, tear-off, separate windows
+
+Goal: multiple **views** over one backend — like Thunderbird/Outlook — so the
+user can keep a message open while working the list, compare two folders, etc.
+NOT multiple daemon instances (`--another` already exists for that, and a
+second daemon means a second DB connection — contention, not what's wanted).
+
+## Key fact: reminders already spawn separate native windows
+
+`MailxService.showReminderPopup` → injected `popupFn` → msger
+`showMessageBoxEx` opens a **real OS WebView window** fed a self-contained HTML
+document (`rawHtml: true`: the caller ships a full HTML doc with its own button
+row + an inline script that posts results back over the wry bridge). It returns
+a handle with `pid` + `close()`.
+
+Consequence: msger spawning extra native windows is **not** the blocker. The
+"popups don't inherit the custom protocol" limitation only blocks a window that
+must load the *multi-file app* (index.html + app.bundle.js + CSS + importmap
+deps, all served from `msger.localhost`). A **single rendered view** is
+self-contained content — the reminder shape.
+
+So:
+- **Torn-off READ-ONLY message reader** = the reminder mechanism. The daemon
+  already has rendered `bodyHtml` from `getMessage`; wrap header + sanitized
+  body as a standalone HTML doc, hand to `showMessageBoxEx`. No custom
+  protocol, no second IPC channel. Cheap.
+- **Torn-off INTERACTIVE view** (reply / navigate / delete / live sync
+  updates) needs a real IPC channel back to the daemon → msger multi-channel
+  work. Expensive. Deferred.
+
+## Three view modes, one backend
+
+1. **Tabs** inside the main window — one WebView, one IPC channel, a tab strip;
+   each tab is an independent three-pane (or a single-message view). Pure
+   client work.
+2. **Tear-off** — detach a tab into its own OS window.
+   - Read-only message tab → `showMessageBoxEx` + `rawHtml` (reminder path).
+   - Interactive tab → needs msger multi-channel IPC (later).
+3. **Re-dock** — drag a torn-off window's content back in as a tab. For the
+   read-only reader this is just: close the popup, re-open the message as an
+   in-window tab. For interactive, follows whatever (2) settles on.
+
+## Tabs architecture (the real work)
+
+Today the list view is module-level global state in `client/components/
+message-list.ts` — `currentAccountId`, `currentFolderId`, `searchMode`,
+`currentSearchQuery`, `positionMemory`, `listCache` — and `message-state.ts` is
+a single global "source of truth" for the list+viewer. One window = one view.
+
+Tabs require that view-state to become **per-tab**:
+
+- **Per-tab:** selected account+folder (or search), selected message, list
+  scroll position, the `message-state` instance, sort order, flagged-only
+  toggle.
+- **Shared (stays global):** the IPC connection + sync event stream, folder
+  counts, the contacts cache, settings, the parsed-body LRU on the daemon.
+  Sync/new-mail events broadcast to every tab; each tab decides if the event
+  touches its folder.
+
+Shape: a `TabManager` owning an array of `ViewTab`, each `ViewTab` holding its
+own `MessageListState` + the DOM subtree for its three-pane. Only the active
+tab's subtree is in layout; inactive tabs keep their DOM detached (cheap) or
+their state and rebuild on activate. `message-list.ts` functions take a
+`ViewTab` (or read `TabManager.active`) instead of the module globals.
+
+## Staging
+
+1. **Tab strip + per-tab three-pane.** Extract the message-list globals into a
+   `ViewTab`/`TabManager`; render a tab strip; New Tab opens another inbox
+   view. The bulk of the work and the architectural commit.
+2. **Open-in-new-tab** for a message (and a folder). Exercises per-tab state on
+   the simplest views.
+3. **Tear-off a read-only message tab** → `showMessageBoxEx` standalone window
+   (reminder mechanism). Re-dock = reopen as a tab.
+4. **Interactive tear-off / true second app window.** Needs msger to let a
+   spawned window inherit the custom protocol AND carry its own IPC channel,
+   plus the daemon multiplexing IPC and broadcasting events to N channels.
+   Separate, cross-component project — do last, only if the read-only
+   tear-off proves insufficient.
+
+Start at stage 1. Each stage is independently shippable.

package/docs/search.md

@@ -19,7 +19,7 @@ These are parsed by mailx before dispatch, so they apply to all three scopes:
 | `from:bob` | Match sender substring |
 | `to:eleanor` | Match recipient substring |
 | `subject:lunch` | Match subject substring (everything until the next `keyword:` or end) |
-| `/regex/` | Client-side regex over the currently-visible rows. Local only — never sent to the server. |
+| `/regex/` | Client-side regex over the currently-visible rows. **Case-insensitive.** Local only — never sent to the server. |
 
 The remaining (unqualified) text becomes the **body** search term in the server query, or a free-text FTS5 phrase in local mode.
 
@@ -80,6 +80,10 @@ So if you typed `bob AND eleanor` on bobma and got results, what likely happened
 
 That explains the asymmetry you may have noticed: `bob AND eleanor` "worked" against bobma (literal-text coincidence) but not against Gmail (no IMAP/API call ever fired).
 
+## Case sensitivity
+
+All three modes are **case-insensitive** — local FTS5, IMAP server SEARCH, and `/regex/` filtering alike. `Lunch`, `lunch`, and `LUNCH` match the same messages. There's no way to force a case-sensitive search.
+
 ## Limitations
 
 - **No regex on the server side** (any provider). `/pattern/` only filters the visible local rows.

package/index.d.ts

@@ -153,6 +153,13 @@ export declare function saveAutocomplete(settings: AutocompleteSettings): void;
 export declare function loadAllowlist(): typeof DEFAULT_ALLOWLIST;
 /** Save allow-list — merges with existing cloud copy (multi-client safe) */
 export declare function saveAllowlist(list: typeof DEFAULT_ALLOWLIST): Promise<void>;
+/** Load user-added dictionary words. Mirrored to GDrive so "Add to dictionary"
+ *  on one machine appears on every machine. Same multi-client merge pattern
+ *  as allowlist. Returns a string array; duplicates removed by saveUserDict. */
+export declare function loadUserDict(): string[];
+/** Save user dictionary — merges with cloud copy so concurrent edits on
+ *  different machines union rather than overwrite. */
+export declare function saveUserDict(words: string[]): Promise<void>;
 /** Load settings — unified view combining all files (backward compatible) */
 export declare function loadSettings(): MailxSettings;
 export declare function saveSettings(settings: MailxSettings): Promise<void>;

package/index.d.ts.map

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

package/index.js

@@ -1047,6 +1047,30 @@ export async function saveAllowlist(list) {
     catch { /* cloud read failed — save local version */ }
     saveFile("allowlist.jsonc", merged);
 }
+/** Load user-added dictionary words. Mirrored to GDrive so "Add to dictionary"
+ *  on one machine appears on every machine. Same multi-client merge pattern
+ *  as allowlist. Returns a string array; duplicates removed by saveUserDict. */
+export function loadUserDict() {
+    const raw = loadFile("userdict.jsonc", { words: [] });
+    return Array.isArray(raw?.words) ? raw.words : [];
+}
+/** Save user dictionary — merges with cloud copy so concurrent edits on
+ *  different machines union rather than overwrite. */
+export async function saveUserDict(words) {
+    let merged = [...new Set(words)];
+    try {
+        const cloudContent = await cloudRead("userdict.jsonc");
+        if (cloudContent) {
+            const cloud = parseJsonc(cloudContent);
+            if (cloud && Array.isArray(cloud.words)) {
+                merged = [...new Set([...merged, ...cloud.words])];
+            }
+        }
+    }
+    catch { /* cloud unreachable — save local version */ }
+    merged.sort();
+    saveFile("userdict.jsonc", { words: merged });
+}
 // ── Legacy compatibility ──
 function loadLegacySettings() {
     const config = readLocalConfig();
@@ -1249,11 +1273,24 @@ export async function deployDocs(appVersion) {
         console.log("  [docs] no docs/ dir found in package — skipping deploy");
         return;
     }
+    // Whitelist: only deploy docs that document a `.jsonc` config file or a
+    // user-facing feature. Internal release-notes / publishing playbooks
+    // (`prod.md`, `prod-android.md`, `npmglobalize-disttag.md`, `rmf-tiny.md`,
+    // `push-relay.md`, etc.) live in the same docs/ folder for developer
+    // reference but have no business on the user's GDrive.
+    // NOTE: only `.jsonc` config-file help belongs here. Feature help (search,
+    // editor, …) is HTML compiled into the client app — see
+    // client/help/*.ts — and must NOT be deployed as a `.md` doc.
+    const USER_DOC_WHITELIST = new Set([
+        "accounts.md", "allowlist.md", "clients.md", "config.md",
+        "contacts.md", "contact-rules.md", "preferences.md",
+        "editor.md",
+    ]);
     try {
         const deployedVersion = (await provider.read(".docs-version") || "").trim();
         if (deployedVersion === appVersion)
             return; // already up to date
-        const mdFiles = fs.readdirSync(docsDir).filter(f => f.endsWith(".md"));
+        const mdFiles = fs.readdirSync(docsDir).filter(f => f.endsWith(".md") && USER_DOC_WHITELIST.has(f));
         // Parallel cloud writes — each provider.write is independent.
         // The previous serial loop took ~5-10 s for the 9 .md files
         // because every write was one round-trip to GDrive. The doc-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-settings",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",
@@ -17,7 +17,7 @@
   },
   "license": "ISC",
   "dependencies": {
-    "@bobfrankston/mailx-types": "^0.1.11",
+    "@bobfrankston/mailx-types": "^0.1.15",
     "jsonc-parser": "^3.3.1"
   },
   "repository": {
@@ -33,7 +33,7 @@
   },
   ".transformedSnapshot": {
     "dependencies": {
-      "@bobfrankston/mailx-types": "^0.1.11",
+      "@bobfrankston/mailx-types": "^0.1.15",
       "jsonc-parser": "^3.3.1"
     }
   }