cache-craft-engine 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MJ.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,172 @@
+# CacheCraft 🛠️
+
+**A lightweight, fully client-side IndexedDB cache engine**  
+With support for compression (gzip), encoding (base64), LRU eviction, TTL, stale-while-revalidate, and namespaces.
+
+- **Framework-agnostic** → React, Vue, Svelte, Vanilla JS, etc.
+- **Persistence** → Data survives page reloads and tab closures
+- **Production-ready** → Smart eviction + size management + automatic compression
+
+[![npm version](https://img.shields.io/npm/v/cache-craft.svg?color=green)](https://www.npmjs.com/package/cache-craft)
+[![GitHub](https://img.shields.io/github/stars/MJavadSF/CacheCraft?style=social)](https://github.com/MJavadSF/CacheCraft)
+
+---
+
+## Key Features
+
+- Persistent storage with **IndexedDB**
+- **LRU eviction** (removes least recently used items when exceeding max size)
+- **gzip compression** automatic for large items (>10KB by default)
+- **Base64 encoding** optional
+- **TTL** (time to live)
+- **Stale-While-Revalidate** → Return stale data quickly + update in the background
+- **Namespaces** for logical separation of caches (e.g., user / media / offline-forms)
+
+---
+
+## Installation
+
+```bash
+npm install cache-craft
+# Or directly from GitHub (before official release):
+# npm install github:MJavadSF/CacheCraft
+```
+
+---
+
+## Quick Usage
+
+```ts
+import { CacheEngine } from 'cache-craft';
+
+const cache = new CacheEngine({
+  dbName: 'my-app-cache',
+  maxSize: 150 * 1024 * 1024,     // 150 MB
+  compressionThreshold: 8 * 1024, // Compress from 8 KB upwards
+  namespace: 'app-v1',            // Optional
+});
+
+// Set
+await cache.set('user-profile', { id: 42, name: 'Ali', avatar: '...' }, {
+  ttl: 10 * 60 * 1000, // 10 minutes
+});
+
+// Simple get
+const user = await cache.get<{ id: number; name: string }>('user-profile');
+
+// Stale-while-revalidate (great for APIs)
+const posts = await cache.get('posts-list', {
+  staleWhileRevalidate: true,
+  revalidate: async () => {
+    const res = await fetch('/api/posts');
+    const data = await res.json();
+    await cache.set('posts-list', data, { ttl: 300_000 });
+    return data;
+  },
+});
+
+// Separate namespace
+const imageCache = cache.namespace('images');
+await imageCache.set('cover-001', { url: '/assets/cover.jpg', alt: '...' });
+```
+
+---
+
+## Full API
+
+```ts
+// Create instance
+const cache = new CacheEngine(config?: CacheConfig);
+
+// Set
+await cache.set(key: string, value: any, options?: CacheSetOptions);
+
+// Get
+await cache.get<T>(key: string, options?: CacheGetOptions<T>): Promise<T | null>;
+
+// Remove single item
+await cache.remove(key: string);
+
+// Clear all cache
+await cache.clear();
+
+// Create sub-cache with namespace
+const subCache = cache.namespace('prefix');
+```
+
+### CacheSetOptions
+
+```ts
+{
+  ttl?: number;           // milliseconds
+  encode?: boolean;       // Base64 encode?
+  forceCompress?: boolean;// Compress even if small
+}
+```
+
+### CacheGetOptions
+
+```ts
+{
+  staleWhileRevalidate?: boolean;
+  revalidate?: () => Promise<T>;
+  ttlOnRevalidate?: number;
+}
+```
+
+---
+
+## Practical Examples
+
+### Cache API Response with TTL
+
+```ts
+async function getUser(id: number) {
+  const key = `user:${id}`;
+  let data = await cache.get(key);
+
+  if (!data) {
+    const res = await fetch(`/api/users/${id}`);
+    data = await res.json();
+    await cache.set(key, data, { ttl: 60_000 }); // 1 minute
+  }
+
+  return data;
+}
+```
+
+### Offline Form Draft
+
+```ts
+// Save on type
+await cache.set('checkout:draft', formValues, { ttl: 24 * 60 * 60_000 });
+
+// On page load
+const saved = await cache.get('checkout:draft');
+```
+
+### Large Data with Forced Compression
+
+```ts
+await cache.set('analytics:2025', hugeJsonData, {
+  forceCompress: true,
+  ttl: 7 * 24 * 60 * 60_000, // One week
+});
+```
+
+---
+
+## Best Practices
+
+- Always use **namespaces** for different data types
+- Never cache **sensitive data** (tokens, passwords)
+- Choose **appropriate TTL** (long for static, short for APIs)
+- Use **staleWhileRevalidate** for high-traffic pages
+- Set **maxSize** based on user devices (lower for mobile)
+
+---
+
+## Links
+
+- GitHub: [CacheCraft](https://github.com/MJavadSF/CacheCraft/)
+- npm: [cache-craft](https://www.npmjs.com/package/cache-craft)

package/dist/cache-engine.d.ts

@@ -0,0 +1,44 @@
+export type CacheEntry<T = any> = {
+    value: T | string | Uint8Array;
+    isEncoded: boolean;
+    isCompressed: boolean;
+    createdAt: number;
+    lastAccessed: number;
+    expiresAt?: number;
+    size: number;
+};
+export type CacheSetOptions = {
+    ttl?: number;
+    encode?: boolean;
+    forceCompress?: boolean;
+};
+export type CacheGetOptions<T> = {
+    staleWhileRevalidate?: boolean;
+    revalidate?: () => Promise<T>;
+    ttlOnRevalidate?: number;
+};
+export type CacheConfig = {
+    dbName?: string;
+    version?: number;
+    storeName?: string;
+    maxSize?: number;
+    compressionThreshold?: number;
+    namespace?: string;
+};
+export declare class CacheEngine {
+    private dbPromise;
+    private readonly config;
+    constructor(cfg?: CacheConfig);
+    private getDB;
+    private tx;
+    private k;
+    private getRaw;
+    private putRaw;
+    private deleteRaw;
+    private evict;
+    set<T>(key: string, value: T, opt?: CacheSetOptions): Promise<void>;
+    get<T>(key: string, opt?: CacheGetOptions<T>): Promise<T | null>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    namespace(ns: string): CacheEngine;
+}

package/dist/cache-engine.js

@@ -0,0 +1,206 @@
+// cache-engine.ts
+// ==============================
+// Utils
+// ==============================
+function isClient() {
+    return (typeof window !== "undefined" &&
+        "indexedDB" in window &&
+        "CompressionStream" in window);
+}
+async function compress(data) {
+    const cs = new CompressionStream("gzip");
+    const writer = cs.writable.getWriter();
+    await writer.write(new TextEncoder().encode(data));
+    await writer.close();
+    const out = await new Response(cs.readable).arrayBuffer();
+    return new Uint8Array(out);
+}
+async function decompress(data) {
+    const ds = new DecompressionStream("gzip");
+    const writer = ds.writable.getWriter();
+    // @ts-ignore
+    await writer.write(data);
+    await writer.close();
+    const out = await new Response(ds.readable).arrayBuffer();
+    return new TextDecoder().decode(out);
+}
+function encode(v) {
+    return btoa(encodeURIComponent(JSON.stringify(v)));
+}
+function decode(v) {
+    return JSON.parse(decodeURIComponent(atob(v)));
+}
+// ==============================
+// Cache Engine
+// ==============================
+export class CacheEngine {
+    constructor(cfg) {
+        this.dbPromise = null;
+        this.config = {
+            dbName: cfg?.dbName ?? "cache-db",
+            version: cfg?.version ?? 1,
+            storeName: cfg?.storeName ?? "cache",
+            maxSize: cfg?.maxSize ?? 100 * 1024 * 1024,
+            compressionThreshold: cfg?.compressionThreshold ?? 10 * 1024,
+            namespace: cfg?.namespace ?? "",
+        };
+    }
+    // ==============================
+    // DB
+    // ==============================
+    async getDB() {
+        if (!isClient())
+            throw new Error("IndexedDB unsupported");
+        if (!this.dbPromise) {
+            this.dbPromise = new Promise((resolve, reject) => {
+                const req = indexedDB.open(this.config.dbName, this.config.version);
+                req.onupgradeneeded = () => {
+                    const db = req.result;
+                    if (!db.objectStoreNames.contains(this.config.storeName)) {
+                        db.createObjectStore(this.config.storeName);
+                    }
+                };
+                req.onsuccess = () => resolve(req.result);
+                req.onerror = () => reject(req.error);
+            });
+        }
+        return this.dbPromise;
+    }
+    async tx(mode, fn) {
+        const db = await this.getDB();
+        const tx = db.transaction(this.config.storeName, mode);
+        const store = tx.objectStore(this.config.storeName);
+        return new Promise((resolve, reject) => {
+            let result;
+            try {
+                const req = fn(store);
+                if (req)
+                    req.onsuccess = () => (result = req.result);
+            }
+            catch (e) {
+                reject(e);
+            }
+            tx.oncomplete = () => resolve(result);
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    // ==============================
+    // Helpers
+    // ==============================
+    k(key) {
+        return this.config.namespace
+            ? `${this.config.namespace}:${key}`
+            : key;
+    }
+    async getRaw(key) {
+        return this.tx("readonly", s => s.get(this.k(key)));
+    }
+    async putRaw(key, val) {
+        return this.tx("readwrite", s => s.put(val, this.k(key)));
+    }
+    async deleteRaw(key) {
+        return this.tx("readwrite", s => s.delete(this.k(key)));
+    }
+    // ==============================
+    // Eviction (LRU)
+    // ==============================
+    async evict() {
+        const db = await this.getDB();
+        const tx = db.transaction(this.config.storeName, "readonly");
+        const store = tx.objectStore(this.config.storeName);
+        const entries = [];
+        await new Promise(res => {
+            store.openCursor().onsuccess = (e) => {
+                const c = e.target.result;
+                if (!c)
+                    return res();
+                entries.push({
+                    key: c.key,
+                    size: c.value.size,
+                    last: c.value.lastAccessed,
+                });
+                c.continue();
+            };
+        });
+        let total = entries.reduce((s, e) => s + e.size, 0);
+        if (total <= this.config.maxSize)
+            return;
+        entries.sort((a, b) => a.last - b.last);
+        for (const e of entries) {
+            if (total <= this.config.maxSize)
+                break;
+            await this.deleteRaw(e.key);
+            total -= e.size;
+        }
+    }
+    // ==============================
+    // Public API
+    // ==============================
+    async set(key, value, opt) {
+        const json = JSON.stringify(value);
+        let final = json;
+        let size = new Blob([json]).size;
+        let compressed = false;
+        if (opt?.forceCompress ||
+            size > this.config.compressionThreshold) {
+            final = await compress(json);
+            size = final.byteLength;
+            compressed = true;
+        }
+        else if (opt?.encode) {
+            final = encode(value);
+            size = new Blob([final]).size;
+        }
+        const entry = {
+            value: final,
+            isEncoded: opt?.encode ?? false,
+            isCompressed: compressed,
+            createdAt: Date.now(),
+            lastAccessed: Date.now(),
+            expiresAt: opt?.ttl
+                ? Date.now() + opt.ttl
+                : undefined,
+            size,
+        };
+        await this.putRaw(key, entry);
+        await this.evict();
+    }
+    async get(key, opt) {
+        const entry = await this.getRaw(key);
+        if (!entry)
+            return null;
+        const now = Date.now();
+        const expired = entry.expiresAt && now > entry.expiresAt;
+        if (!expired)
+            entry.lastAccessed = now;
+        if (expired && opt?.staleWhileRevalidate && opt.revalidate) {
+            opt.revalidate().then(v => this.set(key, v, {
+                ttl: opt.ttlOnRevalidate,
+            }));
+        }
+        if (expired && !opt?.staleWhileRevalidate) {
+            await this.deleteRaw(key);
+            return null;
+        }
+        let v = entry.value;
+        if (entry.isCompressed)
+            v = await decompress(v);
+        if (entry.isEncoded)
+            v = decode(v);
+        return typeof v === "string"
+            ? JSON.parse(v)
+            : v;
+    }
+    async remove(key) {
+        await this.deleteRaw(key);
+    }
+    async clear() {
+        await this.tx("readwrite", s => s.clear());
+    }
+    namespace(ns) {
+        return new CacheEngine({
+            ...this.config,
+            namespace: ns,
+        });
+    }
+}

package/dist/index.cjs

@@ -0,0 +1,211 @@
+'use strict';
+
+// cache-engine.ts
+// ==============================
+// Utils
+// ==============================
+function isClient() {
+    return (typeof window !== "undefined" &&
+        "indexedDB" in window &&
+        "CompressionStream" in window);
+}
+async function compress(data) {
+    const cs = new CompressionStream("gzip");
+    const writer = cs.writable.getWriter();
+    await writer.write(new TextEncoder().encode(data));
+    await writer.close();
+    const out = await new Response(cs.readable).arrayBuffer();
+    return new Uint8Array(out);
+}
+async function decompress(data) {
+    const ds = new DecompressionStream("gzip");
+    const writer = ds.writable.getWriter();
+    // @ts-ignore
+    await writer.write(data);
+    await writer.close();
+    const out = await new Response(ds.readable).arrayBuffer();
+    return new TextDecoder().decode(out);
+}
+function encode(v) {
+    return btoa(encodeURIComponent(JSON.stringify(v)));
+}
+function decode(v) {
+    return JSON.parse(decodeURIComponent(atob(v)));
+}
+// ==============================
+// Cache Engine
+// ==============================
+class CacheEngine {
+    constructor(cfg) {
+        this.dbPromise = null;
+        this.config = {
+            dbName: cfg?.dbName ?? "cache-db",
+            version: cfg?.version ?? 1,
+            storeName: cfg?.storeName ?? "cache",
+            maxSize: cfg?.maxSize ?? 100 * 1024 * 1024,
+            compressionThreshold: cfg?.compressionThreshold ?? 10 * 1024,
+            namespace: cfg?.namespace ?? "",
+        };
+    }
+    // ==============================
+    // DB
+    // ==============================
+    async getDB() {
+        if (!isClient())
+            throw new Error("IndexedDB unsupported");
+        if (!this.dbPromise) {
+            this.dbPromise = new Promise((resolve, reject) => {
+                const req = indexedDB.open(this.config.dbName, this.config.version);
+                req.onupgradeneeded = () => {
+                    const db = req.result;
+                    if (!db.objectStoreNames.contains(this.config.storeName)) {
+                        db.createObjectStore(this.config.storeName);
+                    }
+                };
+                req.onsuccess = () => resolve(req.result);
+                req.onerror = () => reject(req.error);
+            });
+        }
+        return this.dbPromise;
+    }
+    async tx(mode, fn) {
+        const db = await this.getDB();
+        const tx = db.transaction(this.config.storeName, mode);
+        const store = tx.objectStore(this.config.storeName);
+        return new Promise((resolve, reject) => {
+            let result;
+            try {
+                const req = fn(store);
+                if (req)
+                    req.onsuccess = () => (result = req.result);
+            }
+            catch (e) {
+                reject(e);
+            }
+            tx.oncomplete = () => resolve(result);
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    // ==============================
+    // Helpers
+    // ==============================
+    k(key) {
+        return this.config.namespace
+            ? `${this.config.namespace}:${key}`
+            : key;
+    }
+    async getRaw(key) {
+        return this.tx("readonly", s => s.get(this.k(key)));
+    }
+    async putRaw(key, val) {
+        return this.tx("readwrite", s => s.put(val, this.k(key)));
+    }
+    async deleteRaw(key) {
+        return this.tx("readwrite", s => s.delete(this.k(key)));
+    }
+    // ==============================
+    // Eviction (LRU)
+    // ==============================
+    async evict() {
+        const db = await this.getDB();
+        const tx = db.transaction(this.config.storeName, "readonly");
+        const store = tx.objectStore(this.config.storeName);
+        const entries = [];
+        await new Promise(res => {
+            store.openCursor().onsuccess = (e) => {
+                const c = e.target.result;
+                if (!c)
+                    return res();
+                entries.push({
+                    key: c.key,
+                    size: c.value.size,
+                    last: c.value.lastAccessed,
+                });
+                c.continue();
+            };
+        });
+        let total = entries.reduce((s, e) => s + e.size, 0);
+        if (total <= this.config.maxSize)
+            return;
+        entries.sort((a, b) => a.last - b.last);
+        for (const e of entries) {
+            if (total <= this.config.maxSize)
+                break;
+            await this.deleteRaw(e.key);
+            total -= e.size;
+        }
+    }
+    // ==============================
+    // Public API
+    // ==============================
+    async set(key, value, opt) {
+        const json = JSON.stringify(value);
+        let final = json;
+        let size = new Blob([json]).size;
+        let compressed = false;
+        if (opt?.forceCompress ||
+            size > this.config.compressionThreshold) {
+            final = await compress(json);
+            size = final.byteLength;
+            compressed = true;
+        }
+        else if (opt?.encode) {
+            final = encode(value);
+            size = new Blob([final]).size;
+        }
+        const entry = {
+            value: final,
+            isEncoded: opt?.encode ?? false,
+            isCompressed: compressed,
+            createdAt: Date.now(),
+            lastAccessed: Date.now(),
+            expiresAt: opt?.ttl
+                ? Date.now() + opt.ttl
+                : undefined,
+            size,
+        };
+        await this.putRaw(key, entry);
+        await this.evict();
+    }
+    async get(key, opt) {
+        const entry = await this.getRaw(key);
+        if (!entry)
+            return null;
+        const now = Date.now();
+        const expired = entry.expiresAt && now > entry.expiresAt;
+        if (!expired)
+            entry.lastAccessed = now;
+        if (expired && opt?.staleWhileRevalidate && opt.revalidate) {
+            opt.revalidate().then(v => this.set(key, v, {
+                ttl: opt.ttlOnRevalidate,
+            }));
+        }
+        if (expired && !opt?.staleWhileRevalidate) {
+            await this.deleteRaw(key);
+            return null;
+        }
+        let v = entry.value;
+        if (entry.isCompressed)
+            v = await decompress(v);
+        if (entry.isEncoded)
+            v = decode(v);
+        return typeof v === "string"
+            ? JSON.parse(v)
+            : v;
+    }
+    async remove(key) {
+        await this.deleteRaw(key);
+    }
+    async clear() {
+        await this.tx("readwrite", s => s.clear());
+    }
+    namespace(ns) {
+        return new CacheEngine({
+            ...this.config,
+            namespace: ns,
+        });
+    }
+}
+
+exports.CacheEngine = CacheEngine;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/cache-engine.ts"],"sourcesContent":["// cache-engine.ts\r\n\r\n// ==============================\r\n// Types\r\n// ==============================\r\nexport type CacheEntry<T = any> = {\r\n    value: T | string | Uint8Array;\r\n    isEncoded: boolean;\r\n    isCompressed: boolean;\r\n    createdAt: number;\r\n    lastAccessed: number;\r\n    expiresAt?: number;\r\n    size: number;\r\n};\r\n\r\nexport type CacheSetOptions = {\r\n    ttl?: number;\r\n    encode?: boolean;\r\n    forceCompress?: boolean;\r\n};\r\n\r\nexport type CacheGetOptions<T> = {\r\n    staleWhileRevalidate?: boolean;\r\n    revalidate?: () => Promise<T>;\r\n    ttlOnRevalidate?: number;\r\n};\r\n\r\nexport type CacheConfig = {\r\n    dbName?: string;\r\n    version?: number;\r\n    storeName?: string;\r\n    maxSize?: number;\r\n    compressionThreshold?: number;\r\n    namespace?: string;\r\n};\r\n\r\n// ==============================\r\n// Utils\r\n// ==============================\r\nfunction isClient() {\r\n    return (\r\n        typeof window !== \"undefined\" &&\r\n        \"indexedDB\" in window &&\r\n        \"CompressionStream\" in window\r\n    );\r\n}\r\n\r\nasync function compress(data: string): Promise<Uint8Array> {\r\n    const cs = new CompressionStream(\"gzip\");\r\n    const writer = cs.writable.getWriter();\r\n    await writer.write(new TextEncoder().encode(data));\r\n    await writer.close();\r\n    const out = await new Response(cs.readable).arrayBuffer();\r\n    return new Uint8Array(out);\r\n}\r\n\r\nasync function decompress(data: Uint8Array): Promise<string> {\r\n    const ds = new DecompressionStream(\"gzip\");\r\n    const writer = ds.writable.getWriter();\r\n    // @ts-ignore\r\n    await writer.write(data);\r\n    await writer.close();\r\n    const out = await new Response(ds.readable).arrayBuffer();\r\n    return new TextDecoder().decode(out);\r\n}\r\n\r\nfunction encode(v: any) {\r\n    return btoa(encodeURIComponent(JSON.stringify(v)));\r\n}\r\n\r\nfunction decode(v: string) {\r\n    return JSON.parse(decodeURIComponent(atob(v)));\r\n}\r\n\r\n// ==============================\r\n// Cache Engine\r\n// ==============================\r\nexport class CacheEngine {\r\n    private dbPromise: Promise<IDBDatabase> | null = null;\r\n    private readonly config: Required<CacheConfig>;\r\n\r\n    constructor(cfg?: CacheConfig) {\r\n        this.config = {\r\n            dbName: cfg?.dbName ?? \"cache-db\",\r\n            version: cfg?.version ?? 1,\r\n            storeName: cfg?.storeName ?? \"cache\",\r\n            maxSize: cfg?.maxSize ?? 100 * 1024 * 1024,\r\n            compressionThreshold: cfg?.compressionThreshold ?? 10 * 1024,\r\n            namespace: cfg?.namespace ?? \"\",\r\n        };\r\n    }\r\n\r\n    // ==============================\r\n    // DB\r\n    // ==============================\r\n    private async getDB(): Promise<IDBDatabase> {\r\n        if (!isClient()) throw new Error(\"IndexedDB unsupported\");\r\n\r\n        if (!this.dbPromise) {\r\n            this.dbPromise = new Promise((resolve, reject) => {\r\n                const req = indexedDB.open(\r\n                    this.config.dbName,\r\n                    this.config.version\r\n                );\r\n\r\n                req.onupgradeneeded = () => {\r\n                    const db = req.result;\r\n                    if (!db.objectStoreNames.contains(this.config.storeName)) {\r\n                        db.createObjectStore(this.config.storeName);\r\n                    }\r\n                };\r\n\r\n                req.onsuccess = () => resolve(req.result);\r\n                req.onerror = () => reject(req.error);\r\n            });\r\n        }\r\n\r\n        return this.dbPromise;\r\n    }\r\n\r\n    private async tx<T>(\r\n        mode: IDBTransactionMode,\r\n        fn: (store: IDBObjectStore) => IDBRequest | void\r\n    ): Promise<T> {\r\n        const db = await this.getDB();\r\n        const tx = db.transaction(this.config.storeName, mode);\r\n        const store = tx.objectStore(this.config.storeName);\r\n\r\n        return new Promise((resolve, reject) => {\r\n            let result: any;\r\n\r\n            try {\r\n                const req = fn(store);\r\n                if (req) req.onsuccess = () => (result = req.result);\r\n            } catch (e) {\r\n                reject(e);\r\n            }\r\n\r\n            tx.oncomplete = () => resolve(result);\r\n            tx.onerror = () => reject(tx.error);\r\n        });\r\n    }\r\n\r\n    // ==============================\r\n    // Helpers\r\n    // ==============================\r\n    private k(key: string) {\r\n        return this.config.namespace\r\n            ? `${this.config.namespace}:${key}`\r\n            : key;\r\n    }\r\n\r\n    private async getRaw(key: string) {\r\n        return this.tx<CacheEntry>(\"readonly\", s => s.get(this.k(key)));\r\n    }\r\n\r\n    private async putRaw(key: string, val: CacheEntry) {\r\n        return this.tx(\"readwrite\", s => s.put(val, this.k(key)));\r\n    }\r\n\r\n    private async deleteRaw(key: string) {\r\n        return this.tx(\"readwrite\", s => s.delete(this.k(key)));\r\n    }\r\n\r\n    // ==============================\r\n    // Eviction (LRU)\r\n    // ==============================\r\n    private async evict() {\r\n        const db = await this.getDB();\r\n        const tx = db.transaction(this.config.storeName, \"readonly\");\r\n        const store = tx.objectStore(this.config.storeName);\r\n\r\n        const entries: any[] = [];\r\n\r\n        await new Promise<void>(res => {\r\n            store.openCursor().onsuccess = (e: any) => {\r\n                const c = e.target.result;\r\n                if (!c) return res();\r\n\r\n                entries.push({\r\n                    key: c.key,\r\n                    size: c.value.size,\r\n                    last: c.value.lastAccessed,\r\n                });\r\n\r\n                c.continue();\r\n            };\r\n        });\r\n\r\n        let total = entries.reduce((s, e) => s + e.size, 0);\r\n\r\n        if (total <= this.config.maxSize) return;\r\n\r\n        entries.sort((a, b) => a.last - b.last);\r\n\r\n        for (const e of entries) {\r\n            if (total <= this.config.maxSize) break;\r\n            await this.deleteRaw(e.key);\r\n            total -= e.size;\r\n        }\r\n    }\r\n\r\n    // ==============================\r\n    // Public API\r\n    // ==============================\r\n    async set<T>(\r\n        key: string,\r\n        value: T,\r\n        opt?: CacheSetOptions\r\n    ) {\r\n        const json = JSON.stringify(value);\r\n\r\n        let final: string | Uint8Array = json;\r\n        let size = new Blob([json]).size;\r\n        let compressed = false;\r\n\r\n        if (\r\n            opt?.forceCompress ||\r\n            size > this.config.compressionThreshold\r\n        ) {\r\n            final = await compress(json);\r\n            size = final.byteLength;\r\n            compressed = true;\r\n        } else if (opt?.encode) {\r\n            final = encode(value);\r\n            size = new Blob([final]).size;\r\n        }\r\n\r\n        const entry: CacheEntry = {\r\n            value: final,\r\n            isEncoded: opt?.encode ?? false,\r\n            isCompressed: compressed,\r\n            createdAt: Date.now(),\r\n            lastAccessed: Date.now(),\r\n            expiresAt: opt?.ttl\r\n                ? Date.now() + opt.ttl\r\n                : undefined,\r\n            size,\r\n        };\r\n\r\n        await this.putRaw(key, entry);\r\n        await this.evict();\r\n    }\r\n\r\n    async get<T>(\r\n        key: string,\r\n        opt?: CacheGetOptions<T>\r\n    ): Promise<T | null> {\r\n        const entry = await this.getRaw(key);\r\n        if (!entry) return null;\r\n\r\n        const now = Date.now();\r\n        const expired =\r\n            entry.expiresAt && now > entry.expiresAt;\r\n\r\n        if (!expired)\r\n            entry.lastAccessed = now;\r\n\r\n        if (expired && opt?.staleWhileRevalidate && opt.revalidate) {\r\n            opt.revalidate().then(v =>\r\n                this.set(key, v, {\r\n                    ttl: opt.ttlOnRevalidate,\r\n                })\r\n            );\r\n        }\r\n\r\n        if (expired && !opt?.staleWhileRevalidate) {\r\n            await this.deleteRaw(key);\r\n            return null;\r\n        }\r\n\r\n        let v: any = entry.value;\r\n\r\n        if (entry.isCompressed)\r\n            v = await decompress(v as Uint8Array);\r\n\r\n        if (entry.isEncoded)\r\n            v = decode(v as string);\r\n\r\n        return typeof v === \"string\"\r\n            ? JSON.parse(v)\r\n            : v;\r\n    }\r\n\r\n    async remove(key: string) {\r\n        await this.deleteRaw(key);\r\n    }\r\n\r\n    async clear() {\r\n        await this.tx(\"readwrite\", s => s.clear());\r\n    }\r\n\r\n    namespace(ns: string) {\r\n        return new CacheEngine({\r\n            ...this.config,\r\n            namespace: ns,\r\n        });\r\n    }\r\n}\r\n"],"names":[],"mappings":";;AAAA;AAoCA;AACA;AACA;AACA,SAAS,QAAQ,GAAA;AACb,IAAA,QACI,OAAO,MAAM,KAAK,WAAW;AAC7B,QAAA,WAAW,IAAI,MAAM;QACrB,mBAAmB,IAAI,MAAM;AAErC;AAEA,eAAe,QAAQ,CAAC,IAAY,EAAA;AAChC,IAAA,MAAM,EAAE,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC;IACxC,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE;AACtC,IAAA,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClD,IAAA,MAAM,MAAM,CAAC,KAAK,EAAE;AACpB,IAAA,MAAM,GAAG,GAAG,MAAM,IAAI,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;AACzD,IAAA,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC;AAC9B;AAEA,eAAe,UAAU,CAAC,IAAgB,EAAA;AACtC,IAAA,MAAM,EAAE,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC;IAC1C,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE;;AAEtC,IAAA,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;AACxB,IAAA,MAAM,MAAM,CAAC,KAAK,EAAE;AACpB,IAAA,MAAM,GAAG,GAAG,MAAM,IAAI,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;IACzD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;AACxC;AAEA,SAAS,MAAM,CAAC,CAAM,EAAA;AAClB,IAAA,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD;AAEA,SAAS,MAAM,CAAC,CAAS,EAAA;AACrB,IAAA,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD;AAEA;AACA;AACA;MACa,WAAW,CAAA;AAIpB,IAAA,WAAA,CAAY,GAAiB,EAAA;QAHrB,IAAA,CAAA,SAAS,GAAgC,IAAI;QAIjD,IAAI,CAAC,MAAM,GAAG;AACV,YAAA,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,UAAU;AACjC,YAAA,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,CAAC;AAC1B,YAAA,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,OAAO;YACpC,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,GAAG,IAAI,GAAG,IAAI;AAC1C,YAAA,oBAAoB,EAAE,GAAG,EAAE,oBAAoB,IAAI,EAAE,GAAG,IAAI;AAC5D,YAAA,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,EAAE;SAClC;IACL;;;;AAKQ,IAAA,MAAM,KAAK,GAAA;QACf,IAAI,CAAC,QAAQ,EAAE;AAAE,YAAA,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC;AAEzD,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACjB,IAAI,CAAC,SAAS,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;AAC7C,gBAAA,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CACtB,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,IAAI,CAAC,MAAM,CAAC,OAAO,CACtB;AAED,gBAAA,GAAG,CAAC,eAAe,GAAG,MAAK;AACvB,oBAAA,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM;AACrB,oBAAA,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;wBACtD,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;oBAC/C;AACJ,gBAAA,CAAC;AAED,gBAAA,GAAG,CAAC,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;AACzC,gBAAA,GAAG,CAAC,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;AACzC,YAAA,CAAC,CAAC;QACN;QAEA,OAAO,IAAI,CAAC,SAAS;IACzB;AAEQ,IAAA,MAAM,EAAE,CACZ,IAAwB,EACxB,EAAgD,EAAA;AAEhD,QAAA,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE;AAC7B,QAAA,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC;AACtD,QAAA,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QAEnD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;AACnC,YAAA,IAAI,MAAW;AAEf,YAAA,IAAI;AACA,gBAAA,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC;AACrB,gBAAA,IAAI,GAAG;AAAE,oBAAA,GAAG,CAAC,SAAS,GAAG,OAAO,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;YACxD;YAAE,OAAO,CAAC,EAAE;gBACR,MAAM,CAAC,CAAC,CAAC;YACb;YAEA,EAAE,CAAC,UAAU,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;AACrC,YAAA,EAAE,CAAC,OAAO,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC;AACvC,QAAA,CAAC,CAAC;IACN;;;;AAKQ,IAAA,CAAC,CAAC,GAAW,EAAA;AACjB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC;cACb,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAA,CAAA,EAAI,GAAG,CAAA;cAC/B,GAAG;IACb;IAEQ,MAAM,MAAM,CAAC,GAAW,EAAA;QAC5B,OAAO,IAAI,CAAC,EAAE,CAAa,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE;AAEQ,IAAA,MAAM,MAAM,CAAC,GAAW,EAAE,GAAe,EAAA;QAC7C,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D;IAEQ,MAAM,SAAS,CAAC,GAAW,EAAA;QAC/B,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D;;;;AAKQ,IAAA,MAAM,KAAK,GAAA;AACf,QAAA,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE;AAC7B,QAAA,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC;AAC5D,QAAA,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QAEnD,MAAM,OAAO,GAAU,EAAE;AAEzB,QAAA,MAAM,IAAI,OAAO,CAAO,GAAG,IAAG;YAC1B,KAAK,CAAC,UAAU,EAAE,CAAC,SAAS,GAAG,CAAC,CAAM,KAAI;AACtC,gBAAA,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM;AACzB,gBAAA,IAAI,CAAC,CAAC;oBAAE,OAAO,GAAG,EAAE;gBAEpB,OAAO,CAAC,IAAI,CAAC;oBACT,GAAG,EAAE,CAAC,CAAC,GAAG;AACV,oBAAA,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;AAClB,oBAAA,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY;AAC7B,iBAAA,CAAC;gBAEF,CAAC,CAAC,QAAQ,EAAE;AAChB,YAAA,CAAC;AACL,QAAA,CAAC,CAAC;QAEF,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAEnD,QAAA,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE;AAElC,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;AAEvC,QAAA,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;AACrB,YAAA,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE;YAClC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;AAC3B,YAAA,KAAK,IAAI,CAAC,CAAC,IAAI;QACnB;IACJ;;;;AAKA,IAAA,MAAM,GAAG,CACL,GAAW,EACX,KAAQ,EACR,GAAqB,EAAA;QAErB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAElC,IAAI,KAAK,GAAwB,IAAI;QACrC,IAAI,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAChC,IAAI,UAAU,GAAG,KAAK;QAEtB,IACI,GAAG,EAAE,aAAa;AAClB,YAAA,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,EACzC;AACE,YAAA,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;AAC5B,YAAA,IAAI,GAAG,KAAK,CAAC,UAAU;YACvB,UAAU,GAAG,IAAI;QACrB;AAAO,aAAA,IAAI,GAAG,EAAE,MAAM,EAAE;AACpB,YAAA,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACrB,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACjC;AAEA,QAAA,MAAM,KAAK,GAAe;AACtB,YAAA,KAAK,EAAE,KAAK;AACZ,YAAA,SAAS,EAAE,GAAG,EAAE,MAAM,IAAI,KAAK;AAC/B,YAAA,YAAY,EAAE,UAAU;AACxB,YAAA,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;AACrB,YAAA,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,SAAS,EAAE,GAAG,EAAE;kBACV,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC;AACnB,kBAAE,SAAS;YACf,IAAI;SACP;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC;AAC7B,QAAA,MAAM,IAAI,CAAC,KAAK,EAAE;IACtB;AAEA,IAAA,MAAM,GAAG,CACL,GAAW,EACX,GAAwB,EAAA;QAExB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;AACpC,QAAA,IAAI,CAAC,KAAK;AAAE,YAAA,OAAO,IAAI;AAEvB,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACtB,MAAM,OAAO,GACT,KAAK,CAAC,SAAS,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS;AAE5C,QAAA,IAAI,CAAC,OAAO;AACR,YAAA,KAAK,CAAC,YAAY,GAAG,GAAG;QAE5B,IAAI,OAAO,IAAI,GAAG,EAAE,oBAAoB,IAAI,GAAG,CAAC,UAAU,EAAE;AACxD,YAAA,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,IACnB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE;gBACb,GAAG,EAAE,GAAG,CAAC,eAAe;AAC3B,aAAA,CAAC,CACL;QACL;AAEA,QAAA,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,oBAAoB,EAAE;AACvC,YAAA,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;AACzB,YAAA,OAAO,IAAI;QACf;AAEA,QAAA,IAAI,CAAC,GAAQ,KAAK,CAAC,KAAK;QAExB,IAAI,KAAK,CAAC,YAAY;AAClB,YAAA,CAAC,GAAG,MAAM,UAAU,CAAC,CAAe,CAAC;QAEzC,IAAI,KAAK,CAAC,SAAS;AACf,YAAA,CAAC,GAAG,MAAM,CAAC,CAAW,CAAC;QAE3B,OAAO,OAAO,CAAC,KAAK;AAChB,cAAE,IAAI,CAAC,KAAK,CAAC,CAAC;cACZ,CAAC;IACX;IAEA,MAAM,MAAM,CAAC,GAAW,EAAA;AACpB,QAAA,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;IAC7B;AAEA,IAAA,MAAM,KAAK,GAAA;AACP,QAAA,MAAM,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IAC9C;AAEA,IAAA,SAAS,CAAC,EAAU,EAAA;QAChB,OAAO,IAAI,WAAW,CAAC;YACnB,GAAG,IAAI,CAAC,MAAM;AACd,YAAA,SAAS,EAAE,EAAE;AAChB,SAAA,CAAC;IACN;AACH;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+type CacheEntry<T = any> = {
+    value: T | string | Uint8Array;
+    isEncoded: boolean;
+    isCompressed: boolean;
+    createdAt: number;
+    lastAccessed: number;
+    expiresAt?: number;
+    size: number;
+};
+type CacheSetOptions = {
+    ttl?: number;
+    encode?: boolean;
+    forceCompress?: boolean;
+};
+type CacheGetOptions<T> = {
+    staleWhileRevalidate?: boolean;
+    revalidate?: () => Promise<T>;
+    ttlOnRevalidate?: number;
+};
+type CacheConfig = {
+    dbName?: string;
+    version?: number;
+    storeName?: string;
+    maxSize?: number;
+    compressionThreshold?: number;
+    namespace?: string;
+};
+declare class CacheEngine {
+    private dbPromise;
+    private readonly config;
+    constructor(cfg?: CacheConfig);
+    private getDB;
+    private tx;
+    private k;
+    private getRaw;
+    private putRaw;
+    private deleteRaw;
+    private evict;
+    set<T>(key: string, value: T, opt?: CacheSetOptions): Promise<void>;
+    get<T>(key: string, opt?: CacheGetOptions<T>): Promise<T | null>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    namespace(ns: string): CacheEngine;
+}
+
+export { CacheEngine };
+export type { CacheConfig, CacheEntry, CacheGetOptions, CacheSetOptions };

package/dist/index.js

@@ -0,0 +1,209 @@
+// cache-engine.ts
+// ==============================
+// Utils
+// ==============================
+function isClient() {
+    return (typeof window !== "undefined" &&
+        "indexedDB" in window &&
+        "CompressionStream" in window);
+}
+async function compress(data) {
+    const cs = new CompressionStream("gzip");
+    const writer = cs.writable.getWriter();
+    await writer.write(new TextEncoder().encode(data));
+    await writer.close();
+    const out = await new Response(cs.readable).arrayBuffer();
+    return new Uint8Array(out);
+}
+async function decompress(data) {
+    const ds = new DecompressionStream("gzip");
+    const writer = ds.writable.getWriter();
+    // @ts-ignore
+    await writer.write(data);
+    await writer.close();
+    const out = await new Response(ds.readable).arrayBuffer();
+    return new TextDecoder().decode(out);
+}
+function encode(v) {
+    return btoa(encodeURIComponent(JSON.stringify(v)));
+}
+function decode(v) {
+    return JSON.parse(decodeURIComponent(atob(v)));
+}
+// ==============================
+// Cache Engine
+// ==============================
+class CacheEngine {
+    constructor(cfg) {
+        this.dbPromise = null;
+        this.config = {
+            dbName: cfg?.dbName ?? "cache-db",
+            version: cfg?.version ?? 1,
+            storeName: cfg?.storeName ?? "cache",
+            maxSize: cfg?.maxSize ?? 100 * 1024 * 1024,
+            compressionThreshold: cfg?.compressionThreshold ?? 10 * 1024,
+            namespace: cfg?.namespace ?? "",
+        };
+    }
+    // ==============================
+    // DB
+    // ==============================
+    async getDB() {
+        if (!isClient())
+            throw new Error("IndexedDB unsupported");
+        if (!this.dbPromise) {
+            this.dbPromise = new Promise((resolve, reject) => {
+                const req = indexedDB.open(this.config.dbName, this.config.version);
+                req.onupgradeneeded = () => {
+                    const db = req.result;
+                    if (!db.objectStoreNames.contains(this.config.storeName)) {
+                        db.createObjectStore(this.config.storeName);
+                    }
+                };
+                req.onsuccess = () => resolve(req.result);
+                req.onerror = () => reject(req.error);
+            });
+        }
+        return this.dbPromise;
+    }
+    async tx(mode, fn) {
+        const db = await this.getDB();
+        const tx = db.transaction(this.config.storeName, mode);
+        const store = tx.objectStore(this.config.storeName);
+        return new Promise((resolve, reject) => {
+            let result;
+            try {
+                const req = fn(store);
+                if (req)
+                    req.onsuccess = () => (result = req.result);
+            }
+            catch (e) {
+                reject(e);
+            }
+            tx.oncomplete = () => resolve(result);
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    // ==============================
+    // Helpers
+    // ==============================
+    k(key) {
+        return this.config.namespace
+            ? `${this.config.namespace}:${key}`
+            : key;
+    }
+    async getRaw(key) {
+        return this.tx("readonly", s => s.get(this.k(key)));
+    }
+    async putRaw(key, val) {
+        return this.tx("readwrite", s => s.put(val, this.k(key)));
+    }
+    async deleteRaw(key) {
+        return this.tx("readwrite", s => s.delete(this.k(key)));
+    }
+    // ==============================
+    // Eviction (LRU)
+    // ==============================
+    async evict() {
+        const db = await this.getDB();
+        const tx = db.transaction(this.config.storeName, "readonly");
+        const store = tx.objectStore(this.config.storeName);
+        const entries = [];
+        await new Promise(res => {
+            store.openCursor().onsuccess = (e) => {
+                const c = e.target.result;
+                if (!c)
+                    return res();
+                entries.push({
+                    key: c.key,
+                    size: c.value.size,
+                    last: c.value.lastAccessed,
+                });
+                c.continue();
+            };
+        });
+        let total = entries.reduce((s, e) => s + e.size, 0);
+        if (total <= this.config.maxSize)
+            return;
+        entries.sort((a, b) => a.last - b.last);
+        for (const e of entries) {
+            if (total <= this.config.maxSize)
+                break;
+            await this.deleteRaw(e.key);
+            total -= e.size;
+        }
+    }
+    // ==============================
+    // Public API
+    // ==============================
+    async set(key, value, opt) {
+        const json = JSON.stringify(value);
+        let final = json;
+        let size = new Blob([json]).size;
+        let compressed = false;
+        if (opt?.forceCompress ||
+            size > this.config.compressionThreshold) {
+            final = await compress(json);
+            size = final.byteLength;
+            compressed = true;
+        }
+        else if (opt?.encode) {
+            final = encode(value);
+            size = new Blob([final]).size;
+        }
+        const entry = {
+            value: final,
+            isEncoded: opt?.encode ?? false,
+            isCompressed: compressed,
+            createdAt: Date.now(),
+            lastAccessed: Date.now(),
+            expiresAt: opt?.ttl
+                ? Date.now() + opt.ttl
+                : undefined,
+            size,
+        };
+        await this.putRaw(key, entry);
+        await this.evict();
+    }
+    async get(key, opt) {
+        const entry = await this.getRaw(key);
+        if (!entry)
+            return null;
+        const now = Date.now();
+        const expired = entry.expiresAt && now > entry.expiresAt;
+        if (!expired)
+            entry.lastAccessed = now;
+        if (expired && opt?.staleWhileRevalidate && opt.revalidate) {
+            opt.revalidate().then(v => this.set(key, v, {
+                ttl: opt.ttlOnRevalidate,
+            }));
+        }
+        if (expired && !opt?.staleWhileRevalidate) {
+            await this.deleteRaw(key);
+            return null;
+        }
+        let v = entry.value;
+        if (entry.isCompressed)
+            v = await decompress(v);
+        if (entry.isEncoded)
+            v = decode(v);
+        return typeof v === "string"
+            ? JSON.parse(v)
+            : v;
+    }
+    async remove(key) {
+        await this.deleteRaw(key);
+    }
+    async clear() {
+        await this.tx("readwrite", s => s.clear());
+    }
+    namespace(ns) {
+        return new CacheEngine({
+            ...this.config,
+            namespace: ns,
+        });
+    }
+}
+
+export { CacheEngine };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/cache-engine.ts"],"sourcesContent":["// cache-engine.ts\r\n\r\n// ==============================\r\n// Types\r\n// ==============================\r\nexport type CacheEntry<T = any> = {\r\n    value: T | string | Uint8Array;\r\n    isEncoded: boolean;\r\n    isCompressed: boolean;\r\n    createdAt: number;\r\n    lastAccessed: number;\r\n    expiresAt?: number;\r\n    size: number;\r\n};\r\n\r\nexport type CacheSetOptions = {\r\n    ttl?: number;\r\n    encode?: boolean;\r\n    forceCompress?: boolean;\r\n};\r\n\r\nexport type CacheGetOptions<T> = {\r\n    staleWhileRevalidate?: boolean;\r\n    revalidate?: () => Promise<T>;\r\n    ttlOnRevalidate?: number;\r\n};\r\n\r\nexport type CacheConfig = {\r\n    dbName?: string;\r\n    version?: number;\r\n    storeName?: string;\r\n    maxSize?: number;\r\n    compressionThreshold?: number;\r\n    namespace?: string;\r\n};\r\n\r\n// ==============================\r\n// Utils\r\n// ==============================\r\nfunction isClient() {\r\n    return (\r\n        typeof window !== \"undefined\" &&\r\n        \"indexedDB\" in window &&\r\n        \"CompressionStream\" in window\r\n    );\r\n}\r\n\r\nasync function compress(data: string): Promise<Uint8Array> {\r\n    const cs = new CompressionStream(\"gzip\");\r\n    const writer = cs.writable.getWriter();\r\n    await writer.write(new TextEncoder().encode(data));\r\n    await writer.close();\r\n    const out = await new Response(cs.readable).arrayBuffer();\r\n    return new Uint8Array(out);\r\n}\r\n\r\nasync function decompress(data: Uint8Array): Promise<string> {\r\n    const ds = new DecompressionStream(\"gzip\");\r\n    const writer = ds.writable.getWriter();\r\n    // @ts-ignore\r\n    await writer.write(data);\r\n    await writer.close();\r\n    const out = await new Response(ds.readable).arrayBuffer();\r\n    return new TextDecoder().decode(out);\r\n}\r\n\r\nfunction encode(v: any) {\r\n    return btoa(encodeURIComponent(JSON.stringify(v)));\r\n}\r\n\r\nfunction decode(v: string) {\r\n    return JSON.parse(decodeURIComponent(atob(v)));\r\n}\r\n\r\n// ==============================\r\n// Cache Engine\r\n// ==============================\r\nexport class CacheEngine {\r\n    private dbPromise: Promise<IDBDatabase> | null = null;\r\n    private readonly config: Required<CacheConfig>;\r\n\r\n    constructor(cfg?: CacheConfig) {\r\n        this.config = {\r\n            dbName: cfg?.dbName ?? \"cache-db\",\r\n            version: cfg?.version ?? 1,\r\n            storeName: cfg?.storeName ?? \"cache\",\r\n            maxSize: cfg?.maxSize ?? 100 * 1024 * 1024,\r\n            compressionThreshold: cfg?.compressionThreshold ?? 10 * 1024,\r\n            namespace: cfg?.namespace ?? \"\",\r\n        };\r\n    }\r\n\r\n    // ==============================\r\n    // DB\r\n    // ==============================\r\n    private async getDB(): Promise<IDBDatabase> {\r\n        if (!isClient()) throw new Error(\"IndexedDB unsupported\");\r\n\r\n        if (!this.dbPromise) {\r\n            this.dbPromise = new Promise((resolve, reject) => {\r\n                const req = indexedDB.open(\r\n                    this.config.dbName,\r\n                    this.config.version\r\n                );\r\n\r\n                req.onupgradeneeded = () => {\r\n                    const db = req.result;\r\n                    if (!db.objectStoreNames.contains(this.config.storeName)) {\r\n                        db.createObjectStore(this.config.storeName);\r\n                    }\r\n                };\r\n\r\n                req.onsuccess = () => resolve(req.result);\r\n                req.onerror = () => reject(req.error);\r\n            });\r\n        }\r\n\r\n        return this.dbPromise;\r\n    }\r\n\r\n    private async tx<T>(\r\n        mode: IDBTransactionMode,\r\n        fn: (store: IDBObjectStore) => IDBRequest | void\r\n    ): Promise<T> {\r\n        const db = await this.getDB();\r\n        const tx = db.transaction(this.config.storeName, mode);\r\n        const store = tx.objectStore(this.config.storeName);\r\n\r\n        return new Promise((resolve, reject) => {\r\n            let result: any;\r\n\r\n            try {\r\n                const req = fn(store);\r\n                if (req) req.onsuccess = () => (result = req.result);\r\n            } catch (e) {\r\n                reject(e);\r\n            }\r\n\r\n            tx.oncomplete = () => resolve(result);\r\n            tx.onerror = () => reject(tx.error);\r\n        });\r\n    }\r\n\r\n    // ==============================\r\n    // Helpers\r\n    // ==============================\r\n    private k(key: string) {\r\n        return this.config.namespace\r\n            ? `${this.config.namespace}:${key}`\r\n            : key;\r\n    }\r\n\r\n    private async getRaw(key: string) {\r\n        return this.tx<CacheEntry>(\"readonly\", s => s.get(this.k(key)));\r\n    }\r\n\r\n    private async putRaw(key: string, val: CacheEntry) {\r\n        return this.tx(\"readwrite\", s => s.put(val, this.k(key)));\r\n    }\r\n\r\n    private async deleteRaw(key: string) {\r\n        return this.tx(\"readwrite\", s => s.delete(this.k(key)));\r\n    }\r\n\r\n    // ==============================\r\n    // Eviction (LRU)\r\n    // ==============================\r\n    private async evict() {\r\n        const db = await this.getDB();\r\n        const tx = db.transaction(this.config.storeName, \"readonly\");\r\n        const store = tx.objectStore(this.config.storeName);\r\n\r\n        const entries: any[] = [];\r\n\r\n        await new Promise<void>(res => {\r\n            store.openCursor().onsuccess = (e: any) => {\r\n                const c = e.target.result;\r\n                if (!c) return res();\r\n\r\n                entries.push({\r\n                    key: c.key,\r\n                    size: c.value.size,\r\n                    last: c.value.lastAccessed,\r\n                });\r\n\r\n                c.continue();\r\n            };\r\n        });\r\n\r\n        let total = entries.reduce((s, e) => s + e.size, 0);\r\n\r\n        if (total <= this.config.maxSize) return;\r\n\r\n        entries.sort((a, b) => a.last - b.last);\r\n\r\n        for (const e of entries) {\r\n            if (total <= this.config.maxSize) break;\r\n            await this.deleteRaw(e.key);\r\n            total -= e.size;\r\n        }\r\n    }\r\n\r\n    // ==============================\r\n    // Public API\r\n    // ==============================\r\n    async set<T>(\r\n        key: string,\r\n        value: T,\r\n        opt?: CacheSetOptions\r\n    ) {\r\n        const json = JSON.stringify(value);\r\n\r\n        let final: string | Uint8Array = json;\r\n        let size = new Blob([json]).size;\r\n        let compressed = false;\r\n\r\n        if (\r\n            opt?.forceCompress ||\r\n            size > this.config.compressionThreshold\r\n        ) {\r\n            final = await compress(json);\r\n            size = final.byteLength;\r\n            compressed = true;\r\n        } else if (opt?.encode) {\r\n            final = encode(value);\r\n            size = new Blob([final]).size;\r\n        }\r\n\r\n        const entry: CacheEntry = {\r\n            value: final,\r\n            isEncoded: opt?.encode ?? false,\r\n            isCompressed: compressed,\r\n            createdAt: Date.now(),\r\n            lastAccessed: Date.now(),\r\n            expiresAt: opt?.ttl\r\n                ? Date.now() + opt.ttl\r\n                : undefined,\r\n            size,\r\n        };\r\n\r\n        await this.putRaw(key, entry);\r\n        await this.evict();\r\n    }\r\n\r\n    async get<T>(\r\n        key: string,\r\n        opt?: CacheGetOptions<T>\r\n    ): Promise<T | null> {\r\n        const entry = await this.getRaw(key);\r\n        if (!entry) return null;\r\n\r\n        const now = Date.now();\r\n        const expired =\r\n            entry.expiresAt && now > entry.expiresAt;\r\n\r\n        if (!expired)\r\n            entry.lastAccessed = now;\r\n\r\n        if (expired && opt?.staleWhileRevalidate && opt.revalidate) {\r\n            opt.revalidate().then(v =>\r\n                this.set(key, v, {\r\n                    ttl: opt.ttlOnRevalidate,\r\n                })\r\n            );\r\n        }\r\n\r\n        if (expired && !opt?.staleWhileRevalidate) {\r\n            await this.deleteRaw(key);\r\n            return null;\r\n        }\r\n\r\n        let v: any = entry.value;\r\n\r\n        if (entry.isCompressed)\r\n            v = await decompress(v as Uint8Array);\r\n\r\n        if (entry.isEncoded)\r\n            v = decode(v as string);\r\n\r\n        return typeof v === \"string\"\r\n            ? JSON.parse(v)\r\n            : v;\r\n    }\r\n\r\n    async remove(key: string) {\r\n        await this.deleteRaw(key);\r\n    }\r\n\r\n    async clear() {\r\n        await this.tx(\"readwrite\", s => s.clear());\r\n    }\r\n\r\n    namespace(ns: string) {\r\n        return new CacheEngine({\r\n            ...this.config,\r\n            namespace: ns,\r\n        });\r\n    }\r\n}\r\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "cache-craft-engine",
+  "version": "0.1.0",
+  "description": "A lightweight, fully client-side IndexedDB cache engine with compression, encoding, LRU eviction, TTL and stale-while-revalidate support",
+  "author": "Mohammad Javad <your-email@example.com>",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && rollup -c",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": [
+    "cache",
+    "indexeddb",
+    "client-side",
+    "offline",
+    "compression",
+    "lru",
+    "stale-while-revalidate"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MJavadSF/CacheCraft.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MJavadSF/CacheCraft/issues"
+  },
+  "homepage": "https://github.com/MJavadSF/CacheCraft#readme",
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^12.3.0",
+    "rollup": "^4.57.1",
+    "rollup-plugin-dts": "^6.3.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3"
+  }
+}