@arcaelas/whatsapp 5.1.0 → 6.1.0

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

@@ -254,4 +254,3 @@ class WhatsAppBot extends whatsapp_1.default {
 }
 exports.WhatsAppBot = WhatsAppBot;
 exports.default = WhatsAppBot;
-//# sourceMappingURL=decorator.js.map

package/build/cjs/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/cjs/lib/bot/decorators.js

@@ -15,6 +15,7 @@ exports.from = from;
 exports.Bot = Bot;
 exports.pipe = pipe;
 exports.command = command;
+const internal_1 = require("../../lib/internal");
 const decorator_1 = require("./decorator");
 /**
  * Registra el método como listener del evento indicado. Apilable: varios `@on`
@@ -126,9 +127,9 @@ exports.pair = (0, decorator_1.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`
  */
@@ -146,7 +147,7 @@ function from(source) {
                 if (resolved === null) {
                     resolved = new Set();
                     for (const raw of list) {
-                        const r = await wa._resolve_jid(raw);
+                        const r = await (0, internal_1.internals)(wa).resolve_jid(raw);
                         if (r) {
                             resolved.add(r);
                         }
@@ -259,4 +260,3 @@ function command(pattern) {
         });
     };
 }
-//# sourceMappingURL=decorators.js.map

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

@@ -18,4 +18,3 @@ Object.defineProperty(exports, "delay", { enumerable: true, get: function () { r
 Object.defineProperty(exports, "pipe", { enumerable: true, get: function () { return decorators_1.pipe; } });
 Object.defineProperty(exports, "pair", { enumerable: true, get: function () { return decorators_1.pair; } });
 Object.defineProperty(exports, "Bot", { enumerable: true, get: function () { return decorators_1.Bot; } });
-//# sourceMappingURL=index.js.map

package/build/cjs/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/cjs/lib/chat/index.js

@@ -44,6 +44,10 @@ 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;
@@ -95,14 +99,14 @@ 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 = (0, internal_1.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).
@@ -123,10 +127,24 @@ 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, (0, internal_1.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 (0, store_1.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.
@@ -242,6 +260,8 @@ function chat(wa) {
             const socket = (0, internal_1.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}`, (0, store_1.serialize)(this._raw));
                 ok = true;
             }
             return ok;
@@ -323,4 +343,3 @@ function chat(wa) {
         }
     };
 }
-//# sourceMappingURL=index.js.map

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

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

package/build/cjs/lib/internal.js

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

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

@@ -103,6 +103,10 @@ export declare class Message {
     get status(): (typeof STATUS)[number];
     /** true si el mensaje fue visto. / true when the message was seen. */
     get read(): boolean;
+    /** Motivo del rechazo cuando `status` es `error` (`restricted`, `invalid-session`, o el código crudo); null en cualquier otro caso. / Rejection reason when `status` is `error` (`restricted`, `invalid-session`, or the raw code); null otherwise. */
+    get reason(): string | null;
+    /** Nombre del negocio verificado que firma el mensaje, o null. / Verified business name signing the message, or null. */
+    get business(): string | null;
     /** true si está destacado. / true when starred. */
     get starred(): boolean;
     /** true si fue reenviado. / true when forwarded. */
@@ -451,6 +455,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/cjs/lib/message/index.js

@@ -18,6 +18,16 @@ const chat_1 = require("../../lib/chat");
 const store_1 = require("../../lib/store");
 /** Estados legibles indexados por el status numérico de baileys. / Readable states indexed by the baileys numeric status. */
 const STATUS = ['error', 'pending', 'sent', 'delivered', 'read', 'played'];
+/**
+ * Motivos legibles de los códigos con los que el servidor rechaza un mensaje. `restricted`
+ * es la cuenta limitada por WhatsApp: puede seguir chats existentes pero no abrir nuevos.
+ * Readable reasons for the codes the server rejects a message with. `restricted` is an
+ * account limited by WhatsApp: it can continue existing chats but not open new ones.
+ */
+const REASON = {
+    463: 'restricted',
+    479: 'invalid-session',
+};
 const MESSAGE_TYPE_MAP = {
     conversation: 'text',
     extendedTextMessage: 'text',
@@ -79,11 +89,11 @@ async function send(wa, cid, content, binary, extra = {}, doc_overrides) {
         const quoted = extra.mid
             ? ((0, store_1.deserialize)(await wa.engine.get(`/chat/${jid}/message/${extra.mid}`))?.raw ?? undefined)
             : undefined;
-        const raw = await socket.sendMessage(jid, {
-            ...content,
-            ...(extra.once && { viewOnce: true }),
-            ...(quoted && { quoted }),
-        });
+        // La cita viaja en las opciones del socket, no en el contenido: dentro del contenido
+        // baileys la ignora y el mensaje sale sin `contextInfo`.
+        // The quote travels in the socket options, not in the content: inside the content
+        // baileys ignores it and the message goes out without `contextInfo`.
+        const raw = await socket.sendMessage(jid, { ...content, ...(extra.once && { viewOnce: true }) }, { ...(quoted && { quoted }) });
         const sent_id = raw?.key?.id;
         if (raw && sent_id) {
             const instance = message(wa, raw);
@@ -92,21 +102,56 @@ async function send(wa, cid, content, binary, extra = {}, doc_overrides) {
             }
             await wa.engine.set(`/chat/${jid}/message/${sent_id}`, (0, store_1.serialize)(instance._raw), instance._raw.created_at);
             if (binary) {
-                await wa.engine.set(`/chat/${jid}/message/${sent_id}/content`, (0, store_1.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 = (0, store_1.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, (0, store_1.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 = (0, store_1.deserialize)(await wa.engine.get(`/chat/${doc.cid}/message/${doc.id}/content`));
-    if (cached?.data) {
-        return node_stream_1.Readable.from(Buffer.from(cached.data, 'base64'));
+    const cached = await read_content(wa, `/chat/${doc.cid}/message/${doc.id}/content`);
+    if (cached) {
+        return node_stream_1.Readable.from(cached);
     }
     const socket = (0, internal_1.internals)(wa).socket;
     if (socket) {
@@ -196,6 +241,17 @@ class Message {
     get read() {
         return this._raw.status >= 4;
     }
+    /** Motivo del rechazo cuando `status` es `error` (`restricted`, `invalid-session`, o el código crudo); null en cualquier otro caso. / Rejection reason when `status` is `error` (`restricted`, `invalid-session`, or the raw code); null otherwise. */
+    get reason() {
+        const code = this._raw.raw.messageStubParameters?.[0];
+        if (this._raw.status === 0 && code)
+            return REASON[code] ?? code;
+        return null;
+    }
+    /** Nombre del negocio verificado que firma el mensaje, o null. / Verified business name signing the message, or null. */
+    get business() {
+        return this._raw.raw.verifiedBizName ?? null;
+    }
     /** true si está destacado. / true when starred. */
     get starred() {
         return this._raw.starred;
@@ -259,8 +315,7 @@ class Message {
      * @returns Buffer del contenido / Content buffer
      */
     async content() {
-        const cached = (0, store_1.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.
@@ -789,10 +844,21 @@ exports.Sticker = Sticker;
  * Document message; the actual MIME lives in the base `mime`.
  */
 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());
@@ -1079,4 +1145,3 @@ function message(wa, raw) {
     };
     return new (types[doc.type] ?? Message)(wa, doc);
 }
-//# sourceMappingURL=index.js.map

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

@@ -129,4 +129,3 @@ class Feed extends message_1.Message {
     }
 }
 exports.Feed = Feed;
-//# sourceMappingURL=index.js.map

package/build/cjs/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';
 export { RedisEngine, type RedisClient } from '../../../lib/store/engine/lib/redis';

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

@@ -15,4 +15,3 @@ var s3_1 = require("../../../lib/store/engine/lib/s3");
 Object.defineProperty(exports, "S3Engine", { enumerable: true, get: function () { return s3_1.S3Engine; } });
 var sqlite_1 = require("../../../lib/store/engine/lib/sqlite");
 Object.defineProperty(exports, "SQLiteEngine", { enumerable: true, get: function () { return sqlite_1.SQLiteEngine; } });
-//# sourceMappingURL=index.js.map

package/build/cjs/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/cjs/lib/store/engine/lib/file_system/index.js

@@ -13,6 +13,8 @@ const lib_1 = require("../../../../../lib/store/engine/lib");
 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
@@ -161,6 +163,31 @@ 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 (0, promises_1.readFile)((0, node_path_1.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 (0, promises_1.mkdir)(dir, { recursive: true });
+        const file = (0, node_path_1.join)(dir, BINARY_FILE);
+        const tmp = `${file}.${(0, node_crypto_1.randomBytes)(6).toString('hex')}.tmp`;
+        await (0, promises_1.writeFile)(tmp, data);
+        await (0, promises_1.rename)(tmp, file);
+        const when = score ?? Date.now();
+        if (score !== undefined) {
+            await (0, promises_1.utimes)(file, new Date(score), new Date(score)).catch(() => { });
+        }
+        const { parent, name } = (0, lib_1.split_path)(path);
+        this._indexes.get(parent)?.set(name, when);
+    }
     /**
      * Vacía completamente el almacén.
      * Clears the entire store.
@@ -176,4 +203,3 @@ class FileSystemEngine {
     }
 }
 exports.FileSystemEngine = FileSystemEngine;
-//# sourceMappingURL=index.js.map

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

@@ -210,4 +210,3 @@ 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

package/build/cjs/lib/store/engine/lib/redis/index.d.ts

@@ -13,18 +13,20 @@ import type { Engine } from '../../../../../lib/store/engine';
 export interface RedisClient {
     get(key: string): Promise<string | null>;
     set(key: string, value: string): Promise<unknown>;
-    del(keys: string | string[]): Promise<unknown>;
+    del(...keys: unknown[]): Promise<unknown>;
     mget(keys: string[]): Promise<(string | null)[]>;
     scan(cursor: number | string, ...args: unknown[]): Promise<[string, string[]]>;
     zadd(key: string, score: number, member: string): Promise<unknown>;
-    zrem(key: string, members: string | string[]): Promise<unknown>;
+    zrem(...args: unknown[]): Promise<unknown>;
     zrevrange(key: string, start: number, stop: number): Promise<string[]>;
     zcard(key: string): Promise<number>;
+    getBuffer?(...args: unknown[]): Promise<Buffer | null>;
+    setBuffer?(...args: unknown[]): Promise<unknown>;
     pipeline?(): {
         set(key: string, value: string): unknown;
-        del(keys: string | string[]): unknown;
+        del(...keys: unknown[]): unknown;
         zadd(key: string, score: number, member: string): unknown;
-        zrem(key: string, members: string | string[]): unknown;
+        zrem(...args: unknown[]): unknown;
         exec(): Promise<unknown>;
     };
 }
@@ -82,6 +84,18 @@ export declare class RedisEngine implements Engine {
      * Counts direct children in O(1) via ZCARD.
      */
     count(path: string): Promise<number>;
+    /**
+     * Lee el binario del documento. Requiere un cliente con soporte de buffers (ioredis lo
+     * trae con `getBuffer`); sin él la librería cae al documento serializado.
+     * Reads the document binary. Requires a buffer-capable client (ioredis ships `getBuffer`);
+     * without it the library falls back to the serialized document.
+     */
+    get_buffer(path: string): Promise<Buffer | null>;
+    /**
+     * Escribe el binario del documento en su propia key, sin JSON ni base64.
+     * Writes the document binary in its own key, with no JSON nor base64.
+     */
+    set_buffer(path: string, data: Buffer, score?: number): Promise<void>;
     /**
      * Vacía todo el prefix del cliente.
      * Clears the entire client prefix.

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

@@ -78,12 +78,12 @@ class RedisEngine {
         const full = (0, lib_1.normalize_path)(path);
         const pipeline = this._client.pipeline?.();
         if (pipeline) {
-            pipeline.del(this._doc_key(full));
+            pipeline.del([this._doc_key(full), `${this._doc_key(full)}:bin`]);
             pipeline.zrem(this._idx_key(parent), full);
             await pipeline.exec();
         }
         else {
-            await this._client.del(this._doc_key(full));
+            await this._client.del([this._doc_key(full), `${this._doc_key(full)}:bin`]);
             await this._client.zrem(this._idx_key(parent), full);
         }
         await Promise.all([
@@ -112,6 +112,25 @@ class RedisEngine {
     async count(path) {
         return this._client.zcard(this._idx_key(path));
     }
+    /**
+     * Lee el binario del documento. Requiere un cliente con soporte de buffers (ioredis lo
+     * trae con `getBuffer`); sin él la librería cae al documento serializado.
+     * Reads the document binary. Requires a buffer-capable client (ioredis ships `getBuffer`);
+     * without it the library falls back to the serialized document.
+     */
+    async get_buffer(path) {
+        return (await this._client.getBuffer?.(`${this._doc_key(path)}:bin`)) ?? null;
+    }
+    /**
+     * Escribe el binario del documento en su propia key, sin JSON ni base64.
+     * Writes the document binary in its own key, with no JSON nor base64.
+     */
+    async set_buffer(path, data, score) {
+        const { parent } = (0, lib_1.split_path)(path);
+        const full = (0, lib_1.normalize_path)(path);
+        await this._client.setBuffer?.(`${this._doc_key(full)}:bin`, data);
+        await this._client.zadd(this._idx_key(parent), score ?? Date.now(), full);
+    }
     /**
      * Vacía todo el prefix del cliente.
      * Clears the entire client prefix.
@@ -137,4 +156,3 @@ class RedisEngine {
     }
 }
 exports.RedisEngine = RedisEngine;
-//# sourceMappingURL=index.js.map

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

@@ -214,4 +214,3 @@ class S3Engine {
     }
 }
 exports.S3Engine = S3Engine;
-//# sourceMappingURL=index.js.map