@monlite/kv 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emad Jumaah
+
+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,55 @@
+# @monlite/kv
+
+A **Redis-like key-value cache** for [`@monlite/core`](https://www.npmjs.com/package/@monlite/core), backed by SQLite. Synchronous `get/set/incr` with TTLs — part of the [local AI-agent harness](https://github.com/qataruts/monlite#readme) (cache + queue + cron, replacing Redis locally).
+
+```bash
+npm install @monlite/core @monlite/kv
+```
+
+## Quick start
+
+```ts
+import { createDb } from "@monlite/core";
+import { kv } from "@monlite/kv";
+
+const db = createDb("app.db");
+const cache = kv(db);
+
+cache.set("session:42", { user: "ali" }, { ttl: 60_000 }); // expires in 60s
+cache.get("session:42"); // { user: "ali" }  — synchronous, no await
+cache.incr("hits"); // 1
+cache.incr("hits", 5); // 6
+cache.ttl("session:42"); // ~60000 (ms remaining)
+```
+
+It's **synchronous** (local SQLite — no network, no await), **durable** (survives
+restarts), and persisted in your app's database. Use a separate `:memory:` db if
+you want a purely ephemeral cache.
+
+## API
+
+| Method | Description |
+| --- | --- |
+| `get(key)` | Value, or `undefined` (also if expired). |
+| `set(key, value, { ttl })` | Store any JSON value; `ttl` in ms (optional). |
+| `has(key)` / `delete(key)` | Existence / removal. |
+| `incr(key, by?)` / `decr(key, by?)` | Atomic numeric update; returns the new value. |
+| `mget(keys)` | Array of values (`undefined` per missing key). |
+| `keys(prefix?)` | Live keys in the namespace, optionally by prefix. |
+| `expire(key, ttl)` | Set/refresh TTL (ms); `false` if absent. |
+| `ttl(key)` | Remaining ms; `-1` no expiry, `-2` absent (Redis convention). |
+| `size()` / `flush()` | Count / clear the namespace. |
+
+## Options
+
+```ts
+kv(db, {
+  namespace: "sessions", // isolate multiple caches in one db (default "default")
+  sweepIntervalMs: 60_000, // periodically purge expired keys (default: lazy-only)
+});
+```
+
+Expired keys are removed lazily on read; set `sweepIntervalMs` to also purge them
+on a timer. Call `cache.stop()` to clear the sweep timer.
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,114 @@
+'use strict';
+
+// src/index.ts
+var ensured = /* @__PURE__ */ new WeakSet();
+function kv(db, options = {}) {
+  const ns = options.namespace ?? "default";
+  const driver = db.driver;
+  if (!ensured.has(db)) {
+    driver.exec(
+      `CREATE TABLE IF NOT EXISTS _kv (
+        ns TEXT NOT NULL, k TEXT NOT NULL, v TEXT NOT NULL,
+        expires_at INTEGER, PRIMARY KEY (ns, k)
+      )`
+    );
+    ensured.add(db);
+  }
+  const now = () => Date.now();
+  const fresh = (row) => !!row && !(row.expires_at != null && row.expires_at <= now());
+  const getRow = (key) => driver.prepare(`SELECT v, expires_at FROM _kv WHERE ns = ? AND k = ?`).get(ns, key);
+  const del = (key) => driver.prepare(`DELETE FROM _kv WHERE ns = ? AND k = ?`).run(ns, key).changes > 0;
+  const setRaw = (key, v, expires) => driver.prepare(
+    `INSERT INTO _kv (ns, k, v, expires_at) VALUES (?, ?, ?, ?)
+         ON CONFLICT(ns, k) DO UPDATE SET v = excluded.v, expires_at = excluded.expires_at`
+  ).run(ns, key, v, expires);
+  let timer;
+  const api = {
+    get(key) {
+      const row = getRow(key);
+      if (!fresh(row)) {
+        if (row) del(key);
+        return void 0;
+      }
+      return JSON.parse(row.v);
+    },
+    set(key, value, opts) {
+      const expires = opts?.ttl != null ? now() + opts.ttl : null;
+      setRaw(key, JSON.stringify(value), expires);
+    },
+    has(key) {
+      return api.get(key) !== void 0;
+    },
+    delete(key) {
+      return del(key);
+    },
+    incr(key, by = 1) {
+      return driver.transaction(() => {
+        const row = getRow(key);
+        let n = 0;
+        let expires = null;
+        if (fresh(row)) {
+          const cur = JSON.parse(row.v);
+          if (typeof cur !== "number") {
+            throw new Error(`kv.incr: value at "${key}" is not a number`);
+          }
+          n = cur;
+          expires = row.expires_at;
+        }
+        const next = n + by;
+        setRaw(key, JSON.stringify(next), expires);
+        return next;
+      });
+    },
+    decr(key, by = 1) {
+      return api.incr(key, -by);
+    },
+    mget(keys) {
+      return keys.map((k) => api.get(k));
+    },
+    keys(prefix) {
+      const t = now();
+      const rows = prefix !== void 0 ? driver.prepare(
+        `SELECT k, expires_at FROM _kv WHERE ns = ? AND k LIKE ? ESCAPE '\\'`
+      ).all(ns, prefix.replace(/[%_\\]/g, "\\$&") + "%") : driver.prepare(`SELECT k, expires_at FROM _kv WHERE ns = ?`).all(ns);
+      return rows.filter((r) => r.expires_at == null || r.expires_at > t).map((r) => r.k);
+    },
+    expire(key, ttl) {
+      const row = getRow(key);
+      if (!fresh(row)) return false;
+      driver.prepare(`UPDATE _kv SET expires_at = ? WHERE ns = ? AND k = ?`).run(now() + ttl, ns, key);
+      return true;
+    },
+    ttl(key) {
+      const row = getRow(key);
+      if (!fresh(row)) return -2;
+      if (row.expires_at == null) return -1;
+      return row.expires_at - now();
+    },
+    flush() {
+      driver.prepare(`DELETE FROM _kv WHERE ns = ?`).run(ns);
+    },
+    size() {
+      return driver.prepare(
+        `SELECT COUNT(*) AS n FROM _kv WHERE ns = ? AND (expires_at IS NULL OR expires_at > ?)`
+      ).get(ns, now()).n;
+    },
+    stop() {
+      if (timer) clearInterval(timer);
+      timer = void 0;
+    }
+  };
+  if (options.sweepIntervalMs && options.sweepIntervalMs > 0) {
+    timer = setInterval(() => {
+      driver.prepare(
+        `DELETE FROM _kv WHERE expires_at IS NOT NULL AND expires_at <= ?`
+      ).run(now());
+    }, options.sweepIntervalMs);
+    timer.unref?.();
+  }
+  return api;
+}
+
+exports.kv = kv;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Monlite } from \"@monlite/core\";\n\nexport interface KVOptions {\n  /** Logical namespace so multiple caches can share one database. Default \"default\". */\n  namespace?: string;\n  /** If set, a timer periodically purges expired keys (ms). Default: lazy-only. */\n  sweepIntervalMs?: number;\n}\n\n/**\n * A synchronous, Redis-like key-value cache backed by SQLite. Values are any\n * JSON-serializable data; TTLs are in milliseconds.\n */\nexport interface KV {\n  get<T = any>(key: string): T | undefined;\n  set(key: string, value: any, opts?: { ttl?: number }): void;\n  has(key: string): boolean;\n  delete(key: string): boolean;\n  /** Atomically add `by` (default 1) to a numeric key; returns the new value. */\n  incr(key: string, by?: number): number;\n  decr(key: string, by?: number): number;\n  mget<T = any>(keys: string[]): (T | undefined)[];\n  /** Keys in this namespace (optionally by prefix), excluding expired ones. */\n  keys(prefix?: string): string[];\n  /** Set/refresh a key's TTL (ms). Returns false if the key is absent. */\n  expire(key: string, ttl: number): boolean;\n  /** Remaining TTL in ms; `-1` if no expiry, `-2` if absent (Redis convention). */\n  ttl(key: string): number;\n  /** Delete all keys in this namespace. */\n  flush(): void;\n  /** Number of live keys in this namespace. */\n  size(): number;\n  /** Stop the sweep timer (if any). */\n  stop(): void;\n}\n\nconst ensured = new WeakSet<object>();\n\n/**\n * Create a cache over a monlite database.\n *\n * ```ts\n * const cache = kv(db);\n * cache.set(\"session:42\", { user: \"ali\" }, { ttl: 60_000 });\n * cache.get(\"session:42\"); // { user: \"ali\" }  (synchronous)\n * ```\n */\nexport function kv(db: Monlite, options: KVOptions = {}): KV {\n  const ns = options.namespace ?? \"default\";\n  const driver = db.driver;\n\n  if (!ensured.has(db)) {\n    driver.exec(\n      `CREATE TABLE IF NOT EXISTS _kv (\n        ns TEXT NOT NULL, k TEXT NOT NULL, v TEXT NOT NULL,\n        expires_at INTEGER, PRIMARY KEY (ns, k)\n      )`,\n    );\n    ensured.add(db);\n  }\n\n  const now = () => Date.now();\n  const fresh = (row: any): boolean =>\n    !!row && !(row.expires_at != null && row.expires_at <= now());\n\n  const getRow = (key: string) =>\n    driver\n      .prepare(`SELECT v, expires_at FROM _kv WHERE ns = ? AND k = ?`)\n      .get(ns, key) as { v: string; expires_at: number | null } | undefined;\n\n  const del = (key: string): boolean =>\n    driver.prepare(`DELETE FROM _kv WHERE ns = ? AND k = ?`).run(ns, key)\n      .changes > 0;\n\n  const setRaw = (key: string, v: string, expires: number | null) =>\n    driver\n      .prepare(\n        `INSERT INTO _kv (ns, k, v, expires_at) VALUES (?, ?, ?, ?)\n         ON CONFLICT(ns, k) DO UPDATE SET v = excluded.v, expires_at = excluded.expires_at`,\n      )\n      .run(ns, key, v, expires);\n\n  let timer: ReturnType<typeof setInterval> | undefined;\n\n  const api: KV = {\n    get(key) {\n      const row = getRow(key);\n      if (!fresh(row)) {\n        if (row) del(key);\n        return undefined;\n      }\n      return JSON.parse(row!.v);\n    },\n    set(key, value, opts) {\n      const expires = opts?.ttl != null ? now() + opts.ttl : null;\n      setRaw(key, JSON.stringify(value), expires);\n    },\n    has(key) {\n      return api.get(key) !== undefined;\n    },\n    delete(key) {\n      return del(key);\n    },\n    incr(key, by = 1) {\n      return driver.transaction(() => {\n        const row = getRow(key);\n        let n = 0;\n        let expires: number | null = null;\n        if (fresh(row)) {\n          const cur = JSON.parse(row!.v);\n          if (typeof cur !== \"number\") {\n            throw new Error(`kv.incr: value at \"${key}\" is not a number`);\n          }\n          n = cur;\n          expires = row!.expires_at;\n        }\n        const next = n + by;\n        setRaw(key, JSON.stringify(next), expires);\n        return next;\n      });\n    },\n    decr(key, by = 1) {\n      return api.incr(key, -by);\n    },\n    mget(keys) {\n      return keys.map((k) => api.get(k));\n    },\n    keys(prefix) {\n      const t = now();\n      const rows = (\n        prefix !== undefined\n          ? driver\n              .prepare(\n                `SELECT k, expires_at FROM _kv WHERE ns = ? AND k LIKE ? ESCAPE '\\\\'`,\n              )\n              .all(ns, prefix.replace(/[%_\\\\]/g, \"\\\\$&\") + \"%\")\n          : driver.prepare(`SELECT k, expires_at FROM _kv WHERE ns = ?`).all(ns)\n      ) as Array<{ k: string; expires_at: number | null }>;\n      return rows\n        .filter((r) => r.expires_at == null || r.expires_at > t)\n        .map((r) => r.k);\n    },\n    expire(key, ttl) {\n      const row = getRow(key);\n      if (!fresh(row)) return false;\n      driver\n        .prepare(`UPDATE _kv SET expires_at = ? WHERE ns = ? AND k = ?`)\n        .run(now() + ttl, ns, key);\n      return true;\n    },\n    ttl(key) {\n      const row = getRow(key);\n      if (!fresh(row)) return -2;\n      if (row!.expires_at == null) return -1;\n      return row!.expires_at - now();\n    },\n    flush() {\n      driver.prepare(`DELETE FROM _kv WHERE ns = ?`).run(ns);\n    },\n    size() {\n      return (\n        driver\n          .prepare(\n            `SELECT COUNT(*) AS n FROM _kv WHERE ns = ? AND (expires_at IS NULL OR expires_at > ?)`,\n          )\n          .get(ns, now()) as { n: number }\n      ).n;\n    },\n    stop() {\n      if (timer) clearInterval(timer);\n      timer = undefined;\n    },\n  };\n\n  if (options.sweepIntervalMs && options.sweepIntervalMs > 0) {\n    timer = setInterval(() => {\n      driver\n        .prepare(\n          `DELETE FROM _kv WHERE expires_at IS NOT NULL AND expires_at <= ?`,\n        )\n        .run(now());\n    }, options.sweepIntervalMs);\n    timer.unref?.();\n  }\n\n  return api;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,48 @@
+import { Monlite } from '@monlite/core';
+
+interface KVOptions {
+    /** Logical namespace so multiple caches can share one database. Default "default". */
+    namespace?: string;
+    /** If set, a timer periodically purges expired keys (ms). Default: lazy-only. */
+    sweepIntervalMs?: number;
+}
+/**
+ * A synchronous, Redis-like key-value cache backed by SQLite. Values are any
+ * JSON-serializable data; TTLs are in milliseconds.
+ */
+interface KV {
+    get<T = any>(key: string): T | undefined;
+    set(key: string, value: any, opts?: {
+        ttl?: number;
+    }): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    /** Atomically add `by` (default 1) to a numeric key; returns the new value. */
+    incr(key: string, by?: number): number;
+    decr(key: string, by?: number): number;
+    mget<T = any>(keys: string[]): (T | undefined)[];
+    /** Keys in this namespace (optionally by prefix), excluding expired ones. */
+    keys(prefix?: string): string[];
+    /** Set/refresh a key's TTL (ms). Returns false if the key is absent. */
+    expire(key: string, ttl: number): boolean;
+    /** Remaining TTL in ms; `-1` if no expiry, `-2` if absent (Redis convention). */
+    ttl(key: string): number;
+    /** Delete all keys in this namespace. */
+    flush(): void;
+    /** Number of live keys in this namespace. */
+    size(): number;
+    /** Stop the sweep timer (if any). */
+    stop(): void;
+}
+/**
+ * Create a cache over a monlite database.
+ *
+ * ```ts
+ * const cache = kv(db);
+ * cache.set("session:42", { user: "ali" }, { ttl: 60_000 });
+ * cache.get("session:42"); // { user: "ali" }  (synchronous)
+ * ```
+ */
+declare function kv(db: Monlite, options?: KVOptions): KV;
+
+export { type KV, type KVOptions, kv };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { Monlite } from '@monlite/core';
+
+interface KVOptions {
+    /** Logical namespace so multiple caches can share one database. Default "default". */
+    namespace?: string;
+    /** If set, a timer periodically purges expired keys (ms). Default: lazy-only. */
+    sweepIntervalMs?: number;
+}
+/**
+ * A synchronous, Redis-like key-value cache backed by SQLite. Values are any
+ * JSON-serializable data; TTLs are in milliseconds.
+ */
+interface KV {
+    get<T = any>(key: string): T | undefined;
+    set(key: string, value: any, opts?: {
+        ttl?: number;
+    }): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    /** Atomically add `by` (default 1) to a numeric key; returns the new value. */
+    incr(key: string, by?: number): number;
+    decr(key: string, by?: number): number;
+    mget<T = any>(keys: string[]): (T | undefined)[];
+    /** Keys in this namespace (optionally by prefix), excluding expired ones. */
+    keys(prefix?: string): string[];
+    /** Set/refresh a key's TTL (ms). Returns false if the key is absent. */
+    expire(key: string, ttl: number): boolean;
+    /** Remaining TTL in ms; `-1` if no expiry, `-2` if absent (Redis convention). */
+    ttl(key: string): number;
+    /** Delete all keys in this namespace. */
+    flush(): void;
+    /** Number of live keys in this namespace. */
+    size(): number;
+    /** Stop the sweep timer (if any). */
+    stop(): void;
+}
+/**
+ * Create a cache over a monlite database.
+ *
+ * ```ts
+ * const cache = kv(db);
+ * cache.set("session:42", { user: "ali" }, { ttl: 60_000 });
+ * cache.get("session:42"); // { user: "ali" }  (synchronous)
+ * ```
+ */
+declare function kv(db: Monlite, options?: KVOptions): KV;
+
+export { type KV, type KVOptions, kv };

package/dist/index.js

@@ -0,0 +1,112 @@
+// src/index.ts
+var ensured = /* @__PURE__ */ new WeakSet();
+function kv(db, options = {}) {
+  const ns = options.namespace ?? "default";
+  const driver = db.driver;
+  if (!ensured.has(db)) {
+    driver.exec(
+      `CREATE TABLE IF NOT EXISTS _kv (
+        ns TEXT NOT NULL, k TEXT NOT NULL, v TEXT NOT NULL,
+        expires_at INTEGER, PRIMARY KEY (ns, k)
+      )`
+    );
+    ensured.add(db);
+  }
+  const now = () => Date.now();
+  const fresh = (row) => !!row && !(row.expires_at != null && row.expires_at <= now());
+  const getRow = (key) => driver.prepare(`SELECT v, expires_at FROM _kv WHERE ns = ? AND k = ?`).get(ns, key);
+  const del = (key) => driver.prepare(`DELETE FROM _kv WHERE ns = ? AND k = ?`).run(ns, key).changes > 0;
+  const setRaw = (key, v, expires) => driver.prepare(
+    `INSERT INTO _kv (ns, k, v, expires_at) VALUES (?, ?, ?, ?)
+         ON CONFLICT(ns, k) DO UPDATE SET v = excluded.v, expires_at = excluded.expires_at`
+  ).run(ns, key, v, expires);
+  let timer;
+  const api = {
+    get(key) {
+      const row = getRow(key);
+      if (!fresh(row)) {
+        if (row) del(key);
+        return void 0;
+      }
+      return JSON.parse(row.v);
+    },
+    set(key, value, opts) {
+      const expires = opts?.ttl != null ? now() + opts.ttl : null;
+      setRaw(key, JSON.stringify(value), expires);
+    },
+    has(key) {
+      return api.get(key) !== void 0;
+    },
+    delete(key) {
+      return del(key);
+    },
+    incr(key, by = 1) {
+      return driver.transaction(() => {
+        const row = getRow(key);
+        let n = 0;
+        let expires = null;
+        if (fresh(row)) {
+          const cur = JSON.parse(row.v);
+          if (typeof cur !== "number") {
+            throw new Error(`kv.incr: value at "${key}" is not a number`);
+          }
+          n = cur;
+          expires = row.expires_at;
+        }
+        const next = n + by;
+        setRaw(key, JSON.stringify(next), expires);
+        return next;
+      });
+    },
+    decr(key, by = 1) {
+      return api.incr(key, -by);
+    },
+    mget(keys) {
+      return keys.map((k) => api.get(k));
+    },
+    keys(prefix) {
+      const t = now();
+      const rows = prefix !== void 0 ? driver.prepare(
+        `SELECT k, expires_at FROM _kv WHERE ns = ? AND k LIKE ? ESCAPE '\\'`
+      ).all(ns, prefix.replace(/[%_\\]/g, "\\$&") + "%") : driver.prepare(`SELECT k, expires_at FROM _kv WHERE ns = ?`).all(ns);
+      return rows.filter((r) => r.expires_at == null || r.expires_at > t).map((r) => r.k);
+    },
+    expire(key, ttl) {
+      const row = getRow(key);
+      if (!fresh(row)) return false;
+      driver.prepare(`UPDATE _kv SET expires_at = ? WHERE ns = ? AND k = ?`).run(now() + ttl, ns, key);
+      return true;
+    },
+    ttl(key) {
+      const row = getRow(key);
+      if (!fresh(row)) return -2;
+      if (row.expires_at == null) return -1;
+      return row.expires_at - now();
+    },
+    flush() {
+      driver.prepare(`DELETE FROM _kv WHERE ns = ?`).run(ns);
+    },
+    size() {
+      return driver.prepare(
+        `SELECT COUNT(*) AS n FROM _kv WHERE ns = ? AND (expires_at IS NULL OR expires_at > ?)`
+      ).get(ns, now()).n;
+    },
+    stop() {
+      if (timer) clearInterval(timer);
+      timer = void 0;
+    }
+  };
+  if (options.sweepIntervalMs && options.sweepIntervalMs > 0) {
+    timer = setInterval(() => {
+      driver.prepare(
+        `DELETE FROM _kv WHERE expires_at IS NOT NULL AND expires_at <= ?`
+      ).run(now());
+    }, options.sweepIntervalMs);
+    timer.unref?.();
+  }
+  return api;
+}
+
+export { kv };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Monlite } from \"@monlite/core\";\n\nexport interface KVOptions {\n  /** Logical namespace so multiple caches can share one database. Default \"default\". */\n  namespace?: string;\n  /** If set, a timer periodically purges expired keys (ms). Default: lazy-only. */\n  sweepIntervalMs?: number;\n}\n\n/**\n * A synchronous, Redis-like key-value cache backed by SQLite. Values are any\n * JSON-serializable data; TTLs are in milliseconds.\n */\nexport interface KV {\n  get<T = any>(key: string): T | undefined;\n  set(key: string, value: any, opts?: { ttl?: number }): void;\n  has(key: string): boolean;\n  delete(key: string): boolean;\n  /** Atomically add `by` (default 1) to a numeric key; returns the new value. */\n  incr(key: string, by?: number): number;\n  decr(key: string, by?: number): number;\n  mget<T = any>(keys: string[]): (T | undefined)[];\n  /** Keys in this namespace (optionally by prefix), excluding expired ones. */\n  keys(prefix?: string): string[];\n  /** Set/refresh a key's TTL (ms). Returns false if the key is absent. */\n  expire(key: string, ttl: number): boolean;\n  /** Remaining TTL in ms; `-1` if no expiry, `-2` if absent (Redis convention). */\n  ttl(key: string): number;\n  /** Delete all keys in this namespace. */\n  flush(): void;\n  /** Number of live keys in this namespace. */\n  size(): number;\n  /** Stop the sweep timer (if any). */\n  stop(): void;\n}\n\nconst ensured = new WeakSet<object>();\n\n/**\n * Create a cache over a monlite database.\n *\n * ```ts\n * const cache = kv(db);\n * cache.set(\"session:42\", { user: \"ali\" }, { ttl: 60_000 });\n * cache.get(\"session:42\"); // { user: \"ali\" }  (synchronous)\n * ```\n */\nexport function kv(db: Monlite, options: KVOptions = {}): KV {\n  const ns = options.namespace ?? \"default\";\n  const driver = db.driver;\n\n  if (!ensured.has(db)) {\n    driver.exec(\n      `CREATE TABLE IF NOT EXISTS _kv (\n        ns TEXT NOT NULL, k TEXT NOT NULL, v TEXT NOT NULL,\n        expires_at INTEGER, PRIMARY KEY (ns, k)\n      )`,\n    );\n    ensured.add(db);\n  }\n\n  const now = () => Date.now();\n  const fresh = (row: any): boolean =>\n    !!row && !(row.expires_at != null && row.expires_at <= now());\n\n  const getRow = (key: string) =>\n    driver\n      .prepare(`SELECT v, expires_at FROM _kv WHERE ns = ? AND k = ?`)\n      .get(ns, key) as { v: string; expires_at: number | null } | undefined;\n\n  const del = (key: string): boolean =>\n    driver.prepare(`DELETE FROM _kv WHERE ns = ? AND k = ?`).run(ns, key)\n      .changes > 0;\n\n  const setRaw = (key: string, v: string, expires: number | null) =>\n    driver\n      .prepare(\n        `INSERT INTO _kv (ns, k, v, expires_at) VALUES (?, ?, ?, ?)\n         ON CONFLICT(ns, k) DO UPDATE SET v = excluded.v, expires_at = excluded.expires_at`,\n      )\n      .run(ns, key, v, expires);\n\n  let timer: ReturnType<typeof setInterval> | undefined;\n\n  const api: KV = {\n    get(key) {\n      const row = getRow(key);\n      if (!fresh(row)) {\n        if (row) del(key);\n        return undefined;\n      }\n      return JSON.parse(row!.v);\n    },\n    set(key, value, opts) {\n      const expires = opts?.ttl != null ? now() + opts.ttl : null;\n      setRaw(key, JSON.stringify(value), expires);\n    },\n    has(key) {\n      return api.get(key) !== undefined;\n    },\n    delete(key) {\n      return del(key);\n    },\n    incr(key, by = 1) {\n      return driver.transaction(() => {\n        const row = getRow(key);\n        let n = 0;\n        let expires: number | null = null;\n        if (fresh(row)) {\n          const cur = JSON.parse(row!.v);\n          if (typeof cur !== \"number\") {\n            throw new Error(`kv.incr: value at \"${key}\" is not a number`);\n          }\n          n = cur;\n          expires = row!.expires_at;\n        }\n        const next = n + by;\n        setRaw(key, JSON.stringify(next), expires);\n        return next;\n      });\n    },\n    decr(key, by = 1) {\n      return api.incr(key, -by);\n    },\n    mget(keys) {\n      return keys.map((k) => api.get(k));\n    },\n    keys(prefix) {\n      const t = now();\n      const rows = (\n        prefix !== undefined\n          ? driver\n              .prepare(\n                `SELECT k, expires_at FROM _kv WHERE ns = ? AND k LIKE ? ESCAPE '\\\\'`,\n              )\n              .all(ns, prefix.replace(/[%_\\\\]/g, \"\\\\$&\") + \"%\")\n          : driver.prepare(`SELECT k, expires_at FROM _kv WHERE ns = ?`).all(ns)\n      ) as Array<{ k: string; expires_at: number | null }>;\n      return rows\n        .filter((r) => r.expires_at == null || r.expires_at > t)\n        .map((r) => r.k);\n    },\n    expire(key, ttl) {\n      const row = getRow(key);\n      if (!fresh(row)) return false;\n      driver\n        .prepare(`UPDATE _kv SET expires_at = ? WHERE ns = ? AND k = ?`)\n        .run(now() + ttl, ns, key);\n      return true;\n    },\n    ttl(key) {\n      const row = getRow(key);\n      if (!fresh(row)) return -2;\n      if (row!.expires_at == null) return -1;\n      return row!.expires_at - now();\n    },\n    flush() {\n      driver.prepare(`DELETE FROM _kv WHERE ns = ?`).run(ns);\n    },\n    size() {\n      return (\n        driver\n          .prepare(\n            `SELECT COUNT(*) AS n FROM _kv WHERE ns = ? AND (expires_at IS NULL OR expires_at > ?)`,\n          )\n          .get(ns, now()) as { n: number }\n      ).n;\n    },\n    stop() {\n      if (timer) clearInterval(timer);\n      timer = undefined;\n    },\n  };\n\n  if (options.sweepIntervalMs && options.sweepIntervalMs > 0) {\n    timer = setInterval(() => {\n      driver\n        .prepare(\n          `DELETE FROM _kv WHERE expires_at IS NOT NULL AND expires_at <= ?`,\n        )\n        .run(now());\n    }, options.sweepIntervalMs);\n    timer.unref?.();\n  }\n\n  return api;\n}\n"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@monlite/kv",
+  "version": "0.1.0",
+  "description": "Redis-like local key-value cache for @monlite/core: get/set/incr with TTL, on SQLite.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "monlite",
+    "kv",
+    "cache",
+    "redis",
+    "key-value",
+    "ttl",
+    "sqlite"
+  ],
+  "license": "MIT",
+  "author": "Emad Jumaah <emadjumaah@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qataruts/monlite.git",
+    "directory": "packages/kv"
+  },
+  "homepage": "https://github.com/qataruts/monlite/tree/main/packages/kv#readme",
+  "bugs": {
+    "url": "https://github.com/qataruts/monlite/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@monlite/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "better-sqlite3": "^11.8.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}