@arcaelas/whatsapp 3.5.0 → 4.3.0

package/build/esm/index.js

@@ -4,6 +4,6 @@
  * Public entry point of the @arcaelas/whatsapp library.
  */
 export { WhatsApp, default } from './lib/whatsapp/index.js';
-export { FileSystemEngine, RedisEngine } from './lib/store/index.js';
+export { FileSystemEngine, RedisEngine, S3Engine, serialize, deserialize } from './lib/store/index.js';
 export { default as Feed, TTL_MS as FEED_TTL_MS } from './lib/status/index.js';
 //# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG5D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG9F,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,cAAc,CAAC"}

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

@@ -1,5 +1,5 @@
 /**
- * @file playground/bot/decorator.ts
+ * @file bot/decorator.ts
  * @description Infraestructura base de decoradores Stage 3 sobre WhatsApp.
  * Base infrastructure for Stage 3 decorators over WhatsApp.
  */
@@ -21,6 +21,23 @@ 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.
+ *
+ * @param metadata - Objeto metadata del contexto del decorador / Decorator context metadata object
+ * @param method_name - Nombre del método / Method name
+ * @returns Tupla `[schema, handler_meta]` para el método / Tuple `[schema, handler_meta]` for the method
+ */
+export declare function resolve(metadata: Metadata, method_name: string): [BotSchema, HandlerMeta];
 /**
  * Registra un step dentro de un workflow. Uso interno del decorador `@pipe`.
  * Registers a step inside a workflow. Internal use of the `@pipe` decorator.

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

@@ -1,5 +1,5 @@
 /**
- * @file playground/bot/decorator.ts
+ * @file bot/decorator.ts
  * @description Infraestructura base de decoradores Stage 3 sobre WhatsApp.
  * Base infrastructure for Stage 3 decorators over WhatsApp.
  */
@@ -7,14 +7,13 @@ import WhatsApp from '../../lib/whatsapp/index.js';
 Symbol.metadata ??= Symbol.for('Symbol.metadata');
 export const HANDLERS = Symbol('wa:handlers');
 /**
- * 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.
+ * 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
- * @param method_name - Nombre del método / Method name
- * @returns Tupla `[schema, handler_meta]` para el método / Tuple `[schema, handler_meta]` for the method
+ * @returns Schema del bot garantizado con `handlers` y `workflows` / Bot schema guaranteed to have `handlers` and `workflows`
  */
-function resolve(metadata, method_name) {
+export function ensure_schema(metadata) {
     let schema = metadata[HANDLERS];
     if (!schema) {
         schema = { handlers: {}, workflows: {} };
@@ -23,6 +22,18 @@ function resolve(metadata, method_name) {
     if (!schema.workflows) {
         schema.workflows = {};
     }
+    return schema;
+}
+/**
+ * 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.
+ *
+ * @param metadata - Objeto metadata del contexto del decorador / Decorator context metadata object
+ * @param method_name - Nombre del método / Method name
+ * @returns Tupla `[schema, handler_meta]` para el método / Tuple `[schema, handler_meta]` for the method
+ */
+export function resolve(metadata, method_name) {
+    const schema = ensure_schema(metadata);
     schema.handlers[method_name] ||= {
         method: method_name,
         events: [],
@@ -41,14 +52,7 @@ function resolve(metadata, method_name) {
  * @param step - Step a registrar (índice + nombre del método) / Step to register (index + method name)
  */
 export function register_workflow_step(metadata, workflow, step) {
-    let schema = metadata[HANDLERS];
-    if (!schema) {
-        schema = { handlers: {}, workflows: {} };
-        metadata[HANDLERS] = schema;
-    }
-    if (!schema.workflows) {
-        schema.workflows = {};
-    }
+    const schema = ensure_schema(metadata);
     schema.workflows[workflow] ||= [];
     schema.workflows[workflow].push(step);
 }

package/build/esm/lib/bot/decorator.js.map

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

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

@@ -1,5 +1,5 @@
 /**
- * @file playground/bot/decorators.ts
+ * @file bot/decorators.ts
  * @description Decoradores públicos del bot.
  * Public bot decorators.
  */

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

@@ -1,9 +1,9 @@
 /**
- * @file playground/bot/decorators.ts
+ * @file bot/decorators.ts
  * @description Decoradores públicos del bot.
  * Public bot decorators.
  */
-import { WhatsAppBot, decorator, HANDLERS, register_workflow_step, } from './decorator.js';
+import { WhatsAppBot, decorator, register_workflow_step, resolve, } from './decorator.js';
 /**
  * Registra el método como listener del evento indicado. Apilable: varios `@on`
  * sobre el mismo método crean múltiples suscripciones.
@@ -41,22 +41,10 @@ export function once(event) {
         if (context.kind !== 'method') {
             throw new Error('@once only applicable to methods');
         }
-        const metadata = context.metadata;
-        if (!metadata[HANDLERS]) {
-            metadata[HANDLERS] = { handlers: {}, workflows: {} };
-        }
-        const schema = metadata[HANDLERS];
-        const method_name = String(context.name);
-        schema.handlers[method_name] ||= {
-            method: method_name,
-            events: [],
-            guards: [],
-            transforms: [],
-            once: false,
-        };
-        schema.handlers[method_name].once = true;
-        if (event && !schema.handlers[method_name].events.includes(event)) {
-            schema.handlers[method_name].events.push(event);
+        const [, handler] = resolve(context.metadata, String(context.name));
+        handler.once = true;
+        if (event && !handler.events.includes(event)) {
+            handler.events.push(event);
         }
     };
 }
@@ -244,9 +232,7 @@ export function command(pattern) {
             }
             return pattern.test(text);
         })(value, context);
-        const metadata = context.metadata;
-        const schema = metadata[HANDLERS];
-        const handler = schema.handlers[String(context.name)];
+        const [, handler] = resolve(context.metadata, String(context.name));
         handler.transforms.push((args) => {
             const msg = args[0];
             const chat = args[1];

package/build/esm/lib/bot/decorators.js.map

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

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

@@ -18,6 +18,14 @@ export interface IContactRaw {
     img_url?: string | null;
     status?: string | null;
 }
+/**
+ * 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
+ */
+export declare function contact_name(raw: IContactRaw): string;
 /**
  * Clase base del contacto (forma pública, solo lectura).
  * Base Contact class (public shape, read-only).
@@ -25,8 +33,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 +50,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 +66,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 +109,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 +147,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 +190,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/esm/lib/contact/index.js

@@ -5,6 +5,16 @@
  */
 import { jidNormalizedUser } from 'baileys';
 import { deserialize, serialize } from '../../lib/store/index.js';
+/**
+ * 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
+ */
+export 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).
@@ -12,7 +22,7 @@ import { deserialize, serialize } from '../../lib/store/index.js';
 export class Contact {
     constructor(raw, chat) {
         this._raw = raw;
-        this.chat = chat;
+        this._chat = chat;
     }
     /** JID único. / Unique JID. */
     get id() {
@@ -28,7 +38,7 @@ export class Contact {
     }
     /** Nombre: local → push → teléfono. / Name: local → push → phone. */
     get name() {
-        return this._raw.name ?? this._raw.notify ?? this._raw.id.split('@')[0];
+        return contact_name(this._raw);
     }
     /** Número sin formato. / Raw phone number. */
     get phone() {
@@ -42,6 +52,15 @@ export 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;
+    }
 }
 /**
  * Factoría de Contact ligada al contexto WhatsApp.
@@ -101,6 +120,10 @@ export 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;
@@ -132,8 +155,7 @@ export function contact(wa) {
             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));
+                    result = new _Contact(cached, await load_chat_for(jid, contact_name(cached)));
                 }
                 else if (wa._socket) {
                     const needs_check = !lid && !uid.endsWith('@lid');
@@ -170,8 +192,7 @@ export function contact(wa) {
             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)));
+                    contacts.push(new _Contact(parsed, await load_chat_for(parsed.id, contact_name(parsed))));
                 }
             }
             return contacts;

package/build/esm/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/esm/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>;