@notkannan/cache-with-persistence 1.0.0

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2026, Kannan Karthikeyan
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @notkannan/cache-with-persistence
+
+Redis-inspired in-memory key-value store with append-only file persistence.
+
+## Install
+
+```bash
+npm install @notkannan/cache-with-persistence
+```
+
+## Usage
+
+```ts
+import { Store } from '@notkannan/cache-with-persistence';
+
+const store = new Store('./data');
+
+store.set('user:1', 'alice');
+store.set('session', 'abc', 3600); // expires in 1 hour
+
+store.get('user:1');    // 'alice'
+store.del('user:1');    // true
+store.exists('user:1'); // false
+store.ttl('session');   // remaining ms, -1 if no expiry, -2 if missing
+```
+
+Operations are written to a WAL (`store.aof`) and replayed on startup.
+
+## API
+
+| Method | Description |
+|--------|-------------|
+| `new Store(dataDir?)` | Create store; defaults to `./data` |
+| `set(key, value, ttlSeconds?)` | Set a key, optional TTL |
+| `get(key)` | Get value, or `null` if missing/expired |
+| `del(key)` | Delete key; returns `true` if it existed |
+| `exists(key)` | Check if key exists |
+| `ttl(key)` | Remaining ms, `-1` (no expiry), or `-2` (missing) |
+
+## License
+
+ISC

package/dist/HashMap.d.ts

@@ -0,0 +1,14 @@
+export declare class HashMap<V> {
+    private buckets;
+    private size;
+    private capacity;
+    constructor(capacity?: number);
+    private hash;
+    set(key: string, value: V): void;
+    get(key: string): V | undefined;
+    delete(key: string): boolean;
+    has(key: string): boolean;
+    getSize(): number;
+    debug(): void;
+}
+//# sourceMappingURL=HashMap.d.ts.map

package/dist/HashMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HashMap.d.ts","sourceRoot":"","sources":["../src/HashMap.ts"],"names":[],"mappings":"AAOA,qBAAa,OAAO,CAAC,CAAC;IAClB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,SAAK;IAOzB,OAAO,CAAC,IAAI;IAKZ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAyBhC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAa/B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAuB5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,OAAO,IAAI,MAAM;IAKjB,KAAK,IAAI,IAAI;CAUhB"}

package/dist/HashMap.js

@@ -0,0 +1,90 @@
+export class HashMap {
+    buckets;
+    size; // how many key/value pairs are stored
+    capacity; // number of buckets in the HashMap
+    constructor(capacity = 16) {
+        this.capacity = capacity;
+        this.size = 0;
+        this.buckets = new Array(capacity).fill(null);
+    }
+    // Hash function
+    hash(key) {
+        return 1;
+    }
+    // Set function
+    set(key, value) {
+        const index = this.hash(key); // get the index by hashing to the bucket array
+        let entry = this.buckets[index] ?? null;
+        while (entry !== null) {
+            if (entry.key === key) {
+                entry.value = value;
+                return;
+            }
+            entry = entry.next;
+        }
+        // Key not found — prepend a new entry at the head of the chain
+        // (prepending is O(1); appending would require walking to the end)
+        const newEntry = {
+            key,
+            value,
+            next: this.buckets[index] ?? null, // new entry points to the old head
+        };
+        this.buckets[index] = newEntry; // new entry becomes the new head
+        this.size++;
+    }
+    // get function
+    get(key) {
+        const index = this.hash(key);
+        let entry = this.buckets[index] ?? null;
+        // Walk the chain until we find the key or run out
+        while (entry !== null) {
+            if (entry.key === key)
+                return entry.value;
+            entry = entry.next;
+        }
+        return undefined; // key doesn't exist
+    }
+    delete(key) {
+        const index = this.hash(key);
+        let entry = this.buckets[index] ?? null;
+        let prev = null;
+        while (entry !== null) {
+            if (entry.key === key) {
+                // Stitch the chain back together, skipping this entry
+                if (prev === null) {
+                    this.buckets[index] = entry.next; // it was the head
+                }
+                else {
+                    prev.next = entry.next; // bypass this node
+                }
+                this.size--;
+                return true;
+            }
+            prev = entry;
+            entry = entry.next;
+        }
+        return false; // not found
+    }
+    // HELPER FUNCTION
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    getSize() {
+        return this.size;
+    }
+    // For debugging — lets you see the raw bucket structure
+    debug() {
+        this.buckets.forEach((entry, i) => {
+            if (entry === null)
+                return;
+            const chain = [];
+            let e = entry;
+            while (e) {
+                chain.push(`${e.key}:${e.value}`);
+                e = e.next;
+            }
+            console.log(`bucket[${i}] → ${chain.join(' → ')}`);
+        });
+    }
+}
+//# sourceMappingURL=HashMap.js.map

package/dist/HashMap.js.map

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

package/dist/Store.d.ts

@@ -0,0 +1,12 @@
+export declare class Store {
+    private map;
+    private wal;
+    constructor(dataDir?: string);
+    private recover;
+    set(key: string, value: string, ttlSeconds?: number): void;
+    get(key: string): string | null;
+    del(key: string): boolean;
+    exists(key: string): boolean;
+    ttl(key: string): number;
+}
+//# sourceMappingURL=Store.d.ts.map

package/dist/Store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../src/Store.ts"],"names":[],"mappings":"AASA,qBAAa,KAAK;IAChB,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,GAAG,CAAM;gBAEL,OAAO,GAAE,MAAgB;IAQrC,OAAO,CAAC,OAAO;IAqBf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAkB1D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAc/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAOzB"}

package/dist/Store.js

@@ -0,0 +1,76 @@
+import * as fs from 'fs';
+import { HashMap } from './HashMap.js';
+import { WAL } from './WAL.js';
+export class Store {
+    map;
+    wal;
+    constructor(dataDir = './data') {
+        this.map = new HashMap();
+        this.wal = new WAL(dataDir);
+        this.recover();
+    }
+    recover() {
+        const entries = this.wal.readAll();
+        if (entries.length === 0)
+            return; // clean WAL file
+        for (const entry of entries) {
+            if (entry.op === 'SET') {
+                const expiresAt = entry.ttlSeconds
+                    ? entry.timestamp + entry.ttlSeconds * 1000
+                    : null;
+                if (expiresAt !== null && Date.now() > expiresAt)
+                    continue;
+                this.map.set(entry.key, { value: entry.value, expiresAt });
+            }
+            else if (entry.op === 'DEL') {
+                this.map.delete(entry.key);
+            }
+        }
+    }
+    // SET key value [EX seconds]
+    set(key, value, ttlSeconds) {
+        this.wal.append({
+            op: 'SET',
+            key,
+            value,
+            timestamp: Date.now(),
+            ...(ttlSeconds !== undefined && { ttlSeconds })
+        });
+        const expiresAt = ttlSeconds
+            ? Date.now() + ttlSeconds * 1000
+            : null;
+        this.map.set(key, { value, expiresAt });
+    }
+    // GET key → returns the value, or null if missing/expired
+    get(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return null;
+        // Lazy expiry — we check on read, not on a background timer
+        if (entry.expiresAt !== null && Date.now() > entry.expiresAt) {
+            this.map.delete(key); // clean up expired key
+            return null;
+        }
+        return entry.value;
+    }
+    // DEL key → returns true if deleted, false if key didn't exist
+    del(key) {
+        this.wal.append({ op: 'DEL', key, timestamp: Date.now() });
+        return this.map.delete(key);
+    }
+    // EXISTS key
+    exists(key) {
+        return this.get(key) !== null; // reuses expiry logic from get()
+    }
+    // TTL key → remaining milliseconds, -1 if no expiry, -2 if not found
+    ttl(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return -2;
+        if (entry.expiresAt === null)
+            return -1;
+        const remaining = entry.expiresAt - Date.now();
+        return remaining > 0 ? remaining : -2;
+    }
+}
+//# sourceMappingURL=Store.js.map

package/dist/Store.js.map

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

package/dist/WAL.d.ts

@@ -0,0 +1,14 @@
+export interface WALEntry {
+    op: 'SET' | 'DEL';
+    key: string;
+    value?: string;
+    ttlSeconds?: number;
+    timestamp: number;
+}
+export declare class WAL {
+    private filePath;
+    constructor(dataDir: string);
+    append(entry: WALEntry): void;
+    readAll(): WALEntry[];
+}
+//# sourceMappingURL=WAL.d.ts.map

package/dist/WAL.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WAL.d.ts","sourceRoot":"","sources":["../src/WAL.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,GAAG;IACZ,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,MAAM;IAK3B,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAK7B,OAAO,IAAI,QAAQ,EAAE;CAiBxB"}

package/dist/WAL.js

@@ -0,0 +1,31 @@
+import * as fs from 'fs';
+import * as path from 'path';
+export class WAL {
+    filePath;
+    constructor(dataDir) {
+        fs.mkdirSync(dataDir, { recursive: true });
+        this.filePath = path.join(dataDir, 'store.aof');
+    }
+    append(entry) {
+        const line = JSON.stringify(entry) + '\n';
+        fs.appendFileSync(this.filePath, line, 'utf8');
+    }
+    readAll() {
+        if (!fs.existsSync(this.filePath))
+            return [];
+        const raw = fs.readFileSync(this.filePath, 'utf8');
+        const entries = [];
+        for (const line of raw.split('\n')) {
+            if (!line.trim())
+                continue; // skip blank lines
+            try {
+                entries.push(JSON.parse(line));
+            }
+            catch {
+                console.warn('[WAL] Skipping malformed line:', line);
+            }
+        }
+        return entries;
+    }
+}
+//# sourceMappingURL=WAL.js.map

package/dist/WAL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WAL.js","sourceRoot":"","sources":["../src/WAL.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAU7B,MAAM,OAAO,GAAG;IACJ,QAAQ,CAAS;IAEzB,YAAY,OAAe;QACvB,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,KAAe;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAC1C,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,OAAO;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAE7C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,OAAO,GAAe,EAAE,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS,CAAC,mBAAmB;YAC/C,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,gCAAgC,EAAE,IAAI,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { Store } from './Store.js';
+export { WAL, type WALEntry } from './WAL.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,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Store } from './Store.js';
+export { WAL } from './WAL.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,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAiB,MAAM,UAAU,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@notkannan/cache-with-persistence",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "A Redis-inspired in-memory key-value store with persistence",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/notkannan/cache-with-persistence.git"
+  },
+  "author": "Kannan Karthikeyan",
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["redis", "in-memory", "key-value", "store", "wal", "persistence"],
+  "license": "ISC",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3",
+    "typescript": "^6.0.3"
+  }
+}