@arcaelas/whatsapp 1.2.2 → 1.4.0

package/build/esm/Contact.d.ts

@@ -0,0 +1,856 @@
+/**
+ * @file Contact.ts
+ * @description Clase Contact para gestión de contactos de WhatsApp
+ */
+import type { WhatsApp } from './WhatsApp';
+/**
+ * @description Objeto raw del contacto (protocolo).
+ */
+export interface IContactRaw {
+    /** JID único del contacto */
+    id: string;
+    /** ID alternativo en formato LID */
+    lid?: string | null;
+    /** Nombre guardado en la agenda del usuario */
+    name?: string | null;
+    /** Nombre que el contacto configuró en su perfil (pushName) */
+    notify?: string | null;
+    /** Nombre de cuenta business verificada */
+    verifiedName?: string | null;
+    /** URL de la foto de perfil */
+    imgUrl?: string | null;
+    /** Bio/estado del perfil del contacto */
+    status?: string | null;
+}
+/**
+ * @description Datos persistidos de un contacto.
+ */
+export interface IContact {
+    /** JID del contacto (ej: 123456@s.whatsapp.net) */
+    id: string;
+    /** Nombre del contacto */
+    name: string;
+    /** URL de la foto de perfil o null */
+    photo: string | null;
+    /** Número de teléfono sin formato */
+    phone: string;
+    /** Bio del contacto */
+    content: string;
+    /** Objeto raw del protocolo */
+    raw: IContactRaw;
+}
+/**
+ * @description
+ * Clase base para representar un contacto de WhatsApp.
+ * Usar Contact.get() para obtener instancias.
+ */
+export declare class Contact {
+    readonly raw: IContactRaw;
+    constructor(data: IContact);
+    /** JID único del contacto */
+    get id(): string;
+    /** Nombre del contacto */
+    get name(): string;
+    /** URL de la foto de perfil o null */
+    get photo(): string | null;
+    /** Número de teléfono sin formato */
+    get phone(): string;
+    /** Bio del contacto */
+    get content(): string;
+}
+/**
+ * @description Construye IContact desde raw.
+ * @param raw Objeto raw del contacto.
+ * @returns IContact normalizado.
+ */
+export declare function build_contact(raw: IContactRaw): IContact;
+/**
+ * @description Factory que retorna la clase Contact enlazada al contexto.
+ * @param wa Instancia de WhatsApp.
+ * @returns Clase _Contact que extiende Contact.
+ */
+export declare function contact(wa: WhatsApp): {
+    new (data: IContact): {
+        /**
+         * @description Cambia el nombre del contacto.
+         * @param name Nuevo nombre.
+         * @returns true si se guardó correctamente.
+         */
+        rename(name: string): Promise<boolean>;
+        /**
+         * @description Actualiza los datos del perfil desde WhatsApp.
+         * @returns this con datos actualizados, o null si falla.
+         */
+        refresh(): Promise</*elided*/ any | null>;
+        /**
+         * @description Obtiene o crea el chat con este contacto.
+         * @returns Chat asociado al contacto.
+         */
+        chat(): Promise<{
+            messages(offset?: number, limit?: number): Promise<InstanceType<{
+                new (data: import("./Message").IMessage): {
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                };
+                get(cid: string, mid: string): Promise<InstanceType</*elided*/ any> | null>;
+                react(cid: string, mid: string, emoji: string): Promise<boolean>;
+                remove(cid: string, mid: string): Promise<boolean>;
+                forward(cid: string, mid: string, to_cid: string): Promise<boolean>;
+                edit(cid: string, mid: string, text: string): Promise<boolean>;
+                text(cid: string, text: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                image(cid: string, buffer: Buffer, caption?: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                video(cid: string, buffer: Buffer, caption?: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                audio(cid: string, buffer: Buffer, ptt?: boolean): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                location(cid: string, opts: import("./Message").LocationOptions): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                poll(cid: string, opts: import("./Message").PollOptions): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                watch(cid: string, mid: string, handler: (msg: InstanceType</*elided*/ any>) => void): () => void;
+                notify(cid: string, mid: string): void;
+            }>[]>;
+            refresh(): Promise</*elided*/ any | null>;
+            readonly raw: import("./Chat").IChatRaw;
+            get id(): string;
+            get type(): "contact" | "group";
+            get name(): string;
+            get content(): string;
+            get pined(): boolean;
+            get archived(): boolean;
+            get muted(): number | false;
+            get readed(): boolean;
+            get readonly(): boolean;
+        } | null>;
+        readonly raw: IContactRaw;
+        /** JID único del contacto */
+        get id(): string;
+        /** Nombre del contacto */
+        get name(): string;
+        /** URL de la foto de perfil o null */
+        get photo(): string | null;
+        /** Número de teléfono sin formato */
+        get phone(): string;
+        /** Bio del contacto */
+        get content(): string;
+    };
+    /**
+     * @description Obtiene un contacto por su ID.
+     * @param uid JID del contacto (@s.whatsapp.net) o número de teléfono.
+     * @returns Contacto o null si no existe.
+     */
+    get(uid: string): Promise<{
+        /**
+         * @description Cambia el nombre del contacto.
+         * @param name Nuevo nombre.
+         * @returns true si se guardó correctamente.
+         */
+        rename(name: string): Promise<boolean>;
+        /**
+         * @description Actualiza los datos del perfil desde WhatsApp.
+         * @returns this con datos actualizados, o null si falla.
+         */
+        refresh(): Promise</*elided*/ any | null>;
+        /**
+         * @description Obtiene o crea el chat con este contacto.
+         * @returns Chat asociado al contacto.
+         */
+        chat(): Promise<{
+            messages(offset?: number, limit?: number): Promise<InstanceType<{
+                new (data: import("./Message").IMessage): {
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                };
+                get(cid: string, mid: string): Promise<InstanceType</*elided*/ any> | null>;
+                react(cid: string, mid: string, emoji: string): Promise<boolean>;
+                remove(cid: string, mid: string): Promise<boolean>;
+                forward(cid: string, mid: string, to_cid: string): Promise<boolean>;
+                edit(cid: string, mid: string, text: string): Promise<boolean>;
+                text(cid: string, text: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                image(cid: string, buffer: Buffer, caption?: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                video(cid: string, buffer: Buffer, caption?: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                audio(cid: string, buffer: Buffer, ptt?: boolean): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                location(cid: string, opts: import("./Message").LocationOptions): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                poll(cid: string, opts: import("./Message").PollOptions): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                watch(cid: string, mid: string, handler: (msg: InstanceType</*elided*/ any>) => void): () => void;
+                notify(cid: string, mid: string): void;
+            }>[]>;
+            refresh(): Promise</*elided*/ any | null>;
+            readonly raw: import("./Chat").IChatRaw;
+            get id(): string;
+            get type(): "contact" | "group";
+            get name(): string;
+            get content(): string;
+            get pined(): boolean;
+            get archived(): boolean;
+            get muted(): number | false;
+            get readed(): boolean;
+            get readonly(): boolean;
+        } | null>;
+        readonly raw: IContactRaw;
+        /** JID único del contacto */
+        get id(): string;
+        /** Nombre del contacto */
+        get name(): string;
+        /** URL de la foto de perfil o null */
+        get photo(): string | null;
+        /** Número de teléfono sin formato */
+        get phone(): string;
+        /** Bio del contacto */
+        get content(): string;
+    } | null>;
+    /**
+     * @description Actualiza los datos del perfil desde WhatsApp.
+     * @param uid JID del contacto.
+     * @returns Contacto actualizado o null.
+     */
+    refresh(uid: string): Promise<{
+        /**
+         * @description Cambia el nombre del contacto.
+         * @param name Nuevo nombre.
+         * @returns true si se guardó correctamente.
+         */
+        rename(name: string): Promise<boolean>;
+        /**
+         * @description Actualiza los datos del perfil desde WhatsApp.
+         * @returns this con datos actualizados, o null si falla.
+         */
+        refresh(): Promise</*elided*/ any | null>;
+        /**
+         * @description Obtiene o crea el chat con este contacto.
+         * @returns Chat asociado al contacto.
+         */
+        chat(): Promise<{
+            messages(offset?: number, limit?: number): Promise<InstanceType<{
+                new (data: import("./Message").IMessage): {
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                };
+                get(cid: string, mid: string): Promise<InstanceType</*elided*/ any> | null>;
+                react(cid: string, mid: string, emoji: string): Promise<boolean>;
+                remove(cid: string, mid: string): Promise<boolean>;
+                forward(cid: string, mid: string, to_cid: string): Promise<boolean>;
+                edit(cid: string, mid: string, text: string): Promise<boolean>;
+                text(cid: string, text: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                image(cid: string, buffer: Buffer, caption?: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                video(cid: string, buffer: Buffer, caption?: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                audio(cid: string, buffer: Buffer, ptt?: boolean): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                location(cid: string, opts: import("./Message").LocationOptions): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                poll(cid: string, opts: import("./Message").PollOptions): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                watch(cid: string, mid: string, handler: (msg: InstanceType</*elided*/ any>) => void): () => void;
+                notify(cid: string, mid: string): void;
+            }>[]>;
+            refresh(): Promise</*elided*/ any | null>;
+            readonly raw: import("./Chat").IChatRaw;
+            get id(): string;
+            get type(): "contact" | "group";
+            get name(): string;
+            get content(): string;
+            get pined(): boolean;
+            get archived(): boolean;
+            get muted(): number | false;
+            get readed(): boolean;
+            get readonly(): boolean;
+        } | null>;
+        readonly raw: IContactRaw;
+        /** JID único del contacto */
+        get id(): string;
+        /** Nombre del contacto */
+        get name(): string;
+        /** URL de la foto de perfil o null */
+        get photo(): string | null;
+        /** Número de teléfono sin formato */
+        get phone(): string;
+        /** Bio del contacto */
+        get content(): string;
+    } | null>;
+    /**
+     * @description Cambia el nombre de un contacto.
+     * @param uid JID del contacto.
+     * @param name Nuevo nombre.
+     * @returns true si se guardó correctamente.
+     */
+    rename(uid: string, name: string): Promise<boolean>;
+    /**
+     * @description Obtiene contactos paginados.
+     * @param offset Inicio de paginación.
+     * @param limit Cantidad máxima de resultados.
+     * @returns Array de contactos.
+     */
+    paginate(offset?: number, limit?: number): Promise<{
+        /**
+         * @description Cambia el nombre del contacto.
+         * @param name Nuevo nombre.
+         * @returns true si se guardó correctamente.
+         */
+        rename(name: string): Promise<boolean>;
+        /**
+         * @description Actualiza los datos del perfil desde WhatsApp.
+         * @returns this con datos actualizados, o null si falla.
+         */
+        refresh(): Promise</*elided*/ any | null>;
+        /**
+         * @description Obtiene o crea el chat con este contacto.
+         * @returns Chat asociado al contacto.
+         */
+        chat(): Promise<{
+            messages(offset?: number, limit?: number): Promise<InstanceType<{
+                new (data: import("./Message").IMessage): {
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                };
+                get(cid: string, mid: string): Promise<InstanceType</*elided*/ any> | null>;
+                react(cid: string, mid: string, emoji: string): Promise<boolean>;
+                remove(cid: string, mid: string): Promise<boolean>;
+                forward(cid: string, mid: string, to_cid: string): Promise<boolean>;
+                edit(cid: string, mid: string, text: string): Promise<boolean>;
+                text(cid: string, text: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                image(cid: string, buffer: Buffer, caption?: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                video(cid: string, buffer: Buffer, caption?: string): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                audio(cid: string, buffer: Buffer, ptt?: boolean): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                location(cid: string, opts: import("./Message").LocationOptions): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                poll(cid: string, opts: import("./Message").PollOptions): Promise<{
+                    stream(): Promise<import("node:stream").Readable>;
+                    content(): Promise<Buffer>;
+                    readonly index: import("./Message").IMessageIndex;
+                    readonly raw: import("baileys").WAMessage;
+                    get id(): string;
+                    get cid(): string;
+                    get mid(): string | null;
+                    get me(): boolean;
+                    get author(): string;
+                    get edited(): boolean;
+                    get type(): import("./Message").MessageType;
+                    get caption(): string;
+                    get mime(): string;
+                    get status(): import("./Message").MESSAGE_STATUS;
+                    get starred(): boolean;
+                    get forwarded(): boolean;
+                    get created_at(): number;
+                    get deleted_at(): number | null;
+                } | null>;
+                watch(cid: string, mid: string, handler: (msg: InstanceType</*elided*/ any>) => void): () => void;
+                notify(cid: string, mid: string): void;
+            }>[]>;
+            refresh(): Promise</*elided*/ any | null>;
+            readonly raw: import("./Chat").IChatRaw;
+            get id(): string;
+            get type(): "contact" | "group";
+            get name(): string;
+            get content(): string;
+            get pined(): boolean;
+            get archived(): boolean;
+            get muted(): number | false;
+            get readed(): boolean;
+            get readonly(): boolean;
+        } | null>;
+        readonly raw: IContactRaw;
+        /** JID único del contacto */
+        get id(): string;
+        /** Nombre del contacto */
+        get name(): string;
+        /** URL de la foto de perfil o null */
+        get photo(): string | null;
+        /** Número de teléfono sin formato */
+        get phone(): string;
+        /** Bio del contacto */
+        get content(): string;
+    }[]>;
+};