@bobfrankston/rmfmail 1.0.706 → 1.0.708

package/packages/mailx-types/mailx-api.d.ts.map

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

package/packages/mailx-types/mailx-api.js

@@ -0,0 +1,41 @@
+/**
+ * MailxApi — the single typed contract that every mailx service implementation
+ * must satisfy. Both the Node-side desktop service (`MailxService`) and the
+ * browser-side Android service (`WebMailxService`) declare
+ * `implements MailxApi`. Missing methods become build errors instead of
+ * silent runtime "parent bridge has no method X" failures.
+ *
+ * **Why this exists**: until now the two implementations drifted independently.
+ * A method added to MailxService for one platform release would be silently
+ * absent on the other for months. spellcheck-on-GDrive (2026-05-13) added
+ * `getUserDict` / `addUserDictWord` / `removeUserDictWord` to the desktop
+ * service; the Android service got none of them; the relay returned
+ * `parent bridge has no method`, the client `.catch(() => {})` swallowed the
+ * rejection, and the feature silently regressed on phone. With this contract
+ * any such addition is a compile-time failure on whichever side it's missing.
+ *
+ * **Surface**: the 83 method names dispatched by
+ * `mailx-service/jsonrpc.ts` plus a handful of internal helpers both
+ * implementations need. IPC-only names (`sendMessage`, `createCalendarEvent`,
+ * etc.) are listed under their dispatch names — desktop classes that today
+ * use a different internal name (e.g., `send`, `createCalendarEventLocal`)
+ * add a thin alias method so the contract holds without renaming call sites.
+ *
+ * **Optional methods**: a handful of methods require an OS popup or native
+ * filesystem hook and have no meaningful browser equivalent
+ * (`openInWord`, `closeWordEdit`, `showReminderPopup`, `openInTextEditor`,
+ * `openLocalPath`). They are declared `?:` so the browser service can
+ * legitimately omit them. The desktop service must implement them.
+ *
+ * **Types**: signatures use `any` where the shape genuinely varies across
+ * implementations (envelope rows, settings, AI payloads). The contract's
+ * job is name + arity enforcement, not deep schema typing — that lives in
+ * the relevant domain types (`Folder`, `AccountConfig`, etc.).
+ *
+ * **Where to add a new method**: add the method here first. Both
+ * implementations will fail to compile until they implement it. Don't add
+ * methods to a service class without the interface entry — that's how we
+ * got into the silent-drift hole.
+ */
+export {};
+//# sourceMappingURL=mailx-api.js.map

package/packages/mailx-types/mailx-api.js.map

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

package/packages/mailx-types/mailx-api.ts

@@ -0,0 +1,159 @@
+/**
+ * MailxApi — the single typed contract that every mailx service implementation
+ * must satisfy. Both the Node-side desktop service (`MailxService`) and the
+ * browser-side Android service (`WebMailxService`) declare
+ * `implements MailxApi`. Missing methods become build errors instead of
+ * silent runtime "parent bridge has no method X" failures.
+ *
+ * **Why this exists**: until now the two implementations drifted independently.
+ * A method added to MailxService for one platform release would be silently
+ * absent on the other for months. spellcheck-on-GDrive (2026-05-13) added
+ * `getUserDict` / `addUserDictWord` / `removeUserDictWord` to the desktop
+ * service; the Android service got none of them; the relay returned
+ * `parent bridge has no method`, the client `.catch(() => {})` swallowed the
+ * rejection, and the feature silently regressed on phone. With this contract
+ * any such addition is a compile-time failure on whichever side it's missing.
+ *
+ * **Surface**: the 83 method names dispatched by
+ * `mailx-service/jsonrpc.ts` plus a handful of internal helpers both
+ * implementations need. IPC-only names (`sendMessage`, `createCalendarEvent`,
+ * etc.) are listed under their dispatch names — desktop classes that today
+ * use a different internal name (e.g., `send`, `createCalendarEventLocal`)
+ * add a thin alias method so the contract holds without renaming call sites.
+ *
+ * **Optional methods**: a handful of methods require an OS popup or native
+ * filesystem hook and have no meaningful browser equivalent
+ * (`openInWord`, `closeWordEdit`, `showReminderPopup`, `openInTextEditor`,
+ * `openLocalPath`). They are declared `?:` so the browser service can
+ * legitimately omit them. The desktop service must implement them.
+ *
+ * **Types**: signatures use `any` where the shape genuinely varies across
+ * implementations (envelope rows, settings, AI payloads). The contract's
+ * job is name + arity enforcement, not deep schema typing — that lives in
+ * the relevant domain types (`Folder`, `AccountConfig`, etc.).
+ *
+ * **Where to add a new method**: add the method here first. Both
+ * implementations will fail to compile until they implement it. Don't add
+ * methods to a service class without the interface entry — that's how we
+ * got into the silent-drift hole.
+ */
+
+import type { AutocompleteSettings, AutocompleteRequest, AutocompleteResponse, AiTransformRequest, AiTransformResponse } from "./index.js";
+import type { Folder } from "./index.js";
+
+export interface MailxApi {
+    // ── Accounts / folders / messages ─────────────────────────────────
+    getAccounts(): any[] | Promise<any[]>;
+    getFolders(accountId: string): Folder[] | Promise<Folder[]>;
+    getMessages(accountId: string, folderId: number, page?: number, pageSize?: number, sort?: string, sortDir?: string, search?: string, flaggedOnly?: boolean): any | Promise<any>;
+    getUnifiedInbox(page?: number, pageSize?: number): any | Promise<any>;
+    getMessage(accountId: string, uid: number, allowRemote?: boolean, folderId?: number): Promise<any>;
+    getThreadMessages(accountId: string, threadId: string): any | Promise<any>;
+    getAttachment(accountId: string, uid: number, attachmentId: number, folderId?: number): Promise<{ content: any; contentType: string; filename: string }>;
+
+    // ── Flags / move / delete ─────────────────────────────────────────
+    updateFlags(accountId: string, uid: number, flags: string[]): Promise<void>;
+    deleteMessage(accountId: string, uid: number): Promise<void>;
+    deleteMessages(accountId: string, uids: number[]): Promise<void>;
+    undeleteMessage(accountId: string, uid: number, folderId: number): Promise<void>;
+    moveMessage(accountId: string, uid: number, targetFolderId: number, targetAccountId?: string): Promise<void>;
+    moveMessages(accountId: string, uids: number[], targetFolderId: number): Promise<void>;
+    markAsSpamMessages(accountId: string, uids: number[]): Promise<{ targetFolderId: number; moved: number }>;
+    recordSpamReport(accountId: string, uid: number, folderId: number): Promise<any>;
+    markFolderRead(folderId: number): void | Promise<void>;
+
+    // ── Folders ───────────────────────────────────────────────────────
+    createFolder(accountId: string, parentPath: string, name: string): Promise<void>;
+    renameFolder(accountId: string, folderId: number, newName: string): Promise<void>;
+    deleteFolder(accountId: string, folderId: number): Promise<void>;
+    moveFolderToTrash(accountId: string, folderId: number): Promise<void>;
+    emptyFolder(accountId: string, folderId: number): Promise<void>;
+
+    // ── Send / draft / outbox ─────────────────────────────────────────
+    sendMessage(msg: any): Promise<void>;
+    saveDraft(accountId: string, subject: string, bodyHtml: string, bodyText: string, to?: string, cc?: string, previousDraftUid?: number, draftId?: string): Promise<{ draftUid: number | null; draftId: string }>;
+    deleteDraft(accountId: string, draftUid: number, draftId?: string): Promise<void>;
+    getOutboxStatus(): any | Promise<any>;
+    listQueuedOutgoing(): any[] | Promise<any[]>;
+    cancelQueuedOutgoing(filePath: string): { ok: true } | Promise<{ ok: true }>;
+
+    // ── Sync ──────────────────────────────────────────────────────────
+    syncAll(): Promise<void>;
+    syncAccount(accountId: string): Promise<void>;
+    getSyncPending(): { pending: number } | Promise<{ pending: number }>;
+    drainStoreSync(): Promise<void>;
+    reauthenticate(accountId: string): Promise<boolean>;
+    reauthGoogleScopes(): { cleared: number } | Promise<{ cleared: number }>;
+
+    // ── Search ────────────────────────────────────────────────────────
+    searchMessages(query: string, page?: number, pageSize?: number, scope?: string, accountId?: string, folderId?: number, includeTrashSpam?: boolean): Promise<any>;
+
+    // ── Contacts / autocomplete ───────────────────────────────────────
+    searchContacts(query: string): any[] | Promise<any[]>;
+    hasCcHistoryTo(email: string): boolean | Promise<boolean>;
+    hasBccHistoryTo(email: string): boolean | Promise<boolean>;
+    addContact(name: string, email: string): boolean | Promise<boolean>;
+    listContacts(query: string, page?: number, pageSize?: number): any | Promise<any>;
+    upsertContact(name: string, email: string): { ok: true } | Promise<{ ok: true }>;
+    deleteContact(email: string): { ok: true } | Promise<{ ok: true }>;
+    addPreferredContact(entry: { name: string; email: string; source?: string; organization?: string }): Promise<void>;
+    addToDenylist(email: string): Promise<void>;
+    loadContactsConfig(): Promise<any>;
+
+    // ── Priority lists / sender reputation ────────────────────────────
+    getPriorityLists(): { senders: string[]; domains: string[] } | Promise<{ senders: string[]; domains: string[] }>;
+    setPrioritySender(email: string, value: boolean, name?: string): Promise<void>;
+    setPriorityDomain(domain: string, value: boolean): Promise<void>;
+    flagSenderOrDomain(type: "sender" | "domain", value: string): Promise<{ flagged: boolean }>;
+    allowRemoteContent(type: "sender" | "domain" | "recipient", value: string): Promise<void>;
+
+    // ── Calendar / tasks ──────────────────────────────────────────────
+    getCalendarEvents(fromMs: number, toMs: number): Promise<any[]>;
+    createCalendarEvent(ev: any): Promise<{ uuid: string }>;
+    updateCalendarEvent(uuid: string, patch: any): Promise<{ ok: true }>;
+    deleteCalendarEvent(uuid: string): Promise<{ ok: true }>;
+    getTasks(includeCompleted?: boolean): Promise<any[]>;
+    createTask(t: { title: string; notes?: string; dueMs?: number }): Promise<{ uuid: string }>;
+    updateTask(uuid: string, patch: any): Promise<{ ok: true }>;
+    deleteTask(uuid: string): Promise<{ ok: true }>;
+
+    // ── User dictionary (cloud-mirrored spellcheck) ───────────────────
+    getUserDict(): Promise<string[]>;
+    addUserDictWord(word: string): Promise<string[]>;
+    removeUserDictWord(word: string): Promise<string[]>;
+
+    // ── Settings / setup / diagnostics ────────────────────────────────
+    getSettings(): any | Promise<any>;
+    saveSettingsData(settings: any): Promise<void>;
+    getDiagnostics(): any | Promise<any>;
+    getPrimaryAccount(feature?: string): any | Promise<any>;
+    setupAccount(name: string, email: string, password?: string): Promise<{ ok: boolean; error?: string; message?: string }>;
+    repairAccounts(): Promise<{ ok: boolean; error?: string; message?: string }>;
+    getAutocompleteSettings(): AutocompleteSettings | Promise<AutocompleteSettings>;
+    saveAutocompleteSettings(settings: AutocompleteSettings): void | Promise<void>;
+
+    // ── AI / autocomplete (ghost text + transforms) ───────────────────
+    autocomplete(req: AutocompleteRequest): Promise<AutocompleteResponse>;
+    aiTransform(req: AiTransformRequest): Promise<AiTransformResponse>;
+
+    // ── Config JSONC editor + help docs ───────────────────────────────
+    readJsoncFile(name: string): Promise<string | null>;
+    writeJsoncFile(name: string, content: string): Promise<void>;
+    formatJsonc(content: string): Promise<string>;
+    readConfigHelp(name: string): Promise<string>;
+
+    // ── External actions (mailto, unsubscribe, restart, etc.) ─────────
+    unsubscribeOneClick(url: string): Promise<{ ok: boolean; status: number; statusText: string }>;
+    consumePendingMailto(): any | Promise<any>;
+    logClientEvent?(...args: any[]): void | Promise<void>;
+    getVersion?(): any | Promise<any>;
+
+    // ── Desktop-only (OS popups, native FS, Word integration) ─────────
+    // Browser/Android services may omit these — declared optional so a
+    // missing implementation on the web side compiles cleanly.
+    openInWord?(editId: string, html: string): Promise<{ ok: boolean; path: string; opener: string }>;
+    closeWordEdit?(editId: string): Promise<void>;
+    showReminderPopup?(opts: any): Promise<{ button: string; form?: any }>;
+    openInTextEditor?(filePath: string): Promise<{ ok: boolean; opener: string; reason?: string }>;
+    openLocalPath?(which: "config" | "log"): Promise<{ ok: true; path: string }>;
+}

package/packages/mailx-types/package.json

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