@voltro/kv 0.87.0 → 0.88.0

package/dist/Kv.js

@@ -1,6 +1,6 @@
 import { KvStore as e } from "./KvStore.js";
 import { Context as t, Effect as n, Layer as r, Option as i } from "effect";
-//#region src/Kv.ts
+// src/Kv.ts
 var a = class a extends t.Service()("@voltro/Kv", { make: n.gen(function* () {
 	let t = yield* e;
 	return {
@@ -15,5 +15,4 @@ var a = class a extends t.Service()("@voltro/Kv", { make: n.gen(function* () {
 }) }) {
 	static layer = r.effect(a, a.make);
 };
-//#endregion
 export { a as Kv };

package/dist/KvStore.js

@@ -1,5 +1,4 @@
 import { Context as e } from "effect";
-//#region src/KvStore.ts
+// src/KvStore.ts
 var t = class extends e.Service()("@voltro/KvStore") {};
-//#endregion
 export { t as KvStore };

package/dist/analytics.js

@@ -1,5 +1,5 @@
 import { Schema as e } from "effect";
-//#region src/connectionAnalytics.ts
+// src/connectionAnalytics.ts
 var t = class extends e.TaggedError()("AnalyticsError", {
 	provider: e.String,
 	operation: e.String,
@@ -12,5 +12,4 @@ var t = class extends e.TaggedError()("AnalyticsError", {
 	provider: e.String,
 	capability: e.String
 }) {};
-//#endregion
 export { n as AnalyticsCapabilityNotSupported, t as AnalyticsError };

package/dist/backendMemory.js

@@ -1,7 +1,7 @@
 import { KvStore as e } from "./KvStore.js";
 import { makeExpirySweep as t } from "./expirySweep.js";
 import { Clock as n, Effect as r, HashMap as i, Layer as a, Option as o, Ref as s } from "effect";
-//#region src/backendMemory.ts
+// src/backendMemory.ts
 var c = (e, t) => t === void 0 ? Infinity : e + t, l = (e) => r.gen(function* () {
 	let a = yield* s.make(i.empty()), l = e.now === void 0 ? n.currentTimeMillis : r.sync(e.now), u = t(), d = u.sweep;
 	return {
@@ -32,5 +32,4 @@ var c = (e, t) => t === void 0 ? Infinity : e + t, l = (e) => r.gen(function* ()
 		clear: () => r.sync(u.reset).pipe(r.andThen(s.set(a, i.empty())))
 	};
 }), u = (t = {}) => a.effect(e, l(t));
-//#endregion
 export { u as layerMemory };

package/dist/backendRedis.js

@@ -2,7 +2,7 @@ import { KvStore as e } from "./KvStore.js";
 import { KvError as t } from "./errors.js";
 import { RedisConnections as n, commandRetry as r } from "./connection.js";
 import { Effect as i, Layer as a, Option as o } from "effect";
-//#region src/backendRedis.ts
+// src/backendRedis.ts
 var s = (e, n = "voltro:kv") => {
 	let a = (e) => `${n}:${e}`, s = (e) => e.slice(n.length + 1), c = (n, a, o) => i.tryPromise({
 		try: () => o(e),
@@ -44,5 +44,4 @@ var s = (e, n = "voltro:kv") => {
 		cause: String(e)
 	})))), r.keyPrefix ?? "voltro:kv");
 }));
-//#endregion
 export { c as layerRedis, s as makeRedisKvStore };

package/dist/cacheAtomicProtocol.js

@@ -1,4 +1,4 @@
-//#region src/cacheAtomicProtocol.ts
+// src/cacheAtomicProtocol.ts
 var e = class extends Error {
 	constructor() {
 		super("Invalid atomic cache command or state."), this.name = "CacheAtomicProtocolError";
@@ -148,49 +148,60 @@ var e = class extends Error {
 		default: return n();
 	}
 }, h = (e, t) => {
-	if (typeof e != "string" || !/\{voltro:cache:atomic:(?:[a-f0-9]{2})+\}:r$/.test(e)) return n();
-	let r = e.slice(0, -2), i = /* @__PURE__ */ new Set(), o = (e) => {
-		i.add(`${r}:v:${a(e)}`);
-	}, s = (e) => {
-		i.add(`${r}:t:${a(e)}`);
-	}, c = () => {
-		i.add(`${r}:s`);
-	}, l = (e) => {
-		i.add(`${r}:e:${a(e)}`);
+	let r = typeof e == "string" ? e.match(/\{voltro:cache:atomic:(?:[a-f0-9]{2})+\}:r$/)?.[0] : void 0;
+	if (r === void 0) return n();
+	let i = e.slice(0, -2), o = /* @__PURE__ */ new Set(), s = (e) => {
+		o.add(`${i}:v:${a(e)}`);
+	}, c = (e) => {
+		o.add(`${i}:t:${a(e)}`);
+	}, l = () => {
+		o.add(`${i}:s`);
+	}, u = (e) => {
+		o.add(`${i}:e:${a(e)}`);
 	};
 	switch (t.op) {
 		case "inspect":
-			o(t.key);
+			s(t.key);
 			break;
 		case "inspect-values":
-			t.keys.forEach(o);
+			t.keys.forEach(s);
 			break;
 		case "read":
-			o(t.key), t.snapshot?.tags.forEach(s);
+			s(t.key), t.snapshot?.tags.forEach(c);
 			break;
 		case "fence":
-			c();
+			l();
 			break;
 		case "write":
-			o(t.key), t.tags.forEach(s), t.snapshot?.tags.forEach(s), t.fence !== null && t.tags.forEach(l);
+			s(t.key), t.tags.forEach(c), t.snapshot?.tags.forEach(c), t.fence !== null && t.tags.forEach(u);
 			break;
 		case "remove":
-			o(t.key), t.snapshot?.tags.forEach(s);
+			s(t.key), t.snapshot?.tags.forEach(c);
 			break;
 		case "tag":
-			s(t.tag);
+			c(t.tag);
 			break;
 		case "invalidate":
-			s(t.tag), c(), l(t.tag), t.snapshots.forEach((e) => {
-				o(e.key), e.snapshot?.tags.forEach(s);
+			c(t.tag), l(), u(t.tag), t.snapshots.forEach((e) => {
+				s(e.key), e.snapshot?.tags.forEach(c);
 			});
 			break;
-		case "clear": for (let o of t.keys) if (o !== e) {
-			if (!o.startsWith(`${r}:v:`) && !o.startsWith(`${r}:t:`)) return n();
-			a(o.slice(r.length + 3)), i.add(o);
+		case "clear": {
+			let s = r.slice(0, -2), c = /* @__PURE__ */ new Set();
+			for (let l of t.keys) {
+				let t = l;
+				if (l !== e && !l.startsWith(`${i}:v:`) && !l.startsWith(`${i}:t:`)) {
+					if (l === r) t = e;
+					else if (l.startsWith(`${s}:v:`) || l.startsWith(`${s}:t:`)) t = i + l.slice(s.length);
+					else return n();
+				}
+				if (c.has(t)) return n();
+				c.add(t), t !== e && (a(t.slice(i.length + 3)), o.add(t));
+			}
+			break;
 		}
 	}
-	return [e, ...[...i].sort()];
+	return [e, ...[...o].sort()];
 }, g = (e, t) => `${o(t)}:${a(e)}`, _ = (e) => e === void 0 ? null : !Number.isFinite(e) || !Number.isSafeInteger(Math.ceil(e)) ? n() : Math.max(0, Math.ceil(e)), v = (e) => {
 	if (typeof e != "object" || !e || Array.isArray(e) || Object.getPrototypeOf(e) !== Object.prototype && Object.getPrototypeOf(e) !== null) return n();
 	let t = e;
@@ -243,5 +254,4 @@ var e = class extends Error {
 	"tag",
 	"scan"
 ].includes(e.op);
-//#endregion
 export { t as CACHE_FENCE_RETENTION_MS, e as CacheAtomicProtocolError, l as cacheAtomicArray, f as cacheAtomicComponent, h as cacheAtomicKeys, d as cacheAtomicMember, g as cacheAtomicMembership, p as cacheAtomicRoot, x as cacheAtomicScanPage, u as cacheAtomicSnapshot, _ as cacheAtomicTtl, b as cacheAtomicValueSnapshots, m as decodeCacheAtomicCommand, v as decodeCacheAtomicPolicy, y as decodeCacheAtomicReply, S as isCacheAtomicRead };

package/dist/cacheAtomicScript.js

@@ -1,5 +1,5 @@
 import { CACHE_FENCE_RETENTION_MS as e } from "./cacheAtomicProtocol.js";
-//#region src/cacheAtomicScript.ts
+// src/cacheAtomicScript.ts
 var t = String.raw`
 local c = cjson.decode(ARGV[1])
 local policy = ARGV[2] and cjson.decode(ARGV[2]) or {}
@@ -126,8 +126,26 @@ elseif c.op == 'invalidate' then
   for i = 2, #c.snapshots do if c.snapshots[i - 1].key >= c.snapshots[i].key then invalid() end end
 elseif c.op == 'clear' then
   if not null(c.revision) then version(c.revision) end
+  -- KEYS may carry a registry prefix; ARGV retains caller-logical keys.
+  -- The canonical cache token binds those two domains exactly, without
+  -- accepting a foreign connection prefix or another cache namespace.
+  local logicalRoot = string.match(root, '({voltro:cache:atomic:[a-f0-9]+}:r)$')
+  if not logicalRoot then invalid() end
+  id(string.match(logicalRoot, '^{voltro:cache:atomic:([a-f0-9]+)}:r$'))
+  local logicalSpace = string.sub(logicalRoot, 1, #logicalRoot - 2)
+  local selected = {}
   array(c.keys, function(key)
     if type(key) ~= 'string' then invalid() end
+    local kind = string.sub(key, 1, #space + 3)
+    if key ~= root and kind ~= space .. ':v:' and kind ~= space .. ':t:' then
+      local logicalKind = string.sub(key, 1, #logicalSpace + 3)
+      if key == logicalRoot then key = root
+      elseif logicalKind == logicalSpace .. ':v:' or logicalKind == logicalSpace .. ':t:' then
+        key = space .. string.sub(key, #logicalSpace + 1)
+      else invalid() end
+    end
+    if selected[key] then invalid() end
+    selected[key] = true
     if key ~= root then
       local prefix = string.sub(key, 1, #space + 3)
       if prefix ~= space .. ':v:' and prefix ~= space .. ':t:' then invalid() end
@@ -305,5 +323,4 @@ elseif c.op == 'clear' then
 end
 invalid()
 `;
-//#endregion
 export { t as CACHE_ATOMIC_SCRIPT };

package/dist/cacheAtomicState.js

@@ -1,5 +1,5 @@
 import { CACHE_FENCE_RETENTION_MS as e, CacheAtomicProtocolError as t, cacheAtomicKeys as n, cacheAtomicMember as r, cacheAtomicMembership as i, cacheAtomicSnapshot as a, decodeCacheAtomicCommand as o, decodeCacheAtomicPolicy as s } from "./cacheAtomicProtocol.js";
-//#region src/cacheAtomicState.ts
+// src/cacheAtomicState.ts
 var c = 9e15, l = () => {
 	throw new t();
 }, u = (t, u, d, f = {}) => {
@@ -137,5 +137,4 @@ var c = 9e15, l = () => {
 			return O("ok");
 	}
 };
-//#endregion
 export { u as applyCacheAtomicCommand };

package/dist/connection.js

@@ -3,19 +3,20 @@ import { withRespKeyPrefix as t } from "./connectionPrefix.js";
 import { dynamicSql as n } from "./connectionSqlConfig.js";
 import { dynamicAnalytics as r } from "./connectionAnalyticsConfig.js";
 import { byTenant as i, connectionDefinitionsProblem as a, connectionMetadataProblem as o, declaredConnectionEnv as s, dynamic as c, dynamicNats as l, env as u, memory as d, redisConnectionName as f, redisTimeoutsProblem as p, roundRobin as m, shardBy as h } from "./connectionDefinitions.js";
-import { createNativeRedisConnection as g, disconnectNativeRedis as _, nativeRedisTopology as v, scanNativeRedis as y } from "./nativeRedisTopology.js";
-import { connectRedisSubscriber as b } from "./connectionSubscriber.js";
-import { dynamicStorage as x } from "./connectionStorageConfig.js";
-import { withConnectionRegistryConfigProvider as S } from "./connectionConfigProvider.js";
-import { ConnectionRegistry as C, layerConfiguredConnections as w, makeConnectionRegistry as T } from "./connectionPool.js";
-import { httpRedisReaders as ee } from "./redisReadPolicy.js";
-import { nativeRedisReadConfigs as E, openNativeRedisReaders as te } from "./nativeRedisReads.js";
+import { missingDriver as g } from "./driverModule.js";
+import { createNativeRedisConnection as _, disconnectNativeRedis as v, nativeRedisTopology as y, scanNativeRedis as b } from "./nativeRedisTopology.js";
+import { connectRedisSubscriber as x } from "./connectionSubscriber.js";
+import { dynamicStorage as S } from "./connectionStorageConfig.js";
+import { withConnectionRegistryConfigProvider as C } from "./connectionConfigProvider.js";
+import { ConnectionRegistry as ee, layerConfiguredConnections as w, makeConnectionRegistry as T } from "./connectionPool.js";
+import { httpRedisReaders as E } from "./redisReadPolicy.js";
+import { nativeRedisReadConfigs as D, openNativeRedisReaders as te } from "./nativeRedisReads.js";
 import { readRedisNodeDiagnostics as ne } from "./redisDiagnostics.js";
-import { CACHE_FENCE_RETENTION_MS as D, CacheAtomicProtocolError as O, cacheAtomicArray as k, cacheAtomicComponent as A, cacheAtomicKeys as re, cacheAtomicMember as ie, cacheAtomicMembership as ae, cacheAtomicRoot as oe, cacheAtomicScanPage as j, cacheAtomicSnapshot as M, cacheAtomicTtl as N, cacheAtomicValueSnapshots as P, decodeCacheAtomicCommand as F, decodeCacheAtomicPolicy as I, decodeCacheAtomicReply as L, isCacheAtomicRead as R } from "./cacheAtomicProtocol.js";
-import { CACHE_ATOMIC_SCRIPT as z } from "./cacheAtomicScript.js";
-import { Config as B, ConfigProvider as V, Context as H, Effect as U, Layer as W, Option as G, Schedule as K } from "effect";
-//#region src/connection.ts
-var q = (e) => new B.ConfigError(new V.SourceError({ message: e })), se = (e, t) => {
+import { CACHE_FENCE_RETENTION_MS as re, CacheAtomicProtocolError as ie, cacheAtomicArray as ae, cacheAtomicComponent as oe, cacheAtomicKeys as se, cacheAtomicMember as ce, cacheAtomicMembership as O, cacheAtomicRoot as k, cacheAtomicScanPage as A, cacheAtomicSnapshot as j, cacheAtomicTtl as M, cacheAtomicValueSnapshots as N, decodeCacheAtomicCommand as P, decodeCacheAtomicPolicy as F, decodeCacheAtomicReply as I, isCacheAtomicRead as L } from "./cacheAtomicProtocol.js";
+import { CACHE_ATOMIC_SCRIPT as R } from "./cacheAtomicScript.js";
+import { Config as z, ConfigProvider as B, Context as V, Effect as H, Layer as U, Option as W, Schedule as G } from "effect";
+// src/connection.ts
+var K = (e) => new z.ConfigError(new B.SourceError({ message: e })), le = (e, t) => {
 	let n = e.client;
 	return {
 		readOnly: {
@@ -29,11 +30,15 @@ var q = (e) => new B.ConfigError(new V.SourceError({ message: e })), se = (e, t)
 			},
 			zrange: async (e) => {
 				let n = await t.select();
-				return await n.ready(), n.client.zrange(e, 0, -1);
+				return await n.ready(), n.client.zrange(e, 0, "-1");
 			},
 			eval: async (e, n, ...r) => {
 				let i = await t.select();
-				return await i.ready(), i.client.call("eval_ro", e, n, ...r);
+				return await i.ready(), i.client.call("eval_ro", [
+					e,
+					n,
+					...r
+				]);
 			}
 		},
 		ping: async () => (await e.ready(), n.ping()),
@@ -65,8 +70,8 @@ var q = (e) => new B.ConfigError(new V.SourceError({ message: e })), se = (e, t)
 		},
 		exists: async (t) => (await e.ready(), n.exists(t)),
 		eval: async (t, r, ...i) => (await e.ready(), n.eval(t, r, ...i)),
-		zrange: async (t) => (await e.ready(), n.zrange(t, 0, -1)),
-		scan: async (t, n, r) => (await e.ready(), y(e, t, n, r)),
+		zrange: async (t) => (await e.ready(), n.zrange(t, 0, "-1")),
+		scan: async (t, n, r) => (await e.ready(), b(e, t, n, r)),
 		close: async () => {
 			let r, i = () => {
 				try {
@@ -80,11 +85,11 @@ var q = (e) => new B.ConfigError(new V.SourceError({ message: e })), se = (e, t)
 					}, 1e3);
 				})]);
 			} finally {
-				r !== void 0 && clearTimeout(r), await Promise.all([t.close(), _(e)]).then(() => void 0);
+				r !== void 0 && clearTimeout(r), await Promise.all([t.close(), v(e)]).then(() => void 0);
 			}
 		}
 	};
-}, J = (e) => ({
+}, q = (e) => ({
 	readOnly: {
 		get: (t) => e.get(t),
 		exists: (t) => e.exists(t),
@@ -110,7 +115,7 @@ var q = (e) => new B.ConfigError(new V.SourceError({ message: e })), se = (e, t)
 		};
 	},
 	close: () => Promise.resolve()
-}), Y = (e) => e.toUpperCase().replace(/[^A-Z0-9]+/g, "_"), X = (e) => {
+}), J = (e) => e.toUpperCase().replace(/[^A-Z0-9]+/g, "_"), Y = (e) => {
 	if (![
 		"resp",
 		"http",
@@ -148,79 +153,79 @@ var q = (e) => new B.ConfigError(new V.SourceError({ message: e })), se = (e, t)
 		"none"
 	].includes(e.persistence)) return "Connection persistence must be required, optional or none";
 	if (e.maxmemoryPolicyHint !== void 0 && typeof e.maxmemoryPolicyHint != "string") return "Redis maxmemoryPolicyHint must be a string";
-}, Z = (e) => {
-	let t = X(e);
-	return t ? U.fail(q(t)) : e.driver === "resp" ? U.try({
+}, X = (e) => {
+	let t = Y(e);
+	return t ? H.fail(K(t)) : e.driver === "resp" ? H.try({
 		try: () => {
-			let t = v(e);
-			if (E(e), e.readFrom === "replica" && t.kind === "standalone" && !e.replicas?.length) throw Error("Standalone replica reads require replica endpoints");
+			let t = y(e);
+			if (D(e), e.readFrom === "replica" && t.kind === "standalone" && !e.replicas?.length) throw Error("Standalone replica reads require replica endpoints");
 			return t.kind === "cluster" && e.cluster === void 0 ? {
 				...e,
 				cluster: !0
 			} : e;
 		},
-		catch: () => q("Invalid native Redis topology declaration")
-	}) : U.succeed(e);
-}, Q = ["resp", "http"], ce = (e, t = {}) => U.gen(function* () {
-	let n = Y(e), r = t.url ?? (yield* B.String(`${n}_REDIS_URL`).pipe(B.orElse(() => B.String("REDIS_URL")))), i = t.driver === void 0 ? yield* B.Literals(Q, `${n}_REDIS_DRIVER`).pipe(B.option) : G.none(), a = t.driver ?? (G.isSome(i) ? i.value : yield* B.Literals(Q, "REDIS_DRIVER").pipe(B.withDefault("resp"))), o = t.token === void 0 ? yield* B.String(`${n}_REDIS_TOKEN`).pipe(B.orElse(() => B.String("REDIS_TOKEN")), B.orElse(() => B.String("UPSTASH_REDIS_REST_TOKEN")), B.option) : G.some(t.token), s = t.keyPrefix === void 0 ? yield* B.String(`${n}_REDIS_KEY_PREFIX`).pipe(B.option) : G.some(t.keyPrefix);
+		catch: () => K("Invalid native Redis topology declaration")
+	}) : H.succeed(e);
+}, Z = ["resp", "http"], ue = (e, t = {}) => H.gen(function* () {
+	let n = J(e), r = t.url ?? (yield* z.String(`${n}_REDIS_URL`).pipe(z.orElse(() => z.String("REDIS_URL")))), i = t.driver === void 0 ? yield* z.Literals(Z, `${n}_REDIS_DRIVER`).pipe(z.option) : W.none(), a = t.driver ?? (W.isSome(i) ? i.value : yield* z.Literals(Z, "REDIS_DRIVER").pipe(z.withDefault("resp"))), o = t.token === void 0 ? yield* z.String(`${n}_REDIS_TOKEN`).pipe(z.orElse(() => z.String("REDIS_TOKEN")), z.orElse(() => z.String("UPSTASH_REDIS_REST_TOKEN")), z.option) : W.some(t.token), s = t.keyPrefix === void 0 ? yield* z.String(`${n}_REDIS_KEY_PREFIX`).pipe(z.option) : W.some(t.keyPrefix);
 	return {
 		url: r,
 		driver: a,
-		...G.isSome(o) ? { token: o.value } : {},
-		...G.isSome(s) ? { keyPrefix: s.value } : {},
+		...W.isSome(o) ? { token: o.value } : {},
+		...W.isSome(s) ? { keyPrefix: s.value } : {},
 		...t.source === void 0 ? {} : { source: t.source },
 		...t.connectTimeoutMs === void 0 ? {} : { connectTimeoutMs: t.connectTimeoutMs },
 		...t.commandTimeoutMs === void 0 ? {} : { commandTimeoutMs: t.commandTimeoutMs }
 	};
-}).pipe(U.flatMap(Z));
-function le(e, t, n) {
+}).pipe(H.flatMap(X));
+function Q(e, t, n) {
 	let r = n === void 0 ? void 0 : Object.freeze({ tenantId: n.tenantId });
-	return U.gen(function* () {
+	return H.gen(function* () {
 		let n = a(t ?? {});
-		if (n) return yield* U.fail(q(n));
+		if (n) return yield* H.fail(K(n));
 		let i = e.includes(":"), o = i ? e.slice(e.indexOf(":") + 1) : e;
-		if (i && !e.startsWith("redis:")) return yield* U.fail(q("A Redis consumer requires a redis:name connection reference"));
-		if (i && o && !/^[A-Za-z][A-Za-z0-9_-]*$/.test(o)) return yield* U.fail(q("Malformed Redis connection reference"));
+		if (i && !e.startsWith("redis:")) return yield* H.fail(K("A Redis consumer requires a redis:name connection reference"));
+		if (i && o && !/^[A-Za-z][A-Za-z0-9_-]*$/.test(o)) return yield* H.fail(K("Malformed Redis connection reference"));
 		let s = t?.redis ?? {}, c = Object.keys(s), l = f(o, t ?? {}), u = Object.hasOwn(s, l) ? s[l] : void 0;
-		if (!u && c.length > 0) return yield* U.fail(q(`Unknown Redis connection ${l || "(default)"}. Known names: ${c.sort().join(", ") || "(none)"}`));
-		let d = `CONNECTIONS_REDIS_${Y(l)}`, p = yield* B.String(`${d}_URL`).pipe(B.option), m = yield* B.Literals(["resp", "http"], `${d}_DRIVER`).pipe(B.option), h = yield* B.String(`${d}_TOKEN`).pipe(B.option), g = yield* B.String(`${d}_KEY_PREFIX`).pipe(B.option), _ = {
-			...G.isSome(p) ? { url: p.value } : {},
-			...G.isSome(m) ? { driver: m.value } : {},
-			...G.isSome(h) ? { token: h.value } : {},
-			...G.isSome(g) ? { keyPrefix: g.value } : {},
+		if (!u && c.length > 0) return yield* H.fail(K(`Unknown Redis connection ${l || "(default)"}. Known names: ${c.sort().join(", ") || "(none)"}`));
+		let d = `CONNECTIONS_REDIS_${J(l)}`, p = yield* z.String(`${d}_URL`).pipe(z.option), m = yield* z.Literals(["resp", "http"], `${d}_DRIVER`).pipe(z.option), h = yield* z.String(`${d}_TOKEN`).pipe(z.option), g = yield* z.String(`${d}_KEY_PREFIX`).pipe(z.option), _ = {
+			...W.isSome(p) ? { url: p.value } : {},
+			...W.isSome(m) ? { driver: m.value } : {},
+			...W.isSome(h) ? { token: h.value } : {},
+			...W.isSome(g) ? { keyPrefix: g.value } : {},
 			...[
 				p,
 				m,
 				h,
 				g
-			].some(G.isSome) ? { source: "override" } : {}
+			].some(W.isSome) ? { source: "override" } : {}
 		};
 		if (u && "_tag" in u && u._tag === "MemoryRedisConnection") return [
 			p,
 			m,
 			h,
 			g
-		].some(G.isSome) ? yield* U.fail(q("A local memory connection cannot be redirected by transport environment overrides")) : {
+		].some(W.isSome) ? yield* H.fail(K("A local memory connection cannot be redirected by transport environment overrides")) : {
 			url: `memory:${l}`,
 			driver: "memory",
 			source: "config",
 			...u.now === void 0 ? {} : { memoryClock: u.now }
 		};
 		if (u && "_tag" in u) {
-			if (!r?.tenantId) return yield* U.fail(q("A dynamic Redis connection requires tenantId"));
+			if (!r?.tenantId) return yield* H.fail(K("A dynamic Redis connection requires tenantId"));
 			let e = {
 				...yield* u.resolve(r),
 				..._
-			}, t = X(e);
-			return t ? yield* U.fail(q(t)) : e.driver === "memory" ? yield* U.fail(q("Local memory connections require a memory() declaration, not a tenant credential resolver")) : e.keyPrefix !== void 0 && typeof e.keyPrefix != "string" ? yield* U.fail(q("Connection keyPrefix must be a string")) : e.allowSharedNamespace !== void 0 && typeof e.allowSharedNamespace != "boolean" ? yield* U.fail(q("Connection allowSharedNamespace must be a boolean")) : e.driver === "http" && !e.token ? yield* U.fail(q("An HTTP Redis connection requires a declared token")) : e.tls === "required" && !/^rediss(?:\+cluster|\+sentinel)?:\/\//i.test(e.url) && !(e.driver === "http" && /^https:\/\//i.test(e.url)) ? yield* U.fail(q("A Redis connection with tls: required needs a secure Redis scheme or HTTPS")) : yield* Z(e);
+			}, t = Y(e);
+			return t ? yield* H.fail(K(t)) : e.driver === "memory" ? yield* H.fail(K("Local memory connections require a memory() declaration, not a tenant credential resolver")) : e.keyPrefix !== void 0 && typeof e.keyPrefix != "string" ? yield* H.fail(K("Connection keyPrefix must be a string")) : e.allowSharedNamespace !== void 0 && typeof e.allowSharedNamespace != "boolean" ? yield* H.fail(K("Connection allowSharedNamespace must be a boolean")) : e.driver === "http" && !e.token ? yield* H.fail(K("An HTTP Redis connection requires a declared token")) : e.tls === "required" && !/^rediss(?:\+cluster|\+sentinel)?:\/\//i.test(e.url) && !(e.driver === "http" && /^https:\/\//i.test(e.url)) ? yield* H.fail(K("A Redis connection with tls: required needs a secure Redis scheme or HTTPS")) : yield* X(e);
 		}
-		if (!u) return yield* ce(l || e, _);
-		let v = G.isSome(p) ? p.value : yield* B.String(u.url.name), y = G.isSome(m) ? m.value : u.driver ?? "resp", b = G.isSome(h) ? G.some(h.value) : u.token ? G.some(yield* B.String(u.token.name)) : G.none();
-		if (y === "http" && G.isNone(b)) return yield* U.fail(q("An HTTP Redis connection requires a declared token"));
-		let x = G.isSome(g) ? g.value : u.keyPrefix, S = u.cluster ?? /^rediss?\+cluster:\/\//i.test(v);
-		if (u.tls === "required" && !/^rediss(?:\+cluster|\+sentinel)?:\/\//i.test(v) && !(y === "http" && /^https:\/\//i.test(v))) return yield* U.fail(q("A Redis connection with tls: required needs a secure Redis scheme or HTTPS"));
-		let C = yield* U.forEach(u.replicas ?? [], (e) => B.String(e.name));
-		return yield* Z({
+		if (!u) return yield* ue(l || e, _);
+		let v = W.isSome(p) ? p.value : yield* z.String(u.url.name), y = W.isSome(m) ? m.value : u.driver ?? "resp", b = W.isSome(h) ? W.some(h.value) : u.token ? W.some(yield* z.String(u.token.name)) : W.none();
+		if (y === "http" && W.isNone(b)) return yield* H.fail(K("An HTTP Redis connection requires a declared token"));
+		let x = W.isSome(g) ? g.value : u.keyPrefix, S = u.cluster ?? /^rediss?\+cluster:\/\//i.test(v);
+		if (u.tls === "required" && !/^rediss(?:\+cluster|\+sentinel)?:\/\//i.test(v) && !(y === "http" && /^https:\/\//i.test(v))) return yield* H.fail(K("A Redis connection with tls: required needs a secure Redis scheme or HTTPS"));
+		let C = yield* H.forEach(u.replicas ?? [], (e) => z.String(e.name));
+		return yield* X({
 			url: v,
 			driver: y,
 			cluster: S,
@@ -229,8 +234,8 @@ function le(e, t, n) {
 				m,
 				h,
 				g
-			].some(G.isSome) ? "override" : "config",
-			...G.isSome(b) ? { token: b.value } : {},
+			].some(W.isSome) ? "override" : "config",
+			...W.isSome(b) ? { token: b.value } : {},
 			...x === void 0 ? {} : { keyPrefix: x },
 			...u.allowSharedNamespace === void 0 ? {} : { allowSharedNamespace: u.allowSharedNamespace },
 			...u.tls === void 0 ? {} : { tls: u.tls },
@@ -246,12 +251,12 @@ function le(e, t, n) {
 		});
 	});
 }
-var ue = (n) => U.tryPromise({
+var de = (n) => H.tryPromise({
 	try: async (e) => {
 		e.throwIfAborted();
-		let t = X(n);
+		let t = Y(n);
 		if (t) throw Error(t);
-		if (n.driver === "resp" && E(n), n.driver === "memory") {
+		if (n.driver === "resp" && D(n), n.driver === "memory") {
 			let { makeMemoryConnectionState: e } = await import("./connectionMemory.js"), t = e(n.memoryClock), r = t.command();
 			return {
 				...r,
@@ -261,7 +266,7 @@ var ue = (n) => U.tryPromise({
 			};
 		}
 		if (n.driver === "http") {
-			let t = await import("@upstash/redis");
+			let t = await import("@upstash/redis").catch(g("@upstash/redis", "An Upstash HTTP connection"));
 			e.throwIfAborted();
 			let r = typeof t.default == "function" ? t.default : t.default?.Redis, i = t.Redis ?? r;
 			if (!i) throw Error("@upstash/redis: Redis constructor not found in module");
@@ -280,7 +285,7 @@ var ue = (n) => U.tryPromise({
 						signal: r.signal
 					});
 					if (await a.ping() !== "PONG") throw Error("HTTP reader readiness failed");
-					let o = J(a);
+					let o = q(a);
 					if (Number(await o.readOnly.eval("return 1", 0)) !== 1) throw Error("HTTP read-only Lua readiness failed");
 					return e.throwIfAborted(), {
 						...o,
@@ -309,14 +314,14 @@ var ue = (n) => U.tryPromise({
 				if (await t.ping() !== "PONG") throw Error("HTTP primary readiness failed");
 				e.throwIfAborted();
 				let r = {
-					...J(t),
+					...q(t),
 					close: async () => {
 						o.abort();
 					}
 				}, s = [];
 				try {
 					if (n.readFrom !== void 0 && n.readFrom !== "primary") for (let e of n.replicas ?? []) s.push(await a(e));
-					let t = ee(r, s, n.readFrom);
+					let t = E(r, s, n.readFrom);
 					return (n.readFrom === "replica" || n.readFrom === "nearest") && await t.readOnly.eval("return 1", 0), e.throwIfAborted(), t;
 				} catch (e) {
 					throw await Promise.all([r, ...s].map((e) => e.close())), e;
@@ -327,7 +332,7 @@ var ue = (n) => U.tryPromise({
 				e.removeEventListener("abort", s);
 			}
 		}
-		let r = await g(n), i = r.client;
+		let r = await _(n), i = r.client;
 		i.on("error", () => {});
 		let a = () => {
 			i.disconnect();
@@ -336,19 +341,19 @@ var ue = (n) => U.tryPromise({
 		try {
 			e.throwIfAborted(), await i.connect(), await r.ready(), e.throwIfAborted();
 		} catch (e) {
-			throw await _(r), e;
+			throw await v(r), e;
 		} finally {
 			e.removeEventListener("abort", a);
 		}
 		try {
 			let t = await te(n, r, e);
 			try {
-				return e.throwIfAborted(), se(r, t);
+				return e.throwIfAborted(), le(r, t);
 			} catch (e) {
 				throw await t.close(), e;
 			}
 		} catch (e) {
-			throw await _(r), e;
+			throw await v(r), e;
 		}
 	},
 	catch: () => new e({
@@ -356,6 +361,5 @@ var ue = (n) => U.tryPromise({
 		key: "",
 		cause: n.keyPrefix !== void 0 && typeof n.keyPrefix != "string" ? "Connection keyPrefix must be a string" : "Redis connection could not be opened"
 	})
-}).pipe(U.map((e) => t(e, n.keyPrefix))), de = K.max([K.exponential("10 millis"), K.recurs(2)]), $ = class extends H.Service()("@voltro/RedisConnections") {}, fe = W.effect($, U.suspend(() => T()).pipe(U.orDie, U.map((e) => e.redis)));
-//#endregion
-export { z as CACHE_ATOMIC_SCRIPT, D as CACHE_FENCE_RETENTION_MS, O as CacheAtomicProtocolError, C as ConnectionRegistry, $ as RedisConnections, i as byTenant, k as cacheAtomicArray, A as cacheAtomicComponent, re as cacheAtomicKeys, ie as cacheAtomicMember, ae as cacheAtomicMembership, oe as cacheAtomicRoot, j as cacheAtomicScanPage, M as cacheAtomicSnapshot, N as cacheAtomicTtl, P as cacheAtomicValueSnapshots, de as commandRetry, ue as connect, b as connectRedisSubscriber, le as connectionConfig, a as connectionDefinitionsProblem, s as declaredConnectionEnv, F as decodeCacheAtomicCommand, I as decodeCacheAtomicPolicy, L as decodeCacheAtomicReply, c as dynamic, r as dynamicAnalytics, l as dynamicNats, n as dynamicSql, x as dynamicStorage, u as env, R as isCacheAtomicRead, w as layerConfiguredConnections, fe as layerConnections, T as makeConnectionRegistry, d as memory, m as roundRobin, h as shardBy, S as withConnectionRegistryConfigProvider };
+}).pipe(H.map((e) => t(e, n.keyPrefix))), fe = G.max([G.exponential("10 millis"), G.recurs(2)]), $ = class extends V.Service()("@voltro/RedisConnections") {}, pe = U.effect($, H.suspend(() => T()).pipe(H.orDie, H.map((e) => e.redis)));
+export { R as CACHE_ATOMIC_SCRIPT, re as CACHE_FENCE_RETENTION_MS, ie as CacheAtomicProtocolError, ee as ConnectionRegistry, $ as RedisConnections, i as byTenant, ae as cacheAtomicArray, oe as cacheAtomicComponent, se as cacheAtomicKeys, ce as cacheAtomicMember, O as cacheAtomicMembership, k as cacheAtomicRoot, A as cacheAtomicScanPage, j as cacheAtomicSnapshot, M as cacheAtomicTtl, N as cacheAtomicValueSnapshots, fe as commandRetry, de as connect, x as connectRedisSubscriber, Q as connectionConfig, a as connectionDefinitionsProblem, s as declaredConnectionEnv, P as decodeCacheAtomicCommand, F as decodeCacheAtomicPolicy, I as decodeCacheAtomicReply, c as dynamic, r as dynamicAnalytics, l as dynamicNats, n as dynamicSql, S as dynamicStorage, u as env, L as isCacheAtomicRead, w as layerConfiguredConnections, pe as layerConnections, T as makeConnectionRegistry, d as memory, m as roundRobin, h as shardBy, C as withConnectionRegistryConfigProvider };

package/dist/connectionAnalyticsConfig.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/connectionAnalyticsConfig.ts
+// src/connectionAnalyticsConfig.ts
 var o = (e, t = {}) => {
 	let n = t.ttlMs ?? 6e4;
 	if (typeof e != "function" || !Number.isSafeInteger(n) || n <= 0) throw Error("Dynamic analytics requires a resolver and positive ttlMs");
@@ -149,5 +149,4 @@ var o = (e, t = {}) => {
 		source: _ ? "override" : "config"
 	};
 });
-//#endregion
 export { h as analyticsConfigProblem, _ as analyticsConnectionConfig, g as analyticsConnectionName, m as analyticsDefinitionProblem, o as dynamicAnalytics };

package/dist/connectionConfigError.js

@@ -0,0 +1,10 @@
+import { Config as e, ConfigProvider as t } from "effect";
+// src/connectionConfigError.ts
+var n = {
+	redis: "Dynamic connection credentials could not be resolved",
+	nats: "Dynamic connection credentials could not be resolved",
+	storage: "Dynamic storage credentials could not be resolved",
+	analytics: "Dynamic analytics credentials could not be resolved",
+	sql: "Dynamic SQL credentials could not be resolved"
+}, r = (r, i) => r._tag === "ConfigError" ? r : new e.ConfigError(new t.SourceError({ message: n[i] }));
+export { r as connectionConfigError };

package/dist/connectionConfigProvider.js

@@ -1,5 +1,5 @@
 import { ConfigProvider as e, Effect as t, Stream as n } from "effect";
-//#region src/connectionConfigProvider.ts
+// src/connectionConfigProvider.ts
 var r = /* @__PURE__ */ new WeakMap(), i = (i, s) => {
 	i = r.get(i) ?? i;
 	function c(n, r) {
@@ -107,5 +107,4 @@ var r = /* @__PURE__ */ new WeakMap(), i = (i, s) => {
 		maxVersion: (i) => n.mirror.maxVersion(i).pipe(t.provideService(e.ConfigProvider, r))
 	} }
 });
-//#endregion
 export { i as withConnectionRegistryConfigProvider };

package/dist/connectionDefinitions.js

@@ -1,6 +1,6 @@
 import { sqlDefinitionProblem as e } from "./connectionSqlConfig.js";
 import { analyticsDefinitionProblem as t } from "./connectionAnalyticsConfig.js";
-//#region src/connectionDefinitions.ts
+// src/connectionDefinitions.ts
 var n = (e) => {
 	if (!/^[A-Z][A-Z0-9_]*$/.test(e)) throw Error("Connection env names must use uppercase letters, digits and underscores");
 	return Object.freeze({
@@ -281,5 +281,4 @@ var n = (e) => {
 	for (let n of [...Object.values(e.analytics ?? {}), ...Object.values(e.sql ?? {})]) if (!("_tag" in n)) for (let e of Object.values(n)) typeof e == "object" && e && "_tag" in e && e._tag === "ConnectionEnv" && t.add(e.name);
 	return [...t].sort();
 };
-//#endregion
 export { p as byTenant, l as connectionDefinitionsProblem, u as connectionMetadataProblem, m as declaredConnectionEnv, a as dynamic, o as dynamicNats, n as env, i as memory, s as natsConnectionName, c as redisConnectionName, r as redisTimeoutsProblem, f as roundRobin, d as shardBy };

package/dist/connectionMemory.js

@@ -6,7 +6,7 @@ import { applyHotOperations as i, compareHotMembers as a } from "./hotState.js";
 import { HotError as o } from "./hot-contract.js";
 import "./hotRedisScript.js";
 import { applyCacheAtomicCommand as s } from "./cacheAtomicState.js";
-//#region src/connectionMemory.ts
+// src/connectionMemory.ts
 var c = (c = Date.now) => {
 	let l = /* @__PURE__ */ new Map(), u = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Set(), p = !1, m = () => {
 		if (p) throw Error("Memory connection is closed");
@@ -203,5 +203,4 @@ var c = (c = Date.now) => {
 		}
 	};
 };
-//#endregion
 export { c as makeMemoryConnectionState };

package/dist/connectionMetrics.js

@@ -1,5 +1,5 @@
 import { Effect as e, Metric as t } from "effect";
-//#region src/connectionMetrics.ts
+// src/connectionMetrics.ts
 var n = /* @__PURE__ */ new Map(), r = t.gauge("voltro_connection_up", { description: "Whether every current pool for this reference has observed readiness and admits commands; not a persistence or capacity measurement." }), i = t.gauge("voltro_connection_pools", { description: "Owned physical generations, including draining generations." }), a = t.gauge("voltro_connection_active_commands", { description: "Borrowed generation leases, including complete streams and transactions." }), o = t.counter("voltro_connection_commands_total", { description: "Admitted commands and scoped streams; includes read-only probes." }), s = t.counter("voltro_connection_errors_total", { description: "Failed registry operations; includes rejected circuit admission and connection construction." }), c = t.gauge("voltro_connection_latency_ms", { description: "Duration of the most recently completed command or scoped stream in milliseconds." }), l = t.histogram("voltro_connection_duration_seconds", {
 	boundaries: t.exponentialBoundaries({
 		start: .001,
@@ -75,5 +75,4 @@ var n = /* @__PURE__ */ new Map(), r = t.gauge("voltro_connection_up", { descrip
 		}
 	};
 };
-//#endregion
 export { f as makeConnectionMetrics };

package/dist/connectionNamespace.js

@@ -1,4 +1,4 @@
-//#region src/connectionNamespace.ts
+// src/connectionNamespace.ts
 var e = (e) => encodeURIComponent(e).replace(/[!'()*]/g, (e) => `%${e.charCodeAt(0).toString(16).toUpperCase()}`), t = (t) => {
 	if (typeof t.appName != "string" || !t.appName.trim() || typeof t.environment != "string" || !t.environment.trim()) throw Error("Connection namespace requires a nonempty app name and environment");
 	return `voltro:${e(t.appName)}:${e(t.environment)}:`;
@@ -15,5 +15,4 @@ var e = (e) => encodeURIComponent(e).replace(/[!'()*]/g, (e) => `%${e.charCodeAt
 		keyPrefix: i
 	};
 };
-//#endregion
 export { n as applyConnectionNamespace, t as connectionNamespace };