@arcaelas/whatsapp 4.4.0 → 5.1.0

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

@@ -1,333 +1,544 @@
 /**
  * @file message/index.ts
- * @description Entidad Message — una sola clase base que recibe `{wa, doc}` en el constructor.
- * Subclases especializadas (Text, Image, Video, Audio, Gps, Poll) override `content()` según su tipo.
+ * @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.
  */
 import { type WAMessage } from 'baileys';
 import { Readable } from 'node:stream';
-import { Chat, chat } from '../../lib/chat';
-import { Contact, contact } from '../../lib/contact';
+import { Chat } from '../../lib/chat';
+import { Contact } from '../../lib/contact';
 import type { WhatsApp } from '../../lib/whatsapp';
-/** Destino aceptado por `forward`: CID (string), Chat o Contact. */
-export type ForwardTarget = string | Chat | Contact;
-type ChatInstance = InstanceType<ReturnType<typeof chat>>;
-type ContactInstance = InstanceType<ReturnType<typeof contact>>;
-/** Tipos de mensaje internos (no expuestos como getter público). */
-export type MessageType = 'text' | 'image' | 'video' | 'audio' | 'location' | 'poll' | 'document' | 'vcard' | 'event';
-export declare enum MessageStatus {
-    ERROR = 0,
-    PENDING = 1,
-    SERVER_ACK = 2,
-    DELIVERED = 3,
-    READ = 4,
-    PLAYED = 5
-}
-export interface SendOptions {
+/** 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 = {
     mid?: string;
-}
-export interface SendMediaOptions extends SendOptions {
-    caption?: string;
-}
-export interface SendAudioOptions extends SendOptions {
-    ptt?: boolean;
-}
-export interface SendPollOptions extends SendOptions {
-    /** true para selección múltiple; default false (single). / true for multi-select; default false (single). */
-    multiple?: boolean;
-}
-export interface SendDocumentOptions extends SendOptions {
-    /** Nombre del archivo mostrado al receptor. / File name shown to the recipient. */
-    file_name: string;
-    /** MIME real del contenido; default `application/octet-stream`. / Real content MIME; defaults to `application/octet-stream`. */
-    mimetype?: string;
-    /** Texto adjunto opcional. / Optional attached caption. */
-    caption?: string;
-}
-export interface VCardInput {
-    /** Nombre mostrado del contacto. / Contact display name. */
-    name: string;
-    /** Teléfono en formato internacional. / Phone in international format. */
-    phone: string;
-}
-export interface EventInput {
-    /** Nombre del evento. / Event name. */
-    name: string;
-    /** Descripción opcional (texto del evento, expuesto como `caption`). / Optional description (event text, exposed as `caption`). */
-    caption?: string;
-    /** Fecha/hora de inicio. / Start date/time. */
-    start: Date;
-    /** Fecha/hora de fin opcional. / Optional end date/time. */
-    end?: Date;
-    /** Ubicación opcional. / Optional location. */
-    place?: {
-        lat: number;
-        lng: number;
-    };
-}
-export interface LocationOptions {
-    lat: number;
-    lng: number;
-    live?: boolean;
-}
-export interface PollOptions {
-    content: string;
-    options: Array<{
-        content: string;
-    }>;
-}
+    once?: boolean;
+};
 /**
- * Documento persistido del mensaje.
+ * 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, …)`).
  */
-export interface IMessage {
-    id: string;
-    cid: string;
-    mid: string | null;
-    me: boolean;
-    type: MessageType;
-    author: string;
-    status: MessageStatus;
-    starred: boolean;
-    forwarded: boolean;
-    created_at: number;
-    deleted_at: number | null;
-    mime: string;
-    caption: string;
-    edited: boolean;
+export declare class Message {
+    readonly _wa: WhatsApp;
+    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;
+    };
     /**
-     * Solo para polls: discriminador explícito de selección múltiple seteado al enviar.
-     * Cuando está definido, `Poll.multiple` lo prefiere sobre el conteo del proto
-     * (WhatsApp normaliza `selectableOptionsCount` en el echo de polls auto-emitidos
-     * y pierde el discriminador, por eso necesitamos persistirlo nosotros).
-     * Poll-only: explicit multi-select flag set at send time. When defined, `Poll.multiple`
-     * prefers it over the proto count (WhatsApp normalizes `selectableOptionsCount` on
-     * own-poll echo, losing the discriminator).
+     * @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).
      */
-    multiple?: boolean;
-    raw: WAMessage;
-}
-/**
- * Construye el documento IMessage desde el raw de baileys.
- */
-export declare function build_message_doc(raw: WAMessage, self_id?: string, edited?: boolean): IMessage;
-/**
- * Clase base del mensaje. Una sola clase — toda la API de instancia vive aquí.
- * Base message class. Single class — all instance API lives here.
- */
-export declare class Message {
-    /** @internal */
-    protected readonly _wa: WhatsApp;
-    /** @internal */
-    protected readonly _doc: IMessage;
-    /** @internal Cache de la promesa de `author()` para evitar engine round-trips repetidos. */
-    private _author_cache;
-    /** @internal Cache de la promesa de `chat()` para evitar engine round-trips repetidos. */
-    private _chat_cache;
-    constructor(options: {
-        wa: WhatsApp;
-        doc: IMessage;
+    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;
     });
+    /** Identificador del mensaje. / Message identifier. */
     get id(): string;
+    /** Identificador del chat del mensaje. / Message chat identifier. */
     get cid(): string;
-    get type(): MessageType;
-    /** JID del autor del mensaje. Para acceso síncrono sin hidratar el Contact. */
-    get from(): string;
-    /** MIME type del contenido. `text/plain` para texto, `application/json` para location/poll, mimetype real para media. */
-    get mime(): 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. */
+    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;
+    /** true si está destacado. / true when starred. */
     get starred(): boolean;
+    /** true si fue reenviado. / true when forwarded. */
     get forwarded(): boolean;
-    get once(): boolean;
-    get created_at(): number;
-    get deleted_at(): number | null;
-    get status(): MessageStatus;
+    /** 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
+     */
+    author(): Promise<InstanceType<WhatsApp['Contact']>>;
+    /**
+     * Chat al que pertenece el mensaje.
+     * Chat the message belongs to.
+     *
+     * @returns Chat / Chat
+     */
+    chat(): Promise<InstanceType<WhatsApp['Chat']>>;
     /**
-     * Contacto del autor (resuelve vía `wa.Contact.get`; fallback a instancia mínima).
-     * Memoizado por instancia: la primera llamada va al engine; las siguientes
-     * reutilizan la misma promesa sin nuevos round-trips.
-     * Author contact (resolves via `wa.Contact.get`; falls back to a minimal instance).
-     * Instance-memoized: first call hits the engine; subsequent calls reuse the
-     * same promise without further round-trips.
+     * Mensaje citado cuando hay `mid`, o null.
+     * Quoted message when `mid` exists, or null.
+     *
+     * @returns Mensaje citado o null / Quoted message or null
      */
-    author(): Promise<ContactInstance>;
+    message(): Promise<Message | null>;
     /**
-     * Chat al que pertenece el mensaje. Memoizado por instancia: la primera llamada
-     * va al engine; las siguientes reutilizan la misma promesa.
-     * Chat the message belongs to. Instance-memoized: first call hits the engine;
-     * subsequent calls reuse the same promise.
+     * 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
      */
-    chat(): Promise<ChatInstance>;
-    /** Contenido sin parsear, directo del engine. Las subclases override según su tipo. */
     content(): Promise<Buffer>;
     /**
-     * Devuelve un `Readable` con los bytes del mensaje. Para media (image/video/audio)
-     * lee desde el cache del engine o, si falta, descarga desde baileys. Para text/location/poll
-     * retorna el mismo binario que `content()` envuelto en un Readable.
-     * Returns a `Readable` of the message bytes. For media (image/video/audio) it reads
-     * from the engine cache or, if missing, downloads from baileys. For text/location/poll
-     * it wraps the `content()` buffer in a Readable.
+     * 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(): Promise<Readable>;
-    /** Reacciona al mensaje (emoji vacío para retirar). */
+    /**
+     * Reacciones del mensaje agrupadas por emoji con su conteo.
+     * Message reactions grouped by emoji with their count.
+     *
+     * @returns Conteo por emoji / Per-emoji 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.
+     *
+     * @param emoji - Emoji o '' / Emoji or ''
+     * @returns true si se envió / true when sent
+     */
     react(emoji: string): Promise<boolean>;
-    /** Reenvía el mensaje a un destino (CID, Chat o Contact). */
-    forward(target: ForwardTarget): Promise<boolean>;
-    /** Marca el mensaje como leído. */
-    seen(): Promise<boolean>;
-    /** Destaca/retira destacado del mensaje. */
+    /**
+     * Destaca o quita el destacado del mensaje.
+     * Stars or unstars the message.
+     *
+     * @param value - true destaca / true stars
+     * @returns true si se envió / true when sent
+     */
     star(value: boolean): Promise<boolean>;
-    /** Elimina el mensaje. `all=true` (default) borra para todos; `all=false` borra sólo en mi dispositivo. */
+    /**
+     * Marca el mensaje como leído.
+     * Marks the message as read.
+     *
+     * @returns true si se envió / true when sent
+     */
+    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
+     */
+    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 true si se reenvió / true when 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
+     * @returns true si se eliminó / true when deleted
+     */
     delete(all?: boolean): Promise<boolean>;
-    /** Edita el texto/caption del mensaje (solo propios editables). */
-    edit(text: string): Promise<boolean>;
-    /** Observa cambios sobre este mensaje. Retorna unsubscribe. / Watches this message. Returns unsubscribe. */
-    watch(handler: (msg: Message) => void): () => void;
-    /** Responde con texto. */
-    text(caption: string, opts?: SendOptions): Promise<Message | null>;
-    /** Responde con imagen. */
-    image(buf: Buffer, opts?: SendMediaOptions): Promise<Message | null>;
-    /** Responde con video. */
-    video(buf: Buffer, opts?: SendMediaOptions): Promise<Message | null>;
-    /** Responde con audio. */
-    audio(buf: Buffer, opts?: SendAudioOptions): Promise<Message | null>;
-    /** Responde con ubicación. */
-    location(loc: LocationOptions, opts?: SendOptions): Promise<Message | null>;
-    /** Responde con encuesta. */
-    poll(poll: PollOptions, opts?: SendPollOptions): Promise<Message | null>;
-    /** Responde con documento. */
-    document(buf: Buffer, opts: SendDocumentOptions): Promise<Message | null>;
-    /** Responde con tarjeta(s) de contacto. */
-    vcard(contacts: VCardInput[], opts?: SendOptions): Promise<Message | null>;
-    /** Responde con evento. */
-    event(data: EventInput, opts?: SendOptions): Promise<Message | null>;
+    /** Responde con texto. / Replies with text. */
+    text(caption: string, extra?: Omit<SendExtra, 'mid'>): Promise<Message | null>;
+    /** Responde con imagen. / Replies with an image. */
+    image(buf: Buffer, extra?: Omit<SendExtra, 'mid'> & {
+        caption?: string;
+    }): Promise<Message | null>;
+    /** Responde con video. / Replies with a video. */
+    video(buf: Buffer, extra?: Omit<SendExtra, 'mid'> & {
+        caption?: string;
+    }): Promise<Message | null>;
+    /** Responde con audio. / Replies with audio. */
+    audio(buf: Buffer, extra?: Omit<SendExtra, '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>;
+    /** Responde con encuesta. / Replies with a poll. */
+    poll(input: {
+        content: string;
+        options: {
+            content: string;
+        }[];
+    }, extra?: Omit<SendExtra, 'mid'> & {
+        multiple?: boolean;
+    }): Promise<Message | null>;
+    /** Responde con documento. / Replies with a document. */
+    document(buf: Buffer, extra: Omit<SendExtra, '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<SendExtra, '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<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;
+    }[]>;
 }
 /**
- * Mensaje de texto. Override `content()` para retornar el caption como Buffer sin pasar por engine.
- * Text message. Overrides `content()` returning caption as Buffer directly.
+ * Mensaje de texto; `preview()` expone la tarjeta del enlace embebido.
+ * Text message; `preview()` exposes the embedded link card.
  */
 export declare class Text extends Message {
-    content(): Promise<Buffer>;
+    /**
+     * 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(): Promise<{
+        link: string;
+        name: string | null;
+        content: string | null;
+        thumb: Buffer | null;
+    } | null>;
 }
 /**
- * Mensaje de imagen. Hereda `stream()` de la clase base; `content()` drena el stream.
- * Image message. Inherits `stream()` from the base class; `content()` drains the stream.
+ * Mensaje de imagen: dimensiones, peso y miniatura.
+ * Image message: dimensions, size and thumbnail.
  */
 export declare class Image 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;
+    /** 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 video. Hereda `stream()` de la clase base; `content()` drena el stream.
- * Video message. Inherits `stream()` from the base class; `content()` drains the stream.
+ * 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;
+    /** 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. Hereda `stream()` de la clase base; `content()` drena el stream.
- * `ptt` indica si es nota de voz (push-to-talk).
- * Audio message. Inherits `stream()` from the base class; `content()` drains the stream.
- * `ptt` flags voice notes.
+ * 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 {
-    /** true si es nota de voz (push-to-talk). / true if push-to-talk voice note. */
+    /** @internal */
+    private get _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 ubicación. Agrega getters sync `lat`, `lng`, `link` derivados del raw.
- * Location message. Adds sync getters `lat`, `lng`, `link` derived from raw.
+ * Mensaje de sticker: dimensiones, peso y animación.
+ * Sticker message: dimensions, size and animation.
  */
-export declare class Gps extends Message {
+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;
+    /** 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 {
+    /** 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.
+ */
+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. */
     get lng(): number;
-    /** URL de Google Maps apuntando a la coordenada. / Google Maps URL for the coordinate. */
-    get link(): string;
     /** true si es ubicación en tiempo real. / true when live location. */
     get live(): boolean;
+    /** URL de Google Maps de la coordenada. / Google Maps URL for the coordinate. */
+    get link(): string;
 }
 /**
- * Mensaje de encuesta. `caption` es la pregunta (heredada); agrega `options[]` con conteo y `multiple`.
- * Poll message. `caption` is the question (inherited); adds `options[]` with counts and `multiple`.
+ * Mensaje de encuesta: opciones con conteo, votos por contacto y voto propio.
+ * Poll message: options with counts, per-contact votes and self-voting.
  */
 export declare class Poll extends Message {
+    /** @internal */
     private get _poll();
-    /**
-     * true si admite múltiples respuestas. Lee primero el flag explícito persistido
-     * al enviar (caso propio, donde WhatsApp pierde el discriminador en el echo);
-     * fallback al `selectableOptionsCount` del proto (polls foráneos o de UI móvil).
-     * true if the poll accepts multiple answers. Prefers the persisted send-time
-     * flag (own polls, since WhatsApp drops the discriminator on echo); falls back
-     * to the proto `selectableOptionsCount` (foreign or mobile-UI polls).
-     */
+    /** @internal Updates de voto con los bytes normalizados post-engine. / Vote updates with post-engine normalized bytes. */
+    private get _updates();
+    /** true si admite varias respuestas. / true when multi-select. */
     get multiple(): boolean;
-    /** Opciones con conteo de votos actualizado. / Options with up-to-date vote counts. */
+    /** Opciones con su conteo de votos. / Options with their vote counts. */
     get options(): {
-        content: string;
+        name: string;
         count: number;
     }[];
     /**
-     * Vota en la encuesta. Acepta un índice o lista de índices (para `multiple`).
-     * Votes in the poll. Accepts a single index or list (for `multiple`).
+     * Votos individuales: opción elegida y teléfono del votante.
+     * Individual votes: chosen option and voter phone.
+     *
+     * @returns Lista de votos / Vote list
+     */
+    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.
+     *
+     * @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 documento. WhatsApp permite enviar cualquier archivo (PDF, imagen,
- * audio, video, etc.) como documento; lo que lo distingue de image/video/audio es
- * el tipo de mensaje (`documentMessage`), no el mimetype. Hereda `stream()` de la
- * clase base; `content()` drena el stream (cache → download).
- * Document message. WhatsApp lets you send any file (PDF, image, audio, video…)
- * as a document; what sets it apart from image/video/audio is the message type
- * (`documentMessage`), not the mimetype. Inherits `stream()` from the base class;
- * `content()` drains the stream (cache → download).
- */
-export declare class Document extends Message {
-    private get _doc_msg();
-    /** Nombre del archivo. / File name. */
-    get file_name(): string;
-    /** Tamaño en bytes (0 si se desconoce). / Size in bytes (0 if unknown). */
-    get size(): number;
-    /** Número de páginas (PDF); 0 si no aplica. / Page count (PDF); 0 when not applicable. */
-    get pages(): number;
-    /** Título del documento. / Document title. */
-    get title(): string;
-    content(): Promise<Buffer>;
-}
-/**
- * Mensaje de tarjeta(s) de contacto (vCard). Unifica `contactMessage` (uno) y
- * `contactsArrayMessage` (varios) bajo una sola lista `contacts`.
- * Contact card message (vCard). Unifies `contactMessage` (single) and
- * `contactsArrayMessage` (multiple) under a single `contacts` list.
+ * Mensaje de tarjeta(s) de contacto.
+ * Contact card(s) message.
  */
 export declare class VCard extends Message {
-    /** Contactos de la tarjeta con nombre y teléfono. / Card contacts with name and phone. */
+    /** Contactos de la tarjeta. / Card contacts. */
     get contacts(): {
         name: string;
         phone: string;
     }[];
 }
 /**
- * Mensaje de evento de calendario (`eventMessage`): nombre, descripción, rango de
- * fechas, estado de cancelación, link de unión y ubicación.
- * Calendar event message (`eventMessage`): name, description, date range,
- * cancellation state, join link and location.
+ * Mensaje de evento de calendario.
+ * Calendar event message.
  */
 export declare class Event extends Message {
+    /** @internal */
     private get _event();
     /** Nombre del evento. / Event name. */
     get name(): string;
-    /** Epoch ms de inicio. / Start epoch ms. */
-    get start(): number;
-    /** Epoch ms de fin, o null. / End epoch ms, or null. */
-    get end(): number | null;
-    /** true si el evento fue cancelado. / true if the event was canceled. */
+    /** Inicio en ISO UTC. / Start as ISO UTC. */
+    get start(): string;
+    /** Fin en ISO UTC, o null. / End as ISO UTC, or null. */
+    get end(): string | null;
+    /** true si fue cancelado. / true when canceled. */
     get canceled(): boolean;
-    /** Link de unión (audio/video), si aplica. / Join link (audio/video), if any. */
+    /** Link de unión, si aplica. / Join link, if any. */
     get link(): string;
     /** Ubicación del evento, o null. / Event location, or null. */
     get place(): {
@@ -336,42 +547,16 @@ export declare class Event extends Message {
     } | null;
 }
 /**
- * Factoría que enlaza los statics a `wa` y expone las subclases.
- * Factory binding statics to `wa` and exposing subclasses.
+ * 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).
+ *
+ * @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
  */
-export declare function message(wa: WhatsApp): {
-    Text: typeof Text;
-    Image: typeof Image;
-    Video: typeof Video;
-    Audio: typeof Audio;
-    Gps: typeof Gps;
-    Poll: typeof Poll;
-    Document: typeof Document;
-    VCard: typeof VCard;
-    Event: typeof Event;
-    build_message_doc: typeof build_message_doc;
-    build_instance: (doc: IMessage) => Promise<Message>;
-    /** Obtiene un mensaje por CID/MID. */
-    get(cid: string, mid: string): Promise<Message | null>;
-    /** Pagina mensajes de un chat. */
-    list(cid: string, offset?: number, limit?: number): Promise<Message[]>;
-    /** Cuenta mensajes de un chat. */
-    count(cid: string): Promise<number>;
-    text(cid: string, caption: string, opts?: SendOptions): Promise<Message | null>;
-    image(cid: string, buf: Buffer, opts?: SendMediaOptions): Promise<Message | null>;
-    video(cid: string, buf: Buffer, opts?: SendMediaOptions): Promise<Message | null>;
-    audio(cid: string, buf: Buffer, opts?: SendAudioOptions): Promise<Message | null>;
-    location(cid: string, loc: LocationOptions, opts?: SendOptions): Promise<Message | null>;
-    poll(cid: string, p: PollOptions, opts?: SendPollOptions): Promise<Message | null>;
-    document(cid: string, buf: Buffer, opts: SendDocumentOptions): Promise<Message | null>;
-    vcard(cid: string, contacts: VCardInput[], opts?: SendOptions): Promise<Message | null>;
-    event(cid: string, data: EventInput, opts?: SendOptions): Promise<Message | null>;
-    edit(cid: string, mid: string, text: string): Promise<boolean>;
-    delete(cid: string, mid: string, all?: boolean): Promise<boolean>;
-    react(cid: string, mid: string, emoji: string): Promise<boolean>;
-    forward(cid: string, mid: string, target: ForwardTarget): Promise<boolean>;
-    seen(cid: string, mid: string): Promise<boolean>;
-    star(cid: string, mid: string, value: boolean): Promise<boolean>;
-    watch(cid: string, mid: string, handler: (msg: Message) => void): () => void;
-};
+export declare function message(wa: WhatsApp, raw: Message['_raw'] | WAMessage): Message;
 export {};