@arcaelas/whatsapp 2.2.0 → 3.0.2

package/build/esm/lib/bot/decorators.js

@@ -0,0 +1,242 @@
+/**
+ * @file playground/bot/decorators.ts
+ * @description Decoradores públicos del bot.
+ * Public bot decorators.
+ */
+import { WhatsAppBot, decorator, HANDLERS, register_workflow_step, } from './decorator.js';
+/**
+ * Registra el método como listener del evento indicado. Apilable: varios `@on`
+ * sobre el mismo método crean múltiples suscripciones.
+ * Registers the method as a listener of the given event. Stackable: several
+ * `@on` on the same method produce multiple subscriptions.
+ *
+ * @param event - Nombre del evento del cliente / Client event name
+ */
+export const on = decorator((_meta, h, [event]) => {
+    if (!h.events.includes(event)) {
+        h.events.push(event);
+    }
+});
+/**
+ * Pre-chequeo del handler. Los guards se acumulan y se evalúan en orden con AND.
+ * Si el método no tiene `@on` explícito, se auto-registra a `message:created`.
+ * Handler pre-check. Guards accumulate and run in order with AND semantics.
+ * If the method has no explicit `@on`, it auto-registers to `message:created`.
+ *
+ * @param pred - Predicate que recibe los argumentos del evento / Predicate receiving the event arguments
+ */
+export const guard = decorator((_meta, h, [pred]) => {
+    h.guards.push(pred);
+});
+/**
+ * Marca el handler para ejecutarse una sola vez y luego auto-desuscribirse.
+ * Con `event` actúa como shortcut de `@on(event) + @once()`.
+ * Marks the handler to run once and then auto-unsubscribe. With `event` it acts
+ * as a shortcut of `@on(event) + @once()`.
+ *
+ * @param event - Evento opcional para combinar `@on + @once` en un solo decorador / Optional event to combine `@on + @once` in a single decorator
+ */
+export function once(event) {
+    return (_value, context) => {
+        if (context.kind !== 'method') {
+            throw new Error('@once only applicable to methods');
+        }
+        const metadata = context.metadata;
+        if (!metadata[HANDLERS]) {
+            metadata[HANDLERS] = { handlers: {}, workflows: {} };
+        }
+        const schema = metadata[HANDLERS];
+        const method_name = String(context.name);
+        schema.handlers[method_name] ||= {
+            method: method_name,
+            events: [],
+            guards: [],
+            transforms: [],
+            once: false,
+        };
+        schema.handlers[method_name].once = true;
+        if (event && !schema.handlers[method_name].events.includes(event)) {
+            schema.handlers[method_name].events.push(event);
+        }
+    };
+}
+/**
+ * Alias semántico de `@on('connected')`. El método se invoca al establecerse
+ * la conexión con WhatsApp.
+ * Semantic alias of `@on('connected')`. The method runs when the WhatsApp
+ * connection opens.
+ */
+export function connect() {
+    return on('connected');
+}
+/**
+ * Alias semántico de `@on('disconnected')`. El método se invoca al cerrarse
+ * la conexión con WhatsApp.
+ * Semantic alias of `@on('disconnected')`. The method runs when the WhatsApp
+ * connection closes.
+ */
+export function disconnect() {
+    return on('disconnected');
+}
+/**
+ * Ejecuta el método cada `ms` milisegundos mientras el bot esté conectado.
+ * Los timers arrancan en `connected` y se cancelan en `disconnected`.
+ * Runs the method every `ms` milliseconds while the bot is connected. Timers
+ * start on `connected` and are cancelled on `disconnected`.
+ *
+ * @param ms - Intervalo en milisegundos / Interval in milliseconds
+ */
+export function every(ms) {
+    return decorator((_meta, h) => {
+        h.events.push(`__every:${ms}`);
+    })();
+}
+/**
+ * Marca el método como callback de pairing (PIN/QR). Múltiples métodos `@pair`
+ * se invocan en paralelo cuando baileys entrega el código.
+ * Marks the method as a pairing (PIN/QR) callback. Multiple `@pair` methods run
+ * in parallel when baileys delivers the code.
+ */
+export const pair = decorator((_meta, h) => {
+    if (!h.events.includes('__pair')) {
+        h.events.push('__pair');
+    }
+});
+/**
+ * Filtra por autor del mensaje. Acepta JID, LID o teléfono numérico; el string
+ * se normaliza vía `wa._resolve_jid` con cache lazy. Un array produce match OR.
+ * Filters by message author. Accepts JID, LID or numeric phone; the string is
+ * normalized via `wa._resolve_jid` with lazy cache. An array yields OR matching.
+ *
+ * @param source - Identificador(es) permitidos o predicate sobre `msg.from` / Allowed identifier(s) or predicate on `msg.from`
+ */
+export function from(source) {
+    return decorator((_meta, h) => {
+        if (typeof source === 'function') {
+            h.guards.push((...args) => source(args[0].from));
+        }
+        else {
+            const list = Array.isArray(source) ? source : [source];
+            let resolved = null;
+            h.guards.push(async (...args) => {
+                const msg = args[0];
+                const wa = args[args.length - 1];
+                if (resolved === null) {
+                    resolved = new Set();
+                    for (const raw of list) {
+                        const r = await wa._resolve_jid(raw);
+                        if (r) {
+                            resolved.add(r);
+                        }
+                    }
+                }
+                return resolved.has(msg.from);
+            });
+        }
+    })();
+}
+/**
+ * Class decorator que convierte la clase en un bot WhatsApp con opciones default.
+ * La clase no necesita extender `WhatsAppBot` manualmente; el decorador produce
+ * una subclase que hereda de `WhatsAppBot` y copia los métodos + metadata del
+ * target. El constructor acepta un override parcial que se fusiona con las opts
+ * por default.
+ * Class decorator that turns the class into a WhatsApp bot with default options.
+ * The class does not need to extend `WhatsAppBot` manually; the decorator
+ * produces a subclass that inherits from `WhatsAppBot` and copies the target's
+ * methods and metadata. The constructor accepts a partial override that is
+ * merged with the default options.
+ *
+ * @param default_options - Opciones base para la instancia / Default options for the instance
+ */
+export function Bot(default_options) {
+    return function (target, _context) {
+        const Mixed = class extends WhatsAppBot {
+            constructor(override) {
+                super({ ...default_options, ...(override ?? {}) });
+            }
+        };
+        for (const key of Object.getOwnPropertyNames(target.prototype)) {
+            if (key !== 'constructor') {
+                const desc = Object.getOwnPropertyDescriptor(target.prototype, key);
+                if (desc) {
+                    Object.defineProperty(Mixed.prototype, key, desc);
+                }
+            }
+        }
+        const meta = target[Symbol.metadata];
+        if (meta !== undefined) {
+            Object.defineProperty(Mixed, Symbol.metadata, {
+                value: meta,
+                enumerable: true,
+                configurable: true,
+                writable: true,
+            });
+        }
+        return Mixed;
+    };
+}
+/**
+ * Registra el método como paso de un workflow. Todos los steps del mismo
+ * `workflow` se ejecutan secuencialmente al recibir `message:created`, ordenados
+ * por `index`. Comparten los mismos argumentos (msg, chat, wa), por lo que las
+ * mutaciones sobre esos objetos son visibles en los steps posteriores.
+ * Registers the method as a step of a workflow. All steps of the same
+ * `workflow` run sequentially on `message:created`, ordered by `index`. They
+ * share the same arguments (msg, chat, wa), so mutations on those objects are
+ * visible to later steps.
+ *
+ * @param workflow - Nombre del workflow / Workflow name
+ * @param index - Posición dentro del workflow (ASC) / Position within the workflow (ASC)
+ */
+export function pipe(workflow, index) {
+    return (_value, context) => {
+        if (context.kind !== 'method') {
+            throw new Error('@pipe only applicable to methods');
+        }
+        const metadata = context.metadata;
+        register_workflow_step(metadata, workflow, {
+            index,
+            method: String(context.name),
+        });
+    };
+}
+/**
+ * Registra el método como comando textual. Internamente aplica
+ * `@on('message:created')`, un guard que matchea el `pattern` y un transform
+ * que pasa `(msg, chat, args)` al método.
+ * Registers the method as a textual command. Internally applies
+ * `@on('message:created')`, a guard matching the `pattern` and a transform that
+ * passes `(msg, chat, args)` to the method.
+ *
+ * @param pattern - Prefijo textual o RegExp a matchear contra `msg.caption` / Text prefix or RegExp matched against `msg.caption`
+ */
+export function command(pattern) {
+    return (value, context) => {
+        on('message:created')(value, context);
+        guard((...args) => {
+            const msg = args[0];
+            const text = msg.caption ?? '';
+            if (typeof pattern === 'string') {
+                return text.startsWith(pattern);
+            }
+            return pattern.test(text);
+        })(value, context);
+        const metadata = context.metadata;
+        const schema = metadata[HANDLERS];
+        const handler = schema.handlers[String(context.name)];
+        handler.transforms.push((args) => {
+            const msg = args[0];
+            const chat = args[1];
+            const text = msg.caption ?? '';
+            if (typeof pattern === 'string') {
+                const rest = text.slice(pattern.length).trim();
+                const parsed = rest.length > 0 ? rest.split(/\s+/) : [];
+                return [msg, chat, parsed];
+            }
+            const match = pattern.exec(text);
+            return [msg, chat, match ? match.slice(1) : []];
+        });
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/build/esm/lib/bot/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../../src/lib/bot/decorators.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,3 @@
+export { WhatsAppBot, HANDLERS, decorator } from './decorator.js';
+export type { HandlerMeta, BotSchema, WorkflowStep } from './decorator.js';
+export { on, guard, command, from, once, connect, disconnect, every, pipe, pair, Bot } from './decorators.js';

package/build/esm/lib/bot/index.js

@@ -0,0 +1,3 @@
+export { WhatsAppBot, HANDLERS, decorator } from './decorator.js';
+export { on, guard, command, from, once, connect, disconnect, every, pipe, pair, Bot } from './decorators.js';
+//# sourceMappingURL=index.js.map

package/build/esm/lib/bot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/bot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,227 @@
+/**
+ * @file chat/index.ts
+ * @description Entidad Chat — conversaciones individuales y grupales.
+ * Chat entity — individual and group conversations.
+ */
+import type { Message } from '../../lib/message/index.js';
+import type { WhatsApp } from '../../lib/whatsapp/index.js';
+/**
+ * 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).
+ */
+export declare class Chat {
+    /** @internal Shape persistido. Uso interno. / Internal persisted shape. */
+    readonly _raw: IChatRaw;
+    constructor(raw: IChatRaw);
+    /** JID del chat. / Chat JID. */
+    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. */
+    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. */
+    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;
+}
+/**
+ * Factoría de Chat ligada al contexto WhatsApp.
+ * Context-bound Chat factory.
+ *
+ * @param wa - Instancia principal / Main WhatsApp instance
+ */
+export declare function chat(wa: WhatsApp): {
+    new (raw: IChatRaw): {
+        /** 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>;
+        /** Marca todos los mensajes del chat como leídos. / Marks all chat messages as read. */
+        seen(): 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). / Chat participants paginated (self included in groups). */
+        members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
+        /** Mensajes del chat paginados por mtime DESC. / Chat messages paginated by mtime DESC. */
+        messages(offset?: number, limit?: number): Promise<Message[]>;
+        /** @internal Shape persistido. Uso interno. / Internal persisted shape. */
+        readonly _raw: IChatRaw;
+        /** JID del chat. / Chat JID. */
+        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. */
+        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. */
+        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;
+    };
+    /**
+     * 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.
+     */
+    get(cid: string): Promise<{
+        /** 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>;
+        /** Marca todos los mensajes del chat como leídos. / Marks all chat messages as read. */
+        seen(): 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). / Chat participants paginated (self included in groups). */
+        members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
+        /** Mensajes del chat paginados por mtime DESC. / Chat messages paginated by mtime DESC. */
+        messages(offset?: number, limit?: number): Promise<Message[]>;
+        /** @internal Shape persistido. Uso interno. / Internal persisted shape. */
+        readonly _raw: IChatRaw;
+        /** JID del chat. / Chat JID. */
+        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. */
+        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. */
+        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;
+    } | null>;
+    /** Pagina los chats persistidos por mtime DESC. / Paginates persisted chats by mtime DESC. */
+    list(offset?: number, limit?: number): Promise<{
+        /** 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>;
+        /** Marca todos los mensajes del chat como leídos. / Marks all chat messages as read. */
+        seen(): 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). / Chat participants paginated (self included in groups). */
+        members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
+        /** Mensajes del chat paginados por mtime DESC. / Chat messages paginated by mtime DESC. */
+        messages(offset?: number, limit?: number): Promise<Message[]>;
+        /** @internal Shape persistido. Uso interno. / Internal persisted shape. */
+        readonly _raw: IChatRaw;
+        /** JID del chat. / Chat JID. */
+        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. */
+        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. */
+        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;
+    }[]>;
+    /** 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>;
+    /** Marca todos los mensajes del chat como leídos. / Marks all chat messages as read. */
+    seen(cid: string): 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>;
+};