@bobfrankston/rmfmail 1.0.467

package/packages/mailx-service/jsonrpc.d.ts

@@ -0,0 +1,25 @@
+/**
+ * JSON-RPC dispatcher for MailxService.
+ * Maps mailxapi action names to MailxService method calls.
+ * Used by msger's bidirectional IPC (Phase 3) and can also
+ * serve as a stdio JSON-RPC interface for testing.
+ */
+type ServiceLike = Record<string, (...args: any[]) => any>;
+export interface RpcRequest {
+    _action: string;
+    _cbid: string;
+    [key: string]: any;
+}
+export interface RpcResponse {
+    _cbid: string;
+    result?: any;
+    error?: string;
+}
+export interface RpcEvent {
+    _event: string;
+    [key: string]: any;
+}
+/** Dispatch an incoming mailxapi call to the appropriate MailxService method */
+export declare function dispatch(svc: ServiceLike, req: RpcRequest): Promise<RpcResponse>;
+export {};
+//# sourceMappingURL=jsonrpc.d.ts.map

package/packages/mailx-service/jsonrpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["jsonrpc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;AAE3D,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,gFAAgF;AAChF,wBAAsB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAQtF"}

package/packages/mailx-service/jsonrpc.js

@@ -0,0 +1,238 @@
+/**
+ * JSON-RPC dispatcher for MailxService.
+ * Maps mailxapi action names to MailxService method calls.
+ * Used by msger's bidirectional IPC (Phase 3) and can also
+ * serve as a stdio JSON-RPC interface for testing.
+ */
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const rootPkg = JSON.parse(readFileSync(join(__dirname, "..", "..", "package.json"), "utf-8"));
+/** Dispatch an incoming mailxapi call to the appropriate MailxService method */
+export async function dispatch(svc, req) {
+    const { _action, _cbid, ...params } = req;
+    try {
+        const result = await dispatchAction(svc, _action, params);
+        return { _cbid, result };
+    }
+    catch (e) {
+        return { _cbid, error: e.message || String(e) };
+    }
+}
+async function dispatchAction(svc, action, p) {
+    switch (action) {
+        // Accounts
+        case "getAccounts":
+            return svc.getAccounts();
+        case "getFolders":
+            return svc.getFolders(p.accountId);
+        // Messages
+        case "getMessages":
+            return svc.getMessages(p.accountId, p.folderId, p.page, p.pageSize, p.sort, p.sortDir, p.search, p.flaggedOnly);
+        case "getUnifiedInbox":
+            return svc.getUnifiedInbox(p.page || 1, p.pageSize || 50);
+        case "getMessage":
+            return svc.getMessage(p.accountId, p.uid, p.allowRemote, p.folderId);
+        // Flags & actions
+        case "updateFlags":
+            await svc.updateFlags(p.accountId, p.uid, p.flags);
+            return { ok: true };
+        case "deleteMessage":
+            await svc.deleteMessage(p.accountId, p.uid);
+            return { ok: true };
+        case "deleteMessages":
+            await svc.deleteMessages(p.accountId, p.uids);
+            return { ok: true, count: p.uids.length };
+        case "undeleteMessage":
+            await svc.undeleteMessage(p.accountId, p.uid, p.folderId);
+            return { ok: true };
+        case "moveMessage":
+            await svc.moveMessage(p.accountId, p.uid, p.targetFolderId, p.targetAccountId);
+            return { ok: true };
+        case "moveMessages":
+            await svc.moveMessages(p.accountId, p.uids, p.targetFolderId);
+            return { ok: true, count: p.uids.length };
+        case "markAsSpamMessages":
+            return await svc.markAsSpamMessages(p.accountId, p.uids);
+        // Folders
+        case "markFolderRead":
+            svc.markFolderRead(p.folderId);
+            return { ok: true };
+        case "createFolder":
+            await svc.createFolder(p.accountId, p.parentPath, p.name);
+            return { ok: true };
+        case "renameFolder":
+            await svc.renameFolder(p.accountId, p.folderId, p.newName);
+            return { ok: true };
+        case "deleteFolder":
+            await svc.deleteFolder(p.accountId, p.folderId);
+            return { ok: true };
+        case "emptyFolder":
+            await svc.emptyFolder(p.accountId, p.folderId);
+            return { ok: true };
+        // Compose. sendMessage validates synchronously (fast — regex check on
+        // recipient strings), then writes to disk synchronously inside the
+        // service. Validation errors come back immediately to the user; once
+        // we've ACK'd, the message is durable on disk and the worker drains it.
+        // The whole call should be sub-100ms; if it ever isn't, the [send]
+        // timing log shows which step ate the budget.
+        case "sendMessage":
+            await svc.send(p);
+            return { ok: true };
+        case "saveDraft":
+            return svc.saveDraft(p.accountId, p.subject, p.bodyHtml, p.bodyText, p.to, p.cc, p.previousDraftUid, p.draftId);
+        case "deleteDraft":
+            await svc.deleteDraft(p.accountId, p.draftUid, p.draftId);
+            return { ok: true };
+        // Sync
+        case "syncAll":
+            await svc.syncAll();
+            return { ok: true };
+        case "syncAccount":
+            await svc.syncAccount(p.accountId);
+            return { ok: true };
+        case "getSyncPending":
+            return svc.getSyncPending();
+        case "getDiagnostics":
+            return svc.getDiagnostics();
+        case "getPrimaryAccount":
+            return svc.getPrimaryAccount(p?.feature);
+        // Calendar / Tasks: two-way cache. Reads return local immediately
+        // and kick a background refresh that emits updates when done.
+        case "getCalendarEvents":
+            return await svc.getCalendarEvents(p.fromMs, p.toMs);
+        case "createCalendarEvent":
+            return { uuid: await svc.createCalendarEventLocal(p) };
+        case "updateCalendarEvent":
+            await svc.updateCalendarEventLocal(p.uuid, p.patch);
+            return { ok: true };
+        case "deleteCalendarEvent":
+            await svc.deleteCalendarEventLocal(p.uuid);
+            return { ok: true };
+        case "getTasks":
+            return await svc.getTasks(!!p.includeCompleted);
+        case "createTask":
+            return { uuid: await svc.createTaskLocal(p) };
+        case "updateTask":
+            await svc.updateTaskLocal(p.uuid, p.patch);
+            return { ok: true };
+        case "deleteTask":
+            await svc.deleteTaskLocal(p.uuid);
+            return { ok: true };
+        case "drainStoreSync":
+            await svc.drainStoreSync();
+            return { ok: true };
+        case "recordSpamReport":
+            return await svc.recordSpamReport(p.accountId, p.uid, p.folderId);
+        case "getOutboxStatus":
+            return svc.getOutboxStatus();
+        case "listQueuedOutgoing":
+            return svc.listQueuedOutgoing();
+        case "cancelQueuedOutgoing":
+            return svc.cancelQueuedOutgoing(p.path);
+        case "reauthenticate":
+            return { ok: await svc.reauthenticate(p.accountId) };
+        case "reauthGoogleScopes":
+            return svc.reauthGoogleScopes();
+        // Search & contacts
+        case "searchMessages":
+            return svc.search(p.query, p.page, p.pageSize, p.scope, p.accountId, p.folderId);
+        case "searchContacts":
+            return svc.searchContacts(p.query);
+        case "hasCcHistoryTo":
+            return { hasCc: svc.hasCcHistoryTo(p.email) };
+        case "hasBccHistoryTo":
+            return { hasBcc: svc.hasBccHistoryTo(p.email) };
+        case "addContact":
+            return { ok: svc.addContact(p.name, p.email) };
+        case "listContacts":
+            return svc.listContacts(p.query || "", p.page || 1, p.pageSize || 100);
+        case "upsertContact":
+            return svc.upsertContact(p.name, p.email);
+        case "deleteContact":
+            return svc.deleteContact(p.email);
+        case "addPreferredContact":
+            await svc.addPreferredContact({ name: p.name, email: p.email, source: p.source, organization: p.organization });
+            return { ok: true };
+        case "addToDenylist":
+            await svc.addToDenylist(p.email);
+            return { ok: true };
+        case "loadContactsConfig":
+            return { result: await svc.loadContactsConfig() };
+        case "openLocalPath":
+            return await svc.openLocalPath(p.which);
+        case "getThreadMessages":
+            return svc.getThreadMessages(p.accountId, p.threadId);
+        case "readJsoncFile":
+            return { content: await svc.readJsoncFile(p.name) };
+        case "writeJsoncFile":
+            await svc.writeJsoncFile(p.name, p.content);
+            return { ok: true };
+        case "formatJsonc":
+            return { content: await svc.formatJsonc(p.content) };
+        case "readConfigHelp":
+            return { content: await svc.readConfigHelp(p.name) };
+        case "unsubscribeOneClick":
+            return await svc.unsubscribeOneClick(p.url);
+        case "openInWord":
+            return await svc.openInWord(p.editId, p.html);
+        case "closeWordEdit":
+            return await svc.closeWordEdit(p.editId);
+        // Client-side tracing — lets webview / iframe code ship events to the
+        // Node log so a "compose→send→vanished" report can be diagnosed without
+        // opening devtools. Every call shows up as `[client] <tag> <data>` in
+        // the main log. Keep it on the top of the switch so it's cheap + first
+        // to dispatch.
+        case "logClientEvent":
+            console.log(`  [client] ${p.tag || "?"}${p.data ? " " + JSON.stringify(p.data).slice(0, 400) : ""}`);
+            return { ok: true };
+        // Settings
+        case "getSettings":
+            return svc.getSettings();
+        case "saveSettingsData":
+            svc.saveSettings(p);
+            return { ok: true };
+        case "allowRemoteContent":
+            svc.allowRemoteContent(p.type, p.value);
+            return { ok: true };
+        case "flagSenderOrDomain":
+            return await svc.flagSenderOrDomain(p.type, p.value);
+        case "getVersion": {
+            try {
+                const settings = svc.getSettings();
+                const storage = svc.getStorageInfo();
+                return { version: rootPkg.version || "dev", theme: settings.ui?.theme || "system", storage };
+            }
+            catch (e) {
+                console.error(`  [jsonrpc] getVersion error: ${e.message}`);
+                return { version: rootPkg.version || "dev", theme: "system", storage: {} };
+            }
+        }
+        // Autocomplete
+        case "autocomplete":
+            return svc.autocomplete(p);
+        case "getAutocompleteSettings":
+            return svc.getAutocompleteSettings();
+        case "saveAutocompleteSettings":
+            svc.saveAutocompleteSettings(p);
+            return { ok: true };
+        // AI transform (translate / proofread / summarize) — gated by per-feature
+        // toggles in autocomplete settings, both default false.
+        case "aiTransform":
+            return svc.aiTransform(p);
+        // Attachments
+        case "getAttachment": {
+            const att = await svc.getAttachment(p.accountId, p.uid, p.attachmentId, p.folderId);
+            return { content: att.content.toString("base64"), contentType: att.contentType, filename: att.filename };
+        }
+        // Setup & Repair
+        case "setupAccount":
+            return svc.setupAccount(p.name, p.email, p.password);
+        case "repairAccounts":
+            return svc.repairAccounts();
+        default:
+            throw new Error(`Unknown action: ${action}`);
+    }
+}
+//# sourceMappingURL=jsonrpc.js.map

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

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

package/packages/mailx-service/jsonrpc.ts

@@ -0,0 +1,268 @@
+/**
+ * JSON-RPC dispatcher for MailxService.
+ * Maps mailxapi action names to MailxService method calls.
+ * Used by msger's bidirectional IPC (Phase 3) and can also
+ * serve as a stdio JSON-RPC interface for testing.
+ */
+
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const rootPkg = JSON.parse(readFileSync(join(__dirname, "..", "..", "package.json"), "utf-8"));
+
+// Accept any object with the right methods — avoids type conflicts from separate declarations
+type ServiceLike = Record<string, (...args: any[]) => any>;
+
+export interface RpcRequest {
+    _action: string;
+    _cbid: string;
+    [key: string]: any;
+}
+
+export interface RpcResponse {
+    _cbid: string;
+    result?: any;
+    error?: string;
+}
+
+export interface RpcEvent {
+    _event: string;
+    [key: string]: any;
+}
+
+/** Dispatch an incoming mailxapi call to the appropriate MailxService method */
+export async function dispatch(svc: ServiceLike, req: RpcRequest): Promise<RpcResponse> {
+    const { _action, _cbid, ...params } = req;
+    try {
+        const result = await dispatchAction(svc, _action, params);
+        return { _cbid, result };
+    } catch (e: any) {
+        return { _cbid, error: e.message || String(e) };
+    }
+}
+
+async function dispatchAction(svc: ServiceLike, action: string, p: Record<string, any>): Promise<any> {
+    switch (action) {
+        // Accounts
+        case "getAccounts":
+            return svc.getAccounts();
+        case "getFolders":
+            return svc.getFolders(p.accountId);
+
+        // Messages
+        case "getMessages":
+            return svc.getMessages(p.accountId, p.folderId, p.page, p.pageSize, p.sort, p.sortDir, p.search, p.flaggedOnly);
+        case "getUnifiedInbox":
+            return svc.getUnifiedInbox(p.page || 1, p.pageSize || 50);
+        case "getMessage":
+            return svc.getMessage(p.accountId, p.uid, p.allowRemote, p.folderId);
+
+        // Flags & actions
+        case "updateFlags":
+            await svc.updateFlags(p.accountId, p.uid, p.flags);
+            return { ok: true };
+        case "deleteMessage":
+            await svc.deleteMessage(p.accountId, p.uid);
+            return { ok: true };
+        case "deleteMessages":
+            await svc.deleteMessages(p.accountId, p.uids);
+            return { ok: true, count: p.uids.length };
+        case "undeleteMessage":
+            await svc.undeleteMessage(p.accountId, p.uid, p.folderId);
+            return { ok: true };
+        case "moveMessage":
+            await svc.moveMessage(p.accountId, p.uid, p.targetFolderId, p.targetAccountId);
+            return { ok: true };
+        case "moveMessages":
+            await svc.moveMessages(p.accountId, p.uids, p.targetFolderId);
+            return { ok: true, count: p.uids.length };
+        case "markAsSpamMessages":
+            return await svc.markAsSpamMessages(p.accountId, p.uids);
+
+        // Folders
+        case "markFolderRead":
+            svc.markFolderRead(p.folderId);
+            return { ok: true };
+        case "createFolder":
+            await svc.createFolder(p.accountId, p.parentPath, p.name);
+            return { ok: true };
+        case "renameFolder":
+            await svc.renameFolder(p.accountId, p.folderId, p.newName);
+            return { ok: true };
+        case "deleteFolder":
+            await svc.deleteFolder(p.accountId, p.folderId);
+            return { ok: true };
+        case "emptyFolder":
+            await svc.emptyFolder(p.accountId, p.folderId);
+            return { ok: true };
+
+        // Compose. sendMessage validates synchronously (fast — regex check on
+        // recipient strings), then writes to disk synchronously inside the
+        // service. Validation errors come back immediately to the user; once
+        // we've ACK'd, the message is durable on disk and the worker drains it.
+        // The whole call should be sub-100ms; if it ever isn't, the [send]
+        // timing log shows which step ate the budget.
+        case "sendMessage":
+            await svc.send(p);
+            return { ok: true };
+        case "saveDraft":
+            return svc.saveDraft(p.accountId, p.subject, p.bodyHtml, p.bodyText, p.to, p.cc, p.previousDraftUid, p.draftId);
+        case "deleteDraft":
+            await svc.deleteDraft(p.accountId, p.draftUid, p.draftId);
+            return { ok: true };
+
+        // Sync
+        case "syncAll":
+            await svc.syncAll();
+            return { ok: true };
+        case "syncAccount":
+            await svc.syncAccount(p.accountId);
+            return { ok: true };
+        case "getSyncPending":
+            return svc.getSyncPending();
+        case "getDiagnostics":
+            return svc.getDiagnostics();
+        case "getPrimaryAccount":
+            return svc.getPrimaryAccount(p?.feature);
+
+        // Calendar / Tasks: two-way cache. Reads return local immediately
+        // and kick a background refresh that emits updates when done.
+        case "getCalendarEvents":
+            return await svc.getCalendarEvents(p.fromMs, p.toMs);
+        case "createCalendarEvent":
+            return { uuid: await svc.createCalendarEventLocal(p) };
+        case "updateCalendarEvent":
+            await svc.updateCalendarEventLocal(p.uuid, p.patch); return { ok: true };
+        case "deleteCalendarEvent":
+            await svc.deleteCalendarEventLocal(p.uuid); return { ok: true };
+        case "getTasks":
+            return await svc.getTasks(!!p.includeCompleted);
+        case "createTask":
+            return { uuid: await svc.createTaskLocal(p) };
+        case "updateTask":
+            await svc.updateTaskLocal(p.uuid, p.patch); return { ok: true };
+        case "deleteTask":
+            await svc.deleteTaskLocal(p.uuid); return { ok: true };
+        case "drainStoreSync":
+            await svc.drainStoreSync(); return { ok: true };
+        case "recordSpamReport":
+            return await svc.recordSpamReport(p.accountId, p.uid, p.folderId);
+        case "getOutboxStatus":
+            return svc.getOutboxStatus();
+        case "listQueuedOutgoing":
+            return svc.listQueuedOutgoing();
+        case "cancelQueuedOutgoing":
+            return svc.cancelQueuedOutgoing(p.path);
+        case "reauthenticate":
+            return { ok: await svc.reauthenticate(p.accountId) };
+        case "reauthGoogleScopes":
+            return svc.reauthGoogleScopes();
+
+        // Search & contacts
+        case "searchMessages":
+            return svc.search(p.query, p.page, p.pageSize, p.scope, p.accountId, p.folderId);
+        case "searchContacts":
+            return svc.searchContacts(p.query);
+        case "hasCcHistoryTo":
+            return { hasCc: svc.hasCcHistoryTo(p.email) };
+        case "hasBccHistoryTo":
+            return { hasBcc: svc.hasBccHistoryTo(p.email) };
+        case "addContact":
+            return { ok: svc.addContact(p.name, p.email) };
+        case "listContacts":
+            return svc.listContacts(p.query || "", p.page || 1, p.pageSize || 100);
+        case "upsertContact":
+            return svc.upsertContact(p.name, p.email);
+        case "deleteContact":
+            return svc.deleteContact(p.email);
+        case "addPreferredContact":
+            await svc.addPreferredContact({ name: p.name, email: p.email, source: p.source, organization: p.organization });
+            return { ok: true };
+        case "addToDenylist":
+            await svc.addToDenylist(p.email);
+            return { ok: true };
+        case "loadContactsConfig":
+            return { result: await svc.loadContactsConfig() };
+        case "openLocalPath":
+            return await svc.openLocalPath(p.which);
+        case "getThreadMessages":
+            return svc.getThreadMessages(p.accountId, p.threadId);
+        case "readJsoncFile":
+            return { content: await svc.readJsoncFile(p.name) };
+        case "writeJsoncFile":
+            await svc.writeJsoncFile(p.name, p.content);
+            return { ok: true };
+        case "formatJsonc":
+            return { content: await svc.formatJsonc(p.content) };
+        case "readConfigHelp":
+            return { content: await svc.readConfigHelp(p.name) };
+        case "unsubscribeOneClick":
+            return await svc.unsubscribeOneClick(p.url);
+        case "openInWord":
+            return await svc.openInWord(p.editId, p.html);
+        case "closeWordEdit":
+            return await svc.closeWordEdit(p.editId);
+
+        // Client-side tracing — lets webview / iframe code ship events to the
+        // Node log so a "compose→send→vanished" report can be diagnosed without
+        // opening devtools. Every call shows up as `[client] <tag> <data>` in
+        // the main log. Keep it on the top of the switch so it's cheap + first
+        // to dispatch.
+        case "logClientEvent":
+            console.log(`  [client] ${p.tag || "?"}${p.data ? " " + JSON.stringify(p.data).slice(0, 400) : ""}`);
+            return { ok: true };
+
+        // Settings
+        case "getSettings":
+            return svc.getSettings();
+        case "saveSettingsData":
+            svc.saveSettings(p);
+            return { ok: true };
+        case "allowRemoteContent":
+            svc.allowRemoteContent(p.type, p.value);
+            return { ok: true };
+        case "flagSenderOrDomain":
+            return await svc.flagSenderOrDomain(p.type, p.value);
+        case "getVersion": {
+            try {
+                const settings = svc.getSettings();
+                const storage = svc.getStorageInfo();
+                return { version: rootPkg.version || "dev", theme: settings.ui?.theme || "system", storage };
+            } catch (e: any) {
+                console.error(`  [jsonrpc] getVersion error: ${e.message}`);
+                return { version: rootPkg.version || "dev", theme: "system", storage: {} };
+            }
+        }
+
+        // Autocomplete
+        case "autocomplete":
+            return svc.autocomplete(p as any);
+        case "getAutocompleteSettings":
+            return svc.getAutocompleteSettings();
+        case "saveAutocompleteSettings":
+            svc.saveAutocompleteSettings(p);
+            return { ok: true };
+
+        // AI transform (translate / proofread / summarize) — gated by per-feature
+        // toggles in autocomplete settings, both default false.
+        case "aiTransform":
+            return svc.aiTransform(p as any);
+
+        // Attachments
+        case "getAttachment": {
+            const att = await svc.getAttachment(p.accountId, p.uid, p.attachmentId, p.folderId);
+            return { content: att.content.toString("base64"), contentType: att.contentType, filename: att.filename };
+        }
+
+        // Setup & Repair
+        case "setupAccount":
+            return svc.setupAccount(p.name, p.email, p.password);
+        case "repairAccounts":
+            return svc.repairAccounts();
+
+        default:
+            throw new Error(`Unknown action: ${action}`);
+    }
+}

package/packages/mailx-service/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@bobfrankston/mailx-service",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "license": "ISC",
+  "dependencies": {
+    "@bobfrankston/mailx-types": "file:../mailx-types",
+    "@bobfrankston/mailx-store": "file:../mailx-store",
+    "@bobfrankston/mailx-imap": "file:../mailx-imap",
+    "@bobfrankston/mailx-settings": "file:../mailx-settings",
+    "mailparser": "^3.7.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BobFrankston/mailx.git"
+  }
+}

package/packages/mailx-service/tsconfig.json

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

package/packages/mailx-settings/.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-settings/cloud.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Cloud storage for mailx settings — Google Drive API (drive.file scope).
+ *
+ * Uses a single app-owned "mailx" folder on Drive, accessed by folder ID.
+ * The drive.file scope only sees files/folders created by this OAuth client,
+ * which prevents conflicts with existing folders of the same name.
+ * All machines using the same OAuth client ID share the same folder.
+ *
+ * ── Restoring removed providers ──
+ * OneDrive (removed 2026-04-06): Required microsoft-credentials.json in ~/.mailx/,
+ *   MS_SCOPES = "https://graph.microsoft.com/Files.ReadWrite offline_access",
+ *   authenticateOAuth with tokenDir ~/.mailx/tokens/microsoft/.
+ *   Read/write via Graph API: GET/PUT https://graph.microsoft.com/v1.0/me/drive/root:/{path}:/content
+ *   Azure AD app registration needed: https://portal.azure.com → App registrations → Desktop app
+ *
+ * Dropbox (removed 2026-04-06): Never implemented — placeholder only.
+ *   Would need Dropbox OAuth app, token management, and Dropbox API v2 calls.
+ */
+/** Find the settings folder on GDrive, or create a flat "mailx" folder.
+ *  Supports nested paths from config (e.g. "home/.mailx") by walking each
+ *  segment. Falls back to the folderId in config if set, so a stale ID that
+ *  points to the wrong folder gets corrected on next lookup. */
+export declare function gDriveFindOrCreateFolder(): Promise<string | null>;
+export type CloudProvider = "gdrive" | "google" | "local";
+export interface CloudFile {
+    /** Read a file. For gdrive, path is just the filename (folder ID is implicit). */
+    read(filePath: string): Promise<string | null>;
+    /** Write a file. For gdrive, path is just the filename. Throws on failure with a descriptive error. */
+    write(filePath: string, content: string): Promise<void>;
+    /** Check if a file exists. */
+    exists(filePath: string): Promise<boolean>;
+}
+/**
+ * Get a cloud file provider. For gdrive, pass the folder ID.
+ * Files are stored flat in the folder (no subdirectory navigation).
+ */
+export declare function getCloudProvider(provider: string, folderId?: string): CloudFile | null;
+/** Fetch the authenticated Google user's profile (name + email) via the People API.
+ *  Caller must supply an OAuth access token whose scopes include `contacts.readonly`
+ *  or `userinfo.profile`. The Drive token (drive.file) does NOT have the right scope
+ *  on its own — use the Gmail/IMAP OAuth token instead (mailx-imap's
+ *  ImapManager.getOAuthToken). Returns null on failure. */
+export declare function getGoogleProfile(token: string): Promise<{
+    name?: string;
+    email?: string;
+} | null>;
+//# sourceMappingURL=cloud.d.ts.map

package/packages/mailx-settings/cloud.d.ts.map

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