@arcaelas/whatsapp 3.1.1 → 3.2.0

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;

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

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * @file playground/bot/decorators.ts
+ * @description Decoradores públicos del bot.
+ * Public bot decorators.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pair = exports.guard = exports.on = void 0;
+exports.once = once;
+exports.connect = connect;
+exports.disconnect = disconnect;
+exports.every = every;
+exports.from = from;
+exports.Bot = Bot;
+exports.pipe = pipe;
+exports.command = command;
+const decorator_1 = require("./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
+ */
+exports.on = (0, decorator_1.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
+ */
+exports.guard = (0, decorator_1.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
+ */
+function once(event) {
+    return (_value, context) => {
+        if (context.kind !== 'method') {
+            throw new Error('@once only applicable to methods');
+        }
+        const metadata = context.metadata;
+        if (!metadata[decorator_1.HANDLERS]) {
+            metadata[decorator_1.HANDLERS] = { handlers: {}, workflows: {} };
+        }
+        const schema = metadata[decorator_1.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.
+ */
+function connect() {
+    return (0, exports.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.
+ */
+function disconnect() {
+    return (0, exports.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
+ */
+function every(ms) {
+    return (0, decorator_1.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.
+ */
+exports.pair = (0, decorator_1.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`
+ */
+function from(source) {
+    return (0, decorator_1.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
+ */
+function Bot(default_options) {
+    return function (target, _context) {
+        const Mixed = class extends decorator_1.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)
+ */
+function pipe(workflow, index) {
+    return (_value, context) => {
+        if (context.kind !== 'method') {
+            throw new Error('@pipe only applicable to methods');
+        }
+        const metadata = context.metadata;
+        (0, decorator_1.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`
+ */
+function command(pattern) {
+    return (value, context) => {
+        (0, exports.on)('message:created')(value, context);
+        (0, exports.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[decorator_1.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/cjs/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/cjs/lib/bot/index.d.ts

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

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

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bot = exports.pair = exports.pipe = exports.every = exports.disconnect = exports.connect = exports.once = exports.from = exports.command = exports.guard = exports.on = exports.decorator = exports.HANDLERS = exports.WhatsAppBot = void 0;
+var decorator_1 = require("./decorator");
+Object.defineProperty(exports, "WhatsAppBot", { enumerable: true, get: function () { return decorator_1.WhatsAppBot; } });
+Object.defineProperty(exports, "HANDLERS", { enumerable: true, get: function () { return decorator_1.HANDLERS; } });
+Object.defineProperty(exports, "decorator", { enumerable: true, get: function () { return decorator_1.decorator; } });
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "on", { enumerable: true, get: function () { return decorators_1.on; } });
+Object.defineProperty(exports, "guard", { enumerable: true, get: function () { return decorators_1.guard; } });
+Object.defineProperty(exports, "command", { enumerable: true, get: function () { return decorators_1.command; } });
+Object.defineProperty(exports, "from", { enumerable: true, get: function () { return decorators_1.from; } });
+Object.defineProperty(exports, "once", { enumerable: true, get: function () { return decorators_1.once; } });
+Object.defineProperty(exports, "connect", { enumerable: true, get: function () { return decorators_1.connect; } });
+Object.defineProperty(exports, "disconnect", { enumerable: true, get: function () { return decorators_1.disconnect; } });
+Object.defineProperty(exports, "every", { enumerable: true, get: function () { return decorators_1.every; } });
+Object.defineProperty(exports, "pipe", { enumerable: true, get: function () { return decorators_1.pipe; } });
+Object.defineProperty(exports, "pair", { enumerable: true, get: function () { return decorators_1.pair; } });
+Object.defineProperty(exports, "Bot", { enumerable: true, get: function () { return decorators_1.Bot; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/bot/index.ts"],"names":[],"mappings":";;;AAAA,yCAA+D;AAAtD,wGAAA,WAAW,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAAE,sGAAA,SAAS,OAAA;AAEzC,2CAA2G;AAAlG,gGAAA,EAAE,OAAA;AAAE,mGAAA,KAAK,OAAA;AAAE,qGAAA,OAAO,OAAA;AAAE,kGAAA,IAAI,OAAA;AAAE,kGAAA,IAAI,OAAA;AAAE,qGAAA,OAAO,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,mGAAA,KAAK,OAAA;AAAE,kGAAA,IAAI,OAAA;AAAE,kGAAA,IAAI,OAAA;AAAE,iGAAA,GAAG,OAAA"}