@bobfrankston/mailx 1.0.451 → 1.0.453

package/client/compose/ghost-text.ts

@@ -0,0 +1,140 @@
+/**
+ * Ghost text autocomplete — shows AI suggestions as translucent overlay at cursor.
+ * Tab accepts, Escape dismisses, any other key dismisses and re-triggers after debounce.
+ * Editor-agnostic: works with both Quill and tiptap via MailxEditor interface.
+ */
+
+import type { MailxEditor } from "./editor.js";
+import { autocomplete } from "../lib/api-client.js";
+
+interface GhostTextContext {
+    getSubject: () => string;
+    getTo: () => string;
+}
+
+let ghostEl: HTMLElement | null = null;
+let currentSuggestion: string | null = null;
+let debounceTimer: ReturnType<typeof setTimeout> | null = null;
+let abortController: AbortController | null = null;
+let activeEditor: MailxEditor | null = null;
+let debounceMs = 600;
+
+function dismiss(): void {
+    currentSuggestion = null;
+    if (ghostEl) {
+        ghostEl.remove();
+        ghostEl = null;
+    }
+}
+
+function positionGhost(editor: MailxEditor, text: string): void {
+    dismiss();
+
+    const sel = window.getSelection();
+    if (!sel || sel.rangeCount === 0 || !sel.isCollapsed) return;
+
+    const range = sel.getRangeAt(0);
+    let rect = range.getBoundingClientRect();
+
+    // Collapsed range may return zero-width rect — use a temp span to measure
+    if (rect.width === 0 && rect.height === 0) {
+        const span = document.createElement("span");
+        span.textContent = "\u200B"; // zero-width space
+        range.insertNode(span);
+        rect = span.getBoundingClientRect();
+        span.remove();
+        // Restore selection
+        sel.removeAllRanges();
+        sel.addRange(range);
+    }
+
+    const container = editor.getScrollContainer();
+    const containerRect = container.getBoundingClientRect();
+
+    ghostEl = document.createElement("span");
+    ghostEl.className = "ghost-text";
+    ghostEl.textContent = text;
+    ghostEl.style.top = `${rect.top - containerRect.top + container.scrollTop}px`;
+    ghostEl.style.left = `${rect.left - containerRect.left + container.scrollLeft}px`;
+    container.appendChild(ghostEl);
+
+    currentSuggestion = text;
+}
+
+function requestSuggestion(editor: MailxEditor, context: GhostTextContext): void {
+    // Cancel any in-flight request
+    if (abortController) {
+        abortController.abort();
+        abortController = null;
+    }
+
+    const bodyText = editor.getText();
+    if (!bodyText || bodyText.trim().length < 3) return; // need at least a few characters
+
+    abortController = new AbortController();
+    const signal = abortController.signal;
+
+    autocomplete({
+        subject: context.getSubject(),
+        to: context.getTo(),
+        bodyText,
+        cursorOffset: bodyText.length,
+    }, signal).then((result: any) => {
+        if (signal.aborted) return;
+        if (result.suggestion) {
+            positionGhost(editor, result.suggestion);
+        }
+    }).catch((e: any) => {
+        if (e.name === "AbortError") return;
+        // Silently ignore autocomplete errors
+    });
+}
+
+export function initGhostText(editor: MailxEditor, context: GhostTextContext, options?: { debounceMs?: number }): void {
+    activeEditor = editor;
+    if (options?.debounceMs) debounceMs = options.debounceMs;
+
+    // Debounced content change → request suggestion
+    editor.onContentChange(() => {
+        dismiss();
+        if (debounceTimer) clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+            requestSuggestion(editor, context);
+        }, debounceMs);
+    });
+
+    // Key handler: Tab accepts, Escape dismisses
+    editor.onKeyDown((e: KeyboardEvent) => {
+        if (!currentSuggestion) return;
+
+        if (e.key === "Tab") {
+            e.preventDefault();
+            e.stopPropagation();
+            const text = currentSuggestion;
+            dismiss();
+            editor.insertTextAtCursor(text);
+            return;
+        }
+
+        if (e.key === "Escape") {
+            e.preventDefault();
+            e.stopPropagation();
+            dismiss();
+            return;
+        }
+
+        // Any other key: dismiss (new suggestion will come after debounce)
+        dismiss();
+    });
+
+    // Dismiss on blur/scroll
+    editor.root.addEventListener("blur", dismiss);
+    editor.getScrollContainer().addEventListener("scroll", dismiss);
+}
+
+export function destroyGhostText(): void {
+    dismiss();
+    if (debounceTimer) clearTimeout(debounceTimer);
+    if (abortController) abortController.abort();
+    activeEditor = null;
+}

package/client/index.html

@@ -104,6 +104,7 @@
             <button class="rail-btn" id="rail-tasks" title="Tasks" aria-label="Tasks">☑</button>
         </div>
         <div class="rail-bottom">
+            <button class="rail-btn" id="rail-view" title="View options" aria-label="View options">👁</button>
             <button class="rail-btn" id="rail-settings" title="Settings" aria-label="Settings">⚙</button>
             <button class="rail-btn" id="rail-theme" title="Toggle theme" aria-label="Toggle theme">◐</button>
             <button class="rail-btn" id="rail-help" title="Help / About" aria-label="Help">?</button>

package/client/lib/android-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-bootstrap.js","sourceRoot":"","sources":["android-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/client/lib/android-bootstrap.ts

@@ -0,0 +1,9 @@
+/**
+ * Stub — the real android bootstrap is in packages/mailx-store-web/android-bootstrap.ts.
+ * This file exists only because it was created during development. The Android HTML
+ * (client/android.html) loads the bootstrap from the package via import map.
+ *
+ * This file is excluded from the desktop build (not imported by anything).
+ */
+
+export {};

package/client/lib/api-client.js.map

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

package/client/lib/api-client.ts

@@ -0,0 +1,439 @@
+/**
+ * API client — all operations go through the IPC bridge (mailxapi).
+ * mailxapi is injected by the launcher (msger on desktop, MAUI on Android).
+ */
+
+declare const mailxapi: any;
+
+function getIpc(): any {
+    if (typeof mailxapi !== "undefined" && mailxapi?.isApp) return mailxapi;
+    if ((window as any).opener?.mailxapi?.isApp) return (window as any).opener.mailxapi;
+    // Compose iframe — check parent
+    if ((window as any).parent?.mailxapi?.isApp) return (window as any).parent.mailxapi;
+    return null;
+}
+
+/** Build a proxy bridge that forwards every method call to the parent window
+ *  via postMessage. Used when the compose iframe's own attempt to reach
+ *  msger's IPC silently drops messages — empirically, `sendMessage` and
+ *  `saveDraft` both hit this (user-visible: "Sending…" spinner forever;
+ *  "Draft save failed: mailxapi timeout"). The main window's bridge is
+ *  provably fine, so the iframe routes through it. */
+function buildRelayBridge(): any {
+    const pending = new Map<string, { resolve: (v: any) => void; reject: (e: any) => void; timer: any }>();
+    window.addEventListener("message", (ev: MessageEvent) => {
+        if (!ev.data || ev.data.type !== "mailx-ipc-result" || !ev.data.id) return;
+        const entry = pending.get(ev.data.id);
+        if (!entry) return;
+        pending.delete(ev.data.id);
+        clearTimeout(entry.timer);
+        if (ev.data.ok) entry.resolve(ev.data.result);
+        else entry.reject(new Error(ev.data.error || "parent-relay ipc error"));
+    });
+    const call = (method: string, args: any[]): Promise<any> => {
+        const id = `ipc-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                pending.delete(id);
+                reject(new Error(`parent-relay timeout: ${method}`));
+            }, 120000);
+            pending.set(id, { resolve, reject, timer });
+            try {
+                (window.parent as any).postMessage({ type: "mailx-ipc", id, method, args }, "*");
+            } catch (e) {
+                clearTimeout(timer);
+                pending.delete(id);
+                reject(e);
+            }
+        });
+    };
+    // Proxy: any property access returns a function that forwards to parent.
+    // `isApp` / `platform` / other non-function reads return sensible defaults
+    // so existing getIpc-style checks still work.
+    return new Proxy({}, {
+        get(_t, prop: string) {
+            if (prop === "isApp") return true;
+            if (prop === "platform") return (window.parent as any)?.mailxapi?.platform || "webview2";
+            if (prop === "onEvent") {
+                // Event subscription can't be relayed simply — iframes that need
+                // events are rare. Fall back to direct parent bridge for onEvent
+                // since the subscription path doesn't hit the broken send path.
+                return (handler: any) => (window.parent as any)?.mailxapi?.onEvent?.(handler);
+            }
+            return (...args: any[]) => call(prop, args);
+        }
+    });
+}
+
+let cachedRelayBridge: any = null;
+function ipc(): any {
+    // Direct bridge is fine for the top window (main mailx app). The iframe
+    // (compose) can't trust its own bridge resolution because msger-routed
+    // sendMessage / saveDraft IPCs disappear without trace. So when we're in
+    // a child frame with a parent bridge, go through the parent.
+    const inIframe = window.parent && window.parent !== window;
+    if (inIframe && (window.parent as any)?.mailxapi?.isApp) {
+        if (!cachedRelayBridge) cachedRelayBridge = buildRelayBridge();
+        return cachedRelayBridge;
+    }
+    const bridge = getIpc();
+    if (!bridge) throw new Error("IPC bridge not available");
+    return bridge;
+}
+
+// ── Abort controller for message-list requests ──
+
+let messageListAbort: AbortController | null = null;
+
+export function abortMessageListRequests(): void {
+    if (messageListAbort) {
+        messageListAbort.abort();
+        messageListAbort = null;
+    }
+}
+
+// ── API Methods ──
+
+export function getAccounts() {
+    return ipc().getAccounts();
+}
+
+export function getFolders(accountId: string) {
+    return ipc().getFolders(accountId);
+}
+
+export function getMessages(accountId: string, folderId: number, page = 1, pageSize = 50, flaggedOnly = false, sort?: string, sortDir?: string) {
+    abortMessageListRequests();
+    return ipc().getMessages(accountId, folderId, page, pageSize, sort, sortDir, undefined, flaggedOnly);
+}
+
+export function getUnifiedInbox(page = 1, pageSize = 50) {
+    abortMessageListRequests();
+    return ipc().getUnifiedInbox(page, pageSize);
+}
+
+export function searchMessages(query: string, page = 1, pageSize = 50, scope = "all", accountId = "", folderId = 0) {
+    return ipc().searchMessages(query, page, pageSize);
+}
+
+export function getMessage(accountId: string, uid: number, allowRemote = false, folderId?: number) {
+    return ipc().getMessage(accountId, uid, allowRemote, folderId);
+}
+
+export function updateFlags(accountId: string, uid: number, flags: string[]) {
+    return ipc().updateFlags(accountId, uid, flags);
+}
+
+export function triggerSync() {
+    return ipc().syncAll();
+}
+
+export function syncAccount(accountId: string) {
+    return ipc().syncAccount(accountId);
+}
+
+export function reauthenticate(accountId: string) {
+    return ipc().reauthenticate(accountId);
+}
+
+export function reauthGoogleScopes(): Promise<{ cleared: number }> {
+    return (ipc() as any).reauthGoogleScopes();
+}
+
+export function getSyncPending() {
+    return ipc().getSyncPending();
+}
+
+export function getDiagnostics(): Promise<any> {
+    return ipc().getDiagnostics?.() ?? Promise.resolve([]);
+}
+
+/** Account that supplies `feature` data (calendar / tasks / contacts).
+ *  Resolution: per-feature primary flag → catch-all `primary` → first account.
+ *  Pass e.g. "calendar" to honor `primaryCalendar:true` overrides; omit for
+ *  back-compat single-flag behavior. */
+export function getPrimaryAccount(feature?: string): Promise<any> {
+    return ipc().getPrimaryAccount?.(feature) ?? Promise.resolve(null);
+}
+
+// Calendar / Tasks: two-way cache. Reads return local-cached rows; writes
+// commit locally and queue a push to Google. Service layer handles drain.
+export function getCalendarEvents(fromMs: number, toMs: number): Promise<any[]> {
+    return ipc().getCalendarEvents?.(fromMs, toMs) ?? Promise.resolve([]);
+}
+export function createCalendarEvent(ev: {
+    title: string; startMs: number; endMs: number; allDay?: boolean;
+    location?: string; notes?: string;
+}): Promise<{ uuid: string }> {
+    return ipc().createCalendarEvent?.(ev);
+}
+export function updateCalendarEvent(uuid: string, patch: any): Promise<{ ok: boolean }> {
+    return ipc().updateCalendarEvent?.(uuid, patch);
+}
+export function deleteCalendarEvent(uuid: string): Promise<{ ok: boolean }> {
+    return ipc().deleteCalendarEvent?.(uuid);
+}
+export function getTasks(includeCompleted = false): Promise<any[]> {
+    return ipc().getTasks?.(includeCompleted) ?? Promise.resolve([]);
+}
+export function createTask(t: { title: string; notes?: string; dueMs?: number }): Promise<{ uuid: string }> {
+    return ipc().createTask?.(t);
+}
+export function updateTask(uuid: string, patch: any): Promise<{ ok: boolean }> {
+    return ipc().updateTask?.(uuid, patch);
+}
+export function deleteTask(uuid: string): Promise<{ ok: boolean }> {
+    return ipc().deleteTask?.(uuid);
+}
+export function drainStoreSync(): Promise<{ ok: boolean }> {
+    return ipc().drainStoreSync?.();
+}
+
+/** Report the currently-viewed message as spam → appends a row to
+ *  `~/.mailx/spam.csv`. Placeholder: no folder move, no flag change, no
+ *  auto-delete. Training data for a smarter pass later. */
+export function recordSpamReport(accountId: string, uid: number, folderId: number): Promise<{ ok: boolean }> {
+    return ipc().recordSpamReport?.(accountId, uid, folderId);
+}
+
+export function getOutboxStatus() {
+    return (ipc() as any).getOutboxStatus();
+}
+
+export function listQueuedOutgoing() {
+    return (ipc() as any).listQueuedOutgoing();
+}
+
+export function cancelQueuedOutgoing(p: string) {
+    return (ipc() as any).cancelQueuedOutgoing(p);
+}
+
+export function searchContacts(query: string) {
+    return ipc().searchContacts(query);
+}
+
+export function hasCcHistoryTo(email: string): Promise<{ hasCc: boolean }> {
+    return (ipc() as any).hasCcHistoryTo(email);
+}
+
+export function hasBccHistoryTo(email: string): Promise<{ hasBcc: boolean }> {
+    return (ipc() as any).hasBccHistoryTo(email);
+}
+
+export function listContacts(query: string, page = 1, pageSize = 100) {
+    return (ipc() as any).listContacts(query, page, pageSize);
+}
+
+export function upsertContact(name: string, email: string) {
+    return (ipc() as any).upsertContact(name, email);
+}
+
+export function deleteContact(email: string) {
+    return (ipc() as any).deleteContact(email);
+}
+
+export function addPreferredContact(entry: { name: string; email: string; source?: string; organization?: string }) {
+    return (ipc() as any).addPreferredContact(entry.name, entry.email, entry.source, entry.organization);
+}
+
+export function addToDenylist(email: string) {
+    return (ipc() as any).addToDenylist(email);
+}
+
+export function openLocalPath(which: "config" | "log") {
+    return (ipc() as any).openLocalPath(which);
+}
+
+export function allowRemoteContent(type: string, value: string) {
+    return ipc().allowRemoteContent(type, value);
+}
+export function flagSenderOrDomain(type: "sender" | "domain", value: string): Promise<{ flagged: boolean }> {
+    return (ipc() as any).flagSenderOrDomain?.(type, value) ?? Promise.resolve({ flagged: false });
+}
+
+export function deleteMessage(accountId: string, uid: number) {
+    return ipc().deleteMessage?.(accountId, uid);
+}
+
+export function deleteMessages(accountId: string, uids: number[]) {
+    if (uids.length === 1) return deleteMessage(accountId, uids[0]);
+    return ipc().deleteMessages?.(accountId, uids);
+}
+
+export function moveMessages(accountId: string, uids: number[], targetFolderId: number, targetAccountId?: string) {
+    if (uids.length === 1) return moveMessage(accountId, uids[0], targetFolderId, targetAccountId);
+    return ipc().moveMessages?.(accountId, uids, targetFolderId, targetAccountId);
+}
+
+export function markAsSpamMessages(accountId: string, uids: number[]): Promise<{ targetFolderId: number; moved: number }> {
+    return ipc().markAsSpamMessages?.(accountId, uids);
+}
+
+export function undeleteMessage(accountId: string, uid: number, folderId: number) {
+    return ipc().undeleteMessage?.(accountId, uid, folderId);
+}
+
+export function moveMessage(accountId: string, uid: number, targetFolderId: number, targetAccountId?: string) {
+    return ipc().moveMessage?.(accountId, uid, targetFolderId, targetAccountId);
+}
+
+export function restartServer() {
+    return ipc().restart?.();
+}
+
+export function markFolderRead(accountId: string, folderId: number) {
+    return ipc().markFolderRead?.(accountId, folderId);
+}
+
+export function createFolder(accountId: string, parentPath: string, name: string) {
+    return ipc().createFolder?.(accountId, parentPath, name);
+}
+
+export function renameFolder(accountId: string, folderId: number, newName: string) {
+    return ipc().renameFolder?.(accountId, folderId, newName);
+}
+
+export function deleteFolder(accountId: string, folderId: number) {
+    return ipc().deleteFolder?.(accountId, folderId);
+}
+
+export function emptyFolder(accountId: string, folderId: number) {
+    return ipc().emptyFolder?.(accountId, folderId);
+}
+
+/** Ship a named event to the Node log as `[client] <tag> <data>`. Fire and
+ *  forget — never awaits, never throws, never blocks the caller. Tries two
+ *  paths so a broken primary channel can't swallow the trace:
+ *    1. Direct bridge call (self / opener / parent mailxapi).
+ *    2. parent.postMessage fallback — the main window listens and relays.
+ *  The fallback matters because the whole point of tracing is to diagnose
+ *  a broken iframe bridge; a single-path tracer that goes through that same
+ *  bridge is useless in exactly the case we need it. */
+export function logClientEvent(tag: string, data?: any): void {
+    let delivered = false;
+    try {
+        const bridge = typeof (globalThis as any).mailxapi !== "undefined" && (globalThis as any).mailxapi?.isApp ? (globalThis as any).mailxapi
+            : (window as any).opener?.mailxapi?.isApp ? (window as any).opener.mailxapi
+            : (window as any).parent?.mailxapi?.isApp ? (window as any).parent.mailxapi
+            : null;
+        if (bridge?.logClientEvent) {
+            bridge.logClientEvent(tag, data);
+            delivered = true;
+        }
+    } catch { /* never throw from tracing */ }
+    try {
+        if (window.parent && window.parent !== window) {
+            (window.parent as any).postMessage({ type: "mailx-trace", tag, data, bridged: delivered }, "*");
+        }
+    } catch { /* */ }
+}
+
+export function sendMessage(body: any) {
+    return ipc().sendMessage?.(body);
+}
+
+export function saveDraft(body: any) {
+    return ipc().saveDraft?.(body);
+}
+
+// ── Events ──
+
+type EventHandler = (event: any) => void;
+const eventHandlers: EventHandler[] = [];
+
+export function onEvent(handler: EventHandler): void {
+    eventHandlers.push(handler);
+}
+
+export function connectEvents(): void {
+    ipc().onEvent((event: any) => {
+        for (const h of eventHandlers) h(event);
+    });
+}
+
+// ── Autocomplete ──
+
+export function autocomplete(body: { subject: string; to: string; bodyText: string; cursorOffset: number }, signal?: AbortSignal) {
+    return ipc().autocomplete?.(body);
+}
+
+export function getAutocompleteSettings() {
+    return ipc().getAutocompleteSettings?.();
+}
+
+export function saveAutocompleteSettings(settings: any) {
+    return ipc().saveAutocompleteSettings?.(settings);
+}
+
+export function getVersion() {
+    return ipc().getVersion();
+}
+
+export function getSettings() {
+    return ipc().getSettings();
+}
+
+export function saveSettings(settings: any) {
+    return ipc().saveSettingsData?.(settings);
+}
+
+export function repairAccounts() {
+    return ipc().repairAccounts?.();
+}
+
+export function deleteDraft(accountId: string, draftUid: number, draftId?: string) {
+    return ipc().deleteDraft?.(accountId, draftUid, draftId);
+}
+
+export function addContact(name: string, email: string) {
+    return ipc().addContact?.(name, email);
+}
+
+export function getThreadMessages(accountId: string, threadId: string) {
+    return ipc().getThreadMessages?.(accountId, threadId);
+}
+
+export function readJsoncFile(name: string): Promise<{ content: string | null }> {
+    return ipc().readJsoncFile?.(name);
+}
+export function writeJsoncFile(name: string, content: string): Promise<{ ok: boolean }> {
+    return ipc().writeJsoncFile?.(name, content);
+}
+export function formatJsonc(content: string): Promise<{ content: string }> {
+    return (ipc() as any).formatJsonc?.(content);
+}
+export function readConfigHelp(name: string): Promise<{ content: string }> {
+    return ipc().readConfigHelp?.(name) ?? Promise.resolve({ content: "" });
+}
+export function unsubscribeOneClick(url: string): Promise<{ ok: boolean; status: number; statusText: string }> {
+    return ipc().unsubscribeOneClick?.(url);
+}
+export function openInWord(editId: string, html: string): Promise<{ ok: boolean; path: string; opener: string }> {
+    return (ipc() as any).openInWord?.(editId, html) ?? Promise.resolve({ ok: false, path: "", opener: "none" });
+}
+export function closeWordEdit(editId: string): Promise<void> {
+    return (ipc() as any).closeWordEdit?.(editId) ?? Promise.resolve();
+}
+
+/** Run an AI text transform (translate / proofread / summarize). Returns
+ *  empty `text` with a `reason` when the feature is disabled or the provider
+ *  errors — caller should surface `reason` in a status bar, not throw. */
+export function aiTransform(req: { action: "translate" | "proofread" | "summarize"; text: string; targetLang?: string }): Promise<{ text: string; reason?: string }> {
+    return ipc().aiTransform?.(req) ?? Promise.resolve({ text: "", reason: "AI not available in this host" });
+}
+
+export function setupAccount(name: string, email: string, password: string) {
+    return ipc().setupAccount?.(name, email, password);
+}
+
+export async function getAttachment(accountId: string, uid: number, attachmentId: number, folderId?: number): Promise<{ content: string; contentType: string; filename: string }> {
+    return ipc().getAttachment(accountId, uid, attachmentId, folderId);
+}
+
+export async function getDeviceAccounts(): Promise<{ email: string; name: string }[]> {
+    return ipc().getDeviceAccounts?.() ?? [];
+}
+
+// Legacy exports for backward compatibility
+export const connectWebSocket = connectEvents;
+export const onWsEvent = onEvent;