@arcaelas/whatsapp 4.5.0 → 6.0.0

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

@@ -3,64 +3,49 @@
  * @description Entidad Chat — conversaciones individuales y grupales.
  * Chat entity — individual and group conversations.
  */
-import type { Message } from '../../lib/message';
+import { Message } from '../../lib/message';
 import type { WhatsApp } from '../../lib/whatsapp';
 /**
- * Participante de grupo.
- * Group participant.
- */
-export interface GroupParticipant {
-    id: string;
-    admin: string | null;
-}
-/**
- * Shape persistido del chat (snake_case).
- * Persisted chat shape (snake_case).
- */
-export interface IChatRaw {
-    id: string;
-    name?: string | null;
-    display_name?: string | null;
-    description?: string | null;
-    unread_count?: number | null;
-    read_only?: boolean | null;
-    archived?: boolean | null;
-    pinned?: number | null;
-    mute_end_time?: number | null;
-    marked_as_unread?: boolean | null;
-    participants?: GroupParticipant[] | null;
-    created_by?: string | null;
-    created_at?: number | null;
-    ephemeral_expiration?: number | null;
-}
-/**
- * Clase base del chat (forma pública, solo lectura).
- * Base Chat class (public shape, read-only).
+ * Clase base del chat: recibe el raw y deriva todo con getters.
+ * Base Chat class: receives the raw and derives everything via getters.
  */
 export declare class Chat {
-    /** @internal Shape persistido. Uso interno. / Internal persisted shape. */
-    readonly _raw: IChatRaw;
-    constructor(raw: IChatRaw);
-    /** JID del chat. / Chat JID. */
+    readonly _raw: {
+        id: string;
+        name?: string | null;
+        archived?: boolean | null;
+        pinned?: number | null;
+        mute_end_time?: number | null;
+        unread_count?: number | null;
+    };
+    /**
+     * @internal Documento crudo del chat. `id` es el identificador del engine (JID, LID o
+     * `@g.us`); `pinned` y `mute_end_time` son epoch ms.
+     * Raw chat document. `id` is the engine identifier (JID, LID or `@g.us`); `pinned` and
+     * `mute_end_time` are epoch ms.
+     */
+    constructor(_raw: {
+        id: string;
+        name?: string | null;
+        archived?: boolean | null;
+        pinned?: number | null;
+        mute_end_time?: number | null;
+        unread_count?: number | null;
+    });
+    /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
     get id(): string;
-    /** CID (alias). / CID (alias). */
-    get cid(): string;
-    /** Tipo: contact o group. / Type: contact or group. */
-    get type(): 'contact' | 'group';
-    /** Nombre del chat. / Chat name. */
+    /** Nombre del grupo o del contacto. / Group or contact name. */
     get name(): string;
-    /** Descripción del grupo. / Group description. */
-    get content(): string;
-    /** Si está fijado. / Whether it's pinned. */
-    get pinned(): boolean;
-    /** Si está archivado. / Whether it's archived. */
+    /** Tipo de conversación. / Conversation type. */
+    get type(): 'group' | 'contact';
+    /** true si el chat está archivado. / true when the chat is archived. */
     get archived(): boolean;
-    /** true si el chat está silenciado y el silencio aún no expira. / true if chat is muted and the mute has not expired. */
-    get muted(): boolean;
-    /** Si está leído. / Whether it's read. */
-    get read(): boolean;
-    /** Si es solo lectura. / Whether it's read-only. */
-    get readonly(): boolean;
+    /** true si el chat está fijado. / true when the chat is pinned. */
+    get pinned(): boolean;
+    /** Mensajes sin leer del chat. / Chat's unread messages. */
+    get count(): number;
+    /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
+    get muted(): string | null;
 }
 /**
  * Factoría de Chat ligada al contexto WhatsApp.
@@ -69,184 +54,376 @@ export declare class Chat {
  * @param wa - Instancia principal / Main WhatsApp instance
  */
 export declare function chat(wa: WhatsApp): {
-    new (raw: IChatRaw): {
-        /** @internal Cache TTL (15s) de la promesa de participants del grupo. Evita round-trips a `groupMetadata` y deduplica llamadas concurrentes. */
-        _members_cache: Promise<{
-            id: string;
-        }[]> | null;
-        /** Re-hidrata metadata del chat desde el socket. / Re-hydrates chat metadata from the socket. */
-        refresh(): Promise</*elided*/ any | null>;
-        /** Fija/desfija el chat. / Pins or unpins the chat. */
-        pin(value: boolean): Promise<boolean>;
-        /** Archiva/desarchiva el chat. / Archives or unarchives the chat. */
-        archive(value: boolean): Promise<boolean>;
-        /** Silencia/des-silencia el chat. / Mutes or unmutes the chat. */
-        mute(value: boolean): Promise<boolean>;
-        /** Toggle "Escribiendo...". / Toggles the "typing..." indicator. */
-        typing(on: boolean): Promise<boolean>;
-        /** Toggle "Grabando audio...". / Toggles the "recording audio..." indicator. */
-        recording(on: boolean): Promise<boolean>;
-        /** Vacía mensajes del chat (engine local). / Clears chat messages (local engine). */
-        clear(): Promise<boolean>;
-        /** Elimina el chat y sus mensajes (remoto + local). / Deletes the chat and its messages (remote + local). */
-        delete(): Promise<boolean>;
+    new (_raw: {
+        id: string;
+        name?: string | null;
+        archived?: boolean | null;
+        pinned?: number | null;
+        mute_end_time?: number | null;
+        unread_count?: number | null;
+    }): {
         /**
-         * Participantes del chat paginados (incluyéndome en grupos). Para grupos,
-         * el `groupMetadata` se memoiza en la instancia con TTL de 15s para evitar
-         * round-trips repetidos al socket.
-         * Chat participants paginated (self included in groups). For groups,
-         * `groupMetadata` is memoized on the instance with a 15s TTL to avoid
-         * repeated socket round-trips.
+         * Participantes del chat: los integrantes en grupos, el contacto y yo en 1:1.
+         * Chat participants: members for groups, the contact and myself for 1:1.
+         *
+         * @param offset - Desplazamiento / Offset
+         * @param limit - Tamaño de página / Page size
+         * @returns Página de contactos / Contact page
          */
         members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
-        /** Mensajes del chat paginados por mtime DESC. / Chat messages paginated by mtime DESC. */
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        content(): Promise<string>;
+        /**
+         * Mensajes del chat paginados desde el más reciente.
+         * Chat messages paginated from the most recent one.
+         *
+         * @param offset - Desplazamiento / Offset
+         * @param limit - Tamaño de página / Page size
+         * @returns Página de mensajes / Message page
+         */
         messages(offset?: number, limit?: number): Promise<Message[]>;
-        /** @internal Shape persistido. Uso interno. / Internal persisted shape. */
-        readonly _raw: IChatRaw;
-        /** JID del chat. / Chat JID. */
+        /**
+         * Activa o desactiva el indicador «escribiendo…».
+         * Toggles the "typing…" indicator.
+         *
+         * @param value - true activa, false vuelve a pausa / true enables, false returns to paused
+         * @returns true si el socket estaba disponible / true when the socket was available
+         */
+        typing(value: boolean): Promise<boolean>;
+        /**
+         * Activa o desactiva el indicador «grabando audio…».
+         * Toggles the "recording audio…" indicator.
+         *
+         * @param value - true activa, false vuelve a pausa / true enables, false returns to paused
+         * @returns true si el socket estaba disponible / true when the socket was available
+         */
+        recording(value: boolean): Promise<boolean>;
+        /**
+         * Archiva o desarchiva el chat en la cuenta de WhatsApp.
+         * Archives or unarchives the chat on the WhatsApp account.
+         *
+         * @param value - true archiva, false desarchiva / true archives, false unarchives
+         * @returns true si la acción se envió / true when the action was sent
+         */
+        archive(value: boolean): Promise<boolean>;
+        /**
+         * Fija o desfija el chat en la cuenta de WhatsApp. WhatsApp acepta hasta 3 chats
+         * fijados y descarta el cuarto sin avisar, así que el límite se verifica antes.
+         * Pins or unpins the chat on the WhatsApp account. WhatsApp accepts up to 3 pinned
+         * chats and silently drops the fourth, so the limit is checked beforehand.
+         *
+         * @param value - true fija, false desfija / true pins, false unpins
+         * @returns false si el socket está caído o ya hay 3 chats fijados / false when the socket is down or 3 chats are already pinned
+         */
+        pin(value: boolean): Promise<boolean>;
+        /**
+         * Silencia el chat hasta la fecha indicada. `false` o una fecha pasada lo des-silencian.
+         * Mutes the chat until the given date. `false` or a past date unmutes it.
+         *
+         * @param until - Fecha límite (ISO, epoch ms o Date) o false / Deadline (ISO, epoch ms or Date) or false
+         * @returns true si la acción se envió / true when the action was sent
+         */
+        mute(until: string | number | Date | false): Promise<boolean>;
+        /**
+         * Marca el chat completo como leído en la cuenta de WhatsApp.
+         * Marks the whole chat as read on the WhatsApp account.
+         *
+         * @returns true si la acción se envió / true when the action was sent
+         */
+        seen(): Promise<boolean>;
+        /**
+         * Vacía los mensajes del chat en la cuenta de WhatsApp y en el engine, conservando el chat.
+         * Clears the chat messages on the WhatsApp account and in the engine, keeping the chat.
+         *
+         * @returns true siempre; la limpieza local es idempotente / always true; local cleanup is idempotent
+         */
+        clear(): Promise<boolean>;
+        /**
+         * Elimina el chat y sus mensajes en la cuenta de WhatsApp y en el engine; en grupos
+         * abandona el grupo.
+         * Deletes the chat and its messages on the WhatsApp account and in the engine; for
+         * groups it leaves the group.
+         *
+         * @returns true siempre; la limpieza local es idempotente / always true; local cleanup is idempotent
+         */
+        delete(): Promise<boolean>;
+        readonly _raw: {
+            id: string;
+            name?: string | null;
+            archived?: boolean | null;
+            pinned?: number | null;
+            mute_end_time?: number | null;
+            unread_count?: number | null;
+        };
+        /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
         get id(): string;
-        /** CID (alias). / CID (alias). */
-        get cid(): string;
-        /** Tipo: contact o group. / Type: contact or group. */
-        get type(): "contact" | "group";
-        /** Nombre del chat. / Chat name. */
+        /** Nombre del grupo o del contacto. / Group or contact name. */
         get name(): string;
-        /** Descripción del grupo. / Group description. */
-        get content(): string;
-        /** Si está fijado. / Whether it's pinned. */
-        get pinned(): boolean;
-        /** Si está archivado. / Whether it's archived. */
+        /** Tipo de conversación. / Conversation type. */
+        get type(): "group" | "contact";
+        /** true si el chat está archivado. / true when the chat is archived. */
         get archived(): boolean;
-        /** true si el chat está silenciado y el silencio aún no expira. / true if chat is muted and the mute has not expired. */
-        get muted(): boolean;
-        /** Si está leído. / Whether it's read. */
-        get read(): boolean;
-        /** Si es solo lectura. / Whether it's read-only. */
-        get readonly(): boolean;
+        /** true si el chat está fijado. / true when the chat is pinned. */
+        get pinned(): boolean;
+        /** Mensajes sin leer del chat. / Chat's unread messages. */
+        get count(): number;
+        /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
+        get muted(): string | null;
     };
     /**
-     * Obtiene un chat por CID. Si no está persistido, lo crea a partir del contacto.
-     * Retrieves a chat by CID. If not persisted, creates it from the contact.
+     * Carga un chat por teléfono, JID, LID o id de grupo: el persistido en el engine o,
+     * si todavía no existe, una instancia mínima lista para usar (no se persiste).
+     * Loads a chat by phone, JID, LID or group id: the engine-persisted one or, when it
+     * does not exist yet, a minimal ready-to-use instance (not persisted).
+     *
+     * @param cid - Teléfono, JID, LID o id de grupo / Phone, JID, LID or group id
+     * @returns Chat o null si el identificador es irresoluble / Chat or null when the identifier cannot be resolved
      */
-    get(cid: string): Promise<{
-        /** @internal Cache TTL (15s) de la promesa de participants del grupo. Evita round-trips a `groupMetadata` y deduplica llamadas concurrentes. */
-        _members_cache: Promise<{
-            id: string;
-        }[]> | null;
-        /** Re-hidrata metadata del chat desde el socket. / Re-hydrates chat metadata from the socket. */
-        refresh(): Promise</*elided*/ any | null>;
-        /** Fija/desfija el chat. / Pins or unpins the chat. */
-        pin(value: boolean): Promise<boolean>;
-        /** Archiva/desarchiva el chat. / Archives or unarchives the chat. */
-        archive(value: boolean): Promise<boolean>;
-        /** Silencia/des-silencia el chat. / Mutes or unmutes the chat. */
-        mute(value: boolean): Promise<boolean>;
-        /** Toggle "Escribiendo...". / Toggles the "typing..." indicator. */
-        typing(on: boolean): Promise<boolean>;
-        /** Toggle "Grabando audio...". / Toggles the "recording audio..." indicator. */
-        recording(on: boolean): Promise<boolean>;
-        /** Vacía mensajes del chat (engine local). / Clears chat messages (local engine). */
-        clear(): Promise<boolean>;
-        /** Elimina el chat y sus mensajes (remoto + local). / Deletes the chat and its messages (remote + local). */
-        delete(): Promise<boolean>;
+    get(cid: string | number): Promise<{
         /**
-         * Participantes del chat paginados (incluyéndome en grupos). Para grupos,
-         * el `groupMetadata` se memoiza en la instancia con TTL de 15s para evitar
-         * round-trips repetidos al socket.
-         * Chat participants paginated (self included in groups). For groups,
-         * `groupMetadata` is memoized on the instance with a 15s TTL to avoid
-         * repeated socket round-trips.
+         * Participantes del chat: los integrantes en grupos, el contacto y yo en 1:1.
+         * Chat participants: members for groups, the contact and myself for 1:1.
+         *
+         * @param offset - Desplazamiento / Offset
+         * @param limit - Tamaño de página / Page size
+         * @returns Página de contactos / Contact page
          */
         members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
-        /** Mensajes del chat paginados por mtime DESC. / Chat messages paginated by mtime DESC. */
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        content(): Promise<string>;
+        /**
+         * Mensajes del chat paginados desde el más reciente.
+         * Chat messages paginated from the most recent one.
+         *
+         * @param offset - Desplazamiento / Offset
+         * @param limit - Tamaño de página / Page size
+         * @returns Página de mensajes / Message page
+         */
         messages(offset?: number, limit?: number): Promise<Message[]>;
-        /** @internal Shape persistido. Uso interno. / Internal persisted shape. */
-        readonly _raw: IChatRaw;
-        /** JID del chat. / Chat JID. */
+        /**
+         * Activa o desactiva el indicador «escribiendo…».
+         * Toggles the "typing…" indicator.
+         *
+         * @param value - true activa, false vuelve a pausa / true enables, false returns to paused
+         * @returns true si el socket estaba disponible / true when the socket was available
+         */
+        typing(value: boolean): Promise<boolean>;
+        /**
+         * Activa o desactiva el indicador «grabando audio…».
+         * Toggles the "recording audio…" indicator.
+         *
+         * @param value - true activa, false vuelve a pausa / true enables, false returns to paused
+         * @returns true si el socket estaba disponible / true when the socket was available
+         */
+        recording(value: boolean): Promise<boolean>;
+        /**
+         * Archiva o desarchiva el chat en la cuenta de WhatsApp.
+         * Archives or unarchives the chat on the WhatsApp account.
+         *
+         * @param value - true archiva, false desarchiva / true archives, false unarchives
+         * @returns true si la acción se envió / true when the action was sent
+         */
+        archive(value: boolean): Promise<boolean>;
+        /**
+         * Fija o desfija el chat en la cuenta de WhatsApp. WhatsApp acepta hasta 3 chats
+         * fijados y descarta el cuarto sin avisar, así que el límite se verifica antes.
+         * Pins or unpins the chat on the WhatsApp account. WhatsApp accepts up to 3 pinned
+         * chats and silently drops the fourth, so the limit is checked beforehand.
+         *
+         * @param value - true fija, false desfija / true pins, false unpins
+         * @returns false si el socket está caído o ya hay 3 chats fijados / false when the socket is down or 3 chats are already pinned
+         */
+        pin(value: boolean): Promise<boolean>;
+        /**
+         * Silencia el chat hasta la fecha indicada. `false` o una fecha pasada lo des-silencian.
+         * Mutes the chat until the given date. `false` or a past date unmutes it.
+         *
+         * @param until - Fecha límite (ISO, epoch ms o Date) o false / Deadline (ISO, epoch ms or Date) or false
+         * @returns true si la acción se envió / true when the action was sent
+         */
+        mute(until: string | number | Date | false): Promise<boolean>;
+        /**
+         * Marca el chat completo como leído en la cuenta de WhatsApp.
+         * Marks the whole chat as read on the WhatsApp account.
+         *
+         * @returns true si la acción se envió / true when the action was sent
+         */
+        seen(): Promise<boolean>;
+        /**
+         * Vacía los mensajes del chat en la cuenta de WhatsApp y en el engine, conservando el chat.
+         * Clears the chat messages on the WhatsApp account and in the engine, keeping the chat.
+         *
+         * @returns true siempre; la limpieza local es idempotente / always true; local cleanup is idempotent
+         */
+        clear(): Promise<boolean>;
+        /**
+         * Elimina el chat y sus mensajes en la cuenta de WhatsApp y en el engine; en grupos
+         * abandona el grupo.
+         * Deletes the chat and its messages on the WhatsApp account and in the engine; for
+         * groups it leaves the group.
+         *
+         * @returns true siempre; la limpieza local es idempotente / always true; local cleanup is idempotent
+         */
+        delete(): Promise<boolean>;
+        readonly _raw: {
+            id: string;
+            name?: string | null;
+            archived?: boolean | null;
+            pinned?: number | null;
+            mute_end_time?: number | null;
+            unread_count?: number | null;
+        };
+        /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
         get id(): string;
-        /** CID (alias). / CID (alias). */
-        get cid(): string;
-        /** Tipo: contact o group. / Type: contact or group. */
-        get type(): "contact" | "group";
-        /** Nombre del chat. / Chat name. */
+        /** Nombre del grupo o del contacto. / Group or contact name. */
         get name(): string;
-        /** Descripción del grupo. / Group description. */
-        get content(): string;
-        /** Si está fijado. / Whether it's pinned. */
-        get pinned(): boolean;
-        /** Si está archivado. / Whether it's archived. */
+        /** Tipo de conversación. / Conversation type. */
+        get type(): "group" | "contact";
+        /** true si el chat está archivado. / true when the chat is archived. */
         get archived(): boolean;
-        /** true si el chat está silenciado y el silencio aún no expira. / true if chat is muted and the mute has not expired. */
-        get muted(): boolean;
-        /** Si está leído. / Whether it's read. */
-        get read(): boolean;
-        /** Si es solo lectura. / Whether it's read-only. */
-        get readonly(): boolean;
+        /** true si el chat está fijado. / true when the chat is pinned. */
+        get pinned(): boolean;
+        /** Mensajes sin leer del chat. / Chat's unread messages. */
+        get count(): number;
+        /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
+        get muted(): string | null;
     } | null>;
-    /** Pagina los chats persistidos por mtime DESC. / Paginates persisted chats by mtime DESC. */
+    /**
+     * Pagina los chats persistidos, del más reciente al más antiguo.
+     * Paginates persisted chats, from the most recent to the oldest.
+     *
+     * @param offset - Desplazamiento / Offset
+     * @param limit - Tamaño de página / Page size
+     * @returns Página de chats / Chat page
+     */
     list(offset?: number, limit?: number): Promise<{
-        /** @internal Cache TTL (15s) de la promesa de participants del grupo. Evita round-trips a `groupMetadata` y deduplica llamadas concurrentes. */
-        _members_cache: Promise<{
-            id: string;
-        }[]> | null;
-        /** Re-hidrata metadata del chat desde el socket. / Re-hydrates chat metadata from the socket. */
-        refresh(): Promise</*elided*/ any | null>;
-        /** Fija/desfija el chat. / Pins or unpins the chat. */
-        pin(value: boolean): Promise<boolean>;
-        /** Archiva/desarchiva el chat. / Archives or unarchives the chat. */
-        archive(value: boolean): Promise<boolean>;
-        /** Silencia/des-silencia el chat. / Mutes or unmutes the chat. */
-        mute(value: boolean): Promise<boolean>;
-        /** Toggle "Escribiendo...". / Toggles the "typing..." indicator. */
-        typing(on: boolean): Promise<boolean>;
-        /** Toggle "Grabando audio...". / Toggles the "recording audio..." indicator. */
-        recording(on: boolean): Promise<boolean>;
-        /** Vacía mensajes del chat (engine local). / Clears chat messages (local engine). */
-        clear(): Promise<boolean>;
-        /** Elimina el chat y sus mensajes (remoto + local). / Deletes the chat and its messages (remote + local). */
-        delete(): Promise<boolean>;
         /**
-         * Participantes del chat paginados (incluyéndome en grupos). Para grupos,
-         * el `groupMetadata` se memoiza en la instancia con TTL de 15s para evitar
-         * round-trips repetidos al socket.
-         * Chat participants paginated (self included in groups). For groups,
-         * `groupMetadata` is memoized on the instance with a 15s TTL to avoid
-         * repeated socket round-trips.
+         * Participantes del chat: los integrantes en grupos, el contacto y yo en 1:1.
+         * Chat participants: members for groups, the contact and myself for 1:1.
+         *
+         * @param offset - Desplazamiento / Offset
+         * @param limit - Tamaño de página / Page size
+         * @returns Página de contactos / Contact page
          */
         members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
-        /** Mensajes del chat paginados por mtime DESC. / Chat messages paginated by mtime DESC. */
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        content(): Promise<string>;
+        /**
+         * Mensajes del chat paginados desde el más reciente.
+         * Chat messages paginated from the most recent one.
+         *
+         * @param offset - Desplazamiento / Offset
+         * @param limit - Tamaño de página / Page size
+         * @returns Página de mensajes / Message page
+         */
         messages(offset?: number, limit?: number): Promise<Message[]>;
-        /** @internal Shape persistido. Uso interno. / Internal persisted shape. */
-        readonly _raw: IChatRaw;
-        /** JID del chat. / Chat JID. */
+        /**
+         * Activa o desactiva el indicador «escribiendo…».
+         * Toggles the "typing…" indicator.
+         *
+         * @param value - true activa, false vuelve a pausa / true enables, false returns to paused
+         * @returns true si el socket estaba disponible / true when the socket was available
+         */
+        typing(value: boolean): Promise<boolean>;
+        /**
+         * Activa o desactiva el indicador «grabando audio…».
+         * Toggles the "recording audio…" indicator.
+         *
+         * @param value - true activa, false vuelve a pausa / true enables, false returns to paused
+         * @returns true si el socket estaba disponible / true when the socket was available
+         */
+        recording(value: boolean): Promise<boolean>;
+        /**
+         * Archiva o desarchiva el chat en la cuenta de WhatsApp.
+         * Archives or unarchives the chat on the WhatsApp account.
+         *
+         * @param value - true archiva, false desarchiva / true archives, false unarchives
+         * @returns true si la acción se envió / true when the action was sent
+         */
+        archive(value: boolean): Promise<boolean>;
+        /**
+         * Fija o desfija el chat en la cuenta de WhatsApp. WhatsApp acepta hasta 3 chats
+         * fijados y descarta el cuarto sin avisar, así que el límite se verifica antes.
+         * Pins or unpins the chat on the WhatsApp account. WhatsApp accepts up to 3 pinned
+         * chats and silently drops the fourth, so the limit is checked beforehand.
+         *
+         * @param value - true fija, false desfija / true pins, false unpins
+         * @returns false si el socket está caído o ya hay 3 chats fijados / false when the socket is down or 3 chats are already pinned
+         */
+        pin(value: boolean): Promise<boolean>;
+        /**
+         * Silencia el chat hasta la fecha indicada. `false` o una fecha pasada lo des-silencian.
+         * Mutes the chat until the given date. `false` or a past date unmutes it.
+         *
+         * @param until - Fecha límite (ISO, epoch ms o Date) o false / Deadline (ISO, epoch ms or Date) or false
+         * @returns true si la acción se envió / true when the action was sent
+         */
+        mute(until: string | number | Date | false): Promise<boolean>;
+        /**
+         * Marca el chat completo como leído en la cuenta de WhatsApp.
+         * Marks the whole chat as read on the WhatsApp account.
+         *
+         * @returns true si la acción se envió / true when the action was sent
+         */
+        seen(): Promise<boolean>;
+        /**
+         * Vacía los mensajes del chat en la cuenta de WhatsApp y en el engine, conservando el chat.
+         * Clears the chat messages on the WhatsApp account and in the engine, keeping the chat.
+         *
+         * @returns true siempre; la limpieza local es idempotente / always true; local cleanup is idempotent
+         */
+        clear(): Promise<boolean>;
+        /**
+         * Elimina el chat y sus mensajes en la cuenta de WhatsApp y en el engine; en grupos
+         * abandona el grupo.
+         * Deletes the chat and its messages on the WhatsApp account and in the engine; for
+         * groups it leaves the group.
+         *
+         * @returns true siempre; la limpieza local es idempotente / always true; local cleanup is idempotent
+         */
+        delete(): Promise<boolean>;
+        readonly _raw: {
+            id: string;
+            name?: string | null;
+            archived?: boolean | null;
+            pinned?: number | null;
+            mute_end_time?: number | null;
+            unread_count?: number | null;
+        };
+        /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
         get id(): string;
-        /** CID (alias). / CID (alias). */
-        get cid(): string;
-        /** Tipo: contact o group. / Type: contact or group. */
-        get type(): "contact" | "group";
-        /** Nombre del chat. / Chat name. */
+        /** Nombre del grupo o del contacto. / Group or contact name. */
         get name(): string;
-        /** Descripción del grupo. / Group description. */
-        get content(): string;
-        /** Si está fijado. / Whether it's pinned. */
-        get pinned(): boolean;
-        /** Si está archivado. / Whether it's archived. */
+        /** Tipo de conversación. / Conversation type. */
+        get type(): "group" | "contact";
+        /** true si el chat está archivado. / true when the chat is archived. */
         get archived(): boolean;
-        /** true si el chat está silenciado y el silencio aún no expira. / true if chat is muted and the mute has not expired. */
-        get muted(): boolean;
-        /** Si está leído. / Whether it's read. */
-        get read(): boolean;
-        /** Si es solo lectura. / Whether it's read-only. */
-        get readonly(): boolean;
+        /** true si el chat está fijado. / true when the chat is pinned. */
+        get pinned(): boolean;
+        /** Mensajes sin leer del chat. / Chat's unread messages. */
+        get count(): number;
+        /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
+        get muted(): string | null;
     }[]>;
-    /** Fija/desfija un chat por CID. / Pins or unpins a chat by CID. */
-    pin(cid: string, value: boolean): Promise<boolean>;
-    /** Archiva/desarchiva un chat por CID. / Archives or unarchives a chat by CID. */
-    archive(cid: string, value: boolean): Promise<boolean>;
-    /** Silencia/des-silencia un chat por CID. / Mutes or unmutes a chat by CID. */
-    mute(cid: string, value: boolean): Promise<boolean>;
-    /** Vacía mensajes del chat (local). / Clears the chat's messages (local only). */
-    clear(cid: string): Promise<boolean>;
-    /** Elimina el chat y sus mensajes. / Deletes the chat and its messages. */
-    delete(cid: string): Promise<boolean>;
 };