@cogitator-ai/channels 0.2.5 → 0.4.0

package/dist/channels/webchat.d.ts

@@ -3,19 +3,24 @@ export interface WebChatConfig {
     port: number;
     path?: string;
     auth?: (token: string) => boolean;
+    /** Maximum size of an incoming frame in bytes. Default: 1 MiB. */
+    maxPayload?: number;
 }
 export declare class WebChatChannel implements Channel {
     private readonly config;
     readonly type: ChannelType;
     private handler;
     private server;
-    private clients;
+    private readonly clients;
     constructor(config: WebChatConfig);
     onMessage(handler: (msg: ChannelMessage) => Promise<void>): void;
     start(): Promise<void>;
+    private handleConnection;
     stop(): Promise<void>;
-    sendText(channelId: string, text: string, _options?: SendOptions): Promise<string>;
+    private send;
+    sendText(channelId: string, text: string, options?: SendOptions): Promise<string>;
     editText(channelId: string, messageId: string, text: string): Promise<void>;
+    deleteMessage(channelId: string, messageId: string): Promise<void>;
     sendFile(channelId: string, file: Attachment): Promise<void>;
     sendTyping(channelId: string): Promise<void>;
     private onRawMessage;

package/dist/channels/webchat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webchat.d.ts","sourceRoot":"","sources":["../../src/channels/webchat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CACnC;AASD,qBAAa,cAAe,YAAW,OAAO;IAMhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAa;IACvC,OAAO,CAAC,OAAO,CAAyD;IACxE,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,OAAO,CAAoC;gBAEtB,MAAM,EAAE,aAAa;IAElD,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IASlF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAMpC,YAAY;CAuB3B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE7D"}
+{"version":3,"file":"webchat.d.ts","sourceRoot":"","sources":["../../src/channels/webchat.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4BD,qBAAa,cAAe,YAAW,OAAO;IAMhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAa;IACvC,OAAO,CAAC,OAAO,CAAyD;IACxE,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAE3B,MAAM,EAAE,aAAa;IAElD,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC5B,OAAO,CAAC,gBAAgB;IAiClB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,OAAO,CAAC,IAAI;IAON,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAYjF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAIpC,YAAY;CAiB3B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE7D"}

package/dist/channels/webchat.js

@@ -1,5 +1,26 @@
 import { nanoid } from 'nanoid';
 const WS_OPEN = 1;
+const DEFAULT_MAX_PAYLOAD = 1024 * 1024;
+const POLICY_VIOLATION = 1008;
+const GOING_AWAY = 1001;
+function parsePayload(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const record = parsed;
+    if (typeof record.text !== 'string' || record.text.trim().length === 0)
+        return null;
+    return {
+        text: record.text,
+        ...(typeof record.id === 'string' && record.id ? { id: record.id } : {}),
+    };
+}
 export class WebChatChannel {
     config;
     type = 'webchat';
@@ -13,89 +34,130 @@ export class WebChatChannel {
         this.handler = handler;
     }
     async start() {
-        const { WebSocketServer } = await import('ws');
-        const wss = new WebSocketServer({
+        if (this.server)
+            return;
+        let ws;
+        try {
+            ws = await import('ws');
+        }
+        catch {
+            throw new Error('ws is required for WebChat support. Install it: pnpm add ws');
+        }
+        const wss = new ws.WebSocketServer({
             port: this.config.port,
             path: this.config.path ?? '/ws',
+            maxPayload: this.config.maxPayload ?? DEFAULT_MAX_PAYLOAD,
+        });
+        await new Promise((resolve, reject) => {
+            const onError = (err) => {
+                wss.off('listening', onListening);
+                reject(err);
+            };
+            const onListening = () => {
+                wss.off('error', onError);
+                resolve();
+            };
+            wss.once('error', onError);
+            wss.once('listening', onListening);
+        });
+        wss.on('error', (err) => {
+            console.error('[webchat] Server error:', err.message);
         });
-        wss.on('connection', (ws, req) => {
-            const clientId = `webchat_${nanoid(8)}`;
-            if (this.config.auth) {
-                const url = new URL(req.url ?? '/', `http://localhost:${this.config.port}`);
-                const token = url.searchParams.get('token') ?? '';
-                if (!this.config.auth(token)) {
-                    ws.send(JSON.stringify({ type: 'error', message: 'unauthorized' }));
-                    return;
-                }
+        wss.on('connection', (socket, req) => this.handleConnection(socket, req));
+        this.server = wss;
+    }
+    handleConnection(socket, req) {
+        if (this.config.auth) {
+            const url = new URL(req.url ?? '/', 'http://localhost');
+            const token = url.searchParams.get('token') ?? '';
+            if (!this.config.auth(token)) {
+                socket.send(JSON.stringify({ type: 'error', message: 'unauthorized' }));
+                socket.close(POLICY_VIOLATION, 'unauthorized');
+                return;
             }
-            this.clients.set(clientId, ws);
-            ws.send(JSON.stringify({ type: 'connected', clientId }));
-            ws.on('message', (data) => {
-                void this.onRawMessage(clientId, data.toString());
-            });
-            ws.on('close', () => {
-                this.clients.delete(clientId);
+        }
+        const clientId = `webchat_${nanoid(8)}`;
+        this.clients.set(clientId, socket);
+        socket.send(JSON.stringify({ type: 'connected', clientId }));
+        socket.on('message', (data) => {
+            const raw = Array.isArray(data)
+                ? Buffer.concat(data).toString('utf-8')
+                : Buffer.from(data instanceof ArrayBuffer ? new Uint8Array(data) : data).toString('utf-8');
+            void this.onRawMessage(clientId, raw).catch((err) => {
+                console.error('[webchat] Message handler error:', err);
             });
         });
-        this.server = wss;
+        socket.on('close', () => {
+            this.clients.delete(clientId);
+        });
+        socket.on('error', () => {
+            this.clients.delete(clientId);
+        });
     }
     async stop() {
-        if (this.server) {
-            this.server.close();
-            this.server = null;
+        const server = this.server;
+        if (!server)
+            return;
+        this.server = null;
+        for (const socket of this.clients.values()) {
+            socket.close(GOING_AWAY, 'server shutting down');
         }
         this.clients.clear();
+        await new Promise((resolve) => server.close(() => resolve()));
     }
-    async sendText(channelId, text, _options) {
+    send(channelId, payload) {
         const client = this.clients.get(channelId);
         if (client?.readyState !== WS_OPEN)
-            return '';
+            return false;
+        client.send(JSON.stringify(payload));
+        return true;
+    }
+    async sendText(channelId, text, options) {
         const messageId = `msg_${nanoid(8)}`;
-        client.send(JSON.stringify({ type: 'message', id: messageId, text }));
+        const delivered = this.send(channelId, {
+            type: 'message',
+            id: messageId,
+            text,
+            ...(options?.replyTo ? { replyTo: options.replyTo } : {}),
+        });
+        if (!delivered)
+            throw new Error(`WebChat client ${channelId} is not connected`);
         return messageId;
     }
     async editText(channelId, messageId, text) {
-        const client = this.clients.get(channelId);
-        if (client?.readyState !== WS_OPEN)
-            return;
-        client.send(JSON.stringify({ type: 'edit', id: messageId, text }));
+        this.send(channelId, { type: 'edit', id: messageId, text });
+    }
+    async deleteMessage(channelId, messageId) {
+        this.send(channelId, { type: 'delete', id: messageId });
     }
     async sendFile(channelId, file) {
-        const client = this.clients.get(channelId);
-        if (client?.readyState !== WS_OPEN)
-            return;
-        client.send(JSON.stringify({
+        if (!file.url && !file.buffer) {
+            throw new Error('Attachment must have either a buffer or a url');
+        }
+        this.send(channelId, {
             type: 'file',
             filename: file.filename,
             mimeType: file.mimeType,
-            url: file.url,
-        }));
+            ...(file.url ? { url: file.url } : {}),
+            ...(file.buffer ? { data: Buffer.from(file.buffer).toString('base64') } : {}),
+        });
     }
     async sendTyping(channelId) {
-        const client = this.clients.get(channelId);
-        if (client?.readyState !== WS_OPEN)
-            return;
-        client.send(JSON.stringify({ type: 'typing' }));
+        this.send(channelId, { type: 'typing' });
     }
     async onRawMessage(clientId, raw) {
         if (!this.handler)
             return;
-        let parsed;
-        try {
-            parsed = JSON.parse(raw);
-        }
-        catch {
-            return;
-        }
-        if (!parsed.text)
+        const payload = parsePayload(raw);
+        if (!payload)
             return;
         const msg = {
-            id: parsed.id ?? `in_${nanoid(8)}`,
+            id: payload.id ?? `in_${nanoid(8)}`,
             channelType: 'webchat',
             channelId: clientId,
             userId: clientId,
-            text: parsed.text,
-            raw: parsed,
+            text: payload.text,
+            raw: payload,
         };
         await this.handler(msg);
     }

package/dist/channels/webchat.js.map

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

package/dist/channels/whatsapp.d.ts

@@ -1,7 +1,11 @@
-import type { Attachment, Channel, ChannelMessage } from '@cogitator-ai/types';
+import type { Attachment, Channel, ChannelMessage, SendOptions } from '@cogitator-ai/types';
 export interface WhatsAppChannelConfig {
     sessionPath?: string;
     qrCallback?: (qr: string) => void;
+    /**
+     * Render the pairing QR code in the terminal when no `qrCallback` is set.
+     * Requires the optional `qrcode-terminal` package. Default: true.
+     */
     printQr?: boolean;
 }
 type MessageHandler = (msg: ChannelMessage) => Promise<void>;
@@ -9,12 +13,24 @@ export declare class WhatsAppChannel implements Channel {
     readonly type = "whatsapp";
     private handler;
     private sock;
-    private config;
+    private baileys;
+    private readonly config;
+    private readonly recent;
+    private stopped;
+    private reconnectAttempts;
+    private reconnectTimer;
     constructor(config?: WhatsAppChannelConfig);
     start(): Promise<void>;
+    private connect;
+    private handleConnectionUpdate;
+    private presentQr;
+    private extractText;
+    private extractAttachments;
+    private handleIncoming;
     stop(): Promise<void>;
     onMessage(handler: MessageHandler): void;
-    sendText(channelId: string, text: string): Promise<string>;
+    private requireSocket;
+    sendText(channelId: string, text: string, options?: SendOptions): Promise<string>;
     editText(channelId: string, messageId: string, text: string): Promise<void>;
     sendFile(channelId: string, file: Attachment): Promise<void>;
     sendTyping(channelId: string): Promise<void>;

package/dist/channels/whatsapp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../src/channels/whatsapp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG/E,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgCD,KAAK,cAAc,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7D,qBAAa,eAAgB,YAAW,OAAO;IAC7C,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,GAAE,qBAA0B;IAIxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwFtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIlC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO1D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAInD;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAEvE"}
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../src/channels/whatsapp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,OAAO,EACP,cAAc,EACd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAuED,KAAK,cAAc,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAyB7D,qBAAa,eAAgB,YAAW,OAAO;IAC7C,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;gBAExD,MAAM,GAAE,qBAA0B;IAIxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBd,OAAO;IA4BrB,OAAO,CAAC,sBAAsB;YA8BhB,SAAS;IAsBvB,OAAO,CAAC,WAAW;YAaL,kBAAkB;YAuBlB,cAAc;IAkCtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIxC,OAAO,CAAC,aAAa;IAKf,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAajF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC5D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAInD;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAEvE"}

package/dist/channels/whatsapp.js

@@ -1,109 +1,247 @@
 import { markdownToWhatsApp } from '../formatters/whatsapp-markdown.js';
+const MAX_RECENT_MESSAGES = 200;
+const RECONNECT_BASE_MS = 1000;
+const RECONNECT_MAX_MS = 60_000;
+const MEDIA_KINDS = [
+    { key: 'imageMessage', type: 'image', fallbackMime: 'image/jpeg' },
+    { key: 'audioMessage', type: 'audio', fallbackMime: 'audio/ogg' },
+    { key: 'videoMessage', type: 'video', fallbackMime: 'video/mp4' },
+    { key: 'documentMessage', type: 'file', fallbackMime: 'application/octet-stream' },
+];
+async function loadOptional(specifier) {
+    try {
+        return (await import(specifier));
+    }
+    catch {
+        return null;
+    }
+}
 export class WhatsAppChannel {
     type = 'whatsapp';
     handler = null;
     sock = null;
+    baileys = null;
     config;
+    recent = new Map();
+    stopped = true;
+    reconnectAttempts = 0;
+    reconnectTimer = null;
     constructor(config = {}) {
         this.config = config;
     }
     async start() {
-        let baileys;
-        try {
-            // @ts-expect-error optional peer dependency
-            baileys = await import('@whiskeysockets/baileys');
-        }
-        catch {
+        if (this.sock)
+            return;
+        this.stopped = false;
+        const baileys = await loadOptional('@whiskeysockets/baileys');
+        if (!baileys) {
+            this.stopped = true;
             throw new Error('@whiskeysockets/baileys is required for WhatsApp. Install it: pnpm add @whiskeysockets/baileys');
         }
+        this.baileys = baileys;
+        await this.connect(baileys);
+    }
+    async connect(baileys) {
         const sessionPath = this.config.sessionPath ?? '.cogitator/whatsapp-session';
         const { state, saveCreds } = await baileys.useMultiFileAuthState(sessionPath);
-        const sock = baileys.default({
-            auth: state,
-            printQRInTerminal: this.config.printQr ?? true,
-        });
+        const sock = baileys.default({ auth: state });
         this.sock = sock;
-        sock.ev.on('creds.update', saveCreds);
+        sock.ev.on('creds.update', () => {
+            void saveCreds().catch((err) => {
+                console.error('[whatsapp] Failed to persist credentials:', err);
+            });
+        });
         sock.ev.on('connection.update', (update) => {
-            const { connection, qr } = update;
-            if (qr && this.config.qrCallback) {
-                this.config.qrCallback(qr);
-            }
-            if (connection === 'close') {
-                const { lastDisconnect } = update;
-                const statusCode = lastDisconnect?.error?.output?.statusCode;
-                const loggedOut = statusCode === baileys.DisconnectReason.loggedOut;
-                if (!loggedOut) {
-                    void this.start();
-                }
-            }
+            this.handleConnectionUpdate(sock, baileys, update);
         });
         sock.ev.on('messages.upsert', (upsert) => {
             const { messages, type } = upsert;
             if (type !== 'notify')
                 return;
             for (const msg of messages) {
-                if (msg.key.fromMe)
-                    continue;
-                if (!msg.message)
-                    continue;
-                const text = msg.message.conversation ?? msg.message.extendedTextMessage?.text ?? '';
-                if (!text)
-                    continue;
-                const jid = msg.key.remoteJid ?? '';
-                const userId = msg.key.participant ?? jid;
-                const isGroup = jid.endsWith('@g.us');
-                const channelMsg = {
-                    id: msg.key.id ?? '',
-                    channelType: 'whatsapp',
-                    channelId: jid,
-                    userId: userId.split('@')[0],
-                    userName: msg.pushName ?? userId.split('@')[0],
-                    text,
-                    raw: msg,
-                    ...(isGroup ? { groupId: jid } : {}),
-                };
-                if (this.handler) {
-                    void this.handler(channelMsg);
-                }
+                void this.handleIncoming(msg).catch((err) => {
+                    console.error('[whatsapp] Message handler error:', err);
+                });
+            }
+        });
+    }
+    handleConnectionUpdate(sock, baileys, update) {
+        if (update.qr)
+            void this.presentQr(update.qr);
+        if (update.connection === 'open') {
+            this.reconnectAttempts = 0;
+            return;
+        }
+        if (update.connection !== 'close' || this.sock !== sock)
+            return;
+        this.sock = null;
+        const statusCode = update.lastDisconnect?.error?.output?.statusCode;
+        const loggedOut = statusCode === baileys.DisconnectReason.loggedOut;
+        if (this.stopped || loggedOut)
+            return;
+        const delay = Math.min(RECONNECT_BASE_MS * 2 ** this.reconnectAttempts, RECONNECT_MAX_MS);
+        this.reconnectAttempts++;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            if (this.stopped)
+                return;
+            void this.connect(baileys).catch((err) => {
+                console.error('[whatsapp] Reconnect failed:', err);
+            });
+        }, delay);
+    }
+    async presentQr(qr) {
+        if (this.config.qrCallback) {
+            this.config.qrCallback(qr);
+            return;
+        }
+        if (this.config.printQr === false)
+            return;
+        const qrTerminal = await loadOptional('qrcode-terminal');
+        const generator = qrTerminal?.default ?? qrTerminal;
+        if (generator?.generate) {
+            generator.generate(qr, { small: true });
+            return;
+        }
+        console.warn('[whatsapp] Scan required but qrcode-terminal is not installed (pnpm add qrcode-terminal). ' +
+            'Pass qrCallback to render the QR code yourself. Raw QR payload:', qr);
+    }
+    extractText(msg) {
+        const m = msg.message;
+        if (!m)
+            return '';
+        return (m.conversation ??
+            m.extendedTextMessage?.text ??
+            m.imageMessage?.caption ??
+            m.videoMessage?.caption ??
+            m.documentMessage?.caption ??
+            '');
+    }
+    async extractAttachments(msg) {
+        const m = msg.message;
+        if (!m || !this.baileys)
+            return [];
+        const attachments = [];
+        for (const kind of MEDIA_KINDS) {
+            const media = m[kind.key];
+            if (!media)
+                continue;
+            try {
+                const buffer = await this.baileys.downloadMediaMessage(msg, 'buffer', {});
+                attachments.push({
+                    type: kind.type,
+                    mimeType: media.mimetype?.split(';')[0]?.trim() || kind.fallbackMime,
+                    buffer,
+                    ...(media.fileName ? { filename: media.fileName } : {}),
+                });
+            }
+            catch (err) {
+                console.error('[whatsapp] Failed to download media:', err);
             }
+        }
+        return attachments;
+    }
+    async handleIncoming(msg) {
+        if (msg.key.fromMe || !msg.message || !this.handler)
+            return;
+        const jid = msg.key.remoteJid ?? '';
+        const id = msg.key.id ?? '';
+        if (!jid || !id)
+            return;
+        const text = this.extractText(msg);
+        const attachments = await this.extractAttachments(msg);
+        if (!text && attachments.length === 0)
+            return;
+        this.recent.set(id, msg);
+        if (this.recent.size > MAX_RECENT_MESSAGES) {
+            const oldest = this.recent.keys().next().value;
+            if (oldest !== undefined)
+                this.recent.delete(oldest);
+        }
+        const sender = msg.key.participant ?? jid;
+        const userId = sender.split('@')[0];
+        const isGroup = jid.endsWith('@g.us');
+        await this.handler({
+            id,
+            channelType: 'whatsapp',
+            channelId: jid,
+            userId,
+            userName: msg.pushName ?? userId,
+            text,
+            raw: msg,
+            ...(isGroup ? { groupId: jid } : {}),
+            ...(attachments.length > 0 ? { attachments } : {}),
         });
     }
     async stop() {
+        this.stopped = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
         if (this.sock) {
-            this.sock.end();
+            const sock = this.sock;
             this.sock = null;
+            sock.end();
         }
+        this.recent.clear();
     }
     onMessage(handler) {
         this.handler = handler;
     }
-    async sendText(channelId, text) {
+    requireSocket() {
         if (!this.sock)
             throw new Error('WhatsApp not connected');
-        const waText = markdownToWhatsApp(text);
-        const sent = await this.sock.sendMessage(channelId, { text: waText });
-        return sent.key.id ?? '';
+        return this.sock;
+    }
+    async sendText(channelId, text, options) {
+        const sock = this.requireSocket();
+        const quoted = options?.replyTo ? this.recent.get(options.replyTo) : undefined;
+        const sent = await sock.sendMessage(channelId, { text: markdownToWhatsApp(text) }, quoted ? { quoted } : undefined);
+        const id = sent?.key.id;
+        if (!id)
+            throw new Error('WhatsApp did not return a message id');
+        return id;
     }
     async editText(channelId, messageId, text) {
-        if (!this.sock)
-            return;
-        const waText = markdownToWhatsApp(text);
-        await this.sock.sendMessage(channelId, {
-            text: waText,
-            edit: { key: { remoteJid: channelId, id: messageId } },
+        const sock = this.requireSocket();
+        await sock.sendMessage(channelId, {
+            text: markdownToWhatsApp(text),
+            edit: { remoteJid: channelId, id: messageId, fromMe: true },
         });
     }
     async sendFile(channelId, file) {
-        if (!this.sock)
-            throw new Error('WhatsApp not connected');
-        if (!file.buffer)
-            return;
-        await this.sock.sendMessage(channelId, {
-            document: Buffer.from(file.buffer),
-            mimetype: file.mimeType,
-            fileName: file.filename ?? 'file',
-        });
+        const sock = this.requireSocket();
+        let buffer;
+        if (file.buffer) {
+            buffer = Buffer.from(file.buffer);
+        }
+        else if (file.url) {
+            const res = await fetch(file.url);
+            if (!res.ok)
+                throw new Error(`Failed to download ${file.url}: HTTP ${res.status}`);
+            buffer = Buffer.from(await res.arrayBuffer());
+        }
+        else {
+            throw new Error('Attachment must have either a buffer or a url');
+        }
+        switch (file.type) {
+            case 'image':
+                await sock.sendMessage(channelId, { image: buffer, mimetype: file.mimeType });
+                return;
+            case 'audio':
+                await sock.sendMessage(channelId, { audio: buffer, mimetype: file.mimeType });
+                return;
+            case 'video':
+                await sock.sendMessage(channelId, { video: buffer, mimetype: file.mimeType });
+                return;
+            default:
+                await sock.sendMessage(channelId, {
+                    document: buffer,
+                    mimetype: file.mimeType,
+                    fileName: file.filename ?? 'file',
+                });
+        }
     }
     async sendTyping(channelId) {
         if (!this.sock)