@bobfrankston/rmfmail 1.0.546 → 1.0.549

package/packages/mailx-service/reconciler.js

@@ -0,0 +1,209 @@
+/**
+ * Reconciler — single background loop that drains the SyncQueue, polls
+ * for server changes, and emits state events the UI listens for.
+ *
+ * Local-first contract: the Reconciler is the ONLY code path that touches
+ * IMAP / Gmail API on behalf of UI actions. UI handlers commit locally
+ * and enqueue; the Reconciler picks up and mirrors. Reads from the UI
+ * never await the Reconciler.
+ *
+ * What this owns today:
+ * - body-fetch lane: drains `SyncQueue.nextBodyFetch()`, calls
+ *   `imapManager.fetchMessageBody`, emits `bodyAvailable` / `bodyFetchError`.
+ *   This is the new piece; previously body fetches happened inline on
+ *   every getMessage call.
+ * - sync-state pill events: emits `syncStateChanged` so the UI can show
+ *   "Sync OK / Syncing N items".
+ *
+ * What it delegates (intentional — no duplication):
+ * - message-action drain: ImapManager already runs a 30s actionsInterval
+ *   that processes both outbox (processSendActions) and sync_actions
+ *   (processSyncActions) per account. Per plan decision #5, outbox stays
+ *   under ImapManager; we don't fork that work.
+ * - poll loops (per-account quick check, full sync, prefetch, tombstone
+ *   prune): all owned by ImapManager's startPeriodicSync. The Reconciler
+ *   does NOT shadow them — back-pressure on those timers can be added
+ *   later via a single `setBackPressure(level)` hook.
+ *
+ * Part of docs/local-first-plan.md (step 4).
+ */
+const DEFAULTS = {
+    bodyFetchConcurrency: 2,
+    statusEmitIntervalMs: 5_000,
+    prefetchIntervalMs: 60_000,
+    prefetchInitialDelayMs: 2_000,
+    prefetchBackpressureThreshold: 1,
+    tombstonePruneIntervalMs: 3600_000, // hourly
+    tombstoneRetentionDays: 30,
+};
+export class Reconciler {
+    db;
+    imapManager;
+    queue;
+    opts;
+    running = false;
+    statusTimer = null;
+    prefetchTimer = null;
+    tombstoneTimer = null;
+    inFlightFetches = 0;
+    /** Last status payload — used to suppress no-op syncStateChanged events.
+     *  During a heavy multi-folder sync the 5s tick fires a lot of identical
+     *  events; the WebView's event handler runs DOM work for each, which
+     *  stacks up under load. Diff-only emits keep the channel quiet. */
+    lastStatus = { messageActions: -1, bodyFetches: -1, inFlightFetches: -1 };
+    constructor(db, imapManager, queue, opts = {}) {
+        this.db = db;
+        this.imapManager = imapManager;
+        this.queue = queue;
+        this.opts = { ...DEFAULTS, ...opts };
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        // Status pill: emit current totals every few seconds so the UI
+        // can show "Syncing N items" without polling. Diff-only — emit
+        // ONLY when something actually changed since the last tick so
+        // we don't pipe a constant idle stream through the WebView's
+        // event channel during a heavy sync (where the WebView main
+        // thread is already busy painting list updates).
+        this.statusTimer = setInterval(() => {
+            const counts = this.queue.pendingCount();
+            const next = { ...counts, inFlightFetches: this.inFlightFetches };
+            if (next.messageActions === this.lastStatus.messageActions
+                && next.bodyFetches === this.lastStatus.bodyFetches
+                && next.inFlightFetches === this.lastStatus.inFlightFetches) {
+                return;
+            }
+            this.lastStatus = next;
+            this.imapManager.emit("syncStateChanged", next);
+        }, this.opts.statusEmitIntervalMs);
+        // Periodic prefetch tick — owned here (not in ImapManager) so it
+        // can back off when the interactive body-fetch lane has work.
+        // First tick fires soon after startup so "not downloaded" dots
+        // start filling in promptly.
+        const prefetchTick = () => this.runPrefetchTick();
+        setTimeout(prefetchTick, this.opts.prefetchInitialDelayMs);
+        this.prefetchTimer = setInterval(prefetchTick, this.opts.prefetchIntervalMs);
+        // Tombstone prune — bookkeeping only. Trivial cost (one indexed
+        // DELETE per hour), kept off the IMAP-touching code path because
+        // it has nothing to do with sync.
+        const pruneTick = () => this.runTombstonePrune();
+        setTimeout(pruneTick, 30_000); // first run after startup settles
+        this.tombstoneTimer = setInterval(pruneTick, this.opts.tombstonePruneIntervalMs);
+        // Kick the body-fetch loop.
+        this.pumpBodyFetches();
+    }
+    stop() {
+        this.running = false;
+        if (this.statusTimer) {
+            clearInterval(this.statusTimer);
+            this.statusTimer = null;
+        }
+        if (this.prefetchTimer) {
+            clearInterval(this.prefetchTimer);
+            this.prefetchTimer = null;
+        }
+        if (this.tombstoneTimer) {
+            clearInterval(this.tombstoneTimer);
+            this.tombstoneTimer = null;
+        }
+    }
+    /** Hourly bookkeeping — drop tombstones older than the retention window
+     *  so the deleted-message lookup stays fast. */
+    runTombstonePrune() {
+        const cutoff = Date.now() - this.opts.tombstoneRetentionDays * 86400_000;
+        const n = this.db.pruneTombstones(cutoff);
+        if (n > 0)
+            console.log(`  [tombstones] pruned ${n} older than ${this.opts.tombstoneRetentionDays} days`);
+    }
+    /** Fire prefetchBodies on each account unless the interactive body-fetch
+     *  lane has user-clicked work pending — in which case skip this tick.
+     *  ImapManager's per-account `prefetchingAccounts` guard de-dupes if
+     *  the previous tick is still in flight. */
+    runPrefetchTick() {
+        if (!this.running)
+            return;
+        const counts = this.queue.pendingCount();
+        if (counts.bodyFetches >= this.opts.prefetchBackpressureThreshold) {
+            // Interactive work pending — let it drain. Next tick reconsiders.
+            return;
+        }
+        for (const acct of this.db.getAccounts()) {
+            this.imapManager.prefetchBodies(acct.id).catch(e => console.error(`  [prefetch] ${acct.id}: ${e?.message || e}`));
+        }
+    }
+    /** User-visible "sync now" — runs an immediate poll on all accounts
+     *  (or just one) without waiting for the next periodic tick. */
+    syncNow(accountId) {
+        const accts = accountId ? [{ id: accountId }] : this.db.getAccounts();
+        for (const a of accts) {
+            this.imapManager.processSyncActions(a.id).catch(() => { });
+        }
+    }
+    /** Drain the body-fetch lane up to `bodyFetchConcurrency`. Each
+     *  fetch is fire-and-forget; on completion it kicks the pump again
+     *  so a queue that grows during work stays drained. */
+    pumpBodyFetches() {
+        if (!this.running)
+            return;
+        while (this.inFlightFetches < this.opts.bodyFetchConcurrency) {
+            const next = this.queue.nextBodyFetch();
+            if (!next)
+                return;
+            this.inFlightFetches++;
+            (async () => {
+                try {
+                    const raw = await this.imapManager.fetchMessageBody(next.accountId, next.folderId, next.uid);
+                    if (raw) {
+                        this.imapManager.emit("bodyAvailable", {
+                            accountId: next.accountId, folderId: next.folderId, uid: next.uid,
+                        });
+                    }
+                }
+                catch (err) {
+                    if (err?.isNotFound) {
+                        try {
+                            this.db.deleteMessage(next.accountId, next.uid);
+                            this.db.recalcFolderCounts(next.folderId);
+                            this.imapManager.emit("messageRemoved", {
+                                accountId: next.accountId, folderId: next.folderId, uid: next.uid,
+                            });
+                        }
+                        catch { /* */ }
+                    }
+                    else {
+                        const msg = err?.message || "body fetch failed";
+                        const transient = /connection|Too many|UNAVAILABLE|rate|429|5\d\d|timeout|ENOTFOUND|ECONNRESET|ETIMEDOUT/i.test(msg);
+                        // Transient: re-enqueue (budget=3) so the next pump
+                        // tick retries. Surface the error only when the
+                        // budget is exhausted — otherwise we'd flash banners
+                        // for every blip on a slow server.
+                        if (transient && this.queue.requeueBodyFetch(next)) {
+                            // Backoff so we don't immediately re-hit the same
+                            // wedge. Body-fetch lane is in-memory; setTimeout
+                            // is fine.
+                            const backoffMs = 500 * Math.pow(2, next.attempts);
+                            setTimeout(() => this.pumpBodyFetches(), backoffMs);
+                        }
+                        else {
+                            this.imapManager.emit("bodyFetchError", {
+                                accountId: next.accountId, folderId: next.folderId, uid: next.uid,
+                                error: msg, transient,
+                            });
+                        }
+                    }
+                }
+                finally {
+                    this.inFlightFetches--;
+                    this.pumpBodyFetches();
+                }
+            })();
+        }
+    }
+    /** External nudge — call after enqueueing a high-priority body fetch. */
+    kick() {
+        this.pumpBodyFetches();
+    }
+}
+//# sourceMappingURL=reconciler.js.map

package/packages/mailx-service/reconciler.js.map

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

package/packages/mailx-service/reconciler.ts

@@ -0,0 +1,230 @@
+/**
+ * Reconciler — single background loop that drains the SyncQueue, polls
+ * for server changes, and emits state events the UI listens for.
+ *
+ * Local-first contract: the Reconciler is the ONLY code path that touches
+ * IMAP / Gmail API on behalf of UI actions. UI handlers commit locally
+ * and enqueue; the Reconciler picks up and mirrors. Reads from the UI
+ * never await the Reconciler.
+ *
+ * What this owns today:
+ * - body-fetch lane: drains `SyncQueue.nextBodyFetch()`, calls
+ *   `imapManager.fetchMessageBody`, emits `bodyAvailable` / `bodyFetchError`.
+ *   This is the new piece; previously body fetches happened inline on
+ *   every getMessage call.
+ * - sync-state pill events: emits `syncStateChanged` so the UI can show
+ *   "Sync OK / Syncing N items".
+ *
+ * What it delegates (intentional — no duplication):
+ * - message-action drain: ImapManager already runs a 30s actionsInterval
+ *   that processes both outbox (processSendActions) and sync_actions
+ *   (processSyncActions) per account. Per plan decision #5, outbox stays
+ *   under ImapManager; we don't fork that work.
+ * - poll loops (per-account quick check, full sync, prefetch, tombstone
+ *   prune): all owned by ImapManager's startPeriodicSync. The Reconciler
+ *   does NOT shadow them — back-pressure on those timers can be added
+ *   later via a single `setBackPressure(level)` hook.
+ *
+ * Part of docs/local-first-plan.md (step 4).
+ */
+
+import type { ImapManager } from "@bobfrankston/mailx-imap";
+import type { MailxDB } from "@bobfrankston/mailx-store";
+import type { SyncQueue } from "./sync-queue.js";
+
+export interface ReconcilerOptions {
+    /** Max concurrent body fetches across all accounts (in addition to
+     *  per-account semaphore in ImapManager). Keeps the interactive lane
+     *  responsive even when prefetch is hammering. */
+    bodyFetchConcurrency?: number;
+    /** Periodic emit of syncStateChanged — drives the UI status pill. */
+    statusEmitIntervalMs?: number;
+    /** How often to fire the prefetch tick. Default 60s. */
+    prefetchIntervalMs?: number;
+    /** First prefetch fires this soon after start so the "not downloaded"
+     *  dots fill in without making the user wait a minute. */
+    prefetchInitialDelayMs?: number;
+    /** Skip prefetch when the interactive body-fetch lane has at least
+     *  this many items pending. Back-pressure keeps clicks responsive. */
+    prefetchBackpressureThreshold?: number;
+    /** Tombstone prune interval — bookkeeping only, hourly default. */
+    tombstonePruneIntervalMs?: number;
+    /** Tombstone retention — local-delete records older than this are
+     *  removed by the periodic prune. */
+    tombstoneRetentionDays?: number;
+}
+
+const DEFAULTS: Required<ReconcilerOptions> = {
+    bodyFetchConcurrency: 2,
+    statusEmitIntervalMs: 5_000,
+    prefetchIntervalMs: 60_000,
+    prefetchInitialDelayMs: 2_000,
+    prefetchBackpressureThreshold: 1,
+    tombstonePruneIntervalMs: 3600_000,   // hourly
+    tombstoneRetentionDays: 30,
+};
+
+export class Reconciler {
+    private opts: Required<ReconcilerOptions>;
+    private running = false;
+    private statusTimer: ReturnType<typeof setInterval> | null = null;
+    private prefetchTimer: ReturnType<typeof setInterval> | null = null;
+    private tombstoneTimer: ReturnType<typeof setInterval> | null = null;
+    private inFlightFetches = 0;
+    /** Last status payload — used to suppress no-op syncStateChanged events.
+     *  During a heavy multi-folder sync the 5s tick fires a lot of identical
+     *  events; the WebView's event handler runs DOM work for each, which
+     *  stacks up under load. Diff-only emits keep the channel quiet. */
+    private lastStatus = { messageActions: -1, bodyFetches: -1, inFlightFetches: -1 };
+
+    constructor(
+        private db: MailxDB,
+        private imapManager: ImapManager,
+        private queue: SyncQueue,
+        opts: ReconcilerOptions = {},
+    ) {
+        this.opts = { ...DEFAULTS, ...opts };
+    }
+
+    start(): void {
+        if (this.running) return;
+        this.running = true;
+
+        // Status pill: emit current totals every few seconds so the UI
+        // can show "Syncing N items" without polling. Diff-only — emit
+        // ONLY when something actually changed since the last tick so
+        // we don't pipe a constant idle stream through the WebView's
+        // event channel during a heavy sync (where the WebView main
+        // thread is already busy painting list updates).
+        this.statusTimer = setInterval(() => {
+            const counts = this.queue.pendingCount();
+            const next = { ...counts, inFlightFetches: this.inFlightFetches };
+            if (next.messageActions === this.lastStatus.messageActions
+                && next.bodyFetches === this.lastStatus.bodyFetches
+                && next.inFlightFetches === this.lastStatus.inFlightFetches) {
+                return;
+            }
+            this.lastStatus = next;
+            this.imapManager.emit("syncStateChanged", next);
+        }, this.opts.statusEmitIntervalMs);
+
+        // Periodic prefetch tick — owned here (not in ImapManager) so it
+        // can back off when the interactive body-fetch lane has work.
+        // First tick fires soon after startup so "not downloaded" dots
+        // start filling in promptly.
+        const prefetchTick = (): void => this.runPrefetchTick();
+        setTimeout(prefetchTick, this.opts.prefetchInitialDelayMs);
+        this.prefetchTimer = setInterval(prefetchTick, this.opts.prefetchIntervalMs);
+
+        // Tombstone prune — bookkeeping only. Trivial cost (one indexed
+        // DELETE per hour), kept off the IMAP-touching code path because
+        // it has nothing to do with sync.
+        const pruneTick = (): void => this.runTombstonePrune();
+        setTimeout(pruneTick, 30_000);   // first run after startup settles
+        this.tombstoneTimer = setInterval(pruneTick, this.opts.tombstonePruneIntervalMs);
+
+        // Kick the body-fetch loop.
+        this.pumpBodyFetches();
+    }
+
+    stop(): void {
+        this.running = false;
+        if (this.statusTimer) { clearInterval(this.statusTimer); this.statusTimer = null; }
+        if (this.prefetchTimer) { clearInterval(this.prefetchTimer); this.prefetchTimer = null; }
+        if (this.tombstoneTimer) { clearInterval(this.tombstoneTimer); this.tombstoneTimer = null; }
+    }
+
+    /** Hourly bookkeeping — drop tombstones older than the retention window
+     *  so the deleted-message lookup stays fast. */
+    private runTombstonePrune(): void {
+        const cutoff = Date.now() - this.opts.tombstoneRetentionDays * 86400_000;
+        const n = this.db.pruneTombstones(cutoff);
+        if (n > 0) console.log(`  [tombstones] pruned ${n} older than ${this.opts.tombstoneRetentionDays} days`);
+    }
+
+    /** Fire prefetchBodies on each account unless the interactive body-fetch
+     *  lane has user-clicked work pending — in which case skip this tick.
+     *  ImapManager's per-account `prefetchingAccounts` guard de-dupes if
+     *  the previous tick is still in flight. */
+    private runPrefetchTick(): void {
+        if (!this.running) return;
+        const counts = this.queue.pendingCount();
+        if (counts.bodyFetches >= this.opts.prefetchBackpressureThreshold) {
+            // Interactive work pending — let it drain. Next tick reconsiders.
+            return;
+        }
+        for (const acct of this.db.getAccounts()) {
+            this.imapManager.prefetchBodies(acct.id).catch(e =>
+                console.error(`  [prefetch] ${acct.id}: ${e?.message || e}`)
+            );
+        }
+    }
+
+    /** User-visible "sync now" — runs an immediate poll on all accounts
+     *  (or just one) without waiting for the next periodic tick. */
+    syncNow(accountId?: string): void {
+        const accts = accountId ? [{ id: accountId }] : this.db.getAccounts();
+        for (const a of accts) {
+            this.imapManager.processSyncActions(a.id).catch(() => { /* */ });
+        }
+    }
+
+    /** Drain the body-fetch lane up to `bodyFetchConcurrency`. Each
+     *  fetch is fire-and-forget; on completion it kicks the pump again
+     *  so a queue that grows during work stays drained. */
+    private pumpBodyFetches(): void {
+        if (!this.running) return;
+        while (this.inFlightFetches < this.opts.bodyFetchConcurrency) {
+            const next = this.queue.nextBodyFetch();
+            if (!next) return;
+            this.inFlightFetches++;
+            (async () => {
+                try {
+                    const raw = await this.imapManager.fetchMessageBody(next.accountId, next.folderId, next.uid);
+                    if (raw) {
+                        this.imapManager.emit("bodyAvailable", {
+                            accountId: next.accountId, folderId: next.folderId, uid: next.uid,
+                        });
+                    }
+                } catch (err: any) {
+                    if (err?.isNotFound) {
+                        try {
+                            this.db.deleteMessage(next.accountId, next.uid);
+                            this.db.recalcFolderCounts(next.folderId);
+                            this.imapManager.emit("messageRemoved", {
+                                accountId: next.accountId, folderId: next.folderId, uid: next.uid,
+                            });
+                        } catch { /* */ }
+                    } else {
+                        const msg = err?.message || "body fetch failed";
+                        const transient = /connection|Too many|UNAVAILABLE|rate|429|5\d\d|timeout|ENOTFOUND|ECONNRESET|ETIMEDOUT/i.test(msg);
+                        // Transient: re-enqueue (budget=3) so the next pump
+                        // tick retries. Surface the error only when the
+                        // budget is exhausted — otherwise we'd flash banners
+                        // for every blip on a slow server.
+                        if (transient && this.queue.requeueBodyFetch(next)) {
+                            // Backoff so we don't immediately re-hit the same
+                            // wedge. Body-fetch lane is in-memory; setTimeout
+                            // is fine.
+                            const backoffMs = 500 * Math.pow(2, next.attempts);
+                            setTimeout(() => this.pumpBodyFetches(), backoffMs);
+                        } else {
+                            this.imapManager.emit("bodyFetchError", {
+                                accountId: next.accountId, folderId: next.folderId, uid: next.uid,
+                                error: msg, transient,
+                            });
+                        }
+                    }
+                } finally {
+                    this.inFlightFetches--;
+                    this.pumpBodyFetches();
+                }
+            })();
+        }
+    }
+
+    /** External nudge — call after enqueueing a high-priority body fetch. */
+    kick(): void {
+        this.pumpBodyFetches();
+    }
+}

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

@@ -0,0 +1,79 @@
+/**
+ * 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 declare class SyncQueue {
+    private db;
+    private imapManager;
+    private bodyFetches;
+    constructor(db: MailxDB, imapManager: ImapManager);
+    /** 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;
+    /** Queue a server-side flag update (\Seen, \Flagged, \Answered, etc.). */
+    enqueueFlag(accountId: string, uid: number, folderId: number, flags: string[]): void;
+    /** Queue a server-side delete (or trash, depending on action). */
+    enqueueDelete(accountId: string, uid: number, folderId: number, kind?: "delete" | "trash"): void;
+    /** 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;
+    /** 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;
+    /** 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): void;
+    /** 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?: number): boolean;
+    /** Pop the next body-fetch task at or above `maxLane`. Used by the
+     *  reconciler to drain interactive clicks before prefetch backfill. */
+    nextBodyFetch(maxLane?: Lane): BodyFetchKey | null;
+    /** Pending count for diagnostics + the sync-status pill. */
+    pendingCount(): {
+        messageActions: number;
+        bodyFetches: number;
+    };
+}
+export {};
+//# sourceMappingURL=sync-queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-queue.d.ts","sourceRoot":"","sources":["sync-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,MAAM,IAAI,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpE;;;sDAGsD;AACtD,UAAU,YAAY;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAEzG,qBAAa,SAAS;IAId,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,WAAW;IAJvB,OAAO,CAAC,WAAW,CAAmC;gBAG1C,EAAE,EAAE,OAAO,EACX,WAAW,EAAE,WAAW;IAKpC;6EACyE;IACzE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAK3F,0EAA0E;IAC1E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKpF,kEAAkE;IAClE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,QAAQ,GAAG,OAAkB,GAAG,IAAI;IAK1G;;;;;6DAKyD;IACzD,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1G;;2DAEuD;IACvD,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAMxD;;;4DAGwD;IACxD,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,IAAI;IAYpG;;;qEAGiE;IACjE,gBAAgB,CAAC,GAAG,EAAE,YAAY,EAAE,WAAW,SAAI,GAAG,OAAO;IAQ7D;2EACuE;IACvE,aAAa,CAAC,OAAO,GAAE,IAAiB,GAAG,YAAY,GAAG,IAAI;IAY9D,4DAA4D;IAC5D,YAAY,IAAI;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;CAMlE"}

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

@@ -0,0 +1,118 @@
+/**
+ * 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).
+ */
+export class SyncQueue {
+    db;
+    imapManager;
+    bodyFetches = new Map();
+    constructor(db, imapManager) {
+        this.db = db;
+        this.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, uid, fromFolderId, toFolderId) {
+        this.db.queueSyncAction(accountId, "move", uid, fromFolderId, { targetFolderId: toFolderId });
+        this.imapManager.processSyncActions(accountId).catch(() => { });
+    }
+    /** Queue a server-side flag update (\Seen, \Flagged, \Answered, etc.). */
+    enqueueFlag(accountId, uid, folderId, flags) {
+        this.db.queueSyncAction(accountId, "flags", uid, folderId, { flags });
+        this.imapManager.processSyncActions(accountId).catch(() => { });
+    }
+    /** Queue a server-side delete (or trash, depending on action). */
+    enqueueDelete(accountId, uid, folderId, kind = "delete") {
+        this.db.queueSyncAction(accountId, kind, uid, folderId, {});
+        this.imapManager.processSyncActions(accountId).catch(() => { });
+    }
+    /** 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, rawMessage, previousDraftUid, draftId) {
+        this.imapManager.saveDraft(accountId, rawMessage, previousDraftUid, draftId).catch((e) => {
+            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, _outboxId) {
+        // 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, folderId, uid, lane = "interactive") {
+        const key = `${accountId}:${folderId}:${uid}`;
+        const existing = this.bodyFetches.get(key);
+        if (existing) {
+            // Upgrade lane if the new caller is more urgent.
+            const rank = { 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, maxAttempts = 3) {
+        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 = "backfill") {
+        const rank = { interactive: 0, sync: 1, prefetch: 2, backfill: 3 };
+        const cap = rank[maxLane];
+        let best = 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() {
+        return {
+            messageActions: this.db.getTotalPendingSyncCount(),
+            bodyFetches: this.bodyFetches.size,
+        };
+    }
+}
+//# sourceMappingURL=sync-queue.js.map

package/packages/mailx-service/sync-queue.js.map

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