@arcaelas/whatsapp 4.4.0 → 5.1.0

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

@@ -4,13 +4,26 @@
  * AWS S3 persistence driver (optional local cache).
  */
 import { DeleteObjectsCommand, GetObjectCommand, ListObjectsV2Command, PutObjectCommand } from '@aws-sdk/client-s3';
+import { IndexCache, normalize_path, SortedIndex, split_path } from '../../../../../lib/store/engine/lib/index.js';
+/** Objeto que guarda el orden de los hijos de un prefijo. / Object holding the ordering of a prefix children. */
+const ORDER_KEY = '.order';
 /**
- * Normaliza un path colapsando slashes redundantes.
- * Normalizes a path by collapsing redundant slashes.
+ * 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`.
  */
-function normalize_path(path) {
-    return path.replace(/\/+/g, '/').replace(/^\/|\/$/g, '');
-}
 export class S3Engine {
     constructor(options) {
         /** @internal Caché local de documentos, con su timer de expiración. / Local cache of documents, with its expiration timer. */
@@ -19,6 +32,7 @@ export class S3Engine {
         this._bucket = options.bucket;
         this._prefix = options.basedir.endsWith('/') ? options.basedir : `${options.basedir}/`;
         this._cache_opts = options.cache ?? false;
+        this._indexes = new IndexCache(options.cached ?? 12);
     }
     _key(key) {
         return `${this._prefix}${normalize_path(key).replace(/@/g, '_at_')}`;
@@ -46,69 +60,108 @@ export class S3Engine {
             timer: setTimeout(() => this._cache.delete(path), this._cache_opts.ttl),
         });
     }
+    /**
+     * @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`.
+     */
+    async _index(path) {
+        const key = normalize_path(path);
+        const cached = this._indexes.get(key);
+        if (cached) {
+            return cached;
+        }
+        const parent = `${this._key(key)}/`;
+        const index = new SortedIndex(async (entries) => {
+            await this._client
+                .send(new PutObjectCommand({
+                Bucket: this._bucket,
+                Key: `${parent}${ORDER_KEY}`,
+                Body: entries.map(([name, score]) => `${score}\t${name}`).join('\n'),
+                ContentType: 'text/plain',
+            }))
+                .catch(() => null);
+        });
+        const persisted = await this._client
+            .send(new GetObjectCommand({ Bucket: this._bucket, Key: `${parent}${ORDER_KEY}` }))
+            .then((res) => res.Body?.transformToString('utf-8') ?? null)
+            .catch(() => null);
+        if (persisted) {
+            index.load(persisted
+                .split('\n')
+                .filter(Boolean)
+                .map((line) => {
+                const cut = line.indexOf('\t');
+                return [line.slice(cut + 1), Number(line.slice(0, cut))];
+            }));
+        }
+        else {
+            const children = new Map();
+            let token;
+            do {
+                const res = await this._client.send(new ListObjectsV2Command({ Bucket: this._bucket, Prefix: parent, ContinuationToken: token, MaxKeys: 1000 }));
+                for (const object of res.Contents ?? []) {
+                    const rest = object.Key?.slice(parent.length);
+                    const name = rest?.split('/')[0];
+                    if (name && name !== ORDER_KEY) {
+                        children.set(name, Math.max(children.get(name) ?? 0, object.LastModified?.getTime() ?? 0));
+                    }
+                }
+                token = res.NextContinuationToken;
+            } while (token);
+            index.load(children);
+        }
+        this._indexes.set(key, index);
+        return index;
+    }
     async get(key) {
         if (this._cacheable(key) && this._cache.has(key)) {
             return this._cache.get(key).value;
         }
-        const value = await (async () => {
-            try {
-                const res = await this._client.send(new GetObjectCommand({ Bucket: this._bucket, Key: this._key(key) }));
-                return (await res.Body?.transformToString('utf-8')) ?? null;
-            }
-            catch {
-                return null;
-            }
-        })();
+        const value = await this._client
+            .send(new GetObjectCommand({ Bucket: this._bucket, Key: this._key(key) }))
+            .then((res) => res.Body?.transformToString('utf-8') ?? null)
+            .catch(() => null);
         if (this._cacheable(key)) {
             this._cache_set(key, value);
         }
         return value;
     }
-    async set(key, value) {
+    /**
+     * 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).
+     */
+    async set(key, value, score) {
         const remote = this._client.send(new PutObjectCommand({ Bucket: this._bucket, Key: this._key(key), Body: value, ContentType: 'application/json' }));
         if (this._cacheable(key)) {
             this._cache_set(key, value);
         }
+        const { parent, name } = split_path(key);
+        // A diferencia del filesystem, S3 no tiene dónde guardar el score fuera del índice
+        // (`LastModified` es de sólo lectura), así que el índice se carga aunque nadie haya
+        // paginado todavía; si no, el orden cronológico se perdería en la primera escritura.
+        // Unlike the filesystem, S3 has nowhere to keep the score outside the index
+        // (`LastModified` is read-only), so the index is loaded even when nobody paginated
+        // yet; otherwise chronological order would be lost on the first write.
+        (await this._index(parent)).set(name, score ?? Date.now());
         await remote;
     }
+    /**
+     * 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 parent = `${this._prefix}${normalize_path(path).replace(/@/g, '_at_')}/`;
-        const children = new Map();
-        let token;
-        do {
-            const res = await this._client.send(new ListObjectsV2Command({
-                Bucket: this._bucket,
-                Prefix: parent,
-                ContinuationToken: token,
-                MaxKeys: 1000,
-            }));
-            for (const obj of res.Contents ?? []) {
-                if (!obj.Key)
-                    continue;
-                const rest = obj.Key.slice(parent.length);
-                const child_key = `${parent}${rest.split('/')[0]}`;
-                const mtime = obj.LastModified?.getTime() ?? 0;
-                children.set(child_key, Math.max(children.get(child_key) ?? 0, mtime));
-            }
-            token = res.NextContinuationToken;
-        } while (token);
-        const ordered = [...children.entries()]
-            .sort((a, b) => b[1] - a[1])
-            .slice(offset, offset + limit)
-            .map(([key]) => key);
-        const values = await Promise.all(ordered.map(async (key) => {
-            try {
-                const res = await this._client.send(new GetObjectCommand({ Bucket: this._bucket, Key: key }));
-                return (await res.Body?.transformToString('utf-8')) ?? null;
-            }
-            catch {
-                return null;
-            }
-        }));
+        const parent = normalize_path(path);
+        const page = (await this._index(parent)).page(offset, limit);
+        const values = await Promise.all(page.map((name) => this.get(`${parent}/${name}`)));
         return values.filter((value) => value !== null);
     }
     async delete_prefix(prefix) {
-        const full_prefix = `${this._prefix}${normalize_path(prefix).replace(/@/g, '_at_')}`;
+        const full_prefix = this._key(prefix);
         let deleted = 0;
         let token;
         do {
@@ -136,29 +189,24 @@ export class S3Engine {
                 }
             }
         }
+        const { parent, name } = split_path(path);
+        (await this._index(parent)).delete(name);
+        this._indexes.drop(normalize_path(path));
         return (await this.delete_prefix(path)) > 0;
     }
+    /**
+     * Cuenta hijos directos desde el índice del prefijo.
+     * Counts direct children from the prefix index.
+     */
     async count(path) {
-        const full_prefix = `${this._prefix}${normalize_path(path).replace(/@/g, '_at_')}`;
-        let total = 0;
-        let token;
-        do {
-            const res = await this._client.send(new ListObjectsV2Command({
-                Bucket: this._bucket,
-                Prefix: full_prefix,
-                ContinuationToken: token,
-                MaxKeys: 1000,
-            }));
-            total += res.Contents?.length ?? 0;
-            token = res.NextContinuationToken;
-        } while (token);
-        return total;
+        return (await this._index(path)).size;
     }
     async clear() {
         for (const { timer } of this._cache.values()) {
             clearTimeout(timer);
         }
         this._cache.clear();
+        this._indexes.clear();
         await this.delete_prefix('');
     }
 }

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

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

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

@@ -0,0 +1,98 @@
+/**
+ * @file store/engine/lib/sqlite/index.ts
+ * @description Driver de persistencia con SQLite.
+ * SQLite persistence driver.
+ */
+import type { Engine } from '../../../../../lib/store/engine/index.js';
+/**
+ * Sentencia preparada, con la forma que exponen `better-sqlite3` y `node:sqlite`.
+ * Prepared statement, shaped as `better-sqlite3` and `node:sqlite` expose it.
+ */
+interface SQLiteStatement {
+    run(...params: unknown[]): unknown;
+    get(...params: unknown[]): unknown;
+    all(...params: unknown[]): unknown[];
+}
+/**
+ * Interface mínima de la base SQLite. La cumplen `better-sqlite3` (`new Database(file)`) y
+ * el `node:sqlite` nativo (`new DatabaseSync(file)`), así que el driver no agrega ninguna
+ * dependencia: la base se inyecta ya abierta, igual que el cliente de `RedisEngine`.
+ * Minimal SQLite database interface. Both `better-sqlite3` (`new Database(file)`) and the
+ * native `node:sqlite` (`new DatabaseSync(file)`) satisfy it, so this driver adds no
+ * dependency: the database is injected already open, just like `RedisEngine`'s client.
+ */
+export interface SQLiteDatabase {
+    exec(sql: string): unknown;
+    prepare(sql: string): SQLiteStatement;
+}
+/**
+ * Driver de persistencia con SQLite: una tabla `(path, parent, score, value)` con índice
+ * `(parent, score DESC)`.
+ *
+ * Es el driver más eficiente de los integrados porque delega en el motor lo que los demás
+ * resuelven a mano: `list` es un `ORDER BY score DESC LIMIT/OFFSET` sobre el índice (sin
+ * índice en memoria ni archivo de orden), `count` un `COUNT(*)` y el `unset` en cascada una
+ * sola sentencia por rango de `path`. Medido sobre un chat real de 55.146 mensajes frente al
+ * filesystem: 220 MB → 111 MB en disco, primer `list` 115 ms → 0,7 ms y dos inodes en total.
+ *
+ * SQLite persistence driver: a single `(path, parent, score, value)` table with a
+ * `(parent, score DESC)` index. The most efficient built-in driver, since it delegates to the
+ * engine what the others hand-roll: `list` is an indexed `ORDER BY score DESC LIMIT/OFFSET`
+ * (no in-memory index, no order file), `count` a `COUNT(*)` and cascading `unset` a single
+ * range statement. Measured on a real 55,146-message chat against the filesystem: 220 MB →
+ * 111 MB on disk, first `list` 115 ms → 0.7 ms and two inodes in total.
+ *
+ * @example
+ * import Database from 'better-sqlite3';
+ * const engine = new SQLiteEngine(new Database('.sessions/584144709840.db'));
+ *
+ * @example
+ * import { DatabaseSync } from 'node:sqlite';
+ * const engine = new SQLiteEngine(new DatabaseSync('.sessions/584144709840.db'));
+ */
+export declare class SQLiteEngine implements Engine {
+    private readonly _db;
+    private readonly _read;
+    private readonly _write;
+    private readonly _remove;
+    private readonly _page;
+    private readonly _total;
+    private readonly _wipe;
+    /**
+     * @param _db - Base SQLite ya abierta / Already open SQLite database
+     * @param table - Tabla donde viven los documentos / Table holding the documents
+     */
+    constructor(_db: SQLiteDatabase, table?: string);
+    /**
+     * Lee el valor de un documento.
+     * Reads a document's value.
+     */
+    get(path: string): Promise<string | null>;
+    /**
+     * Escribe el valor del documento; `score` fija el orden de `list` (por defecto, la hora
+     * de escritura).
+     * Writes the document value; `score` drives `list` ordering (write time by default).
+     */
+    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 score DESC.
+     * Lists direct children values ordered by score DESC.
+     */
+    list(path: string, offset?: number, limit?: number): Promise<string[]>;
+    /**
+     * Cuenta los hijos directos.
+     * Counts direct children.
+     */
+    count(path: string): Promise<number>;
+    /**
+     * Vacía la tabla completa.
+     * Clears the entire table.
+     */
+    clear(): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,110 @@
+/**
+ * @file store/engine/lib/sqlite/index.ts
+ * @description Driver de persistencia con SQLite.
+ * SQLite persistence driver.
+ */
+import { normalize_path, split_path } from '../../../../../lib/store/engine/lib/index.js';
+/**
+ * Driver de persistencia con SQLite: una tabla `(path, parent, score, value)` con índice
+ * `(parent, score DESC)`.
+ *
+ * Es el driver más eficiente de los integrados porque delega en el motor lo que los demás
+ * resuelven a mano: `list` es un `ORDER BY score DESC LIMIT/OFFSET` sobre el índice (sin
+ * índice en memoria ni archivo de orden), `count` un `COUNT(*)` y el `unset` en cascada una
+ * sola sentencia por rango de `path`. Medido sobre un chat real de 55.146 mensajes frente al
+ * filesystem: 220 MB → 111 MB en disco, primer `list` 115 ms → 0,7 ms y dos inodes en total.
+ *
+ * SQLite persistence driver: a single `(path, parent, score, value)` table with a
+ * `(parent, score DESC)` index. The most efficient built-in driver, since it delegates to the
+ * engine what the others hand-roll: `list` is an indexed `ORDER BY score DESC LIMIT/OFFSET`
+ * (no in-memory index, no order file), `count` a `COUNT(*)` and cascading `unset` a single
+ * range statement. Measured on a real 55,146-message chat against the filesystem: 220 MB →
+ * 111 MB on disk, first `list` 115 ms → 0.7 ms and two inodes in total.
+ *
+ * @example
+ * import Database from 'better-sqlite3';
+ * const engine = new SQLiteEngine(new Database('.sessions/584144709840.db'));
+ *
+ * @example
+ * import { DatabaseSync } from 'node:sqlite';
+ * const engine = new SQLiteEngine(new DatabaseSync('.sessions/584144709840.db'));
+ */
+export class SQLiteEngine {
+    /**
+     * @param _db - Base SQLite ya abierta / Already open SQLite database
+     * @param table - Tabla donde viven los documentos / Table holding the documents
+     */
+    constructor(_db, table = 'documents') {
+        this._db = _db;
+        // WAL y synchronous NORMAL multiplican el rendimiento de escritura; se aplican con
+        // tolerancia porque un driver puede exponerlos como no-op o rechazarlos en :memory:.
+        // WAL and synchronous NORMAL greatly speed up writes; applied leniently since a driver
+        // may expose them as no-ops or reject them on :memory:.
+        try {
+            _db.exec('PRAGMA journal_mode = WAL; PRAGMA synchronous = NORMAL;');
+        }
+        catch {
+            /* optional tuning */
+        }
+        _db.exec(`CREATE TABLE IF NOT EXISTS ${table} (path TEXT PRIMARY KEY, parent TEXT NOT NULL, score INTEGER NOT NULL, value TEXT NOT NULL);
+       CREATE INDEX IF NOT EXISTS ${table}_order ON ${table} (parent, score DESC);`);
+        this._read = _db.prepare(`SELECT value FROM ${table} WHERE path = ?`);
+        this._write = _db.prepare(`INSERT INTO ${table} (path, parent, score, value) VALUES (?, ?, ?, ?)
+       ON CONFLICT(path) DO UPDATE SET value = excluded.value, score = excluded.score`);
+        // El sub-árbol se borra por rango en vez de con LIKE: '0' es el carácter siguiente a '/',
+        // así el rango cubre exactamente los descendientes y se resuelve con el índice de `path`.
+        // The subtree is deleted by range instead of LIKE: '0' is the character right after '/',
+        // so the range covers exactly the descendants and is served by the `path` index.
+        this._remove = _db.prepare(`DELETE FROM ${table} WHERE path = ? OR (path >= ? AND path < ?)`);
+        this._page = _db.prepare(`SELECT value FROM ${table} WHERE parent = ? ORDER BY score DESC LIMIT ? OFFSET ?`);
+        this._total = _db.prepare(`SELECT COUNT(*) AS total FROM ${table} WHERE parent = ?`);
+        this._wipe = _db.prepare(`DELETE FROM ${table}`);
+    }
+    /**
+     * Lee el valor de un documento.
+     * Reads a document's value.
+     */
+    async get(path) {
+        return this._read.get(normalize_path(path))?.value ?? null;
+    }
+    /**
+     * Escribe el valor del documento; `score` fija el orden de `list` (por defecto, la hora
+     * de escritura).
+     * Writes the document value; `score` drives `list` ordering (write time by default).
+     */
+    async set(path, value, score) {
+        const { parent } = split_path(path);
+        this._write.run(normalize_path(path), parent, score ?? Date.now(), value);
+    }
+    /**
+     * Elimina el documento y todos sus descendientes. Idempotente.
+     * Deletes the document and every descendant. Idempotent.
+     */
+    async unset(path) {
+        const full = normalize_path(path);
+        this._remove.run(full, `${full}/`, `${full}0`);
+        return true;
+    }
+    /**
+     * 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) {
+        return this._page.all(normalize_path(path), limit, offset).map((row) => row.value);
+    }
+    /**
+     * Cuenta los hijos directos.
+     * Counts direct children.
+     */
+    async count(path) {
+        return Number(this._total.get(normalize_path(path)).total);
+    }
+    /**
+     * Vacía la tabla completa.
+     * Clears the entire table.
+     */
+    async clear() {
+        this._wipe.run();
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -3,7 +3,7 @@
  * @description Barrel del módulo store — reexporta Engine + drivers y expone helpers de serialización.
  * Store module barrel — re-exports Engine + drivers and provides serialization helpers.
  */
-export { FileSystemEngine, RedisEngine, S3Engine, type Engine, type RedisClient } from '../../lib/store/engine/index.js';
+export { FileSystemEngine, RedisEngine, S3Engine, SQLiteEngine, type Engine, type RedisClient, type SQLiteDatabase } from '../../lib/store/engine/index.js';
 /**
  * Serializa un documento a string preservando Buffers con BufferJSON de baileys.
  * Serializes a document to string preserving Buffers via baileys BufferJSON.
@@ -13,8 +13,12 @@ export { FileSystemEngine, RedisEngine, S3Engine, type Engine, type RedisClient
  */
 export declare function serialize<T>(doc: T): string;
 /**
- * Deserializa un string JSON a documento aplicando BufferJSON. Retorna null si la entrada es null.
- * Deserializes a JSON string to document using BufferJSON. Returns null if input is null.
+ * Deserializa un string JSON a documento aplicando BufferJSON. Retorna null si la entrada es
+ * null o no es JSON válido: un documento corrupto (escritura interrumpida, truncado) se
+ * comporta como inexistente en vez de propagar el parse error a toda la página.
+ * Deserializes a JSON string to document using BufferJSON. Returns null when the input is
+ * null or invalid JSON: a corrupt document (interrupted write, truncation) behaves as
+ * missing instead of poisoning the whole page with a parse error.
  *
  * @param raw - String JSON o null / JSON string or null
  * @returns Documento parseado o null / Parsed document or null

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

@@ -4,7 +4,7 @@
  * Store module barrel — re-exports Engine + drivers and provides serialization helpers.
  */
 import { BufferJSON } from 'baileys';
-export { FileSystemEngine, RedisEngine, S3Engine } from '../../lib/store/engine/index.js';
+export { FileSystemEngine, RedisEngine, S3Engine, SQLiteEngine } from '../../lib/store/engine/index.js';
 /**
  * Serializa un documento a string preservando Buffers con BufferJSON de baileys.
  * Serializes a document to string preserving Buffers via baileys BufferJSON.
@@ -16,8 +16,12 @@ export function serialize(doc) {
     return JSON.stringify(doc, BufferJSON.replacer);
 }
 /**
- * Deserializa un string JSON a documento aplicando BufferJSON. Retorna null si la entrada es null.
- * Deserializes a JSON string to document using BufferJSON. Returns null if input is null.
+ * Deserializa un string JSON a documento aplicando BufferJSON. Retorna null si la entrada es
+ * null o no es JSON válido: un documento corrupto (escritura interrumpida, truncado) se
+ * comporta como inexistente en vez de propagar el parse error a toda la página.
+ * Deserializes a JSON string to document using BufferJSON. Returns null when the input is
+ * null or invalid JSON: a corrupt document (interrupted write, truncation) behaves as
+ * missing instead of poisoning the whole page with a parse error.
  *
  * @param raw - String JSON o null / JSON string or null
  * @returns Documento parseado o null / Parsed document or null
@@ -26,6 +30,11 @@ export function deserialize(raw) {
     if (raw === null) {
         return null;
     }
-    return JSON.parse(raw, BufferJSON.reviver);
+    try {
+        return JSON.parse(raw, BufferJSON.reviver);
+    }
+    catch {
+        return null;
+    }
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/store/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAiC,MAAM,oBAAoB,CAAC;AAE5G;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAI,GAAM;IACjC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAI,GAAkB;IAC/C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,CAAM,CAAC;AAClD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/store/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAsD,MAAM,oBAAoB,CAAC;AAE/I;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAI,GAAM;IACjC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAI,GAAkB;IAC/C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,CAAM,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}