@arcaelas/whatsapp 3.4.0 → 4.2.0

package/build/cjs/lib/contact/index.d.ts

@@ -25,8 +25,8 @@ export interface IContactRaw {
 export declare class Contact {
     /** @internal Shape persistido. Uso interno (convención underscore). / Internal persisted shape. */
     readonly _raw: IContactRaw;
-    /** Chat 1:1 asociado (hidratado). / Associated 1:1 chat (hydrated). */
-    readonly chat: Chat;
+    /** @internal Chat 1:1 asociado ya hidratado. / Internal already-hydrated 1:1 chat. */
+    readonly _chat: Chat;
     constructor(raw: IContactRaw, chat: Chat);
     /** JID único. / Unique JID. */
     get id(): string;
@@ -42,6 +42,13 @@ export declare class Contact {
     get photo(): string | null;
     /** Bio del contacto. / Contact bio. */
     get content(): string;
+    /**
+     * 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.
+     */
+    chat(): Promise<Chat>;
 }
 /**
  * Factoría de Contact ligada al contexto WhatsApp.
@@ -51,8 +58,10 @@ export declare class Contact {
  */
 export declare function contact(wa: WhatsApp): {
     new (raw: IContactRaw, chat: InstanceType<typeof wa.Chat>): {
-        /** Chat 1:1 asociado como subclase enriquecida. / Associated 1:1 chat as enriched subclass. */
-        readonly chat: InstanceType<typeof wa.Chat>;
+        /** @internal Chat 1:1 hidratado como subclase enriquecida. / Internal hydrated 1:1 chat as enriched subclass. */
+        readonly _chat: InstanceType<typeof wa.Chat>;
+        /** Chat 1:1 asociado (subclase enriquecida). / Associated 1:1 chat (enriched subclass). */
+        chat(): Promise<InstanceType<typeof wa.Chat>>;
         /** true si la instancia representa la cuenta autenticada. / true if this instance is the authenticated account. */
         get me(): boolean;
         /**
@@ -92,8 +101,10 @@ export declare function contact(wa: WhatsApp): {
      * - If `uid` lacks `@` → digits are extracted and `socket.onWhatsApp(phone)` resolves the canonical JID.
      */
     get(uid: string): Promise<{
-        /** Chat 1:1 asociado como subclase enriquecida. / Associated 1:1 chat as enriched subclass. */
-        readonly chat: InstanceType<typeof wa.Chat>;
+        /** @internal Chat 1:1 hidratado como subclase enriquecida. / Internal hydrated 1:1 chat as enriched subclass. */
+        readonly _chat: InstanceType<typeof wa.Chat>;
+        /** Chat 1:1 asociado (subclase enriquecida). / Associated 1:1 chat (enriched subclass). */
+        chat(): Promise<InstanceType<typeof wa.Chat>>;
         /** true si la instancia representa la cuenta autenticada. / true if this instance is the authenticated account. */
         get me(): boolean;
         /**
@@ -128,8 +139,10 @@ export declare function contact(wa: WhatsApp): {
      * Paginates persisted contacts by mtime DESC, pre-loading the chat of each one.
      */
     list(offset?: number, limit?: number): Promise<{
-        /** Chat 1:1 asociado como subclase enriquecida. / Associated 1:1 chat as enriched subclass. */
-        readonly chat: InstanceType<typeof wa.Chat>;
+        /** @internal Chat 1:1 hidratado como subclase enriquecida. / Internal hydrated 1:1 chat as enriched subclass. */
+        readonly _chat: InstanceType<typeof wa.Chat>;
+        /** Chat 1:1 asociado (subclase enriquecida). / Associated 1:1 chat (enriched subclass). */
+        chat(): Promise<InstanceType<typeof wa.Chat>>;
         /** true si la instancia representa la cuenta autenticada. / true if this instance is the authenticated account. */
         get me(): boolean;
         /**
@@ -169,8 +182,10 @@ export declare function contact(wa: WhatsApp): {
      * Re-hydrates contact data from the socket by id.
      */
     refresh(uid: string): Promise<{
-        /** Chat 1:1 asociado como subclase enriquecida. / Associated 1:1 chat as enriched subclass. */
-        readonly chat: InstanceType<typeof wa.Chat>;
+        /** @internal Chat 1:1 hidratado como subclase enriquecida. / Internal hydrated 1:1 chat as enriched subclass. */
+        readonly _chat: InstanceType<typeof wa.Chat>;
+        /** Chat 1:1 asociado (subclase enriquecida). / Associated 1:1 chat (enriched subclass). */
+        chat(): Promise<InstanceType<typeof wa.Chat>>;
         /** true si la instancia representa la cuenta autenticada. / true if this instance is the authenticated account. */
         get me(): boolean;
         /**

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

@@ -16,7 +16,7 @@ const store_1 = require("../../lib/store");
 class Contact {
     constructor(raw, chat) {
         this._raw = raw;
-        this.chat = chat;
+        this._chat = chat;
     }
     /** JID único. / Unique JID. */
     get id() {
@@ -46,6 +46,15 @@ class Contact {
     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;
+    }
 }
 exports.Contact = Contact;
 /**
@@ -106,6 +115,10 @@ function contact(wa) {
         constructor(raw, chat) {
             super(raw, chat);
         }
+        /** Chat 1:1 asociado (subclase enriquecida). / Associated 1:1 chat (enriched subclass). */
+        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;

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/message/index.d.ts

@@ -13,7 +13,7 @@ export type ForwardTarget = string | Chat | Contact;
 type ChatInstance = InstanceType<ReturnType<typeof chat>>;
 type ContactInstance = InstanceType<ReturnType<typeof contact>>;
 /** Tipos de mensaje internos (no expuestos como getter público). */
-export type MessageType = 'text' | 'image' | 'video' | 'audio' | 'location' | 'poll';
+export type MessageType = 'text' | 'image' | 'video' | 'audio' | 'location' | 'poll' | 'document' | 'vcard' | 'event';
 export declare enum MessageStatus {
     ERROR = 0,
     PENDING = 1,
@@ -35,6 +35,35 @@ export interface SendPollOptions extends SendOptions {
     /** true para selección múltiple; default false (single). / true for multi-select; default false (single). */
     multiple?: boolean;
 }
+export interface SendDocumentOptions extends SendOptions {
+    /** Nombre del archivo mostrado al receptor. / File name shown to the recipient. */
+    file_name: string;
+    /** MIME real del contenido; default `application/octet-stream`. / Real content MIME; defaults to `application/octet-stream`. */
+    mimetype?: string;
+    /** Texto adjunto opcional. / Optional attached caption. */
+    caption?: string;
+}
+export interface VCardInput {
+    /** Nombre mostrado del contacto. / Contact display name. */
+    name: string;
+    /** Teléfono en formato internacional. / Phone in international format. */
+    phone: string;
+}
+export interface EventInput {
+    /** Nombre del evento. / Event name. */
+    name: string;
+    /** Descripción opcional (texto del evento, expuesto como `caption`). / Optional description (event text, exposed as `caption`). */
+    caption?: string;
+    /** Fecha/hora de inicio. / Start date/time. */
+    start: Date;
+    /** Fecha/hora de fin opcional. / Optional end date/time. */
+    end?: Date;
+    /** Ubicación opcional. / Optional location. */
+    place?: {
+        lat: number;
+        lng: number;
+    };
+}
 export interface LocationOptions {
     lat: number;
     lng: number;
@@ -167,6 +196,12 @@ export declare class Message {
     location(loc: LocationOptions, opts?: SendOptions): Promise<Message | null>;
     /** Responde con encuesta. */
     poll(poll: PollOptions, opts?: SendPollOptions): Promise<Message | null>;
+    /** Responde con documento. */
+    document(buf: Buffer, opts: SendDocumentOptions): Promise<Message | null>;
+    /** Responde con tarjeta(s) de contacto. */
+    vcard(contacts: VCardInput[], opts?: SendOptions): Promise<Message | null>;
+    /** Responde con evento. */
+    event(data: EventInput, opts?: SendOptions): Promise<Message | null>;
 }
 /**
  * Mensaje de texto. Override `content()` para retornar el caption como Buffer sin pasar por engine.
@@ -241,6 +276,65 @@ export declare class Poll extends Message {
      */
     select(index: number | number[]): Promise<boolean>;
 }
+/**
+ * Mensaje de documento. WhatsApp permite enviar cualquier archivo (PDF, imagen,
+ * audio, video, etc.) como documento; lo que lo distingue de image/video/audio es
+ * el tipo de mensaje (`documentMessage`), no el mimetype. Hereda `stream()` de la
+ * clase base; `content()` drena el stream (cache → download).
+ * Document message. WhatsApp lets you send any file (PDF, image, audio, video…)
+ * as a document; what sets it apart from image/video/audio is the message type
+ * (`documentMessage`), not the mimetype. Inherits `stream()` from the base class;
+ * `content()` drains the stream (cache → download).
+ */
+export declare class Document extends Message {
+    private get _doc_msg();
+    /** Nombre del archivo. / File name. */
+    get file_name(): string;
+    /** Tamaño en bytes (0 si se desconoce). / Size in bytes (0 if unknown). */
+    get size(): number;
+    /** Número de páginas (PDF); 0 si no aplica. / Page count (PDF); 0 when not applicable. */
+    get pages(): number;
+    /** Título del documento. / Document title. */
+    get title(): string;
+    content(): Promise<Buffer>;
+}
+/**
+ * Mensaje de tarjeta(s) de contacto (vCard). Unifica `contactMessage` (uno) y
+ * `contactsArrayMessage` (varios) bajo una sola lista `contacts`.
+ * Contact card message (vCard). Unifies `contactMessage` (single) and
+ * `contactsArrayMessage` (multiple) under a single `contacts` list.
+ */
+export declare class VCard extends Message {
+    /** Contactos de la tarjeta con nombre y teléfono. / Card contacts with name and phone. */
+    get contacts(): {
+        name: string;
+        phone: string;
+    }[];
+}
+/**
+ * Mensaje de evento de calendario (`eventMessage`): nombre, descripción, rango de
+ * fechas, estado de cancelación, link de unión y ubicación.
+ * Calendar event message (`eventMessage`): name, description, date range,
+ * cancellation state, join link and location.
+ */
+export declare class Event extends Message {
+    private get _event();
+    /** Nombre del evento. / Event name. */
+    get name(): string;
+    /** Epoch ms de inicio. / Start epoch ms. */
+    get start(): number;
+    /** Epoch ms de fin, o null. / End epoch ms, or null. */
+    get end(): number | null;
+    /** true si el evento fue cancelado. / true if the event was canceled. */
+    get canceled(): boolean;
+    /** Link de unión (audio/video), si aplica. / Join link (audio/video), if any. */
+    get link(): string;
+    /** Ubicación del evento, o null. / Event location, or null. */
+    get place(): {
+        lat: number;
+        lng: number;
+    } | null;
+}
 /**
  * Factoría que enlaza los statics a `wa` y expone las subclases.
  * Factory binding statics to `wa` and exposing subclasses.
@@ -252,6 +346,9 @@ export declare function message(wa: WhatsApp): {
     Audio: typeof Audio;
     Gps: typeof Gps;
     Poll: typeof Poll;
+    Document: typeof Document;
+    VCard: typeof VCard;
+    Event: typeof Event;
     build_message_doc: typeof build_message_doc;
     build_instance: (doc: IMessage) => Promise<Message>;
     /** Obtiene un mensaje por CID/MID. */
@@ -266,6 +363,9 @@ export declare function message(wa: WhatsApp): {
     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?: SendPollOptions): Promise<Message | null>;
+    document(cid: string, buf: Buffer, opts: SendDocumentOptions): Promise<Message | null>;
+    vcard(cid: string, contacts: VCardInput[], opts?: SendOptions): Promise<Message | null>;
+    event(cid: string, data: EventInput, 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>;

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

@@ -5,7 +5,7 @@
  * Subclases especializadas (Text, Image, Video, Audio, Gps, Poll) override `content()` según su tipo.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Poll = exports.Gps = exports.Audio = exports.Video = exports.Image = exports.Text = exports.Message = exports.MessageStatus = void 0;
+exports.Event = exports.VCard = exports.Document = exports.Poll = exports.Gps = exports.Audio = exports.Video = exports.Image = exports.Text = exports.Message = exports.MessageStatus = void 0;
 exports.build_message_doc = build_message_doc;
 exports.message = message;
 const baileys_1 = require("baileys");
@@ -33,6 +33,11 @@ const MESSAGE_TYPE_MAP = {
     pollCreationMessage: 'poll',
     pollCreationMessageV2: 'poll',
     pollCreationMessageV3: 'poll',
+    documentMessage: 'document',
+    documentWithCaptionMessage: 'document',
+    contactMessage: 'vcard',
+    contactsArrayMessage: 'vcard',
+    eventMessage: 'event',
 };
 /**
  * Construye el documento IMessage desde el raw de baileys.
@@ -43,6 +48,7 @@ function build_message_doc(raw, self_id, edited = false) {
     const unwrapped = msg.viewOnceMessage?.message ??
         msg.viewOnceMessageV2?.message ??
         msg.viewOnceMessageV2Extension?.message ??
+        msg.documentWithCaptionMessage?.message ??
         msg;
     const content_type = (0, baileys_1.getContentType)(unwrapped);
     const msg_type = MESSAGE_TYPE_MAP[content_type ?? ''] ?? 'text';
@@ -54,9 +60,12 @@ function build_message_doc(raw, self_id, edited = false) {
         ? (Number(raw.ephemeralStartTimestamp) + ephemeral_duration) * 1000
         : null;
     let mime = 'text/plain';
-    if (msg_type === 'location' || msg_type === 'poll') {
+    if (msg_type === 'location' || msg_type === 'poll' || msg_type === 'event') {
         mime = 'application/json';
     }
+    else if (msg_type === 'vcard') {
+        mime = 'text/vcard';
+    }
     else if (msg_type !== 'text' && typeof msg_content === 'object') {
         mime = msg_content?.mimetype ?? 'application/octet-stream';
     }
@@ -64,11 +73,15 @@ function build_message_doc(raw, self_id, edited = false) {
     if (typeof msg_content === 'string') {
         caption = msg_content;
     }
+    else if (msg_type === 'event') {
+        caption = msg_content?.description ?? '';
+    }
     else if (msg_content) {
         caption =
             msg_content.caption ??
                 msg_content.text ??
                 msg_content.name ??
+                msg_content.displayName ??
                 '';
     }
     const author = key.fromMe && self_id
@@ -219,7 +232,11 @@ class Message {
     /** Reenvía el mensaje a un destino (CID, Chat o Contact). */
     async forward(target) {
         const { _wa, _doc } = this;
-        const to_cid = typeof target === 'string' ? target : target instanceof chat_1.Chat ? target.id : target.chat.id;
+        const to_cid = typeof target === 'string'
+            ? target
+            : target instanceof chat_1.Chat
+                ? target.id
+                : (await target.chat()).id;
         let ok = false;
         if (_wa._socket) {
             const jid = await _wa._resolve_jid(to_cid);
@@ -383,6 +400,18 @@ class Message {
     async poll(poll, opts = {}) {
         return this._wa.Message.poll(this.cid, poll, { ...opts, mid: this.id });
     }
+    /** Responde con documento. */
+    async document(buf, opts) {
+        return this._wa.Message.document(this.cid, buf, { ...opts, mid: this.id });
+    }
+    /** Responde con tarjeta(s) de contacto. */
+    async vcard(contacts, opts = {}) {
+        return this._wa.Message.vcard(this.cid, contacts, { ...opts, mid: this.id });
+    }
+    /** Responde con evento. */
+    async event(data, opts = {}) {
+        return this._wa.Message.event(this.cid, data, { ...opts, mid: this.id });
+    }
 }
 exports.Message = Message;
 /**
@@ -615,6 +644,116 @@ class Poll extends Message {
     }
 }
 exports.Poll = Poll;
+/**
+ * Mensaje de documento. WhatsApp permite enviar cualquier archivo (PDF, imagen,
+ * audio, video, etc.) como documento; lo que lo distingue de image/video/audio es
+ * el tipo de mensaje (`documentMessage`), no el mimetype. Hereda `stream()` de la
+ * clase base; `content()` drena el stream (cache → download).
+ * Document message. WhatsApp lets you send any file (PDF, image, audio, video…)
+ * as a document; what sets it apart from image/video/audio is the message type
+ * (`documentMessage`), not the mimetype. Inherits `stream()` from the base class;
+ * `content()` drains the stream (cache → download).
+ */
+class Document extends Message {
+    get _doc_msg() {
+        const m = this._doc.raw.message;
+        return m?.documentMessage ?? m?.documentWithCaptionMessage?.message?.documentMessage;
+    }
+    /** Nombre del archivo. / File name. */
+    get file_name() {
+        return this._doc_msg?.fileName ?? '';
+    }
+    /** Tamaño en bytes (0 si se desconoce). / Size in bytes (0 if unknown). */
+    get size() {
+        return Number(this._doc_msg?.fileLength?.toString() ?? '0');
+    }
+    /** Número de páginas (PDF); 0 si no aplica. / Page count (PDF); 0 when not applicable. */
+    get pages() {
+        return this._doc_msg?.pageCount ?? 0;
+    }
+    /** Título del documento. / Document title. */
+    get title() {
+        return this._doc_msg?.title ?? '';
+    }
+    async content() {
+        return _drain(await this.stream());
+    }
+}
+exports.Document = Document;
+/**
+ * Construye un vCard 3.0 mínimo con el teléfono enlazado como contacto de WhatsApp.
+ * Builds a minimal vCard 3.0 with the phone linked as a WhatsApp contact.
+ *
+ * @param name - Nombre mostrado / Display name
+ * @param phone - Teléfono en formato internacional / Phone in international format
+ * @returns String vCard (VCF) / vCard (VCF) string
+ */
+function build_vcard(name, phone) {
+    const waid = phone.replace(/\D+/g, '');
+    return [
+        'BEGIN:VCARD',
+        'VERSION:3.0',
+        `FN:${name}`,
+        `TEL;type=CELL;waid=${waid}:${phone}`,
+        'END:VCARD',
+    ].join('\n');
+}
+/**
+ * Mensaje de tarjeta(s) de contacto (vCard). Unifica `contactMessage` (uno) y
+ * `contactsArrayMessage` (varios) bajo una sola lista `contacts`.
+ * Contact card message (vCard). Unifies `contactMessage` (single) and
+ * `contactsArrayMessage` (multiple) under a single `contacts` list.
+ */
+class VCard extends Message {
+    /** Contactos de la tarjeta con nombre y teléfono. / Card contacts with name and phone. */
+    get contacts() {
+        const m = this._doc.raw.message;
+        const raw = m?.contactsArrayMessage?.contacts ?? (m?.contactMessage ? [m.contactMessage] : []);
+        return raw.map((c) => {
+            const tel = (c.vcard ?? '').match(/TEL[^:]*:(.+)/);
+            return { name: c.displayName ?? '', phone: tel ? tel[1].trim() : '' };
+        });
+    }
+}
+exports.VCard = VCard;
+/**
+ * Mensaje de evento de calendario (`eventMessage`): nombre, descripción, rango de
+ * fechas, estado de cancelación, link de unión y ubicación.
+ * Calendar event message (`eventMessage`): name, description, date range,
+ * cancellation state, join link and location.
+ */
+class Event extends Message {
+    get _event() {
+        return this._doc.raw.message?.eventMessage;
+    }
+    /** Nombre del evento. / Event name. */
+    get name() {
+        return this._event?.name ?? '';
+    }
+    /** Epoch ms de inicio. / Start epoch ms. */
+    get start() {
+        return Number(this._event?.startTime?.toString() ?? '0') * 1000;
+    }
+    /** Epoch ms de fin, o null. / End epoch ms, or null. */
+    get end() {
+        const end = this._event?.endTime;
+        return end == null ? null : Number(end.toString()) * 1000;
+    }
+    /** true si el evento fue cancelado. / true if the event was canceled. */
+    get canceled() {
+        return this._event?.isCanceled ?? false;
+    }
+    /** Link de unión (audio/video), si aplica. / Join link (audio/video), if any. */
+    get link() {
+        return this._event?.joinLink ?? '';
+    }
+    /** Ubicación del evento, o null. / Event location, or null. */
+    get place() {
+        const loc = this._event?.location;
+        return loc ? { lat: loc.degreesLatitude ?? 0, lng: loc.degreesLongitude ?? 0 } : null;
+    }
+}
+exports.Event = Event;
 /**
  * Factoría que enlaza los statics a `wa` y expone las subclases.
  * Factory binding statics to `wa` and exposing subclasses.
@@ -640,6 +779,15 @@ function message(wa) {
         if (doc.type === 'poll') {
             return new Poll(opts);
         }
+        if (doc.type === 'document') {
+            return new Document(opts);
+        }
+        if (doc.type === 'vcard') {
+            return new VCard(opts);
+        }
+        if (doc.type === 'event') {
+            return new Event(opts);
+        }
         return new Message(opts);
     }
     async function send(cid, content, binary, reply_to, doc_overrides) {
@@ -680,6 +828,9 @@ function message(wa) {
         Audio,
         Gps,
         Poll,
+        Document,
+        VCard,
+        Event,
         // Helpers internos (usados por orquestador WhatsApp)
         build_message_doc,
         build_instance,
@@ -736,6 +887,41 @@ function message(wa) {
                 },
             }, undefined, opts.mid, { multiple });
         },
+        async document(cid, buf, opts) {
+            return send(cid, {
+                document: buf,
+                fileName: opts.file_name,
+                mimetype: opts.mimetype ?? 'application/octet-stream',
+                caption: opts.caption,
+            }, buf, opts.mid);
+        },
+        async vcard(cid, contacts, opts = {}) {
+            const built = contacts.map((c) => ({
+                displayName: c.name,
+                vcard: build_vcard(c.name, c.phone),
+            }));
+            const binary = Buffer.from(built.map((c) => c.vcard).join('\n'), 'utf-8');
+            return send(cid, { contacts: { contacts: built } }, binary, opts.mid);
+        },
+        async event(cid, data, opts = {}) {
+            const binary = Buffer.from(JSON.stringify({
+                name: data.name,
+                caption: data.caption,
+                start: data.start.getTime(),
+                end: data.end?.getTime() ?? null,
+            }), 'utf-8');
+            return send(cid, {
+                event: {
+                    name: data.name,
+                    description: data.caption,
+                    startDate: data.start,
+                    endDate: data.end,
+                    location: data.place
+                        ? { degreesLatitude: data.place.lat, degreesLongitude: data.place.lng }
+                        : undefined,
+                },
+            }, binary, opts.mid);
+        },
         async edit(cid, mid, text) {
             const m = await api.get(cid, mid);
             return m ? m.edit(text) : false;