@arcaelas/whatsapp 6.0.0 → 6.1.0

package/README.md

@@ -56,8 +56,8 @@ Node 20 o superior. El paquete se distribuye en ESM y CJS.
 import WhatsApp, { FileSystemEngine } from '@arcaelas/whatsapp';
 
 const wa = new WhatsApp({
-    engine: new FileSystemEngine('.sessions/584144709840'),
-    phone: 584144709840,
+    engine: new FileSystemEngine('.sessions/5491112345678'),
+    phone: 5491112345678,
 });
 
 wa.on('message:created', async (msg) => {
@@ -119,7 +119,7 @@ await wa.profile({ photo: null });          // elimina la foto
 
 const post = await wa.feed({
     caption: '¡Estamos en vivo!',
-    contacts: ['584144709840', '56963091328'],   // audiencia obligatoria
+    contacts: ['5491112345678', '584121234567'],   // audiencia obligatoria
 });
 ```
 
@@ -134,13 +134,13 @@ Cada entidad expone getters puros sobre su documento y métodos que actúan cont
 ### Contact
 
 ```ts
-const person = await wa.Contact.get('584144709840');   // teléfono, JID o LID
+const person = await wa.Contact.get('5491112345678');   // teléfono, JID o LID
 const page = await wa.Contact.list(0, 50);
 
 if (person) {
     person.name      // agenda → nombre público → nombre verificado → teléfono
     person.phone     // solo del JID PN, nunca del LID; null si no es determinable
-    person.jid       // '584144709840@s.whatsapp.net' | null
+    person.jid       // '5491112345678@s.whatsapp.net' | null
     person.lid       // '123456789@lid' | null
     person.photo     // URL de la foto | null
     await person.chat();
@@ -152,7 +152,7 @@ if (person) {
 ### Chat
 
 ```ts
-const chat = await wa.Chat.get('584144709840');
+const chat = await wa.Chat.get('5491112345678');
 const chats = await wa.Chat.list(0, 50);
 
 if (chat) {
@@ -198,6 +198,8 @@ const msg = await wa.Message.get(cid, mid);
 | `caption` | texto del mensaje o pie del media |
 | `status` | `'error'` `'pending'` `'sent'` `'delivered'` `'read'` `'played'` |
 | `read` `starred` `forwarded` `edited` `once` | banderas del mensaje |
+| `reason` | motivo del rechazo cuando `status` es `'error'` (`restricted`, `invalid-session`, o el código del servidor), si no `null` |
+| `business` | nombre del negocio verificado que firma el mensaje, o `null` |
 | `created_at` `expires_at` | fechas en ISO UTC (`expires_at` solo en mensajes temporales) |
 
 **Métodos**
@@ -319,10 +321,10 @@ import IORedis from 'ioredis';
 import { S3Client } from '@aws-sdk/client-s3';
 import { FileSystemEngine, SQLiteEngine, RedisEngine, S3Engine } from '@arcaelas/whatsapp';
 
-new FileSystemEngine('.sessions/584144709840');
-new SQLiteEngine(new Database('.sessions/584144709840.db'));
-new RedisEngine(new IORedis(), 'wa:584144709840');
-new S3Engine({ s3: new S3Client({}), bucket: 'sesiones', basedir: 'wa/584144709840' });
+new FileSystemEngine('.sessions/5491112345678');
+new SQLiteEngine(new Database('.sessions/5491112345678.db'));
+new RedisEngine(new IORedis(), 'wa:5491112345678');
+new S3Engine({ s3: new S3Client({}), bucket: 'sesiones', basedir: 'wa/5491112345678' });
 ```
 
 `SQLiteEngine` es el más eficiente de los integrados. Sobre un chat real de 55.146 mensajes, frente al filesystem: 220 MB → 64 MB en disco, primer `list` 115 ms → 0,6 ms, y dos archivos en total en lugar de ~110.000 inodes.
@@ -348,7 +350,7 @@ class Bot extends WhatsAppBot {
         await msg.text(`Consultando ${args[0] ?? 'el catálogo'}…`);
     }
 
-    @from('584144709840')
+    @from('5491112345678')
     async only_admin(msg: Message) {
         await msg.react('👑');
     }
@@ -359,7 +361,7 @@ class Bot extends WhatsAppBot {
     }
 }
 
-const bot = new Bot({ engine: new FileSystemEngine('.sessions/bot'), phone: 584144709840 });
+const bot = new Bot({ engine: new FileSystemEngine('.sessions/bot'), phone: 5491112345678 });
 await bot.connect((auth) => console.log(auth));
 ```
 
@@ -395,7 +397,7 @@ wa.on('message:created', async (msg, chat) => {
 **Reconectar con límite y cerrar en silencio**
 
 ```ts
-const wa = new WhatsApp({ engine, phone: 584144709840, reconnect: { max: 5, interval: 30 } });
+const wa = new WhatsApp({ engine, phone: 5491112345678, reconnect: { max: 5, interval: 30 } });
 await wa.disconnect({ silent: true });   // no emite `disconnected`
 ```
 

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

@@ -103,6 +103,10 @@ export declare class Message {
     get status(): (typeof STATUS)[number];
     /** true si el mensaje fue visto. / true when the message was seen. */
     get read(): boolean;
+    /** Motivo del rechazo cuando `status` es `error` (`restricted`, `invalid-session`, o el código crudo); null en cualquier otro caso. / Rejection reason when `status` is `error` (`restricted`, `invalid-session`, or the raw code); null otherwise. */
+    get reason(): string | null;
+    /** Nombre del negocio verificado que firma el mensaje, o null. / Verified business name signing the message, or null. */
+    get business(): string | null;
     /** true si está destacado. / true when starred. */
     get starred(): boolean;
     /** true si fue reenviado. / true when forwarded. */

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

@@ -18,6 +18,16 @@ const chat_1 = require("../../lib/chat");
 const store_1 = require("../../lib/store");
 /** Estados legibles indexados por el status numérico de baileys. / Readable states indexed by the baileys numeric status. */
 const STATUS = ['error', 'pending', 'sent', 'delivered', 'read', 'played'];
+/**
+ * Motivos legibles de los códigos con los que el servidor rechaza un mensaje. `restricted`
+ * es la cuenta limitada por WhatsApp: puede seguir chats existentes pero no abrir nuevos.
+ * Readable reasons for the codes the server rejects a message with. `restricted` is an
+ * account limited by WhatsApp: it can continue existing chats but not open new ones.
+ */
+const REASON = {
+    463: 'restricted',
+    479: 'invalid-session',
+};
 const MESSAGE_TYPE_MAP = {
     conversation: 'text',
     extendedTextMessage: 'text',
@@ -79,11 +89,11 @@ async function send(wa, cid, content, binary, extra = {}, doc_overrides) {
         const quoted = extra.mid
             ? ((0, store_1.deserialize)(await wa.engine.get(`/chat/${jid}/message/${extra.mid}`))?.raw ?? undefined)
             : undefined;
-        const raw = await socket.sendMessage(jid, {
-            ...content,
-            ...(extra.once && { viewOnce: true }),
-            ...(quoted && { quoted }),
-        });
+        // La cita viaja en las opciones del socket, no en el contenido: dentro del contenido
+        // baileys la ignora y el mensaje sale sin `contextInfo`.
+        // The quote travels in the socket options, not in the content: inside the content
+        // baileys ignores it and the message goes out without `contextInfo`.
+        const raw = await socket.sendMessage(jid, { ...content, ...(extra.once && { viewOnce: true }) }, { ...(quoted && { quoted }) });
         const sent_id = raw?.key?.id;
         if (raw && sent_id) {
             const instance = message(wa, raw);
@@ -231,6 +241,17 @@ class Message {
     get read() {
         return this._raw.status >= 4;
     }
+    /** Motivo del rechazo cuando `status` es `error` (`restricted`, `invalid-session`, o el código crudo); null en cualquier otro caso. / Rejection reason when `status` is `error` (`restricted`, `invalid-session`, or the raw code); null otherwise. */
+    get reason() {
+        const code = this._raw.raw.messageStubParameters?.[0];
+        if (this._raw.status === 0 && code)
+            return REASON[code] ?? code;
+        return null;
+    }
+    /** Nombre del negocio verificado que firma el mensaje, o null. / Verified business name signing the message, or null. */
+    get business() {
+        return this._raw.raw.verifiedBizName ?? null;
+    }
     /** true si está destacado. / true when starred. */
     get starred() {
         return this._raw.starred;

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

@@ -44,11 +44,11 @@ export interface SQLiteDatabase {
  *
  * @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;

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

@@ -26,11 +26,11 @@ const lib_1 = require("../../../../../lib/store/engine/lib");
  *
  * @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 {
     /**

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));
  */
@@ -221,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`;
                 }
@@ -235,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).
@@ -719,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);
@@ -1027,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) {
@@ -1038,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;
@@ -1051,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);
                     }
@@ -1060,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);
                     }
@@ -1068,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);
                     }
@@ -1097,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);
                 }

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

@@ -103,6 +103,10 @@ export declare class Message {
     get status(): (typeof STATUS)[number];
     /** true si el mensaje fue visto. / true when the message was seen. */
     get read(): boolean;
+    /** Motivo del rechazo cuando `status` es `error` (`restricted`, `invalid-session`, o el código crudo); null en cualquier otro caso. / Rejection reason when `status` is `error` (`restricted`, `invalid-session`, or the raw code); null otherwise. */
+    get reason(): string | null;
+    /** Nombre del negocio verificado que firma el mensaje, o null. / Verified business name signing the message, or null. */
+    get business(): string | null;
     /** true si está destacado. / true when starred. */
     get starred(): boolean;
     /** true si fue reenviado. / true when forwarded. */

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

@@ -14,6 +14,16 @@ import { Chat } from '../../lib/chat/index.js';
 import { deserialize, serialize } from '../../lib/store/index.js';
 /** Estados legibles indexados por el status numérico de baileys. / Readable states indexed by the baileys numeric status. */
 const STATUS = ['error', 'pending', 'sent', 'delivered', 'read', 'played'];
+/**
+ * Motivos legibles de los códigos con los que el servidor rechaza un mensaje. `restricted`
+ * es la cuenta limitada por WhatsApp: puede seguir chats existentes pero no abrir nuevos.
+ * Readable reasons for the codes the server rejects a message with. `restricted` is an
+ * account limited by WhatsApp: it can continue existing chats but not open new ones.
+ */
+const REASON = {
+    463: 'restricted',
+    479: 'invalid-session',
+};
 const MESSAGE_TYPE_MAP = {
     conversation: 'text',
     extendedTextMessage: 'text',
@@ -75,11 +85,11 @@ async function send(wa, cid, content, binary, extra = {}, doc_overrides) {
         const quoted = extra.mid
             ? (deserialize(await wa.engine.get(`/chat/${jid}/message/${extra.mid}`))?.raw ?? undefined)
             : undefined;
-        const raw = await socket.sendMessage(jid, {
-            ...content,
-            ...(extra.once && { viewOnce: true }),
-            ...(quoted && { quoted }),
-        });
+        // La cita viaja en las opciones del socket, no en el contenido: dentro del contenido
+        // baileys la ignora y el mensaje sale sin `contextInfo`.
+        // The quote travels in the socket options, not in the content: inside the content
+        // baileys ignores it and the message goes out without `contextInfo`.
+        const raw = await socket.sendMessage(jid, { ...content, ...(extra.once && { viewOnce: true }) }, { ...(quoted && { quoted }) });
         const sent_id = raw?.key?.id;
         if (raw && sent_id) {
             const instance = message(wa, raw);
@@ -227,6 +237,17 @@ export class Message {
     get read() {
         return this._raw.status >= 4;
     }
+    /** Motivo del rechazo cuando `status` es `error` (`restricted`, `invalid-session`, o el código crudo); null en cualquier otro caso. / Rejection reason when `status` is `error` (`restricted`, `invalid-session`, or the raw code); null otherwise. */
+    get reason() {
+        const code = this._raw.raw.messageStubParameters?.[0];
+        if (this._raw.status === 0 && code)
+            return REASON[code] ?? code;
+        return null;
+    }
+    /** Nombre del negocio verificado que firma el mensaje, o null. / Verified business name signing the message, or null. */
+    get business() {
+        return this._raw.raw.verifiedBizName ?? null;
+    }
     /** true si está destacado. / true when starred. */
     get starred() {
         return this._raw.starred;

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

@@ -44,11 +44,11 @@ export interface SQLiteDatabase {
  *
  * @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;

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

@@ -23,11 +23,11 @@ import { normalize_path, split_path } from '../../../../../lib/store/engine/lib/
  *
  * @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 class SQLiteEngine {
     /**

package/build/esm/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/esm/lib/whatsapp/index.js

@@ -39,7 +39,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));
  */
@@ -182,12 +182,15 @@ export class WhatsApp {
             result = uid;
         }
         else if (uid.endsWith('@lid')) {
-            const direct = 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 = jidNormalizedUser(uid);
+            const direct = deserialize(await this.engine.get(`/lid/${lid}`));
             if (direct) {
                 result = direct.includes('@') ? direct : `${direct}@s.whatsapp.net`;
             }
             else {
-                const reverse = deserialize(await this.engine.get(`/lid/${uid.split('@')[0]}_reverse`));
+                const reverse = deserialize(await this.engine.get(`/lid/${lid.split('@')[0]}_reverse`));
                 if (reverse != null) {
                     result = `${reverse}@s.whatsapp.net`;
                 }
@@ -196,7 +199,7 @@ export 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).
@@ -680,13 +683,14 @@ export class WhatsApp {
                 continue;
             }
             if (key.remoteJid && key.id && (receipt.readTimestamp != null || receipt.playedTimestamp != null)) {
-                const doc = 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}`, serialize(doc), doc.created_at);
+                        await this.engine.set(path, serialize(doc), doc.created_at);
                     }
                     const msg_instance = message(this, doc);
                     this.emit('message:seen', msg_instance, await msg_instance.chat(), this);
@@ -988,6 +992,33 @@ export 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, jidNormalizedUser(cid)]) {
+            if (candidate && !tried.has(candidate)) {
+                tried.add(candidate);
+                const path = `/chat/${candidate}/message/${mid}`;
+                const doc = 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) {
@@ -999,8 +1030,9 @@ export class WhatsApp {
                 if (key.remoteJid === 'status@broadcast') {
                     continue;
                 }
-                const doc = 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;
@@ -1012,7 +1044,7 @@ export class WhatsApp {
                         doc.raw = raw;
                         doc.edited = true;
                         doc.caption = message(this, raw).caption;
-                        await this.engine.set(`/chat/${key.remoteJid}/message/${key.id}`, serialize(doc), doc.created_at);
+                        await this.engine.set(path, serialize(doc), doc.created_at);
                         const msg_instance = message(this, doc);
                         this.emit('message:updated', msg_instance, await msg_instance.chat(), this);
                     }
@@ -1021,7 +1053,7 @@ export class WhatsApp {
                         raw.message = { ...raw.message, ...content_update };
                         doc.raw = raw;
                         doc.caption = message(this, raw).caption;
-                        await this.engine.set(`/chat/${key.remoteJid}/message/${key.id}`, serialize(doc), doc.created_at);
+                        await this.engine.set(path, serialize(doc), doc.created_at);
                         const msg_instance = message(this, doc);
                         this.emit('message:updated', msg_instance, await msg_instance.chat(), this);
                     }
@@ -1029,15 +1061,22 @@ export 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}`, serialize(doc), doc.created_at);
+                        await this.engine.set(path, serialize(doc), doc.created_at);
                         const msg_instance = 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}`, serialize(doc), doc.created_at);
+                        await this.engine.set(path, serialize(doc), doc.created_at);
                         const msg_instance = message(this, doc);
                         this.emit('message:updated', msg_instance, await msg_instance.chat(), this);
                     }
@@ -1058,15 +1097,16 @@ export class WhatsApp {
                     }
                     continue;
                 }
-                const doc = 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 = 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}`, serialize(doc), doc.created_at);
+                    await this.engine.set(path, serialize(doc), doc.created_at);
                     const msg_instance = message(this, doc);
                     this.emit('message:reacted', msg_instance, await msg_instance.chat(), reaction.text ?? '', this);
                 }

package/package.json

@@ -72,7 +72,7 @@
     "release": "npm publish --access public"
   },
   "types": "./build/esm/index.d.ts",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "engines": {
     "node": ">=20"
   },