@arcaelas/whatsapp 1.2.3 → 2.0.0

package/build/Message.d.ts

@@ -1,580 +0,0 @@
-/**
- * @file Message.ts
- * @description Clase Message para gestión de mensajes de WhatsApp
- */
-import type { WAMessage } from 'baileys';
-import { Readable } from 'node:stream';
-import type { WhatsApp } from './WhatsApp';
-/**
- * @description Tipos de mensaje soportados.
- */
-export type MessageType = 'text' | 'image' | 'video' | 'audio' | 'location' | 'poll';
-/**
- * @description Estados de un mensaje.
- */
-export declare enum MESSAGE_STATUS {
-    /** Error al enviar */
-    ERROR = 0,
-    /** Mensaje pendiente de envío */
-    PENDING = 1,
-    /** Servidor recibió el mensaje */
-    SERVER_ACK = 2,
-    /** Mensaje entregado al destinatario */
-    DELIVERED = 3,
-    /** Mensaje leído por el destinatario */
-    READ = 4,
-    /** Mensaje reproducido (audio/video) */
-    PLAYED = 5
-}
-/**
- * @description Opciones para crear encuesta.
- */
-export interface PollOptions {
-    /** Pregunta o título de la encuesta */
-    content: string;
-    /** Opciones de respuesta */
-    options: Array<{
-        content: string;
-    }>;
-}
-/**
- * @description Opciones para enviar ubicación.
- */
-export interface LocationOptions {
-    /** Latitud en grados */
-    lat: number;
-    /** Longitud en grados */
-    lng: number;
-    /** true para ubicación en tiempo real */
-    live?: boolean;
-}
-/**
- * @description Datos del índice de mensaje (sin content ni raw completo).
- */
-export interface IMessageIndex {
-    /** ID único del mensaje */
-    id: string;
-    /** ID del chat */
-    cid: string;
-    /** ID del mensaje padre (reply) */
-    mid: string | null;
-    /** Si el mensaje es propio */
-    me: boolean;
-    /** Tipo de mensaje */
-    type: MessageType;
-    /** Autor del mensaje */
-    author: string;
-    /** Estado de entrega */
-    status: MESSAGE_STATUS;
-    /** Si está destacado */
-    starred: boolean;
-    /** Si fue reenviado */
-    forwarded: boolean;
-    /** Timestamp de creación (ms) */
-    created_at: number;
-    /** Timestamp de expiración (ms) o null */
-    deleted_at: number | null;
-    /** Tipo MIME */
-    mime: string;
-    /** Caption del mensaje */
-    caption: string;
-    /** true si fue editado */
-    edited: boolean;
-}
-/**
- * @description Datos completos del mensaje.
- */
-export interface IMessage {
-    /** Índice del mensaje */
-    index: IMessageIndex;
-    /** WAMessage raw del protocolo */
-    raw: WAMessage;
-}
-/**
- * @description Mapeo de tipos de contenido de Baileys a MessageType.
- */
-export declare const MESSAGE_TYPE_MAP: Record<string, MessageType>;
-/**
- * @description Construye IMessageIndex desde WAMessage.
- * @param raw WAMessage del protocolo.
- * @param edited Si el mensaje fue editado.
- * @returns IMessageIndex normalizado.
- */
-export declare function build_message_index(raw: WAMessage, edited?: boolean): IMessageIndex;
-/**
- * @description
- * Clase base para representar un mensaje de WhatsApp.
- * Expone getters sobre el índice, raw accesible para operaciones avanzadas.
- */
-export declare class Message {
-    /** Índice del mensaje */
-    readonly index: IMessageIndex;
-    /** WAMessage raw del protocolo */
-    readonly raw: WAMessage;
-    constructor(data: IMessage);
-    /** ID único del mensaje */
-    get id(): string;
-    /** JID del chat al que pertenece */
-    get cid(): string;
-    /** ID del mensaje padre (reply) */
-    get mid(): string | null;
-    /** true si el mensaje fue enviado por el usuario autenticado */
-    get me(): boolean;
-    /** Autor del mensaje */
-    get author(): string;
-    /** true si el mensaje fue editado */
-    get edited(): boolean;
-    /** Tipo de contenido del mensaje */
-    get type(): MessageType;
-    /** Texto o caption del mensaje */
-    get caption(): string;
-    /** Tipo MIME del contenido */
-    get mime(): string;
-    /** Estado del mensaje */
-    get status(): MESSAGE_STATUS;
-    /** true si el mensaje está destacado */
-    get starred(): boolean;
-    /** true si el mensaje fue reenviado */
-    get forwarded(): boolean;
-    /** Timestamp de creación (ms) */
-    get created_at(): number;
-    /** Timestamp de expiración (ms) o null */
-    get deleted_at(): number | null;
-    /**
-     * @description Obtiene el contenido como Readable stream.
-     * @returns Readable stream (vacío en clase base).
-     */
-    stream(): Promise<Readable>;
-    /**
-     * @description Obtiene el contenido del mensaje como Buffer.
-     * @returns Buffer con el contenido (vacío en clase base).
-     */
-    content(): Promise<Buffer>;
-}
-/**
- * @description Factory que retorna la clase Message enlazada al contexto.
- * @param wa Instancia de WhatsApp.
- * @returns Clase _Message que extiende Message.
- */
-export declare function message(wa: WhatsApp): {
-    new (data: IMessage): {
-        /**
-         * @description Obtiene el contenido como Readable stream.
-         * Para media (image/video/audio) retorna stream directo de Baileys sin cargar en memoria.
-         * Para text/location/poll retorna stream desde buffer pequeño.
-         * @returns Readable stream con el contenido.
-         */
-        stream(): Promise<Readable>;
-        /**
-         * @description Obtiene el contenido del mensaje como Buffer.
-         * Usa stream() internamente y cachea el resultado en el engine.
-         * @returns Buffer con el contenido.
-         */
-        content(): Promise<Buffer>;
-        /** Índice del mensaje */
-        readonly index: IMessageIndex;
-        /** WAMessage raw del protocolo */
-        readonly raw: WAMessage;
-        /** ID único del mensaje */
-        get id(): string;
-        /** JID del chat al que pertenece */
-        get cid(): string;
-        /** ID del mensaje padre (reply) */
-        get mid(): string | null;
-        /** true si el mensaje fue enviado por el usuario autenticado */
-        get me(): boolean;
-        /** Autor del mensaje */
-        get author(): string;
-        /** true si el mensaje fue editado */
-        get edited(): boolean;
-        /** Tipo de contenido del mensaje */
-        get type(): MessageType;
-        /** Texto o caption del mensaje */
-        get caption(): string;
-        /** Tipo MIME del contenido */
-        get mime(): string;
-        /** Estado del mensaje */
-        get status(): MESSAGE_STATUS;
-        /** true si el mensaje está destacado */
-        get starred(): boolean;
-        /** true si el mensaje fue reenviado */
-        get forwarded(): boolean;
-        /** Timestamp de creación (ms) */
-        get created_at(): number;
-        /** Timestamp de expiración (ms) o null */
-        get deleted_at(): number | null;
-    };
-    /**
-     * @description Obtiene un mensaje por CID y MID.
-     * @param cid ID del chat.
-     * @param mid ID del mensaje.
-     * @returns Mensaje o null si no existe.
-     */
-    get(cid: string, mid: string): Promise<InstanceType</*elided*/ any> | null>;
-    /**
-     * @description Reacciona a un mensaje.
-     * @param cid ID del chat.
-     * @param mid ID del mensaje.
-     * @param emoji Emoji de reacción (vacío para quitar).
-     * @returns true si se envió correctamente.
-     */
-    react(cid: string, mid: string, emoji: string): Promise<boolean>;
-    /**
-     * @description Elimina un mensaje para todos.
-     * @param cid ID del chat.
-     * @param mid ID del mensaje.
-     * @returns true si se eliminó correctamente.
-     */
-    remove(cid: string, mid: string): Promise<boolean>;
-    /**
-     * @description Reenvía un mensaje a otro chat.
-     * @param cid ID del chat origen.
-     * @param mid ID del mensaje.
-     * @param to_cid ID del chat destino.
-     * @returns true si se reenvió correctamente.
-     */
-    forward(cid: string, mid: string, to_cid: string): Promise<boolean>;
-    /**
-     * @description Edita un mensaje (solo texto o caption).
-     * @param cid ID del chat.
-     * @param mid ID del mensaje.
-     * @param text Nuevo contenido.
-     * @returns true si se editó correctamente.
-     */
-    edit(cid: string, mid: string, text: string): Promise<boolean>;
-    /**
-     * @description Envía un mensaje de texto.
-     * @param cid ID del chat destino.
-     * @param text Contenido del mensaje.
-     * @returns Mensaje enviado o null.
-     */
-    text(cid: string, text: string): Promise<{
-        /**
-         * @description Obtiene el contenido como Readable stream.
-         * Para media (image/video/audio) retorna stream directo de Baileys sin cargar en memoria.
-         * Para text/location/poll retorna stream desde buffer pequeño.
-         * @returns Readable stream con el contenido.
-         */
-        stream(): Promise<Readable>;
-        /**
-         * @description Obtiene el contenido del mensaje como Buffer.
-         * Usa stream() internamente y cachea el resultado en el engine.
-         * @returns Buffer con el contenido.
-         */
-        content(): Promise<Buffer>;
-        /** Índice del mensaje */
-        readonly index: IMessageIndex;
-        /** WAMessage raw del protocolo */
-        readonly raw: WAMessage;
-        /** ID único del mensaje */
-        get id(): string;
-        /** JID del chat al que pertenece */
-        get cid(): string;
-        /** ID del mensaje padre (reply) */
-        get mid(): string | null;
-        /** true si el mensaje fue enviado por el usuario autenticado */
-        get me(): boolean;
-        /** Autor del mensaje */
-        get author(): string;
-        /** true si el mensaje fue editado */
-        get edited(): boolean;
-        /** Tipo de contenido del mensaje */
-        get type(): MessageType;
-        /** Texto o caption del mensaje */
-        get caption(): string;
-        /** Tipo MIME del contenido */
-        get mime(): string;
-        /** Estado del mensaje */
-        get status(): MESSAGE_STATUS;
-        /** true si el mensaje está destacado */
-        get starred(): boolean;
-        /** true si el mensaje fue reenviado */
-        get forwarded(): boolean;
-        /** Timestamp de creación (ms) */
-        get created_at(): number;
-        /** Timestamp de expiración (ms) o null */
-        get deleted_at(): number | null;
-    } | null>;
-    /**
-     * @description Envía una imagen.
-     * @param cid ID del chat destino.
-     * @param buffer Buffer de la imagen.
-     * @param caption Caption opcional.
-     * @returns Mensaje enviado o null.
-     */
-    image(cid: string, buffer: Buffer, caption?: string): Promise<{
-        /**
-         * @description Obtiene el contenido como Readable stream.
-         * Para media (image/video/audio) retorna stream directo de Baileys sin cargar en memoria.
-         * Para text/location/poll retorna stream desde buffer pequeño.
-         * @returns Readable stream con el contenido.
-         */
-        stream(): Promise<Readable>;
-        /**
-         * @description Obtiene el contenido del mensaje como Buffer.
-         * Usa stream() internamente y cachea el resultado en el engine.
-         * @returns Buffer con el contenido.
-         */
-        content(): Promise<Buffer>;
-        /** Índice del mensaje */
-        readonly index: IMessageIndex;
-        /** WAMessage raw del protocolo */
-        readonly raw: WAMessage;
-        /** ID único del mensaje */
-        get id(): string;
-        /** JID del chat al que pertenece */
-        get cid(): string;
-        /** ID del mensaje padre (reply) */
-        get mid(): string | null;
-        /** true si el mensaje fue enviado por el usuario autenticado */
-        get me(): boolean;
-        /** Autor del mensaje */
-        get author(): string;
-        /** true si el mensaje fue editado */
-        get edited(): boolean;
-        /** Tipo de contenido del mensaje */
-        get type(): MessageType;
-        /** Texto o caption del mensaje */
-        get caption(): string;
-        /** Tipo MIME del contenido */
-        get mime(): string;
-        /** Estado del mensaje */
-        get status(): MESSAGE_STATUS;
-        /** true si el mensaje está destacado */
-        get starred(): boolean;
-        /** true si el mensaje fue reenviado */
-        get forwarded(): boolean;
-        /** Timestamp de creación (ms) */
-        get created_at(): number;
-        /** Timestamp de expiración (ms) o null */
-        get deleted_at(): number | null;
-    } | null>;
-    /**
-     * @description Envía un video.
-     * @param cid ID del chat destino.
-     * @param buffer Buffer del video.
-     * @param caption Caption opcional.
-     * @returns Mensaje enviado o null.
-     */
-    video(cid: string, buffer: Buffer, caption?: string): Promise<{
-        /**
-         * @description Obtiene el contenido como Readable stream.
-         * Para media (image/video/audio) retorna stream directo de Baileys sin cargar en memoria.
-         * Para text/location/poll retorna stream desde buffer pequeño.
-         * @returns Readable stream con el contenido.
-         */
-        stream(): Promise<Readable>;
-        /**
-         * @description Obtiene el contenido del mensaje como Buffer.
-         * Usa stream() internamente y cachea el resultado en el engine.
-         * @returns Buffer con el contenido.
-         */
-        content(): Promise<Buffer>;
-        /** Índice del mensaje */
-        readonly index: IMessageIndex;
-        /** WAMessage raw del protocolo */
-        readonly raw: WAMessage;
-        /** ID único del mensaje */
-        get id(): string;
-        /** JID del chat al que pertenece */
-        get cid(): string;
-        /** ID del mensaje padre (reply) */
-        get mid(): string | null;
-        /** true si el mensaje fue enviado por el usuario autenticado */
-        get me(): boolean;
-        /** Autor del mensaje */
-        get author(): string;
-        /** true si el mensaje fue editado */
-        get edited(): boolean;
-        /** Tipo de contenido del mensaje */
-        get type(): MessageType;
-        /** Texto o caption del mensaje */
-        get caption(): string;
-        /** Tipo MIME del contenido */
-        get mime(): string;
-        /** Estado del mensaje */
-        get status(): MESSAGE_STATUS;
-        /** true si el mensaje está destacado */
-        get starred(): boolean;
-        /** true si el mensaje fue reenviado */
-        get forwarded(): boolean;
-        /** Timestamp de creación (ms) */
-        get created_at(): number;
-        /** Timestamp de expiración (ms) o null */
-        get deleted_at(): number | null;
-    } | null>;
-    /**
-     * @description Envía un audio.
-     * @param cid ID del chat destino.
-     * @param buffer Buffer del audio.
-     * @param ptt true para nota de voz (default true).
-     * @returns Mensaje enviado o null.
-     */
-    audio(cid: string, buffer: Buffer, ptt?: boolean): Promise<{
-        /**
-         * @description Obtiene el contenido como Readable stream.
-         * Para media (image/video/audio) retorna stream directo de Baileys sin cargar en memoria.
-         * Para text/location/poll retorna stream desde buffer pequeño.
-         * @returns Readable stream con el contenido.
-         */
-        stream(): Promise<Readable>;
-        /**
-         * @description Obtiene el contenido del mensaje como Buffer.
-         * Usa stream() internamente y cachea el resultado en el engine.
-         * @returns Buffer con el contenido.
-         */
-        content(): Promise<Buffer>;
-        /** Índice del mensaje */
-        readonly index: IMessageIndex;
-        /** WAMessage raw del protocolo */
-        readonly raw: WAMessage;
-        /** ID único del mensaje */
-        get id(): string;
-        /** JID del chat al que pertenece */
-        get cid(): string;
-        /** ID del mensaje padre (reply) */
-        get mid(): string | null;
-        /** true si el mensaje fue enviado por el usuario autenticado */
-        get me(): boolean;
-        /** Autor del mensaje */
-        get author(): string;
-        /** true si el mensaje fue editado */
-        get edited(): boolean;
-        /** Tipo de contenido del mensaje */
-        get type(): MessageType;
-        /** Texto o caption del mensaje */
-        get caption(): string;
-        /** Tipo MIME del contenido */
-        get mime(): string;
-        /** Estado del mensaje */
-        get status(): MESSAGE_STATUS;
-        /** true si el mensaje está destacado */
-        get starred(): boolean;
-        /** true si el mensaje fue reenviado */
-        get forwarded(): boolean;
-        /** Timestamp de creación (ms) */
-        get created_at(): number;
-        /** Timestamp de expiración (ms) o null */
-        get deleted_at(): number | null;
-    } | null>;
-    /**
-     * @description Envía una ubicación.
-     * @param cid ID del chat destino.
-     * @param opts Opciones de ubicación (lat, lng, live).
-     * @returns Mensaje enviado o null.
-     */
-    location(cid: string, opts: LocationOptions): Promise<{
-        /**
-         * @description Obtiene el contenido como Readable stream.
-         * Para media (image/video/audio) retorna stream directo de Baileys sin cargar en memoria.
-         * Para text/location/poll retorna stream desde buffer pequeño.
-         * @returns Readable stream con el contenido.
-         */
-        stream(): Promise<Readable>;
-        /**
-         * @description Obtiene el contenido del mensaje como Buffer.
-         * Usa stream() internamente y cachea el resultado en el engine.
-         * @returns Buffer con el contenido.
-         */
-        content(): Promise<Buffer>;
-        /** Índice del mensaje */
-        readonly index: IMessageIndex;
-        /** WAMessage raw del protocolo */
-        readonly raw: WAMessage;
-        /** ID único del mensaje */
-        get id(): string;
-        /** JID del chat al que pertenece */
-        get cid(): string;
-        /** ID del mensaje padre (reply) */
-        get mid(): string | null;
-        /** true si el mensaje fue enviado por el usuario autenticado */
-        get me(): boolean;
-        /** Autor del mensaje */
-        get author(): string;
-        /** true si el mensaje fue editado */
-        get edited(): boolean;
-        /** Tipo de contenido del mensaje */
-        get type(): MessageType;
-        /** Texto o caption del mensaje */
-        get caption(): string;
-        /** Tipo MIME del contenido */
-        get mime(): string;
-        /** Estado del mensaje */
-        get status(): MESSAGE_STATUS;
-        /** true si el mensaje está destacado */
-        get starred(): boolean;
-        /** true si el mensaje fue reenviado */
-        get forwarded(): boolean;
-        /** Timestamp de creación (ms) */
-        get created_at(): number;
-        /** Timestamp de expiración (ms) o null */
-        get deleted_at(): number | null;
-    } | null>;
-    /**
-     * @description Envía una encuesta.
-     * @param cid ID del chat destino.
-     * @param opts Opciones de encuesta (content, options).
-     * @returns Mensaje enviado o null.
-     */
-    poll(cid: string, opts: PollOptions): Promise<{
-        /**
-         * @description Obtiene el contenido como Readable stream.
-         * Para media (image/video/audio) retorna stream directo de Baileys sin cargar en memoria.
-         * Para text/location/poll retorna stream desde buffer pequeño.
-         * @returns Readable stream con el contenido.
-         */
-        stream(): Promise<Readable>;
-        /**
-         * @description Obtiene el contenido del mensaje como Buffer.
-         * Usa stream() internamente y cachea el resultado en el engine.
-         * @returns Buffer con el contenido.
-         */
-        content(): Promise<Buffer>;
-        /** Índice del mensaje */
-        readonly index: IMessageIndex;
-        /** WAMessage raw del protocolo */
-        readonly raw: WAMessage;
-        /** ID único del mensaje */
-        get id(): string;
-        /** JID del chat al que pertenece */
-        get cid(): string;
-        /** ID del mensaje padre (reply) */
-        get mid(): string | null;
-        /** true si el mensaje fue enviado por el usuario autenticado */
-        get me(): boolean;
-        /** Autor del mensaje */
-        get author(): string;
-        /** true si el mensaje fue editado */
-        get edited(): boolean;
-        /** Tipo de contenido del mensaje */
-        get type(): MessageType;
-        /** Texto o caption del mensaje */
-        get caption(): string;
-        /** Tipo MIME del contenido */
-        get mime(): string;
-        /** Estado del mensaje */
-        get status(): MESSAGE_STATUS;
-        /** true si el mensaje está destacado */
-        get starred(): boolean;
-        /** true si el mensaje fue reenviado */
-        get forwarded(): boolean;
-        /** Timestamp de creación (ms) */
-        get created_at(): number;
-        /** Timestamp de expiración (ms) o null */
-        get deleted_at(): number | null;
-    } | null>;
-    /**
-     * @description Observa cambios en un mensaje específico.
-     * @param cid ID del chat.
-     * @param mid ID del mensaje.
-     * @param handler Callback con el mensaje actualizado.
-     * @returns Función para dejar de observar.
-     */
-    watch(cid: string, mid: string, handler: (msg: InstanceType</*elided*/ any>) => void): () => void;
-    /**
-     * @description Notifica a los watchers de un mensaje.
-     * @param cid ID del chat.
-     * @param mid ID del mensaje.
-     */
-    notify(cid: string, mid: string): void;
-};