qutedb 0.0.1

package/dist/db/engine.d.ts

@@ -0,0 +1,24 @@
+import type { Codec, Schema, WhereClause } from "./types.js";
+export declare class Engine<S extends Schema, Wire> {
+    private dbName;
+    private version;
+    private schema;
+    private codec;
+    private cache_limit;
+    private db;
+    private cache;
+    constructor(dbName: string, version: number, schema: S, codec: Codec<Wire>, cache_limit?: number);
+    open(): Promise<void>;
+    private normalizeUint8Arrays;
+    private encode;
+    private decode;
+    toStorage<K extends keyof S>(storeName: K, userData: any): any;
+    fromStorage<K extends keyof S>(storeName: K, storageData: any): any;
+    put<K extends keyof S>(storeName: K, userData: any): Promise<void>;
+    delete<K extends keyof S>(storeName: K, key: any): Promise<void>;
+    getSchema<K extends keyof S>(storeName: K): S[K];
+    getRecordsByKeys<K extends keyof S>(storeName: K, keys: IDBValidKey[]): Promise<Record<K, S>[]>;
+    getKeysByIndexes<K extends keyof S>(storeName: K, wheres: WhereClause[], orderField?: string, orderDir?: "asc" | "desc", limit?: number, offset?: number): Promise<IDBValidKey[]>;
+    close(): void;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/db/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/db/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,qBAAa,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI;IAKtC,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,WAAW;IARrB,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,KAAK,CAA6B;gBAGhC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,WAAW,GAAE,MAAa;IAK9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgD3B,OAAO,CAAC,oBAAoB;IA+B5B,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,MAAM;IAId,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,GAAG,GAAG;IAmC9D,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,GAAG,GAAG;IA0B7D,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlE,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAetE,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAI1C,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,EACtC,SAAS,EAAE,CAAC,EACZ,IAAI,EAAE,WAAW,EAAE,GAClB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAqCpB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,EACtC,SAAS,EAAE,CAAC,EACZ,MAAM,EAAE,WAAW,EAAE,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,KAAK,GAAG,MAAc,EAChC,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,SAAI,GACT,OAAO,CAAC,WAAW,EAAE,CAAC;IA6GzB,KAAK,IAAI,IAAI;CAGd"}

package/dist/db/engine.js

@@ -0,0 +1,291 @@
+import { LRUCache } from "./lru.js";
+export class Engine {
+    dbName;
+    version;
+    schema;
+    codec;
+    cache_limit;
+    db = null;
+    cache;
+    constructor(dbName, version, schema, codec, cache_limit = 1000) {
+        this.dbName = dbName;
+        this.version = version;
+        this.schema = schema;
+        this.codec = codec;
+        this.cache_limit = cache_limit;
+        this.cache = new LRUCache(this.cache_limit);
+    }
+    async open() {
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open(this.dbName, this.version);
+            request.onerror = () => reject(request.error);
+            request.onsuccess = () => {
+                this.db = request.result;
+                console.log(`%c[quteDB]: %cDatabase opened ${this.dbName} v${this.version}`, "color: lightgreen; font-weight: bold;", "font-style:italic;color:lightgrey");
+                for (const storeName of Object.keys(this.schema)) {
+                    if (!this.db.objectStoreNames.contains(storeName)) {
+                        reject(new Error(`[quteDB]: Store "${storeName}" not found`));
+                        return;
+                    }
+                }
+                resolve();
+            };
+            request.onupgradeneeded = (event) => {
+                const db = event.target.result;
+                for (const [storeName, config] of Object.entries(this.schema)) {
+                    if (!db.objectStoreNames.contains(storeName)) {
+                        const keyPath = config.pk.length === 1 ? config.pk[0] : config.pk;
+                        if (!keyPath) {
+                            throw new Error(`[quteDB]: Primary Key for the Store "${storeName}"  , Is Not defined`);
+                        }
+                        const store = db.createObjectStore(storeName, { keyPath });
+                        for (const indexField of config.index) {
+                            store.createIndex(indexField, indexField, { unique: false });
+                        }
+                    }
+                }
+            };
+        });
+    }
+    normalizeUint8Arrays(obj) {
+        if (obj === null || obj === undefined) {
+            return obj;
+        }
+        if (obj instanceof Uint8Array) {
+            return obj;
+        }
+        if (obj.constructor?.name === "Buffer" ||
+            (obj.buffer && obj.byteLength !== undefined)) {
+            return new Uint8Array(obj);
+        }
+        if (typeof obj === "object" && !Array.isArray(obj)) {
+            const normalized = {};
+            for (const key in obj) {
+                normalized[key] = this.normalizeUint8Arrays(obj[key]);
+            }
+            return normalized;
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.normalizeUint8Arrays(item));
+        }
+        return obj;
+    }
+    encode(v) {
+        return this.codec.encode(v);
+    }
+    decode(w) {
+        return this.codec.decode(w);
+    }
+    toStorage(storeName, userData) {
+        try {
+            const config = this.schema[storeName];
+            if (!config) {
+                throw new Error("[quteDB]: The Store Schema is Not Defined/Corrupted");
+            }
+            const indexedFields = [...new Set([...config.pk, ...config.index])];
+            const indexed = {};
+            const dataObj = {};
+            // Iterate over actual userData fields, not schema
+            for (const field in userData) {
+                if (indexedFields.includes(field)) {
+                    // Indexed field - store directly
+                    indexed[field] = userData[field];
+                }
+                else {
+                    // Non-indexed field - goes into data blob
+                    dataObj[field] = userData[field];
+                }
+            }
+            // console.log("dataObj:", dataObj); // Should have data now
+            const encoded = this.encode(dataObj);
+            return {
+                ...indexed,
+                data: encoded,
+            };
+        }
+        catch (e) {
+            throw new Error(`[quteDB]: toStorage Error : ${e}`);
+        }
+    }
+    fromStorage(storeName, storageData) {
+        try {
+            const config = this.schema[storeName];
+            if (!config) {
+                throw new Error("[quteDB]: The Store Schema is Not Defined/Corrupted");
+            }
+            const indexedFields = [...new Set([...config.pk, ...config.index])];
+            const indexed = {};
+            // Extract indexed fields
+            for (const field of indexedFields) {
+                indexed[field] = storageData[field];
+            }
+            // Decode data blob
+            const decoded = this.decode(storageData.data);
+            const normalized = this.normalizeUint8Arrays(decoded);
+            return { ...indexed, ...normalized };
+        }
+        catch (e) {
+            throw new Error(`[quteDB]: fromStorage Error : ${e}`);
+        }
+    }
+    async put(storeName, userData) {
+        if (!this.db)
+            throw new Error("[quteDB]: Database not opened");
+        const storageData = this.toStorage(storeName, userData);
+        // console.log("Storagedata : ", storageData, "\nusdata :  ", userData);
+        return new Promise((resolve, reject) => {
+            const tx = this.db.transaction(storeName, "readwrite");
+            const store = tx.objectStore(storeName);
+            const request = store.put(storageData);
+            request.onsuccess = () => resolve();
+            request.onerror = () => reject(request.error);
+        });
+    }
+    async delete(storeName, key) {
+        if (!this.db)
+            throw new Error("[quteDB]: Database not opened");
+        return new Promise((resolve, reject) => {
+            const tx = this.db.transaction(storeName, "readwrite");
+            const store = tx.objectStore(storeName);
+            const request = store.delete(key);
+            request.onsuccess = () => {
+                resolve();
+            };
+            request.onerror = () => reject(request.error);
+        });
+    }
+    getSchema(storeName) {
+        return this.schema[storeName];
+    }
+    async getRecordsByKeys(storeName, keys) {
+        const results = new Map();
+        const misses = [];
+        for (const k of keys) {
+            const v = this.cache.get(k);
+            if (v !== undefined)
+                results.set(k, v);
+            else
+                misses.push(k);
+        }
+        if (misses.length) {
+            const tx = this.db.transaction(storeName, "readonly");
+            const store = tx.objectStore(storeName);
+            await Promise.all(misses.map((k) => new Promise((resolve, reject) => {
+                const r = store.get(k);
+                r.onsuccess = () => {
+                    if (r.result !== undefined) {
+                        let res = this.fromStorage(storeName, r.result);
+                        this.cache.set(k, res);
+                        results.set(k, res);
+                    }
+                    resolve();
+                };
+                r.onerror = () => reject(r.error);
+            })));
+        }
+        return keys.map((k) => results.get(k)).filter(Boolean);
+    }
+    async getKeysByIndexes(storeName, wheres, orderField, orderDir = "asc", limit, offset = 0) {
+        if (!this.db)
+            throw new Error("[quteDB]: DB not opened");
+        const tx = this.db.transaction(storeName, "readonly");
+        const store = tx.objectStore(storeName);
+        const direction = orderDir === "desc" ? "prev" : "next";
+        // ─────────────────────────────────────────────
+        // 1. Decide ordering source (PK or index)
+        // ─────────────────────────────────────────────
+        let orderingSource = store;
+        if (orderField) {
+            const isPK = store.keyPath === orderField;
+            const isIndex = store.indexNames.contains(orderField);
+            if (!isPK && !isIndex) {
+                throw new Error(`[quteDB]: ORDER BY field "${orderField}" is not indexed`);
+            }
+            orderingSource = isPK ? store : store.index(orderField);
+        }
+        // ─────────────────────────────────────────────
+        // 2. Build sets for non-ordering WHERE clauses
+        // ─────────────────────────────────────────────
+        const filterSets = [];
+        for (const w of wheres) {
+            // skip where that matches ordering field (handled by cursor)
+            if (w.field === orderField)
+                continue;
+            const isPK = store.keyPath === w.field;
+            const isIndex = store.indexNames.contains(w.field);
+            if (!isPK && !isIndex) {
+                throw new Error(`[quteDB]: Field ${w.field} not indexed`);
+            }
+            const source = isPK ? store : store.index(w.field);
+            const range = w.op === "=="
+                ? IDBKeyRange.only(w.value)
+                : w.op === ">"
+                    ? IDBKeyRange.lowerBound(w.value, true)
+                    : w.op === ">="
+                        ? IDBKeyRange.lowerBound(w.value)
+                        : w.op === "<"
+                            ? IDBKeyRange.upperBound(w.value, true)
+                            : IDBKeyRange.upperBound(w.value);
+            const keys = await scanKeys(source, range);
+            filterSets.push(new Set(keys));
+        }
+        // ─────────────────────────────────────────────
+        // 3. Walk ordering cursor + apply intersection
+        //    + offset + limit INSIDE cursor
+        // ─────────────────────────────────────────────
+        const results = [];
+        let skipped = 0;
+        return new Promise((resolve, reject) => {
+            const req = orderingSource.openKeyCursor(null, direction);
+            req.onsuccess = () => {
+                const cursor = req.result;
+                if (!cursor) {
+                    resolve(results);
+                    return;
+                }
+                const pk = cursor.primaryKey !== undefined ? cursor.primaryKey : cursor.key;
+                // AND semantics: must exist in all filter sets
+                for (const set of filterSets) {
+                    if (!set.has(pk)) {
+                        cursor.continue();
+                        return;
+                    }
+                }
+                // offset
+                if (skipped < offset) {
+                    skipped++;
+                    cursor.continue();
+                    return;
+                }
+                results.push(pk);
+                // limit
+                if (limit !== undefined && results.length >= limit) {
+                    resolve(results);
+                    return;
+                }
+                cursor.continue();
+            };
+            req.onerror = () => reject(req.error);
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    close() {
+        this.db?.close();
+    }
+}
+async function scanKeys(source, range) {
+    return new Promise((resolve, reject) => {
+        const keys = [];
+        const req = source.openKeyCursor(range);
+        req.onsuccess = () => {
+            const c = req.result;
+            if (!c)
+                return resolve(keys);
+            const pk = c.primaryKey !== undefined ? c.primaryKey : c.key;
+            keys.push(pk);
+            c.continue();
+        };
+        req.onerror = () => reject(req.error);
+    });
+}
+//# sourceMappingURL=engine.js.map

package/dist/db/engine.js.map

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

package/dist/db/lru.d.ts

@@ -0,0 +1,12 @@
+export declare class LRUCache<K, V> {
+    private cache;
+    private capacity;
+    constructor(capacity: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+    delete(key: K): void;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=lru.d.ts.map

package/dist/db/lru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru.d.ts","sourceRoot":"","sources":["../../src/db/lru.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAQ5B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAW1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAe3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAIpB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/db/lru.js

@@ -0,0 +1,46 @@
+export class LRUCache {
+    cache;
+    capacity;
+    constructor(capacity) {
+        if (capacity <= 0) {
+            throw new Error("LRU capacity must be > 0");
+        }
+        this.capacity = capacity;
+        this.cache = new Map();
+    }
+    get(key) {
+        if (!this.cache.has(key))
+            return undefined;
+        // move to most-recently-used
+        const value = this.cache.get(key);
+        this.cache.delete(key);
+        this.cache.set(key, value);
+        return value;
+    }
+    set(key, value) {
+        // update existing → move to MRU
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        this.cache.set(key, value);
+        // evict LRU if over capacity
+        if (this.cache.size > this.capacity) {
+            const lruKey = this.cache.keys().next().value;
+            if (lruKey)
+                this.cache.delete(lruKey);
+        }
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+    delete(key) {
+        this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=lru.js.map

package/dist/db/lru.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru.js","sourceRoot":"","sources":["../../src/db/lru.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAQ;IACX,KAAK,CAAY;IACjB,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAAM;QACR,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAE3C,6BAA6B;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,gCAAgC;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE3B,6BAA6B;QAC7B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,GAAM;QACX,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/db/qdb.d.ts

@@ -0,0 +1,65 @@
+import { Query, UpdateQuery, RemoveQuery } from "./query.js";
+import type { Codec, Schema, StoreData } from "./types.js";
+export default class qdb<S extends Schema, Wire> {
+    private engine;
+    private events;
+    constructor(dbName: string, version: number, schema: S, codec: Codec<Wire>, cache_limit?: number);
+    /**
+     * Open the db (Must)
+     */
+    open(): Promise<this>;
+    /**
+     * put data into db
+     */
+    put<K extends keyof S>(storeName: K, data: StoreData<S, K>): Promise<void>;
+    /**
+     * fetch Record by query callbacks
+     *
+     * end with `all()` or `one()`
+     */
+    query<store extends keyof S & string>(storeName: store): Query<S, store>;
+    /**
+     * update Record by query callbacks
+     *
+     * end with `exec()`
+     */
+    update<store extends keyof S & string>(storeName: store, updates: Partial<StoreData<S, store>>): UpdateQuery<S, store>;
+    /**
+     * update Record by query callbacks
+     *
+     * end with `exec()`
+     */
+    remove<K extends keyof S & string>(storeName: K): RemoveQuery<S, K>;
+    /**
+     * close db as clean up measure
+     */
+    close(): void;
+    /**
+     * static method to delete indexed-db
+     */
+    static deleteDatabase(dbName: string): Promise<void>;
+    /**
+     * setup event and fire across application
+     * @param store - Store name extends  `const stores`
+     * @param action - "ADD" | "DEL" | "UPT" : type of event
+     * @param data - `StoreData[K]` to deliver
+     */
+    private emit;
+    /**
+     * Subscribe to STORE-specific events.
+     *
+     * @param event - Event name derived from the store:
+     * `{store}-UP` | `{store}-ADD` | `{store}-RM`
+     *
+     * @param listener - Callback invoked with event payload:
+     * - `{store}-UP`  → Partial<Record>
+     * - `{store}-ADD` → Record
+     * - `{store}-RM`  → Keys[]
+     *
+     * @returns Cleanup function to unsubscribe.
+     */
+    subscribe<store extends keyof S & string>(event: `${store}-UP`, listener: (data: Partial<StoreData<S, store>>) => void): () => void;
+    subscribe<store extends keyof S & string>(event: `${store}-ADD`, listener: (data: StoreData<S, store>) => void): () => void;
+    subscribe<store extends keyof S & string>(event: `${store}-RM`, listener: (data: IDBValidKey[]) => void): () => void;
+}
+//# sourceMappingURL=qdb.d.ts.map

package/dist/db/qdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdb.d.ts","sourceRoot":"","sources":["../../src/db/qdb.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,KAAK,EACV,KAAK,EAGL,MAAM,EACN,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,OAAO,OAAO,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI;IAC7C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAc;gBAG1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,WAAW,GAAE,MAAa;IAM5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;IACG,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EACzB,SAAS,EAAE,CAAC,EACZ,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACpB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;OAIG;IACH,KAAK,CAAC,KAAK,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;IAIxE;;;;OAIG;IACH,MAAM,CAAC,KAAK,SAAS,MAAM,CAAC,GAAG,MAAM,EACnC,SAAS,EAAE,KAAK,EAChB,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GACpC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC;IAiBxB;;;;OAIG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAkBnE;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;WACU,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D;;;;;OAKG;IACH,OAAO,CAAC,IAAI;IAkCZ;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,KAAK,SAAS,MAAM,CAAC,GAAG,MAAM,EACtC,KAAK,EAAE,GAAG,KAAK,KAAK,EACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,GACrD,MAAM,IAAI;IACb,SAAS,CAAC,KAAK,SAAS,MAAM,CAAC,GAAG,MAAM,EACtC,KAAK,EAAE,GAAG,KAAK,MAAM,EACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,GAC5C,MAAM,IAAI;IACb,SAAS,CAAC,KAAK,SAAS,MAAM,CAAC,GAAG,MAAM,EACtC,KAAK,EAAE,GAAG,KAAK,KAAK,EACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,GACtC,MAAM,IAAI;CAmBd"}

package/dist/db/qdb.js

@@ -0,0 +1,107 @@
+import { Engine } from "./engine.js";
+import { Query, UpdateQuery, RemoveQuery } from "./query.js";
+export default class qdb {
+    engine;
+    events; // Private EventTarget
+    constructor(dbName, version, schema, codec, cache_limit = 1000) {
+        this.events = new EventTarget();
+        this.engine = new Engine(dbName, version, schema, codec, cache_limit);
+    }
+    /**
+     * Open the db (Must)
+     */
+    async open() {
+        await this.engine.open();
+        return this;
+    }
+    /**
+     * put data into db
+     */
+    async put(storeName, data) {
+        await this.engine.put(storeName, data);
+        this.emit(storeName, "ADD", data);
+    }
+    /**
+     * fetch Record by query callbacks
+     *
+     * end with `all()` or `one()`
+     */
+    query(storeName) {
+        return new Query(this.engine, storeName);
+    }
+    /**
+     * update Record by query callbacks
+     *
+     * end with `exec()`
+     */
+    update(storeName, updates) {
+        const query = new UpdateQuery(this.engine, storeName, updates);
+        // Wrap exec method
+        const originalExec = query.exec.bind(query);
+        query.exec = async () => {
+            const count = await originalExec();
+            // Emit UPT event after successful update
+            this.emit(storeName, "UP", updates);
+            return count;
+        };
+        return query;
+    }
+    /**
+     * update Record by query callbacks
+     *
+     * end with `exec()`
+     */
+    remove(storeName) {
+        // let name = storeName
+        const query = new RemoveQuery(this.engine, storeName);
+        // Wrap exec method
+        const originalExec = query.exec.bind(query);
+        query.exec = async () => {
+            const keys = await originalExec();
+            // Emit DEL event after successful delete
+            this.emit(storeName, "RM", keys);
+            return keys;
+        };
+        return query;
+    }
+    /**
+     * close db as clean up measure
+     */
+    close() {
+        this.engine.close();
+    }
+    /**
+     * static method to delete indexed-db
+     */
+    static async deleteDatabase(dbName) {
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.deleteDatabase(dbName);
+            request.onsuccess = () => resolve();
+            request.onerror = () => reject(request.error);
+        });
+    }
+    emit(store, action, data) {
+        const event = {
+            data,
+            name: `${store}-${action}`,
+        };
+        this.events.dispatchEvent(new CustomEvent(event.name, {
+            detail: event.data,
+            bubbles: true,
+            cancelable: true,
+        }));
+    }
+    subscribe(event, listener) {
+        // wrap the listener to extract custom payload
+        const wrapped = (e) => {
+            const customEvent = e;
+            // console.log(`listener.fired @${event}`);
+            listener(customEvent.detail);
+        };
+        this.events.addEventListener(event, wrapped);
+        return () => {
+            this.events.removeEventListener(event, wrapped);
+        };
+    }
+}
+//# sourceMappingURL=qdb.js.map

package/dist/db/qdb.js.map

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

package/dist/db/query.d.ts

@@ -0,0 +1,56 @@
+import type { Engine } from "./engine.js";
+import type { StoreData, WhereClause } from "./types.js";
+declare class QueryBuilder<S, K extends keyof S> {
+    protected engine: Engine<any, any>;
+    protected storeName: K & string;
+    protected _where: WhereClause[];
+    protected limitVal?: number;
+    protected offsetVal?: number;
+    protected orderField?: string;
+    protected orderDir?: "asc" | "desc";
+    protected keysOnly: boolean;
+    constructor(engine: Engine<any, any>, storeName: K & string);
+    /**
+     * Query by indexed fields and primary keys
+     */
+    where(field: string, op: "==" | ">" | ">=" | "<" | "<=", value: any): this;
+    /**
+     * limits the result
+     */
+    limit(n: number): this;
+    /**
+     * start ur results from a given index
+     */
+    offset(n: number): this;
+    /**
+     * ascending order by index
+     */
+    asc(field?: string): this;
+    /**
+     * descending order by index
+     */
+    desc(field?: string): this;
+    protected executeQuery(): Promise<any[]>;
+}
+export declare class Query<S, K extends keyof S> extends QueryBuilder<S, K> {
+    all(): Promise<StoreData<S, K>[]>;
+    one(): Promise<StoreData<S, K> | undefined>;
+    nextPage(): this;
+    /**
+     * Ergonomic primary keys function runs that with query plan
+     * @returns `IDBValidKey[]`
+     */
+    keys(): Promise<IDBValidKey[]>;
+}
+export declare class UpdateQuery<S, K extends keyof S> extends QueryBuilder<S, K> {
+    private updates;
+    constructor(engine: Engine<any, any>, storeName: K & string, updates: Partial<StoreData<S, K>>);
+    preview(): Promise<StoreData<S, K>[]>;
+    exec(): Promise<number>;
+}
+export declare class RemoveQuery<S, K extends keyof S> extends QueryBuilder<S, K> {
+    preview(): Promise<StoreData<S, K>[]>;
+    exec(): Promise<IDBValidKey[]>;
+}
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/db/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/db/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzD,cAAM,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC;IASnC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC;IAClC,SAAS,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM;IATjC,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAM;IACrC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACpC,SAAS,CAAC,QAAQ,UAAS;gBAGf,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EACxB,SAAS,EAAE,CAAC,GAAG,MAAM;IAGjC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAK1E;;OAEG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvB;;OAEG;IACH,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAOzB;;OAEG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;cAOV,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CAoB/C;AAGD,qBAAa,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3D,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAIjC,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;IAMjD,QAAQ,IAAI,IAAI;IAKhB;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAIrC;AAGD,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAIrE,OAAO,CAAC,OAAO;gBAFf,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EACxB,SAAS,EAAE,CAAC,GAAG,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAKrC,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAIrC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CAU9B;AAGD,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAIrC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAYrC"}

package/dist/db/query.js

@@ -0,0 +1,123 @@
+// Shared filter builder
+class QueryBuilder {
+    engine;
+    storeName;
+    _where = [];
+    limitVal;
+    offsetVal;
+    orderField;
+    orderDir;
+    keysOnly = false;
+    constructor(engine, storeName) {
+        this.engine = engine;
+        this.storeName = storeName;
+    }
+    /**
+     * Query by indexed fields and primary keys
+     */
+    where(field, op, value) {
+        this._where.push({ field, op, value });
+        return this;
+    }
+    /**
+     * limits the result
+     */
+    limit(n) {
+        this.limitVal = n;
+        return this;
+    }
+    /**
+     * start ur results from a given index
+     */
+    offset(n) {
+        this.offsetVal = n;
+        return this;
+    }
+    /**
+     * ascending order by index
+     */
+    asc(field) {
+        const schema = this.engine.getSchema(this.storeName);
+        this.orderField = field || schema.pk[0];
+        this.orderDir = "asc";
+        return this;
+    }
+    /**
+     * descending order by index
+     */
+    desc(field) {
+        const schema = this.engine.getSchema(this.storeName);
+        this.orderField = field || schema.pk[0];
+        this.orderDir = "desc";
+        return this;
+    }
+    async executeQuery() {
+        // 1. ask engine for keys
+        const keys = await this.engine.getKeysByIndexes(this.storeName, this._where, this.orderField, this.orderDir, this.limitVal, this.offsetVal);
+        // console.log("pk are : ", keys);
+        if (this.keysOnly) {
+            return keys;
+        }
+        // 2. hydrate via cache + db
+        return this.engine.getRecordsByKeys(this.storeName, keys);
+    }
+}
+// Query for reads
+export class Query extends QueryBuilder {
+    async all() {
+        return this.executeQuery();
+    }
+    async one() {
+        this.limitVal = 1;
+        const results = await this.executeQuery();
+        return results[0];
+    }
+    nextPage() {
+        this.offsetVal = (this.offsetVal || 0) + (this.limitVal || 0);
+        return this;
+    }
+    /**
+     * Ergonomic primary keys function runs that with query plan
+     * @returns `IDBValidKey[]`
+     */
+    async keys() {
+        this.keysOnly = true;
+        return this.executeQuery();
+    }
+}
+// Update Query
+export class UpdateQuery extends QueryBuilder {
+    updates;
+    constructor(engine, storeName, updates) {
+        super(engine, storeName);
+        this.updates = updates;
+    }
+    async preview() {
+        return this.executeQuery();
+    }
+    async exec() {
+        const results = await this.executeQuery();
+        for (const record of results) {
+            const updated = Object.assign({}, record, this.updates);
+            await this.engine.put(this.storeName, updated);
+        }
+        return results.length;
+    }
+}
+// Remove Query
+export class RemoveQuery extends QueryBuilder {
+    async preview() {
+        return this.executeQuery();
+    }
+    async exec() {
+        this.keysOnly = true; // we want just the keys
+        const keys = await this.executeQuery();
+        const deletedKeys = [];
+        for (const key of keys) {
+            await this.engine.delete(this.storeName, key);
+            deletedKeys.push(key); // Collect keys
+        }
+        return deletedKeys; // Return keys instead of count
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/db/query.js.map

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

package/dist/db/types.d.ts

@@ -0,0 +1,22 @@
+export type Schema = {
+    [storeName: string]: {
+        pk: readonly string[];
+        index: readonly string[];
+        data: Record<string, any>;
+    };
+};
+export interface Codec<Wire> {
+    encode(data: unknown): Wire;
+    decode(data: Wire): unknown;
+}
+export type StoreData<S, K extends keyof S> = S[K] extends {
+    data: infer D;
+} ? D : never;
+export type EventActions = "ADD" | "UP" | "RM";
+export type EventName<K extends keyof Schema & string> = `${K}-${EventActions}`;
+export type WhereClause = {
+    field: string;
+    op: "==" | ">" | ">=" | "<" | "<=";
+    value: any;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/db/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/db/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG;IACnB,CAAC,SAAS,EAAE,MAAM,GAAG;QACnB,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC;QACtB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC3B,CAAC;CACH,CAAC;AAEF,MAAM,WAAW,KAAK,CAAC,IAAI;IACzB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GACxE,CAAC,GACD,KAAK,CAAC;AAEV,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/C,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,IAAI,GAAG,CAAC,IAAI,YAAY,EAAE,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,GAAG,CAAC;CACZ,CAAC"}

package/dist/db/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/db/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/db/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./db/qdb.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { default } from "./db/qdb.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "qutedb",
+  "version": "0.0.1",
+  "description": "Very simple and thin IndexedDB wrapper",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "indexeddb",
+    "browser",
+    "database",
+    "fast",
+    "idb",
+    "thin",
+    "Store",
+    "small",
+    "cute",
+    "qute"
+  ],
+  "author": "latenightentropy",
+  "license": "ISC",
+  "devDependencies": {
+    "@msgpack/msgpack": "^3.1.3",
+    "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^4.0.16",
+    "fake-indexeddb": "^6.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  }
+}

package/readme.md

@@ -0,0 +1,157 @@
+# QuteDb 🙈
+
+### Very Simple and thin and Ergonomic IDB wrapper
+
+- Make ur life easier duh and its super thin (~10KB)
+- 0 extra dependencies
+- it just works predictable and explicit
+
+Some Stats:
+| N | Cold | Hot |
+| ---- | ------ | ------- |
+| 50k | ~2.3 s | ~0.38 s |
+| 100k | ~6.6 s | ~0.88 s |
+
+### Storage
+
+Indexes and primary keys are stored plaintext and any fields that are not index is mushed into a object then serialized/deserialized using a user given custom encode/decode function
+
+### Declare Your Database
+
+```ts
+// YourDatabase.ts
+import qdb from "qdb";
+
+interface Employee {
+  name: string;
+  id: string;
+  age: number;
+  joined: number;
+  salary: number;
+  addr: string;
+  office: string;
+}
+
+const schema = {
+  Employees: {
+    pk: ["name","id"],
+    index:["age","office"],
+    data: {} as Employee & {
+        // u can add extra fields not in ur interface
+        years:number;
+    }
+  },
+} as const;
+
+
+const mydb = await new qdb(
+  "my-db", // db name
+  1, // db version
+  scehma, // db schema
+  {
+    decode: JSON.parse, // decode function of ur choice
+    encode: JSON.stringify, // encode function of ur choice
+  },
+  2000 // cache records limit (this is crucial)
+).open();
+
+export mydb;
+```
+
+### 1. Put
+
+```ts
+await mydb.put("Employees", {
+  name: "Alice",
+  id: "e-1",
+  age: 28,
+  joined: Date.now(),
+  salary: 90000,
+  addr: "NY",
+  office: "HQ",
+  years: 3,
+});
+```
+
+### 2. Query Functions
+
+supported operations
+`==  >  >=  <  <=`  
+the `where` clause can only be used with
+primary keys and indexes
+
+```ts
+mydb
+  .query("Employees")
+  .where("office", "==", "HQ")
+  .where("age", ">=", 25)
+  .asc("age")
+  .limit(20)
+  .all();
+```
+
+### 3. Update/Remove
+
+and similar operations for `update` and `remove`
+
+```ts
+// update
+mydb
+  .update("Employees", {
+    salary: 100_000, // partial data
+  })
+  .where("office", "==", "HQ")
+  .where("age", ">=", 25)
+  .asc("age")
+  .limit(20)
+  .exec(); // exec() here
+
+//remove
+mydb
+  .remove("Employees")
+  .where("office", "==", "HQ")
+  .where("age", ">=", 25)
+  .asc("age")
+  .limit(20)
+  .exec(); // exec() here
+```
+
+u can use `one()` instead of `all()` to get a single result
+
+### 3. Pagination
+
+`offset(a:number)` and `limit(b:number)` clauses are provided , and u can build a paginator very easily
+
+### 4. Subscriptions
+
+This is some `svelte` code and u can use the subscription like that , very easy and intuitive
+
+```ts
+let lis: Function[] = [];
+let rooms: RoomSchema[] = $state([]);
+
+ChatStore.query(STORES.ROOMS)
+  .limit(20)
+  .all()
+  .then((data) => {
+    rooms = data;
+  });
+
+lis[0] = ChatStore.subscribe("ROOMS-ADD", (data) => {
+  // here data is the full Room Schema
+  ...
+});
+lis[1] = ChatStore.subscribe("ROOMS-UP", (data) => {
+  // here data is the Partial Room Schema
+  // the Part which is updated
+  ...
+});
+lis[2] = ChatStore.subscribe("ROOMS-RM", (keys) => {
+    // here keys are the Primary Keys belonging to the Reocrd
+    // which are droped
+    ...
+});
+
+// clean up the eventListeners on Dismount
+onDestroy(() => lis.forEach((l) => l()));
+```