@arcaelas/whatsapp 1.2.2 → 1.4.0

package/build/esm/Contact.js

@@ -0,0 +1,183 @@
+/**
+ * @file Contact.ts
+ * @description Clase Contact para gestión de contactos de WhatsApp
+ */
+import { BufferJSON, jidNormalizedUser } from 'baileys';
+/**
+ * @description
+ * Clase base para representar un contacto de WhatsApp.
+ * Usar Contact.get() para obtener instancias.
+ */
+export class Contact {
+    constructor(data) {
+        this.raw = data.raw;
+    }
+    /** JID único del contacto */
+    get id() {
+        return this.raw.id;
+    }
+    /** Nombre del contacto */
+    get name() {
+        return this.raw.name ?? this.raw.notify ?? this.raw.id.split('@')[0];
+    }
+    /** URL de la foto de perfil o null */
+    get photo() {
+        return this.raw.imgUrl ?? null;
+    }
+    /** Número de teléfono sin formato */
+    get phone() {
+        return this.raw.id.split('@')[0];
+    }
+    /** Bio del contacto */
+    get content() {
+        return this.raw.status ?? '';
+    }
+}
+/**
+ * @description Construye IContact desde raw.
+ * @param raw Objeto raw del contacto.
+ * @returns IContact normalizado.
+ */
+export function build_contact(raw) {
+    return {
+        id: raw.id,
+        name: raw.name ?? raw.notify ?? raw.id.split('@')[0],
+        photo: raw.imgUrl ?? null,
+        phone: raw.id.split('@')[0],
+        content: raw.status ?? '',
+        raw,
+    };
+}
+/**
+ * @description Factory que retorna la clase Contact enlazada al contexto.
+ * @param wa Instancia de WhatsApp.
+ * @returns Clase _Contact que extiende Contact.
+ */
+export function contact(wa) {
+    return class _Contact extends Contact {
+        /**
+         * @description Obtiene un contacto por su ID.
+         * @param uid JID del contacto (@s.whatsapp.net) o número de teléfono.
+         * @returns Contacto o null si no existe.
+         */
+        static async get(uid) {
+            const jid = uid.includes('@') ? uid : `${uid}@s.whatsapp.net`;
+            const stored = await wa.engine.get(`contact/${jid}/index`);
+            if (stored)
+                return new _Contact(JSON.parse(stored, BufferJSON.reviver));
+            if (!wa.socket)
+                return null;
+            const found = (await wa.socket.onWhatsApp(jid.split('@')[0]))?.[0];
+            if (!found?.exists)
+                return null;
+            const id = jidNormalizedUser(found.jid);
+            const raw = { id, name: null, notify: null, imgUrl: null, status: null };
+            // Obtener foto de perfil
+            try {
+                raw.imgUrl = (await wa.socket.profilePictureUrl(id, 'image')) ?? null;
+            }
+            catch { /* profile picture may not exist */ }
+            // Obtener estado/bio
+            try {
+                const result = await wa.socket.fetchStatus(id);
+                const status_data = result?.[0];
+                raw.status = status_data?.status?.status ?? null;
+            }
+            catch { /* status fetch may fail */ }
+            const data = build_contact(raw);
+            await wa.engine.set(`contact/${id}/index`, JSON.stringify(data, BufferJSON.replacer));
+            return new _Contact(data);
+        }
+        /**
+         * @description Actualiza los datos del perfil desde WhatsApp.
+         * @param uid JID del contacto.
+         * @returns Contacto actualizado o null.
+         */
+        static async refresh(uid) {
+            const jid = uid.includes('@') ? uid : `${uid}@s.whatsapp.net`;
+            if (!wa.socket)
+                return null;
+            const stored = await wa.engine.get(`contact/${jid}/index`);
+            const data = stored ? JSON.parse(stored, BufferJSON.reviver) : build_contact({ id: jid });
+            // Obtener foto de perfil
+            try {
+                data.raw.imgUrl = (await wa.socket.profilePictureUrl(jid, 'image')) ?? null;
+                data.photo = data.raw.imgUrl;
+            }
+            catch { /* profile picture may not exist */ }
+            // Obtener estado/bio
+            try {
+                const result = await wa.socket.fetchStatus(jid);
+                const status_data = result?.[0];
+                data.raw.status = status_data?.status?.status ?? null;
+                data.content = data.raw.status ?? '';
+            }
+            catch { /* status fetch may fail */ }
+            await wa.engine.set(`contact/${jid}/index`, JSON.stringify(data, BufferJSON.replacer));
+            return new _Contact(data);
+        }
+        /**
+         * @description Cambia el nombre de un contacto.
+         * @param uid JID del contacto.
+         * @param name Nuevo nombre.
+         * @returns true si se guardó correctamente.
+         */
+        static async rename(uid, name) {
+            const jid = uid.includes('@') ? uid : `${uid}@s.whatsapp.net`;
+            const stored = await wa.engine.get(`contact/${jid}/index`);
+            if (!stored)
+                return false;
+            const data = JSON.parse(stored, BufferJSON.reviver);
+            data.raw.name = name;
+            data.name = name;
+            await wa.engine.set(`contact/${jid}/index`, JSON.stringify(data, BufferJSON.replacer));
+            return true;
+        }
+        /**
+         * @description Obtiene contactos paginados.
+         * @param offset Inicio de paginación.
+         * @param limit Cantidad máxima de resultados.
+         * @returns Array de contactos.
+         */
+        static async paginate(offset = 0, limit = 50) {
+            const contacts = [];
+            for (const key of await wa.engine.list('contact/', offset, limit, '/index')) {
+                const stored = await wa.engine.get(key);
+                if (stored)
+                    contacts.push(new _Contact(JSON.parse(stored, BufferJSON.reviver)));
+            }
+            return contacts;
+        }
+        /**
+         * @description Cambia el nombre del contacto.
+         * @param name Nuevo nombre.
+         * @returns true si se guardó correctamente.
+         */
+        async rename(name) {
+            const result = await _Contact.rename(this.id, name);
+            if (result)
+                this.raw.name = name;
+            return result;
+        }
+        /**
+         * @description Actualiza los datos del perfil desde WhatsApp.
+         * @returns this con datos actualizados, o null si falla.
+         */
+        async refresh() {
+            const updated = await _Contact.refresh(this.id);
+            if (!updated)
+                return null;
+            // Actualizar raw con los nuevos datos
+            Object.assign(this.raw, updated.raw);
+            return this;
+        }
+        /**
+         * @description Obtiene o crea el chat con este contacto.
+         * @returns Chat asociado al contacto.
+         */
+        async chat() {
+            return wa.Chat.get(this.id);
+        }
+    };
+}
+//# sourceMappingURL=Contact.js.map

package/build/esm/Contact.js.map

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