@arcaelas/whatsapp 2.2.0 → 3.0.1

package/build/cjs/decorators.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file decorators.ts
+ * @description Sub-entry `@arcaelas/whatsapp/decorators` — API declarativa basada
+ * en decoradores Stage 3 para construir bots sobre el cliente WhatsApp.
+ * Sub-entry `@arcaelas/whatsapp/decorators` — Stage 3 decorator-based declarative
+ * API to build bots on top of the WhatsApp client.
+ */
+export { WhatsAppBot, Bot, on, guard, command, from, once, connect, disconnect, every, pipe, pair, HANDLERS, decorator, } from './lib/bot';
+export type { HandlerMeta, BotSchema, WorkflowStep } from './lib/bot';

package/build/cjs/decorators.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * @file decorators.ts
+ * @description Sub-entry `@arcaelas/whatsapp/decorators` — API declarativa basada
+ * en decoradores Stage 3 para construir bots sobre el cliente WhatsApp.
+ * Sub-entry `@arcaelas/whatsapp/decorators` — Stage 3 decorator-based declarative
+ * API to build bots on top of the WhatsApp client.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decorator = exports.HANDLERS = exports.pair = exports.pipe = exports.every = exports.disconnect = exports.connect = exports.once = exports.from = exports.command = exports.guard = exports.on = exports.Bot = exports.WhatsAppBot = void 0;
+var bot_1 = require("./lib/bot");
+Object.defineProperty(exports, "WhatsAppBot", { enumerable: true, get: function () { return bot_1.WhatsAppBot; } });
+Object.defineProperty(exports, "Bot", { enumerable: true, get: function () { return bot_1.Bot; } });
+Object.defineProperty(exports, "on", { enumerable: true, get: function () { return bot_1.on; } });
+Object.defineProperty(exports, "guard", { enumerable: true, get: function () { return bot_1.guard; } });
+Object.defineProperty(exports, "command", { enumerable: true, get: function () { return bot_1.command; } });
+Object.defineProperty(exports, "from", { enumerable: true, get: function () { return bot_1.from; } });
+Object.defineProperty(exports, "once", { enumerable: true, get: function () { return bot_1.once; } });
+Object.defineProperty(exports, "connect", { enumerable: true, get: function () { return bot_1.connect; } });
+Object.defineProperty(exports, "disconnect", { enumerable: true, get: function () { return bot_1.disconnect; } });
+Object.defineProperty(exports, "every", { enumerable: true, get: function () { return bot_1.every; } });
+Object.defineProperty(exports, "pipe", { enumerable: true, get: function () { return bot_1.pipe; } });
+Object.defineProperty(exports, "pair", { enumerable: true, get: function () { return bot_1.pair; } });
+Object.defineProperty(exports, "HANDLERS", { enumerable: true, get: function () { return bot_1.HANDLERS; } });
+Object.defineProperty(exports, "decorator", { enumerable: true, get: function () { return bot_1.decorator; } });
+//# sourceMappingURL=decorators.js.map

package/build/cjs/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,iCAemB;AAdf,kGAAA,WAAW,OAAA;AACX,0FAAA,GAAG,OAAA;AACH,yFAAA,EAAE,OAAA;AACF,4FAAA,KAAK,OAAA;AACL,8FAAA,OAAO,OAAA;AACP,2FAAA,IAAI,OAAA;AACJ,2FAAA,IAAI,OAAA;AACJ,8FAAA,OAAO,OAAA;AACP,iGAAA,UAAU,OAAA;AACV,4FAAA,KAAK,OAAA;AACL,2FAAA,IAAI,OAAA;AACJ,2FAAA,IAAI,OAAA;AACJ,+FAAA,QAAQ,OAAA;AACR,gGAAA,SAAS,OAAA"}

package/build/cjs/index.d.ts

@@ -1,13 +1,9 @@
 /**
  * @file index.ts
- * @description Punto de entrada público de la librería @arcaelas/whatsapp
+ * @description Punto de entrada público de la librería @arcaelas/whatsapp.
+ * Public entry point of the @arcaelas/whatsapp library.
  */
-export { MESSAGE_STATUS } from './Message';
-export type { LocationOptions, MessageType, PollOptions } from './Message';
-export type { Engine } from './store';
-export type { IChatRaw, IGroupParticipant } from './Chat';
-export type { IContactRaw } from './Contact';
-export type { IMessage, IMessageIndex } from './Message';
-export type { IWhatsApp } from './WhatsApp';
-export { FileEngine, RedisEngine } from './store';
-export { WhatsApp } from './WhatsApp';
+export { WhatsApp, default } from './lib/whatsapp';
+export type { IWhatsApp, DisconnectOptions, ReconnectOption } from './lib/whatsapp';
+export { FileSystemEngine, RedisEngine } from './lib/store';
+export type { Engine, RedisClient } from './lib/store';

package/build/cjs/index.js

@@ -1,17 +1,18 @@
 "use strict";
 /**
  * @file index.ts
- * @description Punto de entrada público de la librería @arcaelas/whatsapp
+ * @description Punto de entrada público de la librería @arcaelas/whatsapp.
+ * Public entry point of the @arcaelas/whatsapp library.
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WhatsApp = exports.RedisEngine = exports.FileEngine = exports.MESSAGE_STATUS = void 0;
-// Enums
-var Message_1 = require("./Message");
-Object.defineProperty(exports, "MESSAGE_STATUS", { enumerable: true, get: function () { return Message_1.MESSAGE_STATUS; } });
-// Classes
-var store_1 = require("./store");
-Object.defineProperty(exports, "FileEngine", { enumerable: true, get: function () { return store_1.FileEngine; } });
+exports.RedisEngine = exports.FileSystemEngine = exports.default = exports.WhatsApp = void 0;
+var whatsapp_1 = require("./lib/whatsapp");
+Object.defineProperty(exports, "WhatsApp", { enumerable: true, get: function () { return whatsapp_1.WhatsApp; } });
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(whatsapp_1).default; } });
+var store_1 = require("./lib/store");
+Object.defineProperty(exports, "FileSystemEngine", { enumerable: true, get: function () { return store_1.FileSystemEngine; } });
 Object.defineProperty(exports, "RedisEngine", { enumerable: true, get: function () { return store_1.RedisEngine; } });
-var WhatsApp_1 = require("./WhatsApp");
-Object.defineProperty(exports, "WhatsApp", { enumerable: true, get: function () { return WhatsApp_1.WhatsApp; } });
 //# sourceMappingURL=index.js.map

package/build/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,QAAQ;AACR,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AAYvB,UAAU;AACV,iCAAkD;AAAzC,mGAAA,UAAU,OAAA;AAAE,oGAAA,WAAW,OAAA;AAChC,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,2CAAmD;AAA1C,oGAAA,QAAQ,OAAA;AAAE,oHAAA,OAAO,OAAA;AAG1B,qCAA4D;AAAnD,yGAAA,gBAAgB,OAAA;AAAE,oGAAA,WAAW,OAAA"}

package/build/cjs/lib/bot/decorator.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @file playground/bot/decorator.ts
+ * @description Infraestructura base de decoradores Stage 3 sobre WhatsApp.
+ * Base infrastructure for Stage 3 decorators over WhatsApp.
+ */
+import WhatsApp, { type IWhatsApp } from '../../lib/whatsapp';
+export declare const HANDLERS: unique symbol;
+export interface HandlerMeta {
+    method: string;
+    events: string[];
+    guards: Array<(...args: unknown[]) => boolean | Promise<boolean>>;
+    transforms: Array<(args: unknown[]) => unknown[] | Promise<unknown[]>>;
+    once: boolean;
+}
+export interface WorkflowStep {
+    index: number;
+    method: string;
+}
+export interface BotSchema {
+    handlers: Record<string, HandlerMeta>;
+    workflows: Record<string, WorkflowStep[]>;
+}
+type Metadata = Record<string | symbol, unknown>;
+/**
+ * Registra un step dentro de un workflow. Uso interno del decorador `@pipe`.
+ * Registers a step inside a workflow. Internal use of the `@pipe` decorator.
+ *
+ * @param metadata - Metadata del contexto del decorador / Decorator context metadata
+ * @param workflow - Nombre del workflow / Workflow name
+ * @param step - Step a registrar (índice + nombre del método) / Step to register (index + method name)
+ */
+export declare function register_workflow_step(metadata: Metadata, workflow: string, step: WorkflowStep): void;
+/**
+ * Factory para crear decoradores paramétricos Stage 3. El callback muta la metadata
+ * del handler mediante la entrada resuelta.
+ * Factory to build Stage 3 parametric decorators. The callback mutates the handler
+ * metadata via the resolved entry.
+ *
+ * @param callback - Mutador de la entrada del handler / Handler entry mutator
+ * @returns Decorador paramétrico listo para aplicarse a un método / Parametric decorator ready to be applied to a method
+ */
+export declare function decorator<P extends unknown[]>(callback: (metadata: Metadata, handler: HandlerMeta, params: P) => void): (...params: P) => (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * Clase base opcional para bots declarativos. El consumer extiende `WhatsAppBot`
+ * (o usa `@WhatsApp` como class decorator), declara métodos decorados y al
+ * `connect()` los listeners se cablean automáticamente contra el event emitter real.
+ * Optional base class for declarative bots. The consumer extends `WhatsAppBot`
+ * (or uses `@WhatsApp` as a class decorator), declares decorated methods and at
+ * `connect()` listeners get wired against the real event emitter automatically.
+ */
+export declare class WhatsAppBot extends WhatsApp {
+    constructor(options: IWhatsApp);
+    /**
+     * Inicia la conexión cableando previamente los handlers decorados. Los métodos
+     * `@pair` se invocan en paralelo con el `callback` opcional.
+     * Starts the connection wiring decorated handlers beforehand. `@pair` methods
+     * run in parallel alongside the optional `callback`.
+     *
+     * @param callback - Callback tradicional del PIN/QR (opcional si hay `@pair`) / Traditional PIN/QR callback (optional when `@pair` exists)
+     */
+    connect(callback?: (auth: string | Buffer) => void | Promise<void>): Promise<void>;
+    /**
+     * Recolecta los métodos marcados con `@pair` ligados a `this`.
+     * Collects methods marked with `@pair` bound to `this`.
+     *
+     * @returns Lista de funciones ligadas listas para invocar con el code / List of bound functions ready to invoke with the code
+     */
+    private _collect_pair_methods;
+    /**
+     * Cablea los handlers decorados contra el event emitter: registra listeners
+     * (`@on`/`@once`), timers (`@every`) y workflows (`@pipe`).
+     * Wires decorated handlers against the event emitter: registers listeners
+     * (`@on`/`@once`), timers (`@every`) and workflows (`@pipe`).
+     */
+    private _wire_handlers;
+}
+export default WhatsAppBot;

package/build/cjs/lib/bot/decorator.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * @file playground/bot/decorator.ts
+ * @description Infraestructura base de decoradores Stage 3 sobre WhatsApp.
+ * Base infrastructure for Stage 3 decorators over WhatsApp.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppBot = exports.HANDLERS = void 0;
+exports.register_workflow_step = register_workflow_step;
+exports.decorator = decorator;
+const whatsapp_1 = __importDefault(require("../../lib/whatsapp"));
+Symbol.metadata ??= Symbol.for('Symbol.metadata');
+exports.HANDLERS = Symbol('wa:handlers');
+/**
+ * Recupera o inicializa el schema del bot y la entrada del método indicado.
+ * Retrieves or initializes the bot schema and the entry for the given method.
+ *
+ * @param metadata - Objeto metadata del contexto del decorador / Decorator context metadata object
+ * @param method_name - Nombre del método / Method name
+ * @returns Tupla `[schema, handler_meta]` para el método / Tuple `[schema, handler_meta]` for the method
+ */
+function resolve(metadata, method_name) {
+    let schema = metadata[exports.HANDLERS];
+    if (!schema) {
+        schema = { handlers: {}, workflows: {} };
+        metadata[exports.HANDLERS] = schema;
+    }
+    if (!schema.workflows) {
+        schema.workflows = {};
+    }
+    schema.handlers[method_name] ||= {
+        method: method_name,
+        events: [],
+        guards: [],
+        transforms: [],
+        once: false,
+    };
+    return [schema, schema.handlers[method_name]];
+}
+/**
+ * Registra un step dentro de un workflow. Uso interno del decorador `@pipe`.
+ * Registers a step inside a workflow. Internal use of the `@pipe` decorator.
+ *
+ * @param metadata - Metadata del contexto del decorador / Decorator context metadata
+ * @param workflow - Nombre del workflow / Workflow name
+ * @param step - Step a registrar (índice + nombre del método) / Step to register (index + method name)
+ */
+function register_workflow_step(metadata, workflow, step) {
+    let schema = metadata[exports.HANDLERS];
+    if (!schema) {
+        schema = { handlers: {}, workflows: {} };
+        metadata[exports.HANDLERS] = schema;
+    }
+    if (!schema.workflows) {
+        schema.workflows = {};
+    }
+    schema.workflows[workflow] ||= [];
+    schema.workflows[workflow].push(step);
+}
+/**
+ * Factory para crear decoradores paramétricos Stage 3. El callback muta la metadata
+ * del handler mediante la entrada resuelta.
+ * Factory to build Stage 3 parametric decorators. The callback mutates the handler
+ * metadata via the resolved entry.
+ *
+ * @param callback - Mutador de la entrada del handler / Handler entry mutator
+ * @returns Decorador paramétrico listo para aplicarse a un método / Parametric decorator ready to be applied to a method
+ */
+function decorator(callback) {
+    return (...params) => (_value, context) => {
+        if (context.kind !== 'method') {
+            throw new Error(`Decorator only applicable to methods; got ${context.kind}`);
+        }
+        const metadata = context.metadata;
+        const method_name = String(context.name);
+        const [, handler] = resolve(metadata, method_name);
+        callback(metadata, handler, params);
+    };
+}
+/**
+ * Clase base opcional para bots declarativos. El consumer extiende `WhatsAppBot`
+ * (o usa `@WhatsApp` como class decorator), declara métodos decorados y al
+ * `connect()` los listeners se cablean automáticamente contra el event emitter real.
+ * Optional base class for declarative bots. The consumer extends `WhatsAppBot`
+ * (or uses `@WhatsApp` as a class decorator), declares decorated methods and at
+ * `connect()` listeners get wired against the real event emitter automatically.
+ */
+class WhatsAppBot extends whatsapp_1.default {
+    constructor(options) {
+        super(options);
+    }
+    /**
+     * Inicia la conexión cableando previamente los handlers decorados. Los métodos
+     * `@pair` se invocan en paralelo con el `callback` opcional.
+     * Starts the connection wiring decorated handlers beforehand. `@pair` methods
+     * run in parallel alongside the optional `callback`.
+     *
+     * @param callback - Callback tradicional del PIN/QR (opcional si hay `@pair`) / Traditional PIN/QR callback (optional when `@pair` exists)
+     */
+    async connect(callback) {
+        this._wire_handlers();
+        const pair_methods = this._collect_pair_methods();
+        const final_callback = async (code) => {
+            await Promise.all(pair_methods.map((fn) => fn(code)));
+            if (callback) {
+                await callback(code);
+            }
+        };
+        return super.connect(final_callback);
+    }
+    /**
+     * Recolecta los métodos marcados con `@pair` ligados a `this`.
+     * Collects methods marked with `@pair` bound to `this`.
+     *
+     * @returns Lista de funciones ligadas listas para invocar con el code / List of bound functions ready to invoke with the code
+     */
+    _collect_pair_methods() {
+        const out = [];
+        const metadata = this.constructor[Symbol.metadata];
+        if (metadata) {
+            const schema = metadata[exports.HANDLERS];
+            if (schema) {
+                for (const meta of Object.values(schema.handlers)) {
+                    if (meta.events.includes('__pair')) {
+                        const fn = this[meta.method];
+                        if (typeof fn === 'function') {
+                            out.push(fn.bind(this));
+                        }
+                    }
+                }
+            }
+        }
+        return out;
+    }
+    /**
+     * Cablea los handlers decorados contra el event emitter: registra listeners
+     * (`@on`/`@once`), timers (`@every`) y workflows (`@pipe`).
+     * Wires decorated handlers against the event emitter: registers listeners
+     * (`@on`/`@once`), timers (`@every`) and workflows (`@pipe`).
+     */
+    _wire_handlers() {
+        const metadata = this.constructor[Symbol.metadata];
+        if (metadata) {
+            const schema = metadata[exports.HANDLERS];
+            if (schema) {
+                const intervals = [];
+                for (const meta of Object.values(schema.handlers)) {
+                    const method = this[meta.method];
+                    if (typeof method === 'function') {
+                        const bound = method.bind(this);
+                        const invoke = async (...args) => {
+                            for (const g of meta.guards) {
+                                if (!(await g(...args))) {
+                                    return;
+                                }
+                            }
+                            let current = args;
+                            for (const t of meta.transforms) {
+                                current = await t(current);
+                            }
+                            await bound(...current);
+                        };
+                        if (meta.events.length === 0 && (meta.guards.length > 0 || meta.transforms.length > 0)) {
+                            meta.events.push('message:created');
+                        }
+                        for (const event of meta.events) {
+                            if (event.startsWith('__every:')) {
+                                const ms = parseInt(event.slice('__every:'.length), 10);
+                                if (Number.isFinite(ms) && ms > 0) {
+                                    intervals.push({ ms, run: () => invoke() });
+                                }
+                            }
+                            else if (event !== '__pair') {
+                                const register = meta.once ? this.once.bind(this) : this.on.bind(this);
+                                register(event, invoke);
+                            }
+                        }
+                    }
+                }
+                if (intervals.length > 0) {
+                    let timer_ids = [];
+                    this.on('connected', () => {
+                        for (const { ms, run } of intervals) {
+                            timer_ids.push(setInterval(() => void run(), ms));
+                        }
+                    });
+                    this.on('disconnected', () => {
+                        for (const id of timer_ids) {
+                            clearInterval(id);
+                        }
+                        timer_ids = [];
+                    });
+                }
+                for (const steps of Object.values(schema.workflows ?? {})) {
+                    const sorted = [...steps].sort((a, b) => a.index - b.index);
+                    const funcs = sorted
+                        .map(({ method }) => {
+                        const fn = this[method];
+                        return typeof fn === 'function' ? fn.bind(this) : null;
+                    })
+                        .filter((f) => f !== null);
+                    if (funcs.length > 0) {
+                        this.on('message:created', (async (...args) => {
+                            for (const fn of funcs) {
+                                await fn(...args);
+                            }
+                        }));
+                    }
+                }
+            }
+        }
+    }
+}
+exports.WhatsAppBot = WhatsAppBot;
+exports.default = WhatsAppBot;
+//# sourceMappingURL=decorator.js.map

package/build/cjs/lib/bot/decorator.js.map

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

package/build/cjs/lib/bot/decorators.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @file playground/bot/decorators.ts
+ * @description Decoradores públicos del bot.
+ * Public bot decorators.
+ */
+import type { IWhatsApp } from '../../lib/whatsapp';
+import { WhatsAppBot } from './decorator';
+/**
+ * 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 declare const on: (event: string) => (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * 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 declare const guard: (pred: (...args: unknown[]) => boolean | Promise<boolean>) => (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * 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 declare function once(event?: string): (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * 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 declare function connect(): (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * 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 declare function disconnect(): (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * 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 declare function every(ms: number): (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * 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 declare const pair: () => (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * 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 declare function from(source: string | string[] | ((jid: string) => boolean)): (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * 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 declare function Bot(default_options: IWhatsApp): <T extends abstract new (...args: never[]) => object>(target: T, _context: ClassDecoratorContext) => new (override?: Partial<IWhatsApp>) => InstanceType<T> & WhatsAppBot;
+/**
+ * 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 declare function pipe(workflow: string, index: number): (_value: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * 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 declare function command(pattern: string | RegExp): (value: unknown, context: ClassMethodDecoratorContext) => void;