@arcaelas/whatsapp 2.2.0 → 3.0.2

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

@@ -0,0 +1,221 @@
+/**
+ * @file contact/index.ts
+ * @description Entidad Contact — lectura/escritura documental sobre `wa.engine`.
+ * Contact entity — documental read/write over `wa.engine`.
+ */
+import { jidNormalizedUser } from 'baileys';
+import { deserialize, serialize } from '../../lib/store/index.js';
+/**
+ * Clase base del contacto (forma pública, solo lectura).
+ * Base Contact class (public shape, read-only).
+ */
+export class Contact {
+    constructor(raw, chat) {
+        this._raw = raw;
+        this.chat = chat;
+    }
+    /** JID único. / Unique JID. */
+    get id() {
+        return this._raw.id;
+    }
+    /** JID (alias). / JID (alias). */
+    get jid() {
+        return this._raw.id;
+    }
+    /** LID si está disponible. / LID when available. */
+    get lid() {
+        return this._raw.lid ?? null;
+    }
+    /** Nombre: local → push → teléfono. / Name: local → push → phone. */
+    get name() {
+        return this._raw.name ?? this._raw.notify ?? this._raw.id.split('@')[0];
+    }
+    /** Número sin formato. / Raw phone number. */
+    get phone() {
+        return this._raw.id.split('@')[0];
+    }
+    /** URL de foto de perfil. / Profile picture URL. */
+    get photo() {
+        return this._raw.img_url ?? null;
+    }
+    /** Bio del contacto. / Contact bio. */
+    get content() {
+        return this._raw.status ?? '';
+    }
+}
+/**
+ * Factoría de Contact ligada al contexto WhatsApp.
+ * Context-bound Contact factory.
+ *
+ * @param wa - Instancia principal / Main WhatsApp instance
+ */
+export 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: 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 = 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);
+        }
+        /** 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) && jidNormalizedUser(self_id) === this.id;
+        }
+        /**
+         * 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.
+         *
+         * 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.
+         */
+        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;
+                }
+            }
+            if (jid && !jid.endsWith('@g.us')) {
+                const cached = deserialize(await wa.engine.get(`/contact/${jid}`));
+                if (cached) {
+                    const fallback_name = cached.name ?? cached.notify ?? jid.split('@')[0];
+                    result = new _Contact(cached, await load_chat_for(jid, fallback_name));
+                }
+                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);
+                        const raw = {
+                            id: discovered.jid,
+                            lid: discovered.lid,
+                            name: null,
+                            notify: null,
+                            verified_name: null,
+                            img_url,
+                            status,
+                        };
+                        await wa.engine.set(`/contact/${discovered.jid}`, serialize(raw));
+                        if (discovered.lid) {
+                            await wa.engine.set(`/lid/${discovered.lid}`, serialize(discovered.jid));
+                        }
+                        result = new _Contact(raw, await load_chat_for(discovered.jid, discovered.jid.split('@')[0]));
+                    }
+                }
+            }
+            return result;
+        }
+        /**
+         * 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.
+         */
+        static async list(offset = 0, limit = 50) {
+            const contacts = [];
+            for (const raw of await wa.engine.list('/contact', offset, limit)) {
+                const parsed = deserialize(raw);
+                if (parsed) {
+                    const fallback_name = parsed.name ?? parsed.notify ?? parsed.id.split('@')[0];
+                    contacts.push(new _Contact(parsed, await load_chat_for(parsed.id, fallback_name)));
+                }
+            }
+            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}`, 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}`, serialize(this._raw));
+                ok = true;
+            }
+            return ok ? this : null;
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

package/build/esm/lib/message/index.d.ts

@@ -0,0 +1,237 @@
+/**
+ * @file message/index.ts
+ * @description Entidad Message — una sola clase base que recibe `{wa, doc}` en el constructor.
+ * Subclases especializadas (Text, Image, Video, Audio, Gps, Poll) override `content()` según su tipo.
+ */
+import { type WAMessage } from 'baileys';
+import { Readable } from 'node:stream';
+import { Chat } from '../../lib/chat/index.js';
+import { Contact } from '../../lib/contact/index.js';
+import type { WhatsApp } from '../../lib/whatsapp/index.js';
+/** Destino aceptado por `forward`: CID (string), Chat o Contact. */
+export type ForwardTarget = string | Chat | Contact;
+/** Tipos de mensaje internos (no expuestos como getter público). */
+export type MessageType = 'text' | 'image' | 'video' | 'audio' | 'location' | 'poll';
+export declare enum MessageStatus {
+    ERROR = 0,
+    PENDING = 1,
+    SERVER_ACK = 2,
+    DELIVERED = 3,
+    READ = 4,
+    PLAYED = 5
+}
+export interface SendOptions {
+    mid?: string;
+}
+export interface SendMediaOptions extends SendOptions {
+    caption?: string;
+}
+export interface SendAudioOptions extends SendOptions {
+    ptt?: boolean;
+}
+export interface LocationOptions {
+    lat: number;
+    lng: number;
+    live?: boolean;
+}
+export interface PollOptions {
+    content: string;
+    options: Array<{
+        content: string;
+    }>;
+}
+/**
+ * Documento persistido del mensaje.
+ */
+export interface IMessage {
+    id: string;
+    cid: string;
+    mid: string | null;
+    me: boolean;
+    type: MessageType;
+    author: string;
+    status: MessageStatus;
+    starred: boolean;
+    forwarded: boolean;
+    created_at: number;
+    deleted_at: number | null;
+    mime: string;
+    caption: string;
+    edited: boolean;
+    raw: WAMessage;
+}
+/**
+ * Construye el documento IMessage desde el raw de baileys.
+ */
+export declare function build_message_doc(raw: WAMessage, self_id?: string, edited?: boolean): IMessage;
+/**
+ * Clase base del mensaje. Una sola clase — toda la API de instancia vive aquí.
+ * Base message class. Single class — all instance API lives here.
+ */
+export declare class Message {
+    /** @internal */
+    protected readonly _wa: WhatsApp;
+    /** @internal */
+    protected readonly _doc: IMessage;
+    constructor(options: {
+        wa: WhatsApp;
+        doc: IMessage;
+    });
+    get id(): string;
+    get cid(): string;
+    get type(): MessageType;
+    /** JID del autor del mensaje. Para acceso síncrono sin hidratar el Contact. */
+    get from(): string;
+    /** MIME type del contenido. `text/plain` para texto, `application/json` para location/poll, mimetype real para media. */
+    get mime(): string;
+    get mid(): string | null;
+    get me(): boolean;
+    get caption(): string;
+    get starred(): boolean;
+    get forwarded(): boolean;
+    get once(): boolean;
+    get created_at(): number;
+    get deleted_at(): number | null;
+    get status(): MessageStatus;
+    get edited(): boolean;
+    /** Contacto del autor (resuelve vía `wa.Contact.get`; fallback a instancia mínima). */
+    author(): Promise<InstanceType<typeof this._wa.Contact>>;
+    /** Chat al que pertenece el mensaje. */
+    chat(): Promise<InstanceType<typeof this._wa.Chat>>;
+    /** Contenido sin parsear, directo del engine. Las subclases override según su tipo. */
+    content(): Promise<Buffer>;
+    /**
+     * Devuelve un `Readable` con los bytes del mensaje. Para media (image/video/audio)
+     * lee desde el cache del engine o, si falta, descarga desde baileys. Para text/location/poll
+     * retorna el mismo binario que `content()` envuelto en un Readable.
+     * Returns a `Readable` of the message bytes. For media (image/video/audio) it reads
+     * from the engine cache or, if missing, downloads from baileys. For text/location/poll
+     * it wraps the `content()` buffer in a Readable.
+     */
+    stream(): Promise<Readable>;
+    /** Reacciona al mensaje (emoji vacío para retirar). */
+    react(emoji: string): Promise<boolean>;
+    /** Reenvía el mensaje a un destino (CID, Chat o Contact). */
+    forward(target: ForwardTarget): Promise<boolean>;
+    /** Marca el mensaje como leído. */
+    seen(): Promise<boolean>;
+    /** Destaca/retira destacado del mensaje. */
+    star(value: boolean): Promise<boolean>;
+    /** Elimina el mensaje. `all=true` (default) borra para todos; `all=false` borra sólo en mi dispositivo. */
+    delete(all?: boolean): Promise<boolean>;
+    /** Edita el texto/caption del mensaje (solo propios editables). */
+    edit(text: string): Promise<boolean>;
+    /** Observa cambios sobre este mensaje. Retorna unsubscribe. / Watches this message. Returns unsubscribe. */
+    watch(handler: (msg: Message) => void): () => void;
+    /** Responde con texto. */
+    text(caption: string, opts?: SendOptions): Promise<Message | null>;
+    /** Responde con imagen. */
+    image(buf: Buffer, opts?: SendMediaOptions): Promise<Message | null>;
+    /** Responde con video. */
+    video(buf: Buffer, opts?: SendMediaOptions): Promise<Message | null>;
+    /** Responde con audio. */
+    audio(buf: Buffer, opts?: SendAudioOptions): Promise<Message | null>;
+    /** Responde con ubicación. */
+    location(loc: LocationOptions, opts?: SendOptions): Promise<Message | null>;
+    /** Responde con encuesta. */
+    poll(poll: PollOptions, opts?: SendOptions): Promise<Message | null>;
+}
+/**
+ * Mensaje de texto. Override `content()` para retornar el caption como Buffer sin pasar por engine.
+ * Text message. Overrides `content()` returning caption as Buffer directly.
+ */
+export declare class Text extends Message {
+    content(): Promise<Buffer>;
+}
+/**
+ * Mensaje de imagen. Hereda `stream()` de la clase base; `content()` drena el stream.
+ * Image message. Inherits `stream()` from the base class; `content()` drains the stream.
+ */
+export declare class Image extends Message {
+    content(): Promise<Buffer>;
+}
+/**
+ * Mensaje de video. Hereda `stream()` de la clase base; `content()` drena el stream.
+ * Video message. Inherits `stream()` from the base class; `content()` drains the stream.
+ */
+export declare class Video extends Message {
+    content(): Promise<Buffer>;
+}
+/**
+ * Mensaje de audio. Hereda `stream()` de la clase base; `content()` drena el stream.
+ * `ptt` indica si es nota de voz (push-to-talk).
+ * Audio message. Inherits `stream()` from the base class; `content()` drains the stream.
+ * `ptt` flags voice notes.
+ */
+export declare class Audio extends Message {
+    /** true si es nota de voz (push-to-talk). / true if push-to-talk voice note. */
+    get ptt(): boolean;
+    content(): Promise<Buffer>;
+}
+/**
+ * Mensaje de ubicación. Agrega getters sync `lat`, `lng`, `link` derivados del raw.
+ * Location message. Adds sync getters `lat`, `lng`, `link` derived from raw.
+ */
+export declare class Gps extends Message {
+    private get _loc();
+    /** Latitud en grados. / Latitude in degrees. */
+    get lat(): number;
+    /** Longitud en grados. / Longitude in degrees. */
+    get lng(): number;
+    /** URL de Google Maps apuntando a la coordenada. / Google Maps URL for the coordinate. */
+    get link(): string;
+    /** true si es ubicación en tiempo real. / true when live location. */
+    get live(): boolean;
+}
+/**
+ * Mensaje de encuesta. `caption` es la pregunta (heredada); agrega `options[]` con conteo y `multiple`.
+ * Poll message. `caption` is the question (inherited); adds `options[]` with counts and `multiple`.
+ */
+export declare class Poll extends Message {
+    private get _poll();
+    /** true si admite múltiples respuestas. / true if it accepts multiple answers. */
+    get multiple(): boolean;
+    /** Opciones con conteo de votos actualizado. / Options with up-to-date vote counts. */
+    get options(): {
+        content: string;
+        count: number;
+    }[];
+    /**
+     * Vota en la encuesta. Acepta un índice o lista de índices (para `multiple`).
+     * Votes in the poll. Accepts a single index or list (for `multiple`).
+     */
+    select(index: number | number[]): Promise<boolean>;
+}
+/**
+ * Factoría que enlaza los statics a `wa` y expone las subclases.
+ * Factory binding statics to `wa` and exposing subclasses.
+ */
+export declare function message(wa: WhatsApp): {
+    Text: typeof Text;
+    Image: typeof Image;
+    Video: typeof Video;
+    Audio: typeof Audio;
+    Gps: typeof Gps;
+    Poll: typeof Poll;
+    build_message_doc: typeof build_message_doc;
+    build_instance: (doc: IMessage) => Promise<Message>;
+    /** Obtiene un mensaje por CID/MID. */
+    get(cid: string, mid: string): Promise<Message | null>;
+    /** Pagina mensajes de un chat. */
+    list(cid: string, offset?: number, limit?: number): Promise<Message[]>;
+    /** Cuenta mensajes de un chat. */
+    count(cid: string): Promise<number>;
+    text(cid: string, caption: string, opts?: SendOptions): Promise<Message | null>;
+    image(cid: string, buf: Buffer, opts?: SendMediaOptions): Promise<Message | null>;
+    video(cid: string, buf: Buffer, opts?: SendMediaOptions): Promise<Message | null>;
+    audio(cid: string, buf: Buffer, opts?: SendAudioOptions): Promise<Message | null>;
+    location(cid: string, loc: LocationOptions, opts?: SendOptions): Promise<Message | null>;
+    poll(cid: string, p: PollOptions, opts?: SendOptions): Promise<Message | null>;
+    edit(cid: string, mid: string, text: string): Promise<boolean>;
+    delete(cid: string, mid: string, all?: boolean): Promise<boolean>;
+    react(cid: string, mid: string, emoji: string): Promise<boolean>;
+    forward(cid: string, mid: string, target: ForwardTarget): Promise<boolean>;
+    seen(cid: string, mid: string): Promise<boolean>;
+    star(cid: string, mid: string, value: boolean): Promise<boolean>;
+    watch(cid: string, mid: string, handler: (msg: Message) => void): () => void;
+};