@arcaelas/whatsapp 6.2.0 → 7.0.0

package/README.md

@@ -44,7 +44,7 @@ Node 20 o superior. El paquete se distribuye en ESM y CJS.
 | Paquete | Necesario para |
 | --- | --- |
 | `@aws-sdk/client-s3` | `S3Engine` |
-| `sharp` o `jimp` | `wa.profile({ photo })` |
+| `sharp` o `jimp` | `cuenta.picture(...)` |
 
 `RedisEngine` y `SQLiteEngine` no necesitan nada: reciben el cliente ya construido, así que servís vos el `ioredis`, `better-sqlite3` o `node:sqlite` que prefieras.
 
@@ -93,8 +93,8 @@ new WhatsApp({ engine, phone?, method?, autoclean?, reconnect?, sync? })
 
 ```ts
 wa.engine                     // motor de persistencia
-wa.contact                    // Contact de la cuenta autenticada, o null sin sesión
-wa.Contact / wa.Chat / wa.Message   // entidades ligadas a este cliente
+wa.Contact / wa.Chat / wa.Message   // entidades, publicadas al conectar
+await wa.account()            // Account de la cuenta autenticada, o null sin usuario
 
 await wa.connect(callback)    // callback recibe el PIN (string) o el QR (Buffer PNG)
 await wa.disconnect({ silent?, destroy? })
@@ -103,33 +103,37 @@ wa.on(event, handler)         // devuelve la función para desuscribirse
 wa.once(event, handler)
 wa.off(event, handler)
 wa.emit(event, ...args)
-
-await wa.profile({ name?, content?, photo? })   // nombre público, bio y foto
-await wa.feed({ content?, caption?, contacts }) // publica un estado
 ```
 
-El estado interno (socket de baileys, emisor, credenciales) es **privado de verdad**: no está accesible desde la instancia. Todo pasa por los métodos de arriba.
+Las entidades y `account()` se publican dentro de `connect`, cuando el socket ya existe: antes de la primera conexión no están definidas. El estado interno (socket, credenciales, reintentos) vive en el closure de `connect` — no hay nada que hurgar en la instancia.
+
+### La cuenta: `Account`
 
-### Perfil y estados
+`await wa.account()` devuelve un `Account extends Contact`: todos los getters de un contacto (`name`, `phone`, `jid`, `lid`, `photo`) más las operaciones que solo existen para uno mismo.
 
 ```ts
-await wa.profile({ name: 'Ventas', content: 'Atendemos 9-18h' });
-await wa.profile({ photo: buffer });        // o una URL
-await wa.profile({ photo: null });          // elimina la foto
+const cuenta = await wa.account();
+
+await cuenta.rename('Ventas');            // nombre público
+await cuenta.picture(buffer);             // foto de perfil (Buffer o URL)
+await cuenta.picture(null);               // la elimina
+await cuenta.content();                   // lee la bio
+await cuenta.content('Atendemos 9-18h');  // la actualiza
+await cuenta.online(true);                // presencia online/offline
 
-const post = await wa.feed({
+const post = await cuenta.post({
     caption: '¡Estamos en vivo!',
-    contacts: ['5491112345678', '584121234567'],   // audiencia obligatoria
+    audience: [contacto, 5491112345678, '584121234567@s.whatsapp.net', '999@lid'],
 });
 ```
 
-`contacts` no es opcional: WhatsApp no entrega el estado a nadie fuera de esa lista. Con `content` (Buffer) se publica imagen o video —el tipo se deduce de la firma del binario— y `caption` queda como pie.
+`audience` no es opcional: WhatsApp no entrega el estado a nadie fuera de esa lista, y acepta instancias de `Contact`, JIDs, LIDs o teléfonos. Con `buffer` se publica imagen o video —el tipo se deduce de la firma del binario— y `caption` queda como pie. La presencia arranca en offline (`markOnlineOnConnect: false`): `online()` es el único interruptor.
 
 ---
 
 ## Entidades
 
-Cada entidad expone getters puros sobre su documento y métodos que actúan contra WhatsApp. `wa.Contact`, `wa.Chat` y `wa.Message` ya vienen ligados al cliente; las clases sueltas se importan del paquete cuando querés `instanceof` o los estáticos con el cliente explícito.
+Cada entidad expone getters puros sobre su documento y métodos que actúan contra WhatsApp. `wa.Contact`, `wa.Chat` y `wa.Message` ya vienen ligados a la sesión; las clases sueltas se importan del paquete cuando querés `instanceof`.
 
 ### Contact
 

package/build/cjs/index.d.ts

@@ -3,11 +3,15 @@
  * @description Punto de entrada público de la librería @arcaelas/whatsapp.
  * Public entry point of the @arcaelas/whatsapp library.
  */
-export { WhatsApp, default } from './lib/whatsapp';
-export type { IWhatsApp, DisconnectOptions, ReconnectOption } from './lib/whatsapp';
+import WhatsApp from './lib/whatsapp';
+export { WhatsApp };
+export default WhatsApp;
+export type IWhatsApp = ConstructorParameters<typeof WhatsApp>[0];
+export type DisconnectOptions = NonNullable<Parameters<WhatsApp['disconnect']>[0]>;
+export type ReconnectOption = NonNullable<IWhatsApp['reconnect']>;
 export { FileSystemEngine, RedisEngine, S3Engine, SQLiteEngine, serialize, deserialize } from './lib/store';
 export type { Engine, RedisClient, SQLiteDatabase } from './lib/store';
-export { Contact, contact } from './lib/contact';
-export { Chat, chat } from './lib/chat';
-export { Message, message, Text, Image, Video, Audio, Sticker, Document, Location, Poll, VCard, Event } from './lib/message';
+export { default as Contact, contact, Account } from './lib/contact';
+export { default as Chat, chat } from './lib/chat';
+export { default as Message, message, Text, Image, Video, Audio, Sticker, Document, Location, Poll, VCard, Event } from './lib/message';
 export { Feed, TTL_MS as FEED_TTL_MS } from './lib/status';

package/build/cjs/index.js

@@ -8,10 +8,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FEED_TTL_MS = exports.Feed = exports.Event = exports.VCard = exports.Poll = exports.Location = exports.Document = exports.Sticker = exports.Audio = exports.Video = exports.Image = exports.Text = exports.message = exports.Message = exports.chat = exports.Chat = exports.contact = exports.Contact = exports.deserialize = exports.serialize = exports.SQLiteEngine = exports.S3Engine = 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; } });
+exports.FEED_TTL_MS = exports.Feed = exports.Event = exports.VCard = exports.Poll = exports.Location = exports.Document = exports.Sticker = exports.Audio = exports.Video = exports.Image = exports.Text = exports.message = exports.Message = exports.chat = exports.Chat = exports.Account = exports.contact = exports.Contact = exports.deserialize = exports.serialize = exports.SQLiteEngine = exports.S3Engine = exports.RedisEngine = exports.FileSystemEngine = exports.WhatsApp = void 0;
+const whatsapp_1 = __importDefault(require("./lib/whatsapp"));
+exports.WhatsApp = whatsapp_1.default;
+exports.default = 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; } });
@@ -20,13 +20,14 @@ Object.defineProperty(exports, "SQLiteEngine", { enumerable: true, get: function
 Object.defineProperty(exports, "serialize", { enumerable: true, get: function () { return store_1.serialize; } });
 Object.defineProperty(exports, "deserialize", { enumerable: true, get: function () { return store_1.deserialize; } });
 var contact_1 = require("./lib/contact");
-Object.defineProperty(exports, "Contact", { enumerable: true, get: function () { return contact_1.Contact; } });
+Object.defineProperty(exports, "Contact", { enumerable: true, get: function () { return __importDefault(contact_1).default; } });
 Object.defineProperty(exports, "contact", { enumerable: true, get: function () { return contact_1.contact; } });
+Object.defineProperty(exports, "Account", { enumerable: true, get: function () { return contact_1.Account; } });
 var chat_1 = require("./lib/chat");
-Object.defineProperty(exports, "Chat", { enumerable: true, get: function () { return chat_1.Chat; } });
+Object.defineProperty(exports, "Chat", { enumerable: true, get: function () { return __importDefault(chat_1).default; } });
 Object.defineProperty(exports, "chat", { enumerable: true, get: function () { return chat_1.chat; } });
 var message_1 = require("./lib/message");
-Object.defineProperty(exports, "Message", { enumerable: true, get: function () { return message_1.Message; } });
+Object.defineProperty(exports, "Message", { enumerable: true, get: function () { return __importDefault(message_1).default; } });
 Object.defineProperty(exports, "message", { enumerable: true, get: function () { return message_1.message; } });
 Object.defineProperty(exports, "Text", { enumerable: true, get: function () { return message_1.Text; } });
 Object.defineProperty(exports, "Image", { enumerable: true, get: function () { return message_1.Image; } });

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

@@ -3,7 +3,8 @@
  * @description Infraestructura base de decoradores Stage 3 sobre WhatsApp.
  * Base infrastructure for Stage 3 decorators over WhatsApp.
  */
-import WhatsApp, { type IWhatsApp } from '../../lib/whatsapp';
+import WhatsApp from '../../lib/whatsapp';
+type IWhatsApp = ConstructorParameters<typeof WhatsApp>[0];
 export declare const HANDLERS: unique symbol;
 export interface HandlerMeta {
     method: string;
@@ -21,14 +22,6 @@ export interface BotSchema {
     workflows: Record<string, WorkflowStep[]>;
 }
 type Metadata = Record<string | symbol, unknown>;
-/**
- * Recupera o inicializa el `BotSchema` almacenado en la metadata del contexto.
- * Retrieves or initializes the `BotSchema` stored in the context metadata.
- *
- * @param metadata - Objeto metadata del contexto del decorador / Decorator context metadata object
- * @returns Schema del bot garantizado con `handlers` y `workflows` / Bot schema guaranteed to have `handlers` and `workflows`
- */
-export declare function ensure_schema(metadata: Metadata): BotSchema;
 /**
  * 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.

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

@@ -9,7 +9,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WhatsAppBot = exports.HANDLERS = void 0;
-exports.ensure_schema = ensure_schema;
 exports.resolve = resolve;
 exports.register_workflow_step = register_workflow_step;
 exports.decorator = decorator;

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

@@ -3,7 +3,8 @@
  * @description Decoradores públicos del bot.
  * Public bot decorators.
  */
-import type { IWhatsApp } from '../../lib/whatsapp';
+import type WhatsApp from '../../lib/whatsapp';
+type IWhatsApp = ConstructorParameters<typeof WhatsApp>[0];
 import { WhatsAppBot } from './decorator';
 /**
  * Registra el método como listener del evento indicado. Apilable: varios `@on`
@@ -13,7 +14,21 @@ import { WhatsAppBot } from './decorator';
  *
  * @param event - Nombre del evento del cliente / Client event name
  */
-export declare const on: (event: string) => (_value: unknown, context: ClassMethodDecoratorContext) => void;
+export declare const on: (event: string) => (_value: unknown, context: ClassMethodDecoratorContext
+/**
+ * Ejecuta el método con un retardo de `ms` milisegundos entre ejecuciones,
+ * usando `setTimeout` recursivo. A diferencia de `@every`, la siguiente
+ * ejecución solo empieza cuando la anterior ha terminado — nunca hay
+ * ejecuciones en paralelo. Arranca en `connected` y se detiene en
+ * `disconnected`.
+ * Runs the method with `ms` milliseconds between executions using a recursive
+ * `setTimeout`. Unlike `@every`, the next execution only starts after the
+ * previous one finishes — executions never overlap. Starts on `connected`
+ * and stops on `disconnected`.
+ *
+ * @param ms - Retardo entre ejecuciones en milisegundos / Delay between executions in milliseconds
+ */
+) => 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`.
@@ -22,7 +37,21 @@ export declare const on: (event: string) => (_value: unknown, context: ClassMeth
  *
  * @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;
+export declare const guard: (pred: (...args: unknown[]) => boolean | Promise<boolean>) => (_value: unknown, context: ClassMethodDecoratorContext
+/**
+ * Ejecuta el método con un retardo de `ms` milisegundos entre ejecuciones,
+ * usando `setTimeout` recursivo. A diferencia de `@every`, la siguiente
+ * ejecución solo empieza cuando la anterior ha terminado — nunca hay
+ * ejecuciones en paralelo. Arranca en `connected` y se detiene en
+ * `disconnected`.
+ * Runs the method with `ms` milliseconds between executions using a recursive
+ * `setTimeout`. Unlike `@every`, the next execution only starts after the
+ * previous one finishes — executions never overlap. Starts on `connected`
+ * and stops on `disconnected`.
+ *
+ * @param ms - Retardo entre ejecuciones en milisegundos / Delay between executions in milliseconds
+ */
+) => void;
 /**
  * Marca el handler para ejecutarse una sola vez y luego auto-desuscribirse.
  * Con `event` actúa como shortcut de `@on(event) + @once()`.
@@ -79,7 +108,21 @@ export declare function delay(ms: number): (_value: unknown, context: ClassMetho
  * 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;
+export declare const pair: () => (_value: unknown, context: ClassMethodDecoratorContext
+/**
+ * Ejecuta el método con un retardo de `ms` milisegundos entre ejecuciones,
+ * usando `setTimeout` recursivo. A diferencia de `@every`, la siguiente
+ * ejecución solo empieza cuando la anterior ha terminado — nunca hay
+ * ejecuciones en paralelo. Arranca en `connected` y se detiene en
+ * `disconnected`.
+ * Runs the method with `ms` milliseconds between executions using a recursive
+ * `setTimeout`. Unlike `@every`, the next execution only starts after the
+ * previous one finishes — executions never overlap. Starts on `connected`
+ * and stops on `disconnected`.
+ *
+ * @param ms - Retardo entre ejecuciones en milisegundos / Delay between executions in milliseconds
+ */
+) => void;
 /**
  * Filtra por autor del mensaje. Acepta JID, LID o teléfono numérico; el string
  * se normaliza con la resolución interna del cliente y cache lazy. Un array produce match OR.
@@ -129,3 +172,4 @@ export declare function pipe(workflow: string, index: number): (_value: unknown,
  * @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;
+export {};

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

@@ -15,7 +15,7 @@ exports.from = from;
 exports.Bot = Bot;
 exports.pipe = pipe;
 exports.command = command;
-const internal_1 = require("../../lib/internal");
+const store_1 = require("../../lib/store");
 const decorator_1 = require("./decorator");
 /**
  * Registra el método como listener del evento indicado. Apilable: varios `@on`
@@ -147,7 +147,7 @@ function from(source) {
                 if (resolved === null) {
                     resolved = new Set();
                     for (const raw of list) {
-                        const r = await (0, internal_1.internals)(wa).resolve_jid(raw);
+                        const r = await (0, store_1.jid_of)(wa.engine, raw);
                         if (r) {
                             resolved.add(r);
                         }