crewly 1.20.122 → 1.20.124

package/dist/backend/backend/src/services/whatsapp/whatsapp-inbox-capture.js

@@ -0,0 +1,420 @@
+/**
+ * WhatsApp Inbox Capture
+ *
+ * Turns Baileys events into inbox-store rows. Used only in `inbox` mode.
+ * Unlike the assistant path (`WhatsAppService.handleIncomingMessage`) nothing
+ * is dropped for being the owner's own message, a group message, media, or
+ * from a contact outside `allowedContacts` — the inbox has to know whether
+ * the owner already replied, and it is the owner's own account.
+ *
+ * Media are never downloaded: a message is recorded as its kind plus caption
+ * (or file name for documents).
+ *
+ * Baileys shapes relied on (v7, `@whiskeysockets/baileys` typings):
+ * - `messages.upsert`: `{ messages: WAMessage[], type: 'notify' | 'append' }`
+ * - `messaging-history.set`: `{ chats: Chat[], contacts: Contact[], messages: WAMessage[], syncType? }`
+ * - `contacts.upsert` / `contacts.update`: `Contact[]` (`id`, `name` = address book, `notify` = their pushName)
+ * - `chats.upsert` / `chats.update`: `Chat[]` (`id`, `name`, `conversationTimestamp`)
+ * - `groups.upsert` / `groups.update`: `GroupMetadata[]` (`id`, `subject`)
+ * - `WAMessage.key.remoteJidAlt` / `participantAlt` (v7 LID↔PN alternates)
+ * - `messageTimestamp`: seconds, as number, numeric string or protobuf Long
+ *
+ * @module services/whatsapp/whatsapp-inbox-capture
+ */
+import { WHATSAPP_CONSTANTS } from '../../constants.js';
+/** Milliseconds per second (Baileys timestamps are seconds). */
+const MS_PER_SECOND = 1000;
+/** Max wrapper depth unwrapped (ephemeral → viewOnce → ...), as Baileys does. */
+const MAX_UNWRAP_DEPTH = 5;
+/** Wrapper message keys whose `.message` holds the real content. */
+const WRAPPER_KEYS = [
+    'ephemeralMessage',
+    'viewOnceMessage',
+    'viewOnceMessageV2',
+    'viewOnceMessageV2Extension',
+    'documentWithCaptionMessage',
+    'editedMessage',
+];
+/**
+ * Content keys that are not user-visible messages (receipts of protocol
+ * work, reactions, key distribution). A message carrying only these is not
+ * stored.
+ */
+const NON_MESSAGE_KEYS = new Set([
+    'protocolMessage',
+    'reactionMessage',
+    'senderKeyDistributionMessage',
+    'messageContextInfo',
+    'pollUpdateMessage',
+    'keepInChatMessage',
+    'encReactionMessage',
+]);
+/**
+ * Narrow an unknown to a plain object.
+ *
+ * @param v - Anything
+ * @returns The object, or undefined
+ */
+function asRec(v) {
+    return v && typeof v === 'object' ? v : undefined;
+}
+/**
+ * Read a non-empty string field.
+ *
+ * @param v - Anything
+ * @returns The string, or undefined when absent/blank
+ */
+function str(v) {
+    return typeof v === 'string' && v.length > 0 ? v : undefined;
+}
+/**
+ * Convert a Baileys timestamp (seconds as number, numeric string, or
+ * protobuf Long with `toNumber()` / `low`+`high`) to epoch ms.
+ *
+ * @param ts - Raw timestamp
+ * @returns Epoch ms, or null when unparseable / non-positive
+ */
+export function toEpochMs(ts) {
+    let seconds = null;
+    if (typeof ts === 'number')
+        seconds = ts;
+    else if (typeof ts === 'bigint')
+        seconds = Number(ts);
+    else if (typeof ts === 'string' && /^\d+$/.test(ts))
+        seconds = Number(ts);
+    else {
+        const r = asRec(ts);
+        if (r && typeof r.toNumber === 'function')
+            seconds = r.toNumber();
+        else if (r && typeof r.low === 'number') {
+            const high = typeof r.high === 'number' ? r.high : 0;
+            seconds = high * 2 ** 32 + (r.low >>> 0);
+        }
+    }
+    if (seconds === null || !Number.isFinite(seconds) || seconds <= 0)
+        return null;
+    return Math.round(seconds * MS_PER_SECOND);
+}
+/**
+ * Whether a JID is a group chat.
+ *
+ * @param jid - JID
+ * @returns True for `...@g.us`
+ */
+export function isGroupJid(jid) {
+    return jid.endsWith(WHATSAPP_CONSTANTS.GROUP_JID_SUFFIX);
+}
+/**
+ * Pick the canonical JID for a person: prefer the phone-number form when
+ * Baileys supplies it as the alternate of a LID, so the same person's
+ * messages (some keyed by LID, some by phone number) land in one chat.
+ *
+ * @param jid - Primary JID (`remoteJid` / `participant`)
+ * @param alt - Alternate JID (`remoteJidAlt` / `participantAlt`)
+ * @returns The canonical JID
+ */
+export function canonicalJid(jid, alt) {
+    if (jid.endsWith(WHATSAPP_CONSTANTS.LID_JID_SUFFIX) && alt && alt.endsWith(WHATSAPP_CONSTANTS.USER_JID_SUFFIX)) {
+        return alt;
+    }
+    return jid;
+}
+/**
+ * Strip wrapper messages (disappearing, view-once, edited, doc-with-caption).
+ *
+ * @param content - `WAMessage.message`
+ * @returns The innermost content object, or undefined
+ */
+export function unwrapMessageContent(content) {
+    let cur = asRec(content);
+    for (let i = 0; i < MAX_UNWRAP_DEPTH && cur; i++) {
+        let inner;
+        for (const k of WRAPPER_KEYS) {
+            inner = asRec(asRec(cur[k])?.message);
+            if (inner)
+                break;
+        }
+        if (!inner)
+            break;
+        cur = inner;
+    }
+    return cur;
+}
+/**
+ * Classify message content into a stored kind and its text/caption.
+ *
+ * @param content - `WAMessage.message` (wrappers allowed)
+ * @returns `{ kind, text }`, or null when this is not a user-visible message
+ *   (protocol message, reaction, empty envelope)
+ */
+export function classifyMessageContent(content) {
+    const c = unwrapMessageContent(content);
+    if (!c)
+        return null;
+    const K = WHATSAPP_CONSTANTS.MESSAGE_KINDS;
+    const conversation = str(c.conversation);
+    if (conversation)
+        return { kind: K.TEXT, text: conversation };
+    const ext = asRec(c.extendedTextMessage);
+    if (ext)
+        return { kind: K.TEXT, text: str(ext.text) ?? '' };
+    const image = asRec(c.imageMessage);
+    if (image)
+        return { kind: K.IMAGE, text: str(image.caption) ?? '' };
+    const video = asRec(c.videoMessage) ?? asRec(c.ptvMessage);
+    if (video)
+        return { kind: K.VIDEO, text: str(video.caption) ?? '' };
+    const doc = asRec(c.documentMessage);
+    if (doc)
+        return { kind: K.DOCUMENT, text: str(doc.caption) ?? str(doc.fileName) ?? str(doc.title) ?? '' };
+    if (asRec(c.audioMessage))
+        return { kind: K.AUDIO, text: '' };
+    if (asRec(c.stickerMessage))
+        return { kind: K.STICKER, text: '' };
+    const visibleKeys = Object.keys(c).filter((k) => c[k] !== null && c[k] !== undefined && !NON_MESSAGE_KEYS.has(k));
+    if (visibleKeys.length === 0)
+        return null;
+    return { kind: K.OTHER, text: '' };
+}
+/**
+ * Parse a Baileys `WAMessage` into an inbox row.
+ *
+ * @param raw - The WAMessage
+ * @param ownJid - The connected account's JID (sender of `fromMe` messages), if known
+ * @returns The parsed message, or null when it is not storable (no id/chat,
+ *   status broadcast, protocol-only content, no timestamp)
+ */
+export function parseBaileysMessage(raw, ownJid) {
+    const r = asRec(raw);
+    const key = asRec(r?.key);
+    const remoteJid = str(key?.remoteJid);
+    const id = str(key?.id);
+    if (!r || !key || !remoteJid || !id)
+        return null;
+    if (remoteJid === WHATSAPP_CONSTANTS.STATUS_BROADCAST_JID)
+        return null;
+    const classified = classifyMessageContent(r.message);
+    if (!classified)
+        return null;
+    const ts = toEpochMs(r.messageTimestamp);
+    if (ts === null)
+        return null;
+    const fromMe = key.fromMe === true;
+    const chatId = canonicalJid(remoteJid, str(key.remoteJidAlt));
+    const isGroup = isGroupJid(chatId);
+    const participant = str(key.participant);
+    const pushName = fromMe ? null : (str(r.pushName) ?? null);
+    let senderJid;
+    if (fromMe)
+        senderJid = ownJid ?? null;
+    else if (isGroup)
+        senderJid = participant ? canonicalJid(participant, str(key.participantAlt)) : null;
+    else
+        senderJid = chatId;
+    return {
+        message: {
+            id,
+            chatId,
+            fromMe,
+            senderJid,
+            senderName: pushName,
+            text: classified.text,
+            ts,
+            kind: classified.kind,
+        },
+        isGroup,
+        pushName,
+    };
+}
+/**
+ * Chat row from a Baileys `Contact`: the address-book name outranks the
+ * contact's own pushName (`notify`) and business `verifiedName`.
+ *
+ * @param contact - Contact (full or partial update)
+ * @returns Upsert input, or null when the contact names nothing useful
+ */
+export function chatFromContact(contact) {
+    const c = asRec(contact);
+    const rawId = str(c?.id);
+    if (!c || !rawId)
+        return null;
+    const id = canonicalJid(rawId, str(c.phoneNumber));
+    const R = WHATSAPP_CONSTANTS.NAME_RANKS;
+    const saved = str(c.name);
+    if (saved)
+        return { id, name: saved, nameRank: R.CONTACT };
+    const other = str(c.notify) ?? str(c.verifiedName);
+    if (other)
+        return { id, name: other, nameRank: R.PUSH_NAME };
+    return null;
+}
+/**
+ * Chat row from a Baileys `Chat` (history sync, `chats.upsert/update`).
+ *
+ * @param chat - Chat
+ * @returns Upsert input, or null without an id / for the status pseudo-chat
+ */
+export function chatFromChat(chat) {
+    const c = asRec(chat);
+    const id = str(c?.id);
+    if (!c || !id || id === WHATSAPP_CONSTANTS.STATUS_BROADCAST_JID)
+        return null;
+    return {
+        id,
+        name: str(c.name) ?? null,
+        nameRank: WHATSAPP_CONSTANTS.NAME_RANKS.CHAT,
+        isGroup: isGroupJid(id),
+        lastMessageAt: toEpochMs(c.conversationTimestamp),
+    };
+}
+/**
+ * Chat row from Baileys `GroupMetadata` (subject = group name).
+ *
+ * @param group - Group metadata (full or partial)
+ * @returns Upsert input, or null without an id
+ */
+export function chatFromGroup(group) {
+    const g = asRec(group);
+    const id = str(g?.id);
+    if (!g || !id)
+        return null;
+    return { id, name: str(g.subject) ?? null, nameRank: WHATSAPP_CONSTANTS.NAME_RANKS.CHAT, isGroup: true };
+}
+/**
+ * Writes Baileys events into a {@link WhatsAppInboxStore}.
+ *
+ * Every handler is defensive: a malformed payload is skipped, never thrown,
+ * because it runs inside the socket's event loop.
+ */
+export class WhatsAppInboxCapture {
+    store;
+    opts;
+    groupLookups = new Set();
+    /**
+     * @param store - Destination store
+     * @param opts - Own-JID accessor, group-subject fetcher, clock
+     */
+    constructor(store, opts = {}) {
+        this.store = store;
+        this.opts = opts;
+    }
+    /**
+     * Store one message and name its chat.
+     *
+     * @param raw - A WAMessage
+     * @returns True when stored
+     */
+    captureMessage(raw) {
+        const parsed = parseBaileysMessage(raw, this.opts.getOwnJid?.() ?? null);
+        if (!parsed)
+            return false;
+        const { message, isGroup, pushName } = parsed;
+        // In a 1:1 chat the sender's pushName is a (weak) name for the chat.
+        this.store.upsertChat({
+            id: message.chatId,
+            isGroup,
+            name: !isGroup ? pushName : null,
+            nameRank: WHATSAPP_CONSTANTS.NAME_RANKS.PUSH_NAME,
+            lastMessageAt: message.ts,
+        });
+        this.store.upsertMessage(message);
+        if (isGroup)
+            this.maybeFetchGroupName(message.chatId);
+        return true;
+    }
+    /**
+     * Handle `messages.upsert` (both `notify` and `append`: own messages sent
+     * from the phone and backfills arrive as `append`).
+     *
+     * @param upsert - `{ messages, type }`
+     * @returns Number of messages stored
+     */
+    onMessagesUpsert(upsert) {
+        const messages = asRec(upsert)?.messages;
+        if (!Array.isArray(messages))
+            return 0;
+        let n = 0;
+        for (const m of messages)
+            if (this.captureMessage(m))
+                n++;
+        return n;
+    }
+    /**
+     * Handle `messaging-history.set`: seed chats, contact names and recent
+     * messages. Messages older than `HISTORY_SYNC_MAX_AGE_MS` are skipped.
+     *
+     * @param payload - `{ chats, contacts, messages }`
+     * @returns Number of messages stored
+     */
+    onHistorySet(payload) {
+        const p = asRec(payload);
+        if (!p)
+            return 0;
+        const chats = (Array.isArray(p.chats) ? p.chats : []).map(chatFromChat).filter((c) => c !== null);
+        const contacts = (Array.isArray(p.contacts) ? p.contacts : [])
+            .map(chatFromContact)
+            .filter((c) => c !== null);
+        this.store.upsertChats([...chats, ...contacts]);
+        const cutoff = (this.opts.now?.() ?? Date.now()) - WHATSAPP_CONSTANTS.HISTORY_SYNC_MAX_AGE_MS;
+        const ownJid = this.opts.getOwnJid?.() ?? null;
+        const parsed = (Array.isArray(p.messages) ? p.messages : [])
+            .map((m) => parseBaileysMessage(m, ownJid))
+            .filter((m) => m !== null && m.message.ts >= cutoff);
+        this.store.upsertChats(parsed
+            .filter((m) => !m.isGroup && m.pushName)
+            .map((m) => ({ id: m.message.chatId, name: m.pushName, nameRank: WHATSAPP_CONSTANTS.NAME_RANKS.PUSH_NAME })));
+        return this.store.upsertMessages(parsed.map((m) => m.message));
+    }
+    /**
+     * Handle `contacts.upsert` / `contacts.update`.
+     *
+     * @param contacts - Contact list
+     */
+    onContacts(contacts) {
+        if (!Array.isArray(contacts))
+            return;
+        this.store.upsertChats(contacts.map(chatFromContact).filter((c) => c !== null));
+    }
+    /**
+     * Handle `chats.upsert` / `chats.update`.
+     *
+     * @param chats - Chat list
+     */
+    onChats(chats) {
+        if (!Array.isArray(chats))
+            return;
+        this.store.upsertChats(chats.map(chatFromChat).filter((c) => c !== null));
+    }
+    /**
+     * Handle `groups.upsert` / `groups.update`.
+     *
+     * @param groups - Group metadata list
+     */
+    onGroups(groups) {
+        if (!Array.isArray(groups))
+            return;
+        this.store.upsertChats(groups.map(chatFromGroup).filter((c) => c !== null));
+    }
+    /**
+     * Look a group's subject up once per process when we have no name for it.
+     *
+     * @param jid - Group JID
+     */
+    maybeFetchGroupName(jid) {
+        const fetcher = this.opts.fetchGroupSubject;
+        if (!fetcher || this.groupLookups.has(jid))
+            return;
+        if (this.store.getChat(jid)?.name)
+            return;
+        this.groupLookups.add(jid);
+        fetcher(jid)
+            .then((subject) => {
+            if (subject)
+                this.store.upsertChat({ id: jid, name: subject, nameRank: WHATSAPP_CONSTANTS.NAME_RANKS.CHAT, isGroup: true });
+        })
+            .catch(() => {
+            // Best effort — the chat keeps its JID as the label.
+        });
+    }
+}
+//# sourceMappingURL=whatsapp-inbox-capture.js.map

package/dist/backend/backend/src/services/whatsapp/whatsapp-inbox-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-inbox-capture.js","sourceRoot":"","sources":["../../../../../../backend/src/services/whatsapp/whatsapp-inbox-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,gEAAgE;AAChE,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,iFAAiF;AACjF,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,oEAAoE;AACpE,MAAM,YAAY,GAAG;IACnB,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,4BAA4B;IAC5B,4BAA4B;IAC5B,eAAe;CACP,CAAC;AAEX;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,iBAAiB;IACjB,iBAAiB;IACjB,8BAA8B;IAC9B,oBAAoB;IACpB,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;CACrB,CAAC,CAAC;AAKH;;;;;GAKG;AACH,SAAS,KAAK,CAAC,CAAU;IACvB,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,EAAW;IACnC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,GAAG,EAAE,CAAC;SACpC,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;SACjD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;SACrE,CAAC;QACJ,MAAM,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU;YAAE,OAAO,GAAI,CAAC,CAAC,QAAyB,EAAE,CAAC;aAC/E,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,GAAY;IACpD,IAAI,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,cAAc,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,CAAC;QAC/G,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,IAAI,KAAsB,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACtC,IAAI,KAAK;gBAAE,MAAM;QACnB,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,MAAM;QAClB,GAAG,GAAG,KAAK,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,kBAAkB,CAAC,aAAa,CAAC;IAE3C,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,YAAY;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACzC,IAAI,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IAE5D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACpC,IAAI,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IACpE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IACpE,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACrC,IAAI,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;IAC1G,IAAI,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC9D,IAAI,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAElE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACrC,CAAC;AAYD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY,EAAE,MAAsB;IACtE,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1B,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,SAAS,KAAK,kBAAkB,CAAC,oBAAoB;QAAE,OAAO,IAAI,CAAC;IAEvE,MAAM,UAAU,GAAG,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzC,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;IAE3D,IAAI,SAAwB,CAAC;IAC7B,IAAI,MAAM;QAAE,SAAS,GAAG,MAAM,IAAI,IAAI,CAAC;SAClC,IAAI,OAAO;QAAE,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;;QACjG,SAAS,GAAG,MAAM,CAAC;IAExB,OAAO;QACL,OAAO,EAAE;YACP,EAAE;YACF,MAAM;YACN,MAAM;YACN,SAAS;YACT,UAAU,EAAE,QAAQ;YACpB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,EAAE;YACF,IAAI,EAAE,UAAU,CAAC,IAAI;SACtB;QACD,OAAO;QACP,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzB,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,GAAG,kBAAkB,CAAC,UAAU,CAAC;IACxC,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,kBAAkB,CAAC,oBAAoB;QAAE,OAAO,IAAI,CAAC;IAC7E,OAAO;QACL,EAAE;QACF,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI;QACzB,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,IAAI;QAC5C,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACvB,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC;KAClD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3G,CAAC;AAYD;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IACd,KAAK,CAAqB;IAC1B,IAAI,CAA8B;IAClC,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAElD;;;OAGG;IACH,YAAY,KAAyB,EAAE,OAAoC,EAAE;QAC3E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,GAAY;QACzB,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC9C,qEAAqE;QACrE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YACpB,EAAE,EAAE,OAAO,CAAC,MAAM;YAClB,OAAO;YACP,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;YAChC,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,SAAS;YACjD,aAAa,EAAE,OAAO,CAAC,EAAE;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,OAAO;YAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAe;QAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;gBAAE,CAAC,EAAE,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,OAAgB;QAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;QACjB,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACxH,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3D,GAAG,CAAC,eAAe,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,kBAAkB,CAAC,uBAAuB,CAAC;QAC9F,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,IAAI,CAAC;QAC/C,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;aAC1C,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,MAAM,CAAC,CAAC;QACnF,IAAI,CAAC,KAAK,CAAC,WAAW,CACpB,MAAM;aACH,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC;aACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAC/G,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,QAAiB;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO;QACrC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IACxG,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,KAAc;QACpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO;QAClC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAClG,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,MAAe;QACtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO;QACnC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IACpG,CAAC;IAED;;;;OAIG;IACK,mBAAmB,CAAC,GAAW;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC5C,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QACnD,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI;YAAE,OAAO;QAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC;aACT,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YAChB,IAAI,OAAO;gBAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9H,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,qDAAqD;QACvD,CAAC,CAAC,CAAC;IACP,CAAC;CACF"}

package/dist/backend/backend/src/services/whatsapp/whatsapp-inbox.store.d.ts

@@ -0,0 +1,243 @@
+/**
+ * WhatsApp Inbox Store
+ *
+ * Local SQLite store behind the WhatsApp inbox connector: the chats and
+ * messages captured from the owner's personal account (read-only), and the
+ * reply drafts agents propose. Lives at `~/.crewly/whatsapp/inbox.db`
+ * (resolved through `getCrewlyHomePath()`, so `CREWLY_HOME` isolates it).
+ *
+ * Nothing in here talks to WhatsApp. Sending a draft is the controller's
+ * job, gated on the owner's confirmation; this store only records the
+ * draft's lifecycle (`pending` → `sending` → `sent` / back to `pending`,
+ * or `discarded`) with an atomic claim so a draft can never be sent twice.
+ *
+ * @module services/whatsapp/whatsapp-inbox.store
+ */
+import type { WhatsAppDraft, WhatsAppDraftStatus, WhatsAppInboxChat, WhatsAppInboxEntry, WhatsAppInboxMessage, WhatsAppSearchHit } from '../../types/whatsapp.types.js';
+/** In-memory database name accepted by better-sqlite3 (tests). */
+export declare const IN_MEMORY_DB = ":memory:";
+/** Input for {@link WhatsAppInboxStore.upsertChat}. */
+export interface UpsertChatInput {
+    /** Chat JID */
+    id: string;
+    /** Display name, if this source knows one */
+    name?: string | null;
+    /** Provenance of `name` (see `WHATSAPP_CONSTANTS.NAME_RANKS`); a lower rank never overwrites a higher one */
+    nameRank?: number;
+    /** Whether the chat is a group (defaults from the JID suffix) */
+    isGroup?: boolean;
+    /** Epoch ms of the newest message this source knows of (only ever moves forward) */
+    lastMessageAt?: number | null;
+}
+/** Options for {@link WhatsAppInboxStore.listInbox}. */
+export interface ListInboxOptions {
+    /** Row cap */
+    limit: number;
+    /** Include group chats (default false — groups are noisy) */
+    includeGroups?: boolean;
+}
+/**
+ * Resolve the default inbox database path under the Crewly home.
+ *
+ * @returns Absolute path to `<crewly home>/whatsapp/inbox.db`
+ */
+export declare function getDefaultInboxDbPath(): string;
+/**
+ * Format a draft sequence number as its human code.
+ *
+ * @param seq - Monotonic sequence number
+ * @returns Code such as `W12`
+ */
+export declare function formatDraftCode(seq: number): string;
+/**
+ * Parse a user-typed draft code (`W12`, `w12`, `#W12`, `12`) into its sequence number.
+ *
+ * @param raw - The code as typed
+ * @returns The sequence number, or null when the text is not a draft code
+ */
+export declare function parseDraftCode(raw: string): number | null;
+/**
+ * SQLite-backed store for the WhatsApp inbox and reply drafts.
+ *
+ * @example
+ * ```typescript
+ * const store = new WhatsAppInboxStore(':memory:');
+ * store.upsertMessage({ id: 'm1', chatId: '1@s.whatsapp.net', fromMe: false, senderJid: null,
+ *   senderName: 'Ann', text: 'hi', ts: Date.now(), kind: 'text' });
+ * store.listInbox({ limit: 20 }); // → [{ chat, unansweredCount: 1, ... }]
+ * ```
+ */
+export declare class WhatsAppInboxStore {
+    private readonly db;
+    /**
+     * Open (and migrate) the inbox database.
+     *
+     * @param dbPath - File path, or `:memory:` for tests. The parent directory
+     *   is created owner-only (0700) and the file is chmod 0600.
+     * @throws NativeBindingFatalError when better-sqlite3 cannot load
+     */
+    constructor(dbPath?: string);
+    /**
+     * Close the database handle.
+     */
+    close(): void;
+    /**
+     * Insert or update a chat.
+     *
+     * The name only changes when the new source ranks at least as high as the
+     * one that set the current name (an address-book name is never replaced by
+     * a pushName). `lastMessageAt` only moves forward.
+     *
+     * @param input - Chat fields known by this source
+     */
+    upsertChat(input: UpsertChatInput): void;
+    /**
+     * Insert or update one message (idempotent on the message id) and advance
+     * its chat's `lastMessageAt`, creating the chat row if needed.
+     *
+     * A re-delivered message keeps its original `fromMe`, chat and timestamp;
+     * text, kind and a newly learned sender name are refreshed (edits, late
+     * pushNames).
+     *
+     * @param msg - The message
+     */
+    upsertMessage(msg: WhatsAppInboxMessage): void;
+    /**
+     * Upsert many messages in one transaction (history sync).
+     *
+     * @param msgs - Messages
+     * @returns How many were written
+     */
+    upsertMessages(msgs: WhatsAppInboxMessage[]): number;
+    /**
+     * Upsert many chats in one transaction.
+     *
+     * @param chats - Chats
+     */
+    upsertChats(chats: UpsertChatInput[]): void;
+    /**
+     * Look up one chat.
+     *
+     * @param id - Chat JID
+     * @returns The chat, or null
+     */
+    getChat(id: string): WhatsAppInboxChat | null;
+    /**
+     * Chats that need a reply: the newest message is not the owner's.
+     *
+     * `unansweredCount` counts inbound messages after the owner's last message
+     * in that chat (all of them when the owner never wrote there).
+     *
+     * @param opts - Limit and whether to include groups
+     * @returns Entries, newest first
+     */
+    listInbox(opts: ListInboxOptions): WhatsAppInboxEntry[];
+    /**
+     * Recent chats, optionally filtered by name or JID substring.
+     *
+     * @param opts - Limit and optional query
+     * @returns Chats, most recently active first (chats with no messages last)
+     */
+    listChats(opts: {
+        limit: number;
+        q?: string;
+    }): WhatsAppInboxChat[];
+    /**
+     * One page of a chat's messages, in chronological order.
+     *
+     * @param chatId - Chat JID
+     * @param opts - Page size and an exclusive upper bound (epoch ms) for paging back
+     * @returns The newest `limit` messages older than `before`, oldest first
+     */
+    listMessages(chatId: string, opts: {
+        limit: number;
+        before?: number;
+    }): WhatsAppInboxMessage[];
+    /**
+     * Substring search over message text (case-insensitive for ASCII).
+     *
+     * @param q - Search text (must be non-empty)
+     * @param limit - Row cap
+     * @returns Hits, newest first
+     */
+    search(q: string, limit: number): WhatsAppSearchHit[];
+    /**
+     * Record a reply draft with the next monotonic code.
+     *
+     * @param input - Recipient, text, author session (null = owner) and clock
+     * @returns The stored draft (status `pending`)
+     */
+    createDraft(input: {
+        chatId: string;
+        text: string;
+        createdBy: string | null;
+        now: number;
+    }): WhatsAppDraft;
+    /**
+     * Look up a draft by its opaque id.
+     *
+     * @param id - Draft id
+     * @returns The draft, or null
+     */
+    getDraftById(id: string): WhatsAppDraft | null;
+    /**
+     * Look up a draft by id or by human code (`W12`, `12`, `#W12`).
+     *
+     * @param ref - Id or code
+     * @returns The draft, or null
+     */
+    findDraft(ref: string): WhatsAppDraft | null;
+    /**
+     * List drafts, newest first.
+     *
+     * @param opts - Optional status filter and row cap
+     * @returns Drafts
+     */
+    listDrafts(opts: {
+        status?: WhatsAppDraftStatus;
+        limit: number;
+    }): WhatsAppDraft[];
+    /**
+     * Atomically move a draft from `pending` to `sending`.
+     *
+     * Only one caller can win: this is what makes "a draft can't be sent twice"
+     * hold under concurrent requests.
+     *
+     * @param id - Draft id
+     * @returns True when this caller now holds the send claim
+     */
+    claimDraftForSend(id: string): boolean;
+    /**
+     * Mark a claimed draft as sent.
+     *
+     * @param id - Draft id
+     * @param now - Epoch ms of the send
+     */
+    markDraftSent(id: string, now: number): void;
+    /**
+     * Return a claimed draft to `pending` after a failed send, keeping the error.
+     *
+     * @param id - Draft id
+     * @param error - Why the send failed
+     */
+    releaseDraftClaim(id: string, error: string): void;
+    /**
+     * Discard a pending draft.
+     *
+     * @param id - Draft id
+     * @param now - Epoch ms
+     * @returns True when the draft was pending and is now discarded
+     */
+    discardDraft(id: string, now: number): boolean;
+}
+/**
+ * Get the process-wide inbox store, opening it on first use.
+ *
+ * @returns The store at {@link getDefaultInboxDbPath}
+ */
+export declare function getWhatsAppInboxStore(): WhatsAppInboxStore;
+/**
+ * Close and forget the process-wide store (tests, shutdown).
+ */
+export declare function resetWhatsAppInboxStore(): void;
+//# sourceMappingURL=whatsapp-inbox.store.d.ts.map

package/dist/backend/backend/src/services/whatsapp/whatsapp-inbox.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-inbox.store.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/whatsapp/whatsapp-inbox.store.ts"],"names":[],"mappings":"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"}