@arcaelas/whatsapp 4.5.0 → 5.1.0

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

@@ -1,70 +1,68 @@
 "use strict";
 /**
  * @file contact/index.ts
- * @description Entidad Contact — lectura/escritura documental sobre `wa.engine`.
- * Contact entity — documental read/write over `wa.engine`.
+ * @description Entidad Contact — una ficha mínima derivada del raw del contacto.
+ * Contact entity — a minimal card derived from the raw contact document.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Contact = void 0;
-exports.contact_name = contact_name;
 exports.contact = contact;
 const baileys_1 = require("baileys");
+const internal_1 = require("../../lib/internal");
 const store_1 = require("../../lib/store");
 /**
- * Resuelve el nombre mostrado de un contacto con prioridad local → push → teléfono.
- * Resolves a contact's display name with priority local → push → phone number.
- *
- * @param raw - Documento persistido del contacto / Persisted contact document
- * @returns Nombre mostrado / Display name
- */
-function contact_name(raw) {
-    return raw.name ?? raw.notify ?? raw.id.split('@')[0];
-}
-/**
- * Clase base del contacto (forma pública, solo lectura).
- * Base Contact class (public shape, read-only).
+ * Clase base del contacto: recibe el raw de baileys y deriva todo con getters.
+ * Base Contact class: receives the baileys raw and derives everything via getters.
  */
 class Contact {
-    constructor(raw, chat) {
-        this._raw = raw;
-        this._chat = chat;
+    /**
+     * @internal Documento crudo del contacto en snake_case. `id` llega en formato LID o PN
+     * según el addressing; `phone_number` es el JID PN cuando baileys lo conoce.
+     * Raw contact document in snake_case. `id` arrives in LID or PN format depending on
+     * addressing; `phone_number` is the PN JID when baileys knows it.
+     */
+    constructor(_raw) {
+        this._raw = _raw;
     }
-    /** JID único. / Unique JID. */
-    get id() {
-        return this._raw.id;
+    /** Nombre: agenda → público → verificado → teléfono. / Name: address book → public → verified → phone. */
+    get name() {
+        const { name, notify, verified_name } = this._raw;
+        return name ?? notify ?? verified_name ?? this.phone ?? this._raw.id.split('@')[0];
     }
-    /** JID (alias). / JID (alias). */
+    /**
+     * JID legado (`@s.whatsapp.net`): el reportado por baileys o generado desde el id
+     * cuando ya viene en formato PN; null si no es determinable.
+     * Legacy JID (`@s.whatsapp.net`): the one baileys reports or generated from the id
+     * when it is already PN-formatted; null when not determinable.
+     */
     get jid() {
-        return this._raw.id;
+        if (this._raw.phone_number)
+            return (0, baileys_1.jidNormalizedUser)(this._raw.phone_number);
+        if (this._raw.id.endsWith('@s.whatsapp.net'))
+            return (0, baileys_1.jidNormalizedUser)(this._raw.id);
+        return null;
     }
-    /** LID si está disponible. / LID when available. */
+    /** LID (`@lid`) cuando es definible; null si no. / LID (`@lid`) when definable; null otherwise. */
     get lid() {
-        return this._raw.lid ?? null;
-    }
-    /** Nombre: local → push → teléfono. / Name: local → push → phone. */
-    get name() {
-        return contact_name(this._raw);
+        if (this._raw.lid)
+            return this._raw.lid;
+        if (this._raw.id.endsWith('@lid'))
+            return this._raw.id;
+        return null;
     }
-    /** Número sin formato. / Raw phone number. */
+    /**
+     * Teléfono del contacto, derivado únicamente del JID PN (nunca del LID);
+     * null cuando no hay JID determinable.
+     * Contact phone, derived from the PN JID only (never from the LID);
+     * null when no JID is determinable.
+     */
     get phone() {
-        return this._raw.id.split('@')[0];
+        return this.jid?.split('@')[0] ?? null;
     }
-    /** URL de foto de perfil. / Profile picture URL. */
+    /** URL de la foto de perfil, o null. / Profile picture URL, or null. */
     get photo() {
-        return this._raw.img_url ?? null;
-    }
-    /** Bio del contacto. / Contact bio. */
-    get content() {
-        return this._raw.status ?? '';
-    }
-    /**
-     * Chat 1:1 asociado al contacto. Async por coherencia con `Message.chat()` /
-     * `Message.author()`, aunque la instancia ya está hidratada en memoria.
-     * 1:1 chat associated with the contact. Async for consistency with
-     * `Message.chat()` / `Message.author()`, though already hydrated in memory.
-     */
-    async chat() {
-        return this._chat;
+        const url = this._raw.img_url;
+        return url?.startsWith('http') ? url : null;
     }
 }
 exports.Contact = Contact;
@@ -75,173 +73,81 @@ exports.Contact = Contact;
  * @param wa - Instancia principal / Main WhatsApp instance
  */
 function contact(wa) {
-    /**
-     * Descubre el JID canónico y el LID (cuando aplica) de un número consultando al socket.
-     * Discovers the canonical JID and LID (when applicable) of a phone number via the socket.
-     */
-    async function discover_by_phone(phone) {
-        let result = null;
-        if (wa._socket && phone.length > 0) {
-            const found = (await wa._socket.onWhatsApp(phone))?.[0];
-            if (found?.exists) {
-                result = { jid: (0, baileys_1.jidNormalizedUser)(found.jid), lid: found.lid ?? null };
-            }
-        }
-        return result;
-    }
-    /**
-     * Obtiene foto y bio del contacto desde el socket.
-     * Fetches profile picture and bio from the socket.
-     */
-    async function fetch_profile_data(id) {
-        let img_url = null;
-        let status = null;
-        if (wa._socket) {
-            try {
-                img_url = (await wa._socket.profilePictureUrl(id, 'image')) ?? null;
-            }
-            catch {
-                /* may not exist */
-            }
-            try {
-                const result = await wa._socket.fetchStatus(id);
-                const data = result?.[0];
-                status = data?.status?.status ?? null;
-            }
-            catch {
-                /* may fail */
-            }
-        }
-        return { img_url, status };
-    }
-    /**
-     * Carga la instancia Chat 1:1 del contacto. Si no existe en engine, fabrica una mínima.
-     * Loads the 1:1 Chat instance for a contact. Falls back to a minimal instance if missing.
-     */
-    async function load_chat_for(jid, fallback_name) {
-        const cached = (0, store_1.deserialize)(await wa.engine.get(`/chat/${jid}`));
-        return new wa.Chat(cached ?? { id: jid, name: fallback_name });
-    }
     return class _Contact extends Contact {
-        constructor(raw, chat) {
-            super(raw, chat);
-        }
-        /** Chat 1:1 asociado (subclase enriquecida). / Associated 1:1 chat (enriched subclass). */
+        /**
+         * Chat 1:1 del contacto: el persistido en el engine, o una instancia mínima.
+         * The contact's 1:1 chat: the engine-persisted one, or a minimal instance.
+         *
+         * @returns Instancia de Chat / Chat instance
+         */
         async chat() {
-            return this._chat;
-        }
-        /** true si la instancia representa la cuenta autenticada. / true if this instance is the authenticated account. */
-        get me() {
-            const self_id = wa._socket?.user?.id;
-            return Boolean(self_id) && (0, baileys_1.jidNormalizedUser)(self_id) === this.id;
+            const cid = this.jid ?? this.lid ?? this._raw.id;
+            const cached = (0, store_1.deserialize)(await wa.engine.get(`/chat/${cid}`));
+            return new wa.Chat(cached ?? { id: cid, name: this.name });
         }
         /**
-         * Obtiene un contacto. Dispatch inteligente:
-         * - Si `uid` contiene `@` → se interpreta como JID (`@s.whatsapp.net` / `@g.us`) o LID (`@lid`) y se resuelve con el mapping.
-         * - Si no contiene `@` → se limpian los dígitos y se consulta `socket.onWhatsApp(phone)` para obtener el JID canónico.
+         * Carga un contacto por teléfono, JID o LID: primero el engine; si no está
+         * persistido lo descubre por red (`onWhatsApp` + foto + bio) y lo materializa.
+         * Loads a contact by phone, JID or LID: engine first; when not persisted it
+         * discovers it over the network (`onWhatsApp` + photo + bio) and materializes it.
          *
-         * Retrieves a contact. Smart dispatch:
-         * - If `uid` contains `@` → treated as JID or LID, resolved via mapping.
-         * - If `uid` lacks `@` → digits are extracted and `socket.onWhatsApp(phone)` resolves the canonical JID.
+         * @param uid - Teléfono, JID o LID / Phone, JID or LID
+         * @returns Contacto o null si no existe en WhatsApp / Contact or null when not on WhatsApp
          */
         static async get(uid) {
-            let result = null;
-            let jid = null;
-            let lid = null;
-            if (uid.includes('@')) {
-                jid = await wa._resolve_jid(uid);
-            }
-            else {
-                const discovered = await discover_by_phone(uid.replace(/\D+/g, ''));
-                if (discovered) {
-                    jid = discovered.jid;
-                    lid = discovered.lid;
-                }
-            }
+            const digits = String(uid).replace(/\D+/g, '');
+            const jid = String(uid).includes('@')
+                ? await (0, internal_1.internals)(wa).resolve_jid(String(uid))
+                : digits
+                    ? `${digits}@s.whatsapp.net`
+                    : null;
             if (jid && !jid.endsWith('@g.us')) {
                 const cached = (0, store_1.deserialize)(await wa.engine.get(`/contact/${jid}`));
-                if (cached) {
-                    result = new _Contact(cached, await load_chat_for(jid, contact_name(cached)));
-                }
-                else if (wa._socket) {
-                    const needs_check = !lid && !uid.endsWith('@lid');
-                    const discovered = needs_check
-                        ? await discover_by_phone(jid.split('@')[0])
-                        : { jid, lid };
-                    if (discovered) {
-                        const { img_url, status } = await fetch_profile_data(discovered.jid);
+                if (cached)
+                    return new _Contact(cached);
+                const socket = (0, internal_1.internals)(wa).socket;
+                if (socket) {
+                    const found = (await socket.onWhatsApp(jid.split('@')[0]))?.[0];
+                    if (found?.exists) {
+                        const id = (0, baileys_1.jidNormalizedUser)(found.jid);
+                        const img_url = await socket.profilePictureUrl(id, 'image').catch(() => null);
+                        const status = await socket
+                            .fetchStatus(id)
+                            .then((result) => result?.[0]?.status?.status ?? null)
+                            .catch(() => null);
                         const raw = {
-                            id: discovered.jid,
-                            lid: discovered.lid,
+                            id,
+                            lid: found.lid ?? null,
+                            phone_number: id,
                             name: null,
                             notify: null,
                             verified_name: null,
-                            img_url,
+                            img_url: img_url ?? null,
                             status,
                         };
-                        await wa.engine.set(`/contact/${discovered.jid}`, (0, store_1.serialize)(raw));
-                        if (discovered.lid) {
-                            await wa.engine.set(`/lid/${discovered.lid}`, (0, store_1.serialize)(discovered.jid));
+                        await wa.engine.set(`/contact/${id}`, (0, store_1.serialize)(raw));
+                        if (found.lid) {
+                            await wa.engine.set(`/lid/${found.lid}`, (0, store_1.serialize)(id));
                         }
-                        result = new _Contact(raw, await load_chat_for(discovered.jid, discovered.jid.split('@')[0]));
+                        return new _Contact(raw);
                     }
                 }
             }
-            return result;
+            return null;
         }
         /**
-         * Pagina los contactos persistidos por mtime DESC, pre-cargando el chat de cada uno.
-         * Paginates persisted contacts by mtime DESC, pre-loading the chat of each one.
+         * Pagina los contactos persistidos.
+         * Paginates persisted contacts.
+         *
+         * @param offset - Desplazamiento / Offset
+         * @param limit - Tamaño de página / Page size
+         * @returns Página de contactos / Contact page
          */
         static async list(offset = 0, limit = 50) {
-            const contacts = [];
-            for (const raw of await wa.engine.list('/contact', offset, limit)) {
-                const parsed = (0, store_1.deserialize)(raw);
-                if (parsed) {
-                    contacts.push(new _Contact(parsed, await load_chat_for(parsed.id, contact_name(parsed))));
-                }
-            }
-            return contacts;
-        }
-        /**
-         * Renombra localmente un contacto por id.
-         * Renames a contact locally by id.
-         */
-        static async rename(uid, name) {
-            const c = await _Contact.get(uid);
-            return c ? c.rename(name) : false;
-        }
-        /**
-         * Re-hidrata los datos del contacto por id desde el socket.
-         * Re-hydrates contact data from the socket by id.
-         */
-        static async refresh(uid) {
-            const c = await _Contact.get(uid);
-            return c ? c.refresh() : null;
-        }
-        /**
-         * Renombra el contacto localmente (solo agenda del dispositivo).
-         * Renames the contact locally (device address book only).
-         */
-        async rename(name) {
-            this._raw.name = name;
-            await wa.engine.set(`/contact/${this.id}`, (0, store_1.serialize)(this._raw));
-            return true;
-        }
-        /**
-         * Re-hidrata foto y bio desde el socket.
-         * Re-hydrates profile picture and bio from the socket.
-         */
-        async refresh() {
-            let ok = false;
-            if (wa._socket) {
-                const { img_url, status } = await fetch_profile_data(this.id);
-                this._raw.img_url = img_url;
-                this._raw.status = status;
-                await wa.engine.set(`/contact/${this.id}`, (0, store_1.serialize)(this._raw));
-                ok = true;
-            }
-            return ok ? this : null;
+            return (await wa.engine.list('/contact', offset, limit))
+                .map((raw) => (0, store_1.deserialize)(raw))
+                .filter((parsed) => parsed !== null)
+                .map((parsed) => new _Contact(parsed));
         }
     };
 }

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

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

package/build/cjs/lib/internal.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @file internal.ts
+ * @description Canal privado entre el cliente y sus entidades. Vive en un `WeakMap` fuera de
+ * la instancia, así el socket de baileys y la resolución de JIDs quedan disponibles para
+ * `Contact`, `Chat`, `Message` y `Feed` sin exponerse en la superficie pública de `WhatsApp`:
+ * el consumidor sólo ve `on`/`once`/`off`/`emit` y los métodos documentados.
+ * Private channel between the client and its entities. It lives in a `WeakMap` outside the
+ * instance, so the baileys socket and JID resolution stay available to `Contact`, `Chat`,
+ * `Message` and `Feed` without surfacing on `WhatsApp`'s public API: consumers only see
+ * `on`/`once`/`off`/`emit` and the documented methods.
+ */
+import type { WASocket } from 'baileys';
+/**
+ * Estado que el cliente comparte con sus entidades.
+ * State the client shares with its entities.
+ */
+export interface Internals {
+    /** Socket vivo de baileys, o null mientras no hay conexión. / Live baileys socket, or null while disconnected. */
+    socket: WASocket | null;
+    /** Normaliza cualquier identificador (JID, LID o teléfono) a JID canónico. / Normalizes any identifier (JID, LID or phone) into a canonical JID. */
+    resolve_jid(uid: string): Promise<string | null>;
+}
+/**
+ * Publica el estado interno de un cliente para las entidades de la librería.
+ * Publishes a client's internal state for the library entities.
+ *
+ * @param owner - Cliente dueño del estado / Client owning the state
+ * @param state - Estado compartido, mutable por el cliente / Shared state, mutated by the client
+ */
+export declare function bind(owner: object, state: Internals): void;
+/**
+ * Estado interno del cliente. Sólo lo resuelven los módulos de la librería: el objeto
+ * nunca se expone al consumidor.
+ * A client's internal state. Only library modules resolve it: the object is never exposed
+ * to the consumer.
+ *
+ * @param owner - Cliente construido por la librería / Client built by the library
+ * @returns Estado compartido / Shared state
+ */
+export declare function internals(owner: object): Internals;

package/build/cjs/lib/internal.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @file internal.ts
+ * @description Canal privado entre el cliente y sus entidades. Vive en un `WeakMap` fuera de
+ * la instancia, así el socket de baileys y la resolución de JIDs quedan disponibles para
+ * `Contact`, `Chat`, `Message` y `Feed` sin exponerse en la superficie pública de `WhatsApp`:
+ * el consumidor sólo ve `on`/`once`/`off`/`emit` y los métodos documentados.
+ * Private channel between the client and its entities. It lives in a `WeakMap` outside the
+ * instance, so the baileys socket and JID resolution stay available to `Contact`, `Chat`,
+ * `Message` and `Feed` without surfacing on `WhatsApp`'s public API: consumers only see
+ * `on`/`once`/`off`/`emit` and the documented methods.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bind = bind;
+exports.internals = internals;
+const channel = new WeakMap();
+/**
+ * Publica el estado interno de un cliente para las entidades de la librería.
+ * Publishes a client's internal state for the library entities.
+ *
+ * @param owner - Cliente dueño del estado / Client owning the state
+ * @param state - Estado compartido, mutable por el cliente / Shared state, mutated by the client
+ */
+function bind(owner, state) {
+    channel.set(owner, state);
+}
+/**
+ * Estado interno del cliente. Sólo lo resuelven los módulos de la librería: el objeto
+ * nunca se expone al consumidor.
+ * A client's internal state. Only library modules resolve it: the object is never exposed
+ * to the consumer.
+ *
+ * @param owner - Cliente construido por la librería / Client built by the library
+ * @returns Estado compartido / Shared state
+ */
+function internals(owner) {
+    return channel.get(owner);
+}
+//# sourceMappingURL=internal.js.map

package/build/cjs/lib/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../../src/lib/internal.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAwBH,oBAEC;AAWD,8BAEC;AAxBD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAqB,CAAC;AAEjD;;;;;;GAMG;AACH,SAAgB,IAAI,CAAC,KAAa,EAAE,KAAgB;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,KAAa;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;AAC/B,CAAC"}