@arcaelas/whatsapp 2.2.0 → 3.0.2

package/build/cjs/store/driver/RedisEngine.js

@@ -1,70 +0,0 @@
-"use strict";
-/**
- * @file store/driver/RedisEngine.ts
- * @description Engine de persistencia con Redis
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RedisEngine = void 0;
-/**
- * @description
- * Engine de persistencia con Redis.
- * Recibe una conexión existente de ioredis o redis.
- *
- * Redis persistence engine.
- * Receives an existing ioredis or redis connection.
- *
- * @example
- * import Redis from 'ioredis';
- * const client = new Redis();
- * const engine = new RedisEngine(client, 'wa:5491112345678');
- * await engine.set('contact/123', '{"name":"John"}');
- */
-class RedisEngine {
-    constructor(_client, _prefix = 'wa:default') {
-        this._client = _client;
-        this._prefix = _prefix;
-    }
-    /** @description Obtiene un valor por su key. / Retrieves a value by its key. */
-    async get(key) {
-        return this._client.get(`${this._prefix}:${key}`);
-    }
-    /**
-     * @description Guarda o elimina un valor. Si value es null, elimina la key y todas las sub-keys con ese prefijo.
-     * Saves or deletes a value. If value is null, deletes the key and all sub-keys matching the prefix.
-     */
-    async set(key, value) {
-        const full_key = `${this._prefix}:${key}`;
-        if (value) {
-            await this._client.set(full_key, value);
-        }
-        else {
-            await this._client.del(full_key);
-            const pattern = `${full_key}/*`;
-            let cursor = '0';
-            do {
-                const [next, batch] = await this._client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
-                cursor = next;
-                if (batch.length)
-                    await this._client.del(batch);
-            } while (cursor !== '0');
-        }
-    }
-    /**
-     * @description Lista keys bajo un prefijo.
-     * Lists keys under a prefix.
-     * @note Redis SCAN no garantiza orden. / Redis SCAN does not guarantee order.
-     */
-    async list(prefix, offset = 0, limit = 50) {
-        const pattern = `${this._prefix}:${prefix}*`;
-        const keys = [];
-        let cursor = '0';
-        do {
-            const [next, batch] = await this._client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
-            cursor = next;
-            keys.push(...batch);
-        } while (cursor !== '0' && keys.length < offset + limit + 100);
-        return keys.map((k) => k.slice(this._prefix.length + 1)).slice(offset, offset + limit);
-    }
-}
-exports.RedisEngine = RedisEngine;
-//# sourceMappingURL=RedisEngine.js.map

package/build/cjs/store/driver/RedisEngine.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RedisEngine.js","sourceRoot":"","sources":["../../../../src/store/driver/RedisEngine.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAeH;;;;;;;;;;;;;GAaG;AACH,MAAa,WAAW;IACpB,YAA6B,OAAoB,EAAmB,UAAkB,YAAY;QAArE,YAAO,GAAP,OAAO,CAAa;QAAmB,YAAO,GAAP,OAAO,CAAuB;IAAI,CAAC;IAEvG,gFAAgF;IAChF,KAAK,CAAC,GAAG,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAoB;QACvC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,CAAC;YAChC,IAAI,MAAM,GAAG,GAAG,CAAC;YACjB,GAAG,CAAC;gBACA,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;gBACtF,MAAM,GAAG,IAAI,CAAC;gBACd,IAAI,KAAK,CAAC,MAAM;oBAAE,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACpD,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;QAC7B,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE;QAC7C,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,GAAG,CAAC;QAC7C,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC;YACA,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YACtF,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACxB,CAAC,QAAQ,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,EAAE;QAC/D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;IAC3F,CAAC;CACJ;AA5CD,kCA4CC"}

package/build/cjs/store/engine.d.ts

@@ -1,53 +0,0 @@
-/**
- * @file store/engine.ts
- * @description Interface Engine - contrato para proveedores de persistencia key-value
- */
-/**
- * @description
- * Interface que define el contrato para proveedores de persistencia.
- * Almacena texto (JSON stringified con BufferJSON para binarios).
- *
- * Interface that defines the contract for persistence providers.
- * Stores plain text (JSON stringified with BufferJSON for binaries).
- *
- * @example
- * class CustomEngine implements Engine {
- *   async get(key: string): Promise<string | null> {
- *     return localStorage.getItem(key);
- *   }
- *
- *   async set(key: string, value: string | null): Promise<void> {
- *     if (value === null) localStorage.removeItem(key);
- *     else localStorage.setItem(key, value);
- *   }
- *
- *   async list(prefix: string, offset?: number, limit?: number): Promise<string[]> {
- *     return Object.keys(localStorage).filter(k => k.startsWith(prefix));
- *   }
- * }
- */
-export interface Engine {
-    /**
-     * @description Obtiene un valor por su key.
-     * Retrieves a value by its key.
-     * @param key Ruta del documento (ej: 'creds', 'contact/123@s.whatsapp.net').
-     * @returns Texto JSON o null si no existe.
-     */
-    get(key: string): Promise<string | null>;
-    /**
-     * @description Guarda o elimina un valor. Si value es null, elimina la key y todas las sub-keys recursivamente.
-     * Saves or deletes a value. If value is null, deletes the key and all sub-keys recursively.
-     * @param key Ruta del documento.
-     * @param value Texto a guardar o null para eliminar recursivamente.
-     */
-    set(key: string, value: string | null): Promise<void>;
-    /**
-     * @description Lista keys bajo un prefijo, ordenados por más reciente.
-     * Lists keys under a prefix, ordered by most recent.
-     * @param prefix Prefijo de búsqueda (ej: 'contact/', 'chat/123/message/').
-     * @param offset Inicio de paginación (default: 0).
-     * @param limit Cantidad máxima (default: 50).
-     * @returns Array de keys.
-     */
-    list(prefix: string, offset?: number, limit?: number): Promise<string[]>;
-}

package/build/cjs/store/engine.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * @file store/engine.ts
- * @description Interface Engine - contrato para proveedores de persistencia key-value
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=engine.js.map

package/build/cjs/store/engine.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/store/engine.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/build/cjs/store/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * @file store/index.ts
- * @description Exportaciones del módulo de persistencia
- */
-export { FileEngine } from '../store/driver/FileEngine';
-export { RedisEngine } from '../store/driver/RedisEngine';
-export type { RedisClient } from '../store/driver/RedisEngine';
-export type { Engine } from '../store/engine';

package/build/cjs/store/index.js

@@ -1,12 +0,0 @@
-"use strict";
-/**
- * @file store/index.ts
- * @description Exportaciones del módulo de persistencia
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RedisEngine = exports.FileEngine = void 0;
-var FileEngine_1 = require("../store/driver/FileEngine");
-Object.defineProperty(exports, "FileEngine", { enumerable: true, get: function () { return FileEngine_1.FileEngine; } });
-var RedisEngine_1 = require("../store/driver/RedisEngine");
-Object.defineProperty(exports, "RedisEngine", { enumerable: true, get: function () { return RedisEngine_1.RedisEngine; } });
-//# sourceMappingURL=index.js.map

package/build/cjs/store/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,wDAAuD;AAA9C,wGAAA,UAAU,OAAA;AACnB,0DAAyD;AAAhD,0GAAA,WAAW,OAAA"}

package/build/esm/Chat.d.ts

@@ -1,317 +0,0 @@
-/**
- * @file Chat.ts
- * @description Clase Chat para gestión de conversaciones de WhatsApp
- */
-import type { WhatsApp } from './WhatsApp';
-/**
- * @description Participante de grupo.
- * Group participant.
- */
-export interface IGroupParticipant {
-    /** JID del participante / Participant JID */
-    id: string;
-    /** Rol de admin: null, 'admin', 'superadmin' / Admin role */
-    admin: string | null;
-}
-/**
- * @description Objeto raw del chat (protocolo).
- * Raw chat object (protocol).
- */
-export interface IChatRaw {
-    /** JID único del chat / Unique chat JID */
-    id: string;
-    /** Nombre del chat o grupo / Chat or group name */
-    name?: string | null;
-    /** Nombre alternativo para mostrar / Alternative display name */
-    displayName?: string | null;
-    /** Descripción del grupo / Group description */
-    description?: string | null;
-    /** Cantidad de mensajes no leídos / Unread message count */
-    unreadCount?: number | null;
-    /** Si el chat es de solo lectura / Whether the chat is read-only */
-    readOnly?: boolean | null;
-    /** Si el chat está archivado / Whether the chat is archived */
-    archived?: boolean | null;
-    /** Timestamp cuando se fijó el chat / Pin timestamp */
-    pinned?: number | null;
-    /** Timestamp cuando expira el silencio / Mute end timestamp */
-    muteEndTime?: number | null;
-    /** Si fue marcado manualmente como no leído / Whether manually marked as unread */
-    markedAsUnread?: boolean | null;
-    /** Lista de participantes del grupo / Group participant list */
-    participant?: IGroupParticipant[] | null;
-    /** JID del creador del grupo / Group creator JID */
-    createdBy?: string | null;
-    /** Timestamp de creación / Creation timestamp */
-    createdAt?: number | null;
-    /** Duración de mensajes temporales (segundos) / Ephemeral message duration (seconds) */
-    ephemeralExpiration?: number | null;
-}
-/**
- * @description
- * Clase base para representar una conversación de WhatsApp.
- * Base class representing a WhatsApp conversation.
- */
-export declare class Chat {
-    readonly raw: IChatRaw;
-    constructor(raw: IChatRaw);
-    /** JID único del chat / Unique chat JID */
-    get id(): string;
-    /** Tipo de chat / Chat type */
-    get type(): 'contact' | 'group';
-    /** Nombre del chat / Chat name */
-    get name(): string;
-    /** Descripción del chat/grupo / Chat/group description */
-    get content(): string;
-    /** Si está fijado / Whether it's pinned */
-    get pinned(): boolean;
-    /** Si está archivado / Whether it's archived */
-    get archived(): boolean;
-    /** Timestamp cuando expira el silencio (0 = no silenciado) / Mute end timestamp (0 = not muted) */
-    get muted(): number;
-    /** Si está leído / Whether it's read */
-    get read(): boolean;
-    /** Si es solo lectura / Whether it's read-only */
-    get readonly(): boolean;
-}
-/**
- * @description Factory que retorna la clase Chat enlazada al contexto.
- * Factory that returns the Chat class bound to context.
- * @param wa Instancia de WhatsApp.
- */
-export declare function chat(wa: WhatsApp): {
-    new (raw: IChatRaw): {
-        /**
-         * @description Actualiza los datos del chat desde WhatsApp.
-         * Refreshes chat data from WhatsApp.
-         */
-        refresh(): Promise</*elided*/ any | null>;
-        /**
-         * @description Elimina el chat con cascade delete.
-         * Deletes the chat with cascade delete.
-         */
-        remove(): Promise<boolean>;
-        /**
-         * @description Fija o desfija el chat.
-         * Pins or unpins the chat.
-         */
-        pin(value: boolean): Promise<boolean>;
-        /**
-         * @description Archiva o desarchiva el chat.
-         * Archives or unarchives the chat.
-         */
-        archive(value: boolean): Promise<boolean>;
-        /**
-         * @description Silencia o quita silencio del chat.
-         * Mutes or unmutes the chat.
-         * @param duration Duración en ms (0 o null para quitar silencio) / Duration in ms (0 or null to unmute).
-         */
-        mute(duration: number | null): Promise<boolean>;
-        /**
-         * @description Marca el chat como leído.
-         * Marks the chat as read.
-         */
-        seen(): Promise<boolean>;
-        /**
-         * @description Obtiene los miembros del chat.
-         * Gets chat members.
-         */
-        members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
-        /**
-         * @description Obtiene mensajes del chat (paginados).
-         * Gets chat messages (paginated).
-         */
-        messages(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Message>[]>;
-        /**
-         * @description Obtiene el contacto asociado al chat (solo chats individuales).
-         * Gets the contact associated with the chat (individual chats only).
-         */
-        contact(): Promise<InstanceType<typeof wa.Contact> | null>;
-        readonly raw: IChatRaw;
-        /** JID único del chat / Unique chat JID */
-        get id(): string;
-        /** Tipo de chat / Chat type */
-        get type(): "contact" | "group";
-        /** Nombre del chat / Chat name */
-        get name(): string;
-        /** Descripción del chat/grupo / Chat/group description */
-        get content(): string;
-        /** Si está fijado / Whether it's pinned */
-        get pinned(): boolean;
-        /** Si está archivado / Whether it's archived */
-        get archived(): boolean;
-        /** Timestamp cuando expira el silencio (0 = no silenciado) / Mute end timestamp (0 = not muted) */
-        get muted(): number;
-        /** Si está leído / Whether it's read */
-        get read(): boolean;
-        /** Si es solo lectura / Whether it's read-only */
-        get readonly(): boolean;
-    };
-    /**
-     * @description Obtiene un chat por su ID.
-     * Retrieves a chat by its ID.
-     */
-    get(cid: string): Promise<{
-        /**
-         * @description Actualiza los datos del chat desde WhatsApp.
-         * Refreshes chat data from WhatsApp.
-         */
-        refresh(): Promise</*elided*/ any | null>;
-        /**
-         * @description Elimina el chat con cascade delete.
-         * Deletes the chat with cascade delete.
-         */
-        remove(): Promise<boolean>;
-        /**
-         * @description Fija o desfija el chat.
-         * Pins or unpins the chat.
-         */
-        pin(value: boolean): Promise<boolean>;
-        /**
-         * @description Archiva o desarchiva el chat.
-         * Archives or unarchives the chat.
-         */
-        archive(value: boolean): Promise<boolean>;
-        /**
-         * @description Silencia o quita silencio del chat.
-         * Mutes or unmutes the chat.
-         * @param duration Duración en ms (0 o null para quitar silencio) / Duration in ms (0 or null to unmute).
-         */
-        mute(duration: number | null): Promise<boolean>;
-        /**
-         * @description Marca el chat como leído.
-         * Marks the chat as read.
-         */
-        seen(): Promise<boolean>;
-        /**
-         * @description Obtiene los miembros del chat.
-         * Gets chat members.
-         */
-        members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
-        /**
-         * @description Obtiene mensajes del chat (paginados).
-         * Gets chat messages (paginated).
-         */
-        messages(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Message>[]>;
-        /**
-         * @description Obtiene el contacto asociado al chat (solo chats individuales).
-         * Gets the contact associated with the chat (individual chats only).
-         */
-        contact(): Promise<InstanceType<typeof wa.Contact> | null>;
-        readonly raw: IChatRaw;
-        /** JID único del chat / Unique chat JID */
-        get id(): string;
-        /** Tipo de chat / Chat type */
-        get type(): "contact" | "group";
-        /** Nombre del chat / Chat name */
-        get name(): string;
-        /** Descripción del chat/grupo / Chat/group description */
-        get content(): string;
-        /** Si está fijado / Whether it's pinned */
-        get pinned(): boolean;
-        /** Si está archivado / Whether it's archived */
-        get archived(): boolean;
-        /** Timestamp cuando expira el silencio (0 = no silenciado) / Mute end timestamp (0 = not muted) */
-        get muted(): number;
-        /** Si está leído / Whether it's read */
-        get read(): boolean;
-        /** Si es solo lectura / Whether it's read-only */
-        get readonly(): boolean;
-    } | null>;
-    /**
-     * @description Obtiene chats paginados.
-     * Retrieves paginated chats.
-     */
-    list(offset?: number, limit?: number): Promise<{
-        /**
-         * @description Actualiza los datos del chat desde WhatsApp.
-         * Refreshes chat data from WhatsApp.
-         */
-        refresh(): Promise</*elided*/ any | null>;
-        /**
-         * @description Elimina el chat con cascade delete.
-         * Deletes the chat with cascade delete.
-         */
-        remove(): Promise<boolean>;
-        /**
-         * @description Fija o desfija el chat.
-         * Pins or unpins the chat.
-         */
-        pin(value: boolean): Promise<boolean>;
-        /**
-         * @description Archiva o desarchiva el chat.
-         * Archives or unarchives the chat.
-         */
-        archive(value: boolean): Promise<boolean>;
-        /**
-         * @description Silencia o quita silencio del chat.
-         * Mutes or unmutes the chat.
-         * @param duration Duración en ms (0 o null para quitar silencio) / Duration in ms (0 or null to unmute).
-         */
-        mute(duration: number | null): Promise<boolean>;
-        /**
-         * @description Marca el chat como leído.
-         * Marks the chat as read.
-         */
-        seen(): Promise<boolean>;
-        /**
-         * @description Obtiene los miembros del chat.
-         * Gets chat members.
-         */
-        members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
-        /**
-         * @description Obtiene mensajes del chat (paginados).
-         * Gets chat messages (paginated).
-         */
-        messages(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Message>[]>;
-        /**
-         * @description Obtiene el contacto asociado al chat (solo chats individuales).
-         * Gets the contact associated with the chat (individual chats only).
-         */
-        contact(): Promise<InstanceType<typeof wa.Contact> | null>;
-        readonly raw: IChatRaw;
-        /** JID único del chat / Unique chat JID */
-        get id(): string;
-        /** Tipo de chat / Chat type */
-        get type(): "contact" | "group";
-        /** Nombre del chat / Chat name */
-        get name(): string;
-        /** Descripción del chat/grupo / Chat/group description */
-        get content(): string;
-        /** Si está fijado / Whether it's pinned */
-        get pinned(): boolean;
-        /** Si está archivado / Whether it's archived */
-        get archived(): boolean;
-        /** Timestamp cuando expira el silencio (0 = no silenciado) / Mute end timestamp (0 = not muted) */
-        get muted(): number;
-        /** Si está leído / Whether it's read */
-        get read(): boolean;
-        /** Si es solo lectura / Whether it's read-only */
-        get readonly(): boolean;
-    }[]>;
-    /**
-     * @description Fija o desfija un chat por su ID.
-     * Pins or unpins a chat by its ID.
-     */
-    pin(cid: string, value: boolean): Promise<boolean>;
-    /**
-     * @description Archiva o desarchiva un chat por su ID.
-     * Archives or unarchives a chat by its ID.
-     */
-    archive(cid: string, value: boolean): Promise<boolean>;
-    /**
-     * @description Silencia o quita silencio de un chat por su ID.
-     * Mutes or unmutes a chat by its ID.
-     */
-    mute(cid: string, duration: number | null): Promise<boolean>;
-    /**
-     * @description Marca un chat como leido por su ID.
-     * Marks a chat as read by its ID.
-     */
-    seen(cid: string): Promise<boolean>;
-    /**
-     * @description Elimina un chat por su ID.
-     * Removes a chat by its ID.
-     */
-    remove(cid: string): Promise<boolean>;
-};