@arcaelas/whatsapp 5.1.0 → 6.0.0

package/build/cjs/lib/store/engine/lib/sqlite/index.js

@@ -15,14 +15,14 @@ const lib_1 = require("../../../../../lib/store/engine/lib");
  * resuelven a mano: `list` es un `ORDER BY score DESC LIMIT/OFFSET` sobre el índice (sin
  * índice en memoria ni archivo de orden), `count` un `COUNT(*)` y el `unset` en cascada una
  * sola sentencia por rango de `path`. Medido sobre un chat real de 55.146 mensajes frente al
- * filesystem: 220 MB → 111 MB en disco, primer `list` 115 ms → 0,7 ms y dos inodes en total.
+ * filesystem: 220 MB → 64 MB en disco, primer `list` 115 ms → 0,6 ms y dos archivos en total.
  *
  * SQLite persistence driver: a single `(path, parent, score, value)` table with a
  * `(parent, score DESC)` index. The most efficient built-in driver, since it delegates to the
  * engine what the others hand-roll: `list` is an indexed `ORDER BY score DESC LIMIT/OFFSET`
  * (no in-memory index, no order file), `count` a `COUNT(*)` and cascading `unset` a single
  * range statement. Measured on a real 55,146-message chat against the filesystem: 220 MB →
- * 111 MB on disk, first `list` 115 ms → 0.7 ms and two inodes in total.
+ * 64 MB on disk, first `list` 115 ms → 0.6 ms and two files in total.
  *
  * @example
  * import Database from 'better-sqlite3';
@@ -49,7 +49,7 @@ class SQLiteEngine {
         catch {
             /* optional tuning */
         }
-        _db.exec(`CREATE TABLE IF NOT EXISTS ${table} (path TEXT PRIMARY KEY, parent TEXT NOT NULL, score INTEGER NOT NULL, value TEXT NOT NULL);
+        _db.exec(`CREATE TABLE IF NOT EXISTS ${table} (path TEXT PRIMARY KEY, parent TEXT NOT NULL, score INTEGER NOT NULL, value TEXT NOT NULL DEFAULT '', binary BLOB);
        CREATE INDEX IF NOT EXISTS ${table}_order ON ${table} (parent, score DESC);`);
         this._read = _db.prepare(`SELECT value FROM ${table} WHERE path = ?`);
         this._write = _db.prepare(`INSERT INTO ${table} (path, parent, score, value) VALUES (?, ?, ?, ?)
@@ -62,6 +62,9 @@ class SQLiteEngine {
         this._page = _db.prepare(`SELECT value FROM ${table} WHERE parent = ? ORDER BY score DESC LIMIT ? OFFSET ?`);
         this._total = _db.prepare(`SELECT COUNT(*) AS total FROM ${table} WHERE parent = ?`);
         this._wipe = _db.prepare(`DELETE FROM ${table}`);
+        this._read_blob = _db.prepare(`SELECT binary FROM ${table} WHERE path = ?`);
+        this._write_blob = _db.prepare(`INSERT INTO ${table} (path, parent, score, value, binary) VALUES (?, ?, ?, '', ?)
+       ON CONFLICT(path) DO UPDATE SET binary = excluded.binary, score = excluded.score`);
     }
     /**
      * Lee el valor de un documento.
@@ -102,6 +105,22 @@ class SQLiteEngine {
     async count(path) {
         return Number(this._total.get((0, lib_1.normalize_path)(path)).total);
     }
+    /**
+     * Lee el binario del documento, o null si la fila no lo tiene.
+     * Reads the document binary, or null when the row has none.
+     */
+    async get_buffer(path) {
+        const row = this._read_blob.get((0, lib_1.normalize_path)(path));
+        return row?.binary ? Buffer.from(row.binary) : null;
+    }
+    /**
+     * Escribe el binario del documento como BLOB, sin JSON ni base64.
+     * Writes the document binary as a BLOB, with no JSON nor base64.
+     */
+    async set_buffer(path, data, score) {
+        const { parent } = (0, lib_1.split_path)(path);
+        this._write_blob.run((0, lib_1.normalize_path)(path), parent, score ?? Date.now(), data);
+    }
     /**
      * Vacía la tabla completa.
      * Clears the entire table.
@@ -111,4 +130,3 @@ class SQLiteEngine {
     }
 }
 exports.SQLiteEngine = SQLiteEngine;
-//# sourceMappingURL=index.js.map

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

@@ -46,4 +46,3 @@ function deserialize(raw) {
         return null;
     }
 }
-//# sourceMappingURL=index.js.map

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

@@ -154,6 +154,19 @@ class WhatsApp {
         }
         return null;
     }
+    /**
+     * @internal
+     * Persiste un binario: crudo cuando el driver lo soporta, JSON con base64 si no.
+     * Persists a binary: raw when the driver supports it, base64 JSON otherwise.
+     */
+    async #write_content(path, data) {
+        if (this.engine.set_buffer) {
+            await this.engine.set_buffer(path, data);
+        }
+        else {
+            await this.engine.set(path, (0, store_1.serialize)({ data: data.toString('base64') }));
+        }
+    }
     /** @internal Encola una tarea en la cadena serial de handlers. / Queues a task on the serial handler chain. */
     #enqueue(task) {
         this.#chain = this.#chain.then(task).catch(() => { });
@@ -462,7 +475,7 @@ class WhatsApp {
                 };
                 await this.engine.set(`/status/${doc.id}`, (0, store_1.serialize)(doc), created_at);
                 if (post.content) {
-                    await this.engine.set(`/status/${doc.id}/content`, (0, store_1.serialize)({ data: post.content.toString('base64') }));
+                    await this.#write_content(`/status/${doc.id}/content`, post.content);
                 }
                 result = new status_1.Feed(this, doc);
                 this.emit('feed:created', result, this);
@@ -627,6 +640,7 @@ class WhatsApp {
                     archived: ch.archived ?? null,
                     pinned: ch.pinned ?? null,
                     mute_end_time: ch.muteEndTime != null ? Number(ch.muteEndTime) : null,
+                    unread_count: ch.unreadCount ?? null,
                 };
                 if (ch.name) {
                     raw.name = ch.name;
@@ -662,6 +676,9 @@ class WhatsApp {
                 if (mute_changed) {
                     patch.mute_end_time = ch.muteEndTime != null ? Number(ch.muteEndTime) : null;
                 }
+                if (ch.unreadCount != null) {
+                    patch.unread_count = ch.unreadCount;
+                }
                 if (Object.keys(patch).length > 0) {
                     const merged = { ...current, ...patch };
                     await this.engine.set(`/chat/${ch.id}`, (0, store_1.serialize)(merged));
@@ -811,7 +828,7 @@ class WhatsApp {
                     }
                     await this.engine.set(`/status/${mid}`, (0, store_1.serialize)(feed_raw));
                     if (content_buf.length > 0) {
-                        await this.engine.set(`/status/${mid}/content`, (0, store_1.serialize)({ data: content_buf.toString('base64') }));
+                        await this.#write_content(`/status/${mid}/content`, content_buf);
                     }
                     this.emit('feed:created', new status_1.Feed(this, feed_raw), this);
                     continue;
@@ -999,7 +1016,7 @@ class WhatsApp {
                     }
                 }
                 if (content_buf.length > 0) {
-                    await this.engine.set(`/chat/${cid}/message/${mid}/content`, (0, store_1.serialize)({ data: content_buf.toString('base64') }));
+                    await this.#write_content(`/chat/${cid}/message/${mid}/content`, content_buf);
                 }
                 const instance = (0, message_1.message)(this, doc);
                 const chat_instance = await instance.chat();
@@ -1098,4 +1115,3 @@ class WhatsApp {
 }
 exports.WhatsApp = WhatsApp;
 exports.default = WhatsApp;
-//# sourceMappingURL=index.js.map

package/build/esm/decorators.js

@@ -6,4 +6,3 @@
  * API to build bots on top of the WhatsApp client.
  */
 export { WhatsAppBot, Bot, on, guard, command, from, once, connect, disconnect, every, delay, pipe, pair, HANDLERS, decorator, } from './lib/bot/index.js';
-//# sourceMappingURL=decorators.js.map

package/build/esm/index.js

@@ -9,4 +9,3 @@ export { Contact, contact } from './lib/contact/index.js';
 export { Chat, chat } from './lib/chat/index.js';
 export { Message, message, Text, Image, Video, Audio, Sticker, Document, Location, Poll, VCard, Event } from './lib/message/index.js';
 export { Feed, TTL_MS as FEED_TTL_MS } from './lib/status/index.js';
-//# sourceMappingURL=index.js.map

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

@@ -243,4 +243,3 @@ export class WhatsAppBot extends WhatsApp {
     }
 }
 export default WhatsAppBot;
-//# sourceMappingURL=decorator.js.map

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

@@ -82,9 +82,9 @@ export declare function delay(ms: number): (_value: unknown, context: ClassMetho
 export declare const pair: () => (_value: unknown, context: ClassMethodDecoratorContext) => void;
 /**
  * Filtra por autor del mensaje. Acepta JID, LID o teléfono numérico; el string
- * se normaliza vía `wa._resolve_jid` con cache lazy. Un array produce match OR.
+ * se normaliza con la resolución interna del cliente y cache lazy. Un array produce match OR.
  * Filters by message author. Accepts JID, LID or numeric phone; the string is
- * normalized via `wa._resolve_jid` with lazy cache. An array yields OR matching.
+ * normalized through the client's internal resolution with lazy cache. An array yields OR matching.
  *
  * @param source - Identificador(es) permitidos o predicate sobre `msg.from` / Allowed identifier(s) or predicate on `msg.from`
  */

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

@@ -3,6 +3,7 @@
  * @description Decoradores públicos del bot.
  * Public bot decorators.
  */
+import { internals } from '../../lib/internal.js';
 import { WhatsAppBot, decorator, register_workflow_step, resolve, } from './decorator.js';
 /**
  * Registra el método como listener del evento indicado. Apilable: varios `@on`
@@ -114,9 +115,9 @@ export const pair = decorator((_meta, h) => {
 });
 /**
  * Filtra por autor del mensaje. Acepta JID, LID o teléfono numérico; el string
- * se normaliza vía `wa._resolve_jid` con cache lazy. Un array produce match OR.
+ * se normaliza con la resolución interna del cliente y cache lazy. Un array produce match OR.
  * Filters by message author. Accepts JID, LID or numeric phone; the string is
- * normalized via `wa._resolve_jid` with lazy cache. An array yields OR matching.
+ * normalized through the client's internal resolution with lazy cache. An array yields OR matching.
  *
  * @param source - Identificador(es) permitidos o predicate sobre `msg.from` / Allowed identifier(s) or predicate on `msg.from`
  */
@@ -134,7 +135,7 @@ export function from(source) {
                 if (resolved === null) {
                     resolved = new Set();
                     for (const raw of list) {
-                        const r = await wa._resolve_jid(raw);
+                        const r = await internals(wa).resolve_jid(raw);
                         if (r) {
                             resolved.add(r);
                         }
@@ -247,4 +248,3 @@ export function command(pattern) {
         });
     };
 }
-//# sourceMappingURL=decorators.js.map

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

@@ -1,3 +1,2 @@
 export { WhatsAppBot, HANDLERS, decorator } from './decorator.js';
 export { on, guard, command, from, once, connect, disconnect, every, delay, pipe, pair, Bot } from './decorators.js';
-//# sourceMappingURL=index.js.map

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

@@ -16,6 +16,7 @@ export declare class Chat {
         archived?: boolean | null;
         pinned?: number | null;
         mute_end_time?: number | null;
+        unread_count?: number | null;
     };
     /**
      * @internal Documento crudo del chat. `id` es el identificador del engine (JID, LID o
@@ -29,6 +30,7 @@ export declare class Chat {
         archived?: boolean | null;
         pinned?: number | null;
         mute_end_time?: number | null;
+        unread_count?: number | null;
     });
     /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
     get id(): string;
@@ -40,6 +42,8 @@ export declare class Chat {
     get archived(): boolean;
     /** true si el chat está fijado. / true when the chat is pinned. */
     get pinned(): boolean;
+    /** Mensajes sin leer del chat. / Chat's unread messages. */
+    get count(): number;
     /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
     get muted(): string | null;
 }
@@ -56,6 +60,7 @@ export declare function chat(wa: WhatsApp): {
         archived?: boolean | null;
         pinned?: number | null;
         mute_end_time?: number | null;
+        unread_count?: number | null;
     }): {
         /**
          * Participantes del chat: los integrantes en grupos, el contacto y yo en 1:1.
@@ -66,6 +71,15 @@ export declare function chat(wa: WhatsApp): {
          * @returns Página de contactos / Contact page
          */
         members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        content(): Promise<string>;
         /**
          * Mensajes del chat paginados desde el más reciente.
          * Chat messages paginated from the most recent one.
@@ -146,6 +160,7 @@ export declare function chat(wa: WhatsApp): {
             archived?: boolean | null;
             pinned?: number | null;
             mute_end_time?: number | null;
+            unread_count?: number | null;
         };
         /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
         get id(): string;
@@ -157,6 +172,8 @@ export declare function chat(wa: WhatsApp): {
         get archived(): boolean;
         /** true si el chat está fijado. / true when the chat is pinned. */
         get pinned(): boolean;
+        /** Mensajes sin leer del chat. / Chat's unread messages. */
+        get count(): number;
         /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
         get muted(): string | null;
     };
@@ -179,6 +196,15 @@ export declare function chat(wa: WhatsApp): {
          * @returns Página de contactos / Contact page
          */
         members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        content(): Promise<string>;
         /**
          * Mensajes del chat paginados desde el más reciente.
          * Chat messages paginated from the most recent one.
@@ -259,6 +285,7 @@ export declare function chat(wa: WhatsApp): {
             archived?: boolean | null;
             pinned?: number | null;
             mute_end_time?: number | null;
+            unread_count?: number | null;
         };
         /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
         get id(): string;
@@ -270,6 +297,8 @@ export declare function chat(wa: WhatsApp): {
         get archived(): boolean;
         /** true si el chat está fijado. / true when the chat is pinned. */
         get pinned(): boolean;
+        /** Mensajes sin leer del chat. / Chat's unread messages. */
+        get count(): number;
         /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
         get muted(): string | null;
     } | null>;
@@ -291,6 +320,15 @@ export declare function chat(wa: WhatsApp): {
          * @returns Página de contactos / Contact page
          */
         members(offset?: number, limit?: number): Promise<InstanceType<typeof wa.Contact>[]>;
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        content(): Promise<string>;
         /**
          * Mensajes del chat paginados desde el más reciente.
          * Chat messages paginated from the most recent one.
@@ -371,6 +409,7 @@ export declare function chat(wa: WhatsApp): {
             archived?: boolean | null;
             pinned?: number | null;
             mute_end_time?: number | null;
+            unread_count?: number | null;
         };
         /** Teléfono del contacto, o el identificador crudo en grupos y LIDs. / Contact phone, or the raw identifier for groups and LIDs. */
         get id(): string;
@@ -382,6 +421,8 @@ export declare function chat(wa: WhatsApp): {
         get archived(): boolean;
         /** true si el chat está fijado. / true when the chat is pinned. */
         get pinned(): boolean;
+        /** Mensajes sin leer del chat. / Chat's unread messages. */
+        get count(): number;
         /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
         get muted(): string | null;
     }[]>;

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

@@ -40,6 +40,10 @@ export class Chat {
     get pinned() {
         return this._raw.pinned != null;
     }
+    /** Mensajes sin leer del chat. / Chat's unread messages. */
+    get count() {
+        return this._raw.unread_count ?? 0;
+    }
     /** Fecha ISO UTC hasta la que el chat está silenciado, o null. / ISO UTC date until the chat stays muted, or null. */
     get muted() {
         const end = this._raw.mute_end_time;
@@ -90,14 +94,14 @@ export function chat(wa) {
      * Participantes del grupo memoizados 15s, para no repetir `groupMetadata` en cada página.
      * Group participants memoized for 15s, avoiding a `groupMetadata` round-trip per page.
      */
-    const members_cache = new Map();
-    function group_members(jid) {
-        if (!members_cache.has(jid)) {
+    const groups_cache = new Map();
+    function group_meta(jid) {
+        if (!groups_cache.has(jid)) {
             const socket = internals(wa).socket;
-            members_cache.set(jid, socket ? socket.groupMetadata(jid).then((meta) => meta.participants).catch(() => []) : Promise.resolve([]));
-            setTimeout(() => members_cache.delete(jid), 15_000);
+            groups_cache.set(jid, socket ? socket.groupMetadata(jid).catch(() => ({ participants: [] })) : Promise.resolve({ participants: [] }));
+            setTimeout(() => groups_cache.delete(jid), 15_000);
         }
-        return members_cache.get(jid);
+        return groups_cache.get(jid);
     }
     /**
      * Contacto desde el engine, o ficha mínima local cuando no está persistido (sin red).
@@ -118,10 +122,24 @@ export function chat(wa) {
          */
         async members(offset = 0, limit = 50) {
             const ids = this.type === 'group'
-                ? (await group_members(this._raw.id)).map((participant) => participant.id)
+                ? (await group_meta(this._raw.id)).participants.map((participant) => participant.id)
                 : [this._raw.id, internals(wa).socket?.user?.id].filter((id) => Boolean(id));
             return Promise.all(ids.slice(offset, offset + limit).map(load_contact));
         }
+        /**
+         * Descripción del chat: el asunto del grupo o, en un 1:1, la bio del contacto.
+         * Es asíncrono porque ninguno de los dos vive en el documento del chat.
+         * Chat description: the group's subject or, on a 1:1, the contact's bio. It is async
+         * because neither of them lives in the chat document.
+         *
+         * @returns Descripción, o cadena vacía si no hay / Description, or an empty string when absent
+         */
+        async content() {
+            if (this.type === 'group') {
+                return (await group_meta(this._raw.id)).desc ?? '';
+            }
+            return deserialize(await wa.engine.get(`/contact/${this._raw.id}`))?.status ?? '';
+        }
         /**
          * Mensajes del chat paginados desde el más reciente.
          * Chat messages paginated from the most recent one.
@@ -237,6 +255,8 @@ export function chat(wa) {
             const socket = internals(wa).socket;
             if (socket) {
                 await socket.chatModify({ markRead: true, lastMessages: await last_messages(this._raw.id) }, this._raw.id);
+                this._raw.unread_count = 0;
+                await wa.engine.set(`/chat/${this._raw.id}`, serialize(this._raw));
                 ok = true;
             }
             return ok;
@@ -318,4 +338,3 @@ export function chat(wa) {
         }
     };
 }
-//# sourceMappingURL=index.js.map

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

@@ -146,4 +146,3 @@ export function contact(wa) {
         }
     };
 }
-//# sourceMappingURL=index.js.map

package/build/esm/lib/internal.js

@@ -32,4 +32,3 @@ export function bind(owner, state) {
 export function internals(owner) {
     return channel.get(owner);
 }
-//# sourceMappingURL=internal.js.map

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

@@ -451,6 +451,12 @@ export declare class Sticker extends Message {
  * Document message; the actual MIME lives in the base `mime`.
  */
 export declare class Document extends Message {
+    /** @internal */
+    private get _media();
+    /** Nombre del archivo. / File name. */
+    get name(): string;
+    /** Número de páginas (PDF); 0 cuando no aplica. / Page count (PDF); 0 when not applicable. */
+    get pages(): number;
     /** Peso en bytes. / Size in bytes. */
     get size(): number;
     content(): Promise<Buffer>;

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

@@ -88,21 +88,56 @@ async function send(wa, cid, content, binary, extra = {}, doc_overrides) {
             }
             await wa.engine.set(`/chat/${jid}/message/${sent_id}`, serialize(instance._raw), instance._raw.created_at);
             if (binary) {
-                await wa.engine.set(`/chat/${jid}/message/${sent_id}/content`, serialize({ data: binary.toString('base64') }));
+                await write_content(wa, `/chat/${jid}/message/${sent_id}/content`, binary);
             }
             result = instance;
         }
     }
     return result;
 }
+/**
+ * Binario persistido de un documento: primero el crudo del engine y, si el driver no soporta
+ * binarios o el dato viene de una sesión anterior, el documento JSON con base64.
+ * A document's persisted binary: the engine's raw one first and, when the driver lacks binary
+ * support or the data comes from an older session, the base64 JSON document.
+ *
+ * @param wa - Cliente dueño / Owner client
+ * @param path - Ruta del contenido / Content path
+ * @returns Binario o null / Binary or null
+ */
+async function read_content(wa, path) {
+    const raw = await wa.engine.get_buffer?.(path);
+    if (raw?.length) {
+        return raw;
+    }
+    const legacy = deserialize(await wa.engine.get(path));
+    return legacy?.data ? Buffer.from(legacy.data, 'base64') : null;
+}
+/**
+ * Persiste el binario de un documento: crudo cuando el driver lo soporta, JSON con base64
+ * en caso contrario.
+ * Persists a document's binary: raw when the driver supports it, base64 JSON otherwise.
+ *
+ * @param wa - Cliente dueño / Owner client
+ * @param path - Ruta del contenido / Content path
+ * @param data - Binario a guardar / Binary to store
+ */
+async function write_content(wa, path, data) {
+    if (wa.engine.set_buffer) {
+        await wa.engine.set_buffer(path, data);
+    }
+    else {
+        await wa.engine.set(path, serialize({ data: data.toString('base64') }));
+    }
+}
 /**
  * Stream del binario del mensaje: cache del engine o descarga de baileys.
  * Message binary stream: engine cache or baileys download.
  */
 async function media_stream(wa, doc) {
-    const cached = deserialize(await wa.engine.get(`/chat/${doc.cid}/message/${doc.id}/content`));
-    if (cached?.data) {
-        return Readable.from(Buffer.from(cached.data, 'base64'));
+    const cached = await read_content(wa, `/chat/${doc.cid}/message/${doc.id}/content`);
+    if (cached) {
+        return Readable.from(cached);
     }
     const socket = internals(wa).socket;
     if (socket) {
@@ -255,8 +290,7 @@ export class Message {
      * @returns Buffer del contenido / Content buffer
      */
     async content() {
-        const cached = deserialize(await this._wa.engine.get(`/chat/${this._raw.cid}/message/${this._raw.id}/content`));
-        return cached?.data ? Buffer.from(cached.data, 'base64') : Buffer.alloc(0);
+        return (await read_content(this._wa, `/chat/${this._raw.cid}/message/${this._raw.id}/content`)) ?? Buffer.alloc(0);
     }
     /**
      * Stream del contenido; para media descarga de baileys si el cache falta.
@@ -779,10 +813,21 @@ export class Sticker extends Message {
  * Document message; the actual MIME lives in the base `mime`.
  */
 export class Document extends Message {
+    /** @internal */
+    get _media() {
+        return unwrap(this._raw.raw.message ?? {}).documentMessage;
+    }
+    /** Nombre del archivo. / File name. */
+    get name() {
+        return this._media?.fileName ?? '';
+    }
+    /** Número de páginas (PDF); 0 cuando no aplica. / Page count (PDF); 0 when not applicable. */
+    get pages() {
+        return this._media?.pageCount ?? 0;
+    }
     /** Peso en bytes. / Size in bytes. */
     get size() {
-        const media = unwrap(this._raw.raw.message ?? {}).documentMessage;
-        return to_number(media?.fileLength);
+        return to_number(this._media?.fileLength);
     }
     async content() {
         return drain(await this.stream());
@@ -1064,4 +1109,3 @@ export function message(wa, raw) {
     };
     return new (types[doc.type] ?? Message)(wa, doc);
 }
-//# sourceMappingURL=index.js.map

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

@@ -125,4 +125,3 @@ export class Feed extends Message {
         throw new Error('ERR_FEED_UNSUPPORTED');
     }
 }
-//# sourceMappingURL=index.js.map

package/build/esm/lib/store/engine/index.d.ts

@@ -42,6 +42,20 @@ export interface Engine {
     count(path: string): Promise<number>;
     /** Vacía completamente el almacén. / Clears the entire store. */
     clear(): Promise<void>;
+    /**
+     * Lee un binario por path. Opcional: un driver que no lo implemente sigue siendo válido y
+     * la librería cae al documento serializado.
+     * Reads a binary by path. Optional: a driver that does not implement it stays valid and the
+     * library falls back to the serialized document.
+     */
+    get_buffer?(path: string): Promise<Buffer | null>;
+    /**
+     * Escribe un binario sin pasar por JSON ni base64 (un 33% menos de peso y sin parseo para
+     * leerlo). Opcional, igual que `get_buffer`.
+     * Writes a binary without JSON nor base64 (33% less weight and no parsing to read it back).
+     * Optional, just like `get_buffer`.
+     */
+    set_buffer?(path: string, data: Buffer, score?: number): Promise<void>;
 }
 export { FileSystemEngine } from '../../../lib/store/engine/lib/file_system/index.js';
 export { RedisEngine, type RedisClient } from '../../../lib/store/engine/lib/redis/index.js';

package/build/esm/lib/store/engine/index.js

@@ -8,4 +8,3 @@ export { FileSystemEngine } from '../../../lib/store/engine/lib/file_system/inde
 export { RedisEngine } from '../../../lib/store/engine/lib/redis/index.js';
 export { S3Engine } from '../../../lib/store/engine/lib/s3/index.js';
 export { SQLiteEngine } from '../../../lib/store/engine/lib/sqlite/index.js';
-//# sourceMappingURL=index.js.map

package/build/esm/lib/store/engine/lib/file_system/index.d.ts

@@ -78,6 +78,16 @@ export declare class FileSystemEngine implements Engine {
      * Counts direct children with a valid document.
      */
     count(path: string): Promise<number>;
+    /**
+     * Lee el binario del documento, o null si no existe.
+     * Reads the document binary, or null when missing.
+     */
+    get_buffer(path: string): Promise<Buffer | null>;
+    /**
+     * Escribe el binario del documento como archivo crudo, sin JSON ni base64.
+     * Writes the document binary as a raw file, with no JSON nor base64.
+     */
+    set_buffer(path: string, data: Buffer, score?: number): Promise<void>;
     /**
      * Vacía completamente el almacén.
      * Clears the entire store.

package/build/esm/lib/store/engine/lib/file_system/index.js

@@ -10,6 +10,8 @@ import { IndexCache, normalize_path, SortedIndex, split_path } from '../../../..
 const INDEX_FILE = 'index.json';
 /** Índice de orden persistido junto a los hijos del directorio. / Ordering index persisted next to the directory children. */
 const ORDER_FILE = '.order';
+/** Binario del documento, guardado crudo junto a su JSON. / Document binary, stored raw next to its JSON. */
+const BINARY_FILE = 'content.bin';
 /**
  * Driver de persistencia en sistema de archivos.
  * Cada documento se almacena como `<base>/<path>/index.json` de modo que un recurso pueda
@@ -158,6 +160,31 @@ export class FileSystemEngine {
     async count(path) {
         return (await this._index(path)).size;
     }
+    /**
+     * Lee el binario del documento, o null si no existe.
+     * Reads the document binary, or null when missing.
+     */
+    async get_buffer(path) {
+        return readFile(join(this._dir(path), BINARY_FILE)).catch(() => null);
+    }
+    /**
+     * Escribe el binario del documento como archivo crudo, sin JSON ni base64.
+     * Writes the document binary as a raw file, with no JSON nor base64.
+     */
+    async set_buffer(path, data, score) {
+        const dir = this._dir(path);
+        await mkdir(dir, { recursive: true });
+        const file = join(dir, BINARY_FILE);
+        const tmp = `${file}.${randomBytes(6).toString('hex')}.tmp`;
+        await writeFile(tmp, data);
+        await rename(tmp, file);
+        const when = score ?? Date.now();
+        if (score !== undefined) {
+            await utimes(file, new Date(score), new Date(score)).catch(() => { });
+        }
+        const { parent, name } = split_path(path);
+        this._indexes.get(parent)?.set(name, when);
+    }
     /**
      * Vacía completamente el almacén.
      * Clears the entire store.
@@ -172,4 +199,3 @@ export class FileSystemEngine {
         this._indexes.clear();
     }
 }
-//# sourceMappingURL=index.js.map

package/build/esm/lib/store/engine/lib/index.js

@@ -203,4 +203,3 @@ export function split_path(path) {
     const cut = full.lastIndexOf('/');
     return cut === -1 ? { parent: '', name: full } : { parent: full.slice(0, cut), name: full.slice(cut + 1) };
 }
-//# sourceMappingURL=index.js.map