@monlite/kv 0.1.1 → 0.2.1

package/README.md

@@ -1,6 +1,8 @@
 # @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).
+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
+(cache + queue + cron, replacing Redis locally).
 
 ```bash
 npm install @monlite/core @monlite/kv
@@ -16,40 +18,44 @@ 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)
+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.
+The cache is **synchronous** (local SQLite — no network, no await), **durable** (survives
+restarts), and stored in your app's database. Use `:memory:` 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. |
+| `set(key, value, { ttl? })` | Store any JSON-serializable value; `ttl` in ms (optional). |
+| `setNX(key, value, { ttl? })` | Atomic set-if-absent (Redis `SET NX`); returns `true` if acquired. The lock/nonce primitive. |
+| `has(key)` / `delete(key)` | Existence check / removal. |
+| `incr(key, by?)` / `decr(key, by?)` | Atomic numeric increment/decrement; returns the new value. |
+| `mget(keys)` | Array of values (`undefined` per missing/expired key). |
+| `keys(prefix?)` | Live keys in the namespace, optionally filtered by prefix. |
+| `expire(key, ttl)` | Set or refresh the TTL (ms); returns `false` if the key is absent. |
+| `ttl(key)` | Remaining ms; `-1` = no expiry, `-2` = key absent (Redis convention). |
+| `size()` / `flush()` | Count / clear all keys in the namespace. |
+| `stop()` | Clear the sweep timer (if `sweepIntervalMs` was set). |
 
 ## Options
 
 ```ts
 kv(db, {
-  namespace: "sessions", // isolate multiple caches in one db (default "default")
+  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.
+Expired keys are removed lazily on read. Set `sweepIntervalMs` to also purge them on a timer.
+Call `cache.stop()` to clear the timer when shutting down.
+
+## License
 
 MIT

package/dist/index.cjs

@@ -36,6 +36,15 @@ function kv(db, options = {}) {
       const expires = opts?.ttl != null ? now() + opts.ttl : null;
       setRaw(key, JSON.stringify(value), expires);
     },
+    setNX(key, value, opts) {
+      return driver.transaction(() => {
+        const row = getRow(key);
+        if (fresh(row)) return false;
+        const expires = opts?.ttl != null ? now() + opts.ttl : null;
+        setRaw(key, JSON.stringify(value), expires);
+        return true;
+      }, true);
+    },
     has(key) {
       return api.get(key) !== void 0;
     },
@@ -58,7 +67,7 @@ function kv(db, options = {}) {
         const next = n + by;
         setRaw(key, JSON.stringify(next), expires);
         return next;
-      });
+      }, true);
     },
     decr(key, by = 1) {
       return api.incr(key, -by);

package/dist/index.cjs.map

@@ -1 +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"]}
+{"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  /**\n   * Atomically set the key only if it isn't already present (Redis `SET NX`).\n   * Returns `true` if set, `false` if a live key already existed. The lock\n   * primitive for single-instance schedulers, nonces, and once-only work.\n   */\n  setNX(key: string, value: any, opts?: { ttl?: number }): boolean;\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    setNX(key, value, opts) {\n      // IMMEDIATE: take the write lock up front so two processes racing the same\n      // key can't deadlock on lock upgrade — the loser cleanly gets `false`.\n      return driver.transaction(() => {\n        const row = getRow(key);\n        if (fresh(row)) return false; // a live key already exists\n        const expires = opts?.ttl != null ? now() + opts.ttl : null;\n        setRaw(key, JSON.stringify(value), expires);\n        return true;\n      }, true);\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(() => {  // IMMEDIATE: read-modify-write needs the write lock up front\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      }, true);\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

@@ -15,6 +15,14 @@ interface KV {
     set(key: string, value: any, opts?: {
         ttl?: number;
     }): void;
+    /**
+     * Atomically set the key only if it isn't already present (Redis `SET NX`).
+     * Returns `true` if set, `false` if a live key already existed. The lock
+     * primitive for single-instance schedulers, nonces, and once-only work.
+     */
+    setNX(key: string, value: any, opts?: {
+        ttl?: number;
+    }): boolean;
     has(key: string): boolean;
     delete(key: string): boolean;
     /** Atomically add `by` (default 1) to a numeric key; returns the new value. */

package/dist/index.d.ts

@@ -15,6 +15,14 @@ interface KV {
     set(key: string, value: any, opts?: {
         ttl?: number;
     }): void;
+    /**
+     * Atomically set the key only if it isn't already present (Redis `SET NX`).
+     * Returns `true` if set, `false` if a live key already existed. The lock
+     * primitive for single-instance schedulers, nonces, and once-only work.
+     */
+    setNX(key: string, value: any, opts?: {
+        ttl?: number;
+    }): boolean;
     has(key: string): boolean;
     delete(key: string): boolean;
     /** Atomically add `by` (default 1) to a numeric key; returns the new value. */

package/dist/index.js

@@ -34,6 +34,15 @@ function kv(db, options = {}) {
       const expires = opts?.ttl != null ? now() + opts.ttl : null;
       setRaw(key, JSON.stringify(value), expires);
     },
+    setNX(key, value, opts) {
+      return driver.transaction(() => {
+        const row = getRow(key);
+        if (fresh(row)) return false;
+        const expires = opts?.ttl != null ? now() + opts.ttl : null;
+        setRaw(key, JSON.stringify(value), expires);
+        return true;
+      }, true);
+    },
     has(key) {
       return api.get(key) !== void 0;
     },
@@ -56,7 +65,7 @@ function kv(db, options = {}) {
         const next = n + by;
         setRaw(key, JSON.stringify(next), expires);
         return next;
-      });
+      }, true);
     },
     decr(key, by = 1) {
       return api.incr(key, -by);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAoCA,IAAM,OAAA,uBAAc,OAAA,EAAgB;AAW7B,SAAS,EAAA,CAAG,EAAA,EAAa,OAAA,GAAqB,EAAC,EAAO;AAC3D,EAAA,MAAM,EAAA,GAAK,QAAQ,SAAA,IAAa,SAAA;AAChC,EAAA,MAAM,SAAS,EAAA,CAAG,MAAA;AAElB,EAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,EAAE,CAAA,EAAG;AACpB,IAAA,MAAA,CAAO,IAAA;AAAA,MACL,CAAA;AAAA;AAAA;AAAA,OAAA;AAAA,KAIF;AACA,IAAA,OAAA,CAAQ,IAAI,EAAE,CAAA;AAAA,EAChB;AAEA,EAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,GAAA,EAAI;AAC3B,EAAA,MAAM,KAAA,GAAQ,CAAC,GAAA,KACb,CAAC,CAAC,GAAA,IAAO,EAAE,GAAA,CAAI,UAAA,IAAc,IAAA,IAAQ,GAAA,CAAI,UAAA,IAAc,GAAA,EAAI,CAAA;AAE7D,EAAA,MAAM,MAAA,GAAS,CAAC,GAAA,KACd,MAAA,CACG,QAAQ,CAAA,oDAAA,CAAsD,CAAA,CAC9D,GAAA,CAAI,EAAA,EAAI,GAAG,CAAA;AAEhB,EAAA,MAAM,GAAA,GAAM,CAAC,GAAA,KACX,MAAA,CAAO,OAAA,CAAQ,CAAA,sCAAA,CAAwC,CAAA,CAAE,GAAA,CAAI,EAAA,EAAI,GAAG,CAAA,CACjE,OAAA,GAAU,CAAA;AAEf,EAAA,MAAM,MAAA,GAAS,CAAC,GAAA,EAAa,CAAA,EAAW,YACtC,MAAA,CACG,OAAA;AAAA,IACC,CAAA;AAAA,0FAAA;AAAA,GAEF,CACC,GAAA,CAAI,EAAA,EAAI,GAAA,EAAK,GAAG,OAAO,CAAA;AAE5B,EAAA,IAAI,KAAA;AAEJ,EAAA,MAAM,GAAA,GAAU;AAAA,IACd,IAAI,GAAA,EAAK;AACP,MAAA,MAAM,GAAA,GAAM,OAAO,GAAG,CAAA;AACtB,MAAA,IAAI,CAAC,KAAA,CAAM,GAAG,CAAA,EAAG;AACf,QAAA,IAAI,GAAA,MAAS,GAAG,CAAA;AAChB,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAK,CAAC,CAAA;AAAA,IAC1B,CAAA;AAAA,IACA,GAAA,CAAI,GAAA,EAAK,KAAA,EAAO,IAAA,EAAM;AACpB,MAAA,MAAM,UAAU,IAAA,EAAM,GAAA,IAAO,OAAO,GAAA,EAAI,GAAI,KAAK,GAAA,GAAM,IAAA;AACvD,MAAA,MAAA,CAAO,GAAA,EAAK,IAAA,CAAK,SAAA,CAAU,KAAK,GAAG,OAAO,CAAA;AAAA,IAC5C,CAAA;AAAA,IACA,IAAI,GAAA,EAAK;AACP,MAAA,OAAO,GAAA,CAAI,GAAA,CAAI,GAAG,CAAA,KAAM,MAAA;AAAA,IAC1B,CAAA;AAAA,IACA,OAAO,GAAA,EAAK;AACV,MAAA,OAAO,IAAI,GAAG,CAAA;AAAA,IAChB,CAAA;AAAA,IACA,IAAA,CAAK,GAAA,EAAK,EAAA,GAAK,CAAA,EAAG;AAChB,MAAA,OAAO,MAAA,CAAO,YAAY,MAAM;AAC9B,QAAA,MAAM,GAAA,GAAM,OAAO,GAAG,CAAA;AACtB,QAAA,IAAI,CAAA,GAAI,CAAA;AACR,QAAA,IAAI,OAAA,GAAyB,IAAA;AAC7B,QAAA,IAAI,KAAA,CAAM,GAAG,CAAA,EAAG;AACd,UAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,GAAA,CAAK,CAAC,CAAA;AAC7B,UAAA,IAAI,OAAO,QAAQ,QAAA,EAAU;AAC3B,YAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,GAAG,CAAA,iBAAA,CAAmB,CAAA;AAAA,UAC9D;AACA,UAAA,CAAA,GAAI,GAAA;AACJ,UAAA,OAAA,GAAU,GAAA,CAAK,UAAA;AAAA,QACjB;AACA,QAAA,MAAM,OAAO,CAAA,GAAI,EAAA;AACjB,QAAA,MAAA,CAAO,GAAA,EAAK,IAAA,CAAK,SAAA,CAAU,IAAI,GAAG,OAAO,CAAA;AACzC,QAAA,OAAO,IAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,IAAA,CAAK,GAAA,EAAK,EAAA,GAAK,CAAA,EAAG;AAChB,MAAA,OAAO,GAAA,CAAI,IAAA,CAAK,GAAA,EAAK,CAAC,EAAE,CAAA;AAAA,IAC1B,CAAA;AAAA,IACA,KAAK,IAAA,EAAM;AACT,MAAA,OAAO,KAAK,GAAA,CAAI,CAAC,MAAM,GAAA,CAAI,GAAA,CAAI,CAAC,CAAC,CAAA;AAAA,IACnC,CAAA;AAAA,IACA,KAAK,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,GAAA,EAAI;AACd,MAAA,MAAM,IAAA,GACJ,MAAA,KAAW,MAAA,GACP,MAAA,CACG,OAAA;AAAA,QACC,CAAA,mEAAA;AAAA,OACF,CACC,GAAA,CAAI,EAAA,EAAI,MAAA,CAAO,QAAQ,SAAA,EAAW,MAAM,CAAA,GAAI,GAAG,IAClD,MAAA,CAAO,OAAA,CAAQ,CAAA,0CAAA,CAA4C,CAAA,CAAE,IAAI,EAAE,CAAA;AAEzE,MAAA,OAAO,IAAA,CACJ,MAAA,CAAO,CAAC,CAAA,KAAM,EAAE,UAAA,IAAc,IAAA,IAAQ,CAAA,CAAE,UAAA,GAAa,CAAC,CAAA,CACtD,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,CAAC,CAAA;AAAA,IACnB,CAAA;AAAA,IACA,MAAA,CAAO,KAAK,GAAA,EAAK;AACf,MAAA,MAAM,GAAA,GAAM,OAAO,GAAG,CAAA;AACtB,MAAA,IAAI,CAAC,KAAA,CAAM,GAAG,CAAA,EAAG,OAAO,KAAA;AACxB,MAAA,MAAA,CACG,OAAA,CAAQ,sDAAsD,CAAA,CAC9D,GAAA,CAAI,KAAI,GAAI,GAAA,EAAK,IAAI,GAAG,CAAA;AAC3B,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA,IAAI,GAAA,EAAK;AACP,MAAA,MAAM,GAAA,GAAM,OAAO,GAAG,CAAA;AACtB,MAAA,IAAI,CAAC,KAAA,CAAM,GAAG,CAAA,EAAG,OAAO,EAAA;AACxB,MAAA,IAAI,GAAA,CAAK,UAAA,IAAc,IAAA,EAAM,OAAO,EAAA;AACpC,MAAA,OAAO,GAAA,CAAK,aAAa,GAAA,EAAI;AAAA,IAC/B,CAAA;AAAA,IACA,KAAA,GAAQ;AACN,MAAA,MAAA,CAAO,OAAA,CAAQ,CAAA,4BAAA,CAA8B,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA;AAAA,IACvD,CAAA;AAAA,IACA,IAAA,GAAO;AACL,MAAA,OACE,MAAA,CACG,OAAA;AAAA,QACC,CAAA,qFAAA;AAAA,OACF,CACC,GAAA,CAAI,EAAA,EAAI,GAAA,EAAK,CAAA,CAChB,CAAA;AAAA,IACJ,CAAA;AAAA,IACA,IAAA,GAAO;AACL,MAAA,IAAI,KAAA,gBAAqB,KAAK,CAAA;AAC9B,MAAA,KAAA,GAAQ,MAAA;AAAA,IACV;AAAA,GACF;AAEA,EAAA,IAAI,OAAA,CAAQ,eAAA,IAAmB,OAAA,CAAQ,eAAA,GAAkB,CAAA,EAAG;AAC1D,IAAA,KAAA,GAAQ,YAAY,MAAM;AACxB,MAAA,MAAA,CACG,OAAA;AAAA,QACC,CAAA,gEAAA;AAAA,OACF,CACC,GAAA,CAAI,GAAA,EAAK,CAAA;AAAA,IACd,CAAA,EAAG,QAAQ,eAAe,CAAA;AAC1B,IAAA,KAAA,CAAM,KAAA,IAAQ;AAAA,EAChB;AAEA,EAAA,OAAO,GAAA;AACT","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"]}
+{"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  /**\n   * Atomically set the key only if it isn't already present (Redis `SET NX`).\n   * Returns `true` if set, `false` if a live key already existed. The lock\n   * primitive for single-instance schedulers, nonces, and once-only work.\n   */\n  setNX(key: string, value: any, opts?: { ttl?: number }): boolean;\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    setNX(key, value, opts) {\n      // IMMEDIATE: take the write lock up front so two processes racing the same\n      // key can't deadlock on lock upgrade — the loser cleanly gets `false`.\n      return driver.transaction(() => {\n        const row = getRow(key);\n        if (fresh(row)) return false; // a live key already exists\n        const expires = opts?.ttl != null ? now() + opts.ttl : null;\n        setRaw(key, JSON.stringify(value), expires);\n        return true;\n      }, true);\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(() => {  // IMMEDIATE: read-modify-write needs the write lock up front\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      }, true);\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

@@ -1,6 +1,6 @@
 {
   "name": "@monlite/kv",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Redis-like local key-value cache for @monlite/core: get/set/incr with TTL, on SQLite.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -49,7 +49,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@monlite/core": "^2.0.0"
+    "@monlite/core": "^2.6.3"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",