@bobfrankston/mailx-store-web 0.1.5

package/db.d.ts

@@ -0,0 +1,146 @@
+/**
+ * WebAssembly SQLite metadata index for mailx (Android/browser).
+ * API-compatible with @bobfrankston/mailx-store's MailxDB.
+ * Uses sql.js (SQLite compiled to WebAssembly) for in-browser SQLite.
+ *
+ * Database is persisted to IndexedDB on every write operation.
+ * Bodies are stored in IndexedDB via WebMessageStore (not filesystem).
+ */
+import type { MessageEnvelope, Folder, EmailAddress, PagedResult, MessageQuery } from "@bobfrankston/mailx-types";
+export declare class WebMailxDB {
+    private db;
+    private ready;
+    private saveTimer;
+    constructor(dbName?: string);
+    private init;
+    /** Wait for DB initialization */
+    waitReady(): Promise<void>;
+    /** One-shot junk-contact purge — see desktop equivalent in mailx-store/db.ts.
+     *  Bump TARGET when filter rules tighten so we sweep historical rows once
+     *  per device. Flag stored in localStorage (the web DB has no kv table). */
+    private runOneShotJunkContactPurge;
+    /** Persist DB to IndexedDB (debounced — batches rapid writes) */
+    private scheduleSave;
+    /** Force immediate persist */
+    flush(): Promise<void>;
+    close(): void;
+    private run;
+    private get;
+    private all;
+    private lastId;
+    upsertAccount(id: string, name: string, email: string, configJson: string): void;
+    getAccounts(): {
+        id: string;
+        name: string;
+        email: string;
+        lastSync: number;
+    }[];
+    getAccountConfigs(): {
+        id: string;
+        name: string;
+        email: string;
+        configJson: string;
+    }[];
+    updateLastSync(accountId: string, timestamp: number): void;
+    upsertFolder(accountId: string, folderPath: string, name: string, specialUse: string, delimiter: string): number;
+    getFolders(accountId: string): Folder[];
+    deleteFolder(folderId: number): void;
+    markFolderRead(folderId: number): void;
+    deleteAllMessages(accountId: string, folderId: number): void;
+    updateFolderCounts(folderId: number, total: number, unread: number): void;
+    updateFolderSync(folderId: number, uidvalidity: number, highestModseq: string): void;
+    getFolderSync(folderId: number): {
+        uidvalidity: number;
+        highestModseq: string;
+    };
+    upsertMessage(msg: {
+        accountId: string;
+        folderId: number;
+        uid: number;
+        messageId: string;
+        inReplyTo: string;
+        references: string[];
+        date: number;
+        subject: string;
+        from: EmailAddress;
+        to: EmailAddress[];
+        cc: EmailAddress[];
+        flags: string[];
+        size: number;
+        hasAttachments: boolean;
+        preview: string;
+        bodyPath: string;
+    }): number;
+    getMessages(query: MessageQuery): PagedResult<MessageEnvelope>;
+    getUnifiedInbox(page?: number, pageSize?: number): PagedResult<MessageEnvelope>;
+    getMessageByUid(accountId: string, uid: number, folderId?: number): MessageEnvelope;
+    getMessageBodyPath(accountId: string, uid: number): string;
+    updateMessageFlags(accountId: string, uid: number, flags: string[]): void;
+    updateBodyPath(accountId: string, uid: number, bodyPath: string): void;
+    getMessagesWithoutBody(accountId: string, limit?: number): {
+        uid: number;
+        folderId: number;
+    }[];
+    getHighestUid(accountId: string, folderId: number): number;
+    getOldestDate(accountId: string, folderId: number): number;
+    getMessageCount(accountId: string, folderId: number): number;
+    getUidsForFolder(accountId: string, folderId: number): number[];
+    deleteMessage(accountId: string, uid: number): void;
+    recalcFolderCounts(folderId: number): void;
+    beginTransaction(): void;
+    commitTransaction(): void;
+    rollbackTransaction(): void;
+    /** Delete every contact row tied to a single Google contact identity
+     *  (resourceName like "people/c12345"). Used by the People-API
+     *  incremental sync when Google flags a contact as deleted. A single
+     *  Google contact can have multiple email-rows; remove them all. */
+    deleteContactByGoogleId(googleId: string): number;
+    /** Stamp the google_id + organization on an already-recorded contact row.
+     *  Web side mirrors mailx-store/db.ts — the Google sync calls
+     *  `recordSentAddress` first to upsert, then this to attach the
+     *  Google identity for incremental delete tracking. */
+    setContactGoogleId(email: string, googleId: string, organization: string): void;
+    recordSentAddress(name: string, email: string): void;
+    seedContactsFromMessages(): number;
+    searchContacts(query: string, limit?: number): {
+        name: string;
+        email: string;
+        source: string;
+        useCount: number;
+    }[];
+    /** Address-book listing. Same shape as mailx-store/db.ts:listContacts so
+     *  the address-book modal renders identically on desktop and Android. */
+    listContacts(query: string, page?: number, pageSize?: number): {
+        items: any[];
+        total: number;
+        page: number;
+        pageSize: number;
+    };
+    upsertContact(name: string, email: string): void;
+    deleteContactLocal(email: string): void;
+    /** Q49 heuristic: has the user ever sent to `recipientEmail` with a
+     *  non-empty Cc? Scans Sent folder(s). Used by compose to auto-expand
+     *  the Cc row on reply to a frequent-Cc'd recipient. */
+    hasCcHistoryTo(recipientEmail: string): boolean;
+    searchMessages(query: string, page?: number, pageSize?: number, accountId?: string, folderId?: number): PagedResult<MessageEnvelope>;
+    queueSyncAction(accountId: string, action: string, uid: number, folderId: number, extra?: {
+        targetFolderId?: number;
+        flags?: string[];
+        rawMessage?: string;
+    }): void;
+    getPendingSyncActions(accountId: string): any[];
+    completeSyncAction(id: number): void;
+    failSyncAction(id: number, error: string): void;
+    /** Delete a queued sync action by (accountId, action, uid) — used by the
+     *  send path which tracks queued sends via a unique negative uid rather
+     *  than threading the row id through the async send pipeline. */
+    completeSyncActionByUid(accountId: string, action: string, uid: number): void;
+    /** Mark a send-queue action failed by uid — same tracking-key rationale. */
+    failSyncActionByUid(accountId: string, action: string, uid: number, error: string): void;
+    getPendingSyncCount(accountId: string): number;
+    getTotalPendingSyncCount(): number;
+    /** Reset the entire database */
+    resetStore(): Promise<void>;
+    private rowToEnvelope;
+}
+//# sourceMappingURL=db.d.ts.map

package/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["db.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAoPlH,qBAAa,UAAU;IACnB,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAA8C;gBAEnD,MAAM,SAAU;YAId,IAAI;IAkBlB,iCAAiC;IAC3B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC;;gFAE4E;IAC5E,OAAO,CAAC,0BAA0B;IAoBlC,iEAAiE;IACjE,OAAO,CAAC,YAAY;IAWpB,8BAA8B;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,MAAM;IAOd,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQhF,WAAW,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE;IAI9E,iBAAiB,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE;IAItF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAM1D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAchH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAUvC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOtC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK5D,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAKpF,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;IAO/E,aAAa,CAAC,GAAG,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QACpE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QACvE,IAAI,EAAE,YAAY,CAAC;QAAC,EAAE,EAAE,YAAY,EAAE,CAAC;QAAC,EAAE,EAAE,YAAY,EAAE,CAAC;QAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;KAC7F,GAAG,MAAM;IA0BV,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAAC,eAAe,CAAC;IAuB9D,eAAe,CAAC,IAAI,SAAI,EAAE,QAAQ,SAAK,GAAG,WAAW,CAAC,eAAe,CAAC;IActE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe;IAUnF,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAK1D,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKzE,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKtE,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE;IAa1F,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAM1D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAM1D,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAM5D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAK/D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMnD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ1C,gBAAgB,IAAI,IAAI;IACxB,iBAAiB,IAAI,IAAI;IACzB,mBAAmB,IAAI,IAAI;IAI3B;;;wEAGoE;IACpE,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAOjD;;;2DAGuD;IACvD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAO/E,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAepD,wBAAwB,IAAI,MAAM;IAmBlC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE;IAU9G;6EACyE;IACzE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,EAAE,QAAQ,SAAM,GAAG;QAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAwBtH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAehD,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvC;;4DAEwD;IACxD,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAoB/C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,EAAE,QAAQ,SAAK,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,eAAe,CAAC;IAsB3H,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;QACtF,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAClE,GAAG,IAAI;IAaR,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,EAAE;IAU/C,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAEpC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/C;;qEAEiE;IACjE,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7E,4EAA4E;IAC5E,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxF,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAK9C,wBAAwB,IAAI,MAAM;IAKlC,gCAAgC;IAC1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,OAAO,CAAC,aAAa;CAYxB"}