@voltro/kv 0.87.0 → 0.88.0

package/dist/connectionPrefix.js

@@ -1,4 +1,4 @@
-//#region src/connectionPrefix.ts
+// src/connectionPrefix.ts
 var e = (e) => e.replace(/[\\*?\[\]]/g, "\\$&"), t = (t, n) => {
 	if (n === void 0 || n === "") return t;
 	let r = (e) => n + e, i = (e, t) => {
@@ -33,5 +33,4 @@ var e = (e) => e.replace(/[\\*?\[\]]/g, "\\$&"), t = (t, n) => {
 		}
 	};
 };
-//#endregion
 export { t as withRespKeyPrefix };

package/dist/connectionScripts.js

@@ -1,4 +1,3 @@
-//#region src/connectionScripts.ts
+// src/connectionScripts.ts
 var e = "return redis.call('PUBLISH', ARGV[1], ARGV[2])";
-//#endregion
 export { e as CONNECTION_PUBLISH_SCRIPT };

package/dist/connectionSqlConfig.js

@@ -1,6 +1,6 @@
 import { connectionDefinitionsProblem as e } from "./connectionDefinitions.js";
 import { Config as t, ConfigProvider as n, Effect as r, Option as i } from "effect";
-//#region src/connectionSqlConfig.ts
+// src/connectionSqlConfig.ts
 var a = (e, t = {}) => {
 	let n = t.ttlMs ?? 6e4;
 	if (typeof e != "function" || !Number.isSafeInteger(n) || n <= 0) throw Error("Dynamic SQL requires a resolver and positive ttlMs");
@@ -115,5 +115,4 @@ var a = (e, t = {}) => {
 		source: i.isSome(g) ? "override" : "config"
 	};
 });
-//#endregion
 export { a as dynamicSql, d as sqlConfigProblem, p as sqlConnectionConfig, f as sqlConnectionName, u as sqlDefinitionProblem };

package/dist/connectionStorageConfig.js

@@ -1,6 +1,6 @@
 import { connectionDefinitionsProblem as e, connectionMetadataProblem as t } from "./connectionDefinitions.js";
 import { Config as n, ConfigProvider as r, Effect as i, Option as a } from "effect";
-//#region src/connectionStorageConfig.ts
+// src/connectionStorageConfig.ts
 var o = (e, t = {}) => {
 	let n = t.ttlMs ?? 6e4;
 	if (typeof e != "function" || !Number.isSafeInteger(n) || n <= 0) throw Error("Dynamic storage requires a resolver and positive ttlMs");
@@ -186,5 +186,4 @@ var o = (e, t = {}) => {
 		source: h ? "override" : "config"
 	};
 });
-//#endregion
 export { o as dynamicStorage, c as storageConfigProblem, l as storageConnectionConfig, s as storageConnectionName };

package/dist/connectionStorageFacade.js

@@ -1,6 +1,6 @@
 import { StorageError as e } from "./storage.js";
 import { Effect as t, Stream as n } from "effect";
-//#region src/connectionStorageFacade.ts
+// src/connectionStorageFacade.ts
 var r = (r) => {
 	let i = (n) => t.fail(new e({
 		provider: r.config().provider,
@@ -74,5 +74,4 @@ var r = (r) => {
 		}
 	}));
 };
-//#endregion
 export { r as makeStorageFacade };

package/dist/connectionSubscriber.js

@@ -1,48 +1,49 @@
 import { KvError as e } from "./errors.js";
-import { createNativeRedisConnection as t, disconnectNativeRedis as n, nativeRedisOptions as r, nativeRedisTopology as i } from "./nativeRedisTopology.js";
-import { Effect as a } from "effect";
-//#region src/connectionSubscriber.ts
-var o = async (e, a) => {
-	a.throwIfAborted();
-	let o = await t(e, "subscriber"), s, c = () => Promise.all([n(o), s === void 0 ? Promise.resolve() : n({
+import { missingDriver as t } from "./driverModule.js";
+import { createNativeRedisConnection as n, disconnectNativeRedis as r, nativeRedisOptions as i, nativeRedisTopology as a } from "./nativeRedisTopology.js";
+import { Effect as o } from "effect";
+// src/connectionSubscriber.ts
+var s = async (e, o) => {
+	o.throwIfAborted();
+	let s = await n(e, "subscriber"), c, l = () => Promise.all([r(s), c === void 0 ? Promise.resolve() : r({
 		kind: "standalone",
-		client: s
-	})]).then(() => void 0), l = () => {
-		c();
+		client: c
+	})]).then(() => void 0), u = () => {
+		l();
 	};
-	a.addEventListener("abort", l, { once: !0 }), o.client.on("error", () => {});
+	o.addEventListener("abort", u, { once: !0 }), s.client.on("error", () => {});
 	try {
-		if (a.throwIfAborted(), await o.client.connect(), await o.ready(), a.throwIfAborted(), o.kind !== "cluster") return {
-			client: o.client,
-			dispose: c
+		if (o.throwIfAborted(), await s.client.connect(), await s.ready(), o.throwIfAborted(), s.kind !== "cluster") return {
+			client: s.client,
+			dispose: l
 		};
-		let t = o.client.nodes("master").find((e) => e.status === "ready");
-		if (t === void 0) throw Error("No ready Cluster primary");
-		let l = t.options.host, u = t.options.port;
-		if (l === void 0 || u === void 0) throw Error("Cluster primary endpoint missing");
-		let d = i(e);
-		if (d.kind !== "cluster") throw Error("Expected Cluster topology");
-		let { default: f } = await import("ioredis");
-		return a.throwIfAborted(), s = new f({
-			...d.options,
-			...r("subscriber"),
-			host: l,
-			port: u
-		}), s.on("error", () => {}), await s.connect(), a.throwIfAborted(), await n(o), a.throwIfAborted(), {
-			client: s,
-			dispose: c
+		let n = s.client.nodes("master").find((e) => e.status === "ready");
+		if (n === void 0) throw Error("No ready Cluster primary");
+		let u = n.options.host, d = n.options.port;
+		if (u === void 0 || d === void 0) throw Error("Cluster primary endpoint missing");
+		let f = a(e);
+		if (f.kind !== "cluster") throw Error("Expected Cluster topology");
+		let { default: p } = await import("ioredis").catch(t("ioredis", "A Redis subscriber connection"));
+		return o.throwIfAborted(), c = new p({
+			...f.options,
+			...i("subscriber"),
+			host: u,
+			port: d
+		}), c.on("error", () => {}), await c.connect(), o.throwIfAborted(), await r(s), o.throwIfAborted(), {
+			client: c,
+			dispose: l
 		};
 	} catch (e) {
-		throw await c(), e;
+		throw await l(), e;
 	} finally {
-		a.removeEventListener("abort", l);
+		o.removeEventListener("abort", u);
 	}
-}, s = (t) => a.tryPromise({
+}, c = (t) => o.tryPromise({
 	try: async (e) => {
 		if (t.driver !== "resp") throw Error("RESP is required for subscriptions");
-		let n = await o(t, e);
+		let n = await s(t, e);
 		e.aborted && (await n.dispose(), e.throwIfAborted());
-		let r = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), a = /* @__PURE__ */ new Set(), s = n, c = !1, l, u, d, f = Promise.resolve(), p = Promise.resolve(), m = (e) => {
+		let r = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), a = /* @__PURE__ */ new Set(), o = n, c = !1, l, u, d, f = Promise.resolve(), p = Promise.resolve(), m = (e) => {
 			let t = p.then(e);
 			return p = t.then(() => void 0, () => void 0), t;
 		}, h = (e) => {
@@ -54,12 +55,12 @@ var o = async (e, a) => {
 			return f = Promise.all([f, t]).then(() => void 0), t;
 		}, _ = (e) => {
 			e.client.on("message", (t, n) => {
-				if (!(c || s !== e)) for (let e of r) try {
+				if (!(c || o !== e)) for (let e of r) try {
 					e(t, n);
 				} catch {}
 			});
 			let t = () => {
-				c || s !== e || (s = void 0, h({ kind: "disconnected" }), g(e), y());
+				c || o !== e || (o = void 0, h({ kind: "disconnected" }), g(e), y());
 			};
 			e.client.on("close", t), e.client.on("reconnecting", t);
 		}, v = async () => {
@@ -70,13 +71,13 @@ var o = async (e, a) => {
 			};
 			e.signal.addEventListener("abort", r, { once: !0 });
 			try {
-				n = await o(t, e.signal);
+				n = await s(t, e.signal);
 				let r = n;
 				await m(async () => {
 					if (e.signal.throwIfAborted(), c) throw Error("Subscriber closed");
 					for (let e of a) await r.client.subscribe(e);
 					if (e.signal.throwIfAborted(), r.client.status !== "ready") throw Error("Subscriber lost during restoration");
-					_(r), s = r;
+					_(r), o = r;
 				}), n = void 0, h({ kind: "reconnected" });
 			} catch {
 				n !== void 0 && await g(n);
@@ -86,23 +87,23 @@ var o = async (e, a) => {
 		}, y = () => {
 			c || l !== void 0 || d !== void 0 || (l = setTimeout(() => {
 				l = void 0, d = v().finally(() => {
-					d = void 0, !c && s === void 0 && y();
+					d = void 0, !c && o === void 0 && y();
 				});
 			}, 100));
 		};
-		if (_(n), n.client.status !== "ready") throw s = void 0, await g(n), Error("Subscriber lost before admission");
+		if (_(n), n.client.status !== "ready") throw o = void 0, await g(n), Error("Subscriber lost before admission");
 		let b = () => {
-			if (c || s === void 0 || s.client.status !== "ready") throw Error("Subscriber unavailable");
-			return s;
+			if (c || o === void 0 || o.client.status !== "ready") throw Error("Subscriber unavailable");
+			return o;
 		};
 		return {
 			subscribe: (e) => m(async () => {
 				let t = b();
-				if (await t.client.subscribe(e), c || s !== t) throw Error("Subscriber lost during registration");
+				if (await t.client.subscribe(e), c || o !== t) throw Error("Subscriber lost during registration");
 				a.add(e);
 			}),
 			unsubscribe: (e) => m(async () => {
-				a.delete(e), !c && s !== void 0 && await s.client.unsubscribe(e);
+				a.delete(e), !c && o !== void 0 && await o.client.unsubscribe(e);
 			}),
 			onMessage: (e) => (r.add(e), () => {
 				r.delete(e);
@@ -113,8 +114,8 @@ var o = async (e, a) => {
 			close: async () => {
 				if (!c) {
 					c = !0, l !== void 0 && clearTimeout(l), u?.abort();
-					let e = s;
-					s = void 0, e !== void 0 && g(e), a.clear(), r.clear(), i.clear();
+					let e = o;
+					o = void 0, e !== void 0 && g(e), a.clear(), r.clear(), i.clear();
 				}
 				await d, await p, await f;
 			}
@@ -126,5 +127,4 @@ var o = async (e, a) => {
 		cause: "Redis subscriber could not be opened"
 	})
 });
-//#endregion
-export { s as connectRedisSubscriber };
+export { c as connectRedisSubscriber };

package/dist/driverModule.js

@@ -0,0 +1,9 @@
+// src/driverModule.ts
+var e = (e, t) => {
+	if (typeof e != "object" || !e) return !1;
+	let { code: n, message: r } = e;
+	return (n === "ERR_MODULE_NOT_FOUND" || n === "MODULE_NOT_FOUND") && typeof r == "string" && r.includes(t);
+}, t = (t, n) => (r) => {
+	throw e(r, t) ? Error(`${n} needs the "${t}" package, which is not installed. Add "${t}" to this app's dependencies; apps that depend on @voltro/runtime have it already.`, { cause: r }) : r;
+};
+export { t as missingDriver };

package/dist/errors.js

@@ -1,5 +1,5 @@
 import { Schema as e } from "effect";
-//#region src/errors.ts
+// src/errors.ts
 var t = class extends e.TaggedError()("KvError", {
 	operation: e.String,
 	key: e.String,
@@ -9,5 +9,4 @@ var t = class extends e.TaggedError()("KvError", {
 		return this.cause;
 	}
 };
-//#endregion
 export { t as KvError };

package/dist/expirySweep.js

@@ -1,5 +1,5 @@
 import { HashMap as e, Option as t } from "effect";
-//#region src/expirySweep.ts
+// src/expirySweep.ts
 var n = () => {
 	let n;
 	return {
@@ -22,5 +22,4 @@ var n = () => {
 		}
 	};
 };
-//#endregion
 export { n as makeExpirySweep };

package/dist/hot-contract.js

@@ -3,7 +3,7 @@ import { hotStoreFromRunner as t, validateHotOp as n } from "./hotOperations.js"
 import { applyHotOperations as r, compareHotMembers as i } from "./hotState.js";
 import { readHotStoreWithFallback as a } from "./hotReadAvailability.js";
 import { Context as o, Schema as s } from "effect";
-//#region src/HotStore.ts
+// src/HotStore.ts
 var c = class extends s.TaggedError()("HotError", {
 	operation: s.String,
 	key: s.String,
@@ -14,5 +14,4 @@ var c = class extends s.TaggedError()("HotError", {
 		"unavailable"
 	])
 }) {}, l = class extends o.Service()("@voltro/HotStore") {};
-//#endregion
 export { c as HotError, l as HotStore, r as applyHotOperations, i as compareHotMembers, e as consumeHotRateLimit, t as hotStoreFromRunner, a as readHotStoreWithFallback, n as validateHotOp };

package/dist/hot-testing.d.ts

@@ -23,6 +23,19 @@ export declare interface HotConformanceFixture {
     readonly capabilities: HotStoreShape['capabilities'];
 }
 
+/** Runner operations used by the suite; supplied by the test-only caller. */
+export declare interface HotConformanceTestApi {
+    readonly describe: (name: string, body: () => void) => unknown;
+    readonly it: (name: string, body: () => Promise<void>) => unknown;
+    readonly expect: (actual: unknown) => {
+        readonly toEqual: (expected: unknown) => unknown;
+        readonly toBe: (expected: unknown) => unknown;
+        readonly toHaveLength: (expected: number) => unknown;
+        readonly toBeGreaterThan: (expected: number) => unknown;
+        readonly toBeLessThanOrEqual: (expected: number) => unknown;
+    };
+}
+
 declare interface HotCounterOptions extends HotTtl {
     readonly max?: number;
 }
@@ -178,7 +191,7 @@ declare class HotStore extends HotStore_base {
 declare const HotStore_base: Context.ServiceClass<HotStore, "@voltro/HotStore", HotStoreShape>;
 
 /** Run exactly the same behavioral contract against a backend or a replacement port. */
-export declare const hotStoreConformance: (name: string, fixture: () => HotConformanceFixture) => void;
+export declare const hotStoreConformance: (name: string, fixture: () => HotConformanceFixture, tests: HotConformanceTestApi) => void;
 
 declare interface HotStoreShape {
     readonly zadd: (key: string, members: ReadonlyArray<HotMember>, options?: HotZaddOptions) => Effect.Effect<void, HotError>;

package/dist/hotMemory.js

@@ -2,7 +2,7 @@ import { hotStoreFromRunner as e, validateHotOp as t } from "./hotOperations.js"
 import { applyHotOperations as n, compareHotMembers as r } from "./hotState.js";
 import { HotError as i, HotStore as a } from "./hot-contract.js";
 import { Clock as o, Effect as s, Layer as c, Stream as l } from "effect";
-//#region src/hotMemory.ts
+// src/hotMemory.ts
 var u = { sweepBatchSize: 32 }, d = (a = {}) => s.try({
 	try: () => {
 		let c = /* @__PURE__ */ new Map(), d = a.sweepBatchSize ?? u.sweepBatchSize;
@@ -42,5 +42,4 @@ var u = { sweepBatchSize: 32 }, d = (a = {}) => s.try({
 		reason: "invalid"
 	})
 }), f = (e = {}) => c.effect(a, d(e));
-//#endregion
 export { u as HOT_MEMORY_DEFAULTS, f as layerHotMemory, d as makeMemoryHotStore };

package/dist/hotOperations.js

@@ -1,6 +1,6 @@
 import { HotError as e } from "./hot-contract.js";
 import { Effect as t, Option as n } from "effect";
-//#region src/hotOperations.ts
+// src/hotOperations.ts
 var r = /* @__PURE__ */ new Set([
 	"zrank",
 	"zscore",
@@ -219,5 +219,4 @@ var r = /* @__PURE__ */ new Set([
 		capabilities: o
 	};
 };
-//#endregion
 export { s as hotStoreFromRunner, i as isHotReadOperation, o as validateHotOp, a as validateHotReadOptions };

package/dist/hotRateLimit.js

@@ -1,4 +1,4 @@
-//#region src/hotRateLimit.ts
+// src/hotRateLimit.ts
 var e = (e, i, a) => {
 	switch (i.algorithm) {
 		case "fixed-window": return t(e, i, a);
@@ -99,5 +99,4 @@ var e = (e, i, a) => {
 		}
 	};
 };
-//#endregion
 export { e as consumeHotRateLimit };

package/dist/hotReadAvailability.js

@@ -1,6 +1,6 @@
 import { HotError as e } from "./hot-contract.js";
 import { Effect as t } from "effect";
-//#region src/hotReadAvailability.ts
+// src/hotReadAvailability.ts
 var n = (n) => t.suspend(() => n.onUnavailable !== "degrade" && n.onUnavailable !== "fail" ? t.fail(new e({
 	operation: "readFallback",
 	key: "",
@@ -15,5 +15,4 @@ var n = (n) => t.suspend(() => n.onUnavailable !== "degrade" && n.onUnavailable
 	smembers: (...e) => n.store.smembers(...e),
 	sismember: (...e) => n.store.sismember(...e)
 }).pipe(t.catch((e) => typeof e == "object" && e && e._tag === "HotError" && e.reason === "unavailable" && n.onUnavailable === "degrade" ? t.suspend(n.fallback) : t.fail(e))));
-//#endregion
 export { n as readHotStoreWithFallback };

package/dist/hotRedis.js

@@ -3,7 +3,7 @@ import { hotStoreFromRunner as t, isHotReadOperation as n, validateHotOp as r, v
 import { HotError as a, HotStore as o } from "./hot-contract.js";
 import { HOT_SCRIPT as s } from "./hotRedisScript.js";
 import { Effect as c, Layer as l, Option as u, Stream as d } from "effect";
-//#region src/hotRedis.ts
+// src/hotRedis.ts
 var f = {
 	connectionName: "hot",
 	namespace: "voltro:hot",
@@ -135,5 +135,4 @@ var f = {
 		})
 	});
 }));
-//#endregion
 export { f as HOT_REDIS_DEFAULTS, h as layerHotRedis, m as makeRedisHotStore };

package/dist/hotRedisScript.js

@@ -1,4 +1,3 @@
-//#region src/hotRedisScript.ts
+// src/hotRedisScript.ts
 var e = "\nlocal ops = cjson.decode(ARGV[1])\nlocal tm = redis.call('TIME')\nlocal now = tonumber(tm[1]) * 1000 + math.floor(tonumber(tm[2]) / 1000)\nlocal out = {}\nlocal function fail(op, reason)\n  return cjson.encode({ failure = { operation = op.op, key = op.key, reason = reason } })\nend\nlocal function ttl(k, o)\n  if o and o.ttlMs then redis.call('PEXPIRE', k, string.format('%.0f', o.ttlMs)) end\nend\nlocal function numberString(k, prefix)\n  local raw = redis.call('GET', k)\n  if not raw then return nil end\n  if string.sub(raw, 1, 2) ~= prefix then error('WRONGTYPE') end\n  return string.sub(raw, 3)\nend\nlocal function run(o, k)\n  local op = o.op\n  local expected\n  if string.sub(op, 1, 1) == 'z' then expected = 'zset'\n  elseif string.sub(op, 1, 1) == 'h' then expected = 'hash'\n  elseif op == 'sadd' or op == 'srem' or op == 'smembers' or op == 'sismember' then expected = 'set' end\n  if expected then\n    local actual = redis.call('TYPE', k).ok\n    if actual ~= 'none' and actual ~= expected then error('WRONGTYPE') end\n  end\n  if op == 'zadd' then\n    local pending = {}\n    local mode = o.options and o.options.mode or 'set'\n    for _, m in ipairs(o.members) do\n      local old\n      if mode ~= 'set' then old = pending[m.member] or tonumber(redis.call('ZSCORE', k, m.member)) end\n      local score = m.score\n      if old then\n        if mode == 'max' then score = math.max(old, score)\n        elseif mode == 'min' then score = math.min(old, score)\n        elseif mode == 'incr' then score = old + score end\n      end\n      if score == math.huge or score == -math.huge or score ~= score then error('HOT_INVALID') end\n      pending[m.member] = score\n    end\n    -- RESP-family Lua bridges differ in number-to-argument precision.\n    for member, score in pairs(pending) do redis.call('ZADD', k, string.format('%.17g', score), member) end\n    ttl(k, o.options); return cjson.null\n  elseif op == 'zrem' then\n    local count = 0\n    for _, member in ipairs(o.members) do count = count + redis.call('ZREM', k, member) end\n    return count\n  elseif op == 'zrank' then\n    local cmd = o.order == 'desc' and 'ZREVRANK' or 'ZRANK'\n    return redis.call(cmd, k, o.member) or cjson.null\n  elseif op == 'zscore' then\n    return tonumber(redis.call('ZSCORE', k, o.member)) or cjson.null\n  elseif op == 'zcard' then return redis.call('ZCARD', k)\n  elseif op == 'zrange' then\n    local raw\n    local limit = o.options and o.options.limit\n    if limit == 0 then return {} end\n    if o.range.byRank then\n      local cmd = o.order == 'desc' and 'ZREVRANGE' or 'ZRANGE'\n      local lo, hi = o.range.byRank[1], o.range.byRank[2]\n      if limit then\n        local count = redis.call('ZCARD', k)\n        if lo < 0 then lo = count + lo end\n        if hi < 0 then hi = count + hi end\n        lo = math.max(0, lo)\n        hi = math.min(hi, lo + limit - 1)\n        if hi < lo then return {} end\n      end\n      raw = redis.call(cmd, k, string.format('%.0f', lo), string.format('%.0f', hi), 'WITHSCORES')\n    else\n      local cmd = o.order == 'desc' and 'ZREVRANGEBYSCORE' or 'ZRANGEBYSCORE'\n      local lo, hi = o.range.byScore[1], o.range.byScore[2]\n      if lo > hi then return {} end\n      if o.order == 'desc' then lo, hi = hi, lo end\n      if limit then raw = redis.call(cmd, k, string.format('%.17g', lo), string.format('%.17g', hi), 'WITHSCORES', 'LIMIT', 0, limit)\n      else raw = redis.call(cmd, k, string.format('%.17g', lo), string.format('%.17g', hi), 'WITHSCORES') end\n    end\n    local result = {}\n    for i = 1, #raw / 2 do\n      local score = raw[i * 2]\n      if type(score) == 'number' then score = string.format('%.17g', score) end\n      table.insert(result, { member = raw[i * 2 - 1], score = score })\n    end\n    return result\n  elseif op == 'zremRange' then\n    local pair = o.range.byRank or o.range.byScore\n    local cmd = o.range.byRank and 'ZREMRANGEBYRANK' or 'ZREMRANGEBYSCORE'\n    local format = o.range.byRank and '%.0f' or '%.17g'\n    return redis.call(cmd, k, string.format(format, pair[1]), string.format(format, pair[2]))\n  elseif op == 'incrBy' then\n    local value = tonumber(numberString(k, 'c:')) or 0\n    value = value + o.delta\n    if math.abs(value) > 9007199254740991 then error('HOT_INVALID') end\n    if o.options and o.options.max and value > o.options.max then error('HOT_LIMIT') end\n    redis.call('SET', k, 'c:' .. string.format('%.0f', value), 'KEEPTTL')\n    ttl(k, o.options); return value\n  elseif op == 'tokenBucket' then\n    local raw = numberString(k, 'b:')\n    local old = raw and cjson.decode(raw) or { tokens = o.config.capacity, updatedAt = now }\n    local available = math.min(o.config.capacity, tonumber(old.tokens) + math.max(0, now - tonumber(old.updatedAt)) * o.config.refillPerSec / 1000)\n    local allowed = available >= o.cost\n    local remaining = available\n    if allowed then remaining = remaining - o.cost end\n    local retry = allowed and 0 or math.ceil((o.cost - available) / o.config.refillPerSec * 1000)\n    local life = math.max(1, math.ceil(o.config.capacity / o.config.refillPerSec * 1000))\n    redis.call('SET', k, 'b:' .. cjson.encode({ tokens = string.format('%.17g', remaining), updatedAt = string.format('%.0f', math.max(now, tonumber(old.updatedAt))) }), 'PX', string.format('%.0f', life))\n    return { allowed = allowed, remaining = string.format('%.17g', remaining), retryAfterMs = string.format('%.0f', retry) }\n  elseif op == 'rateLimit' then\n    local raw = numberString(k, 'r:')\n    local s = raw and cjson.decode(raw) or nil\n    local cfg = o.config\n    local at = o.nowMs or now\n    local limit, windowMs, capacity = cfg.limit, cfg.windowMs, cfg.burst\n    local allowed, remaining, resetAt, retryAfter\n    local state\n    if cfg.algorithm == 'fixed-window' then\n      local start = s and s.kind == 'fixed' and tonumber(s.windowStart) or at\n      local count = s and s.kind == 'fixed' and tonumber(s.count) or 0\n      if at - start >= windowMs then start = at; count = 0 end\n      resetAt = start + windowMs\n      allowed = count < limit\n      if allowed then count = count + 1 end\n      remaining = allowed and limit - count or 0\n      retryAfter = allowed and 0 or resetAt - at\n      state = { kind = 'fixed', windowStart = start, count = count }\n    elseif cfg.algorithm == 'sliding-window' then\n      local start = s and s.kind == 'sliding' and tonumber(s.currStart) or at\n      local current = s and s.kind == 'sliding' and tonumber(s.currCount) or 0\n      local previous = s and s.kind == 'sliding' and tonumber(s.prevCount) or 0\n      local elapsed = math.floor((at - start) / windowMs)\n      if elapsed >= 2 then previous = 0; current = 0; start = at\n      elseif elapsed == 1 then previous = current; current = 0; start = start + windowMs end\n      local weight = (windowMs - (at - start)) / windowMs\n      local estimate = previous * weight + current\n      resetAt = start + windowMs\n      allowed = estimate < limit\n      if allowed then current = current + 1 end\n      remaining = allowed and math.max(0, math.floor(limit - estimate - 1)) or 0\n      retryAfter = allowed and 0 or resetAt - at\n      state = { kind = 'sliding', currStart = start, currCount = current, prevCount = previous }\n    else\n      local tokens = s and s.kind == 'token' and tonumber(s.tokens) or capacity\n      local last = s and s.kind == 'token' and tonumber(s.lastRefill) or at\n      local refill = limit / windowMs\n      tokens = math.min(capacity, tokens + (at - last) * refill)\n      allowed = tokens >= 1\n      if allowed then tokens = tokens - 1 end\n      retryAfter = allowed and 0 or math.ceil((1 - tokens) / refill)\n      remaining = allowed and math.floor(tokens) or 0\n      resetAt = at + (allowed and math.ceil((capacity - tokens) / refill) or retryAfter)\n      state = { kind = 'token', tokens = tokens, lastRefill = at }\n    end\n    for field, value in pairs(state) do\n      if type(value) == 'number' then state[field] = string.format('%.17g', value) end\n    end\n    redis.call('SET', k, 'r:' .. cjson.encode(state), 'PX', string.format('%.0f', math.ceil(math.max(windowMs * 2, 60000) + 1000)))\n    return { allowed = allowed, remaining = string.format('%.17g', remaining), resetAtMs = string.format('%.17g', resetAt), retryAfterMs = string.format('%.17g', retryAfter) }\n  elseif op == 'hset' then\n    for f, v in pairs(o.fields) do redis.call('HSET', k, f, v) end\n    ttl(k, o.options); return cjson.null\n  elseif op == 'hget' then return redis.call('HGET', k, o.field) or cjson.null\n  elseif op == 'hgetAll' then\n    local raw = redis.call('HGETALL', k)\n    local fields = {}\n    for i = 1, #raw, 2 do fields[raw[i]] = raw[i + 1] end\n    return fields\n  elseif op == 'hdel' then\n    local count = 0\n    for _, field in ipairs(o.fields) do count = count + redis.call('HDEL', k, field) end\n    return count\n  elseif op == 'sadd' or op == 'srem' then\n    local count = 0\n    for _, member in ipairs(o.members) do count = count + redis.call(op == 'sadd' and 'SADD' or 'SREM', k, member) end\n    if op == 'sadd' then ttl(k, o.options) end\n    return count\n  elseif op == 'smembers' then\n    local members = redis.call('SMEMBERS', k); table.sort(members); return members\n  elseif op == 'sismember' then return redis.call('SISMEMBER', k, o.member) == 1\n  elseif op == 'setNx' then return redis.call('SET', k, 'l:' .. o.value, 'NX', 'PX', string.format('%.0f', o.ttlMs)) ~= false\n  elseif op == 'compareDelete' or op == 'compareExpire' then\n    local value = numberString(k, 'l:')\n    if value == nil or value ~= o.value then return false end\n    if op == 'compareDelete' then return redis.call('DEL', k) == 1 end\n    return redis.call('PEXPIRE', k, string.format('%.0f', o.ttlMs)) == 1\n  elseif op == 'expire' then redis.call('PEXPIRE', k, string.format('%.0f', o.ttlMs)); return cjson.null\n  elseif op == 'delete' then return redis.call('DEL', k) == 1 end\n  error('HOT_INVALID')\nend\nfor i, op in ipairs(ops) do\n  local ok, result = pcall(run, op, KEYS[i])\n  if not ok then\n    local reason = 'unavailable'\n    if string.find(result, 'WRONGTYPE', 1, true) then reason = 'wrongType'\n    elseif string.find(result, 'HOT_LIMIT', 1, true) then reason = 'limit'\n    elseif string.find(result, 'HOT_INVALID', 1, true) then reason = 'invalid' end\n    return fail(op, reason)\n  end\n  -- Redis cjson numbers have only 14 significant digits. Use strings on\n  -- known numeric result slots so safe integers and fractional scores survive.\n  if type(result) == 'number' then result = string.format('%.17g', result) end\n  table.insert(out, { value = result })\nend\nreturn cjson.encode({ results = out })\n";
-//#endregion
 export { e as HOT_SCRIPT };

package/dist/hotRouting.js

@@ -3,7 +3,7 @@ import { hotStoreFromRunner as t, validateHotOp as n, validateHotReadOptions as
 import { HotError as i, HotStore as a } from "./hot-contract.js";
 import { makeRedisHotStore as o } from "./hotRedis.js";
 import { Effect as s, Layer as c, Stream as l } from "effect";
-//#region src/hotRouting.ts
+// src/hotRouting.ts
 var u = (u) => c.effect(a, s.gen(function* () {
 	let a = yield* e, c = u.routes?.[u.consumer], d = c?.select, f = u.context === void 0 ? void 0 : Object.freeze({ tenantId: u.context.tenantId }), p = u.consumers?.[u.consumer] ?? u.connection, m = [...new Set(c?.connections ?? [p ?? ""])], h = u.namespace, g = u.scanCount, _ = (e, t = "") => new i({
 		operation: e,
@@ -14,7 +14,7 @@ var u = (u) => c.effect(a, s.gen(function* () {
 	let v = !0;
 	for (let e of m) {
 		if (e !== "" && !/^redis:[A-Za-z][A-Za-z0-9_-]*$/.test(e)) return yield* s.fail(_("route"));
-		(!(yield* a.validate(e).pipe(s.mapError(() => _("route")))).tenantScoped || f !== void 0) && (yield* a.config(e, f).pipe(s.mapError(() => _("route")))).driver === "memory" && (v = !1);
+		(yield* a.validate(e).pipe(s.mapError(() => _("route")))).tenantScoped && f === void 0 || (yield* a.config(e, f).pipe(s.mapError(() => _("route")))).driver !== "memory" || (v = !1);
 	}
 	if (h !== void 0 && (!h || /[{}]/.test(h)) || g !== void 0 && (!Number.isSafeInteger(g) || g < 1)) return yield* s.fail(_("route"));
 	let y = (e) => s.try({
@@ -74,5 +74,4 @@ var u = (u) => c.effect(a, s.gen(function* () {
 		persistent: !1
 	});
 }));
-//#endregion
 export { u as layerRoutedHotRedis };

package/dist/hotState.js

@@ -1,7 +1,7 @@
 import { consumeHotRateLimit as e } from "./hotRateLimit.js";
 import { validateHotOp as t } from "./hotOperations.js";
 import { HotError as n } from "./hot-contract.js";
-//#region src/hotState.ts
+// src/hotState.ts
 var r = (e, t) => {
 	let n = Array.from(e, (e) => e.codePointAt(0) ?? 0), r = Array.from(t, (e) => e.codePointAt(0) ?? 0);
 	for (let e = 0; e < Math.min(n.length, r.length); e++) {
@@ -178,5 +178,4 @@ var r = (e, t) => {
 	}
 	return f;
 };
-//#endregion
 export { s as applyHotOperations, r as compareHotMembers };