@arcaelas/whatsapp 4.5.0 → 5.1.0

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

@@ -1,15 +1,18 @@
 "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; } });
+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/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/store/engine/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAmCH,kEAAsE;AAA7D,+GAAA,gBAAgB,OAAA;AACzB,sDAA6E;AAApE,oGAAA,WAAW,OAAA;AACpB,gDAAqD;AAA5C,8FAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/store/engine/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA+CH,kEAAsE;AAA7D,+GAAA,gBAAgB,OAAA;AACzB,sDAA6E;AAApE,oGAAA,WAAW,OAAA;AACpB,gDAAqD;AAA5C,8FAAA,QAAQ,OAAA;AACjB,wDAAkF;AAAzE,sGAAA,YAAY,OAAA"}

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[]>;
     /**

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

@@ -6,40 +6,98 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileSystemEngine = void 0;
+const node_crypto_1 = require("node:crypto");
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
+const lib_1 = require("../../../../../lib/store/engine/lib");
 const INDEX_FILE = 'index.json';
-/**
- * Normaliza un path colapsando slashes redundantes.
- * Normalizes a path by collapsing redundant slashes.
- */
-function normalize_path(path) {
-    return path.replace(/\/+/g, '/').replace(/^\/|\/$/g, '');
-}
+/** Índice de orden persistido junto a los hijos del directorio. / Ordering index persisted next to the directory children. */
+const ORDER_FILE = '.order';
 /**
  * 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');
  * await engine.set('/chat/123', JSON.stringify({ name: 'John' }));
  */
 class FileSystemEngine {
-    constructor(_base) {
+    /**
+     * @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, cached = 12) {
         this._base = _base;
+        this._indexes = new lib_1.IndexCache(cached);
     }
     /** @internal */
     _dir(path) {
-        return (0, node_path_1.join)(this._base, normalize_path(path));
+        return (0, node_path_1.join)(this._base, (0, lib_1.normalize_path)(path));
     }
     /** @internal */
     _file(path) {
         return (0, node_path_1.join)(this._dir(path), INDEX_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.
+     */
+    async _index(path) {
+        const key = (0, lib_1.normalize_path)(path);
+        const cached = this._indexes.get(key);
+        if (cached) {
+            return cached;
+        }
+        const dir = (0, node_path_1.join)(this._base, key);
+        const index = new lib_1.SortedIndex(async (entries) => {
+            await this._write((0, node_path_1.join)(dir, ORDER_FILE), entries.map(([name, score]) => `${score}\t${name}`).join('\n')).catch(() => { });
+        });
+        const children = (await (0, promises_1.readdir)(dir, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory());
+        const persisted = (await (0, promises_1.readFile)((0, node_path_1.join)(dir, ORDER_FILE), 'utf-8').catch(() => null))
+            ?.split('\n')
+            .filter(Boolean)
+            .map((line) => {
+            const cut = line.indexOf('\t');
+            return [line.slice(cut + 1), Number(line.slice(0, cut))];
+        });
+        if (persisted?.length === children.length) {
+            index.load(persisted);
+        }
+        else {
+            const scanned = await Promise.all(children.map(async (entry) => {
+                const found = await (0, promises_1.stat)((0, node_path_1.join)(dir, entry.name, INDEX_FILE)).catch(() => null);
+                return found ? [entry.name, found.mtimeMs] : null;
+            }));
+            index.load(scanned.filter((entry) => entry !== null));
+        }
+        this._indexes.set(key, index);
+        return index;
+    }
+    /** @internal Escritura atómica: archivo temporal y rename sobre el destino. / Atomic write: temp file plus rename onto the target. */
+    async _write(file, value) {
+        const tmp = `${file}.${(0, node_crypto_1.randomBytes)(6).toString('hex')}.tmp`;
+        await (0, promises_1.writeFile)(tmp, value, 'utf-8');
+        await (0, promises_1.rename)(tmp, file);
+    }
     /**
      * Lee el valor de un documento.
      * Reads a document's value.
@@ -53,13 +111,22 @@ class FileSystemEngine {
         }
     }
     /**
-     * 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).
      */
-    async set(path, value) {
+    async set(path, value, score) {
         const dir = this._dir(path);
         await (0, promises_1.mkdir)(dir, { recursive: true });
-        await (0, promises_1.writeFile)((0, node_path_1.join)(dir, INDEX_FILE), value, 'utf-8');
+        const file = (0, node_path_1.join)(dir, INDEX_FILE);
+        await this._write(file, value);
+        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);
     }
     /**
      * Elimina el documento y todos sus descendientes. Idempotente.
@@ -72,70 +139,27 @@ class FileSystemEngine {
         catch {
             /* idempotent */
         }
+        const { parent, name } = (0, lib_1.split_path)(path);
+        this._indexes.get(parent)?.delete(name);
+        this._indexes.drop((0, lib_1.normalize_path)(path));
         return true;
     }
     /**
-     * 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.
      */
     async list(path, offset = 0, limit = 50) {
         const dir = this._dir(path);
-        try {
-            const entries = await (0, promises_1.readdir)(dir, { withFileTypes: true });
-            const stats = await Promise.all(entries
-                .filter((e) => e.isDirectory())
-                .map(async (entry) => {
-                const file = (0, node_path_1.join)(dir, entry.name, INDEX_FILE);
-                try {
-                    const st = await (0, promises_1.stat)(file);
-                    return { file, mtime: st.mtimeMs };
-                }
-                catch {
-                    return null;
-                }
-            }));
-            const valid = stats.filter((x) => x !== null);
-            valid.sort((a, b) => b.mtime - a.mtime);
-            const page = valid.slice(offset, offset + limit);
-            const values = await Promise.all(page.map(async ({ file }) => {
-                try {
-                    return await (0, promises_1.readFile)(file, 'utf-8');
-                }
-                catch {
-                    return null;
-                }
-            }));
-            return values.filter((value) => value !== null);
-        }
-        catch {
-            return [];
-        }
+        const page = (await this._index(path)).page(offset, limit);
+        const values = await Promise.all(page.map((name) => (0, promises_1.readFile)((0, node_path_1.join)(dir, name, INDEX_FILE), 'utf-8').catch(() => null)));
+        return values.filter((value) => value !== null);
     }
     /**
      * Cuenta los hijos directos que tienen un documento válido.
      * Counts direct children with a valid document.
      */
     async count(path) {
-        const dir = this._dir(path);
-        try {
-            const entries = await (0, promises_1.readdir)(dir, { withFileTypes: true });
-            let total = 0;
-            await Promise.all(entries
-                .filter((e) => e.isDirectory())
-                .map(async (entry) => {
-                try {
-                    await (0, promises_1.stat)((0, node_path_1.join)(dir, entry.name, INDEX_FILE));
-                    total++;
-                }
-                catch {
-                    /* not a valid child doc */
-                }
-            }));
-            return total;
-        }
-        catch {
-            return 0;
-        }
+        return (await this._index(path)).size;
     }
     /**
      * Vacía completamente el almacén.
@@ -148,6 +172,7 @@ class FileSystemEngine {
         catch {
             /* idempotent */
         }
+        this._indexes.clear();
     }
 }
 exports.FileSystemEngine = FileSystemEngine;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/lib/store/engine/lib/file_system/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/lib/store/engine/lib/file_system/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6CAA0C;AAC1C,+CAAiG;AACjG,yCAAiC;AAEjC,gDAA6F;AAE7F,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,8HAA8H;AAC9H,MAAM,UAAU,GAAG,QAAQ,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,gBAAgB;IAI3B;;;OAGG;IACH,YAA6B,KAAa,EAAE,MAAM,GAAG,EAAE;QAA1B,UAAK,GAAL,KAAK,CAAQ;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAU,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB;IACR,IAAI,CAAC,IAAY;QACvB,OAAO,IAAA,gBAAI,EAAC,IAAI,CAAC,KAAK,EAAE,IAAA,oBAAc,EAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,gBAAgB;IACR,KAAK,CAAC,IAAY;QACxB,OAAO,IAAA,gBAAI,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,MAAM,CAAC,IAAY;QAC/B,MAAM,GAAG,GAAG,IAAA,oBAAc,EAAC,IAAI,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,iBAAW,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5H,CAAC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAA,kBAAO,EAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACtH,MAAM,SAAS,GAAG,CAAC,MAAM,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAClF,EAAE,KAAK,CAAC,IAAI,CAAC;aACZ,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAqB,CAAC;QAC/E,CAAC,CAAC,CAAC;QACL,IAAI,SAAS,EAAE,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC3B,MAAM,KAAK,GAAG,MAAM,IAAA,eAAI,EAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC9E,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAsB,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1E,CAAC,CAAC,CACH,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sIAAsI;IAC9H,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,KAAa;QAC9C,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAA,yBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5D,MAAM,IAAA,oBAAS,EAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,IAAA,iBAAM,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,IAAI,CAAC;YACH,OAAO,MAAM,IAAA,mBAAQ,EAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,KAAc;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAA,iBAAM,EAAC,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,gBAAU,EAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,IAAI,CAAC;YACH,MAAM,IAAA,aAAE,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,gBAAU,EAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAA,oBAAc,EAAC,IAAI,CAAC,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CACrF,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,MAAM,IAAA,aAAE,EAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AArJD,4CAqJC"}

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

@@ -0,0 +1,112 @@
+/**
+ * @file store/engine/lib/index.ts
+ * @description Utilidades compartidas por los drivers: índice ordenado por directorio,
+ * caché LRU de índices y normalización de rutas.
+ * Shared driver utilities: per-directory sorted index, LRU index cache and path normalization.
+ */
+/**
+ * @internal
+ * Índice ordenado por score DESC de los hijos de un directorio, mantenido incrementalmente:
+ * `page()` recorta sin re-ordenar y `set`/`delete` reubican una sola entrada por búsqueda
+ * binaria. Persiste su contenido con el callback `_flush`, agrupando ráfagas de escritura.
+ *
+ * Score-DESC sorted index of a directory's children, kept incrementally: `page()` slices
+ * without re-sorting and `set`/`delete` relocate a single entry via binary search. Persists
+ * through the `_flush` callback, coalescing write bursts.
+ */
+export declare class SortedIndex {
+    private readonly _flush;
+    private readonly _delay;
+    /** @internal Nombres ordenados por score DESC. / Names ordered by score DESC. */
+    private _order;
+    /** @internal Score vigente de cada nombre. / Current score per name. */
+    private _scores;
+    private _dirty;
+    private _timer;
+    /**
+     * @param _flush - Persiste el índice; recibe los pares ordenados / Persists the index; receives the ordered pairs
+     * @param _delay - Espera antes de persistir, agrupando ráfagas / Wait before persisting, coalescing bursts
+     */
+    constructor(_flush: (entries: [string, number][]) => Promise<void>, _delay?: number);
+    /** Cantidad de hijos indexados. / Indexed children count. */
+    get size(): number;
+    /** Pares `[nombre, score]` en orden DESC. / `[name, score]` pairs in DESC order. */
+    get entries(): [string, number][];
+    /**
+     * Reemplaza el índice completo con las entradas dadas, ordenándolas una sola vez.
+     * Replaces the whole index with the given entries, sorting them once.
+     */
+    load(entries: Iterable<[string, number]>): void;
+    /** Página de nombres en orden DESC, sin re-ordenar. / Page of names in DESC order, no re-sorting. */
+    page(offset: number, limit: number): string[];
+    /**
+     * Inserta o reubica un hijo con su score, manteniendo el orden.
+     * Inserts or relocates a child with its score, keeping the order.
+     */
+    set(name: string, score: number): void;
+    /**
+     * Quita un hijo del índice.
+     * Removes a child from the index.
+     */
+    delete(name: string): void;
+    /**
+     * Cancela la persistencia pendiente; se usa al descartar el índice de la caché.
+     * Cancels the pending persistence; used when dropping the index from the cache.
+     */
+    dispose(): void;
+    /** @internal Saca el nombre de la lista ordenada si estaba presente. / Detaches the name from the ordered list when present. */
+    private _detach;
+    /** @internal Primera posición cuyo score es menor o igual al dado (orden DESC). / First position whose score is lower or equal to the given one (DESC order). */
+    private _locate;
+    /** @internal Programa la persistencia diferida. / Schedules the deferred persistence. */
+    private _schedule;
+}
+/**
+ * @internal
+ * Caché LRU de índices por directorio: mantiene acotada la memoria del driver descartando
+ * el directorio menos usado cuando se supera el límite.
+ * Per-directory LRU cache of indexes: keeps driver memory bounded by dropping the
+ * least-recently-used directory once the limit is exceeded.
+ */
+export declare class IndexCache {
+    private readonly _limit;
+    private readonly _cache;
+    /** @param _limit - Directorios indexados simultáneamente / Simultaneously indexed directories */
+    constructor(_limit?: number);
+    /**
+     * Índice ya cargado del directorio, marcándolo como recién usado.
+     * Already loaded index for the directory, marking it as recently used.
+     */
+    get(key: string): SortedIndex | undefined;
+    /**
+     * Registra el índice del directorio, descartando el menos usado si se supera el límite.
+     * Registers the directory index, dropping the least used one when over the limit.
+     */
+    set(key: string, index: SortedIndex): void;
+    /**
+     * Descarta el índice del directorio y de todo su sub-árbol.
+     * Drops the directory index and its whole subtree.
+     */
+    drop(key: string): void;
+    /** Vacía la caché completa. / Clears the whole cache. */
+    clear(): void;
+}
+/**
+ * Normaliza un path colapsando slashes redundantes y recortando los extremos.
+ * Normalizes a path collapsing redundant slashes and trimming both ends.
+ *
+ * @param path - Ruta cruda / Raw path
+ * @returns Ruta normalizada / Normalized path
+ */
+export declare function normalize_path(path: string): string;
+/**
+ * Separa una ruta normalizada en directorio padre y nombre del hijo.
+ * Splits a normalized path into parent directory and child name.
+ *
+ * @param path - Ruta a separar / Path to split
+ * @returns `{ parent, name }` / `{ parent, name }`
+ */
+export declare function split_path(path: string): {
+    parent: string;
+    name: string;
+};