@arcaelas/whatsapp 4.4.0 → 5.1.0

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

@@ -1,9 +1,11 @@
 /**
  * @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.
  */
 export { FileSystemEngine } from '../../../lib/store/engine/lib/file_system/index.js';
 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/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/store/engine/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAoB,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/store/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+CH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAoB,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAuB,MAAM,+BAA+B,CAAC"}

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

@@ -7,10 +7,22 @@ import type { Engine } from '../../../../../lib/store/engine/index.js';
 /**
  * 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/index.js';
  */
 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/esm/lib/store/engine/lib/file_system/index.js

@@ -3,31 +3,45 @@
  * @description Driver de persistencia en sistema de archivos local.
  * Local filesystem persistence driver.
  */
-import { mkdir, readdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { randomBytes } from 'node:crypto';
+import { mkdir, readdir, readFile, rename, rm, stat, utimes, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { IndexCache, normalize_path, SortedIndex, split_path } from '../../../../../lib/store/engine/lib/index.js';
 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' }));
  */
 export 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 IndexCache(cached);
     }
     /** @internal */
     _dir(path) {
@@ -37,6 +51,50 @@ export class FileSystemEngine {
     _file(path) {
         return 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 = normalize_path(path);
+        const cached = this._indexes.get(key);
+        if (cached) {
+            return cached;
+        }
+        const dir = join(this._base, key);
+        const index = new SortedIndex(async (entries) => {
+            await this._write(join(dir, ORDER_FILE), entries.map(([name, score]) => `${score}\t${name}`).join('\n')).catch(() => { });
+        });
+        const children = (await readdir(dir, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory());
+        const persisted = (await readFile(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 stat(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}.${randomBytes(6).toString('hex')}.tmp`;
+        await writeFile(tmp, value, 'utf-8');
+        await rename(tmp, file);
+    }
     /**
      * Lee el valor de un documento.
      * Reads a document's value.
@@ -50,13 +108,22 @@ export 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 mkdir(dir, { recursive: true });
-        await writeFile(join(dir, INDEX_FILE), value, 'utf-8');
+        const file = join(dir, INDEX_FILE);
+        await this._write(file, value);
+        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);
     }
     /**
      * Elimina el documento y todos sus descendientes. Idempotente.
@@ -69,70 +136,27 @@ export class FileSystemEngine {
         catch {
             /* idempotent */
         }
+        const { parent, name } = split_path(path);
+        this._indexes.get(parent)?.delete(name);
+        this._indexes.drop(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 readdir(dir, { withFileTypes: true });
-            const stats = await Promise.all(entries
-                .filter((e) => e.isDirectory())
-                .map(async (entry) => {
-                const file = join(dir, entry.name, INDEX_FILE);
-                try {
-                    const st = await 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 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) => readFile(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 readdir(dir, { withFileTypes: true });
-            let total = 0;
-            await Promise.all(entries
-                .filter((e) => e.isDirectory())
-                .map(async (entry) => {
-                try {
-                    await stat(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.
@@ -145,6 +169,7 @@ export class FileSystemEngine {
         catch {
             /* idempotent */
         }
+        this._indexes.clear();
     }
 }
 //# sourceMappingURL=index.js.map

package/build/esm/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":"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"}

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