@bobfrankston/mailx 1.0.451 → 1.0.453

package/packages/mailx-core/index.ts

@@ -0,0 +1,424 @@
+/**
+ * @bobfrankston/mailx-core
+ * Core mail functions — callable directly via IPC or wrapped by Express.
+ * No HTTP, no Express, no WebSocket. Just plain async functions.
+ */
+
+import { MailxDB } from "@bobfrankston/mailx-store";
+import { ImapManager } from "@bobfrankston/mailx-imap";
+import { loadSettings, saveSettings, loadAllowlist, saveAllowlist, loadAccounts, getConfigDir, getStorePath, initLocalConfig } from "@bobfrankston/mailx-settings";
+import { simpleParser } from "mailparser";
+import type { ComposeMessage, AccountConfig } from "@bobfrankston/mailx-types";
+
+// ── Initialization ──
+
+let db: MailxDB;
+let imapManager: ImapManager;
+const eventHandlers: ((event: any) => void)[] = [];
+
+export function onEvent(handler: (event: any) => void): void {
+    eventHandlers.push(handler);
+}
+
+function emit(event: any): void {
+    for (const h of eventHandlers) {
+        try { h(event); } catch { /* ignore handler errors */ }
+    }
+}
+
+export async function initialize(transportFactory?: any): Promise<void> {
+    initLocalConfig();
+    const dbDir = getConfigDir();
+    db = new MailxDB(dbDir);
+    imapManager = new ImapManager(db, transportFactory || (() => { throw new Error("No transport factory provided"); }));
+
+    // Seed contacts
+    const seeded = db.seedContactsFromMessages();
+    if (seeded > 0) console.log(`  Seeded ${seeded} contacts`);
+
+    // Search index — only if empty
+    let ftsCount = 0;
+    try { ftsCount = (db as any).db.prepare("SELECT COUNT(*) as cnt FROM messages_fts").get()?.cnt || 0; } catch { /* */ }
+    if (ftsCount === 0) {
+        const indexed = db.rebuildSearchIndex();
+        if (indexed > 0) console.log(`  Search index: ${indexed} messages`);
+    }
+
+    // Add accounts
+    const settings = loadSettings();
+    for (const account of settings.accounts) {
+        if (!account.enabled) continue;
+        try {
+            await imapManager.addAccount(account);
+            console.log(`  Account added: ${account.name} (${account.id})`);
+        } catch (e: any) {
+            console.error(`  Failed to add account ${account.id}: ${e.message}`);
+        }
+    }
+
+    // Wire events to push notifications
+    imapManager.on("syncProgress", (accountId: string, phase: string, progress: number) => {
+        emit({ type: "syncProgress", accountId, phase, progress });
+    });
+    imapManager.on("folderCountsChanged", (accountId: string, counts: any) => {
+        emit({ type: "folderCountsChanged", accountId, counts });
+    });
+
+    // Initial sync + IDLE
+    if (settings.accounts.some(a => a.enabled)) {
+        console.log("  Starting initial sync...");
+        imapManager.syncAll().then(async () => {
+            console.log("  Initial sync complete");
+            await imapManager.startWatching();
+            imapManager.syncAllContacts().catch(e =>
+                console.error(`  Google Contacts sync error: ${e.message}`)
+            );
+        }).catch(e => {
+            console.error(`  Initial sync error: ${e.message}`);
+        });
+    }
+
+    imapManager.startPeriodicSync(settings.sync.intervalMinutes);
+    imapManager.startOutboxWorker();
+}
+
+export async function shutdown(): Promise<void> {
+    imapManager?.stopPeriodicSync();
+    imapManager?.stopOutboxWorker();
+    await imapManager?.shutdown();
+    db?.close();
+}
+
+// ── HTML Sanitization ──
+
+function sanitizeHtml(html: string): { html: string; hasRemoteContent: boolean } {
+    let hasRemoteContent = false;
+    let clean = html.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, "");
+    clean = clean.replace(/\s+on\w+\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi, "");
+    clean = clean.replace(/<img\b([^>]*)\bsrc\s*=\s*("[^"]*"|'[^']*')/gi, (match, before, src) => {
+        const url = src.slice(1, -1);
+        if (url.startsWith("data:") || url.startsWith("cid:")) return match;
+        hasRemoteContent = true;
+        return `<img${before}src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='20' height='20'%3E%3Crect fill='%23888' width='20' height='20' rx='3'/%3E%3Ctext x='10' y='14' text-anchor='middle' fill='white' font-size='12'%3E⊘%3C/text%3E%3C/svg%3E" data-blocked-src=${src} title="Remote image blocked"`;
+    });
+    clean = clean.replace(/<link\b[^>]*rel\s*=\s*["']stylesheet["'][^>]*>/gi, (match) => {
+        hasRemoteContent = true;
+        return `<!-- blocked: ${match.replace(/--/g, "")} -->`;
+    });
+    clean = clean.replace(/url\s*\(\s*(['"]?)(https?:\/\/[^)]+)\1\s*\)/gi, (_match, _q, url) => {
+        hasRemoteContent = true;
+        return `url("") /* blocked: ${url} */`;
+    });
+    clean = clean.replace(/<\/?form\b[^>]*>/gi, "");
+    clean = clean.replace(/<iframe\b[^>]*>[\s\S]*?<\/iframe>/gi, "");
+    return { html: clean, hasRemoteContent };
+}
+
+// ── API Functions ──
+
+export function getAccounts() {
+    return db.getAccounts();
+}
+
+export function getFolders(params: { accountId: string }) {
+    return db.getFolders(params.accountId);
+}
+
+export function getMessages(params: { accountId: string; folderId: number; page?: number; pageSize?: number; sort?: string; sortDir?: string; search?: string; flaggedOnly?: boolean }) {
+    return db.getMessages({
+        accountId: params.accountId,
+        folderId: params.folderId,
+        page: params.page || 1,
+        pageSize: params.pageSize || 50,
+        sort: (params.sort as any) || "date",
+        sortDir: (params.sortDir as any) || "desc",
+        search: params.search,
+        flaggedOnly: params.flaggedOnly,
+    });
+}
+
+export function getUnifiedInbox(params: { page?: number; pageSize?: number }) {
+    return db.getUnifiedInbox(params.page, params.pageSize);
+}
+
+export async function getMessage(params: { accountId: string; uid: number; allowRemote?: boolean; folderId?: number }) {
+    const { accountId, uid } = params;
+    let allowRemote = params.allowRemote || false;
+    const envelope = db.getMessageByUid(accountId, uid, params.folderId);
+    if (!envelope) throw new Error("Message not found");
+
+    let bodyHtml = "";
+    let bodyText = "";
+    let hasRemoteContent = false;
+    let attachments: any[] = [];
+
+    let deliveredTo = "";
+    let returnPath = "";
+    let listUnsubscribe = "";
+    let listUnsubscribeMail = "";
+    let listUnsubscribeHttp = "";
+    let listUnsubscribeOneClick = false;
+
+    const raw = await imapManager.fetchMessageBody(accountId, envelope.folderId, envelope.uid);
+    if (raw) {
+        const parsed = await simpleParser(raw);
+        bodyHtml = parsed.html || "";
+        bodyText = parsed.text || "";
+        attachments = (parsed.attachments || []).map((a, i) => ({
+            id: i,
+            filename: a.filename || `attachment-${i}`,
+            mimeType: a.contentType || "application/octet-stream",
+            size: a.size || 0,
+            contentId: a.contentId || "",
+        }));
+        // Extract useful headers for the UI
+        const hdr = (key: string): string => {
+            let v = parsed.headers.get(key);
+            if (!v) return "";
+            if (Array.isArray(v)) v = v[0];
+            if (typeof v === "string") return v;
+            if (typeof v === "object" && v !== null) {
+                if ("text" in v) return (v as any).text || "";
+                if ("value" in v) return String((v as any).value);
+                if ("address" in v) return (v as any).address || "";
+            }
+            return String(v);
+        };
+        // Get the real Delivered-To, skipping relay domains from account config
+        const settings = loadSettings();
+        const acctConfig = settings.accounts.find(a => a.id === accountId);
+        const relayDomains = acctConfig?.relayDomains || [];
+        const prefixes: string[] = acctConfig?.deliveredToPrefix || [];
+        const rawDelivered = parsed.headers.get("delivered-to");
+        if (rawDelivered) {
+            const deliveredList = Array.isArray(rawDelivered) ? rawDelivered : [rawDelivered];
+            for (let i = deliveredList.length - 1; i >= 0; i--) {
+                const d = deliveredList[i];
+                const addr = typeof d === "string" ? d : (d as any)?.text || (d as any)?.address || String(d);
+                if (!relayDomains.some((rd: string) => addr.includes(`@${rd}`))) {
+                    deliveredTo = addr;
+                    break;
+                }
+            }
+            if (!deliveredTo && deliveredList.length > 0) {
+                const d = deliveredList[deliveredList.length - 1];
+                deliveredTo = typeof d === "string" ? d : (d as any)?.text || (d as any)?.address || String(d);
+            }
+            // Strip prefix from local part to get clean alias
+            if (deliveredTo && prefixes.length > 0) {
+                const [local, domain] = deliveredTo.split("@");
+                for (const prefix of prefixes) {
+                    if (local.startsWith(prefix)) {
+                        deliveredTo = `${local.slice(prefix.length)}@${domain}`;
+                        break;
+                    }
+                }
+            }
+        }
+        returnPath = hdr("return-path").replace(/[<>]/g, "");
+        ({ listUnsubscribeMail, listUnsubscribeHttp, listUnsubscribeOneClick } =
+            parseListUnsubscribe(parsed.headers));
+        listUnsubscribe = listUnsubscribeHttp || listUnsubscribeMail;
+    }
+
+    if (bodyHtml && !allowRemote) {
+        const allowList = loadAllowlist();
+        const senderAddr = envelope.from?.address || "";
+        const senderDomain = senderAddr.split("@")[1] || "";
+        const toAddrs = (envelope.to || []).map((a: any) => a.address);
+        const isAllowed = allowList.senders.includes(senderAddr) ||
+            allowList.domains.includes(senderDomain) ||
+            toAddrs.some((a: string) => allowList.recipients?.includes(a));
+
+        if (isAllowed) {
+            allowRemote = true;
+        } else {
+            const result = sanitizeHtml(bodyHtml);
+            bodyHtml = result.html;
+            hasRemoteContent = result.hasRemoteContent;
+        }
+    }
+
+    // Build .eml file path for "View Source"
+    const storePath = getStorePath();
+    const emlPath = `${storePath}/${accountId}/${envelope.folderId}/${envelope.uid}.eml`;
+
+    return { ...envelope, bodyHtml, bodyText, hasRemoteContent, remoteAllowed: allowRemote, attachments, deliveredTo, returnPath, listUnsubscribe, listUnsubscribeMail, listUnsubscribeHttp, listUnsubscribeOneClick, emlPath };
+}
+
+/** Parse `List-Unsubscribe` (RFC 2369) and `List-Unsubscribe-Post` (RFC 8058).
+ *  Returns mailto URL, HTTPS URL, and whether one-click POST is allowed.
+ *  mailparser only exposes ONE of mail/url even when both are present, so we
+ *  also scan the raw header text for the full set of angle-bracketed URIs. */
+function parseListUnsubscribe(headers: any): { listUnsubscribeMail: string; listUnsubscribeHttp: string; listUnsubscribeOneClick: boolean } {
+    let mail = "";
+    let http = "";
+    let oneClick = false;
+
+    // Raw header scan — most reliable.
+    const raw = headers.get("list-unsubscribe");
+    const rawStr = typeof raw === "string" ? raw : (raw && typeof (raw as any).text === "string" ? (raw as any).text : "");
+    if (rawStr) {
+        const matches = rawStr.match(/<([^>]+)>/g) || [];
+        for (const m of matches) {
+            const url = m.slice(1, -1).trim();
+            if (!mail && /^mailto:/i.test(url)) mail = url;
+            else if (!http && /^https?:/i.test(url)) http = url;
+        }
+    }
+    // mailparser fallback — for builds where headers.get returns the parsed object.
+    if (!mail && !http) {
+        const listHeaders = headers.get("list");
+        if (listHeaders?.unsubscribe) {
+            const unsub = listHeaders.unsubscribe;
+            if (unsub.url) http = Array.isArray(unsub.url) ? unsub.url[0] : unsub.url;
+            if (unsub.mail) mail = `mailto:${Array.isArray(unsub.mail) ? unsub.mail[0] : unsub.mail}`;
+        }
+    }
+
+    const post = headers.get("list-unsubscribe-post");
+    const postStr = typeof post === "string" ? post : (post && typeof (post as any).text === "string" ? (post as any).text : "");
+    if (postStr && /one-?click/i.test(postStr)) oneClick = true;
+
+    return { listUnsubscribeMail: mail, listUnsubscribeHttp: http, listUnsubscribeOneClick: oneClick };
+}
+
+export async function updateFlags(params: { accountId: string; uid: number; flags: string[] }) {
+    const envelope = db.getMessageByUid(params.accountId, params.uid);
+    await imapManager.updateFlagsLocal(params.accountId, params.uid, envelope?.folderId || 0, params.flags);
+}
+
+export async function deleteMessage(params: { accountId: string; uid: number }) {
+    const envelope = db.getMessageByUid(params.accountId, params.uid);
+    if (!envelope) throw new Error("Message not found");
+    await imapManager.trashMessage(params.accountId, envelope.folderId, envelope.uid);
+}
+
+export async function undeleteMessage(params: { accountId: string; uid: number; folderId: number }) {
+    await imapManager.undeleteMessage(params.accountId, params.uid, params.folderId);
+}
+
+export async function sendMessage(params: ComposeMessage) {
+    const settings = loadSettings();
+    const account = settings.accounts.find(a => a.id === params.from);
+    if (!account) throw new Error(`Unknown account: ${params.from}`);
+
+    const to = params.to.map(a => a.name ? `${a.name} <${a.address}>` : a.address).join(", ");
+    const cc = params.cc?.map(a => a.name ? `${a.name} <${a.address}>` : a.address).join(", ");
+    const bcc = params.bcc?.map(a => a.name ? `${a.name} <${a.address}>` : a.address).join(", ");
+
+    const headers = [
+        `From: ${account.name} <${account.email}>`,
+        `To: ${to}`,
+        cc ? `Cc: ${cc}` : null,
+        bcc ? `Bcc: ${bcc}` : null,
+        `Subject: ${params.subject}`,
+        `Date: ${new Date().toUTCString()}`,
+        params.inReplyTo ? `In-Reply-To: ${params.inReplyTo}` : null,
+        params.references?.length ? `References: ${params.references.join(" ")}` : null,
+        `MIME-Version: 1.0`,
+        `Content-Type: text/html; charset=UTF-8`,
+    ].filter(h => h !== null).join("\r\n");
+    const rawMessage = `${headers}\r\n\r\n${params.bodyHtml || params.bodyText || ""}`;
+
+    imapManager.queueOutgoingLocal(account.id, rawMessage);
+    for (const addr of params.to) db.recordSentAddress(addr.name, addr.address);
+    if (params.cc) for (const addr of params.cc) db.recordSentAddress(addr.name, addr.address);
+    if (params.bcc) for (const addr of params.bcc) db.recordSentAddress(addr.name, addr.address);
+}
+
+export async function saveDraft(params: { accountId: string; subject: string; bodyHtml: string; bodyText: string; to: string; cc: string; previousDraftUid?: number }) {
+    const settings = loadSettings();
+    const account = settings.accounts.find(a => a.id === params.accountId);
+    if (!account) throw new Error(`Unknown account: ${params.accountId}`);
+
+    const headers = [
+        `From: ${account.name} <${account.email}>`,
+        params.to ? `To: ${params.to}` : null,
+        params.cc ? `Cc: ${params.cc}` : null,
+        `Subject: ${params.subject || "(no subject)"}`,
+        `Date: ${new Date().toUTCString()}`,
+        `MIME-Version: 1.0`,
+        `Content-Type: text/html; charset=UTF-8`,
+    ].filter(h => h !== null).join("\r\n");
+    const raw = `${headers}\r\n\r\n${params.bodyHtml || params.bodyText || ""}`;
+
+    return await imapManager.saveDraft(params.accountId, raw, params.previousDraftUid);
+}
+
+export async function deleteDraft(params: { accountId: string; draftUid: number }) {
+    await imapManager.deleteDraft(params.accountId, params.draftUid);
+}
+
+export function searchMessages(params: { query: string; page?: number; pageSize?: number }) {
+    if (!params.query.trim()) return { items: [], total: 0, page: 1, pageSize: 50 };
+    return db.searchMessages(params.query, params.page || 1, params.pageSize || 50);
+}
+
+export function searchContacts(params: { query: string }) {
+    if (params.query.length < 1) return [];
+    return db.searchContacts(params.query);
+}
+
+export async function syncAll() {
+    await imapManager.syncAll();
+}
+
+export function getSyncPending() {
+    return { pending: db.getTotalPendingSyncCount() };
+}
+
+export async function allowRemoteContent(params: { type: string; value: string }) {
+    const list = loadAllowlist();
+    if (params.type === "sender" && !list.senders.includes(params.value)) list.senders.push(params.value);
+    else if (params.type === "domain" && !list.domains.includes(params.value)) list.domains.push(params.value);
+    else if (params.type === "recipient") {
+        if (!list.recipients) list.recipients = [];
+        if (!list.recipients.includes(params.value)) list.recipients.push(params.value);
+    }
+    await saveAllowlist(list);
+}
+
+export function getSettings() {
+    return loadSettings();
+}
+
+export function saveSettingsData(data: any) {
+    saveSettings(data);
+}
+
+export function rebuildSearchIndex() {
+    return db.rebuildSearchIndex();
+}
+
+export function seedContacts() {
+    return db.seedContactsFromMessages();
+}
+
+export async function syncGoogleContacts() {
+    await imapManager.syncAllContacts();
+}
+
+export function getVersion() {
+    return { server: "1.0.0", client: "1.0.0" }; // Updated by build
+}
+
+// ── Action dispatcher for IPC ──
+
+const actions: Record<string, (params: any) => any> = {
+    getAccounts, getFolders, getMessages, getUnifiedInbox, getMessage,
+    updateFlags, deleteMessage, undeleteMessage, sendMessage,
+    saveDraft, deleteDraft, searchMessages, searchContacts,
+    syncAll, getSyncPending, allowRemoteContent,
+    getSettings, saveSettingsData, rebuildSearchIndex,
+    seedContacts, syncGoogleContacts, getVersion,
+};
+
+/** Dispatch an action by name — used by IPC and Express wrapper */
+export async function dispatch(action: string, params: any = {}): Promise<any> {
+    const fn = actions[action];
+    if (!fn) throw new Error(`Unknown action: ${action}`);
+    return await fn(params);
+}
+
+export { db, imapManager };

package/packages/mailx-core/ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["ipc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAsC9C"}

package/packages/mailx-core/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["ipc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC1B,kBAAkB;IAClB,MAAM,UAAU,EAAE,CAAC;IAEnB,wBAAwB;IACxB,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAE/E,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACzB,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,CAAC,sBAAsB;QAClC,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,GAAG,CAAC;QAC1C,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK;YAAE,OAAO;QAE/B,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACtF,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7F,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAChB,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC;AAED,kCAAkC;AAClC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzF,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACjB,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/packages/mailx-core/ipc.ts

@@ -0,0 +1,62 @@
+/**
+ * IPC protocol — stdin/stdout JSON lines for Rust↔Node communication.
+ * Rust launcher sends JSON requests, Node dispatches to core functions,
+ * sends JSON responses back. Events pushed to stdout as well.
+ *
+ * Protocol:
+ *   Request:  { "_action": "getMessages", "_cbid": "5", "accountId": "bobma", ... }
+ *   Response: { "_type": "response", "_cbid": "5", "result": { ... } }
+ *   Error:    { "_type": "error", "_cbid": "5", "error": "message" }
+ *   Event:    { "_type": "event", "data": { "type": "folderCountsChanged", ... } }
+ */
+
+import * as readline from "node:readline";
+import { dispatch, initialize, onEvent } from "./index.js";
+
+export async function startIPC(): Promise<void> {
+    // Initialize core
+    await initialize();
+
+    // Push events to stdout
+    onEvent((event) => {
+        const line = JSON.stringify({ _type: "event", data: event });
+        process.stdout.write(line + "\n");
+    });
+
+    // Read JSON lines from stdin
+    const rl = readline.createInterface({ input: process.stdin, terminal: false });
+
+    rl.on("line", async (line) => {
+        let msg: any;
+        try {
+            msg = JSON.parse(line);
+        } catch {
+            return; // Skip malformed JSON
+        }
+
+        const { _action, _cbid, ...params } = msg;
+        if (!_action || !_cbid) return;
+
+        try {
+            const result = await dispatch(_action, params);
+            process.stdout.write(JSON.stringify({ _type: "response", _cbid, result }) + "\n");
+        } catch (e: any) {
+            process.stdout.write(JSON.stringify({ _type: "error", _cbid, error: e.message }) + "\n");
+        }
+    });
+
+    rl.on("close", () => {
+        console.error("IPC stdin closed, shutting down");
+        process.exit(0);
+    });
+
+    console.error("IPC ready");
+}
+
+// If run directly, start IPC mode
+if (import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("ipc.js")) {
+    startIPC().catch(e => {
+        console.error(`IPC startup error: ${e.message}`);
+        process.exit(1);
+    });
+}

package/packages/mailx-core/package.json

@@ -11,7 +11,7 @@
   "dependencies": {
     "@bobfrankston/mailx-types": "file:../mailx-types",
     "@bobfrankston/mailx-store": "file:../mailx-store",
-    "@bobfrankston/mailx-imap": "file:../mailx-imap",
+    "@bobfrankston/mailx-imap": "file:../../../packages/mailx-imap",
     "@bobfrankston/mailx-settings": "file:../mailx-settings",
     "mailparser": "^3.7.2"
   }

package/packages/mailx-core/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": ".",
+    "rootDir": "."
+  },
+  "include": ["*.ts"],
+  "exclude": ["node_modules", "prev", "cruft", "tests"]
+}

package/packages/mailx-host/.gitattributes

@@ -0,0 +1,10 @@
+# Force LF line endings for all text files
+* text=auto eol=lf
+
+# Ensure these are always LF
+*.ts text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf

package/packages/mailx-host/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,qBAAqB,CAAC;AAE7C,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9F,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,wBAAgB,UAAU,IAAI,QAAQ,CAIrC;AAWD,eAAO,MAAM,cAAc,6BAAuB,CAAC;AACnD,eAAO,MAAM,WAAW,0BAAoB,CAAC;AAC7C,eAAO,MAAM,UAAU,yBAAmB,CAAC;AAC3C,eAAO,MAAM,UAAU,yBAAmB,CAAC;AAC3C,eAAO,MAAM,QAAQ,EAAE,QAAoB,CAAC"}

package/packages/mailx-host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,qBAAqB,CAAC;AAM7C,MAAM,UAAU,UAAU;IACtB,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAqB,CAAC;IACnF,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,MAAM,SAAS,GAAa,UAAU,EAAE,CAAC;AAEzC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,IAAI,KAAK,CACX,gBAAgB,SAAS,qEAAqE;QAC9F,oFAAoF,CACvF,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAa,SAAS,CAAC"}

package/packages/mailx-host/index.ts

@@ -0,0 +1,38 @@
+/**
+ * mailx-host — runtime WebView host selector.
+ *
+ * Today: msger on every platform.
+ * Future: lazy-load @bobfrankston/mailx-host-msgview for Mac and niche
+ * Linux systems that can't get webkit2gtk-4.1.
+ *
+ * Callers (bin/mailx.ts) import showMessageBox / showService / setAppName
+ * from here instead of @bobfrankston/msger directly, so the swap is a
+ * one-line change when msgview arrives.
+ */
+
+import * as msger from "@bobfrankston/msger";
+
+export type { MessageBoxOptions, MessageBoxResult, ServiceHandle } from "@bobfrankston/msger";
+
+export type HostName = "msger" | "msgview";
+
+export function selectHost(): HostName {
+    const requested = (process.env.MAILX_HOST || "").toLowerCase();
+    if (requested === "msger" || requested === "msgview") return requested as HostName;
+    return "msger";
+}
+
+const _hostName: HostName = selectHost();
+
+if (_hostName !== "msger") {
+    throw new Error(
+        `mailx-host: "${_hostName}" adapter not implemented yet — set MAILX_HOST=msger to fall back, ` +
+        `or implement @bobfrankston/mailx-host-msgview (see docs/host-abstraction-plan.md).`
+    );
+}
+
+export const showMessageBox = msger.showMessageBox;
+export const showService = msger.showService;
+export const setAppName = msger.setAppName;
+export const setAppIcon = msger.setAppIcon;
+export const hostName: HostName = _hostName;

package/packages/mailx-host/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-host",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Host abstraction for mailx — dispatches to msger or msgview",
   "type": "module",
   "main": "index.js",
@@ -11,7 +11,7 @@
   },
   "license": "ISC",
   "dependencies": {
-    "@bobfrankston/msger": "file:../../../../utils/msgx/msger"
+    "@bobfrankston/msger": "^0.1.367"
   },
   "repository": {
     "type": "git",
@@ -19,5 +19,13 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  ".dependencies": {
+    "@bobfrankston/msger": "file:../../../../../utils/msgx/msger"
+  },
+  ".transformedSnapshot": {
+    "dependencies": {
+      "@bobfrankston/msger": "^0.1.367"
+    }
   }
 }

package/packages/mailx-host/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": ".",
+    "rootDir": "."
+  },
+  "include": ["*.ts", "*.d.ts"],
+  "exclude": ["node_modules", "prev", "cruft", "tests"]
+}

package/packages/mailx-send/.gitattributes

@@ -0,0 +1,10 @@
+# Force LF line endings for all text files
+* text=auto eol=lf
+
+# Ensure these are always LF
+*.ts text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf

package/packages/mailx-send/cli-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-queue.d.ts","sourceRoot":"","sources":["cli-queue.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}

package/packages/mailx-send/cli-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-queue.js","sourceRoot":"","sources":["cli-queue.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AAE/D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,SAAS,MAAM,CAAC,IAAY;IACxB,MAAM,MAAM,GAA2B,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACvD,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC;AACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,MAAM,GAAmB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAChF,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAEpC,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IACrB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,SAAS,EAAE,CAAC;QACZ,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACJ,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;IACpC,CAAC;IACD,+BAA+B;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC;IACrE,CAAC;AACL,CAAC;KAAM,CAAC;IACJ,uBAAuB;IACvB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC;QACjE,KAAK,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,CAAC;IACD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACvD,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}