@arcaelas/whatsapp 4.5.0 → 6.0.0

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

@@ -1,85 +1,75 @@
 /**
  * @file status/index.ts
- * @description Entidad `Feed` — representa una publicación del status broadcast
- * (`status@broadcast`). Análoga a `Message` pero acotada al ciclo de vida de un
- * status (24h, no se cita, no se edita, sin starring/forward).
- * Status broadcast entry. Analogous to `Message` but scoped to the status
- * lifecycle (24h TTL, no quoting, no editing, no starring/forward).
+ * @description Entidad Feed — publicación del status broadcast (`status@broadcast`) como
+ * subclase de Message: hereda author/chat/content/stream y anula lo que un status no soporta.
+ * Feed entity — status broadcast post as a Message subclass: inherits
+ * author/chat/content/stream and voids what a status does not support.
  */
-import { type WAMessage } from 'baileys';
-import { Readable } from 'node:stream';
-import { Contact } from '../../lib/contact';
+import type { WAMessage } from 'baileys';
+import { Message } from '../../lib/message';
 import type { WhatsApp } from '../../lib/whatsapp';
-/** Tipos soportados por un status broadcast. / Status broadcast supported types. */
-export type FeedType = 'text' | 'image' | 'video' | 'audio';
-/**
- * Documento persistido del status.
- * Persisted status document.
- */
-export interface IFeedRaw {
-    id: string;
-    author_jid: string;
-    type: FeedType;
-    caption: string;
-    mime: string;
-    created_at: number;
-    expires_at: number;
-    viewed: boolean;
-    raw: WAMessage;
-}
 /** Vida útil del status: 24 horas en ms. / Status lifetime: 24h in ms. */
 export declare const TTL_MS: number;
 /**
- * Status broadcast — una publicación del feed `status@broadcast` con duración 24h.
- *
- * Status broadcast entry — a `status@broadcast` post with a 24h lifetime.
+ * Publicación del status broadcast. El documento del status se adapta al shape de
+ * Message en el constructor (`cid` fijo a `status@broadcast`, `author` desde
+ * `author_jid`, `deleted_at` desde `expires_at`), así los getters heredados aplican
+ * tal cual.
+ * Status broadcast post. The status document is adapted to the Message shape in the
+ * constructor (`cid` pinned to `status@broadcast`, `author` from `author_jid`,
+ * `deleted_at` from `expires_at`), so inherited getters apply as-is.
  */
-export default class Feed {
-    /** @internal */
-    protected readonly _wa: WhatsApp;
-    /** @internal */
-    protected readonly _doc: IFeedRaw;
-    /** @internal Cache de la promesa de `author()` para evitar engine round-trips repetidos. */
-    private _author_cache;
-    constructor(options: {
-        wa: WhatsApp;
-        doc: IFeedRaw;
+export declare class Feed extends Message {
+    constructor(wa: WhatsApp, doc: {
+        id: string;
+        author_jid: string;
+        type: 'text' | 'image' | 'video' | 'audio';
+        caption: string;
+        mime: string;
+        created_at: number;
+        expires_at: number;
+        viewed: boolean;
+        raw: WAMessage;
     });
-    /** Identificador del status (mid). / Status id (mid). */
-    get id(): string;
-    /** Tipo de contenido. / Content type. */
-    get type(): FeedType;
     /** true si ya enviamos read receipt sobre este status. / true once a read receipt was sent. */
     get viewed(): boolean;
-    /** Texto / caption del status. / Status text or caption. */
-    get caption(): string;
-    /** Epoch ms de publicación. / Publication epoch ms. */
-    get created_at(): number;
-    /** Epoch ms de expiración (created_at + 24h). / Expiration epoch ms (created_at + 24h). */
-    get expires_at(): number;
-    /**
-     * Resuelve el autor del status. Memoizado a nivel de instancia: la primera
-     * llamada va al engine vía `wa.Contact.get`; las siguientes devuelven la misma
-     * instancia sin volver a leer.
-     * Resolves the status author. Instance-memoized: first call hits the engine
-     * via `wa.Contact.get`; subsequent calls return the cached instance.
-     */
-    author(): Promise<Contact>;
-    /**
-     * Stream progresivo del contenido. Para texto envuelve el caption; para media
-     * lee del cache del engine y, si falta, descarga desde baileys.
-     * Progressive content stream. For text wraps the caption; for media reads the
-     * engine cache and falls back to baileys download.
-     */
-    stream(): Promise<Readable>;
-    /**
-     * Acumula el stream del status en un Buffer.
-     * Drains the status stream into a Buffer.
-     */
-    content(): Promise<Buffer>;
     /**
-     * Marca el status como visto enviando read receipt. Persiste `viewed = true`.
-     * Marks the status as seen sending a read receipt. Persists `viewed = true`.
+     * Marca el status como visto enviando read receipt y persiste `viewed`.
+     * Marks the status as seen sending a read receipt and persists `viewed`.
+     *
+     * @returns true si se envió / true when sent
      */
     view(): Promise<boolean>;
+    /** Un status marca visto con `view()`. / A status marks seen via `view()`. */
+    seen(): Promise<boolean>;
+    /** No soportado en un status. / Unsupported on a status. */
+    message(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    react(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    star(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    edit(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    forward(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    delete(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    text(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    image(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    video(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    audio(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    location(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    poll(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    document(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    vcard(): Promise<never>;
+    /** No soportado en un status. / Unsupported on a status. */
+    event(): Promise<never>;
 }

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

@@ -1,137 +1,131 @@
 "use strict";
 /**
  * @file status/index.ts
- * @description Entidad `Feed` — representa una publicación del status broadcast
- * (`status@broadcast`). Análoga a `Message` pero acotada al ciclo de vida de un
- * status (24h, no se cita, no se edita, sin starring/forward).
- * Status broadcast entry. Analogous to `Message` but scoped to the status
- * lifecycle (24h TTL, no quoting, no editing, no starring/forward).
+ * @description Entidad Feed — publicación del status broadcast (`status@broadcast`) como
+ * subclase de Message: hereda author/chat/content/stream y anula lo que un status no soporta.
+ * Feed entity — status broadcast post as a Message subclass: inherits
+ * author/chat/content/stream and voids what a status does not support.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TTL_MS = void 0;
-const baileys_1 = require("baileys");
-const node_stream_1 = require("node:stream");
+exports.Feed = exports.TTL_MS = void 0;
+const internal_1 = require("../../lib/internal");
+const message_1 = require("../../lib/message");
 const store_1 = require("../../lib/store");
 /** Vida útil del status: 24 horas en ms. / Status lifetime: 24h in ms. */
 exports.TTL_MS = 24 * 60 * 60 * 1000;
 /**
- * Status broadcast — una publicación del feed `status@broadcast` con duración 24h.
- *
- * Status broadcast entry — a `status@broadcast` post with a 24h lifetime.
+ * Publicación del status broadcast. El documento del status se adapta al shape de
+ * Message en el constructor (`cid` fijo a `status@broadcast`, `author` desde
+ * `author_jid`, `deleted_at` desde `expires_at`), así los getters heredados aplican
+ * tal cual.
+ * Status broadcast post. The status document is adapted to the Message shape in the
+ * constructor (`cid` pinned to `status@broadcast`, `author` from `author_jid`,
+ * `deleted_at` from `expires_at`), so inherited getters apply as-is.
  */
-class Feed {
-    constructor(options) {
-        /** @internal Cache de la promesa de `author()` para evitar engine round-trips repetidos. */
-        this._author_cache = null;
-        this._wa = options.wa;
-        this._doc = options.doc;
-    }
-    /** Identificador del status (mid). / Status id (mid). */
-    get id() {
-        return this._doc.id;
-    }
-    /** Tipo de contenido. / Content type. */
-    get type() {
-        return this._doc.type;
+class Feed extends message_1.Message {
+    constructor(wa, doc) {
+        super(wa, {
+            ...doc,
+            cid: 'status@broadcast',
+            mid: null,
+            me: false,
+            author: doc.author_jid,
+            status: 1,
+            starred: false,
+            forwarded: false,
+            deleted_at: doc.expires_at,
+            edited: false,
+        });
     }
     /** true si ya enviamos read receipt sobre este status. / true once a read receipt was sent. */
     get viewed() {
-        return this._doc.viewed;
-    }
-    /** Texto / caption del status. / Status text or caption. */
-    get caption() {
-        return this._doc.caption;
-    }
-    /** Epoch ms de publicación. / Publication epoch ms. */
-    get created_at() {
-        return this._doc.created_at;
-    }
-    /** Epoch ms de expiración (created_at + 24h). / Expiration epoch ms (created_at + 24h). */
-    get expires_at() {
-        return this._doc.expires_at;
-    }
-    /**
-     * Resuelve el autor del status. Memoizado a nivel de instancia: la primera
-     * llamada va al engine vía `wa.Contact.get`; las siguientes devuelven la misma
-     * instancia sin volver a leer.
-     * Resolves the status author. Instance-memoized: first call hits the engine
-     * via `wa.Contact.get`; subsequent calls return the cached instance.
-     */
-    async author() {
-        return (this._author_cache ??= (async () => {
-            const { _wa, _doc } = this;
-            const fetched = await _wa.Contact.get(_doc.author_jid);
-            return (fetched ??
-                new _wa.Contact({
-                    id: _doc.author_jid,
-                    lid: null,
-                    name: null,
-                    notify: null,
-                    verified_name: null,
-                    img_url: null,
-                    status: null,
-                }, new _wa.Chat({
-                    id: _doc.author_jid,
-                    name: _doc.author_jid.split('@')[0],
-                })));
-        })());
-    }
-    /**
-     * Stream progresivo del contenido. Para texto envuelve el caption; para media
-     * lee del cache del engine y, si falta, descarga desde baileys.
-     * Progressive content stream. For text wraps the caption; for media reads the
-     * engine cache and falls back to baileys download.
-     */
-    async stream() {
-        const { _wa, _doc } = this;
-        if (_doc.type === 'text') {
-            return node_stream_1.Readable.from(Buffer.from(_doc.caption, 'utf-8'));
-        }
-        const cached = (0, store_1.deserialize)(await _wa.engine.get(`/status/${_doc.id}/content`));
-        if (cached?.data) {
-            return node_stream_1.Readable.from(Buffer.from(cached.data, 'base64'));
-        }
-        if (_wa._socket) {
-            try {
-                return (await (0, baileys_1.downloadMediaMessage)(_doc.raw, 'stream', {}));
-            }
-            catch {
-                /* fallback empty */
-            }
-        }
-        return node_stream_1.Readable.from(Buffer.alloc(0));
-    }
-    /**
-     * Acumula el stream del status en un Buffer.
-     * Drains the status stream into a Buffer.
-     */
-    async content() {
-        const chunks = [];
-        for await (const chunk of await this.stream()) {
-            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-        }
-        return Buffer.concat(chunks);
+        return this._raw.viewed ?? false;
     }
     /**
-     * Marca el status como visto enviando read receipt. Persiste `viewed = true`.
-     * Marks the status as seen sending a read receipt. Persists `viewed = true`.
+     * Marca el status como visto enviando read receipt y persiste `viewed`.
+     * Marks the status as seen sending a read receipt and persists `viewed`.
+     *
+     * @returns true si se envió / true when sent
      */
     async view() {
-        const { _wa, _doc } = this;
         let ok = false;
-        if (_wa._socket) {
-            if (!_doc.viewed) {
-                await _wa._socket.readMessages([
-                    { remoteJid: 'status@broadcast', id: _doc.id, participant: _doc.author_jid },
+        const socket = (0, internal_1.internals)(this._wa).socket;
+        if (socket) {
+            if (!this.viewed) {
+                await socket.readMessages([
+                    { remoteJid: 'status@broadcast', id: this._raw.id, participant: this._raw.author },
                 ]);
-                _doc.viewed = true;
-                await _wa.engine.set(`/status/${_doc.id}`, (0, store_1.serialize)(_doc));
+                this._raw.viewed = true;
+                await this._wa.engine.set(`/status/${this._raw.id}`, (0, store_1.serialize)(this._raw));
             }
-            _wa._event.emit('feed:updated', this, _wa);
+            this._wa.emit('feed:updated', this, this._wa);
             ok = true;
         }
         return ok;
     }
+    /** Un status marca visto con `view()`. / A status marks seen via `view()`. */
+    async seen() {
+        return this.view();
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async message() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async react() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async star() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async edit() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async forward() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async delete() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async text() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async image() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async video() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async audio() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async location() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async poll() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async document() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async vcard() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
+    /** No soportado en un status. / Unsupported on a status. */
+    async event() {
+        throw new Error('ERR_FEED_UNSUPPORTED');
+    }
 }
-exports.default = Feed;
-//# sourceMappingURL=index.js.map
+exports.Feed = Feed;

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

@@ -1,7 +1,8 @@
 /**
  * @file store/engine/index.ts
- * @description Contrato del motor de persistencia (string-based) y barrel de drivers.
- * Engine contract (string-based) and drivers barrel.
+ * @description Contrato del motor de persistencia (string-based), utilidades compartidas
+ * por los drivers y barrel de implementaciones.
+ * Engine contract (string-based), shared driver utilities and implementations barrel.
  */
 /**
  * Contrato de persistencia key-value de strings. El engine no conoce JSON; la serialización
@@ -12,24 +13,51 @@
  *
  * Reglas / Rules:
  * - Paths se normalizan quitando slashes redundantes. / Paths strip redundant slashes.
- * - `set` refresca el mtime (drives `list` order). / `set` refreshes mtime.
+ * - `set` fija el score de orden: el `score` explícito cuando llega, o la hora de escritura.
+ *   / `set` fixes the ordering score: the explicit `score` when given, else write time.
  * - `unset` hace cascade sobre el sub-árbol. / `unset` cascades the subtree.
- * - `list` solo devuelve hijos directos ordenados por mtime DESC. / `list` yields direct children, mtime DESC.
+ * - `list` solo devuelve hijos directos ordenados por score DESC. / `list` yields direct children, score DESC.
+ * - `list` y `count` cuestan O(limit) amortizado: los drivers mantienen un índice ordenado
+ *   por directorio en vez de recorrer y re-ordenar el padre en cada página (ver `SortedIndex`).
+ *   / `list` and `count` cost O(limit) amortized: drivers keep a per-directory sorted index
+ *   instead of scanning and re-sorting the parent on every page.
  */
 export interface Engine {
     /** Lee un valor por path. Retorna null si no existe. / Reads a value by path; null if missing. */
     get(path: string): Promise<string | null>;
-    /** Escribe un valor. Refresca el mtime. / Writes a value. Refreshes mtime. */
-    set(path: string, value: string): Promise<void>;
+    /**
+     * Escribe un valor. `score` fija el orden de `list` (epoch ms del documento, ej. `created_at`);
+     * sin él se usa la hora de escritura — los re-syncs que reescriben documentos históricos DEBEN
+     * pasar el score para no destruir la cronología.
+     * Writes a value. `score` drives `list` ordering (document epoch ms, e.g. `created_at`);
+     * without it write time is used — re-syncs rewriting historical documents MUST pass the
+     * score to preserve chronology.
+     */
+    set(path: string, value: string, score?: number): Promise<void>;
     /** Elimina el valor y todos sus descendientes. Idempotente. / Cascade delete. Idempotent. */
     unset(path: string): Promise<boolean>;
-    /** Lista valores de los hijos directos, paginados por mtime DESC. / Lists direct children values, mtime DESC. */
+    /** Lista valores de los hijos directos, paginados por score DESC. / Lists direct children values, score DESC. */
     list(path: string, offset?: number, limit?: number): Promise<string[]>;
     /** Cuenta hijos directos sin leer los valores. / Counts direct children without loading values. */
     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';
 export { S3Engine } from '../../../lib/store/engine/lib/s3';
+export { SQLiteEngine, type SQLiteDatabase } from '../../../lib/store/engine/lib/sqlite';

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

@@ -1,15 +1,17 @@
 "use strict";
 /**
  * @file store/engine/index.ts
- * @description Contrato del motor de persistencia (string-based) y barrel de drivers.
- * Engine contract (string-based) and drivers barrel.
+ * @description Contrato del motor de persistencia (string-based), utilidades compartidas
+ * por los drivers y barrel de implementaciones.
+ * Engine contract (string-based), shared driver utilities and implementations barrel.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.S3Engine = exports.RedisEngine = exports.FileSystemEngine = void 0;
+exports.SQLiteEngine = exports.S3Engine = exports.RedisEngine = exports.FileSystemEngine = void 0;
 var file_system_1 = require("../../../lib/store/engine/lib/file_system");
 Object.defineProperty(exports, "FileSystemEngine", { enumerable: true, get: function () { return file_system_1.FileSystemEngine; } });
 var redis_1 = require("../../../lib/store/engine/lib/redis");
 Object.defineProperty(exports, "RedisEngine", { enumerable: true, get: function () { return redis_1.RedisEngine; } });
 var s3_1 = require("../../../lib/store/engine/lib/s3");
 Object.defineProperty(exports, "S3Engine", { enumerable: true, get: function () { return s3_1.S3Engine; } });
-//# sourceMappingURL=index.js.map
+var sqlite_1 = require("../../../lib/store/engine/lib/sqlite");
+Object.defineProperty(exports, "SQLiteEngine", { enumerable: true, get: function () { return sqlite_1.SQLiteEngine; } });

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

@@ -7,10 +7,22 @@ import type { Engine } from '../../../../../lib/store/engine';
 /**
  * Driver de persistencia en sistema de archivos.
  * Cada documento se almacena como `<base>/<path>/index.json` de modo que un recurso pueda
- * coexistir con sub-recursos anidados.
+ * coexistir con sub-recursos anidados. Las escrituras son atómicas (tmp + rename) y el score
+ * de orden viaja en el mtime del archivo.
+ *
+ * Para que `list`/`count` cuesten O(limit) mantiene un índice ordenado por directorio
+ * (`SortedIndex`), acotado por LRU y respaldado en `<dir>/.order`: al abrir un directorio
+ * carga ese archivo y sólo reconstruye con `readdir` + `stat` cuando el conteo no coincide.
+ * Asume un único proceso escritor sobre el directorio base.
  *
  * Filesystem persistence driver. Each document lives at `<base>/<path>/index.json` so a
- * resource can coexist with nested sub-resources.
+ * resource can coexist with nested sub-resources. Writes are atomic (tmp + rename) and the
+ * ordering score travels in the file mtime.
+ *
+ * To keep `list`/`count` at O(limit) it maintains a per-directory sorted index
+ * (`SortedIndex`), LRU-bounded and backed by `<dir>/.order`: opening a directory loads that
+ * file and only rebuilds via `readdir` + `stat` when the count does not match. Assumes a
+ * single writer process over the base directory.
  *
  * @example
  * const engine = new FileSystemEngine('/tmp/wa');
@@ -18,29 +30,47 @@ import type { Engine } from '../../../../../lib/store/engine';
  */
 export declare class FileSystemEngine implements Engine {
     private readonly _base;
-    constructor(_base: string);
+    /** @internal Índices por directorio, acotados por LRU. / Per-directory indexes, LRU-bounded. */
+    private readonly _indexes;
+    /**
+     * @param _base - Directorio raíz del almacén / Store root directory
+     * @param cached - Directorios indexados simultáneamente en memoria / Simultaneously in-memory indexed directories
+     */
+    constructor(_base: string, cached?: number);
     /** @internal */
     private _dir;
     /** @internal */
     private _file;
+    /**
+     * @internal
+     * Índice del directorio: lo toma de la caché, del `.order` persistido (validando el conteo
+     * contra `readdir`) o lo reconstruye leyendo el mtime de cada hijo.
+     * Directory index: taken from the cache, from the persisted `.order` (validating the count
+     * against `readdir`) or rebuilt reading each child's mtime.
+     */
+    private _index;
+    /** @internal Escritura atómica: archivo temporal y rename sobre el destino. / Atomic write: temp file plus rename onto the target. */
+    private _write;
     /**
      * Lee el valor de un documento.
      * Reads a document's value.
      */
     get(path: string): Promise<string | null>;
     /**
-     * Escribe el valor de un documento, creando los directorios necesarios.
-     * Writes a document's value, creating directories as needed.
+     * Escribe el valor de un documento de forma atómica creando los directorios necesarios;
+     * con `score` fija el mtime del archivo (y por tanto el orden de `list`).
+     * Atomically writes a document's value creating directories as needed; `score` fixes the
+     * file mtime (and therefore `list` ordering).
      */
-    set(path: string, value: string): Promise<void>;
+    set(path: string, value: string, score?: number): Promise<void>;
     /**
      * Elimina el documento y todos sus descendientes. Idempotente.
      * Deletes the document and every descendant. Idempotent.
      */
     unset(path: string): Promise<boolean>;
     /**
-     * Lista los valores de los hijos directos, ordenados por mtime DESC.
-     * Lists direct children values ordered by mtime DESC.
+     * Lista los valores de los hijos directos, ordenados por score DESC.
+     * Lists direct children values ordered by score DESC.
      */
     list(path: string, offset?: number, limit?: number): Promise<string[]>;
     /**
@@ -48,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.