@arcaelas/whatsapp 5.1.0 → 6.1.0

package/build/cjs/lib/store/engine/lib/sqlite/index.d.ts

@@ -33,22 +33,22 @@ export interface SQLiteDatabase {
  * resuelven a mano: `list` es un `ORDER BY score DESC LIMIT/OFFSET` sobre el índice (sin
  * índice en memoria ni archivo de orden), `count` un `COUNT(*)` y el `unset` en cascada una
  * sola sentencia por rango de `path`. Medido sobre un chat real de 55.146 mensajes frente al
- * filesystem: 220 MB → 111 MB en disco, primer `list` 115 ms → 0,7 ms y dos inodes en total.
+ * filesystem: 220 MB → 64 MB en disco, primer `list` 115 ms → 0,6 ms y dos archivos en total.
  *
  * SQLite persistence driver: a single `(path, parent, score, value)` table with a
  * `(parent, score DESC)` index. The most efficient built-in driver, since it delegates to the
  * engine what the others hand-roll: `list` is an indexed `ORDER BY score DESC LIMIT/OFFSET`
  * (no in-memory index, no order file), `count` a `COUNT(*)` and cascading `unset` a single
  * range statement. Measured on a real 55,146-message chat against the filesystem: 220 MB →
- * 111 MB on disk, first `list` 115 ms → 0.7 ms and two inodes in total.
+ * 64 MB on disk, first `list` 115 ms → 0.6 ms and two files in total.
  *
  * @example
  * import Database from 'better-sqlite3';
- * const engine = new SQLiteEngine(new Database('.sessions/584144709840.db'));
+ * const engine = new SQLiteEngine(new Database('.sessions/5491112345678.db'));
  *
  * @example
  * import { DatabaseSync } from 'node:sqlite';
- * const engine = new SQLiteEngine(new DatabaseSync('.sessions/584144709840.db'));
+ * const engine = new SQLiteEngine(new DatabaseSync('.sessions/5491112345678.db'));
  */
 export declare class SQLiteEngine implements Engine {
     private readonly _db;
@@ -58,6 +58,8 @@ export declare class SQLiteEngine implements Engine {
     private readonly _page;
     private readonly _total;
     private readonly _wipe;
+    private readonly _read_blob;
+    private readonly _write_blob;
     /**
      * @param _db - Base SQLite ya abierta / Already open SQLite database
      * @param table - Tabla donde viven los documentos / Table holding the documents
@@ -89,6 +91,16 @@ export declare class SQLiteEngine implements Engine {
      * Counts direct children.
      */
     count(path: string): Promise<number>;
+    /**
+     * Lee el binario del documento, o null si la fila no lo tiene.
+     * Reads the document binary, or null when the row has none.
+     */
+    get_buffer(path: string): Promise<Buffer | null>;
+    /**
+     * Escribe el binario del documento como BLOB, sin JSON ni base64.
+     * Writes the document binary as a BLOB, with no JSON nor base64.
+     */
+    set_buffer(path: string, data: Buffer, score?: number): Promise<void>;
     /**
      * Vacía la tabla completa.
      * Clears the entire table.

package/build/cjs/lib/store/engine/lib/sqlite/index.js

@@ -15,22 +15,22 @@ const lib_1 = require("../../../../../lib/store/engine/lib");
  * resuelven a mano: `list` es un `ORDER BY score DESC LIMIT/OFFSET` sobre el índice (sin
  * índice en memoria ni archivo de orden), `count` un `COUNT(*)` y el `unset` en cascada una
  * sola sentencia por rango de `path`. Medido sobre un chat real de 55.146 mensajes frente al
- * filesystem: 220 MB → 111 MB en disco, primer `list` 115 ms → 0,7 ms y dos inodes en total.
+ * filesystem: 220 MB → 64 MB en disco, primer `list` 115 ms → 0,6 ms y dos archivos en total.
  *
  * SQLite persistence driver: a single `(path, parent, score, value)` table with a
  * `(parent, score DESC)` index. The most efficient built-in driver, since it delegates to the
  * engine what the others hand-roll: `list` is an indexed `ORDER BY score DESC LIMIT/OFFSET`
  * (no in-memory index, no order file), `count` a `COUNT(*)` and cascading `unset` a single
  * range statement. Measured on a real 55,146-message chat against the filesystem: 220 MB →
- * 111 MB on disk, first `list` 115 ms → 0.7 ms and two inodes in total.
+ * 64 MB on disk, first `list` 115 ms → 0.6 ms and two files in total.
  *
  * @example
  * import Database from 'better-sqlite3';
- * const engine = new SQLiteEngine(new Database('.sessions/584144709840.db'));
+ * const engine = new SQLiteEngine(new Database('.sessions/5491112345678.db'));
  *
  * @example
  * import { DatabaseSync } from 'node:sqlite';
- * const engine = new SQLiteEngine(new DatabaseSync('.sessions/584144709840.db'));
+ * const engine = new SQLiteEngine(new DatabaseSync('.sessions/5491112345678.db'));
  */
 class SQLiteEngine {
     /**
@@ -49,7 +49,7 @@ class SQLiteEngine {
         catch {
             /* optional tuning */
         }
-        _db.exec(`CREATE TABLE IF NOT EXISTS ${table} (path TEXT PRIMARY KEY, parent TEXT NOT NULL, score INTEGER NOT NULL, value TEXT NOT NULL);
+        _db.exec(`CREATE TABLE IF NOT EXISTS ${table} (path TEXT PRIMARY KEY, parent TEXT NOT NULL, score INTEGER NOT NULL, value TEXT NOT NULL DEFAULT '', binary BLOB);
        CREATE INDEX IF NOT EXISTS ${table}_order ON ${table} (parent, score DESC);`);
         this._read = _db.prepare(`SELECT value FROM ${table} WHERE path = ?`);
         this._write = _db.prepare(`INSERT INTO ${table} (path, parent, score, value) VALUES (?, ?, ?, ?)
@@ -62,6 +62,9 @@ class SQLiteEngine {
         this._page = _db.prepare(`SELECT value FROM ${table} WHERE parent = ? ORDER BY score DESC LIMIT ? OFFSET ?`);
         this._total = _db.prepare(`SELECT COUNT(*) AS total FROM ${table} WHERE parent = ?`);
         this._wipe = _db.prepare(`DELETE FROM ${table}`);
+        this._read_blob = _db.prepare(`SELECT binary FROM ${table} WHERE path = ?`);
+        this._write_blob = _db.prepare(`INSERT INTO ${table} (path, parent, score, value, binary) VALUES (?, ?, ?, '', ?)
+       ON CONFLICT(path) DO UPDATE SET binary = excluded.binary, score = excluded.score`);
     }
     /**
      * Lee el valor de un documento.
@@ -102,6 +105,22 @@ class SQLiteEngine {
     async count(path) {
         return Number(this._total.get((0, lib_1.normalize_path)(path)).total);
     }
+    /**
+     * Lee el binario del documento, o null si la fila no lo tiene.
+     * Reads the document binary, or null when the row has none.
+     */
+    async get_buffer(path) {
+        const row = this._read_blob.get((0, lib_1.normalize_path)(path));
+        return row?.binary ? Buffer.from(row.binary) : null;
+    }
+    /**
+     * Escribe el binario del documento como BLOB, sin JSON ni base64.
+     * Writes the document binary as a BLOB, with no JSON nor base64.
+     */
+    async set_buffer(path, data, score) {
+        const { parent } = (0, lib_1.split_path)(path);
+        this._write_blob.run((0, lib_1.normalize_path)(path), parent, score ?? Date.now(), data);
+    }
     /**
      * Vacía la tabla completa.
      * Clears the entire table.
@@ -111,4 +130,3 @@ class SQLiteEngine {
     }
 }
 exports.SQLiteEngine = SQLiteEngine;
-//# sourceMappingURL=index.js.map

package/build/cjs/lib/store/index.js

@@ -46,4 +46,3 @@ function deserialize(raw) {
         return null;
     }
 }
-//# sourceMappingURL=index.js.map

package/build/cjs/lib/whatsapp/index.d.ts

@@ -111,7 +111,7 @@ interface WhatsAppEventMap {
  * Main WhatsApp client. Does not connect on instantiation.
  *
  * @example
- * const wa = new WhatsApp({ engine: new FileSystemEngine(__dirname), phone: 584144709840 });
+ * const wa = new WhatsApp({ engine: new FileSystemEngine(__dirname), phone: 5491112345678 });
  * wa.on('message:created', (msg) => console.log(msg.caption));
  * await wa.connect((code) => console.log(code));
  */

package/build/cjs/lib/whatsapp/index.js

@@ -78,7 +78,7 @@ function sniff_media(data) {
  * Main WhatsApp client. Does not connect on instantiation.
  *
  * @example
- * const wa = new WhatsApp({ engine: new FileSystemEngine(__dirname), phone: 584144709840 });
+ * const wa = new WhatsApp({ engine: new FileSystemEngine(__dirname), phone: 5491112345678 });
  * wa.on('message:created', (msg) => console.log(msg.caption));
  * await wa.connect((code) => console.log(code));
  */
@@ -154,6 +154,19 @@ class WhatsApp {
         }
         return null;
     }
+    /**
+     * @internal
+     * Persiste un binario: crudo cuando el driver lo soporta, JSON con base64 si no.
+     * Persists a binary: raw when the driver supports it, base64 JSON otherwise.
+     */
+    async #write_content(path, data) {
+        if (this.engine.set_buffer) {
+            await this.engine.set_buffer(path, data);
+        }
+        else {
+            await this.engine.set(path, (0, store_1.serialize)({ data: data.toString('base64') }));
+        }
+    }
     /** @internal Encola una tarea en la cadena serial de handlers. / Queues a task on the serial handler chain. */
     #enqueue(task) {
         this.#chain = this.#chain.then(task).catch(() => { });
@@ -208,12 +221,15 @@ class WhatsApp {
             result = uid;
         }
         else if (uid.endsWith('@lid')) {
-            const direct = (0, store_1.deserialize)(await this.engine.get(`/lid/${uid}`));
+            // Los receipts direccionan por dispositivo (`…:9@lid`); el índice se guarda sin él.
+            // Receipts address per device (`…:9@lid`); the index is stored without it.
+            const lid = (0, baileys_1.jidNormalizedUser)(uid);
+            const direct = (0, store_1.deserialize)(await this.engine.get(`/lid/${lid}`));
             if (direct) {
                 result = direct.includes('@') ? direct : `${direct}@s.whatsapp.net`;
             }
             else {
-                const reverse = (0, store_1.deserialize)(await this.engine.get(`/lid/${uid.split('@')[0]}_reverse`));
+                const reverse = (0, store_1.deserialize)(await this.engine.get(`/lid/${lid.split('@')[0]}_reverse`));
                 if (reverse != null) {
                     result = `${reverse}@s.whatsapp.net`;
                 }
@@ -222,7 +238,7 @@ class WhatsApp {
                     // baileys lo conoce vía su lidMapping. Sin esto, un chat referenciado por @lid
                     // (p.ej. el pollCreationMessageKey de un voto entrante) no resuelve al PN donde
                     // realmente está guardado, y el mensaje/poll no se encuentra.
-                    const pn = await this.#internals.socket?.signalRepository?.lidMapping?.getPNForLID(uid).catch(() => null);
+                    const pn = await this.#internals.socket?.signalRepository?.lidMapping?.getPNForLID(lid).catch(() => null);
                     if (pn) {
                         // getPNForLID puede traer sufijo de dispositivo (`:0`); se normaliza para
                         // que el JID coincida con el que usa el store (sin device).
@@ -462,7 +478,7 @@ class WhatsApp {
                 };
                 await this.engine.set(`/status/${doc.id}`, (0, store_1.serialize)(doc), created_at);
                 if (post.content) {
-                    await this.engine.set(`/status/${doc.id}/content`, (0, store_1.serialize)({ data: post.content.toString('base64') }));
+                    await this.#write_content(`/status/${doc.id}/content`, post.content);
                 }
                 result = new status_1.Feed(this, doc);
                 this.emit('feed:created', result, this);
@@ -627,6 +643,7 @@ class WhatsApp {
                     archived: ch.archived ?? null,
                     pinned: ch.pinned ?? null,
                     mute_end_time: ch.muteEndTime != null ? Number(ch.muteEndTime) : null,
+                    unread_count: ch.unreadCount ?? null,
                 };
                 if (ch.name) {
                     raw.name = ch.name;
@@ -662,6 +679,9 @@ class WhatsApp {
                 if (mute_changed) {
                     patch.mute_end_time = ch.muteEndTime != null ? Number(ch.muteEndTime) : null;
                 }
+                if (ch.unreadCount != null) {
+                    patch.unread_count = ch.unreadCount;
+                }
                 if (Object.keys(patch).length > 0) {
                     const merged = { ...current, ...patch };
                     await this.engine.set(`/chat/${ch.id}`, (0, store_1.serialize)(merged));
@@ -702,13 +722,14 @@ class WhatsApp {
                 continue;
             }
             if (key.remoteJid && key.id && (receipt.readTimestamp != null || receipt.playedTimestamp != null)) {
-                const doc = (0, store_1.deserialize)(await this.engine.get(`/chat/${key.remoteJid}/message/${key.id}`));
-                if (doc) {
+                const found = await this.#locate(key.remoteJid, key.id);
+                if (found) {
+                    const { path, doc } = found;
                     const next = receipt.playedTimestamp != null ? PLAYED : READ;
                     if (doc.status < next) {
                         doc.status = next;
                         doc.raw.status = next;
-                        await this.engine.set(`/chat/${key.remoteJid}/message/${key.id}`, (0, store_1.serialize)(doc), doc.created_at);
+                        await this.engine.set(path, (0, store_1.serialize)(doc), doc.created_at);
                     }
                     const msg_instance = (0, message_1.message)(this, doc);
                     this.emit('message:seen', msg_instance, await msg_instance.chat(), this);
@@ -811,7 +832,7 @@ class WhatsApp {
                     }
                     await this.engine.set(`/status/${mid}`, (0, store_1.serialize)(feed_raw));
                     if (content_buf.length > 0) {
-                        await this.engine.set(`/status/${mid}/content`, (0, store_1.serialize)({ data: content_buf.toString('base64') }));
+                        await this.#write_content(`/status/${mid}/content`, content_buf);
                     }
                     this.emit('feed:created', new status_1.Feed(this, feed_raw), this);
                     continue;
@@ -999,7 +1020,7 @@ class WhatsApp {
                     }
                 }
                 if (content_buf.length > 0) {
-                    await this.engine.set(`/chat/${cid}/message/${mid}/content`, (0, store_1.serialize)({ data: content_buf.toString('base64') }));
+                    await this.#write_content(`/chat/${cid}/message/${mid}/content`, content_buf);
                 }
                 const instance = (0, message_1.message)(this, doc);
                 const chat_instance = await instance.chat();
@@ -1010,6 +1031,33 @@ class WhatsApp {
             }
         }
     }
+    /**
+     * Ubica el documento de un mensaje partiendo del chat crudo del key. Los updates y
+     * receipts llegan direccionados por LID —con o sin dispositivo— mientras el documento
+     * vive bajo el JID con el que se guardó, así que se prueban ambas formas.
+     * Locates a message document from the raw chat in the key. Updates and receipts arrive
+     * LID-addressed —with or without device— while the document lives under the JID it was
+     * stored with, so both forms are tried.
+     *
+     * @param cid - Chat tal como viene en el key / Chat as it comes in the key
+     * @param mid - Identificador del mensaje / Message identifier
+     * @returns Ruta y documento, o null si no existe / Path and document, or null when missing
+     * @internal
+     */
+    async #locate(cid, mid) {
+        const tried = new Set();
+        for (const candidate of [await this.#resolve_jid(cid), cid, (0, baileys_1.jidNormalizedUser)(cid)]) {
+            if (candidate && !tried.has(candidate)) {
+                tried.add(candidate);
+                const path = `/chat/${candidate}/message/${mid}`;
+                const doc = (0, store_1.deserialize)(await this.engine.get(path));
+                if (doc) {
+                    return { path, doc };
+                }
+            }
+        }
+        return null;
+    }
     /** @internal */
     async #handle_messages_update(updates) {
         for (const { key, update: upd } of updates) {
@@ -1021,8 +1069,9 @@ class WhatsApp {
                 if (key.remoteJid === 'status@broadcast') {
                     continue;
                 }
-                const doc = (0, store_1.deserialize)(await this.engine.get(`/chat/${key.remoteJid}/message/${key.id}`));
-                if (doc) {
+                const found = await this.#locate(key.remoteJid, key.id);
+                if (found) {
+                    const { path, doc } = found;
                     const raw = doc.raw ?? { key };
                     const upd_any = upd;
                     const edited_message = upd_any.message?.editedMessage?.message;
@@ -1034,7 +1083,7 @@ class WhatsApp {
                         doc.raw = raw;
                         doc.edited = true;
                         doc.caption = (0, message_1.message)(this, raw).caption;
-                        await this.engine.set(`/chat/${key.remoteJid}/message/${key.id}`, (0, store_1.serialize)(doc), doc.created_at);
+                        await this.engine.set(path, (0, store_1.serialize)(doc), doc.created_at);
                         const msg_instance = (0, message_1.message)(this, doc);
                         this.emit('message:updated', msg_instance, await msg_instance.chat(), this);
                     }
@@ -1043,7 +1092,7 @@ class WhatsApp {
                         raw.message = { ...raw.message, ...content_update };
                         doc.raw = raw;
                         doc.caption = (0, message_1.message)(this, raw).caption;
-                        await this.engine.set(`/chat/${key.remoteJid}/message/${key.id}`, (0, store_1.serialize)(doc), doc.created_at);
+                        await this.engine.set(path, (0, store_1.serialize)(doc), doc.created_at);
                         const msg_instance = (0, message_1.message)(this, doc);
                         this.emit('message:updated', msg_instance, await msg_instance.chat(), this);
                     }
@@ -1051,15 +1100,22 @@ class WhatsApp {
                         doc.starred = upd_any.starred === true;
                         raw.starred = doc.starred;
                         doc.raw = raw;
-                        await this.engine.set(`/chat/${key.remoteJid}/message/${key.id}`, (0, store_1.serialize)(doc), doc.created_at);
+                        await this.engine.set(path, (0, store_1.serialize)(doc), doc.created_at);
                         const msg_instance = (0, message_1.message)(this, doc);
                         this.emit(doc.starred ? 'message:starred' : 'message:unstarred', msg_instance, await msg_instance.chat(), this);
                     }
                     else if (status !== undefined) {
                         raw.status = status;
                         doc.status = status;
+                        // El rechazo del servidor viaja como stub del update; sin persistirlo el
+                        // mensaje queda en error sin decir por qué.
+                        // The server rejection travels as an update stub; without persisting it the
+                        // message stays in error without saying why.
+                        if (upd_any.messageStubParameters) {
+                            raw.messageStubParameters = upd_any.messageStubParameters;
+                        }
                         doc.raw = raw;
-                        await this.engine.set(`/chat/${key.remoteJid}/message/${key.id}`, (0, store_1.serialize)(doc), doc.created_at);
+                        await this.engine.set(path, (0, store_1.serialize)(doc), doc.created_at);
                         const msg_instance = (0, message_1.message)(this, doc);
                         this.emit('message:updated', msg_instance, await msg_instance.chat(), this);
                     }
@@ -1080,15 +1136,16 @@ class WhatsApp {
                     }
                     continue;
                 }
-                const doc = (0, store_1.deserialize)(await this.engine.get(`/chat/${key.remoteJid}/message/${key.id}`));
-                if (doc) {
+                const found = await this.#locate(key.remoteJid, key.id);
+                if (found) {
+                    const { path, doc } = found;
                     const reactor = (0, baileys_1.jidNormalizedUser)(key.participant ?? key.remoteJid);
                     const emoji = reaction.text ?? '';
                     doc.reactions = [
                         ...(doc.reactions ?? []).filter((r) => r.author !== reactor),
                         ...(emoji ? [{ author: reactor, emoji, at: Date.now() }] : []),
                     ];
-                    await this.engine.set(`/chat/${key.remoteJid}/message/${key.id}`, (0, store_1.serialize)(doc), doc.created_at);
+                    await this.engine.set(path, (0, store_1.serialize)(doc), doc.created_at);
                     const msg_instance = (0, message_1.message)(this, doc);
                     this.emit('message:reacted', msg_instance, await msg_instance.chat(), reaction.text ?? '', this);
                 }
@@ -1098,4 +1155,3 @@ class WhatsApp {
 }
 exports.WhatsApp = WhatsApp;
 exports.default = WhatsApp;
-//# sourceMappingURL=index.js.map

package/build/esm/decorators.js

@@ -6,4 +6,3 @@
  * API to build bots on top of the WhatsApp client.
  */
 export { WhatsAppBot, Bot, on, guard, command, from, once, connect, disconnect, every, delay, pipe, pair, HANDLERS, decorator, } from './lib/bot/index.js';
-//# sourceMappingURL=decorators.js.map

package/build/esm/index.js

@@ -9,4 +9,3 @@ export { Contact, contact } from './lib/contact/index.js';
 export { Chat, chat } from './lib/chat/index.js';
 export { Message, message, Text, Image, Video, Audio, Sticker, Document, Location, Poll, VCard, Event } from './lib/message/index.js';
 export { Feed, TTL_MS as FEED_TTL_MS } from './lib/status/index.js';
-//# sourceMappingURL=index.js.map

package/build/esm/lib/bot/decorator.js

@@ -243,4 +243,3 @@ export class WhatsAppBot extends WhatsApp {
     }
 }
 export default WhatsAppBot;
-//# sourceMappingURL=decorator.js.map

package/build/esm/lib/bot/decorators.d.ts

@@ -82,9 +82,9 @@ export declare function delay(ms: number): (_value: unknown, context: ClassMetho
 export declare const pair: () => (_value: unknown, context: ClassMethodDecoratorContext) => void;
 /**
  * Filtra por autor del mensaje. Acepta JID, LID o teléfono numérico; el string
- * se normaliza vía `wa._resolve_jid` con cache lazy. Un array produce match OR.
+ * se normaliza con la resolución interna del cliente y cache lazy. Un array produce match OR.
  * Filters by message author. Accepts JID, LID or numeric phone; the string is
- * normalized via `wa._resolve_jid` with lazy cache. An array yields OR matching.
+ * normalized through the client's internal resolution with lazy cache. An array yields OR matching.
  *
  * @param source - Identificador(es) permitidos o predicate sobre `msg.from` / Allowed identifier(s) or predicate on `msg.from`
  */

package/build/esm/lib/bot/decorators.js

@@ -3,6 +3,7 @@
  * @description Decoradores públicos del bot.
  * Public bot decorators.
  */
+import { internals } from '../../lib/internal.js';
 import { WhatsAppBot, decorator, register_workflow_step, resolve, } from './decorator.js';
 /**
  * Registra el método como listener del evento indicado. Apilable: varios `@on`
@@ -114,9 +115,9 @@ export const pair = decorator((_meta, h) => {
 });
 /**
  * Filtra por autor del mensaje. Acepta JID, LID o teléfono numérico; el string
- * se normaliza vía `wa._resolve_jid` con cache lazy. Un array produce match OR.
+ * se normaliza con la resolución interna del cliente y cache lazy. Un array produce match OR.
  * Filters by message author. Accepts JID, LID or numeric phone; the string is
- * normalized via `wa._resolve_jid` with lazy cache. An array yields OR matching.
+ * normalized through the client's internal resolution with lazy cache. An array yields OR matching.
  *
  * @param source - Identificador(es) permitidos o predicate sobre `msg.from` / Allowed identifier(s) or predicate on `msg.from`
  */
@@ -134,7 +135,7 @@ export function from(source) {
                 if (resolved === null) {
                     resolved = new Set();
                     for (const raw of list) {
-                        const r = await wa._resolve_jid(raw);
+                        const r = await internals(wa).resolve_jid(raw);
                         if (r) {
                             resolved.add(r);
                         }
@@ -247,4 +248,3 @@ export function command(pattern) {
         });
     };
 }
-//# sourceMappingURL=decorators.js.map

package/build/esm/lib/bot/index.js

@@ -1,3 +1,2 @@
 export { WhatsAppBot, HANDLERS, decorator } from './decorator.js';
 export { on, guard, command, from, once, connect, disconnect, every, delay, pipe, pair, Bot } from './decorators.js';
-//# sourceMappingURL=index.js.map

package/build/esm/lib/chat/index.d.ts

@@ -16,6 +16,7 @@ export declare class Chat {
         archived?: boolean | null;
         pinned?: number | null;
         mute_end_time?: number | null;
+        unread_count?: number | null;
     };
     /**
      * @internal Documento crudo del chat. `id` es el identificador del engine (JID, LID o
@@ -29,6 +30,7 @@ export declare class Chat {
         archived?: boolean | null;
         pinned?: number | null;
         mute_end_time?: number | null;
+        unread_count?: number | null;
     });
     /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
     get id(): string;
@@ -40,6 +42,8 @@ export declare class Chat {
     get archived(): boolean;
     /** true si el chat está fijado. / true when the chat is pinned. */
     get pinned(): boolean;
+    /** Mensajes sin leer del chat. / Chat's unread messages. */
+    get count(): number;
     /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
     get muted(): string | null;
 }
@@ -56,6 +60,7 @@ export declare function chat(wa: WhatsApp): {
         archived?: boolean | null;
         pinned?: number | null;
         mute_end_time?: number | null;
+        unread_count?: number | null;
     }): {
         /**
          * Participantes del chat: los integrantes en grupos, el contacto y yo en 1:1.
@@ -66,6 +71,15 @@ export declare function chat(wa: WhatsApp): {
          * @returns Página de contactos / Contact page
          */
         members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        content(): Promise<string>;
         /**
          * Mensajes del chat paginados desde el más reciente.
          * Chat messages paginated from the most recent one.
@@ -146,6 +160,7 @@ export declare function chat(wa: WhatsApp): {
             archived?: boolean | null;
             pinned?: number | null;
             mute_end_time?: number | null;
+            unread_count?: number | null;
         };
         /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
         get id(): string;
@@ -157,6 +172,8 @@ export declare function chat(wa: WhatsApp): {
         get archived(): boolean;
         /** true si el chat está fijado. / true when the chat is pinned. */
         get pinned(): boolean;
+        /** Mensajes sin leer del chat. / Chat's unread messages. */
+        get count(): number;
         /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
         get muted(): string | null;
     };
@@ -179,6 +196,15 @@ export declare function chat(wa: WhatsApp): {
          * @returns Página de contactos / Contact page
          */
         members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        content(): Promise<string>;
         /**
          * Mensajes del chat paginados desde el más reciente.
          * Chat messages paginated from the most recent one.
@@ -259,6 +285,7 @@ export declare function chat(wa: WhatsApp): {
             archived?: boolean | null;
             pinned?: number | null;
             mute_end_time?: number | null;
+            unread_count?: number | null;
         };
         /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
         get id(): string;
@@ -270,6 +297,8 @@ export declare function chat(wa: WhatsApp): {
         get archived(): boolean;
         /** true si el chat está fijado. / true when the chat is pinned. */
         get pinned(): boolean;
+        /** Mensajes sin leer del chat. / Chat's unread messages. */
+        get count(): number;
         /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
         get muted(): string | null;
     } | null>;
@@ -291,6 +320,15 @@ export declare function chat(wa: WhatsApp): {
          * @returns Página de contactos / Contact page
          */
         members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        content(): Promise<string>;
         /**
          * Mensajes del chat paginados desde el más reciente.
          * Chat messages paginated from the most recent one.
@@ -371,6 +409,7 @@ export declare function chat(wa: WhatsApp): {
             archived?: boolean | null;
             pinned?: number | null;
             mute_end_time?: number | null;
+            unread_count?: number | null;
         };
         /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
         get id(): string;
@@ -382,6 +421,8 @@ export declare function chat(wa: WhatsApp): {
         get archived(): boolean;
         /** true si el chat está fijado. / true when the chat is pinned. */
         get pinned(): boolean;
+        /** Mensajes sin leer del chat. / Chat's unread messages. */
+        get count(): number;
         /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
         get muted(): string | null;
     }[]>;

package/build/esm/lib/chat/index.js

@@ -40,6 +40,10 @@ export class Chat {
     get pinned() {
         return this._raw.pinned != null;
     }
+    /** Mensajes sin leer del chat. / Chat's unread messages. */
+    get count() {
+        return this._raw.unread_count ?? 0;
+    }
     /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
     get muted() {
         const end = this._raw.mute_end_time;
@@ -90,14 +94,14 @@ export function chat(wa) {
      * Participantes del grupo memoizados 15s, para no repetir `groupMetadata` en cada página.
      * Group participants memoized for 15s, avoiding a `groupMetadata` round-trip per page.
      */
-    const members_cache = new Map();
-    function group_members(jid) {
-        if (!members_cache.has(jid)) {
+    const groups_cache = new Map();
+    function group_meta(jid) {
+        if (!groups_cache.has(jid)) {
             const socket = internals(wa).socket;
-            members_cache.set(jid, socket ? socket.groupMetadata(jid).then((meta) => meta.participants).catch(() => []) : Promise.resolve([]));
-            setTimeout(() => members_cache.delete(jid), 15_000);
+            groups_cache.set(jid, socket ? socket.groupMetadata(jid).catch(() => ({ participants: [] })) : Promise.resolve({ participants: [] }));
+            setTimeout(() => groups_cache.delete(jid), 15_000);
         }
-        return members_cache.get(jid);
+        return groups_cache.get(jid);
     }
     /**
      * Contacto desde el engine, o ficha mínima local cuando no está persistido (sin red).
@@ -118,10 +122,24 @@ export function chat(wa) {
          */
         async members(offset = 0, limit = 50) {
             const ids = this.type === 'group'
-                ? (await group_members(this._raw.id)).map((participant) => participant.id)
+                ? (await group_meta(this._raw.id)).participants.map((participant) => participant.id)
                 : [this._raw.id, internals(wa).socket?.user?.id].filter((id) => Boolean(id));
             return Promise.all(ids.slice(offset, offset + limit).map(load_contact));
         }
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        async content() {
+            if (this.type === 'group') {
+                return (await group_meta(this._raw.id)).desc ?? '';
+            }
+            return deserialize(await wa.engine.get(`/contact/${this._raw.id}`))?.status ?? '';
+        }
         /**
          * Mensajes del chat paginados desde el más reciente.
          * Chat messages paginated from the most recent one.
@@ -237,6 +255,8 @@ export function chat(wa) {
             const socket = internals(wa).socket;
             if (socket) {
                 await socket.chatModify({ markRead: true, lastMessages: await last_messages(this._raw.id) }, this._raw.id);
+                this._raw.unread_count = 0;
+                await wa.engine.set(`/chat/${this._raw.id}`, serialize(this._raw));
                 ok = true;
             }
             return ok;
@@ -318,4 +338,3 @@ export function chat(wa) {
         }
     };
 }
-//# sourceMappingURL=index.js.map

package/build/esm/lib/contact/index.js

@@ -146,4 +146,3 @@ export function contact(wa) {
         }
     };
 }
-//# sourceMappingURL=index.js.map

package/build/esm/lib/internal.js

@@ -32,4 +32,3 @@ export function bind(owner, state) {
 export function internals(owner) {
     return channel.get(owner);
 }
-//# sourceMappingURL=internal.js.map