@arcaelas/whatsapp 4.2.0 → 4.4.0

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

@@ -88,13 +88,7 @@ class RedisEngine {
             return [];
         }
         const raws = await this._client.mget(members.map((m) => this._doc_key(m)));
-        const result = [];
-        for (const raw of raws) {
-            if (raw !== null) {
-                result.push(raw);
-            }
-        }
-        return result;
+        return raws.filter((raw) => raw !== null);
     }
     /**
      * Cuenta hijos directos en O(1) usando ZCARD.

package/build/cjs/lib/store/engine/lib/redis/index.js.map

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

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

@@ -0,0 +1,66 @@
+/**
+ * @file store/engine/lib/s3/index.ts
+ * @description Driver de persistencia con AWS S3 (caché local opcional).
+ * AWS S3 persistence driver (optional local cache).
+ */
+import { S3Client } from '@aws-sdk/client-s3';
+import type { Engine } from '../../../../../lib/store/engine';
+/**
+ * Configuración de la caché local. Cada entrada se limpia con un `setTimeout`
+ * (no hay campo de expiración en la lectura). `when` decide qué keys se cachean;
+ * el resto va directo a S3.
+ * Local cache configuration. Each entry is cleared with a `setTimeout` (no
+ * expiration field on read). `when` decides which keys get cached; everything
+ * else goes straight to S3.
+ */
+interface CacheOptions {
+    /** Tiempo de vida de cada entrada en ms. / Time-to-live of each entry in ms. */
+    ttl: number;
+    /** Predicado que decide si un path se cachea. / Predicate deciding whether a path is cached. */
+    when(key: string): boolean;
+}
+interface S3EngineOptions {
+    /** Cliente S3 ya configurado. / Pre-configured S3 client. */
+    s3: S3Client;
+    /** Nombre del bucket. / Bucket name. */
+    bucket: string;
+    /** Prefijo base de las keys dentro del bucket. / Base key prefix inside the bucket. */
+    basedir: string;
+    /**
+     * Caché local: `false` la desactiva; un objeto `{ ttl, when }` la configura.
+     * Default: `false` (sin caché).
+     * Local cache: `false` disables it; an object `{ ttl, when }` configures it.
+     * Default: `false` (no cache).
+     */
+    cache?: false | CacheOptions;
+}
+export declare class S3Engine implements Engine {
+    private readonly _client;
+    private readonly _bucket;
+    private readonly _prefix;
+    private readonly _cache_opts;
+    /** @internal Caché local de documentos, con su timer de expiración. / Local cache of documents, with its expiration timer. */
+    private readonly _cache;
+    constructor(options: S3EngineOptions);
+    private _key;
+    /**
+     * Indica si un path es elegible para caché según la configuración `when`.
+     * Reports whether a path is eligible for caching per the `when` config.
+     */
+    private _cacheable;
+    /**
+     * Guarda un valor en la caché local y programa su limpieza con un `setTimeout`.
+     * Reemplaza el timer previo si la key ya estaba cacheada para no acumular timers.
+     * Stores a value in the local cache and schedules its cleanup with a `setTimeout`.
+     * Replaces the previous timer when the key was already cached so timers don't pile up.
+     */
+    private _cache_set;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    list(path: string, offset?: number, limit?: number): Promise<string[]>;
+    delete_prefix(prefix: string): Promise<number>;
+    unset(path: string): Promise<boolean>;
+    count(path: string): Promise<number>;
+    clear(): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * @file store/engine/lib/s3/index.ts
+ * @description Driver de persistencia con AWS S3 (caché local opcional).
+ * AWS S3 persistence driver (optional local cache).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3Engine = void 0;
+const client_s3_1 = require("@aws-sdk/client-s3");
+/**
+ * Normaliza un path colapsando slashes redundantes.
+ * Normalizes a path by collapsing redundant slashes.
+ */
+function normalize_path(path) {
+    return path.replace(/\/+/g, '/').replace(/^\/|\/$/g, '');
+}
+class S3Engine {
+    constructor(options) {
+        /** @internal Caché local de documentos, con su timer de expiración. / Local cache of documents, with its expiration timer. */
+        this._cache = new Map();
+        this._client = options.s3;
+        this._bucket = options.bucket;
+        this._prefix = options.basedir.endsWith('/') ? options.basedir : `${options.basedir}/`;
+        this._cache_opts = options.cache ?? false;
+    }
+    _key(key) {
+        return `${this._prefix}${normalize_path(key).replace(/@/g, '_at_')}`;
+    }
+    /**
+     * Indica si un path es elegible para caché según la configuración `when`.
+     * Reports whether a path is eligible for caching per the `when` config.
+     */
+    _cacheable(path) {
+        return this._cache_opts !== false && this._cache_opts.when(path);
+    }
+    /**
+     * Guarda un valor en la caché local y programa su limpieza con un `setTimeout`.
+     * Reemplaza el timer previo si la key ya estaba cacheada para no acumular timers.
+     * Stores a value in the local cache and schedules its cleanup with a `setTimeout`.
+     * Replaces the previous timer when the key was already cached so timers don't pile up.
+     */
+    _cache_set(path, value) {
+        if (this._cache_opts === false) {
+            return;
+        }
+        clearTimeout(this._cache.get(path)?.timer);
+        this._cache.set(path, {
+            value,
+            timer: setTimeout(() => this._cache.delete(path), this._cache_opts.ttl),
+        });
+    }
+    async get(key) {
+        if (this._cacheable(key) && this._cache.has(key)) {
+            return this._cache.get(key).value;
+        }
+        const value = await (async () => {
+            try {
+                const res = await this._client.send(new client_s3_1.GetObjectCommand({ Bucket: this._bucket, Key: this._key(key) }));
+                return (await res.Body?.transformToString('utf-8')) ?? null;
+            }
+            catch {
+                return null;
+            }
+        })();
+        if (this._cacheable(key)) {
+            this._cache_set(key, value);
+        }
+        return value;
+    }
+    async set(key, value) {
+        const remote = this._client.send(new client_s3_1.PutObjectCommand({ Bucket: this._bucket, Key: this._key(key), Body: value, ContentType: 'application/json' }));
+        if (this._cacheable(key)) {
+            this._cache_set(key, value);
+        }
+        await remote;
+    }
+    async list(path, offset = 0, limit = 50) {
+        const parent = `${this._prefix}${normalize_path(path).replace(/@/g, '_at_')}/`;
+        const children = new Map();
+        let token;
+        do {
+            const res = await this._client.send(new client_s3_1.ListObjectsV2Command({
+                Bucket: this._bucket,
+                Prefix: parent,
+                ContinuationToken: token,
+                MaxKeys: 1000,
+            }));
+            for (const obj of res.Contents ?? []) {
+                if (!obj.Key)
+                    continue;
+                const rest = obj.Key.slice(parent.length);
+                const child_key = `${parent}${rest.split('/')[0]}`;
+                const mtime = obj.LastModified?.getTime() ?? 0;
+                children.set(child_key, Math.max(children.get(child_key) ?? 0, mtime));
+            }
+            token = res.NextContinuationToken;
+        } while (token);
+        const ordered = [...children.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(offset, offset + limit)
+            .map(([key]) => key);
+        const values = await Promise.all(ordered.map(async (key) => {
+            try {
+                const res = await this._client.send(new client_s3_1.GetObjectCommand({ Bucket: this._bucket, Key: key }));
+                return (await res.Body?.transformToString('utf-8')) ?? null;
+            }
+            catch {
+                return null;
+            }
+        }));
+        return values.filter((value) => value !== null);
+    }
+    async delete_prefix(prefix) {
+        const full_prefix = `${this._prefix}${normalize_path(prefix).replace(/@/g, '_at_')}`;
+        let deleted = 0;
+        let token;
+        do {
+            const res = await this._client.send(new client_s3_1.ListObjectsV2Command({
+                Bucket: this._bucket,
+                Prefix: full_prefix,
+                ContinuationToken: token,
+                MaxKeys: 1000,
+            }));
+            const keys = (res.Contents ?? []).filter((o) => o.Key).map((o) => ({ Key: o.Key }));
+            if (keys.length) {
+                await this._client.send(new client_s3_1.DeleteObjectsCommand({ Bucket: this._bucket, Delete: { Objects: keys } }));
+                deleted += keys.length;
+            }
+            token = res.NextContinuationToken;
+        } while (token);
+        return deleted;
+    }
+    async unset(path) {
+        if (this._cacheable(path)) {
+            for (const key of this._cache.keys()) {
+                if (key === path || key.startsWith(`${path}/`)) {
+                    clearTimeout(this._cache.get(key).timer);
+                    this._cache.delete(key);
+                }
+            }
+        }
+        return (await this.delete_prefix(path)) > 0;
+    }
+    async count(path) {
+        const full_prefix = `${this._prefix}${normalize_path(path).replace(/@/g, '_at_')}`;
+        let total = 0;
+        let token;
+        do {
+            const res = await this._client.send(new client_s3_1.ListObjectsV2Command({
+                Bucket: this._bucket,
+                Prefix: full_prefix,
+                ContinuationToken: token,
+                MaxKeys: 1000,
+            }));
+            total += res.Contents?.length ?? 0;
+            token = res.NextContinuationToken;
+        } while (token);
+        return total;
+    }
+    async clear() {
+        for (const { timer } of this._cache.values()) {
+            clearTimeout(timer);
+        }
+        this._cache.clear();
+        await this.delete_prefix('');
+    }
+}
+exports.S3Engine = S3Engine;
+//# sourceMappingURL=index.js.map

package/build/cjs/lib/store/engine/lib/s3/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/lib/store/engine/lib/s3/index.ts"],"names":[],"mappings":"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"}

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

@@ -3,7 +3,7 @@
  * @description Barrel del módulo store — reexporta Engine + drivers y expone helpers de serialización.
  * Store module barrel — re-exports Engine + drivers and provides serialization helpers.
  */
-export { FileSystemEngine, RedisEngine, type Engine, type RedisClient } from '../../lib/store/engine';
+export { FileSystemEngine, RedisEngine, S3Engine, type Engine, type RedisClient } from '../../lib/store/engine';
 /**
  * Serializa un documento a string preservando Buffers con BufferJSON de baileys.
  * Serializes a document to string preserving Buffers via baileys BufferJSON.

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

@@ -5,13 +5,14 @@
  * Store module barrel — re-exports Engine + drivers and provides serialization helpers.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RedisEngine = exports.FileSystemEngine = void 0;
+exports.S3Engine = exports.RedisEngine = exports.FileSystemEngine = void 0;
 exports.serialize = serialize;
 exports.deserialize = deserialize;
 const baileys_1 = require("baileys");
 var engine_1 = require("../../lib/store/engine");
 Object.defineProperty(exports, "FileSystemEngine", { enumerable: true, get: function () { return engine_1.FileSystemEngine; } });
 Object.defineProperty(exports, "RedisEngine", { enumerable: true, get: function () { return engine_1.RedisEngine; } });
+Object.defineProperty(exports, "S3Engine", { enumerable: true, get: function () { return engine_1.S3Engine; } });
 /**
  * Serializa un documento a string preservando Buffers con BufferJSON de baileys.
  * Serializes a document to string preserving Buffers via baileys BufferJSON.

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/store/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAaH,8BAEC;AASD,kCAKC;AA3BD,qCAAqC;AAErC,6CAAkG;AAAzF,0GAAA,gBAAgB,OAAA;AAAE,qGAAA,WAAW,OAAA;AAEtC;;;;;;GAMG;AACH,SAAgB,SAAS,CAAI,GAAM;IACjC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,oBAAU,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAI,GAAkB;IAC/C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,oBAAU,CAAC,OAAO,CAAM,CAAC;AAClD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/store/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAaH,8BAEC;AASD,kCAKC;AA3BD,qCAAqC;AAErC,6CAA4G;AAAnG,0GAAA,gBAAgB,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAEhD;;;;;;GAMG;AACH,SAAgB,SAAS,CAAI,GAAM;IACjC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,oBAAU,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAI,GAAkB;IAC/C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,oBAAU,CAAC,OAAO,CAAM,CAAC;AAClD,CAAC"}

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

@@ -158,6 +158,14 @@ export declare class WhatsApp {
      * @internal
      */
     private _attach_business_handlers;
+    /**
+     * Persiste un contacto y su índice LID; emite `contact:created` solo si es nuevo.
+     * Persists a contact and its LID index; emits `contact:created` only when new.
+     *
+     * @param raw - Documento del contacto a persistir / Contact document to persist
+     * @internal
+     */
+    private _persist_contact;
     /** @internal */
     private _handle_contacts_upsert;
     /** @internal */

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

@@ -173,7 +173,7 @@ class WhatsApp {
                         keys: {
                             get: async (type, ids) => {
                                 const data = {};
-                                for (const id of ids) {
+                                await Promise.all(ids.map(async (id) => {
                                     const value = (0, store_1.deserialize)(await this.engine.get(`/session/${type}/${id}`));
                                     if (value) {
                                         data[id] =
@@ -181,21 +181,13 @@ class WhatsApp {
                                                 ? baileys_1.proto.Message.AppStateSyncKeyData.create(value)
                                                 : value;
                                     }
-                                }
+                                }));
                                 return data;
                             },
                             set: async (data) => {
-                                for (const category in data) {
-                                    for (const id in data[category]) {
-                                        const value = data[category][id];
-                                        if (value != null) {
-                                            await this.engine.set(`/session/${category}/${id}`, (0, store_1.serialize)(value));
-                                        }
-                                        else {
-                                            await this.engine.unset(`/session/${category}/${id}`);
-                                        }
-                                    }
-                                }
+                                await Promise.all(Object.entries(data).flatMap(([category, entries]) => Object.entries(entries).map(([id, value]) => value != null
+                                    ? this.engine.set(`/session/${category}/${id}`, (0, store_1.serialize)(value))
+                                    : this.engine.unset(`/session/${category}/${id}`))));
                             },
                         },
                     },
@@ -359,12 +351,30 @@ class WhatsApp {
         //     void this._handle_messages_reaction(reactions);
         // });
     }
+    /**
+     * Persiste un contacto y su índice LID; emite `contact:created` solo si es nuevo.
+     * Persists a contact and its LID index; emits `contact:created` only when new.
+     *
+     * @param raw - Documento del contacto a persistir / Contact document to persist
+     * @internal
+     */
+    async _persist_contact(raw) {
+        const existing = await this.engine.get(`/contact/${raw.id}`);
+        await this.engine.set(`/contact/${raw.id}`, (0, store_1.serialize)(raw));
+        if (raw.lid) {
+            await this.engine.set(`/lid/${raw.lid}`, (0, store_1.serialize)(raw.id));
+        }
+        if (existing === null) {
+            const cached_chat = (0, store_1.deserialize)(await this.engine.get(`/chat/${raw.id}`));
+            const chat_instance = new this.Chat(cached_chat ?? { id: raw.id, name: (0, contact_1.contact_name)(raw) });
+            this._event.emit('contact:created', new this.Contact(raw, chat_instance), chat_instance, this);
+        }
+    }
     /** @internal */
     async _handle_contacts_upsert(contacts) {
         for (const c of contacts) {
             if (c.id) {
-                const existing = await this.engine.get(`/contact/${c.id}`);
-                const raw = {
+                await this._persist_contact({
                     id: c.id,
                     lid: c.lid ?? null,
                     name: c.name ?? null,
@@ -372,16 +382,7 @@ class WhatsApp {
                     verified_name: c.verifiedName ?? null,
                     img_url: c.imgUrl ?? null,
                     status: c.status ?? null,
-                };
-                await this.engine.set(`/contact/${c.id}`, (0, store_1.serialize)(raw));
-                if (raw.lid) {
-                    await this.engine.set(`/lid/${raw.lid}`, (0, store_1.serialize)(raw.id));
-                }
-                if (existing === null) {
-                    const cached_chat = (0, store_1.deserialize)(await this.engine.get(`/chat/${raw.id}`));
-                    const chat_instance = new this.Chat(cached_chat ?? { id: raw.id, name: raw.name ?? raw.notify ?? raw.id.split('@')[0] });
-                    this._event.emit('contact:created', new this.Contact(raw, chat_instance), chat_instance, this);
-                }
+                });
             }
         }
     }
@@ -391,22 +392,13 @@ class WhatsApp {
             if (c.id) {
                 const current = (0, store_1.deserialize)(await this.engine.get(`/contact/${c.id}`));
                 if (current) {
-                    const patch = {};
-                    if (c.notify) {
-                        patch.notify = c.notify;
-                    }
-                    if (c.name) {
-                        patch.name = c.name;
-                    }
-                    if (c.imgUrl) {
-                        patch.img_url = c.imgUrl;
-                    }
-                    if (c.status) {
-                        patch.status = c.status;
-                    }
-                    if (c.lid) {
-                        patch.lid = c.lid;
-                    }
+                    const patch = {
+                        ...(c.notify && { notify: c.notify }),
+                        ...(c.name && { name: c.name }),
+                        ...(c.imgUrl && { img_url: c.imgUrl }),
+                        ...(c.status && { status: c.status }),
+                        ...(c.lid && { lid: c.lid }),
+                    };
                     if (Object.keys(patch).length > 0) {
                         const merged = { ...current, ...patch };
                         await this.engine.set(`/contact/${c.id}`, (0, store_1.serialize)(merged));
@@ -414,7 +406,7 @@ class WhatsApp {
                             await this.engine.set(`/lid/${patch.lid}`, (0, store_1.serialize)(c.id));
                         }
                         const cached_chat = (0, store_1.deserialize)(await this.engine.get(`/chat/${c.id}`));
-                        const chat_instance = new this.Chat(cached_chat ?? { id: c.id, name: merged.name ?? merged.notify ?? c.id.split('@')[0] });
+                        const chat_instance = new this.Chat(cached_chat ?? { id: c.id, name: (0, contact_1.contact_name)(merged) });
                         this._event.emit('contact:updated', new this.Contact(merged, chat_instance), chat_instance, this);
                     }
                 }
@@ -636,45 +628,60 @@ class WhatsApp {
                         if (poll_doc && message_secret) {
                             try {
                                 const poll_key = poll_doc.raw.key ?? {};
-                                // WhatsApp moderno usa LID normalizado para identidad del HMAC
-                                // tanto en votos propios (echo) como foráneos. Espejo del fix de
-                                // `Poll.select()` (ver `src/lib/message`).
-                                // Modern WhatsApp uses normalized LID identity for HMAC on both
-                                // own-vote echoes and foreign votes. Mirrors the `Poll.select()` fix.
+                                // La identidad propia del HMAC depende del addressing del chat
+                                // (LID en @lid, PN en @s.whatsapp.net), así que para las posiciones
+                                // fromMe se intenta descifrar con ambas: AES-GCM autentica, la
+                                // clave equivocada lanza y se prueba la siguiente.
+                                // Own HMAC identity depends on chat addressing (LID on @lid, PN on
+                                // @s.whatsapp.net), so fromMe positions try both candidates:
+                                // AES-GCM authenticates, a wrong key throws and the next is tried.
                                 const self_id = this._socket?.user?.id ?? '';
                                 const self_lid = this._socket?.user?.lid ?? '';
-                                const voter_raw = msg.key.fromMe
-                                    ? (self_lid || self_id)
-                                    : msg.key.remoteJid?.endsWith('@lid')
-                                        ? msg.key.remoteJid
-                                        : msg.key.participant ||
-                                            msg.key.remoteJidAlt ||
-                                            msg.key.remoteJid ||
-                                            '';
-                                const creator_raw = poll_key.fromMe
-                                    ? (self_lid || self_id)
-                                    : poll_key.remoteJid?.endsWith('@lid')
-                                        ? poll_key.remoteJid
-                                        : poll_key.participant ||
-                                            poll_key.remoteJidAlt ||
-                                            poll_key.remoteJid ||
-                                            '';
-                                const voter_jid = (0, baileys_1.jidNormalizedUser)(voter_raw);
-                                const poll_creator_jid = (0, baileys_1.jidNormalizedUser)(creator_raw);
-                                const decrypted = (0, baileys_1.decryptPollVote)({ encPayload: update.vote.encPayload, encIv: update.vote.encIv }, {
-                                    pollCreatorJid: poll_creator_jid,
-                                    pollMsgId: target_mid,
-                                    pollEncKey: message_secret,
-                                    voterJid: voter_jid,
-                                });
-                                (0, baileys_1.updateMessageWithPollUpdate)(poll_doc.raw, {
-                                    pollUpdateMessageKey: msg.key,
-                                    vote: decrypted,
-                                    senderTimestampMs: Number(msg.messageTimestamp) || Date.now(),
-                                });
-                                await this.engine.set(`/chat/${resolved_cid}/message/${target_mid}`, (0, store_1.serialize)(poll_doc));
-                                const msg_instance = await this.Message.build_instance(poll_doc);
-                                this._event.emit('message:updated', msg_instance, await msg_instance.chat(), this);
+                                const selves = [...new Set([self_lid, self_id].filter(Boolean))];
+                                const foreign_voter = msg.key.remoteJid?.endsWith('@lid')
+                                    ? msg.key.remoteJid
+                                    : msg.key.participant ||
+                                        msg.key.remoteJidAlt ||
+                                        msg.key.remoteJid ||
+                                        '';
+                                const foreign_creator = poll_key.remoteJid?.endsWith('@lid')
+                                    ? poll_key.remoteJid
+                                    : poll_key.participant ||
+                                        poll_key.remoteJidAlt ||
+                                        poll_key.remoteJid ||
+                                        '';
+                                const voters = msg.key.fromMe ? selves : [foreign_voter];
+                                const creators = poll_key.fromMe ? selves : [foreign_creator];
+                                let decrypted = null;
+                                for (const voter of voters) {
+                                    for (const creator of creators) {
+                                        try {
+                                            decrypted = (0, baileys_1.decryptPollVote)({ encPayload: update.vote.encPayload, encIv: update.vote.encIv }, {
+                                                pollCreatorJid: (0, baileys_1.jidNormalizedUser)(creator),
+                                                pollMsgId: target_mid,
+                                                pollEncKey: message_secret,
+                                                voterJid: (0, baileys_1.jidNormalizedUser)(voter),
+                                            });
+                                            break;
+                                        }
+                                        catch {
+                                            /* identidad equivocada: probar la siguiente */
+                                        }
+                                    }
+                                    if (decrypted) {
+                                        break;
+                                    }
+                                }
+                                if (decrypted) {
+                                    (0, baileys_1.updateMessageWithPollUpdate)(poll_doc.raw, {
+                                        pollUpdateMessageKey: msg.key,
+                                        vote: decrypted,
+                                        senderTimestampMs: Number(msg.messageTimestamp) || Date.now(),
+                                    });
+                                    await this.engine.set(`/chat/${resolved_cid}/message/${target_mid}`, (0, store_1.serialize)(poll_doc));
+                                    const msg_instance = await this.Message.build_instance(poll_doc);
+                                    this._event.emit('message:updated', msg_instance, await msg_instance.chat(), this);
+                                }
                             }
                             catch {
                                 /* decrypt may fail */
@@ -715,23 +722,15 @@ class WhatsApp {
                     const push_name = msg.pushName ?? null;
                     const is_group = cid.endsWith('@g.us');
                     if (doc.author && !(await this.engine.get(`/contact/${doc.author}`))) {
-                        const lid_key = msg.key.remoteJid?.endsWith('@lid') ? msg.key.remoteJid : null;
-                        const contact_raw = {
+                        await this._persist_contact({
                             id: doc.author,
-                            lid: lid_key,
+                            lid: msg.key.remoteJid?.endsWith('@lid') ? msg.key.remoteJid : null,
                             name: null,
-                            notify: is_group ? null : push_name,
+                            notify: push_name,
                             verified_name: msg.verifiedBizName ?? null,
                             img_url: null,
                             status: null,
-                        };
-                        await this.engine.set(`/contact/${doc.author}`, (0, store_1.serialize)(contact_raw));
-                        if (lid_key) {
-                            await this.engine.set(`/lid/${lid_key}`, (0, store_1.serialize)(doc.author));
-                        }
-                        const cached_chat = (0, store_1.deserialize)(await this.engine.get(`/chat/${doc.author}`));
-                        const author_chat = new this.Chat(cached_chat ?? { id: doc.author, name: push_name ?? doc.author.split('@')[0] });
-                        this._event.emit('contact:created', new this.Contact(contact_raw, author_chat), author_chat, this);
+                        });
                     }
                     if (!(await this.engine.get(`/chat/${cid}`))) {
                         const chat_raw = {