@arcaelas/whatsapp 6.2.0 → 7.0.0

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

@@ -1,32 +1,44 @@
 /**
  * @file message/index.ts
- * @description Entidad Message — clase base con getters puros y subclases por tipo
- * (Text, Image, Video, Audio, Sticker, Document, Location, Poll, VCard, Event);
- * `message(wa, raw)` evalúa el tipo y retorna la instancia correcta.
- * Message entity — pure-getter base class with per-type subclasses;
- * `message(wa, raw)` evaluates the type and returns the right instance.
+ * @description Entidad Message — clase base con getters puros y subclases por tipo;
+ * `message(init)` devuelve la clase ligada a la sesión con los envíos y lecturas.
+ * Message entity — pure-getter base class with per-type subclasses; `message(init)`
+ * returns the session-bound class with sends and reads.
  */
-import { type WAMessage } from 'baileys';
+import { proto, type WAMessage, type WASocket } from 'baileys';
 import { Readable } from 'node:stream';
-import { Chat } from '../../lib/chat/index.js';
-import { Contact } from '../../lib/contact/index.js';
-import type { WhatsApp } from '../../lib/whatsapp/index.js';
+import Chat from '../../lib/chat/index.js';
+import type Contact from '../../lib/contact/index.js';
+import { type Engine } from '../../lib/store/index.js';
+import type WhatsApp from '../../lib/whatsapp/index.js';
 /** Estados legibles indexados por el status numérico de baileys. / Readable states indexed by the baileys numeric status. */
 declare const STATUS: readonly ["error", "pending", "sent", "delivered", "read", "played"];
-type SendExtra = {
+/** Sesión activa que liga la entidad. / Active session binding the entity. */
+type Init = {
+    wa: WhatsApp;
+    engine: Engine;
+    socket: WASocket;
+};
+/** Opciones comunes de envío. / Common send options. */
+type Extra = {
     mid?: string;
     once?: boolean;
 };
 /**
- * Clase base del mensaje: recibe el cliente y el raw, deriva el estado con getters y
- * opera contra WhatsApp con sus métodos. Los estáticos reciben el cliente como primer
- * argumento (`Message.text(wa, cid, …)`).
- * Base message class: receives the client and the raw, derives state via getters and
- * operates against WhatsApp with its methods. Statics take the client as their first
- * argument (`Message.text(wa, cid, …)`).
+ * Mensaje: recibe la sesión y el documento, deriva el estado con getters y opera contra
+ * WhatsApp con sus métodos. Los de respuesta citan automáticamente este mensaje.
+ * Message: receives the session and the document, derives state via getters and operates
+ * against WhatsApp with its methods. Reply methods quote this message automatically.
  */
-export declare class Message {
-    readonly _wa: WhatsApp;
+export default class Message {
+    /** @internal Sesión dueña de la instancia. / Session owning the instance. */
+    readonly _init: Init;
+    /**
+     * @internal Documento persistido. `status`, `created_at` y `deleted_at` guardan los
+     * números del protocolo; los getters los presentan legibles.
+     * Persisted document. `status`, `created_at` and `deleted_at` keep the protocol numbers;
+     * getters expose them readable.
+     */
     readonly _raw: {
         id: string;
         cid: string;
@@ -52,149 +64,87 @@ export declare class Message {
         raw: WAMessage;
     };
     /**
-     * @internal Cliente dueño y documento persistido. `status`, `created_at` y
-     * `deleted_at` guardan los valores numéricos del protocolo; los getters los
-     * presentan legibles. `viewed` existe únicamente en los status broadcast (Feed).
-     * Owner client and persisted document. `status`, `created_at` and `deleted_at`
-     * keep the protocol numeric values; getters expose them readable. `viewed` only
-     * exists on status broadcasts (Feed).
+     * Recibe la sesión y el documento persistido, o el crudo de baileys: en ese caso el
+     * documento se deriva aquí y se despacha la subclase del tipo — `new Message(init, raw)`
+     * de una encuesta devuelve un `Poll`.
+     * Receives the session and the persisted document, or the baileys raw: in that case the
+     * document is derived here and the per-type subclass is dispatched — `new Message(init,
+     * raw)` of a poll returns a `Poll`.
      */
-    constructor(_wa: WhatsApp, _raw: {
-        id: string;
-        cid: string;
-        mid: string | null;
-        me: boolean;
-        type: 'text' | 'image' | 'video' | 'audio' | 'sticker' | 'document' | 'location' | 'poll' | 'vcard' | 'event';
-        author: string;
-        status: number;
-        starred: boolean;
-        forwarded: boolean;
-        created_at: number;
-        deleted_at: number | null;
-        mime: string;
-        caption: string;
-        edited: boolean;
-        multiple?: boolean;
-        reactions?: {
-            author: string;
-            emoji: string;
-            at: number;
-        }[];
-        viewed?: boolean | null;
-        raw: WAMessage;
-    });
+    constructor(init: Init, raw: Message['_raw'] | WAMessage);
     /** Identificador del mensaje. / Message identifier. */
     get id(): string;
-    /** Identificador del chat del mensaje. / Message chat identifier. */
+    /** Identificador del chat. / Chat identifier. */
     get cid(): string;
     /** Identificador del mensaje citado, o null. / Quoted message identifier, or null. */
     get mid(): string | null;
-    /** JID del autor, para acceso síncrono. / Author JID, for sync access. */
+    /** JID del autor. / Author JID. */
     get from(): string;
     /** true si soy el autor. / true when I am the author. */
     get me(): boolean;
     /** Tipo del mensaje. / Message type. */
     get type(): Message['_raw']['type'];
-    /** MIME: text/plain en texto, text/json en poll/location/vcard/event, real en media. / MIME: text/plain for text, text/json for poll/location/vcard/event, actual for media. */
-    get mime(): string;
     /** Texto del mensaje o caption del media. / Message text or media caption. */
     get caption(): string;
     /** Estado legible del mensaje. / Readable message state. */
     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. */
     get forwarded(): boolean;
     /** true si fue editado. / true when edited. */
     get edited(): boolean;
-    /** true si es de una sola lectura (view-once). / true when view-once. */
-    get once(): boolean;
     /** Fecha de creación en ISO UTC. / Creation date as ISO UTC. */
     get created_at(): string;
     /** Vencimiento del mensaje temporal en ISO UTC, o null. / Ephemeral expiration as ISO UTC, or null. */
     get expires_at(): string | null;
-    /**
-     * Contacto autor del mensaje, desde el engine (ficha mínima si no está persistido).
-     * Message author contact, from the engine (minimal card when not persisted).
-     *
-     * @returns Contacto / Contact
-     */
+    /** MIME: text/plain en texto, text/json en poll/location/vcard/event, real en media. / MIME: text/plain for text, text/json for poll/location/vcard/event, actual for media. */
+    get mime(): string;
+    /** Motivo del rechazo cuando `status` es `error` (`restricted`, `invalid-session`, o el código crudo); null si no. / 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 es de una sola lectura (view-once). / true when view-once. */
+    get once(): boolean;
+    /** Contacto autor, desde el engine (ficha mínima si no está persistido). / Author contact, from the engine (minimal card when not persisted). */
     author(): Promise<InstanceType<WhatsApp['Contact']>>;
-    /**
-     * Chat al que pertenece el mensaje.
-     * Chat the message belongs to.
-     *
-     * @returns Chat / Chat
-     */
+    /** Chat al que pertenece el mensaje. / Chat the message belongs to. */
     chat(): Promise<InstanceType<WhatsApp['Chat']>>;
-    /**
-     * Mensaje citado cuando hay `mid`, o null.
-     * Quoted message when `mid` exists, or null.
-     *
-     * @returns Mensaje citado o null / Quoted message or null
-     */
+    /** Mensaje citado cuando hay `mid`, o null. / Quoted message when `mid` exists, or null. */
     message(): Promise<Message | null>;
-    /**
-     * Contenido del mensaje: texto como su caption, media como binario, y
-     * poll/location/vcard/event como JSON.
-     * Message content: text as its caption, media as binary, and
-     * poll/location/vcard/event as JSON.
-     *
-     * @returns Buffer del contenido / Content buffer
-     */
+    /** Contenido persistido: texto, JSON del tipo, o binario del media. / Persisted content: text, per-type JSON, or media binary. */
     content(): Promise<Buffer>;
-    /**
-     * Stream del contenido; para media descarga de baileys si el cache falta.
-     * Content stream; media falls back to a baileys download when the cache is missing.
-     *
-     * @returns Readable del contenido / Content readable
-     */
+    /** Stream del contenido. / Content stream. */
     stream(): Promise<Readable>;
-    /**
-     * Reacciones del mensaje agrupadas por emoji con su conteo.
-     * Message reactions grouped by emoji with their count.
-     *
-     * @returns Conteo por emoji / Per-emoji count
-     */
+    /** Reacciones agrupadas por emoji con su conteo. / Reactions grouped by emoji with their count. */
     reactions(): Promise<{
         emoji: string;
         count: number;
     }[]>;
     /**
      * Reacciona al mensaje; el emoji vacío retira la reacción.
-     * Reacts to the message; an empty emoji removes the reaction.
+     * Reacts to the message; an empty emoji removes it.
      *
      * @param emoji - Emoji o '' / Emoji or ''
-     * @returns true si se envió / true when sent
      */
     react(emoji: string): Promise<boolean>;
     /**
-     * Destaca o quita el destacado del mensaje.
+     * Destaca o quita el destacado.
      * Stars or unstars the message.
      *
      * @param value - true destaca / true stars
-     * @returns true si se envió / true when sent
      */
     star(value: boolean): Promise<boolean>;
-    /**
-     * Marca el mensaje como leído.
-     * Marks the message as read.
-     *
-     * @returns true si se envió / true when sent
-     */
+    /** Marca el mensaje como leído. / Marks the message as read. */
     seen(): Promise<boolean>;
     /**
      * Edita el caption del mensaje propio (texto, imagen o video).
      * Edits the own message caption (text, image or video).
      *
      * @param caption - Texto nuevo / New text
-     * @returns true si se editó / true when edited
+     * @returns false si el mensaje no es propio o su tipo no se puede editar / false when not own or its type cannot be edited
      */
     edit(caption: string): Promise<boolean>;
     /**
@@ -202,7 +152,7 @@ export declare class Message {
      * Forwards the message to another chat.
      *
      * @param target - CID, Chat o Contact destino / Target CID, Chat or Contact
-     * @returns true si se reenvió / true when forwarded
+     * @returns false si el destino es irresoluble o el contenido no admite reenvío / false when the target cannot be resolved or the content cannot be forwarded
      */
     forward(target: string | Chat | Contact): Promise<boolean>;
     /**
@@ -210,39 +160,38 @@ export declare class Message {
      * Deletes the message: this device only by default, for everyone with `true`.
      *
      * @param all - true elimina para todos / true deletes for everyone
-     * @returns true si se eliminó / true when deleted
      */
     delete(all?: boolean): Promise<boolean>;
     /** Responde con texto. / Replies with text. */
-    text(caption: string, extra?: Omit<SendExtra, 'mid'>): Promise<Message | null>;
+    text(caption: string, extra?: Omit<Extra, 'mid'>): Promise<Message | null>;
     /** Responde con imagen. / Replies with an image. */
-    image(buf: Buffer, extra?: Omit<SendExtra, 'mid'> & {
+    image(buf: Buffer, extra?: Omit<Extra, 'mid'> & {
         caption?: string;
     }): Promise<Message | null>;
     /** Responde con video. / Replies with a video. */
-    video(buf: Buffer, extra?: Omit<SendExtra, 'mid'> & {
+    video(buf: Buffer, extra?: Omit<Extra, 'mid'> & {
         caption?: string;
     }): Promise<Message | null>;
     /** Responde con audio. / Replies with audio. */
-    audio(buf: Buffer, extra?: Omit<SendExtra, 'mid'> & {
+    audio(buf: Buffer, extra?: Omit<Extra, 'mid'> & {
         ptt?: boolean;
     }): Promise<Message | null>;
     /** Responde con ubicación. / Replies with a location. */
     location(loc: {
         lat: number;
         lng: number;
-    }, extra?: Omit<SendExtra, 'mid'>): Promise<Message | null>;
+    }, extra?: Omit<Extra, 'mid'>): Promise<Message | null>;
     /** Responde con encuesta. / Replies with a poll. */
     poll(input: {
         content: string;
         options: {
             content: string;
         }[];
-    }, extra?: Omit<SendExtra, 'mid'> & {
+    }, extra?: Omit<Extra, 'mid'> & {
         multiple?: boolean;
     }): Promise<Message | null>;
     /** Responde con documento. / Replies with a document. */
-    document(buf: Buffer, extra: Omit<SendExtra, 'mid'> & {
+    document(buf: Buffer, extra: Omit<Extra, 'mid'> & {
         file_name: string;
         mimetype?: string;
         caption?: string;
@@ -251,7 +200,7 @@ export declare class Message {
     vcard(contacts: {
         name: string;
         phone: string;
-    }[], extra?: Omit<SendExtra, 'mid'>): Promise<Message | null>;
+    }[], extra?: Omit<Extra, 'mid'>): Promise<Message | null>;
     /** Responde con evento. / Replies with an event. */
     event(data: {
         name: string;
@@ -262,107 +211,14 @@ export declare class Message {
             lat: number;
             lng: number;
         };
-    }, extra?: Omit<SendExtra, 'mid'>): Promise<Message | null>;
-    /**
-     * Obtiene un mensaje por chat y id.
-     * Retrieves a message by chat and id.
-     *
-     * @param wa - Cliente dueño / Owner client
-     * @param cid - Identificador del chat / Chat identifier
-     * @param mid - Identificador del mensaje / Message identifier
-     * @returns Mensaje o null / Message or null
-     */
-    static get(wa: WhatsApp, cid: string, mid: string): Promise<Message | null>;
-    /**
-     * Pagina los mensajes de un chat desde el más reciente.
-     * Paginates chat messages from the most recent one.
-     *
-     * @param wa - Cliente dueño / Owner client
-     * @param cid - Identificador del chat / Chat identifier
-     * @param offset - Desplazamiento / Offset
-     * @param limit - Tamaño de página / Page size
-     * @returns Página de mensajes / Message page
-     */
-    static list(wa: WhatsApp, cid: string, offset?: number, limit?: number): Promise<Message[]>;
-    /** Envía texto. / Sends text. */
-    static text(wa: WhatsApp, cid: string, caption: string, extra?: SendExtra): Promise<Message | null>;
-    /** Envía imagen. / Sends an image. */
-    static image(wa: WhatsApp, cid: string, buf: Buffer, extra?: SendExtra & {
-        caption?: string;
-    }): Promise<Message | null>;
-    /** Envía video. / Sends a video. */
-    static video(wa: WhatsApp, cid: string, buf: Buffer, extra?: SendExtra & {
-        caption?: string;
-    }): Promise<Message | null>;
-    /** Envía audio. / Sends audio. */
-    static audio(wa: WhatsApp, cid: string, buf: Buffer, extra?: SendExtra & {
-        ptt?: boolean;
-    }): Promise<Message | null>;
-    /** Envía ubicación. / Sends a location. */
-    static location(wa: WhatsApp, cid: string, loc: {
-        lat: number;
-        lng: number;
-    }, extra?: SendExtra): Promise<Message | null>;
-    /** Envía encuesta. / Sends a poll. */
-    static poll(wa: WhatsApp, cid: string, input: {
-        content: string;
-        options: {
-            content: string;
-        }[];
-    }, extra?: SendExtra & {
-        multiple?: boolean;
-    }): Promise<Message | null>;
-    /** Envía documento. / Sends a document. */
-    static document(wa: WhatsApp, cid: string, buf: Buffer, extra: SendExtra & {
-        file_name: string;
-        mimetype?: string;
-        caption?: string;
-    }): Promise<Message | null>;
-    /** Envía tarjeta(s) de contacto. / Sends contact card(s). */
-    static vcard(wa: WhatsApp, cid: string, contacts: {
-        name: string;
-        phone: string;
-    }[], extra?: SendExtra): Promise<Message | null>;
-    /** Envía evento. / Sends an event. */
-    static event(wa: WhatsApp, cid: string, data: {
-        name: string;
-        caption?: string;
-        start: Date;
-        end?: Date;
-        place?: {
-            lat: number;
-            lng: number;
-        };
-    }, extra?: SendExtra): Promise<Message | null>;
-    /** Reacciona a un mensaje por id. / Reacts to a message by id. */
-    static react(wa: WhatsApp, cid: string, mid: string, emoji: string): Promise<boolean>;
-    /** Destaca un mensaje por id. / Stars a message by id. */
-    static star(wa: WhatsApp, cid: string, mid: string, value: boolean): Promise<boolean>;
-    /** Marca un mensaje como leído por id. / Marks a message as read by id. */
-    static seen(wa: WhatsApp, cid: string, mid: string): Promise<boolean>;
-    /** Edita un mensaje por id. / Edits a message by id. */
-    static edit(wa: WhatsApp, cid: string, mid: string, caption: string): Promise<boolean>;
-    /** Reenvía un mensaje por id. / Forwards a message by id. */
-    static forward(wa: WhatsApp, cid: string, mid: string, target: string | Chat | Contact): Promise<boolean>;
-    /** Elimina un mensaje por id. / Deletes a message by id. */
-    static delete(wa: WhatsApp, cid: string, mid: string, all?: boolean): Promise<boolean>;
-    /** Reacciones de un mensaje por id. / Reactions of a message by id. */
-    static reactions(wa: WhatsApp, cid: string, mid: string): Promise<{
-        emoji: string;
-        count: number;
-    }[]>;
+    }, extra?: Omit<Extra, 'mid'>): Promise<Message | null>;
 }
 /**
  * Mensaje de texto; `preview()` expone la tarjeta del enlace embebido.
  * Text message; `preview()` exposes the embedded link card.
  */
 export declare class Text extends Message {
-    /**
-     * Preview del enlace del texto, o null cuando no trae metadata.
-     * Text link preview, or null when it carries no metadata.
-     *
-     * @returns { link, name, content, thumb } o null / { link, name, content, thumb } or null
-     */
+    /** Preview del enlace, o null cuando el texto no trae metadata. / Link preview, or null when the text carries no metadata. */
     preview(): Promise<{
         link: string;
         name: string | null;
@@ -371,107 +227,69 @@ export declare class Text extends Message {
     } | null>;
 }
 /**
- * Mensaje de imagen: dimensiones, peso y miniatura.
- * Image message: dimensions, size and thumbnail.
+ * Base de los mensajes con binario: dimensiones, peso, miniatura y descarga.
+ * Base for binary messages: dimensions, size, thumbnail and download.
  */
-export declare class Image extends Message {
-    /** @internal */
-    private get _media();
+declare class Media extends Message {
+    /** @internal Bloque de media del raw, común a los cinco tipos. / Raw media block, shared by the five types. */
+    get _media(): {
+        width?: number | null;
+        height?: number | null;
+        seconds?: number | null;
+        ptt?: boolean | null;
+        isAnimated?: boolean | null;
+        fileName?: string | null;
+        pageCount?: number | null;
+        fileLength?: number | {
+            toString(): string;
+        } | null;
+        waveform?: Uint8Array | string | null;
+        jpegThumbnail?: Uint8Array | string | null;
+    } | null;
     /** Ancho en píxeles. / Width in pixels. */
     get width(): number;
     /** Alto en píxeles. / Height in pixels. */
     get height(): number;
     /** Peso en bytes. / Size in bytes. */
     get size(): number;
-    /**
-     * Miniatura JPEG embebida, o null.
-     * Embedded JPEG thumbnail, or null.
-     *
-     * @returns Buffer de la miniatura o null / Thumbnail buffer or null
-     */
+    /** Miniatura JPEG embebida, o null. / Embedded JPEG thumbnail, or null. */
     thumb(): Promise<Buffer | null>;
+    /** Binario del media: el persistido, o la descarga de baileys. / Media binary: the persisted one, or the baileys download. */
     content(): Promise<Buffer>;
+    /** Stream del media sin acumularlo cuando hay que descargar. / Media stream without buffering when a download is needed. */
+    stream(): Promise<Readable>;
 }
-/**
- * Mensaje de video: dimensiones, duración, peso y miniatura.
- * Video message: dimensions, duration, size and thumbnail.
- */
-export declare class Video extends Message {
-    /** @internal */
-    private get _media();
-    /** Ancho en píxeles. / Width in pixels. */
-    get width(): number;
-    /** Alto en píxeles. / Height in pixels. */
-    get height(): number;
+/** Mensaje de imagen. / Image message. */
+export declare class Image extends Media {
+}
+/** Mensaje de video. / Video message. */
+export declare class Video extends Media {
     /** Duración en segundos. / Duration in seconds. */
     get duration(): number;
-    /** Peso en bytes. / Size in bytes. */
-    get size(): number;
-    /**
-     * Miniatura JPEG embebida, o null.
-     * Embedded JPEG thumbnail, or null.
-     *
-     * @returns Buffer de la miniatura o null / Thumbnail buffer or null
-     */
-    thumb(): Promise<Buffer | null>;
-    content(): Promise<Buffer>;
 }
-/**
- * Mensaje de audio: nota de voz o archivo, con forma de onda del protocolo.
- * Audio message: voice note or file, with the protocol waveform.
- */
-export declare class Audio extends Message {
-    /** @internal */
-    private get _media();
+/** Mensaje de audio: nota de voz o archivo. / Audio message: voice note or file. */
+export declare class Audio extends Media {
     /** true si es nota de voz. / true when push-to-talk. */
     get ptt(): boolean;
     /** Duración en segundos. / Duration in seconds. */
     get duration(): number;
-    /** Peso en bytes. / Size in bytes. */
-    get size(): number;
     /** Forma de onda 0-100 lista para pintar. / Paint-ready 0-100 waveform. */
     get waveform(): number[];
-    content(): Promise<Buffer>;
 }
-/**
- * Mensaje de sticker: dimensiones, peso y animación.
- * Sticker message: dimensions, size and animation.
- */
-export declare class Sticker extends Message {
-    /** @internal */
-    private get _media();
-    /** Ancho en píxeles. / Width in pixels. */
-    get width(): number;
-    /** Alto en píxeles. / Height in pixels. */
-    get height(): number;
+/** Mensaje de sticker. / Sticker message. */
+export declare class Sticker extends Media {
     /** true si el sticker es animado. / true when animated. */
     get animated(): boolean;
-    /** Peso en bytes. / Size in bytes. */
-    get size(): number;
-    content(): Promise<Buffer>;
 }
-/**
- * Mensaje de documento; el MIME real vive en `mime` de la base.
- * Document message; the actual MIME lives in the base `mime`.
- */
-export declare class Document extends Message {
-    /** @internal */
-    private get _media();
+/** Mensaje de documento; el MIME real vive en `mime`. / Document message; the actual MIME lives in `mime`. */
+export declare class Document extends Media {
     /** Nombre del archivo. / File name. */
     get name(): string;
     /** Número de páginas (PDF); 0 cuando no aplica. / Page count (PDF); 0 when not applicable. */
     get pages(): number;
-    /** Peso en bytes. / Size in bytes. */
-    get size(): number;
-    content(): Promise<Buffer>;
 }
-/**
- * Mensaje de ubicación, fija o en vivo.
- * Location message, static or live.
- */
+/** Mensaje de ubicación, fija o en vivo. / Location message, static or live. */
 export declare class Location extends Message {
-    /** @internal */
-    private get _loc();
     /** Latitud en grados. / Latitude in degrees. */
     get lat(): number;
     /** Longitud en grados. / Longitude in degrees. */
@@ -486,10 +304,18 @@ export declare class Location extends Message {
  * Poll message: options with counts, per-contact votes and self-voting.
  */
 export declare class Poll extends Message {
-    /** @internal */
-    private get _poll();
+    /** @internal Bloque de la encuesta en el raw. / Raw poll block. */
+    get _poll(): proto.Message.IPollCreationMessage | null | undefined;
     /** @internal Updates de voto con los bytes normalizados post-engine. / Vote updates with post-engine normalized bytes. */
-    private get _updates();
+    get _updates(): {
+        vote: {
+            selectedOptions: (Uint8Array<ArrayBufferLike> | Buffer<ArrayBuffer>)[];
+        } | null | undefined;
+        pollUpdateMessageKey?: (proto.IMessageKey | null);
+        senderTimestampMs?: (number | Long | null);
+        serverTimestampMs?: (number | Long | null);
+        unread?: (boolean | null);
+    }[];
     /** true si admite varias respuestas. / true when multi-select. */
     get multiple(): boolean;
     /** Opciones con su conteo de votos. / Options with their vote counts. */
@@ -497,35 +323,25 @@ export declare class Poll extends Message {
         name: string;
         count: number;
     }[];
-    /**
-     * Votos individuales: opción elegida y teléfono del votante.
-     * Individual votes: chosen option and voter phone.
-     *
-     * @returns Lista de votos / Vote list
-     */
+    /** Votos individuales: opción elegida y teléfono del votante. / Individual votes: chosen option and voter phone. */
     votes(): Promise<{
         name: string;
         contact: string;
     }[]>;
     /**
-     * Vota en la encuesta con uno o varios índices. Cifra el voto (HMAC+AES-GCM) y lo
-     * enruta al chat @lid con la identidad LID propia. Best-effort: el voto entrante
-     * descifra correcto, pero WhatsApp no propaga el voto emitido desde un dispositivo
-     * vinculado (companion).
-     * Votes in the poll with one or more indexes. Encrypts the vote (HMAC+AES-GCM) and
-     * routes it to the @lid chat with the own LID identity. Best-effort: incoming votes
-     * decrypt fine, but WhatsApp does not propagate votes emitted from a linked
-     * (companion) device.
+     * Vota con uno o varios índices: cifra el voto (HMAC+AES-GCM) y lo enruta al chat @lid
+     * con la identidad LID propia. Best-effort: WhatsApp no propaga el voto emitido desde un
+     * dispositivo vinculado.
+     * Votes with one or more indexes: encrypts the vote (HMAC+AES-GCM) and routes it to the
+     * @lid chat with the own LID identity. Best-effort: WhatsApp does not propagate votes
+     * emitted from a linked device.
      *
      * @param index - Índice o índices de la opción / Option index or indexes
      * @returns true si el voto se emitió / true when the vote was relayed
      */
     select(index: number | number[]): Promise<boolean>;
 }
-/**
- * Mensaje de tarjeta(s) de contacto.
- * Contact card(s) message.
- */
+/** Mensaje de tarjeta(s) de contacto. / Contact card(s) message. */
 export declare class VCard extends Message {
     /** Contactos de la tarjeta. / Card contacts. */
     get contacts(): {
@@ -533,13 +349,10 @@ export declare class VCard extends Message {
         phone: string;
     }[];
 }
-/**
- * Mensaje de evento de calendario.
- * Calendar event message.
- */
+/** Mensaje de evento de calendario. / Calendar event message. */
 export declare class Event extends Message {
-    /** @internal */
-    private get _event();
+    /** @internal Bloque del evento en el raw. / Raw event block. */
+    get _event(): proto.Message.IEventMessage | null | undefined;
     /** Nombre del evento. / Event name. */
     get name(): string;
     /** Inicio en ISO UTC. / Start as ISO UTC. */
@@ -557,16 +370,282 @@ export declare class Event extends Message {
     } | null;
 }
 /**
- * Factoría de Message: evalúa el tipo y retorna la instancia de la subclase correcta.
- * Acepta el documento persistido o el mensaje crudo de baileys — en ese caso el
- * documento se deriva aquí mismo (id, tipo, autor, caption, mime, fechas).
- * Message factory: evaluates the type and returns the right subclass instance. Accepts
- * the persisted document or the raw baileys message — in that case the document is
- * derived right here (id, type, author, caption, mime, dates).
+ * Mensaje ligado a la sesión viva: la misma clase con los envíos, las lecturas, las acciones
+ * por id y las subclases para `instanceof`.
+ * Message bound to the live session: the same class with sends, reads, by-id actions and the
+ * subclasses for `instanceof`.
  *
- * @param wa - Instancia principal / Main WhatsApp instance
- * @param raw - Documento persistido o WAMessage crudo / Persisted document or raw WAMessage
- * @returns Instancia del tipo correcto / Right-type instance
+ * @param init - Sesión activa: cliente, motor y socket / Active session: client, engine and socket
+ * @returns Clase `Message` con acceso a la sesión / `Message` class with session access
  */
-export declare function message(wa: WhatsApp, raw: Message['_raw'] | WAMessage): Message;
+export declare function message(init: Init): {
+    new (init: Init, raw: Message["_raw"] | WAMessage): {
+        /** @internal Sesión dueña de la instancia. / Session owning the instance. */
+        readonly _init: Init;
+        /**
+         * @internal Documento persistido. `status`, `created_at` y `deleted_at` guardan los
+         * números del protocolo; los getters los presentan legibles.
+         * Persisted document. `status`, `created_at` and `deleted_at` keep the protocol numbers;
+         * getters expose them readable.
+         */
+        readonly _raw: {
+            id: string;
+            cid: string;
+            mid: string | null;
+            me: boolean;
+            type: "text" | "image" | "video" | "audio" | "sticker" | "document" | "location" | "poll" | "vcard" | "event";
+            author: string;
+            status: number;
+            starred: boolean;
+            forwarded: boolean;
+            created_at: number;
+            deleted_at: number | null;
+            mime: string;
+            caption: string;
+            edited: boolean;
+            multiple?: boolean;
+            reactions?: {
+                author: string;
+                emoji: string;
+                at: number;
+            }[];
+            viewed?: boolean | null;
+            raw: WAMessage;
+        };
+        /** Identificador del mensaje. / Message identifier. */
+        get id(): string;
+        /** Identificador del chat. / Chat identifier. */
+        get cid(): string;
+        /** Identificador del mensaje citado, o null. / Quoted message identifier, or null. */
+        get mid(): string | null;
+        /** JID del autor. / Author JID. */
+        get from(): string;
+        /** true si soy el autor. / true when I am the author. */
+        get me(): boolean;
+        /** Tipo del mensaje. / Message type. */
+        get type(): Message["_raw"]["type"];
+        /** Texto del mensaje o caption del media. / Message text or media caption. */
+        get caption(): string;
+        /** Estado legible del mensaje. / Readable message state. */
+        get status(): (typeof STATUS)[number];
+        /** true si el mensaje fue visto. / true when the message was seen. */
+        get read(): boolean;
+        /** true si está destacado. / true when starred. */
+        get starred(): boolean;
+        /** true si fue reenviado. / true when forwarded. */
+        get forwarded(): boolean;
+        /** true si fue editado. / true when edited. */
+        get edited(): boolean;
+        /** Fecha de creación en ISO UTC. / Creation date as ISO UTC. */
+        get created_at(): string;
+        /** Vencimiento del mensaje temporal en ISO UTC, o null. / Ephemeral expiration as ISO UTC, or null. */
+        get expires_at(): string | null;
+        /** MIME: text/plain en texto, text/json en poll/location/vcard/event, real en media. / MIME: text/plain for text, text/json for poll/location/vcard/event, actual for media. */
+        get mime(): string;
+        /** Motivo del rechazo cuando `status` es `error` (`restricted`, `invalid-session`, o el código crudo); null si no. / 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 es de una sola lectura (view-once). / true when view-once. */
+        get once(): boolean;
+        /** Contacto autor, desde el engine (ficha mínima si no está persistido). / Author contact, from the engine (minimal card when not persisted). */
+        author(): Promise<InstanceType<WhatsApp["Contact"]>>;
+        /** Chat al que pertenece el mensaje. / Chat the message belongs to. */
+        chat(): Promise<InstanceType<WhatsApp["Chat"]>>;
+        /** Mensaje citado cuando hay `mid`, o null. / Quoted message when `mid` exists, or null. */
+        message(): Promise<Message | null>;
+        /** Contenido persistido: texto, JSON del tipo, o binario del media. / Persisted content: text, per-type JSON, or media binary. */
+        content(): Promise<Buffer>;
+        /** Stream del contenido. / Content stream. */
+        stream(): Promise<Readable>;
+        /** Reacciones agrupadas por emoji con su conteo. / Reactions grouped by emoji with their count. */
+        reactions(): Promise<{
+            emoji: string;
+            count: number;
+        }[]>;
+        /**
+         * Reacciona al mensaje; el emoji vacío retira la reacción.
+         * Reacts to the message; an empty emoji removes it.
+         *
+         * @param emoji - Emoji o '' / Emoji or ''
+         */
+        react(emoji: string): Promise<boolean>;
+        /**
+         * Destaca o quita el destacado.
+         * Stars or unstars the message.
+         *
+         * @param value - true destaca / true stars
+         */
+        star(value: boolean): Promise<boolean>;
+        /** Marca el mensaje como leído. / Marks the message as read. */
+        seen(): Promise<boolean>;
+        /**
+         * Edita el caption del mensaje propio (texto, imagen o video).
+         * Edits the own message caption (text, image or video).
+         *
+         * @param caption - Texto nuevo / New text
+         * @returns false si el mensaje no es propio o su tipo no se puede editar / false when not own or its type cannot be edited
+         */
+        edit(caption: string): Promise<boolean>;
+        /**
+         * Reenvía el mensaje a otro chat.
+         * Forwards the message to another chat.
+         *
+         * @param target - CID, Chat o Contact destino / Target CID, Chat or Contact
+         * @returns false si el destino es irresoluble o el contenido no admite reenvío / false when the target cannot be resolved or the content cannot be forwarded
+         */
+        forward(target: string | Chat | Contact): Promise<boolean>;
+        /**
+         * Elimina el mensaje: solo en mi dispositivo por defecto, para todos con `true`.
+         * Deletes the message: this device only by default, for everyone with `true`.
+         *
+         * @param all - true elimina para todos / true deletes for everyone
+         */
+        delete(all?: boolean): Promise<boolean>;
+        /** Responde con texto. / Replies with text. */
+        text(caption: string, extra?: Omit<Extra, "mid">): Promise<Message | null>;
+        /** Responde con imagen. / Replies with an image. */
+        image(buf: Buffer, extra?: Omit<Extra, "mid"> & {
+            caption?: string;
+        }): Promise<Message | null>;
+        /** Responde con video. / Replies with a video. */
+        video(buf: Buffer, extra?: Omit<Extra, "mid"> & {
+            caption?: string;
+        }): Promise<Message | null>;
+        /** Responde con audio. / Replies with audio. */
+        audio(buf: Buffer, extra?: Omit<Extra, "mid"> & {
+            ptt?: boolean;
+        }): Promise<Message | null>;
+        /** Responde con ubicación. / Replies with a location. */
+        location(loc: {
+            lat: number;
+            lng: number;
+        }, extra?: Omit<Extra, "mid">): Promise<Message | null>;
+        /** Responde con encuesta. / Replies with a poll. */
+        poll(input: {
+            content: string;
+            options: {
+                content: string;
+            }[];
+        }, extra?: Omit<Extra, "mid"> & {
+            multiple?: boolean;
+        }): Promise<Message | null>;
+        /** Responde con documento. / Replies with a document. */
+        document(buf: Buffer, extra: Omit<Extra, "mid"> & {
+            file_name: string;
+            mimetype?: string;
+            caption?: string;
+        }): Promise<Message | null>;
+        /** Responde con tarjeta(s) de contacto. / Replies with contact card(s). */
+        vcard(contacts: {
+            name: string;
+            phone: string;
+        }[], extra?: Omit<Extra, "mid">): Promise<Message | null>;
+        /** Responde con evento. / Replies with an event. */
+        event(data: {
+            name: string;
+            caption?: string;
+            start: Date;
+            end?: Date;
+            place?: {
+                lat: number;
+                lng: number;
+            };
+        }, extra?: Omit<Extra, "mid">): Promise<Message | null>;
+    };
+    readonly Text: typeof Text;
+    readonly Image: typeof Image;
+    readonly Video: typeof Video;
+    readonly Audio: typeof Audio;
+    readonly Sticker: typeof Sticker;
+    readonly Document: typeof Document;
+    readonly Location: typeof Location;
+    readonly Poll: typeof Poll;
+    readonly VCard: typeof VCard;
+    readonly Event: typeof Event;
+    /**
+     * Mensaje por chat e id.
+     * Message by chat and id.
+     *
+     * @param cid - Teléfono, JID o LID del chat / Chat phone, JID or LID
+     * @param mid - Identificador del mensaje / Message identifier
+     */
+    get(cid: string, mid: string): Promise<Message | null>;
+    /**
+     * Pagina los mensajes del chat, del más reciente al más antiguo.
+     * Paginates chat messages, from the most recent to the oldest.
+     *
+     * @param cid - Teléfono, JID o LID del chat / Chat phone, JID or LID
+     * @param offset - Desplazamiento / Offset
+     * @param limit - Tamaño de página / Page size
+     */
+    list(cid: string, offset?: number, limit?: number): Promise<Message[]>;
+    /** Envía texto. / Sends text. */
+    text(cid: string, caption: string, extra?: Extra): Promise<Message | null>;
+    /** Envía imagen. / Sends an image. */
+    image(cid: string, buf: Buffer, extra?: Extra & {
+        caption?: string;
+    }): Promise<Message | null>;
+    /** Envía video. / Sends a video. */
+    video(cid: string, buf: Buffer, extra?: Extra & {
+        caption?: string;
+    }): Promise<Message | null>;
+    /** Envía audio. / Sends audio. */
+    audio(cid: string, buf: Buffer, extra?: Extra & {
+        ptt?: boolean;
+    }): Promise<Message | null>;
+    /** Envía ubicación. / Sends a location. */
+    location(cid: string, loc: {
+        lat: number;
+        lng: number;
+    }, extra?: Extra): Promise<Message | null>;
+    /** Envía encuesta. / Sends a poll. */
+    poll(cid: string, input: {
+        content: string;
+        options: {
+            content: string;
+        }[];
+    }, extra?: Extra & {
+        multiple?: boolean;
+    }): Promise<Message | null>;
+    /** Envía documento. / Sends a document. */
+    document(cid: string, buf: Buffer, extra: Extra & {
+        file_name: string;
+        mimetype?: string;
+        caption?: string;
+    }): Promise<Message | null>;
+    /** Envía tarjeta(s) de contacto. / Sends contact card(s). */
+    vcard(cid: string, contacts: {
+        name: string;
+        phone: string;
+    }[], extra?: Extra): Promise<Message | null>;
+    /** Envía evento. / Sends an event. */
+    event(cid: string, data: {
+        name: string;
+        caption?: string;
+        start: Date;
+        end?: Date;
+        place?: {
+            lat: number;
+            lng: number;
+        };
+    }, extra?: Extra): Promise<Message | null>;
+    /** Reacciona a un mensaje por id. / Reacts to a message by id. */
+    react(cid: string, mid: string, emoji: string): Promise<boolean>;
+    /** Destaca un mensaje por id. / Stars a message by id. */
+    star(cid: string, mid: string, value: boolean): Promise<boolean>;
+    /** Marca un mensaje como leído por id. / Marks a message as read by id. */
+    seen(cid: string, mid: string): Promise<boolean>;
+    /** Edita un mensaje por id. / Edits a message by id. */
+    edit(cid: string, mid: string, caption: string): Promise<boolean>;
+    /** Reenvía un mensaje por id. / Forwards a message by id. */
+    forward(cid: string, mid: string, target: string | Chat | Contact): Promise<boolean>;
+    /** Elimina un mensaje por id. / Deletes a message by id. */
+    delete(cid: string, mid: string, all?: boolean): Promise<boolean>;
+    /** Reacciones de un mensaje por id. / Reactions of a message by id. */
+    reactions(cid: string, mid: string): Promise<{
+        emoji: string;
+        count: number;
+    }[]>;
+};
 export {};