crewly 1.20.121 → 1.20.123

package/dist/backend/backend/src/services/whatsapp/whatsapp-connection-config.js

@@ -0,0 +1,108 @@
+/**
+ * WhatsApp Connection Config Persistence
+ *
+ * Stores how the owner last connected WhatsApp (mode, allowed contacts,
+ * whether to reconnect on boot) at `~/.crewly/whatsapp/connection.json`, so
+ * a restart keeps inbox mode instead of silently falling back to the
+ * auto-replying assistant.
+ *
+ * @module services/whatsapp/whatsapp-connection-config
+ */
+import { promises as fs, existsSync } from 'fs';
+import path from 'path';
+import { WHATSAPP_CONSTANTS } from '../../constants.js';
+import { getCrewlyHomePath } from '../core/crewly-home.utils.js';
+import { isWhatsAppMode } from '../../types/whatsapp.types.js';
+/** Owner-only file mode for the config file. */
+const PRIVATE_FILE_MODE = 0o600;
+const PRIVATE_DIR_MODE = 0o700;
+/**
+ * Path of the persisted connection config.
+ *
+ * @returns `<crewly home>/whatsapp/connection.json`
+ */
+export function getConnectionConfigPath() {
+    return path.join(getCrewlyHomePath(), WHATSAPP_CONSTANTS.DATA_DIR, WHATSAPP_CONSTANTS.CONNECTION_CONFIG_FILE);
+}
+/**
+ * Read the persisted connection config.
+ *
+ * @returns The config, or null when absent, unreadable or malformed
+ */
+export async function loadWhatsAppConnection() {
+    const file = getConnectionConfigPath();
+    try {
+        if (!existsSync(file))
+            return null;
+        const parsed = JSON.parse(await fs.readFile(file, 'utf8'));
+        if (!parsed || typeof parsed !== 'object')
+            return null;
+        const p = parsed;
+        if (!isWhatsAppMode(p.mode))
+            return null;
+        return {
+            mode: p.mode,
+            autoConnect: p.autoConnect === true,
+            allowedContacts: Array.isArray(p.allowedContacts)
+                ? p.allowedContacts.filter((c) => typeof c === 'string')
+                : undefined,
+            phoneNumber: typeof p.phoneNumber === 'string' ? p.phoneNumber : undefined,
+            authStatePath: typeof p.authStatePath === 'string' ? p.authStatePath : undefined,
+            updatedAt: typeof p.updatedAt === 'number' ? p.updatedAt : 0,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Persist the config a connection was started with (auto-connect on).
+ *
+ * @param config - The config passed to `WhatsAppService.initialize`
+ * @param mode - The resolved mode
+ */
+export async function saveWhatsAppConnection(config, mode) {
+    const record = {
+        mode,
+        autoConnect: true,
+        allowedContacts: config.allowedContacts,
+        phoneNumber: config.phoneNumber,
+        authStatePath: config.authStatePath,
+        updatedAt: Date.now(),
+    };
+    await writeConnection(record);
+}
+/**
+ * Turn auto-connect off after an explicit disconnect, keeping the mode.
+ */
+export async function markWhatsAppDisconnected() {
+    const current = await loadWhatsAppConnection();
+    if (!current)
+        return;
+    await writeConnection({ ...current, autoConnect: false, updatedAt: Date.now() });
+}
+/**
+ * Convert a persisted record into a service config.
+ *
+ * @param persisted - Stored record
+ * @returns Config for `WhatsAppService.initialize`
+ */
+export function toWhatsAppConfig(persisted) {
+    return {
+        mode: persisted.mode,
+        allowedContacts: persisted.allowedContacts,
+        phoneNumber: persisted.phoneNumber,
+        authStatePath: persisted.authStatePath,
+    };
+}
+/**
+ * Write the record owner-only.
+ *
+ * @param record - Record to write
+ */
+async function writeConnection(record) {
+    const file = getConnectionConfigPath();
+    await fs.mkdir(path.dirname(file), { recursive: true, mode: PRIVATE_DIR_MODE });
+    await fs.writeFile(file, JSON.stringify(record, null, 2), { mode: PRIVATE_FILE_MODE });
+}
+//# sourceMappingURL=whatsapp-connection-config.js.map

package/dist/backend/backend/src/services/whatsapp/whatsapp-connection-config.js.map

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

package/dist/backend/backend/src/services/whatsapp/whatsapp-draft-gate.d.ts

@@ -0,0 +1,74 @@
+/**
+ * WhatsApp Draft Send Gate
+ *
+ * Decides whether a reply draft may be sent. Owner decision (2026-09-24):
+ * nothing is ever sent to WhatsApp without the owner's explicit
+ * confirmation, one message at a time.
+ *
+ * - A request with no `X-Agent-Session` header is the owner (dashboard,
+ *   mobile, portal) — the click is the confirmation.
+ * - An agent may send only when a genuine owner chat message (from
+ *   `ChatV2Service.getRecentOwnerMessageContents`, which agents cannot
+ *   write) created after the draft says 「发 W12」 for this draft's code, and
+ *   the draft is at most `DRAFT_CONFIRM_WINDOW_MS` old. Because the owner
+ *   message must post-date the draft, bounding the draft's age also bounds
+ *   the confirmation to that window.
+ *
+ * @module services/whatsapp/whatsapp-draft-gate
+ */
+import type { WhatsAppDraft } from '../../types/whatsapp.types.js';
+/** Why an agent's send was refused. */
+export type DraftSendRefusal = 'no_confirmation' | 'window_expired';
+/** Outcome of {@link decideDraftSend}. */
+export type DraftSendDecision = {
+    allowed: true;
+    via: 'owner' | 'owner_confirmation';
+    confirmation?: string;
+} | {
+    allowed: false;
+    reason: DraftSendRefusal;
+};
+/** Inputs for {@link decideDraftSend}. */
+export interface DraftSendContext {
+    /** The draft (must be pending — checked by the caller) */
+    draft: WhatsAppDraft;
+    /** `X-Agent-Session` of the caller; undefined = owner */
+    agentSession: string | undefined;
+    /** Owner message texts created at/after `sinceMs`, newest first */
+    ownerMessagesSince: (sinceMs: number) => string[];
+    /** Current epoch ms */
+    now: number;
+}
+/**
+ * Whether one owner message confirms sending a given draft.
+ *
+ * @param text - Owner message text
+ * @param draft - The draft
+ * @returns True for 「发 W12」 / 「发送 12」 / "send #W12" / 「确认发送 W12」 naming this draft
+ */
+export declare function isConfirmationFor(text: string, draft: Pick<WhatsAppDraft, 'seq'>): boolean;
+/**
+ * Decide whether the caller may send this draft now.
+ *
+ * @param ctx - Draft, caller, owner-message source, clock
+ * @returns Allowed (and why), or refused (and why)
+ */
+export declare function decideDraftSend(ctx: DraftSendContext): DraftSendDecision;
+/**
+ * The instruction an agent must follow after drafting: show the owner the
+ * draft and ask for 「发 <code>」.
+ *
+ * @param draft - The draft
+ * @param recipient - Human label for the recipient (chat name or JID)
+ * @returns Instruction text
+ */
+export declare function buildOwnerConfirmPrompt(draft: Pick<WhatsAppDraft, 'code' | 'text'>, recipient: string): string;
+/**
+ * Human message for a refused agent send.
+ *
+ * @param draft - The draft
+ * @param reason - Refusal reason
+ * @returns Message for the 403 body
+ */
+export declare function buildRefusalMessage(draft: Pick<WhatsAppDraft, 'code'>, reason: DraftSendRefusal): string;
+//# sourceMappingURL=whatsapp-draft-gate.d.ts.map

package/dist/backend/backend/src/services/whatsapp/whatsapp-draft-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-draft-gate.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/whatsapp/whatsapp-draft-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAMnE,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEpE,0CAA0C;AAC1C,MAAM,MAAM,iBAAiB,GACzB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEjD,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,KAAK,EAAE,aAAa,CAAC;IACrB,yDAAyD;IACzD,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,mEAAmE;IACnE,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAClD,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,OAAO,CAI1F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,iBAAiB,CASxE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9G;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAYxG"}

package/dist/backend/backend/src/services/whatsapp/whatsapp-draft-gate.js

@@ -0,0 +1,82 @@
+/**
+ * WhatsApp Draft Send Gate
+ *
+ * Decides whether a reply draft may be sent. Owner decision (2026-09-24):
+ * nothing is ever sent to WhatsApp without the owner's explicit
+ * confirmation, one message at a time.
+ *
+ * - A request with no `X-Agent-Session` header is the owner (dashboard,
+ *   mobile, portal) — the click is the confirmation.
+ * - An agent may send only when a genuine owner chat message (from
+ *   `ChatV2Service.getRecentOwnerMessageContents`, which agents cannot
+ *   write) created after the draft says 「发 W12」 for this draft's code, and
+ *   the draft is at most `DRAFT_CONFIRM_WINDOW_MS` old. Because the owner
+ *   message must post-date the draft, bounding the draft's age also bounds
+ *   the confirmation to that window.
+ *
+ * @module services/whatsapp/whatsapp-draft-gate
+ */
+import { WHATSAPP_CONSTANTS } from '../../constants.js';
+import { parseDraftCode } from './whatsapp-inbox.store.js';
+/** Milliseconds per minute (for human-readable window text). */
+const MS_PER_MINUTE = 60 * 1000;
+/**
+ * Whether one owner message confirms sending a given draft.
+ *
+ * @param text - Owner message text
+ * @param draft - The draft
+ * @returns True for 「发 W12」 / 「发送 12」 / "send #W12" / 「确认发送 W12」 naming this draft
+ */
+export function isConfirmationFor(text, draft) {
+    const m = WHATSAPP_CONSTANTS.DRAFT_CONFIRM_PATTERN.exec(text.trim());
+    if (!m)
+        return false;
+    return parseDraftCode(m[2]) === draft.seq;
+}
+/**
+ * Decide whether the caller may send this draft now.
+ *
+ * @param ctx - Draft, caller, owner-message source, clock
+ * @returns Allowed (and why), or refused (and why)
+ */
+export function decideDraftSend(ctx) {
+    if (!ctx.agentSession)
+        return { allowed: true, via: 'owner' };
+    if (ctx.now - ctx.draft.createdAt > WHATSAPP_CONSTANTS.DRAFT_CONFIRM_WINDOW_MS) {
+        return { allowed: false, reason: 'window_expired' };
+    }
+    const confirmation = ctx.ownerMessagesSince(ctx.draft.createdAt).find((t) => isConfirmationFor(t, ctx.draft));
+    return confirmation !== undefined
+        ? { allowed: true, via: 'owner_confirmation', confirmation }
+        : { allowed: false, reason: 'no_confirmation' };
+}
+/**
+ * The instruction an agent must follow after drafting: show the owner the
+ * draft and ask for 「发 <code>」.
+ *
+ * @param draft - The draft
+ * @param recipient - Human label for the recipient (chat name or JID)
+ * @returns Instruction text
+ */
+export function buildOwnerConfirmPrompt(draft, recipient) {
+    return (`Draft ${draft.code} is saved but NOT sent. Show the owner the recipient (${recipient}), ` +
+        `the exact draft text, and the code ${draft.code}, and ask them to reply 「发 ${draft.code}」 to send it ` +
+        `(or send/discard it from the dashboard). Do not send it until they do.`);
+}
+/**
+ * Human message for a refused agent send.
+ *
+ * @param draft - The draft
+ * @param reason - Refusal reason
+ * @returns Message for the 403 body
+ */
+export function buildRefusalMessage(draft, reason) {
+    const windowMinutes = Math.round(WHATSAPP_CONSTANTS.DRAFT_CONFIRM_WINDOW_MS / MS_PER_MINUTE);
+    if (reason === 'window_expired') {
+        return (`Draft ${draft.code} is older than ${windowMinutes} minutes, so it can no longer be sent on the owner's ` +
+            `chat confirmation. Ask the owner to send it from the dashboard, or write a fresh draft and ask them to reply 「发 <new code>」.`);
+    }
+    return (`The owner has not confirmed draft ${draft.code}. Show the owner the draft (recipient and exact text) ` +
+        `and ask them to reply 「发 ${draft.code}」. Only then call send again. Never send without it.`);
+}
+//# sourceMappingURL=whatsapp-draft-gate.js.map

package/dist/backend/backend/src/services/whatsapp/whatsapp-draft-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-draft-gate.js","sourceRoot":"","sources":["../../../../../../backend/src/services/whatsapp/whatsapp-draft-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,gEAAgE;AAChE,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC;AAsBhC;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAiC;IAC/E,MAAM,CAAC,GAAG,kBAAkB,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAqB;IACnD,IAAI,CAAC,GAAG,CAAC,YAAY;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAC9D,IAAI,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,kBAAkB,CAAC,uBAAuB,EAAE,CAAC;QAC/E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACtD,CAAC;IACD,MAAM,YAAY,GAAG,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9G,OAAO,YAAY,KAAK,SAAS;QAC/B,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,oBAAoB,EAAE,YAAY,EAAE;QAC5D,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA2C,EAAE,SAAiB;IACpG,OAAO,CACL,SAAS,KAAK,CAAC,IAAI,yDAAyD,SAAS,KAAK;QAC1F,sCAAsC,KAAK,CAAC,IAAI,8BAA8B,KAAK,CAAC,IAAI,eAAe;QACvG,wEAAwE,CACzE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkC,EAAE,MAAwB;IAC9F,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,uBAAuB,GAAG,aAAa,CAAC,CAAC;IAC7F,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChC,OAAO,CACL,SAAS,KAAK,CAAC,IAAI,kBAAkB,aAAa,uDAAuD;YACzG,8HAA8H,CAC/H,CAAC;IACJ,CAAC;IACD,OAAO,CACL,qCAAqC,KAAK,CAAC,IAAI,wDAAwD;QACvG,4BAA4B,KAAK,CAAC,IAAI,sDAAsD,CAC7F,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,184 @@
+/**
+ * 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 type { WhatsAppInboxMessage, WhatsAppMessageKind } from '../../types/whatsapp.types.js';
+import type { UpsertChatInput, WhatsAppInboxStore } from './whatsapp-inbox.store.js';
+/** Loose record type for untyped Baileys payloads. */
+type Rec = Record<string, unknown>;
+/**
+ * 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 declare function toEpochMs(ts: unknown): number | null;
+/**
+ * Whether a JID is a group chat.
+ *
+ * @param jid - JID
+ * @returns True for `...@g.us`
+ */
+export declare function isGroupJid(jid: string): boolean;
+/**
+ * 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 declare function canonicalJid(jid: string, alt?: string): string;
+/**
+ * Strip wrapper messages (disappearing, view-once, edited, doc-with-caption).
+ *
+ * @param content - `WAMessage.message`
+ * @returns The innermost content object, or undefined
+ */
+export declare function unwrapMessageContent(content: unknown): Rec | undefined;
+/**
+ * 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 declare function classifyMessageContent(content: unknown): {
+    kind: WhatsAppMessageKind;
+    text: string;
+} | null;
+/** Result of parsing one Baileys message. */
+export interface ParsedWhatsAppMessage {
+    /** Row for the store */
+    message: WhatsAppInboxMessage;
+    /** Whether the chat is a group */
+    isGroup: boolean;
+    /** Sender's self-chosen name, when the message carried one (not for own messages) */
+    pushName: string | null;
+}
+/**
+ * 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 declare function parseBaileysMessage(raw: unknown, ownJid?: string | null): ParsedWhatsAppMessage | null;
+/**
+ * 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 declare function chatFromContact(contact: unknown): UpsertChatInput | 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 declare function chatFromChat(chat: unknown): UpsertChatInput | null;
+/**
+ * Chat row from Baileys `GroupMetadata` (subject = group name).
+ *
+ * @param group - Group metadata (full or partial)
+ * @returns Upsert input, or null without an id
+ */
+export declare function chatFromGroup(group: unknown): UpsertChatInput | null;
+/** Optional hooks for {@link WhatsAppInboxCapture}. */
+export interface WhatsAppInboxCaptureOptions {
+    /** The connected account's JID (sender of own messages) */
+    getOwnJid?: () => string | null;
+    /** Fetch a group's subject for a group we have no name for (best effort) */
+    fetchGroupSubject?: (jid: string) => Promise<string | null>;
+    /** Clock (tests) */
+    now?: () => number;
+}
+/**
+ * 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 declare class WhatsAppInboxCapture {
+    private readonly store;
+    private readonly opts;
+    private readonly groupLookups;
+    /**
+     * @param store - Destination store
+     * @param opts - Own-JID accessor, group-subject fetcher, clock
+     */
+    constructor(store: WhatsAppInboxStore, opts?: WhatsAppInboxCaptureOptions);
+    /**
+     * Store one message and name its chat.
+     *
+     * @param raw - A WAMessage
+     * @returns True when stored
+     */
+    captureMessage(raw: unknown): boolean;
+    /**
+     * 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: unknown): number;
+    /**
+     * 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: unknown): number;
+    /**
+     * Handle `contacts.upsert` / `contacts.update`.
+     *
+     * @param contacts - Contact list
+     */
+    onContacts(contacts: unknown): void;
+    /**
+     * Handle `chats.upsert` / `chats.update`.
+     *
+     * @param chats - Chat list
+     */
+    onChats(chats: unknown): void;
+    /**
+     * Handle `groups.upsert` / `groups.update`.
+     *
+     * @param groups - Group metadata list
+     */
+    onGroups(groups: unknown): void;
+    /**
+     * Look a group's subject up once per process when we have no name for it.
+     *
+     * @param jid - Group JID
+     */
+    private maybeFetchGroupName;
+}
+export {};
+//# sourceMappingURL=whatsapp-inbox-capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-inbox-capture.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/whatsapp/whatsapp-inbox-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAiCrF,sDAAsD;AACtD,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAsBnC;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAepD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,GAAG,SAAS,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsB3G;AAED,6CAA6C;AAC7C,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,GAAG,IAAI,CAsCtG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAWxE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAWlE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAKpE;AAED,uDAAuD;AACvD,MAAM,WAAW,2BAA2B;IAC1C,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAChC,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5D,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD;;;OAGG;gBACS,KAAK,EAAE,kBAAkB,EAAE,IAAI,GAAE,2BAAgC;IAK7E;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAiBrC;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;IAQzC;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAsBtC;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAKnC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAK7B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAK/B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAa5B"}