@bobfrankston/rmfmail 1.0.546 → 1.0.549

package/packages/mailx-service/sync-queue.ts

@@ -0,0 +1,134 @@
+/**
+ * SyncQueue — the formal enqueue surface for server-side mirroring of
+ * local actions.
+ *
+ * Local-first contract: every UI write commits to the local store first,
+ * then hands off here. Nothing in this file does network I/O; the
+ * Reconciler drains the queue.
+ *
+ * Implementation note: the underlying persistence already exists. Message
+ * ops live in `sync_actions` (drained by ImapManager.processSyncActions),
+ * non-message ops in `store_sync` (drained by the per-domain workers).
+ * This class is the public API surface — call sites switch to it so the
+ * architecture's seam is visible, the rules are enforceable, and we can
+ * later bolt on body-fetch / draft-push / send-push lanes without
+ * touching every call site again.
+ *
+ * Priority lanes (interactive > sync > prefetch > backfill) are tracked
+ * here as ordering hints; the actual scheduler is in the Reconciler.
+ *
+ * Part of docs/local-first-plan.md (steps 3-4).
+ */
+
+import type { MailxDB } from "@bobfrankston/mailx-store";
+import type { ImapManager } from "@bobfrankston/mailx-imap";
+
+export type Lane = "interactive" | "sync" | "prefetch" | "backfill";
+
+/** In-memory body-fetch dedupe + ordering. We keep this as a Set rather
+ *  than persisted rows because body fetches are idempotent (the file is
+ *  named after the (folder, uid) pair) and a re-fetch on next click is
+ *  cheap if a process crash drops the queued item. */
+interface BodyFetchKey { accountId: string; folderId: number; uid: number; lane: Lane; attempts: number }
+
+export class SyncQueue {
+    private bodyFetches = new Map<string, BodyFetchKey>();
+
+    constructor(
+        private db: MailxDB,
+        private imapManager: ImapManager,
+    ) {}
+
+    // ── Message-mirror enqueues (commit local DB row first; then call here) ──
+
+    /** Queue a server-side move. The local rows have already been moved in
+     *  the DB; the mirror reaches the server on the next reconciler pass. */
+    enqueueMove(accountId: string, uid: number, fromFolderId: number, toFolderId: number): void {
+        this.db.queueSyncAction(accountId, "move", uid, fromFolderId, { targetFolderId: toFolderId });
+        this.imapManager.processSyncActions(accountId).catch(() => { /* retried by reconciler */ });
+    }
+
+    /** Queue a server-side flag update (\Seen, \Flagged, \Answered, etc.). */
+    enqueueFlag(accountId: string, uid: number, folderId: number, flags: string[]): void {
+        this.db.queueSyncAction(accountId, "flags", uid, folderId, { flags });
+        this.imapManager.processSyncActions(accountId).catch(() => { /* retried */ });
+    }
+
+    /** Queue a server-side delete (or trash, depending on action). */
+    enqueueDelete(accountId: string, uid: number, folderId: number, kind: "delete" | "trash" = "delete"): void {
+        this.db.queueSyncAction(accountId, kind, uid, folderId, {});
+        this.imapManager.processSyncActions(accountId).catch(() => { /* retried */ });
+    }
+
+    /** Queue an IMAP APPEND of a draft body. Drafts already have crash
+     *  recovery via the editing/.eml on disk, so this lane is in-memory
+     *  fire-and-forget for now — the architectural value is centralizing
+     *  the call site, not adding a second on-disk store for the same
+     *  bytes. The reconciler retries on transient IMAP failure via the
+     *  existing sync_actions backoff after first failure. */
+    enqueueDraftPush(accountId: string, rawMessage: string, previousDraftUid?: number, draftId?: string): void {
+        this.imapManager.saveDraft(accountId, rawMessage, previousDraftUid, draftId).catch((e: any) => {
+            console.error(`  [sync-queue] draft push deferred (${draftId}): ${e?.message || e}`);
+            this.imapManager.emit("draftSaveDeferred", { accountId, draftId, error: String(e?.message || e) });
+        });
+    }
+
+    /** Queue an outbox send. Today the outbox/<acct>/*.ltr directory IS
+     *  the queue and a separate worker drains it; this seam is reserved
+     *  for when that worker moves under the reconciler. */
+    enqueueSend(_accountId: string, _outboxId: string): void {
+        // No-op — outbox dir-based queue stays as-is per plan decision #5.
+    }
+
+    // ── Body fetch lane (in-memory; idempotent) ──
+
+    /** Request a body fetch. Dedupes per (account, folder, uid). The
+     *  `lane` argument hints urgency: `interactive` is a click; `prefetch`
+     *  is the background backfiller; `backfill` is the one-time post-sync
+     *  catch-up. Reconciler picks higher priority first. */
+    enqueueBodyFetch(accountId: string, folderId: number, uid: number, lane: Lane = "interactive"): void {
+        const key = `${accountId}:${folderId}:${uid}`;
+        const existing = this.bodyFetches.get(key);
+        if (existing) {
+            // Upgrade lane if the new caller is more urgent.
+            const rank: Record<Lane, number> = { interactive: 0, sync: 1, prefetch: 2, backfill: 3 };
+            if (rank[lane] < rank[existing.lane]) existing.lane = lane;
+            return;
+        }
+        this.bodyFetches.set(key, { accountId, folderId, uid, lane, attempts: 0 });
+    }
+
+    /** Re-enqueue a transient failure — the reconciler calls this after a
+     *  fetch errored with a transient code. Returns `true` if the item was
+     *  put back in the queue (still under retry budget) or `false` if its
+     *  budget is exhausted (caller surfaces the error to the UI). */
+    requeueBodyFetch(key: BodyFetchKey, maxAttempts = 3): boolean {
+        if (key.attempts + 1 >= maxAttempts) return false;
+        const k = `${key.accountId}:${key.folderId}:${key.uid}`;
+        // Don't downgrade lane on retry; keep the one the original caller set.
+        this.bodyFetches.set(k, { ...key, attempts: key.attempts + 1 });
+        return true;
+    }
+
+    /** Pop the next body-fetch task at or above `maxLane`. Used by the
+     *  reconciler to drain interactive clicks before prefetch backfill. */
+    nextBodyFetch(maxLane: Lane = "backfill"): BodyFetchKey | null {
+        const rank: Record<Lane, number> = { interactive: 0, sync: 1, prefetch: 2, backfill: 3 };
+        const cap = rank[maxLane];
+        let best: BodyFetchKey | null = null;
+        for (const v of this.bodyFetches.values()) {
+            if (rank[v.lane] > cap) continue;
+            if (!best || rank[v.lane] < rank[best.lane]) best = v;
+        }
+        if (best) this.bodyFetches.delete(`${best.accountId}:${best.folderId}:${best.uid}`);
+        return best;
+    }
+
+    /** Pending count for diagnostics + the sync-status pill. */
+    pendingCount(): { messageActions: number; bodyFetches: number } {
+        return {
+            messageActions: this.db.getTotalPendingSyncCount(),
+            bodyFetches: this.bodyFetches.size,
+        };
+    }
+}

package/packages/mailx-settings/docs/contacts.md

@@ -18,7 +18,11 @@
   ],
   "discovered": [
     { "name": "Bob", "email": "bob@example.com", "useCount": 715, "lastUsed": 1777921829000 }
-  ]
+  ],
+  "groups": {
+    "Joes": ["joe@example.com", "jo@example.com"],
+    "Family": ["alice@example.com", "Joes"]
+  }
 }
 ```
 
@@ -27,6 +31,7 @@
 - **preferred** — manually-curated, top-ranked in autocomplete. Add people you actually want to reach quickly.
 - **denylist** — addresses (lowercased) excluded from autocomplete entirely.
 - **discovered** — auto-collected from sent/received mail. `useCount` × recency drives autocomplete ranking. Junk patterns (see below) are dropped at insertion.
+- **groups** — mailing lists. Type the group name in To/Cc/Bcc and compose expands it into the member addresses on send. Each value is an array of either email addresses (`"a@b.com"` or `"Name <a@b.com>"`) or other group names (recursive aliasing — cycles are detected, depth capped at 10). Group lookup is case-insensitive on the key. The two `Joes` example above plus the `Family` example show flat membership and one group nested inside another.
 
 ## Global junk filter
 

package/packages/mailx-settings/docs/search.md

@@ -0,0 +1,99 @@
+# Search
+
+> **Owned by rmfmail. Do not edit this file** — it's reference documentation.
+
+Search in rmfmail runs in one of three modes depending on what you've selected:
+
+- **All folders** (default) — searches your **local cache** using SQLite FTS5
+- **This folder** — instant client-side filter on visible rows; full FTS5 search on Enter
+- **Server** (the "Server" checkbox) — sends the query to the mail server (IMAP SEARCH on bobma-style accounts; **not yet wired to Gmail API for Gmail accounts** — see "Limitations" below)
+
+The mode you're in dictates which query operators work. Scope matters.
+
+## Common shortcuts (work in every mode)
+
+These are parsed by mailx before dispatch, so they apply to all three scopes:
+
+| Form | Effect |
+|---|---|
+| `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. |
+
+The remaining (unqualified) text becomes the **body** search term in the server query, or a free-text FTS5 phrase in local mode.
+
+## Mode 1: Local search (FTS5) — default
+
+Uses SQLite's FTS5 full-text index built from envelopes + locally-cached bodies. Fast, indexed, ~1ms per query.
+
+Supported FTS5 syntax (when the search box has more than one word and no scope checkbox):
+
+| Operator | Example | Meaning |
+|---|---|---|
+| `term1 term2` | `bob lunch` | both must appear (implicit AND) |
+| `term1 OR term2` | `bob OR eleanor` | either |
+| `term1 NOT term2` | `bob NOT spam` | first without the second |
+| `"phrase"` | `"happy birthday"` | exact phrase |
+| `term*` | `lunch*` | prefix |
+| `^col:term` | `^subject:budget` | restrict to one indexed column (subject, body, from, to) |
+| `NEAR(a b, 5)` | `NEAR(bob lunch, 5)` | both within 5 tokens of each other |
+
+**Case**: FTS5 is **case-insensitive**. `AND`/`OR`/`NOT` work in any case (`and`, `OR`, `Not` are equivalent).
+
+What's actually indexed: subject, from, to, cc, snippet (first ~200 chars of body), and the full body text *if* the body has been downloaded locally (the blue dot in the list). Bodies that haven't been prefetched aren't searchable until they are.
+
+## Mode 2: This-folder filter
+
+When the scope dropdown is set to "This folder" and you type, mailx **client-side filters the currently rendered rows** instantly — no server hit, no FTS5. Just substring match across each visible row's text.
+
+Press **Enter** to escalate to a full FTS5 search of the folder.
+
+`/regex/` works here for fast on-screen filtering.
+
+## Mode 3: Server search
+
+Tick the "Server" checkbox and the query goes to the mail server.
+
+### bobma / Dovecot (IMAP SEARCH)
+
+Standard IMAP keys, server-side. Combinable with implicit AND. mailx parses your `from:`, `to:`, `subject:` qualifiers and forwards them as IMAP keys; remaining text becomes a `BODY` search.
+
+| Key | Example | Meaning |
+|---|---|---|
+| `BODY <text>` | (default for unqualified words) | Substring of body |
+| `TEXT <text>` | (not exposed in the UI yet) | Substring of header + body |
+| `SUBJECT <text>` | `subject:budget` | Substring of subject |
+| `FROM <addr>` | `from:bob` | Substring of From line |
+| `TO <addr>` | `to:eleanor` | Substring of To line |
+| `SINCE <date>` | (not exposed) | RFC 822 date |
+
+**Case**: IMAP SEARCH is **case-insensitive** (per RFC 3501 §6.4.4). `bob AND eleanor` and `bob and eleanor` behave the same on Dovecot.
+
+**`AND` / `OR`**: IMAP's grammar is implicit-AND between keys. There's no literal `AND` keyword — typing `bob AND eleanor` would be sent as a body search for the literal three-word string. To OR keys you'd use IMAP's `OR <key1> <key2>` prefix syntax, which mailx doesn't expose in the UI today.
+
+So if you typed `bob AND eleanor` on bobma and got results, what likely happened is the body literally contained the string "bob and eleanor" (case-insensitive). Apparent "AND" success is coincidence with the literal text.
+
+### Gmail (server-search currently unwired)
+
+`searchAndFetchOnServer` is IMAP-only and `withConnection` doesn't exist for Gmail-API accounts. Server-scope queries on Gmail today **return nothing new** — they only hit local cache. This is a known gap; the fix is to add a Gmail-API path that uses Google's `q=` query parameter (full Gmail search syntax: `from:`, `subject:`, `has:attachment`, `older_than:1y`, `label:`, etc., with proper boolean `AND`/`OR`).
+
+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).
+
+## Limitations
+
+- **No regex on the server side** (any provider). `/pattern/` only filters the visible local rows.
+- **Server search results are stored locally** (envelope-only) on first hit. So a server search is also a backfill of envelopes for those messages — they appear next to local results without re-fetching.
+- **Body search on bodies you haven't prefetched** only works server-side. The local FTS5 index can't search what isn't downloaded.
+
+## Practical patterns
+
+| Goal | What to type | Scope |
+|---|---|---|
+| Quick keyword in current folder | `lunch` | This folder (instant) |
+| All-time mail from someone | `from:bob.frankston@example.com` | All folders (FTS5) |
+| Mail mentioning two people | `bob eleanor` | All folders (FTS5; implicit AND) |
+| Either of two terms | `bob OR eleanor` | All folders (FTS5) |
+| Exact phrase | `"open source"` | All folders (FTS5) |
+| Regex over what's on screen | `/^Re: \[mailx\]/` | Any (client-side) |
+| Old mail beyond `historyDays` | type query, then check the **Server** checkbox | Server (Dovecot only today) |

package/packages/mailx-settings/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-settings",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",

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

@@ -28,6 +28,12 @@ export declare class FileMessageStore implements MessageStore {
      *  it in `body_path`. The (folderId, uid) args are kept for interface
      *  compatibility; they do NOT affect the filename. */
     putMessage(accountId: string, _folderId: number, _uid: number, raw: Buffer): Promise<string>;
+    /** Resolve a stored body_path (relative or absolute) to an absolute
+     *  filesystem path. Returns "" if the input doesn't resolve to a file
+     *  inside the store. UI / "Source" actions need the absolute path so
+     *  they can open / pass it to OS file pickers without re-introducing
+     *  the basePath context every time. */
+    absolutePath(stored: string): string;
     /** Read by stored path (relative or absolute). */
     readByPath(stored: string): Promise<Buffer>;
     hasByPath(stored: string): Promise<boolean>;

package/packages/mailx-store/file-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["file-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,qBAAa,gBAAiB,YAAW,YAAY;IACrC,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAIpC;;;sCAGkC;IAClC,OAAO,CAAC,eAAe;IAMvB;;;gDAG4C;IAC5C,OAAO,CAAC,aAAa;IAQrB;;0DAEsD;IAChD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlG,kDAAkD;IAC5C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD;;;;;;;;;uDASmD;IACnD,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EAC7C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM;IA6BjF,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAGrE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGhF,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAGjF,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1F"}
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["file-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,qBAAa,gBAAiB,YAAW,YAAY;IACrC,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAIpC;;;sCAGkC;IAClC,OAAO,CAAC,eAAe;IAMvB;;;gDAG4C;IAC5C,OAAO,CAAC,aAAa;IAQrB;;0DAEsD;IAChD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlG;;;;2CAIuC;IACvC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIpC,kDAAkD;IAC5C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD;;;;;;;;;uDASmD;IACnD,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EAC7C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM;IA6BjF,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAGrE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGhF,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAGjF,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1F"}

package/packages/mailx-store/file-store.js

@@ -51,6 +51,14 @@ export class FileMessageStore {
         fs.writeFileSync(abs, raw);
         return rel;
     }
+    /** Resolve a stored body_path (relative or absolute) to an absolute
+     *  filesystem path. Returns "" if the input doesn't resolve to a file
+     *  inside the store. UI / "Source" actions need the absolute path so
+     *  they can open / pass it to OS file pickers without re-introducing
+     *  the basePath context every time. */
+    absolutePath(stored) {
+        return this.resolveStored(stored);
+    }
     /** Read by stored path (relative or absolute). */
     async readByPath(stored) {
         const abs = this.resolveStored(stored);

package/packages/mailx-store/file-store.js.map

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

package/packages/mailx-store/file-store.ts

@@ -54,6 +54,15 @@ export class FileMessageStore implements MessageStore {
         return rel;
     }
 
+    /** Resolve a stored body_path (relative or absolute) to an absolute
+     *  filesystem path. Returns "" if the input doesn't resolve to a file
+     *  inside the store. UI / "Source" actions need the absolute path so
+     *  they can open / pass it to OS file pickers without re-introducing
+     *  the basePath context every time. */
+    absolutePath(stored: string): string {
+        return this.resolveStored(stored);
+    }
+
     /** Read by stored path (relative or absolute). */
     async readByPath(stored: string): Promise<Buffer> {
         const abs = this.resolveStored(stored);

package/packages/mailx-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-store",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",