@voltro/kv 0.84.0 → 0.86.0

package/THIRD-PARTY-NOTICES.md

@@ -1,6 +1,6 @@
 # Third-Party Notices — @voltro/kv
 
-This package depends on the open-source software listed below. Each is the
+This package uses the open-source software listed below. Each is the
 property of its respective copyright holders and is used under the terms of
 its license. This file is provided for attribution; it grants no rights in
 @voltro/kv itself, which is proprietary (see LICENSE).

package/dist/Kv.js

@@ -0,0 +1,19 @@
+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
+var a = class a extends t.Service()("@voltro/Kv", { make: n.gen(function* () {
+	let t = yield* e;
+	return {
+		get: (e) => t.get(e),
+		getOrElse: (e, r) => t.get(e).pipe(n.map((e) => i.isSome(e) ? e.value : r())),
+		set: (e, n, r) => t.set(e, n, r),
+		delete: t.delete,
+		has: t.has,
+		list: t.list,
+		clear: t.clear
+	};
+}) }) {
+	static layer = r.effect(a, a.make);
+};
+//#endregion
+export { a as Kv };

package/dist/KvStore.js

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

package/dist/backendMemory.js

@@ -0,0 +1,36 @@
+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
+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 {
+		get: (e) => l.pipe(r.flatMap((t) => s.modify(a, (n) => {
+			n = d(n, t);
+			let r = i.get(n, e);
+			return o.isNone(r) ? [o.none(), n] : r.value.expiresAt <= t ? [o.none(), i.remove(n, e)] : [o.some(r.value.value), n];
+		}))),
+		set: (e, t, n) => l.pipe(r.flatMap((r) => s.update(a, (a) => i.set(d(a, r), e, {
+			value: t,
+			expiresAt: c(r, n?.ttlMs)
+		})))),
+		delete: (e) => l.pipe(r.flatMap((t) => s.modify(a, (n) => {
+			n = d(n, t);
+			let r = i.get(n, e);
+			return o.isNone(r) ? [!1, n] : [r.value.expiresAt > t, i.remove(n, e)];
+		}))),
+		has: (e) => l.pipe(r.flatMap((t) => s.modify(a, (n) => {
+			n = d(n, t);
+			let r = i.get(n, e);
+			return o.isNone(r) ? [!1, n] : r.value.expiresAt <= t ? [!1, i.remove(n, e)] : [!0, n];
+		}))),
+		list: (e) => l.pipe(r.flatMap((t) => s.modify(a, (n) => {
+			let r = [], a = n;
+			for (let [o, s] of n) s.expiresAt <= t ? a = i.remove(a, o) : (e === "" || o.startsWith(e)) && r.push(o);
+			return u.reset(), [r, a];
+		}))),
+		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

@@ -0,0 +1,48 @@
+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
+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),
+		catch: (e) => new t({
+			operation: n,
+			key: a,
+			cause: String(e)
+		})
+	}).pipe(i.retry(r)), l = (e, n) => i.try({
+		try: () => JSON.stringify(n),
+		catch: (n) => new t({
+			operation: "serialize",
+			key: e,
+			cause: String(n)
+		})
+	}), u = (e, n) => i.try({
+		try: () => o.some(JSON.parse(n)),
+		catch: (n) => new t({
+			operation: "deserialize",
+			key: e,
+			cause: String(n)
+		})
+	}), d = (e, t, n) => c("list", "", (n) => n.scan(t, e, 200)).pipe(i.flatMap(({ cursor: t, keys: r }) => {
+		for (let e of r) n.push(s(e));
+		return t === "0" ? i.succeed(n) : d(e, t, n);
+	})), f = (e) => c("clear", "", (t) => t.scan(e, `${n}:*`, 200)).pipe(i.flatMap(({ cursor: e, keys: t }) => (t.length > 0 ? c("clear", "", (e) => e.del(t)) : i.succeed(0)).pipe(i.flatMap(() => e === "0" ? i.void : f(e)))));
+	return {
+		get: (e) => c("get", e, (t) => t.get(a(e))).pipe(i.flatMap((t) => t === null ? i.succeed(o.none()) : u(e, t))),
+		set: (e, t, n) => l(e, t).pipe(i.flatMap((t) => n?.ttlMs !== void 0 && n.ttlMs > 0 ? c("set", e, (r) => r.psetex(a(e), Math.ceil(n.ttlMs), t)) : c("set", e, (n) => n.set(a(e), t))), i.asVoid),
+		delete: (e) => c("delete", e, (t) => t.del([a(e)])).pipe(i.map((e) => e > 0)),
+		has: (e) => c("has", e, (t) => t.exists(a(e))).pipe(i.map((e) => e > 0)),
+		list: (e) => d(`${n}:${e}*`, "0", []),
+		clear: () => f("0")
+	};
+}, c = (r = {}) => a.effect(e, i.gen(function* () {
+	return s(yield* (yield* n).client(r.connectionName ?? "kv").pipe(i.catch((e) => e instanceof t ? i.fail(e) : i.fail(new t({
+		operation: "connect",
+		key: "",
+		cause: String(e)
+	})))), r.keyPrefix ?? "voltro:kv");
+}));
+//#endregion
+export { c as layerRedis, s as makeRedisKvStore };

package/dist/connection.d.ts

@@ -1,15 +1,16 @@
-import { ConfigError } from 'effect';
+import { Config } from 'effect';
 import { Context } from 'effect';
 import { Duration } from 'effect/Duration';
 import { Effect } from 'effect';
 import { Layer } from 'effect';
 import { Schedule } from 'effect';
 import { Schema } from 'effect';
+import { YieldableError } from 'effect/Cause';
 
 /** Bounded retry for transient command failures (network blip). Connect is
  *  NOT retried — a bad url should fail loud at boot. Re-exported so consumers
  *  wrap their own command runners consistently. */
-export declare const commandRetry: Schedule.Schedule<[ Duration, number], unknown, never>;
+export declare const commandRetry: Schedule.Schedule< Duration, unknown, never, never>;
 
 /**
  * Build a RESP command client from resolved config. The driver decides the
@@ -19,30 +20,20 @@ export declare const commandRetry: Schedule.Schedule<[ Duration, number], unknow
  */
 export declare const connect: (config: RedisConnectionConfig) => Effect.Effect<RespClient, KvError>;
 
-/**
- * Resolve a named connection's config from the environment. Reads the
- * per-name override first, then the shared default — e.g. `client('cache')`
- * reads `CACHE_REDIS_URL`, falling back to `REDIS_URL`. Driver / token /
- * key-prefix follow the same `<NAME>_REDIS_*` → `REDIS_*` pattern. A bad
- * driver literal or a fully-missing url is a `ConfigError` (fail-loud at
- * boot), matching the cache layer's stance.
- */
-export declare const connectionConfig: (name: string) => Effect.Effect<RedisConnectionConfig, ConfigError.ConfigError>;
+export declare const connectionConfig: (name: string) => Effect.Effect<RedisConnectionConfig, Config.ConfigError>;
 
 declare class KvError extends KvError_base {
 }
 
-declare const KvError_base: Schema.TaggedErrorClass<KvError, "KvError", {
-    readonly _tag: Schema.tag<"KvError">;
-} & {
+declare const KvError_base: Schema.Class<KvError, Schema.TaggedStruct<"KvError", {
     /** Which op failed: 'get' | 'set' | 'delete' | 'has' | 'clear' |
      *  'list' | 'connect' | 'serialize' | 'deserialize'. */
-    operation: typeof Schema.String;
+    readonly operation: Schema.String;
     /** The key (or connection name) involved; '' where not applicable. */
-    key: typeof Schema.String;
+    readonly key: Schema.String;
     /** `String(originalError)` — round-trip-safe diagnostic form. */
-    cause: typeof Schema.String;
-}>;
+    readonly cause: Schema.String;
+}>, YieldableError>;
 
 /**
  * `Layer<RedisConnections>` — the pooled registry. Each named connection is
@@ -66,7 +57,7 @@ export declare interface RedisConnectionConfig {
 export declare class RedisConnections extends RedisConnections_base {
 }
 
-declare const RedisConnections_base: Context.TagClass<RedisConnections, "@voltro/RedisConnections", RespConnections>;
+declare const RedisConnections_base: Context.ServiceClass<RedisConnections, "@voltro/RedisConnections", RespConnections>;
 
 /** The minimal command surface both ioredis and @upstash/redis satisfy —
  *  the superset the framework's command-only RESP consumers (cache, rate
@@ -91,10 +82,10 @@ export declare interface RespConnections {
     /** Get-or-create the pooled RESP command client for a named connection.
      *  One socket per name for the registry's lifetime — concurrent first-callers
      *  collapse to a single connect. */
-    readonly client: (name: string) => Effect.Effect<RespClient, KvError | ConfigError.ConfigError>;
+    readonly client: (name: string) => Effect.Effect<RespClient, KvError | Config.ConfigError>;
     /** Resolve a named connection's config WITHOUT opening it — for consumers
      *  that build their own client (e.g. a dedicated pub/sub connection). */
-    readonly config: (name: string) => Effect.Effect<RedisConnectionConfig, ConfigError.ConfigError>;
+    readonly config: (name: string) => Effect.Effect<RedisConnectionConfig, Config.ConfigError>;
 }
 
 export { }

package/dist/connection.js

@@ -1,2 +1,81 @@
-import { a as e, i as t, n, r, t as i } from "./connection-DtnqPJzH.js";
-export { i as RedisConnections, n as commandRetry, r as connect, t as connectionConfig, e as layerConnections };
+import { KvError as e } from "./errors.js";
+import { Config as t, Context as n, Effect as r, HashMap as i, Layer as a, Option as o, Schedule as s, Scope as c, SynchronizedRef as l } from "effect";
+//#region src/connection.ts
+var u = (e) => ({
+	get: (t) => e.get(t),
+	set: (t, n) => e.set(t, n),
+	psetex: (t, n, r) => e.psetex(t, n, r),
+	del: (t) => t.length === 0 ? Promise.resolve(0) : e.del(...t),
+	exists: (t) => e.exists(t),
+	eval: (t, n, ...r) => e.eval(t, n, ...r),
+	zrange: (t) => e.zrange(t, 0, -1),
+	scan: async (t, n, r) => {
+		let [i, a] = await e.scan(t, "MATCH", n, "COUNT", r);
+		return {
+			cursor: i,
+			keys: a
+		};
+	},
+	close: () => e.quit().then(() => void 0).catch(() => {
+		try {
+			e.disconnect();
+		} catch {}
+	})
+}), d = (e) => ({
+	get: (t) => e.get(t),
+	set: (t, n) => e.set(t, n),
+	psetex: (t, n, r) => e.psetex(t, n, r),
+	del: (t) => t.length === 0 ? Promise.resolve(0) : e.del(...t),
+	exists: (t) => e.exists(t),
+	eval: (t, n, ...r) => e.eval(t, r.slice(0, n), r.slice(n)),
+	zrange: (t) => e.zrange(t, 0, -1),
+	scan: async (t, n, r) => {
+		let [i, a] = await e.scan(t, {
+			match: n,
+			count: r
+		});
+		return {
+			cursor: String(i),
+			keys: a
+		};
+	},
+	close: () => Promise.resolve()
+}), f = (e) => e.toUpperCase().replace(/[^A-Z0-9]+/g, "_"), p = ["resp", "http"], m = (e) => r.gen(function* () {
+	let n = f(e), r = yield* t.String(`${n}_REDIS_URL`).pipe(t.orElse(() => t.String("REDIS_URL"))), i = yield* t.Literals(p, `${n}_REDIS_DRIVER`).pipe(t.option), a = o.isSome(i) ? i.value : yield* t.Literals(p, "REDIS_DRIVER").pipe(t.withDefault("resp")), s = yield* t.String(`${n}_REDIS_TOKEN`).pipe(t.orElse(() => t.String("REDIS_TOKEN")), t.orElse(() => t.String("UPSTASH_REDIS_REST_TOKEN")), t.option), c = yield* t.String(`${n}_REDIS_KEY_PREFIX`).pipe(t.option);
+	return {
+		url: r,
+		driver: a,
+		...o.isSome(s) ? { token: s.value } : {},
+		...o.isSome(c) ? { keyPrefix: c.value } : {}
+	};
+}), h = (t) => r.tryPromise({
+	try: async () => {
+		if (t.driver === "http") {
+			let e = await import("@upstash/redis"), n = typeof e.default == "function" ? e.default : e.default?.Redis, r = e.Redis ?? n;
+			if (!r) throw Error("@upstash/redis: Redis constructor not found in module");
+			return d(new r({
+				url: t.url,
+				token: t.token,
+				automaticDeserialization: !1
+			}));
+		}
+		let e = (await import("ioredis")).default, n = new e(t.url);
+		return n.on("error", () => {}), u(n);
+	},
+	catch: (t) => new e({
+		operation: "connect",
+		key: "",
+		cause: String(t)
+	})
+}), g = s.max([s.exponential("10 millis"), s.recurs(2)]), _ = class extends n.Service()("@voltro/RedisConnections") {}, v = a.effect(_, r.gen(function* () {
+	let e = yield* r.scope, t = yield* l.make(i.empty()), n = (e) => m(e);
+	return {
+		client: (a) => l.modifyEffect(t, (t) => {
+			let s = i.get(t, a);
+			return o.isSome(s) ? r.succeed([s.value, t]) : n(a).pipe(r.flatMap(h), r.tap((t) => c.addFinalizer(e, r.promise(() => t.close().catch(() => void 0)))), r.map((e) => [e, i.set(t, a, e)]));
+		}),
+		config: n
+	};
+}));
+//#endregion
+export { _ as RedisConnections, g as commandRetry, h as connect, m as connectionConfig, v as layerConnections };

package/dist/errors.js

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

package/dist/expirySweep.js

@@ -0,0 +1,26 @@
+import { HashMap as e, Option as t } from "effect";
+//#region src/expirySweep.ts
+var n = () => {
+	let n;
+	return {
+		reset: () => {
+			n = void 0;
+		},
+		sweep: (r, i) => {
+			n ??= e.keys(r)[Symbol.iterator]();
+			let a = r;
+			for (let r = 0; r < 16; r++) {
+				let r = n.next();
+				if (r.done) {
+					n = void 0;
+					break;
+				}
+				let o = e.get(a, r.value);
+				t.isSome(o) && o.value.expiresAt <= i && (a = e.remove(a, r.value));
+			}
+			return a;
+		}
+	};
+};
+//#endregion
+export { n as makeExpirySweep };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ConfigError } from 'effect';
+import { Config } from 'effect';
 import { Context } from 'effect';
 import { Duration } from 'effect/Duration';
 import { Effect } from 'effect';
@@ -6,11 +6,12 @@ import { Layer } from 'effect';
 import { Option } from 'effect';
 import { Schedule } from 'effect';
 import { Schema } from 'effect';
+import { YieldableError } from 'effect/Cause';
 
 /** Bounded retry for transient command failures (network blip). Connect is
  *  NOT retried — a bad url should fail loud at boot. Re-exported so consumers
  *  wrap their own command runners consistently. */
-export declare const commandRetry: Schedule.Schedule<[ Duration, number], unknown, never>;
+export declare const commandRetry: Schedule.Schedule< Duration, unknown, never, never>;
 
 /**
  * Build a RESP command client from resolved config. The driver decides the
@@ -20,21 +21,25 @@ export declare const commandRetry: Schedule.Schedule<[ Duration, number], unknow
  */
 export declare const connect: (config: RedisConnectionConfig) => Effect.Effect<RespClient, KvError>;
 
-/**
- * Resolve a named connection's config from the environment. Reads the
- * per-name override first, then the shared default — e.g. `client('cache')`
- * reads `CACHE_REDIS_URL`, falling back to `REDIS_URL`. Driver / token /
- * key-prefix follow the same `<NAME>_REDIS_*` → `REDIS_*` pattern. A bad
- * driver literal or a fully-missing url is a `ConfigError` (fail-loud at
- * boot), matching the cache layer's stance.
- */
-export declare const connectionConfig: (name: string) => Effect.Effect<RedisConnectionConfig, ConfigError.ConfigError>;
+export declare const connectionConfig: (name: string) => Effect.Effect<RedisConnectionConfig, Config.ConfigError>;
 
 export declare class Kv extends Kv_base {
+    /** `Kv` over whatever `KvStore` is provided. */
+    static readonly layer: Layer.Layer<Kv, never, KvStore>;
 }
 
-declare const Kv_base: Effect.Service.Class<Kv, "@voltro/Kv", {
-    readonly effect: Effect.Effect<{
+declare const Kv_base: Context.ServiceClass<Kv, "@voltro/Kv", {
+    /** Read a typed value. `None` on miss/expiry. */
+    readonly get: <A = unknown>(key: string) => Effect.Effect<Option.Option<A>, KvError>;
+    /** Read a typed value, falling back to `orElse()` (run only on miss). */
+    readonly getOrElse: <A>(key: string, orElse: () => A) => Effect.Effect<A, KvError>;
+    readonly set: <A>(key: string, value: A, options?: KvSetOptions) => Effect.Effect<void, KvError>;
+    readonly delete: (key: string) => Effect.Effect<boolean, KvError>;
+    readonly has: (key: string) => Effect.Effect<boolean, KvError>;
+    readonly list: (prefix: string) => Effect.Effect<ReadonlyArray<string>, KvError>;
+    readonly clear: () => Effect.Effect<void, KvError>;
+}> & {
+    readonly make: Effect.Effect<{
         /** Read a typed value. `None` on miss/expiry. */
         readonly get: <A = unknown>(key: string) => Effect.Effect<Option.Option<A>, KvError>;
         /** Read a typed value, falling back to `orElse()` (run only on miss). */
@@ -45,22 +50,20 @@ declare const Kv_base: Effect.Service.Class<Kv, "@voltro/Kv", {
         readonly list: (prefix: string) => Effect.Effect<ReadonlyArray<string>, KvError>;
         readonly clear: () => Effect.Effect<void, KvError>;
     }, never, KvStore>;
-}>;
+};
 
 export declare class KvError extends KvError_base {
 }
 
-declare const KvError_base: Schema.TaggedErrorClass<KvError, "KvError", {
-    readonly _tag: Schema.tag<"KvError">;
-} & {
+declare const KvError_base: Schema.Class<KvError, Schema.TaggedStruct<"KvError", {
     /** Which op failed: 'get' | 'set' | 'delete' | 'has' | 'clear' |
      *  'list' | 'connect' | 'serialize' | 'deserialize'. */
-    operation: typeof Schema.String;
+    readonly operation: Schema.String;
     /** The key (or connection name) involved; '' where not applicable. */
-    key: typeof Schema.String;
+    readonly key: Schema.String;
     /** `String(originalError)` — round-trip-safe diagnostic form. */
-    cause: typeof Schema.String;
-}>;
+    readonly cause: Schema.String;
+}>, YieldableError>;
 
 export declare interface KvSetOptions {
     /** Time-to-live in milliseconds. Omit for no expiry — the entry lives until
@@ -71,7 +74,7 @@ export declare interface KvSetOptions {
 export declare class KvStore extends KvStore_base {
 }
 
-declare const KvStore_base: Context.TagClass<KvStore, "@voltro/KvStore", KvStoreShape>;
+declare const KvStore_base: Context.ServiceClass<KvStore, "@voltro/KvStore", KvStoreShape>;
 
 export declare interface KvStoreShape {
     /** Read a value. `None` on miss OR expiry (expired entries are lazily
@@ -135,7 +138,7 @@ export declare interface RedisConnectionConfig {
 export declare class RedisConnections extends RedisConnections_base {
 }
 
-declare const RedisConnections_base: Context.TagClass<RedisConnections, "@voltro/RedisConnections", RespConnections>;
+declare const RedisConnections_base: Context.ServiceClass<RedisConnections, "@voltro/RedisConnections", RespConnections>;
 
 export declare interface RedisKvOptions {
     /** Named connection to draw from the registry. Default `'kv'` — reads
@@ -168,10 +171,10 @@ export declare interface RespConnections {
     /** Get-or-create the pooled RESP command client for a named connection.
      *  One socket per name for the registry's lifetime — concurrent first-callers
      *  collapse to a single connect. */
-    readonly client: (name: string) => Effect.Effect<RespClient, KvError | ConfigError.ConfigError>;
+    readonly client: (name: string) => Effect.Effect<RespClient, KvError | Config.ConfigError>;
     /** Resolve a named connection's config WITHOUT opening it — for consumers
      *  that build their own client (e.g. a dedicated pub/sub connection). */
-    readonly config: (name: string) => Effect.Effect<RedisConnectionConfig, ConfigError.ConfigError>;
+    readonly config: (name: string) => Effect.Effect<RedisConnectionConfig, Config.ConfigError>;
 }
 
 export { }

package/dist/index.js

@@ -1,83 +1,7 @@
-import { a as e, i as t, n, o as r, r as i, t as a } from "./connection-DtnqPJzH.js";
-import { Clock as o, Context as s, Effect as c, HashMap as l, Layer as u, Option as d, Ref as f } from "effect";
-//#region src/KvStore.ts
-var p = class extends s.Tag("@voltro/KvStore")() {}, m = class extends c.Service()("@voltro/Kv", { effect: c.gen(function* () {
-	let e = yield* p;
-	return {
-		get: (t) => e.get(t),
-		getOrElse: (t, n) => e.get(t).pipe(c.map((e) => d.isSome(e) ? e.value : n())),
-		set: (t, n, r) => e.set(t, n, r),
-		delete: e.delete,
-		has: e.has,
-		list: e.list,
-		clear: e.clear
-	};
-}) }) {}, h = (e, t) => t === void 0 ? Infinity : e + t, g = (e) => c.gen(function* () {
-	let t = yield* f.make(l.empty()), n = e.now === void 0 ? o.currentTimeMillis : c.sync(e.now);
-	return {
-		get: (e) => n.pipe(c.flatMap((n) => f.modify(t, (t) => {
-			let r = l.get(t, e);
-			return d.isNone(r) ? [d.none(), t] : r.value.expiresAt <= n ? [d.none(), l.remove(t, e)] : [d.some(r.value.value), t];
-		}))),
-		set: (e, r, i) => n.pipe(c.flatMap((n) => f.update(t, (t) => l.set(t, e, {
-			value: r,
-			expiresAt: h(n, i?.ttlMs)
-		})))),
-		delete: (e) => n.pipe(c.flatMap((n) => f.modify(t, (t) => {
-			let r = l.get(t, e);
-			return d.isNone(r) ? [!1, t] : [r.value.expiresAt > n, l.remove(t, e)];
-		}))),
-		has: (e) => n.pipe(c.flatMap((n) => f.modify(t, (t) => {
-			let r = l.get(t, e);
-			return d.isNone(r) ? [!1, t] : r.value.expiresAt <= n ? [!1, l.remove(t, e)] : [!0, t];
-		}))),
-		list: (e) => n.pipe(c.flatMap((n) => f.get(t).pipe(c.map((t) => {
-			let r = [];
-			for (let [i, a] of t) a.expiresAt <= n || (e === "" || i.startsWith(e)) && r.push(i);
-			return r;
-		})))),
-		clear: () => f.set(t, l.empty())
-	};
-}), _ = (e = {}) => u.effect(p, g(e)), v = (e, t = "voltro:kv") => {
-	let i = (e) => `${t}:${e}`, a = (e) => e.slice(t.length + 1), o = (t, i, a) => c.tryPromise({
-		try: () => a(e),
-		catch: (e) => new r({
-			operation: t,
-			key: i,
-			cause: String(e)
-		})
-	}).pipe(c.retry(n)), s = (e, t) => c.try({
-		try: () => JSON.stringify(t),
-		catch: (t) => new r({
-			operation: "serialize",
-			key: e,
-			cause: String(t)
-		})
-	}), l = (e, t) => c.try({
-		try: () => d.some(JSON.parse(t)),
-		catch: (t) => new r({
-			operation: "deserialize",
-			key: e,
-			cause: String(t)
-		})
-	}), u = (e, t, n) => o("list", "", (n) => n.scan(t, e, 200)).pipe(c.flatMap(({ cursor: t, keys: r }) => {
-		for (let e of r) n.push(a(e));
-		return t === "0" ? c.succeed(n) : u(e, t, n);
-	})), f = (e) => o("clear", "", (n) => n.scan(e, `${t}:*`, 200)).pipe(c.flatMap(({ cursor: e, keys: t }) => (t.length > 0 ? o("clear", "", (e) => e.del(t)) : c.succeed(0)).pipe(c.flatMap(() => e === "0" ? c.void : f(e)))));
-	return {
-		get: (e) => o("get", e, (t) => t.get(i(e))).pipe(c.flatMap((t) => t === null ? c.succeed(d.none()) : l(e, t))),
-		set: (e, t, n) => s(e, t).pipe(c.flatMap((t) => n?.ttlMs !== void 0 && n.ttlMs > 0 ? o("set", e, (r) => r.psetex(i(e), Math.ceil(n.ttlMs), t)) : o("set", e, (n) => n.set(i(e), t))), c.asVoid),
-		delete: (e) => o("delete", e, (t) => t.del([i(e)])).pipe(c.map((e) => e > 0)),
-		has: (e) => o("has", e, (t) => t.exists(i(e))).pipe(c.map((e) => e > 0)),
-		list: (e) => u(`${t}:${e}*`, "0", []),
-		clear: () => f("0")
-	};
-}, y = (e = {}) => u.effect(p, c.gen(function* () {
-	return v(yield* (yield* a).client(e.connectionName ?? "kv").pipe(c.catchAll((e) => e instanceof r ? c.fail(e) : c.fail(new r({
-		operation: "connect",
-		key: "",
-		cause: String(e)
-	})))), e.keyPrefix ?? "voltro:kv");
-}));
-//#endregion
-export { m as Kv, r as KvError, p as KvStore, a as RedisConnections, n as commandRetry, i as connect, t as connectionConfig, e as layerConnections, _ as layerMemory, y as layerRedis, v as makeRedisKvStore };
+import { KvStore as e } from "./KvStore.js";
+import { Kv as t } from "./Kv.js";
+import { KvError as n } from "./errors.js";
+import { layerMemory as r } from "./backendMemory.js";
+import { RedisConnections as i, commandRetry as a, connect as o, connectionConfig as s, layerConnections as c } from "./connection.js";
+import { layerRedis as l, makeRedisKvStore as u } from "./backendRedis.js";
+export { t as Kv, n as KvError, e as KvStore, i as RedisConnections, a as commandRetry, o as connect, s as connectionConfig, c as layerConnections, r as layerMemory, l as layerRedis, u as makeRedisKvStore };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/kv",
-  "version": "0.84.0",
+  "version": "0.86.0",
   "description": "Named RESP connection registry + durable key-value primitive. One config surface for many Redis-family connections (Redis/Valkey/KeyDB/Dragonfly/Upstash) shared across cache, rate-limit, RYW and broadcast; plus a durable, tenant-scoped KV store distinct from the best-effort cache.",
   "keywords": [
     "voltro",
@@ -42,7 +42,7 @@
     "ioredis": "^5.11.1"
   },
   "peerDependencies": {
-    "effect": "^3.22.2"
+    "effect": "4.0.1"
   },
   "publishConfig": {
     "access": "public"

package/dist/connection-DtnqPJzH.js

@@ -1,84 +0,0 @@
-import { Config as e, Context as t, Effect as n, HashMap as r, Layer as i, Option as a, Schedule as o, Schema as s, Scope as c, SynchronizedRef as l } from "effect";
-//#region src/errors.ts
-var u = class extends s.TaggedError()("KvError", {
-	operation: s.String,
-	key: s.String,
-	cause: s.String
-}) {}, d = (e) => ({
-	get: (t) => e.get(t),
-	set: (t, n) => e.set(t, n),
-	psetex: (t, n, r) => e.psetex(t, n, r),
-	del: (t) => t.length === 0 ? Promise.resolve(0) : e.del(...t),
-	exists: (t) => e.exists(t),
-	eval: (t, n, ...r) => e.eval(t, n, ...r),
-	zrange: (t) => e.zrange(t, 0, -1),
-	scan: async (t, n, r) => {
-		let [i, a] = await e.scan(t, "MATCH", n, "COUNT", r);
-		return {
-			cursor: i,
-			keys: a
-		};
-	},
-	close: () => e.quit().then(() => void 0).catch(() => {
-		try {
-			e.disconnect();
-		} catch {}
-	})
-}), f = (e) => ({
-	get: (t) => e.get(t),
-	set: (t, n) => e.set(t, n),
-	psetex: (t, n, r) => e.psetex(t, n, r),
-	del: (t) => t.length === 0 ? Promise.resolve(0) : e.del(...t),
-	exists: (t) => e.exists(t),
-	eval: (t, n, ...r) => e.eval(t, r.slice(0, n), r.slice(n)),
-	zrange: (t) => e.zrange(t, 0, -1),
-	scan: async (t, n, r) => {
-		let [i, a] = await e.scan(t, {
-			match: n,
-			count: r
-		});
-		return {
-			cursor: String(i),
-			keys: a
-		};
-	},
-	close: () => Promise.resolve()
-}), p = (e) => e.toUpperCase().replace(/[^A-Z0-9]+/g, "_"), m = (t) => n.gen(function* () {
-	let n = p(t), r = yield* e.string(`${n}_REDIS_URL`).pipe(e.orElse(() => e.string("REDIS_URL"))), i = yield* e.literal("resp", "http")(`${n}_REDIS_DRIVER`).pipe(e.orElse(() => e.literal("resp", "http")("REDIS_DRIVER")), e.withDefault("resp")), o = yield* e.string(`${n}_REDIS_TOKEN`).pipe(e.orElse(() => e.string("REDIS_TOKEN")), e.orElse(() => e.string("UPSTASH_REDIS_REST_TOKEN")), e.option), s = yield* e.string(`${n}_REDIS_KEY_PREFIX`).pipe(e.option);
-	return {
-		url: r,
-		driver: i,
-		...a.isSome(o) ? { token: o.value } : {},
-		...a.isSome(s) ? { keyPrefix: s.value } : {}
-	};
-}), h = (e) => n.tryPromise({
-	try: async () => {
-		if (e.driver === "http") {
-			let t = await import("@upstash/redis"), n = typeof t.default == "function" ? t.default : t.default?.Redis, r = t.Redis ?? n;
-			if (!r) throw Error("@upstash/redis: Redis constructor not found in module");
-			return f(new r({
-				url: e.url,
-				token: e.token,
-				automaticDeserialization: !1
-			}));
-		}
-		let t = (await import("ioredis")).default, n = new t(e.url);
-		return n.on("error", () => {}), d(n);
-	},
-	catch: (e) => new u({
-		operation: "connect",
-		key: "",
-		cause: String(e)
-	})
-}), g = o.exponential("10 millis").pipe(o.intersect(o.recurs(2))), _ = class extends t.Tag("@voltro/RedisConnections")() {}, v = i.scoped(_, n.gen(function* () {
-	let e = yield* n.scope, t = yield* l.make(r.empty()), i = (e) => m(e);
-	return {
-		client: (o) => l.modifyEffect(t, (t) => {
-			let s = r.get(t, o);
-			return a.isSome(s) ? n.succeed([s.value, t]) : i(o).pipe(n.flatMap(h), n.tap((t) => c.addFinalizer(e, n.promise(() => t.close().catch(() => void 0)))), n.map((e) => [e, r.set(t, o, e)]));
-		}),
-		config: i
-	};
-}));
-//#endregion
-export { v as a, m as i, g as n, u as o, h as r, _ as t };