@arcaelas/whatsapp 4.5.0 → 5.1.0

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

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * @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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexCache = exports.SortedIndex = void 0;
+exports.normalize_path = normalize_path;
+exports.split_path = split_path;
+/**
+ * @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.
+ */
+class SortedIndex {
+    /**
+     * @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, _delay = 1_000) {
+        this._flush = _flush;
+        this._delay = _delay;
+        /** @internal Nombres ordenados por score DESC. / Names ordered by score DESC. */
+        this._order = [];
+        /** @internal Score vigente de cada nombre. / Current score per name. */
+        this._scores = new Map();
+        this._dirty = false;
+        this._timer = null;
+    }
+    /** Cantidad de hijos indexados. / Indexed children count. */
+    get size() {
+        return this._order.length;
+    }
+    /** Pares `[nombre, score]` en orden DESC. / `[name, score]` pairs in DESC order. */
+    get entries() {
+        return this._order.map((name) => [name, this._scores.get(name) ?? 0]);
+    }
+    /**
+     * 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) {
+        const pairs = [...entries].sort((a, b) => b[1] - a[1]);
+        this._order = pairs.map(([name]) => name);
+        this._scores = new Map(pairs);
+    }
+    /** Página de nombres en orden DESC, sin re-ordenar. / Page of names in DESC order, no re-sorting. */
+    page(offset, limit) {
+        return this._order.slice(offset, offset + limit);
+    }
+    /**
+     * Inserta o reubica un hijo con su score, manteniendo el orden.
+     * Inserts or relocates a child with its score, keeping the order.
+     */
+    set(name, score) {
+        this._detach(name);
+        this._order.splice(this._locate(score), 0, name);
+        this._scores.set(name, score);
+        this._schedule();
+    }
+    /**
+     * Quita un hijo del índice.
+     * Removes a child from the index.
+     */
+    delete(name) {
+        if (this._scores.has(name)) {
+            this._detach(name);
+            this._schedule();
+        }
+    }
+    /**
+     * 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() {
+        if (this._timer) {
+            clearTimeout(this._timer);
+            this._timer = null;
+        }
+    }
+    /** @internal Saca el nombre de la lista ordenada si estaba presente. / Detaches the name from the ordered list when present. */
+    _detach(name) {
+        const previous = this._scores.get(name);
+        if (previous !== undefined) {
+            let position = this._locate(previous);
+            while (position < this._order.length && this._order[position] !== name) {
+                position++;
+            }
+            if (position < this._order.length) {
+                this._order.splice(position, 1);
+            }
+            this._scores.delete(name);
+        }
+    }
+    /** @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). */
+    _locate(score) {
+        let low = 0;
+        let high = this._order.length;
+        while (low < high) {
+            const middle = (low + high) >> 1;
+            if ((this._scores.get(this._order[middle]) ?? 0) > score) {
+                low = middle + 1;
+            }
+            else {
+                high = middle;
+            }
+        }
+        return low;
+    }
+    /** @internal Programa la persistencia diferida. / Schedules the deferred persistence. */
+    _schedule() {
+        this._dirty = true;
+        if (!this._timer) {
+            this._timer = setTimeout(() => {
+                this._timer = null;
+                if (this._dirty) {
+                    this._dirty = false;
+                    void this._flush(this.entries).catch(() => { });
+                }
+            }, this._delay);
+            this._timer.unref?.();
+        }
+    }
+}
+exports.SortedIndex = SortedIndex;
+/**
+ * @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.
+ */
+class IndexCache {
+    /** @param _limit - Directorios indexados simultáneamente / Simultaneously indexed directories */
+    constructor(_limit = 12) {
+        this._limit = _limit;
+        this._cache = new Map();
+    }
+    /**
+     * Índice ya cargado del directorio, marcándolo como recién usado.
+     * Already loaded index for the directory, marking it as recently used.
+     */
+    get(key) {
+        const index = this._cache.get(key);
+        if (index) {
+            this._cache.delete(key);
+            this._cache.set(key, index);
+        }
+        return index;
+    }
+    /**
+     * 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, index) {
+        this._cache.set(key, index);
+        while (this._cache.size > this._limit) {
+            const oldest = this._cache.keys().next().value;
+            this._cache.get(oldest)?.dispose();
+            this._cache.delete(oldest);
+        }
+    }
+    /**
+     * Descarta el índice del directorio y de todo su sub-árbol.
+     * Drops the directory index and its whole subtree.
+     */
+    drop(key) {
+        for (const cached of [...this._cache.keys()]) {
+            if (cached === key || cached.startsWith(`${key}/`)) {
+                this._cache.get(cached)?.dispose();
+                this._cache.delete(cached);
+            }
+        }
+    }
+    /** Vacía la caché completa. / Clears the whole cache. */
+    clear() {
+        for (const index of this._cache.values()) {
+            index.dispose();
+        }
+        this._cache.clear();
+    }
+}
+exports.IndexCache = IndexCache;
+/**
+ * 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
+ */
+function normalize_path(path) {
+    return path.replace(/\/+/g, '/').replace(/^\/|\/$/g, '');
+}
+/**
+ * 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 }`
+ */
+function split_path(path) {
+    const full = normalize_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/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/lib/store/engine/lib/index.ts"],"names":[],"mappings":"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"}

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

@@ -5,8 +5,10 @@
  */
 import type { Engine } from '../../../../../lib/store/engine';
 /**
- * Interface mínima del cliente Redis (compatible con ioredis).
- * Minimal Redis client interface (ioredis-compatible).
+ * Interface mínima del cliente Redis (compatible con ioredis). `pipeline` es opcional:
+ * cuando existe, las escrituras que tocan documento e índice viajan en un solo round-trip.
+ * Minimal Redis client interface (ioredis-compatible). `pipeline` is optional: when present,
+ * writes touching document and index travel in a single round-trip.
  */
 export interface RedisClient {
     get(key: string): Promise<string | null>;
@@ -18,15 +20,28 @@ export interface RedisClient {
     zrem(key: string, members: string | string[]): Promise<unknown>;
     zrevrange(key: string, start: number, stop: number): Promise<string[]>;
     zcard(key: string): Promise<number>;
+    pipeline?(): {
+        set(key: string, value: string): unknown;
+        del(keys: string | string[]): unknown;
+        zadd(key: string, score: number, member: string): unknown;
+        zrem(key: string, members: string | string[]): unknown;
+        exec(): Promise<unknown>;
+    };
 }
 /**
  * Driver de persistencia con Redis.
  *
  * Keyspaces:
  * - `<prefix>:doc:<path>` → string del documento.
- * - `<prefix>:idx:<parent>` → sorted set (score=mtime, member=path completo).
+ * - `<prefix>:idx:<parent>` → sorted set (score explícito o de escritura, member=path completo).
  *
- * `list` combina ZREVRANGE + MGET → O(log N + M) en una sola round-trip.
+ * El índice ordenado vive en Redis: `list` combina ZREVRANGE + MGET (dos round-trips, O(log N + M))
+ * y `count` es un ZCARD O(1); las escrituras agrupan documento e índice en un pipeline para que
+ * no queden documentos huérfanos del índice si el proceso muere entre ambas operaciones.
+ *
+ * Redis persistence driver. The sorted index lives in Redis: `list` combines ZREVRANGE + MGET
+ * and `count` is an O(1) ZCARD; writes group document and index in a pipeline so no document
+ * is left orphaned from the index when the process dies between both operations.
  *
  * @example
  * import IORedis from 'ioredis';
@@ -40,26 +55,26 @@ export declare class RedisEngine implements Engine {
     private _doc_key;
     /** @internal */
     private _idx_key;
-    /** @internal */
-    private _split;
     /**
      * Lee el valor de un documento.
      * Reads a document's value.
      */
     get(path: string): Promise<string | null>;
     /**
-     * Escribe el valor y actualiza el índice del padre con el timestamp actual.
-     * Writes the value and updates the parent's index with current timestamp.
+     * Escribe el valor y su entrada de índice en una sola operación; `score` fija el orden
+     * de `list` (por defecto, la hora de escritura).
+     * Writes the value and its index entry in a single operation; `score` drives `list`
+     * ordering (write time by default).
      */
-    set(path: string, value: string): Promise<void>;
+    set(path: string, value: string, score?: number): Promise<void>;
     /**
-     * Elimina el doc, su índice y todo el sub-árbol.
-     * Deletes the doc, its index, and the entire subtree.
+     * Elimina el doc, su entrada de índice y todo el sub-árbol.
+     * Deletes the doc, its index entry, and the entire subtree.
      */
     unset(path: string): Promise<boolean>;
     /**
-     * Lista valores de los hijos directos, ordenados por mtime DESC en una round-trip.
-     * Lists direct children values ordered by mtime DESC in a single round-trip.
+     * Lista valores de los hijos directos, ordenados por score DESC en dos round-trips.
+     * Lists direct children values ordered by score DESC in two round-trips.
      */
     list(path: string, offset?: number, limit?: number): Promise<string[]>;
     /**

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

@@ -6,21 +6,21 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RedisEngine = void 0;
-/**
- * Normaliza un path colapsando slashes redundantes.
- * Normalizes a path by collapsing redundant slashes.
- */
-function normalize_path(path) {
-    return path.replace(/\/+/g, '/').replace(/^\/|\/$/g, '');
-}
+const lib_1 = require("../../../../../lib/store/engine/lib");
 /**
  * Driver de persistencia con Redis.
  *
  * Keyspaces:
  * - `<prefix>:doc:<path>` → string del documento.
- * - `<prefix>:idx:<parent>` → sorted set (score=mtime, member=path completo).
+ * - `<prefix>:idx:<parent>` → sorted set (score explícito o de escritura, member=path completo).
  *
- * `list` combina ZREVRANGE + MGET → O(log N + M) en una sola round-trip.
+ * El índice ordenado vive en Redis: `list` combina ZREVRANGE + MGET (dos round-trips, O(log N + M))
+ * y `count` es un ZCARD O(1); las escrituras agrupan documento e índice en un pipeline para que
+ * no queden documentos huérfanos del índice si el proceso muere entre ambas operaciones.
+ *
+ * Redis persistence driver. The sorted index lives in Redis: `list` combines ZREVRANGE + MGET
+ * and `count` is an O(1) ZCARD; writes group document and index in a pipeline so no document
+ * is left orphaned from the index when the process dies between both operations.
  *
  * @example
  * import IORedis from 'ioredis';
@@ -33,20 +33,11 @@ class RedisEngine {
     }
     /** @internal */
     _doc_key(path) {
-        return `${this._prefix}:doc:${normalize_path(path)}`;
+        return `${this._prefix}:doc:${(0, lib_1.normalize_path)(path)}`;
     }
     /** @internal */
     _idx_key(parent) {
-        return `${this._prefix}:idx:${normalize_path(parent)}`;
-    }
-    /** @internal */
-    _split(path) {
-        const full = normalize_path(path);
-        const i = full.lastIndexOf('/');
-        if (i === -1) {
-            return { parent: '', full };
-        }
-        return { parent: full.slice(0, i), full };
+        return `${this._prefix}:idx:${(0, lib_1.normalize_path)(parent)}`;
     }
     /**
      * Lee el valor de un documento.
@@ -56,38 +47,62 @@ class RedisEngine {
         return this._client.get(this._doc_key(path));
     }
     /**
-     * Escribe el valor y actualiza el índice del padre con el timestamp actual.
-     * Writes the value and updates the parent's index with current timestamp.
+     * Escribe el valor y su entrada de índice en una sola operación; `score` fija el orden
+     * de `list` (por defecto, la hora de escritura).
+     * Writes the value and its index entry in a single operation; `score` drives `list`
+     * ordering (write time by default).
      */
-    async set(path, value) {
-        const { parent, full } = this._split(path);
-        await this._client.set(this._doc_key(full), value);
-        await this._client.zadd(this._idx_key(parent), Date.now(), full);
+    async set(path, value, score) {
+        const { parent } = (0, lib_1.split_path)(path);
+        const full = (0, lib_1.normalize_path)(path);
+        const doc_key = this._doc_key(full);
+        const idx_key = this._idx_key(parent);
+        const rank = score ?? Date.now();
+        const pipeline = this._client.pipeline?.();
+        if (pipeline) {
+            pipeline.set(doc_key, value);
+            pipeline.zadd(idx_key, rank, full);
+            await pipeline.exec();
+        }
+        else {
+            await this._client.set(doc_key, value);
+            await this._client.zadd(idx_key, rank, full);
+        }
     }
     /**
-     * Elimina el doc, su índice y todo el sub-árbol.
-     * Deletes the doc, its index, and the entire subtree.
+     * Elimina el doc, su entrada de índice y todo el sub-árbol.
+     * Deletes the doc, its index entry, and the entire subtree.
      */
     async unset(path) {
-        const { parent, full } = this._split(path);
-        await this._client.del(this._doc_key(full));
-        await this._client.zrem(this._idx_key(parent), full);
-        await this._delete_pattern(`${this._prefix}:doc:${full}/*`);
-        await this._delete_pattern(`${this._prefix}:idx:${full}`);
-        await this._delete_pattern(`${this._prefix}:idx:${full}/*`);
+        const { parent } = (0, lib_1.split_path)(path);
+        const full = (0, lib_1.normalize_path)(path);
+        const pipeline = this._client.pipeline?.();
+        if (pipeline) {
+            pipeline.del(this._doc_key(full));
+            pipeline.zrem(this._idx_key(parent), full);
+            await pipeline.exec();
+        }
+        else {
+            await this._client.del(this._doc_key(full));
+            await this._client.zrem(this._idx_key(parent), full);
+        }
+        await Promise.all([
+            this._delete_pattern(`${this._prefix}:doc:${full}/*`),
+            this._delete_pattern(`${this._prefix}:idx:${full}`),
+            this._delete_pattern(`${this._prefix}:idx:${full}/*`),
+        ]);
         return true;
     }
     /**
-     * Lista valores de los hijos directos, ordenados por mtime DESC en una round-trip.
-     * Lists direct children values ordered by mtime DESC in a single round-trip.
+     * Lista valores de los hijos directos, ordenados por score DESC en dos round-trips.
+     * Lists direct children values ordered by score DESC in two round-trips.
      */
     async list(path, offset = 0, limit = 50) {
-        const { full } = this._split(path);
-        const members = await this._client.zrevrange(this._idx_key(full), offset, offset + limit - 1);
+        const members = await this._client.zrevrange(this._idx_key(path), offset, offset + limit - 1);
         if (members.length === 0) {
             return [];
         }
-        const raws = await this._client.mget(members.map((m) => this._doc_key(m)));
+        const raws = await this._client.mget(members.map((member) => this._doc_key(member)));
         return raws.filter((raw) => raw !== null);
     }
     /**
@@ -95,8 +110,7 @@ class RedisEngine {
      * Counts direct children in O(1) via ZCARD.
      */
     async count(path) {
-        const { full } = this._split(path);
-        return this._client.zcard(this._idx_key(full));
+        return this._client.zcard(this._idx_key(path));
     }
     /**
      * Vacía todo el prefix del cliente.
@@ -114,7 +128,7 @@ class RedisEngine {
     async _delete_pattern(pattern) {
         let cursor = '0';
         do {
-            const [next, batch] = await this._client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+            const [next, batch] = await this._client.scan(cursor, 'MATCH', pattern, 'COUNT', 500);
             cursor = next;
             if (batch.length > 0) {
                 await this._client.del(batch);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/lib/store/engine/lib/redis/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/lib/store/engine/lib/redis/index.ts"],"names":[],"mappings":"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"}

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

@@ -33,7 +33,26 @@ interface S3EngineOptions {
      * Default: `false` (no cache).
      */
     cache?: false | CacheOptions;
+    /** Prefijos indexados simultáneamente en memoria. / Simultaneously in-memory indexed prefixes. */
+    cached?: number;
 }
+/**
+ * Driver de persistencia con AWS S3.
+ *
+ * Para que `list`/`count` no recorran todo el prefijo en cada página mantiene un índice
+ * ordenado por prefijo (`SortedIndex`), acotado por LRU y respaldado en el objeto `.order`:
+ * ahí viven los scores explícitos que S3 no puede representar (`LastModified` es de sólo
+ * lectura), de modo que el orden cronológico sobrevive a los re-syncs igual que en los
+ * demás drivers. Si el objeto `.order` falta, el índice se reconstruye listando el prefijo
+ * una única vez y ordenando por `LastModified`.
+ *
+ * AWS S3 persistence driver. To keep `list`/`count` from walking the whole prefix on every
+ * page it maintains a per-prefix sorted index (`SortedIndex`), LRU-bounded and backed by the
+ * `.order` object: it holds the explicit scores S3 cannot represent (`LastModified` is
+ * read-only), so chronological order survives re-syncs just like on the other drivers. When
+ * `.order` is missing the index is rebuilt listing the prefix once and ordering by
+ * `LastModified`.
+ */
 export declare class S3Engine implements Engine {
     private readonly _client;
     private readonly _bucket;
@@ -41,6 +60,8 @@ export declare class S3Engine implements Engine {
     private readonly _cache_opts;
     /** @internal Caché local de documentos, con su timer de expiración. / Local cache of documents, with its expiration timer. */
     private readonly _cache;
+    /** @internal Índices por prefijo, acotados por LRU. / Per-prefix indexes, LRU-bounded. */
+    private readonly _indexes;
     constructor(options: S3EngineOptions);
     private _key;
     /**
@@ -55,11 +76,33 @@ export declare class S3Engine implements Engine {
      * Replaces the previous timer when the key was already cached so timers don't pile up.
      */
     private _cache_set;
+    /**
+     * @internal
+     * Índice del prefijo: de la caché, del objeto `.order` o reconstruido listando el prefijo
+     * una sola vez y ordenando por `LastModified`.
+     * Prefix index: from the cache, from the `.order` object or rebuilt listing the prefix
+     * once and ordering by `LastModified`.
+     */
+    private _index;
     get(key: string): Promise<string | null>;
-    set(key: string, value: string): Promise<void>;
+    /**
+     * Escribe el valor y registra su score en el índice del prefijo, que S3 no puede
+     * derivar por sí solo (`LastModified` es de sólo lectura).
+     * Writes the value and records its score in the prefix index, which S3 cannot derive
+     * on its own (`LastModified` is read-only).
+     */
+    set(key: string, value: string, score?: number): Promise<void>;
+    /**
+     * 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[]>;
     delete_prefix(prefix: string): Promise<number>;
     unset(path: string): Promise<boolean>;
+    /**
+     * Cuenta hijos directos desde el índice del prefijo.
+     * Counts direct children from the prefix index.
+     */
     count(path: string): Promise<number>;
     clear(): Promise<void>;
 }