@monlite/kv 0.3.0 → 0.4.0

package/dist/index.cjs

@@ -15,7 +15,12 @@ function kv(db, options = {}) {
         seq INTEGER PRIMARY KEY AUTOINCREMENT,
         ns TEXT NOT NULL, channel TEXT NOT NULL, payload TEXT, ts INTEGER NOT NULL
       );
-      CREATE INDEX IF NOT EXISTS _idx_kv_pubsub ON _monlite_kv_pubsub (ns, seq)`
+      CREATE INDEX IF NOT EXISTS _idx_kv_pubsub ON _monlite_kv_pubsub (ns, seq);
+      CREATE TABLE IF NOT EXISTS _monlite_kv_zset (
+        ns TEXT NOT NULL, k TEXT NOT NULL, member TEXT NOT NULL, score REAL NOT NULL,
+        PRIMARY KEY (ns, k, member)
+      );
+      CREATE INDEX IF NOT EXISTS _idx_kv_zset ON _monlite_kv_zset (ns, k, score, member)`
     );
     ensured.add(db);
   }
@@ -30,7 +35,7 @@ function kv(db, options = {}) {
   ).run(ns, key, v, expires);
   let timer;
   const subs = /* @__PURE__ */ new Set();
-  let psTimer;
+  let psTask;
   const psMaxSeq = () => driver.prepare(`SELECT MAX(seq) AS s FROM _monlite_kv_pubsub WHERE ns = ?`).get(ns).s ?? 0;
   const drainPubsub = () => {
     if (subs.size === 0) return;
@@ -132,6 +137,73 @@ function kv(db, options = {}) {
         `SELECT COUNT(*) AS n FROM _kv WHERE ns = ? AND (expires_at IS NULL OR expires_at > ?)`
       ).get(ns, now()).n;
     },
+    // ── sorted sets ──────────────────────────────────────────────────────────
+    zadd(key, score, member) {
+      driver.prepare(
+        `INSERT INTO _monlite_kv_zset (ns, k, member, score) VALUES (?, ?, ?, ?)
+           ON CONFLICT(ns, k, member) DO UPDATE SET score = excluded.score`
+      ).run(ns, key, member, score);
+    },
+    zincrby(key, delta, member) {
+      return driver.transaction(() => {
+        const row = driver.prepare(
+          `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`
+        ).get(ns, key, member);
+        const next = (row?.score ?? 0) + delta;
+        driver.prepare(
+          `INSERT INTO _monlite_kv_zset (ns, k, member, score) VALUES (?, ?, ?, ?)
+             ON CONFLICT(ns, k, member) DO UPDATE SET score = excluded.score`
+        ).run(ns, key, member, next);
+        return next;
+      }, true);
+    },
+    zscore(key, member) {
+      const row = driver.prepare(
+        `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`
+      ).get(ns, key, member);
+      return row?.score;
+    },
+    zrem(key, member) {
+      return driver.prepare(
+        `DELETE FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`
+      ).run(ns, key, member).changes > 0;
+    },
+    zcard(key) {
+      return driver.prepare(
+        `SELECT COUNT(*) AS n FROM _monlite_kv_zset WHERE ns = ? AND k = ?`
+      ).get(ns, key).n;
+    },
+    zrank(key, member, opts) {
+      const row = driver.prepare(
+        `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`
+      ).get(ns, key, member);
+      if (!row) return void 0;
+      const cmp = opts?.rev ? `score > ? OR (score = ? AND member > ?)` : `score < ? OR (score = ? AND member < ?)`;
+      return driver.prepare(
+        `SELECT COUNT(*) AS n FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND (${cmp})`
+      ).get(ns, key, row.score, row.score, member).n;
+    },
+    zrange(key, start, stop, opts) {
+      const card = api.zcard(key);
+      let lo = start < 0 ? card + start : start;
+      let hi = stop < 0 ? card + stop : stop;
+      if (lo < 0) lo = 0;
+      if (hi >= card) hi = card - 1;
+      if (card === 0 || lo > hi) return [];
+      const dir = opts?.rev ? "DESC" : "ASC";
+      const rows = driver.prepare(
+        `SELECT member, score FROM _monlite_kv_zset WHERE ns = ? AND k = ?
+           ORDER BY score ${dir}, member ${dir} LIMIT ? OFFSET ?`
+      ).all(ns, key, hi - lo + 1, lo);
+      return opts?.withScores ? rows : rows.map((r) => r.member);
+    },
+    zrangeByScore(key, min, max, opts) {
+      const rows = driver.prepare(
+        `SELECT member, score FROM _monlite_kv_zset WHERE ns = ? AND k = ?
+           AND score >= ? AND score <= ? ORDER BY score ASC, member ASC`
+      ).all(ns, key, min, max);
+      return opts?.withScores ? rows : rows.map((r) => r.member);
+    },
     publish(channel, message) {
       const ts = now();
       driver.prepare(
@@ -146,23 +218,22 @@ function kv(db, options = {}) {
     subscribe(channel, cb) {
       const sub = { channel, cb, cursor: psMaxSeq() };
       subs.add(sub);
-      if (!psTimer) {
-        psTimer = setInterval(drainPubsub, pubsubPollMs);
-        psTimer.unref?.();
-      }
+      if (!psTask) psTask = db.heartbeat.every(pubsubPollMs, drainPubsub);
       return () => {
         subs.delete(sub);
-        if (subs.size === 0 && psTimer) {
-          clearInterval(psTimer);
-          psTimer = void 0;
+        if (subs.size === 0 && psTask) {
+          psTask.cancel();
+          psTask = void 0;
         }
       };
     },
     stop() {
       if (timer) clearInterval(timer);
       timer = void 0;
-      if (psTimer) clearInterval(psTimer);
-      psTimer = void 0;
+      if (psTask) {
+        psTask.cancel();
+        psTask = void 0;
+      }
     }
   };
   if (options.sweepIntervalMs && options.sweepIntervalMs > 0) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAwDA,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;AAAA;AAAA;AAAA;AAAA;AAAA,+EAAA;AAAA,KASF;AACA,IAAA,OAAA,CAAQ,IAAI,EAAE,CAAA;AAAA,EAChB;AAEA,EAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,GAAA,EAAI;AAC3B,EAAA,MAAM,eAAe,IAAA,CAAK,GAAA,CAAI,EAAA,EAAI,OAAA,CAAQ,gBAAgB,GAAG,CAAA;AAC7D,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;AAIJ,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAS;AAC1B,EAAA,IAAI,OAAA;AAEJ,EAAA,MAAM,QAAA,GAAW,MAEb,MAAA,CACG,OAAA,CAAQ,2DAA2D,CAAA,CACnE,GAAA,CAAI,EAAE,CAAA,CACT,CAAA,IAAK,CAAA;AAGT,EAAA,MAAM,cAAc,MAAY;AAC9B,IAAA,IAAI,IAAA,CAAK,SAAS,CAAA,EAAG;AACrB,IAAA,IAAI,GAAA,GAAM,QAAA;AACV,IAAA,KAAA,MAAW,KAAK,IAAA,EAAM,GAAA,GAAM,KAAK,GAAA,CAAI,GAAA,EAAK,EAAE,MAAM,CAAA;AAClD,IAAA,MAAM,OAAO,MAAA,CACV,OAAA;AAAA,MACC,CAAA,0FAAA;AAAA,KACF,CACC,GAAA,CAAI,EAAA,EAAI,GAAG,CAAA;AACd,IAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AACvB,IAAA,KAAA,MAAW,CAAA,IAAK,CAAC,GAAG,IAAI,CAAA,EAAG;AACzB,MAAA,KAAA,MAAW,KAAK,IAAA,EAAM;AACpB,QAAA,IAAI,CAAA,CAAE,GAAA,IAAO,CAAA,CAAE,MAAA,EAAQ;AACvB,QAAA,CAAA,CAAE,SAAS,CAAA,CAAE,GAAA;AACb,QAAA,IAAI,CAAA,CAAE,OAAA,KAAY,CAAA,CAAE,OAAA,EAAS;AAC3B,UAAA,IAAI;AACF,YAAA,CAAA,CAAE,GAAG,IAAA,CAAK,KAAA,CAAM,CAAA,CAAE,OAAA,IAAW,MAAM,CAAC,CAAA;AAAA,UACtC,CAAA,CAAA,MAAQ;AAAA,UAER;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAA;AAEA,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;AAGvD,MAAA,MAAA,CAAO,KAAK,IAAA,CAAK,SAAA,CAAU,KAAA,IAAS,IAAI,GAAG,OAAO,CAAA;AAAA,IACpD,CAAA;AAAA,IACA,KAAA,CAAM,GAAA,EAAK,KAAA,EAAO,IAAA,EAAM;AAGtB,MAAA,OAAO,MAAA,CAAO,YAAY,MAAM;AAC9B,QAAA,MAAM,GAAA,GAAM,OAAO,GAAG,CAAA;AACtB,QAAA,IAAI,KAAA,CAAM,GAAG,CAAA,EAAG,OAAO,KAAA;AACvB,QAAA,MAAM,UAAU,IAAA,EAAM,GAAA,IAAO,OAAO,GAAA,EAAI,GAAI,KAAK,GAAA,GAAM,IAAA;AAGvD,QAAA,MAAA,CAAO,KAAK,IAAA,CAAK,SAAA,CAAU,KAAA,IAAS,IAAI,GAAG,OAAO,CAAA;AAClD,QAAA,OAAO,IAAA;AAAA,MACT,GAAG,IAAI,CAAA;AAAA,IACT,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;AAE9B,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,GAAG,IAAI,CAAA;AAAA,IACT,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,OAAA,CAAQ,SAAS,OAAA,EAAS;AACxB,MAAA,MAAM,KAAK,GAAA,EAAI;AACf,MAAA,MAAA,CACG,OAAA;AAAA,QACC,CAAA,6EAAA;AAAA,OACF,CACC,IAAI,EAAA,EAAI,OAAA,EAAS,KAAK,SAAA,CAAU,OAAA,IAAW,IAAI,CAAA,EAAG,EAAE,CAAA;AAGvD,MAAA,MAAA,CACG,OAAA,CAAQ,CAAA,2CAAA,CAA6C,CAAA,CACrD,GAAA,CAAI,KAAK,GAAM,CAAA;AAGlB,MAAA,WAAA,EAAY;AACZ,MAAA,IAAI,CAAA,GAAI,CAAA;AACR,MAAA,KAAA,MAAW,CAAA,IAAK,IAAA,EAAM,IAAI,CAAA,CAAE,YAAY,OAAA,EAAS,CAAA,EAAA;AACjD,MAAA,OAAO,CAAA;AAAA,IACT,CAAA;AAAA,IACA,SAAA,CAAU,SAAS,EAAA,EAAI;AACrB,MAAA,MAAM,MAAW,EAAE,OAAA,EAAS,EAAA,EAAI,MAAA,EAAQ,UAAS,EAAE;AACnD,MAAA,IAAA,CAAK,IAAI,GAAG,CAAA;AACZ,MAAA,IAAI,CAAC,OAAA,EAAS;AACZ,QAAA,OAAA,GAAU,WAAA,CAAY,aAAa,YAAY,CAAA;AAC/C,QAAA,OAAA,CAAQ,KAAA,IAAQ;AAAA,MAClB;AACA,MAAA,OAAO,MAAM;AACX,QAAA,IAAA,CAAK,OAAO,GAAG,CAAA;AACf,QAAA,IAAI,IAAA,CAAK,IAAA,KAAS,CAAA,IAAK,OAAA,EAAS;AAC9B,UAAA,aAAA,CAAc,OAAO,CAAA;AACrB,UAAA,OAAA,GAAU,MAAA;AAAA,QACZ;AAAA,MACF,CAAA;AAAA,IACF,CAAA;AAAA,IACA,IAAA,GAAO;AACL,MAAA,IAAI,KAAA,gBAAqB,KAAK,CAAA;AAC9B,MAAA,KAAA,GAAQ,MAAA;AACR,MAAA,IAAI,OAAA,gBAAuB,OAAO,CAAA;AAClC,MAAA,OAAA,GAAU,MAAA;AAAA,IACZ;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.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  /** How often (ms) a `subscribe()` listener polls for cross-process messages. Default `200`. */\n  pubsubPollMs?: 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  /**\n   * Publish a message to a channel (Redis `PUBLISH`). Delivered to every\n   * `subscribe()` listener on that channel — including in OTHER processes\n   * sharing this database. Ephemeral: not replayed to late subscribers. Returns\n   * the number of listeners on this instance that received it.\n   */\n  publish(channel: string, message: any): number;\n  /**\n   * Subscribe to a channel (Redis `SUBSCRIBE`). The callback fires for each\n   * message published AFTER this call, cross-process. Returns an unsubscribe.\n   */\n  subscribe(channel: string, cb: (message: any) => void): () => void;\n  /** Stop the sweep + pub/sub timers (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      CREATE TABLE IF NOT EXISTS _monlite_kv_pubsub (\n        seq INTEGER PRIMARY KEY AUTOINCREMENT,\n        ns TEXT NOT NULL, channel TEXT NOT NULL, payload TEXT, ts INTEGER NOT NULL\n      );\n      CREATE INDEX IF NOT EXISTS _idx_kv_pubsub ON _monlite_kv_pubsub (ns, seq)`,\n    );\n    ensured.add(db);\n  }\n\n  const now = () => Date.now();\n  const pubsubPollMs = Math.max(20, options.pubsubPollMs ?? 200);\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  // ── pub/sub ──────────────────────────────────────────────────────────────\n  type Sub = { channel: string; cb: (m: any) => void; cursor: number };\n  const subs = new Set<Sub>();\n  let psTimer: ReturnType<typeof setInterval> | undefined;\n\n  const psMaxSeq = (): number =>\n    (\n      driver\n        .prepare(`SELECT MAX(seq) AS s FROM _monlite_kv_pubsub WHERE ns = ?`)\n        .get(ns) as { s: number | null }\n    ).s ?? 0;\n\n  /** Deliver new messages to every local subscriber (cross-process via the table). */\n  const drainPubsub = (): void => {\n    if (subs.size === 0) return;\n    let min = Infinity;\n    for (const s of subs) min = Math.min(min, s.cursor);\n    const rows = driver\n      .prepare(\n        `SELECT seq, channel, payload FROM _monlite_kv_pubsub WHERE ns = ? AND seq > ? ORDER BY seq`,\n      )\n      .all(ns, min) as Array<{ seq: number; channel: string; payload: string }>;\n    if (rows.length === 0) return;\n    for (const s of [...subs]) {\n      for (const r of rows) {\n        if (r.seq <= s.cursor) continue;\n        s.cursor = r.seq;\n        if (r.channel === s.channel) {\n          try {\n            s.cb(JSON.parse(r.payload ?? \"null\"));\n          } catch {\n            /* a subscriber callback must not break delivery to others */\n          }\n        }\n      }\n    }\n  };\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      // `?? null` so `set(key, undefined)` stores JSON null (round-trips to null)\n      // instead of binding `undefined` and tripping the NOT NULL constraint.\n      setRaw(key, JSON.stringify(value ?? null), 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        // `?? null` so `set(key, undefined)` stores JSON null (round-trips to null)\n        // instead of binding `undefined` and tripping the NOT NULL constraint.\n        setRaw(key, JSON.stringify(value ?? null), 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(() => {\n        // 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    publish(channel, message) {\n      const ts = now();\n      driver\n        .prepare(\n          `INSERT INTO _monlite_kv_pubsub (ns, channel, payload, ts) VALUES (?, ?, ?, ?)`,\n        )\n        .run(ns, channel, JSON.stringify(message ?? null), ts);\n      // Ephemeral: prune old messages (late subscribers don't replay) so the\n      // table can't grow unbounded.\n      driver\n        .prepare(`DELETE FROM _monlite_kv_pubsub WHERE ts < ?`)\n        .run(ts - 30_000);\n      // Deliver to same-instance subscribers immediately (cross-process listeners\n      // pick it up on their next poll).\n      drainPubsub();\n      let n = 0;\n      for (const s of subs) if (s.channel === channel) n++;\n      return n;\n    },\n    subscribe(channel, cb) {\n      const sub: Sub = { channel, cb, cursor: psMaxSeq() }; // start at \"now\" — no replay\n      subs.add(sub);\n      if (!psTimer) {\n        psTimer = setInterval(drainPubsub, pubsubPollMs);\n        psTimer.unref?.();\n      }\n      return () => {\n        subs.delete(sub);\n        if (subs.size === 0 && psTimer) {\n          clearInterval(psTimer);\n          psTimer = undefined;\n        }\n      };\n    },\n    stop() {\n      if (timer) clearInterval(timer);\n      timer = undefined;\n      if (psTimer) clearInterval(psTimer);\n      psTimer = 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, HeartbeatTask } 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  /** How often (ms) a `subscribe()` listener polls for cross-process messages. Default `200`. */\n  pubsubPollMs?: 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\n  // ── sorted sets (Redis ZSET) — leaderboards, rate-limiters, priority indexes ──\n  /** Add or update `member` with `score` (Redis `ZADD`). */\n  zadd(key: string, score: number, member: string): void;\n  /** Increment `member`'s score by `delta` (`ZINCRBY`); returns the new score. */\n  zincrby(key: string, delta: number, member: string): number;\n  /** A member's score, or `undefined` if absent (`ZSCORE`). */\n  zscore(key: string, member: string): number | undefined;\n  /** Remove `member` (`ZREM`); returns `true` if it existed. */\n  zrem(key: string, member: string): boolean;\n  /** Number of members (`ZCARD`). */\n  zcard(key: string): number;\n  /** 0-based rank by ascending score (ties lexicographic); `rev` for descending. `undefined` if absent. */\n  zrank(\n    key: string,\n    member: string,\n    opts?: { rev?: boolean },\n  ): number | undefined;\n  /**\n   * Members by rank range `[start, stop]` inclusive (negative counts from the end,\n   * Redis-style), ascending by score (`rev` = descending). With `withScores`,\n   * returns `{ member, score }[]` (`ZRANGE` / `ZREVRANGE`).\n   */\n  zrange(\n    key: string,\n    start: number,\n    stop: number,\n    opts?: { rev?: boolean; withScores?: boolean },\n  ): string[] | Array<{ member: string; score: number }>;\n  /** Members with `min <= score <= max`, ascending (`ZRANGEBYSCORE`). */\n  zrangeByScore(\n    key: string,\n    min: number,\n    max: number,\n    opts?: { withScores?: boolean },\n  ): string[] | Array<{ member: string; score: number }>;\n\n  /**\n   * Publish a message to a channel (Redis `PUBLISH`). Delivered to every\n   * `subscribe()` listener on that channel — including in OTHER processes\n   * sharing this database. Ephemeral: not replayed to late subscribers. Returns\n   * the number of listeners on this instance that received it.\n   */\n  publish(channel: string, message: any): number;\n  /**\n   * Subscribe to a channel (Redis `SUBSCRIBE`). The callback fires for each\n   * message published AFTER this call, cross-process. Returns an unsubscribe.\n   */\n  subscribe(channel: string, cb: (message: any) => void): () => void;\n  /** Stop the sweep + pub/sub timers (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      CREATE TABLE IF NOT EXISTS _monlite_kv_pubsub (\n        seq INTEGER PRIMARY KEY AUTOINCREMENT,\n        ns TEXT NOT NULL, channel TEXT NOT NULL, payload TEXT, ts INTEGER NOT NULL\n      );\n      CREATE INDEX IF NOT EXISTS _idx_kv_pubsub ON _monlite_kv_pubsub (ns, seq);\n      CREATE TABLE IF NOT EXISTS _monlite_kv_zset (\n        ns TEXT NOT NULL, k TEXT NOT NULL, member TEXT NOT NULL, score REAL NOT NULL,\n        PRIMARY KEY (ns, k, member)\n      );\n      CREATE INDEX IF NOT EXISTS _idx_kv_zset ON _monlite_kv_zset (ns, k, score, member)`,\n    );\n    ensured.add(db);\n  }\n\n  const now = () => Date.now();\n  const pubsubPollMs = Math.max(20, options.pubsubPollMs ?? 200);\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  // ── pub/sub ──────────────────────────────────────────────────────────────\n  type Sub = { channel: string; cb: (m: any) => void; cursor: number };\n  const subs = new Set<Sub>();\n  let psTask: HeartbeatTask | undefined;\n\n  const psMaxSeq = (): number =>\n    (\n      driver\n        .prepare(`SELECT MAX(seq) AS s FROM _monlite_kv_pubsub WHERE ns = ?`)\n        .get(ns) as { s: number | null }\n    ).s ?? 0;\n\n  /** Deliver new messages to every local subscriber (cross-process via the table). */\n  const drainPubsub = (): void => {\n    if (subs.size === 0) return;\n    let min = Infinity;\n    for (const s of subs) min = Math.min(min, s.cursor);\n    const rows = driver\n      .prepare(\n        `SELECT seq, channel, payload FROM _monlite_kv_pubsub WHERE ns = ? AND seq > ? ORDER BY seq`,\n      )\n      .all(ns, min) as Array<{ seq: number; channel: string; payload: string }>;\n    if (rows.length === 0) return;\n    for (const s of [...subs]) {\n      for (const r of rows) {\n        if (r.seq <= s.cursor) continue;\n        s.cursor = r.seq;\n        if (r.channel === s.channel) {\n          try {\n            s.cb(JSON.parse(r.payload ?? \"null\"));\n          } catch {\n            /* a subscriber callback must not break delivery to others */\n          }\n        }\n      }\n    }\n  };\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      // `?? null` so `set(key, undefined)` stores JSON null (round-trips to null)\n      // instead of binding `undefined` and tripping the NOT NULL constraint.\n      setRaw(key, JSON.stringify(value ?? null), 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        // `?? null` so `set(key, undefined)` stores JSON null (round-trips to null)\n        // instead of binding `undefined` and tripping the NOT NULL constraint.\n        setRaw(key, JSON.stringify(value ?? null), 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(() => {\n        // 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\n    // ── sorted sets ──────────────────────────────────────────────────────────\n    zadd(key, score, member) {\n      driver\n        .prepare(\n          `INSERT INTO _monlite_kv_zset (ns, k, member, score) VALUES (?, ?, ?, ?)\n           ON CONFLICT(ns, k, member) DO UPDATE SET score = excluded.score`,\n        )\n        .run(ns, key, member, score);\n    },\n    zincrby(key, delta, member) {\n      // IMMEDIATE: atomic read-modify-write across processes.\n      return driver.transaction(() => {\n        const row = driver\n          .prepare(\n            `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`,\n          )\n          .get(ns, key, member) as { score: number } | undefined;\n        const next = (row?.score ?? 0) + delta;\n        driver\n          .prepare(\n            `INSERT INTO _monlite_kv_zset (ns, k, member, score) VALUES (?, ?, ?, ?)\n             ON CONFLICT(ns, k, member) DO UPDATE SET score = excluded.score`,\n          )\n          .run(ns, key, member, next);\n        return next;\n      }, true);\n    },\n    zscore(key, member) {\n      const row = driver\n        .prepare(\n          `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`,\n        )\n        .get(ns, key, member) as { score: number } | undefined;\n      return row?.score;\n    },\n    zrem(key, member) {\n      return (\n        driver\n          .prepare(\n            `DELETE FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`,\n          )\n          .run(ns, key, member).changes > 0\n      );\n    },\n    zcard(key) {\n      return (\n        driver\n          .prepare(\n            `SELECT COUNT(*) AS n FROM _monlite_kv_zset WHERE ns = ? AND k = ?`,\n          )\n          .get(ns, key) as { n: number }\n      ).n;\n    },\n    zrank(key, member, opts) {\n      const row = driver\n        .prepare(\n          `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`,\n        )\n        .get(ns, key, member) as { score: number } | undefined;\n      if (!row) return undefined;\n      // Members ordered before this one (ties broken lexicographically by member).\n      const cmp = opts?.rev\n        ? `score > ? OR (score = ? AND member > ?)`\n        : `score < ? OR (score = ? AND member < ?)`;\n      return (\n        driver\n          .prepare(\n            `SELECT COUNT(*) AS n FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND (${cmp})`,\n          )\n          .get(ns, key, row.score, row.score, member) as { n: number }\n      ).n;\n    },\n    zrange(key, start, stop, opts) {\n      const card = api.zcard(key);\n      let lo = start < 0 ? card + start : start;\n      let hi = stop < 0 ? card + stop : stop;\n      if (lo < 0) lo = 0;\n      if (hi >= card) hi = card - 1;\n      if (card === 0 || lo > hi) return [];\n      const dir = opts?.rev ? \"DESC\" : \"ASC\";\n      const rows = driver\n        .prepare(\n          `SELECT member, score FROM _monlite_kv_zset WHERE ns = ? AND k = ?\n           ORDER BY score ${dir}, member ${dir} LIMIT ? OFFSET ?`,\n        )\n        .all(ns, key, hi - lo + 1, lo) as Array<{\n        member: string;\n        score: number;\n      }>;\n      return opts?.withScores ? rows : rows.map((r) => r.member);\n    },\n    zrangeByScore(key, min, max, opts) {\n      const rows = driver\n        .prepare(\n          `SELECT member, score FROM _monlite_kv_zset WHERE ns = ? AND k = ?\n           AND score >= ? AND score <= ? ORDER BY score ASC, member ASC`,\n        )\n        .all(ns, key, min, max) as Array<{ member: string; score: number }>;\n      return opts?.withScores ? rows : rows.map((r) => r.member);\n    },\n\n    publish(channel, message) {\n      const ts = now();\n      driver\n        .prepare(\n          `INSERT INTO _monlite_kv_pubsub (ns, channel, payload, ts) VALUES (?, ?, ?, ?)`,\n        )\n        .run(ns, channel, JSON.stringify(message ?? null), ts);\n      // Ephemeral: prune old messages (late subscribers don't replay) so the\n      // table can't grow unbounded.\n      driver\n        .prepare(`DELETE FROM _monlite_kv_pubsub WHERE ts < ?`)\n        .run(ts - 30_000);\n      // Deliver to same-instance subscribers immediately (cross-process listeners\n      // pick it up on their next poll).\n      drainPubsub();\n      let n = 0;\n      for (const s of subs) if (s.channel === channel) n++;\n      return n;\n    },\n    subscribe(channel, cb) {\n      const sub: Sub = { channel, cb, cursor: psMaxSeq() }; // start at \"now\" — no replay\n      subs.add(sub);\n      // Register the cross-process poll on the shared heartbeat (one timer for the\n      // whole db), started on first subscribe and dropped when the last unsubscribes.\n      if (!psTask) psTask = db.heartbeat.every(pubsubPollMs, drainPubsub);\n      return () => {\n        subs.delete(sub);\n        if (subs.size === 0 && psTask) {\n          psTask.cancel();\n          psTask = undefined;\n        }\n      };\n    },\n    stop() {\n      if (timer) clearInterval(timer);\n      timer = undefined;\n      if (psTask) {\n        psTask.cancel();\n        psTask = undefined;\n      }\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

@@ -41,6 +41,39 @@ interface KV {
     flush(): void;
     /** Number of live keys in this namespace. */
     size(): number;
+    /** Add or update `member` with `score` (Redis `ZADD`). */
+    zadd(key: string, score: number, member: string): void;
+    /** Increment `member`'s score by `delta` (`ZINCRBY`); returns the new score. */
+    zincrby(key: string, delta: number, member: string): number;
+    /** A member's score, or `undefined` if absent (`ZSCORE`). */
+    zscore(key: string, member: string): number | undefined;
+    /** Remove `member` (`ZREM`); returns `true` if it existed. */
+    zrem(key: string, member: string): boolean;
+    /** Number of members (`ZCARD`). */
+    zcard(key: string): number;
+    /** 0-based rank by ascending score (ties lexicographic); `rev` for descending. `undefined` if absent. */
+    zrank(key: string, member: string, opts?: {
+        rev?: boolean;
+    }): number | undefined;
+    /**
+     * Members by rank range `[start, stop]` inclusive (negative counts from the end,
+     * Redis-style), ascending by score (`rev` = descending). With `withScores`,
+     * returns `{ member, score }[]` (`ZRANGE` / `ZREVRANGE`).
+     */
+    zrange(key: string, start: number, stop: number, opts?: {
+        rev?: boolean;
+        withScores?: boolean;
+    }): string[] | Array<{
+        member: string;
+        score: number;
+    }>;
+    /** Members with `min <= score <= max`, ascending (`ZRANGEBYSCORE`). */
+    zrangeByScore(key: string, min: number, max: number, opts?: {
+        withScores?: boolean;
+    }): string[] | Array<{
+        member: string;
+        score: number;
+    }>;
     /**
      * Publish a message to a channel (Redis `PUBLISH`). Delivered to every
      * `subscribe()` listener on that channel — including in OTHER processes

package/dist/index.d.ts

@@ -41,6 +41,39 @@ interface KV {
     flush(): void;
     /** Number of live keys in this namespace. */
     size(): number;
+    /** Add or update `member` with `score` (Redis `ZADD`). */
+    zadd(key: string, score: number, member: string): void;
+    /** Increment `member`'s score by `delta` (`ZINCRBY`); returns the new score. */
+    zincrby(key: string, delta: number, member: string): number;
+    /** A member's score, or `undefined` if absent (`ZSCORE`). */
+    zscore(key: string, member: string): number | undefined;
+    /** Remove `member` (`ZREM`); returns `true` if it existed. */
+    zrem(key: string, member: string): boolean;
+    /** Number of members (`ZCARD`). */
+    zcard(key: string): number;
+    /** 0-based rank by ascending score (ties lexicographic); `rev` for descending. `undefined` if absent. */
+    zrank(key: string, member: string, opts?: {
+        rev?: boolean;
+    }): number | undefined;
+    /**
+     * Members by rank range `[start, stop]` inclusive (negative counts from the end,
+     * Redis-style), ascending by score (`rev` = descending). With `withScores`,
+     * returns `{ member, score }[]` (`ZRANGE` / `ZREVRANGE`).
+     */
+    zrange(key: string, start: number, stop: number, opts?: {
+        rev?: boolean;
+        withScores?: boolean;
+    }): string[] | Array<{
+        member: string;
+        score: number;
+    }>;
+    /** Members with `min <= score <= max`, ascending (`ZRANGEBYSCORE`). */
+    zrangeByScore(key: string, min: number, max: number, opts?: {
+        withScores?: boolean;
+    }): string[] | Array<{
+        member: string;
+        score: number;
+    }>;
     /**
      * Publish a message to a channel (Redis `PUBLISH`). Delivered to every
      * `subscribe()` listener on that channel — including in OTHER processes

package/dist/index.js

@@ -13,7 +13,12 @@ function kv(db, options = {}) {
         seq INTEGER PRIMARY KEY AUTOINCREMENT,
         ns TEXT NOT NULL, channel TEXT NOT NULL, payload TEXT, ts INTEGER NOT NULL
       );
-      CREATE INDEX IF NOT EXISTS _idx_kv_pubsub ON _monlite_kv_pubsub (ns, seq)`
+      CREATE INDEX IF NOT EXISTS _idx_kv_pubsub ON _monlite_kv_pubsub (ns, seq);
+      CREATE TABLE IF NOT EXISTS _monlite_kv_zset (
+        ns TEXT NOT NULL, k TEXT NOT NULL, member TEXT NOT NULL, score REAL NOT NULL,
+        PRIMARY KEY (ns, k, member)
+      );
+      CREATE INDEX IF NOT EXISTS _idx_kv_zset ON _monlite_kv_zset (ns, k, score, member)`
     );
     ensured.add(db);
   }
@@ -28,7 +33,7 @@ function kv(db, options = {}) {
   ).run(ns, key, v, expires);
   let timer;
   const subs = /* @__PURE__ */ new Set();
-  let psTimer;
+  let psTask;
   const psMaxSeq = () => driver.prepare(`SELECT MAX(seq) AS s FROM _monlite_kv_pubsub WHERE ns = ?`).get(ns).s ?? 0;
   const drainPubsub = () => {
     if (subs.size === 0) return;
@@ -130,6 +135,73 @@ function kv(db, options = {}) {
         `SELECT COUNT(*) AS n FROM _kv WHERE ns = ? AND (expires_at IS NULL OR expires_at > ?)`
       ).get(ns, now()).n;
     },
+    // ── sorted sets ──────────────────────────────────────────────────────────
+    zadd(key, score, member) {
+      driver.prepare(
+        `INSERT INTO _monlite_kv_zset (ns, k, member, score) VALUES (?, ?, ?, ?)
+           ON CONFLICT(ns, k, member) DO UPDATE SET score = excluded.score`
+      ).run(ns, key, member, score);
+    },
+    zincrby(key, delta, member) {
+      return driver.transaction(() => {
+        const row = driver.prepare(
+          `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`
+        ).get(ns, key, member);
+        const next = (row?.score ?? 0) + delta;
+        driver.prepare(
+          `INSERT INTO _monlite_kv_zset (ns, k, member, score) VALUES (?, ?, ?, ?)
+             ON CONFLICT(ns, k, member) DO UPDATE SET score = excluded.score`
+        ).run(ns, key, member, next);
+        return next;
+      }, true);
+    },
+    zscore(key, member) {
+      const row = driver.prepare(
+        `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`
+      ).get(ns, key, member);
+      return row?.score;
+    },
+    zrem(key, member) {
+      return driver.prepare(
+        `DELETE FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`
+      ).run(ns, key, member).changes > 0;
+    },
+    zcard(key) {
+      return driver.prepare(
+        `SELECT COUNT(*) AS n FROM _monlite_kv_zset WHERE ns = ? AND k = ?`
+      ).get(ns, key).n;
+    },
+    zrank(key, member, opts) {
+      const row = driver.prepare(
+        `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`
+      ).get(ns, key, member);
+      if (!row) return void 0;
+      const cmp = opts?.rev ? `score > ? OR (score = ? AND member > ?)` : `score < ? OR (score = ? AND member < ?)`;
+      return driver.prepare(
+        `SELECT COUNT(*) AS n FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND (${cmp})`
+      ).get(ns, key, row.score, row.score, member).n;
+    },
+    zrange(key, start, stop, opts) {
+      const card = api.zcard(key);
+      let lo = start < 0 ? card + start : start;
+      let hi = stop < 0 ? card + stop : stop;
+      if (lo < 0) lo = 0;
+      if (hi >= card) hi = card - 1;
+      if (card === 0 || lo > hi) return [];
+      const dir = opts?.rev ? "DESC" : "ASC";
+      const rows = driver.prepare(
+        `SELECT member, score FROM _monlite_kv_zset WHERE ns = ? AND k = ?
+           ORDER BY score ${dir}, member ${dir} LIMIT ? OFFSET ?`
+      ).all(ns, key, hi - lo + 1, lo);
+      return opts?.withScores ? rows : rows.map((r) => r.member);
+    },
+    zrangeByScore(key, min, max, opts) {
+      const rows = driver.prepare(
+        `SELECT member, score FROM _monlite_kv_zset WHERE ns = ? AND k = ?
+           AND score >= ? AND score <= ? ORDER BY score ASC, member ASC`
+      ).all(ns, key, min, max);
+      return opts?.withScores ? rows : rows.map((r) => r.member);
+    },
     publish(channel, message) {
       const ts = now();
       driver.prepare(
@@ -144,23 +216,22 @@ function kv(db, options = {}) {
     subscribe(channel, cb) {
       const sub = { channel, cb, cursor: psMaxSeq() };
       subs.add(sub);
-      if (!psTimer) {
-        psTimer = setInterval(drainPubsub, pubsubPollMs);
-        psTimer.unref?.();
-      }
+      if (!psTask) psTask = db.heartbeat.every(pubsubPollMs, drainPubsub);
       return () => {
         subs.delete(sub);
-        if (subs.size === 0 && psTimer) {
-          clearInterval(psTimer);
-          psTimer = void 0;
+        if (subs.size === 0 && psTask) {
+          psTask.cancel();
+          psTask = void 0;
         }
       };
     },
     stop() {
       if (timer) clearInterval(timer);
       timer = void 0;
-      if (psTimer) clearInterval(psTimer);
-      psTimer = void 0;
+      if (psTask) {
+        psTask.cancel();
+        psTask = void 0;
+      }
     }
   };
   if (options.sweepIntervalMs && options.sweepIntervalMs > 0) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAwDA,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;AAAA;AAAA;AAAA;AAAA;AAAA,+EAAA;AAAA,KASF;AACA,IAAA,OAAA,CAAQ,IAAI,EAAE,CAAA;AAAA,EAChB;AAEA,EAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,GAAA,EAAI;AAC3B,EAAA,MAAM,eAAe,IAAA,CAAK,GAAA,CAAI,EAAA,EAAI,OAAA,CAAQ,gBAAgB,GAAG,CAAA;AAC7D,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;AAIJ,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAS;AAC1B,EAAA,IAAI,OAAA;AAEJ,EAAA,MAAM,QAAA,GAAW,MAEb,MAAA,CACG,OAAA,CAAQ,2DAA2D,CAAA,CACnE,GAAA,CAAI,EAAE,CAAA,CACT,CAAA,IAAK,CAAA;AAGT,EAAA,MAAM,cAAc,MAAY;AAC9B,IAAA,IAAI,IAAA,CAAK,SAAS,CAAA,EAAG;AACrB,IAAA,IAAI,GAAA,GAAM,QAAA;AACV,IAAA,KAAA,MAAW,KAAK,IAAA,EAAM,GAAA,GAAM,KAAK,GAAA,CAAI,GAAA,EAAK,EAAE,MAAM,CAAA;AAClD,IAAA,MAAM,OAAO,MAAA,CACV,OAAA;AAAA,MACC,CAAA,0FAAA;AAAA,KACF,CACC,GAAA,CAAI,EAAA,EAAI,GAAG,CAAA;AACd,IAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AACvB,IAAA,KAAA,MAAW,CAAA,IAAK,CAAC,GAAG,IAAI,CAAA,EAAG;AACzB,MAAA,KAAA,MAAW,KAAK,IAAA,EAAM;AACpB,QAAA,IAAI,CAAA,CAAE,GAAA,IAAO,CAAA,CAAE,MAAA,EAAQ;AACvB,QAAA,CAAA,CAAE,SAAS,CAAA,CAAE,GAAA;AACb,QAAA,IAAI,CAAA,CAAE,OAAA,KAAY,CAAA,CAAE,OAAA,EAAS;AAC3B,UAAA,IAAI;AACF,YAAA,CAAA,CAAE,GAAG,IAAA,CAAK,KAAA,CAAM,CAAA,CAAE,OAAA,IAAW,MAAM,CAAC,CAAA;AAAA,UACtC,CAAA,CAAA,MAAQ;AAAA,UAER;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAA;AAEA,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;AAGvD,MAAA,MAAA,CAAO,KAAK,IAAA,CAAK,SAAA,CAAU,KAAA,IAAS,IAAI,GAAG,OAAO,CAAA;AAAA,IACpD,CAAA;AAAA,IACA,KAAA,CAAM,GAAA,EAAK,KAAA,EAAO,IAAA,EAAM;AAGtB,MAAA,OAAO,MAAA,CAAO,YAAY,MAAM;AAC9B,QAAA,MAAM,GAAA,GAAM,OAAO,GAAG,CAAA;AACtB,QAAA,IAAI,KAAA,CAAM,GAAG,CAAA,EAAG,OAAO,KAAA;AACvB,QAAA,MAAM,UAAU,IAAA,EAAM,GAAA,IAAO,OAAO,GAAA,EAAI,GAAI,KAAK,GAAA,GAAM,IAAA;AAGvD,QAAA,MAAA,CAAO,KAAK,IAAA,CAAK,SAAA,CAAU,KAAA,IAAS,IAAI,GAAG,OAAO,CAAA;AAClD,QAAA,OAAO,IAAA;AAAA,MACT,GAAG,IAAI,CAAA;AAAA,IACT,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;AAE9B,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,GAAG,IAAI,CAAA;AAAA,IACT,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,OAAA,CAAQ,SAAS,OAAA,EAAS;AACxB,MAAA,MAAM,KAAK,GAAA,EAAI;AACf,MAAA,MAAA,CACG,OAAA;AAAA,QACC,CAAA,6EAAA;AAAA,OACF,CACC,IAAI,EAAA,EAAI,OAAA,EAAS,KAAK,SAAA,CAAU,OAAA,IAAW,IAAI,CAAA,EAAG,EAAE,CAAA;AAGvD,MAAA,MAAA,CACG,OAAA,CAAQ,CAAA,2CAAA,CAA6C,CAAA,CACrD,GAAA,CAAI,KAAK,GAAM,CAAA;AAGlB,MAAA,WAAA,EAAY;AACZ,MAAA,IAAI,CAAA,GAAI,CAAA;AACR,MAAA,KAAA,MAAW,CAAA,IAAK,IAAA,EAAM,IAAI,CAAA,CAAE,YAAY,OAAA,EAAS,CAAA,EAAA;AACjD,MAAA,OAAO,CAAA;AAAA,IACT,CAAA;AAAA,IACA,SAAA,CAAU,SAAS,EAAA,EAAI;AACrB,MAAA,MAAM,MAAW,EAAE,OAAA,EAAS,EAAA,EAAI,MAAA,EAAQ,UAAS,EAAE;AACnD,MAAA,IAAA,CAAK,IAAI,GAAG,CAAA;AACZ,MAAA,IAAI,CAAC,OAAA,EAAS;AACZ,QAAA,OAAA,GAAU,WAAA,CAAY,aAAa,YAAY,CAAA;AAC/C,QAAA,OAAA,CAAQ,KAAA,IAAQ;AAAA,MAClB;AACA,MAAA,OAAO,MAAM;AACX,QAAA,IAAA,CAAK,OAAO,GAAG,CAAA;AACf,QAAA,IAAI,IAAA,CAAK,IAAA,KAAS,CAAA,IAAK,OAAA,EAAS;AAC9B,UAAA,aAAA,CAAc,OAAO,CAAA;AACrB,UAAA,OAAA,GAAU,MAAA;AAAA,QACZ;AAAA,MACF,CAAA;AAAA,IACF,CAAA;AAAA,IACA,IAAA,GAAO;AACL,MAAA,IAAI,KAAA,gBAAqB,KAAK,CAAA;AAC9B,MAAA,KAAA,GAAQ,MAAA;AACR,MAAA,IAAI,OAAA,gBAAuB,OAAO,CAAA;AAClC,MAAA,OAAA,GAAU,MAAA;AAAA,IACZ;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  /** How often (ms) a `subscribe()` listener polls for cross-process messages. Default `200`. */\n  pubsubPollMs?: 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  /**\n   * Publish a message to a channel (Redis `PUBLISH`). Delivered to every\n   * `subscribe()` listener on that channel — including in OTHER processes\n   * sharing this database. Ephemeral: not replayed to late subscribers. Returns\n   * the number of listeners on this instance that received it.\n   */\n  publish(channel: string, message: any): number;\n  /**\n   * Subscribe to a channel (Redis `SUBSCRIBE`). The callback fires for each\n   * message published AFTER this call, cross-process. Returns an unsubscribe.\n   */\n  subscribe(channel: string, cb: (message: any) => void): () => void;\n  /** Stop the sweep + pub/sub timers (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      CREATE TABLE IF NOT EXISTS _monlite_kv_pubsub (\n        seq INTEGER PRIMARY KEY AUTOINCREMENT,\n        ns TEXT NOT NULL, channel TEXT NOT NULL, payload TEXT, ts INTEGER NOT NULL\n      );\n      CREATE INDEX IF NOT EXISTS _idx_kv_pubsub ON _monlite_kv_pubsub (ns, seq)`,\n    );\n    ensured.add(db);\n  }\n\n  const now = () => Date.now();\n  const pubsubPollMs = Math.max(20, options.pubsubPollMs ?? 200);\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  // ── pub/sub ──────────────────────────────────────────────────────────────\n  type Sub = { channel: string; cb: (m: any) => void; cursor: number };\n  const subs = new Set<Sub>();\n  let psTimer: ReturnType<typeof setInterval> | undefined;\n\n  const psMaxSeq = (): number =>\n    (\n      driver\n        .prepare(`SELECT MAX(seq) AS s FROM _monlite_kv_pubsub WHERE ns = ?`)\n        .get(ns) as { s: number | null }\n    ).s ?? 0;\n\n  /** Deliver new messages to every local subscriber (cross-process via the table). */\n  const drainPubsub = (): void => {\n    if (subs.size === 0) return;\n    let min = Infinity;\n    for (const s of subs) min = Math.min(min, s.cursor);\n    const rows = driver\n      .prepare(\n        `SELECT seq, channel, payload FROM _monlite_kv_pubsub WHERE ns = ? AND seq > ? ORDER BY seq`,\n      )\n      .all(ns, min) as Array<{ seq: number; channel: string; payload: string }>;\n    if (rows.length === 0) return;\n    for (const s of [...subs]) {\n      for (const r of rows) {\n        if (r.seq <= s.cursor) continue;\n        s.cursor = r.seq;\n        if (r.channel === s.channel) {\n          try {\n            s.cb(JSON.parse(r.payload ?? \"null\"));\n          } catch {\n            /* a subscriber callback must not break delivery to others */\n          }\n        }\n      }\n    }\n  };\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      // `?? null` so `set(key, undefined)` stores JSON null (round-trips to null)\n      // instead of binding `undefined` and tripping the NOT NULL constraint.\n      setRaw(key, JSON.stringify(value ?? null), 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        // `?? null` so `set(key, undefined)` stores JSON null (round-trips to null)\n        // instead of binding `undefined` and tripping the NOT NULL constraint.\n        setRaw(key, JSON.stringify(value ?? null), 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(() => {\n        // 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    publish(channel, message) {\n      const ts = now();\n      driver\n        .prepare(\n          `INSERT INTO _monlite_kv_pubsub (ns, channel, payload, ts) VALUES (?, ?, ?, ?)`,\n        )\n        .run(ns, channel, JSON.stringify(message ?? null), ts);\n      // Ephemeral: prune old messages (late subscribers don't replay) so the\n      // table can't grow unbounded.\n      driver\n        .prepare(`DELETE FROM _monlite_kv_pubsub WHERE ts < ?`)\n        .run(ts - 30_000);\n      // Deliver to same-instance subscribers immediately (cross-process listeners\n      // pick it up on their next poll).\n      drainPubsub();\n      let n = 0;\n      for (const s of subs) if (s.channel === channel) n++;\n      return n;\n    },\n    subscribe(channel, cb) {\n      const sub: Sub = { channel, cb, cursor: psMaxSeq() }; // start at \"now\" — no replay\n      subs.add(sub);\n      if (!psTimer) {\n        psTimer = setInterval(drainPubsub, pubsubPollMs);\n        psTimer.unref?.();\n      }\n      return () => {\n        subs.delete(sub);\n        if (subs.size === 0 && psTimer) {\n          clearInterval(psTimer);\n          psTimer = undefined;\n        }\n      };\n    },\n    stop() {\n      if (timer) clearInterval(timer);\n      timer = undefined;\n      if (psTimer) clearInterval(psTimer);\n      psTimer = 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, HeartbeatTask } 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  /** How often (ms) a `subscribe()` listener polls for cross-process messages. Default `200`. */\n  pubsubPollMs?: 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\n  // ── sorted sets (Redis ZSET) — leaderboards, rate-limiters, priority indexes ──\n  /** Add or update `member` with `score` (Redis `ZADD`). */\n  zadd(key: string, score: number, member: string): void;\n  /** Increment `member`'s score by `delta` (`ZINCRBY`); returns the new score. */\n  zincrby(key: string, delta: number, member: string): number;\n  /** A member's score, or `undefined` if absent (`ZSCORE`). */\n  zscore(key: string, member: string): number | undefined;\n  /** Remove `member` (`ZREM`); returns `true` if it existed. */\n  zrem(key: string, member: string): boolean;\n  /** Number of members (`ZCARD`). */\n  zcard(key: string): number;\n  /** 0-based rank by ascending score (ties lexicographic); `rev` for descending. `undefined` if absent. */\n  zrank(\n    key: string,\n    member: string,\n    opts?: { rev?: boolean },\n  ): number | undefined;\n  /**\n   * Members by rank range `[start, stop]` inclusive (negative counts from the end,\n   * Redis-style), ascending by score (`rev` = descending). With `withScores`,\n   * returns `{ member, score }[]` (`ZRANGE` / `ZREVRANGE`).\n   */\n  zrange(\n    key: string,\n    start: number,\n    stop: number,\n    opts?: { rev?: boolean; withScores?: boolean },\n  ): string[] | Array<{ member: string; score: number }>;\n  /** Members with `min <= score <= max`, ascending (`ZRANGEBYSCORE`). */\n  zrangeByScore(\n    key: string,\n    min: number,\n    max: number,\n    opts?: { withScores?: boolean },\n  ): string[] | Array<{ member: string; score: number }>;\n\n  /**\n   * Publish a message to a channel (Redis `PUBLISH`). Delivered to every\n   * `subscribe()` listener on that channel — including in OTHER processes\n   * sharing this database. Ephemeral: not replayed to late subscribers. Returns\n   * the number of listeners on this instance that received it.\n   */\n  publish(channel: string, message: any): number;\n  /**\n   * Subscribe to a channel (Redis `SUBSCRIBE`). The callback fires for each\n   * message published AFTER this call, cross-process. Returns an unsubscribe.\n   */\n  subscribe(channel: string, cb: (message: any) => void): () => void;\n  /** Stop the sweep + pub/sub timers (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      CREATE TABLE IF NOT EXISTS _monlite_kv_pubsub (\n        seq INTEGER PRIMARY KEY AUTOINCREMENT,\n        ns TEXT NOT NULL, channel TEXT NOT NULL, payload TEXT, ts INTEGER NOT NULL\n      );\n      CREATE INDEX IF NOT EXISTS _idx_kv_pubsub ON _monlite_kv_pubsub (ns, seq);\n      CREATE TABLE IF NOT EXISTS _monlite_kv_zset (\n        ns TEXT NOT NULL, k TEXT NOT NULL, member TEXT NOT NULL, score REAL NOT NULL,\n        PRIMARY KEY (ns, k, member)\n      );\n      CREATE INDEX IF NOT EXISTS _idx_kv_zset ON _monlite_kv_zset (ns, k, score, member)`,\n    );\n    ensured.add(db);\n  }\n\n  const now = () => Date.now();\n  const pubsubPollMs = Math.max(20, options.pubsubPollMs ?? 200);\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  // ── pub/sub ──────────────────────────────────────────────────────────────\n  type Sub = { channel: string; cb: (m: any) => void; cursor: number };\n  const subs = new Set<Sub>();\n  let psTask: HeartbeatTask | undefined;\n\n  const psMaxSeq = (): number =>\n    (\n      driver\n        .prepare(`SELECT MAX(seq) AS s FROM _monlite_kv_pubsub WHERE ns = ?`)\n        .get(ns) as { s: number | null }\n    ).s ?? 0;\n\n  /** Deliver new messages to every local subscriber (cross-process via the table). */\n  const drainPubsub = (): void => {\n    if (subs.size === 0) return;\n    let min = Infinity;\n    for (const s of subs) min = Math.min(min, s.cursor);\n    const rows = driver\n      .prepare(\n        `SELECT seq, channel, payload FROM _monlite_kv_pubsub WHERE ns = ? AND seq > ? ORDER BY seq`,\n      )\n      .all(ns, min) as Array<{ seq: number; channel: string; payload: string }>;\n    if (rows.length === 0) return;\n    for (const s of [...subs]) {\n      for (const r of rows) {\n        if (r.seq <= s.cursor) continue;\n        s.cursor = r.seq;\n        if (r.channel === s.channel) {\n          try {\n            s.cb(JSON.parse(r.payload ?? \"null\"));\n          } catch {\n            /* a subscriber callback must not break delivery to others */\n          }\n        }\n      }\n    }\n  };\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      // `?? null` so `set(key, undefined)` stores JSON null (round-trips to null)\n      // instead of binding `undefined` and tripping the NOT NULL constraint.\n      setRaw(key, JSON.stringify(value ?? null), 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        // `?? null` so `set(key, undefined)` stores JSON null (round-trips to null)\n        // instead of binding `undefined` and tripping the NOT NULL constraint.\n        setRaw(key, JSON.stringify(value ?? null), 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(() => {\n        // 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\n    // ── sorted sets ──────────────────────────────────────────────────────────\n    zadd(key, score, member) {\n      driver\n        .prepare(\n          `INSERT INTO _monlite_kv_zset (ns, k, member, score) VALUES (?, ?, ?, ?)\n           ON CONFLICT(ns, k, member) DO UPDATE SET score = excluded.score`,\n        )\n        .run(ns, key, member, score);\n    },\n    zincrby(key, delta, member) {\n      // IMMEDIATE: atomic read-modify-write across processes.\n      return driver.transaction(() => {\n        const row = driver\n          .prepare(\n            `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`,\n          )\n          .get(ns, key, member) as { score: number } | undefined;\n        const next = (row?.score ?? 0) + delta;\n        driver\n          .prepare(\n            `INSERT INTO _monlite_kv_zset (ns, k, member, score) VALUES (?, ?, ?, ?)\n             ON CONFLICT(ns, k, member) DO UPDATE SET score = excluded.score`,\n          )\n          .run(ns, key, member, next);\n        return next;\n      }, true);\n    },\n    zscore(key, member) {\n      const row = driver\n        .prepare(\n          `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`,\n        )\n        .get(ns, key, member) as { score: number } | undefined;\n      return row?.score;\n    },\n    zrem(key, member) {\n      return (\n        driver\n          .prepare(\n            `DELETE FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`,\n          )\n          .run(ns, key, member).changes > 0\n      );\n    },\n    zcard(key) {\n      return (\n        driver\n          .prepare(\n            `SELECT COUNT(*) AS n FROM _monlite_kv_zset WHERE ns = ? AND k = ?`,\n          )\n          .get(ns, key) as { n: number }\n      ).n;\n    },\n    zrank(key, member, opts) {\n      const row = driver\n        .prepare(\n          `SELECT score FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND member = ?`,\n        )\n        .get(ns, key, member) as { score: number } | undefined;\n      if (!row) return undefined;\n      // Members ordered before this one (ties broken lexicographically by member).\n      const cmp = opts?.rev\n        ? `score > ? OR (score = ? AND member > ?)`\n        : `score < ? OR (score = ? AND member < ?)`;\n      return (\n        driver\n          .prepare(\n            `SELECT COUNT(*) AS n FROM _monlite_kv_zset WHERE ns = ? AND k = ? AND (${cmp})`,\n          )\n          .get(ns, key, row.score, row.score, member) as { n: number }\n      ).n;\n    },\n    zrange(key, start, stop, opts) {\n      const card = api.zcard(key);\n      let lo = start < 0 ? card + start : start;\n      let hi = stop < 0 ? card + stop : stop;\n      if (lo < 0) lo = 0;\n      if (hi >= card) hi = card - 1;\n      if (card === 0 || lo > hi) return [];\n      const dir = opts?.rev ? \"DESC\" : \"ASC\";\n      const rows = driver\n        .prepare(\n          `SELECT member, score FROM _monlite_kv_zset WHERE ns = ? AND k = ?\n           ORDER BY score ${dir}, member ${dir} LIMIT ? OFFSET ?`,\n        )\n        .all(ns, key, hi - lo + 1, lo) as Array<{\n        member: string;\n        score: number;\n      }>;\n      return opts?.withScores ? rows : rows.map((r) => r.member);\n    },\n    zrangeByScore(key, min, max, opts) {\n      const rows = driver\n        .prepare(\n          `SELECT member, score FROM _monlite_kv_zset WHERE ns = ? AND k = ?\n           AND score >= ? AND score <= ? ORDER BY score ASC, member ASC`,\n        )\n        .all(ns, key, min, max) as Array<{ member: string; score: number }>;\n      return opts?.withScores ? rows : rows.map((r) => r.member);\n    },\n\n    publish(channel, message) {\n      const ts = now();\n      driver\n        .prepare(\n          `INSERT INTO _monlite_kv_pubsub (ns, channel, payload, ts) VALUES (?, ?, ?, ?)`,\n        )\n        .run(ns, channel, JSON.stringify(message ?? null), ts);\n      // Ephemeral: prune old messages (late subscribers don't replay) so the\n      // table can't grow unbounded.\n      driver\n        .prepare(`DELETE FROM _monlite_kv_pubsub WHERE ts < ?`)\n        .run(ts - 30_000);\n      // Deliver to same-instance subscribers immediately (cross-process listeners\n      // pick it up on their next poll).\n      drainPubsub();\n      let n = 0;\n      for (const s of subs) if (s.channel === channel) n++;\n      return n;\n    },\n    subscribe(channel, cb) {\n      const sub: Sub = { channel, cb, cursor: psMaxSeq() }; // start at \"now\" — no replay\n      subs.add(sub);\n      // Register the cross-process poll on the shared heartbeat (one timer for the\n      // whole db), started on first subscribe and dropped when the last unsubscribes.\n      if (!psTask) psTask = db.heartbeat.every(pubsubPollMs, drainPubsub);\n      return () => {\n        subs.delete(sub);\n        if (subs.size === 0 && psTask) {\n          psTask.cancel();\n          psTask = undefined;\n        }\n      };\n    },\n    stop() {\n      if (timer) clearInterval(timer);\n      timer = undefined;\n      if (psTask) {\n        psTask.cancel();\n        psTask = undefined;\n      }\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.3.0",
+  "version": "0.4.0",
   "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.7.0"
+    "@monlite/core": "^2.8.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",