@arcaelas/whatsapp 3.0.2 → 3.1.1

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

@@ -1,179 +0,0 @@
-/**
- * @file whatsapp/index.ts
- * @description Orquestador principal del cliente WhatsApp v3.
- * Main orchestrator of the WhatsApp v3 client.
- */
-import { type WASocket } from 'baileys';
-import { chat } from '../../lib/chat/index.js';
-import { contact } from '../../lib/contact/index.js';
-import { message, Message } from '../../lib/message/index.js';
-import { type Engine } from '../../lib/store/index.js';
-/**
- * Opciones del cliente WhatsApp.
- * WhatsApp client options.
- */
-/**
- * Configuración de reconexión automática tras cierres no-loggedOut.
- * - `true` (default): reintenta indefinidamente con 60s de intervalo.
- * - `false`: no reconecta.
- * - `number`: máximo N reintentos con 60s de intervalo.
- * - `{ max, interval }`: control explícito (interval en segundos).
- *
- * Automatic reconnection config for non-loggedOut closes.
- */
-export type ReconnectOption = boolean | number | {
-    max?: number;
-    interval?: number;
-};
-export interface IWhatsApp {
-    /** Motor de almacenamiento. / Storage engine. */
-    engine: Engine;
-    /** Teléfono para emparejamiento por PIN. Si falta, se usa QR. / Phone for PIN pairing; QR otherwise. */
-    phone?: number | string;
-    /**
-     * Si al recibir `loggedOut` debe limpiar todo el engine (default: `true`).
-     * Si es `false`, solo elimina `/session/creds` y preserva historial.
-     *
-     * Whether to clear the entire engine on `loggedOut` (default: `true`).
-     */
-    autoclean?: boolean;
-    /** Reconexión automática tras cierres no-loggedOut. Default: `true`. / Auto-reconnect on non-loggedOut closes. */
-    reconnect?: ReconnectOption;
-    /** Sincroniza historial completo desde el móvil (default: `false`). / Sync full history from phone. */
-    sync?: boolean;
-}
-/**
- * Opciones de desconexión.
- * Disconnect options.
- */
-export interface DisconnectOptions {
-    /** No emitir evento de cierre. / Suppress close emission. */
-    silent?: boolean;
-    /** Vaciar el engine tras cerrar. / Clear the engine after closing. */
-    destroy?: boolean;
-}
-type MessageInstance = Message;
-type ChatInstance = InstanceType<ReturnType<typeof chat>>;
-type ContactInstance = InstanceType<ReturnType<typeof contact>>;
-/**
- * Mapa de eventos emitidos por el cliente. Cada listener recibe el artefacto principal seguido
- * de la instancia del cliente como último argumento.
- * Map of events emitted by the client. Each listener receives the primary payload followed by
- * the client instance as the last argument.
- */
-interface WhatsAppEventMap {
-    connected: [WhatsApp];
-    disconnected: [WhatsApp];
-    'contact:created': [ContactInstance, ChatInstance, WhatsApp];
-    'contact:updated': [ContactInstance, ChatInstance, WhatsApp];
-    'contact:deleted': [ContactInstance, ChatInstance, WhatsApp];
-    'chat:created': [ChatInstance, WhatsApp];
-    'chat:deleted': [ChatInstance, WhatsApp];
-    'chat:pinned': [ChatInstance, WhatsApp];
-    'chat:unpinned': [ChatInstance, WhatsApp];
-    'chat:archived': [ChatInstance, WhatsApp];
-    'chat:unarchived': [ChatInstance, WhatsApp];
-    'chat:muted': [ChatInstance, WhatsApp];
-    'chat:unmuted': [ChatInstance, WhatsApp];
-    'message:created': [MessageInstance, ChatInstance, WhatsApp];
-    'message:updated': [MessageInstance, ChatInstance, WhatsApp];
-    'message:deleted': [MessageInstance, ChatInstance, WhatsApp];
-    'message:reacted': [MessageInstance, ChatInstance, string, WhatsApp];
-    'message:starred': [MessageInstance, ChatInstance, WhatsApp];
-    'message:unstarred': [MessageInstance, ChatInstance, WhatsApp];
-    'message:forwarded': [MessageInstance, ChatInstance, WhatsApp];
-    'message:seen': [MessageInstance, ChatInstance, WhatsApp];
-}
-/**
- * Cliente principal de WhatsApp. No inicia la conexión al instanciar.
- * Main WhatsApp client. Does not connect on instantiation.
- *
- * @example
- * const wa = new WhatsApp({ engine: new FileSystemEngine(__dirname), phone: 584144709840 });
- * wa.on('message:created', (msg) => console.log(msg.caption));
- * await wa.connect((code) => console.log(code));
- */
-export declare class WhatsApp {
-    private readonly _phone?;
-    private readonly _event;
-    private readonly _autoclean;
-    private readonly _reconnect;
-    private readonly _sync;
-    /** @internal */
-    _socket: WASocket | null;
-    private _intentional_close;
-    private _has_connected;
-    private _retry_timer;
-    private _retry_count;
-    readonly engine: Engine;
-    readonly Contact: ReturnType<typeof contact>;
-    readonly Chat: ReturnType<typeof chat>;
-    readonly Message: ReturnType<typeof message>;
-    constructor(options: IWhatsApp);
-    /** @internal */
-    private _parse_reconnect;
-    /**
-     * Registra un listener de evento. Retorna función para desuscribirse.
-     * Registers an event listener. Returns an unsubscribe function.
-     */
-    on<E extends keyof WhatsAppEventMap>(event: E, handler: (...args: WhatsAppEventMap[E]) => void): () => void;
-    /**
-     * Quita un listener previamente registrado.
-     * Removes a previously registered listener.
-     */
-    off<E extends keyof WhatsAppEventMap>(event: E, handler: (...args: WhatsAppEventMap[E]) => void): this;
-    /**
-     * Registra un listener one-shot. Retorna función para desuscribirse antes de que dispare.
-     * Registers a one-shot listener. Returns an unsubscribe function.
-     */
-    once<E extends keyof WhatsAppEventMap>(event: E, handler: (...args: WhatsAppEventMap[E]) => void): () => void;
-    /**
-     * @internal
-     * Normaliza cualquier identificador (JID, LID, número, etc.) a JID canónico.
-     * Uso interno de la librería — no forma parte de la API pública.
-     */
-    _resolve_jid(uid: string): Promise<string | null>;
-    /**
-     * Inicia la conexión. El callback recibe el PIN (string) si se configuró `phone`, o el QR (Buffer PNG) si no.
-     * Resuelve cuando la sesión sincroniza; reintenta automáticamente en cierres no-loggedOut.
-     *
-     * Starts the connection. Callback receives the PIN (string) when `phone` is configured, or the QR (PNG Buffer) otherwise.
-     * Resolves once the session is synced; retries on non-loggedOut disconnects.
-     */
-    connect(callback: (auth: string | Buffer) => void | Promise<void>): Promise<void>;
-    /**
-     * Cierra la conexión. Con `destroy: true` vacía el engine completo.
-     * Closes the connection. With `destroy: true` clears the engine entirely.
-     */
-    disconnect(options?: DisconnectOptions): Promise<void>;
-    /**
-     * Conecta los handlers de eventos de baileys: contactos, chats y mensajes.
-     * Wires baileys event handlers: contacts, chats and messages.
-     *
-     * @internal
-     */
-    private _attach_business_handlers;
-    /** @internal */
-    private _handle_contacts_upsert;
-    /** @internal */
-    private _handle_contacts_update;
-    /** @internal */
-    private _handle_lid_mapping;
-    /** @internal */
-    private _handle_chats_upsert;
-    /** @internal */
-    private _handle_chats_update;
-    /** @internal */
-    private _handle_chats_delete;
-    /** @internal */
-    private _handle_contacts_delete;
-    /** @internal */
-    private _handle_message_receipt;
-    /** @internal */
-    private _handle_messages_upsert;
-    /** @internal */
-    private _handle_messages_update;
-    /** @internal */
-    private _handle_messages_reaction;
-}
-export default WhatsApp;