@voltro/kv 0.86.0 → 0.87.0

package/dist/connectionPrefix.js

@@ -0,0 +1,37 @@
+//#region 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) => {
+		if (!Number.isSafeInteger(e) || e < 0 || e > t.length || t.slice(0, e).some((e) => typeof e != "string")) throw Error("Namespaced EVAL requires a valid key count and string keys");
+		return t.map((t, n) => n < e ? r(t) : t);
+	};
+	return {
+		...t.readOnly === void 0 ? {} : { readOnly: {
+			get: (e) => t.readOnly.get(r(e)),
+			exists: (e) => t.readOnly.exists(r(e)),
+			zrange: (e) => t.readOnly.zrange(r(e)),
+			eval: async (e, n, ...r) => t.readOnly.eval(e, n, ...i(n, r))
+		} },
+		...t.crossNode === void 0 ? {} : { crossNode: t.crossNode },
+		...t.ping === void 0 ? {} : { ping: () => t.ping() },
+		...t.diagnostics === void 0 ? {} : { diagnostics: () => t.diagnostics() },
+		...t.onReconnect === void 0 ? {} : { onReconnect: (e) => t.onReconnect(e) },
+		close: () => t.close(),
+		get: (e) => t.get(r(e)),
+		set: (e, n) => t.set(r(e), n),
+		psetex: (e, n, i) => t.psetex(r(e), n, i),
+		del: (e) => t.del(e.map(r)),
+		exists: (e) => t.exists(r(e)),
+		zrange: (e) => t.zrange(r(e)),
+		eval: async (e, n, ...r) => t.eval(e, n, ...i(n, r)),
+		scan: async (r, i, a) => {
+			let o = await t.scan(r, e(n) + i, a);
+			return {
+				cursor: o.cursor,
+				keys: o.keys.filter((e) => e.startsWith(n)).map((e) => e.slice(n.length))
+			};
+		}
+	};
+};
+//#endregion
+export { t as withRespKeyPrefix };

package/dist/connectionScripts.js

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

package/dist/connectionSqlConfig.js

@@ -0,0 +1,119 @@
+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
+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");
+	return Object.freeze({
+		_tag: "DynamicSqlConnection",
+		resolve: e,
+		ttlMs: n
+	});
+}, o = (e) => typeof e == "object" && !!e && !Array.isArray(e), s = (e) => o(e) && e._tag === "ConnectionEnv" && typeof e.name == "string" && /^[A-Z][A-Z0-9_]*$/.test(e.name), c = [
+	"dialect",
+	"url",
+	"tls",
+	"maxConnections",
+	"acquireTimeoutMs",
+	"acquireQueueLimit",
+	"statementTimeoutMs",
+	"schema",
+	"label",
+	"region",
+	"source"
+], l = (e) => {
+	if (Object.keys(e).some((e) => !c.includes(e))) return "SQL connection options contain an unknown field";
+	if (![
+		"postgres",
+		"mysql",
+		"mariadb",
+		"mssql",
+		"sqlite",
+		"turso"
+	].includes(String(e.dialect))) return "SQL connections require an implemented dialect";
+	if (e.tls !== void 0 && !["auto", "required"].includes(String(e.tls))) return "SQL TLS must be auto or required";
+	for (let t of [
+		"maxConnections",
+		"acquireTimeoutMs",
+		"acquireQueueLimit",
+		"statementTimeoutMs"
+	]) {
+		let n = e[t];
+		if (n !== void 0 && (typeof n != "number" || !Number.isSafeInteger(n) || n < +(t === "maxConnections"))) return "SQL pool and timeout options must be safe integers in their allowed range";
+	}
+	if (["sqlite", "turso"].includes(String(e.dialect)) && [
+		"maxConnections",
+		"acquireTimeoutMs",
+		"acquireQueueLimit",
+		"statementTimeoutMs"
+	].some((t) => e[t] !== void 0)) return "Embedded SQL does not implement network pool or timeout options";
+	if (e.statementTimeoutMs !== void 0 && e.dialect !== "postgres") return "SQL statement timeout is implemented only for PostgreSQL";
+	if (e.acquireQueueLimit !== void 0 && !["mysql", "mariadb"].includes(String(e.dialect))) return "SQL acquire queue limit is implemented only for MySQL and MariaDB";
+	if (e.schema !== void 0 && (e.dialect !== "postgres" || typeof e.schema != "string" || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(e.schema))) return "SQL schema requires a PostgreSQL identifier";
+	for (let t of ["label", "region"]) if (e[t] !== void 0 && typeof e[t] != "string") return "SQL metadata must be strings";
+	if (e.source !== void 0 && !["config", "override"].includes(String(e.source))) return "SQL source metadata is invalid";
+}, u = (e) => o(e) ? "_tag" in e ? e._tag === "DynamicSqlConnection" && typeof e.resolve == "function" && typeof e.ttlMs == "number" && Number.isSafeInteger(e.ttlMs) && e.ttlMs > 0 ? void 0 : "Dynamic SQL requires a resolver and positive ttlMs" : l(e) || (e.source === void 0 ? s(e.url) ? void 0 : "SQL endpoints and credentials must use env() declarations" : "SQL source is resolved metadata, not a declaration") : "SQL declarations must be named objects", d = (e) => {
+	if (!o(e)) return "SQL configuration must be a named object";
+	let t = l(e);
+	if (t) return t;
+	if (typeof e.url != "string" || !e.url.trim()) return "SQL requires a resolved nonempty URL";
+	let n = e.dialect;
+	if (["sqlite", "turso"].includes(String(n)) && e.url === ":memory:") return e.tls === "required" ? "SQL TLS requires a network transport with encryption" : void 0;
+	try {
+		let t = new URL(e.url);
+		if (!(n === "postgres" ? ["postgres:", "postgresql:"] : n === "mysql" || n === "mariadb" ? ["mysql:", "mariadb:"] : n === "mssql" ? ["mssql:", "sqlserver:"] : ["file:"]).includes(t.protocol) || t.hash) return "SQL URL must match the declared dialect and have no fragment";
+		if (["sqlite", "turso"].includes(String(n))) {
+			if (t.protocol !== "file:" || t.hostname || t.search || t.username || t.password || !t.pathname || e.url === "file:") return "Embedded SQL registry connections require a local file path without URL authority or query options";
+		} else {
+			if (!t.hostname || !t.pathname.replace(/^\//, "")) return "Network SQL requires an explicit host and database";
+			for (let [r, i] of t.searchParams) {
+				if (![
+					"sslmode",
+					"ssl",
+					...n === "mssql" ? ["encrypt"] : []
+				].includes(r)) return "SQL URL contains an unimplemented query option";
+				if (!(r === "sslmode" ? ["require", "disable"] : [
+					"true",
+					"false",
+					"1",
+					"0"
+				]).includes(i)) return "SQL URL requests an unimplemented TLS mode";
+				if (e.tls === "required" && [
+					"disable",
+					"false",
+					"0"
+				].includes(i)) return "SQL TLS configuration conflicts with the URL";
+				if (t.searchParams.getAll(r).length !== 1) return "SQL URL contains duplicate query options";
+			}
+			let r = [...t.searchParams].map(([e, t]) => e === "sslmode" ? t === "require" : ["true", "1"].includes(t));
+			if (new Set(r).size > 1) return "SQL URL contains conflicting TLS options";
+			decodeURIComponent(t.username), decodeURIComponent(t.password);
+		}
+		if (e.tls === "required" && ["sqlite", "turso"].includes(String(n)) && !["libsql:", "https:"].includes(t.protocol)) return "SQL TLS requires a network transport with encryption";
+	} catch {
+		return "SQL requires a valid dialect URL";
+	}
+}, f = (e, t) => {
+	let n = e.replace(/^sql:/, ""), r = Object.keys(t.sql ?? {});
+	return n || t.defaults?.sql || (r.length === 1 ? r[0] : "");
+}, p = (a, o, c) => r.gen(function* () {
+	let l = e(o);
+	if (l) return yield* r.fail(new t.ConfigError(new n.SourceError({ message: l })));
+	if (a !== "sql:" && !/^sql:[A-Za-z][A-Za-z0-9_-]*$/.test(a)) return yield* r.fail(new t.ConfigError(new n.SourceError({ message: "SQL requires a sql:name reference" })));
+	let u = f(a, o), p = o.sql ?? {}, m = Object.hasOwn(p, u) ? p[u] : void 0;
+	if (m === void 0) return yield* r.fail(new t.ConfigError(new n.SourceError({ message: `Unknown SQL connection ${u || "(default)"}. Known names: ${Object.keys(p).sort().join(", ")}` })));
+	let h;
+	if ("_tag" in m) {
+		if (typeof c?.tenantId != "string" || !c.tenantId) return yield* r.fail(new t.ConfigError(new n.SourceError({ message: "Dynamic SQL requires tenantId" })));
+		h = { ...yield* m.resolve(Object.freeze({ tenantId: c.tenantId })) };
+	} else h = { ...m };
+	let g = yield* t.String(`CONNECTIONS_SQL_${u.toUpperCase().replace(/[^A-Z0-9]+/g, "_")}_URL`).pipe(t.option);
+	i.isSome(g) ? h.url = g.value : s(h.url) && (h.url = yield* t.String(h.url.name));
+	let _ = d(h);
+	return _ ? yield* r.fail(new t.ConfigError(new n.SourceError({ message: _ }))) : {
+		...h,
+		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

@@ -0,0 +1,190 @@
+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
+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");
+	return Object.freeze({
+		_tag: "DynamicStorageConnection",
+		resolve: e,
+		ttlMs: n
+	});
+}, s = (e, t) => {
+	let n = e.replace(/^storage:/, ""), r = Object.keys(t.storage ?? {});
+	return n || t.defaults?.storage || (r.length === 1 ? r[0] : "");
+}, c = (e) => {
+	if (typeof e != "object" || !e || Array.isArray(e)) return "Storage configuration must be a named object";
+	let n = t(e);
+	if (n) return n;
+	if (Object.keys(e).some((e) => ![
+		"provider",
+		"bucket",
+		"root",
+		"endpoint",
+		"accessKeyId",
+		"secretAccessKey",
+		"accountName",
+		"accountKey",
+		"connectionString",
+		"cdnBaseUrl",
+		"forcePathStyle",
+		"publicAcl",
+		"tls",
+		"persistence",
+		"keyPrefix",
+		"allowSharedNamespace",
+		"region",
+		"label",
+		"acl",
+		"source"
+	].includes(e))) return "Storage configuration contains an unknown field";
+	if (e.persistence !== void 0 && ![
+		"required",
+		"optional",
+		"none"
+	].includes(e.persistence)) return "Storage persistence must be required, optional or none";
+	if (![
+		"s3",
+		"minio",
+		"azure",
+		"filesystem",
+		"memory",
+		"database"
+	].includes(e.provider)) return "Storage provider must be s3, minio, azure, filesystem, memory or database";
+	for (let t of [
+		"bucket",
+		"root",
+		"endpoint",
+		"accessKeyId",
+		"secretAccessKey",
+		"accountName",
+		"accountKey",
+		"connectionString",
+		"cdnBaseUrl",
+		"region",
+		"label",
+		"keyPrefix"
+	]) if (e[t] !== void 0 && (typeof e[t] != "string" || !e[t].trim())) return `Storage ${t} must be nonempty`;
+	if (e.accessKeyId === void 0 != (e.secretAccessKey === void 0)) return "Storage access key and secret must resolve together";
+	if (e.accountName === void 0 != (e.accountKey === void 0) && e.connectionString === void 0) return "Azure account and key must resolve together";
+	if ((e.provider === "s3" || e.provider === "minio" || e.provider === "azure") && !e.bucket) return "Object storage requires a bucket or container";
+	if (e.provider === "filesystem" && !e.root) return "Filesystem storage requires a root";
+	if (e.provider === "azure" && !e.connectionString && (!e.accountName || !e.accountKey)) return "Azure storage requires declared credentials";
+	for (let t of [
+		"forcePathStyle",
+		"publicAcl",
+		"allowSharedNamespace"
+	]) if (e[t] !== void 0 && typeof e[t] != "boolean") return `Storage ${t} must be a boolean`;
+	if (e.keyPrefix !== void 0 && (!/^[A-Za-z0-9_:/.-]+$/.test(e.keyPrefix) || e.keyPrefix.startsWith("/") || e.keyPrefix.split("/").includes(".."))) return "Storage namespace must be an opaque relative prefix";
+	for (let t of ["endpoint", "cdnBaseUrl"]) {
+		let n = e[t];
+		if (n !== void 0) try {
+			let t = new URL(n);
+			if (!["https:", "http:"].includes(t.protocol) || t.username || t.password || t.search || t.hash) return "Storage endpoints require HTTP(S) without credentials or query";
+			if (e.tls === "required" && t.protocol !== "https:") return "Storage TLS policy requires HTTPS";
+		} catch {
+			return "Storage endpoints must be valid HTTP(S) URLs";
+		}
+	}
+}, l = (t, o, l) => i.gen(function* () {
+	let u = e(o);
+	if (u) return yield* i.fail(new n.ConfigError(new r.SourceError({ message: u })));
+	if (!/^storage:[A-Za-z][A-Za-z0-9_-]*$/.test(t) && t !== "storage:") return yield* i.fail(new n.ConfigError(new r.SourceError({ message: "Storage requires a storage:name reference" })));
+	let d = s(t, o), f = o.storage ?? {}, p = Object.hasOwn(f, d) ? f[d] : void 0;
+	if (p === void 0) return yield* i.fail(new n.ConfigError(new r.SourceError({ message: `Unknown storage connection ${d || "(default)"}. Known names: ${Object.keys(f).sort().join(", ")}` })));
+	let m, h = !1, g = `CONNECTIONS_STORAGE_${d.toUpperCase().replace(/[^A-Z0-9]+/g, "_")}`, _ = (e, t) => i.gen(function* () {
+		let r = yield* n.String(`${g}_${e}`).pipe(n.option);
+		return a.isSome(r) ? (h = !0, r.value) : t === void 0 || typeof t == "string" ? t : yield* n.String(t.name);
+	});
+	if ("_tag" in p) {
+		if (!l?.tenantId) return yield* i.fail(new n.ConfigError(new r.SourceError({ message: "Dynamic storage requires tenantId" })));
+		m = { ...yield* p.resolve(Object.freeze({ tenantId: l.tenantId })) };
+	} else {
+		let { bucket: e, root: t, endpoint: n, accessKeyId: r, secretAccessKey: i, accountName: a, accountKey: o, connectionString: s, cdnBaseUrl: c, ...l } = p;
+		m = { ...l };
+		for (let [l, u, d] of [
+			[
+				"bucket",
+				"BUCKET",
+				e
+			],
+			[
+				"root",
+				"ROOT",
+				t
+			],
+			[
+				"endpoint",
+				"ENDPOINT",
+				n
+			],
+			[
+				"accessKeyId",
+				"ACCESS_KEY_ID",
+				r
+			],
+			[
+				"secretAccessKey",
+				"SECRET_ACCESS_KEY",
+				i
+			],
+			[
+				"accountName",
+				"ACCOUNT_NAME",
+				a
+			],
+			[
+				"accountKey",
+				"ACCOUNT_KEY",
+				o
+			],
+			[
+				"connectionString",
+				"CONNECTION_STRING",
+				s
+			],
+			[
+				"cdnBaseUrl",
+				"CDN_BASE_URL",
+				c
+			]
+		]) {
+			let e = yield* _(u, d);
+			e !== void 0 && (m = {
+				...m,
+				[l]: e
+			});
+		}
+	}
+	if ("_tag" in p) for (let [e, t] of [
+		["bucket", "BUCKET"],
+		["root", "ROOT"],
+		["endpoint", "ENDPOINT"],
+		["accessKeyId", "ACCESS_KEY_ID"],
+		["secretAccessKey", "SECRET_ACCESS_KEY"],
+		["accountName", "ACCOUNT_NAME"],
+		["accountKey", "ACCOUNT_KEY"],
+		["connectionString", "CONNECTION_STRING"],
+		["cdnBaseUrl", "CDN_BASE_URL"]
+	]) {
+		let n = yield* _(t, m[e]);
+		n !== void 0 && (m = {
+			...m,
+			[e]: n
+		});
+	}
+	for (let [e, t] of [["keyPrefix", "KEY_PREFIX"], ["region", "REGION"]]) {
+		let n = yield* _(t, m[e]);
+		n !== void 0 && (m = {
+			...m,
+			[e]: n
+		});
+	}
+	let v = c(m);
+	return v ? yield* i.fail(new n.ConfigError(new r.SourceError({ message: v }))) : {
+		...m,
+		source: h ? "override" : "config"
+	};
+});
+//#endregion
+export { o as dynamicStorage, c as storageConfigProblem, l as storageConnectionConfig, s as storageConnectionName };

package/dist/connectionStorageFacade.js

@@ -0,0 +1,78 @@
+import { StorageError as e } from "./storage.js";
+import { Effect as t, Stream as n } from "effect";
+//#region src/connectionStorageFacade.ts
+var r = (r) => {
+	let i = (n) => t.fail(new e({
+		provider: r.config().provider,
+		message: `Storage provider does not offer ${n}`,
+		transient: !1
+	})), { config: a, command: o } = r, s = {
+		objectNamespace: o("objectNamespace", (e) => e.objectNamespace),
+		objectLocation: (e) => o("objectLocation", (t) => t.objectLocation?.(e) ?? i("objectLocation")),
+		get name() {
+			return a().provider;
+		},
+		get presigns() {
+			return [
+				"s3",
+				"minio",
+				"azure"
+			].includes(a().provider);
+		},
+		put: (...e) => o("put", (t) => t.put(...e)),
+		get: (...e) => o("get", (t) => t.get(...e)),
+		delete: (...e) => o("delete", (t) => t.delete(...e)),
+		getUrl: (...e) => o("getUrl", (t) => t.getUrl(...e)),
+		head: (...e) => o("head", (t) => t.head(...e)),
+		publicUrl: (e) => {
+			let t = a();
+			return t.cdnBaseUrl ? `${t.cdnBaseUrl.replace(/\/$/, "")}/${t.keyPrefix ?? ""}${e}` : null;
+		},
+		getStream: (n) => o("head", (e) => e.head(n)).pipe(t.flatMap((i) => i === null ? t.fail(new e({
+			provider: a().provider,
+			message: "Storage object is absent",
+			transient: !1,
+			status: 404
+		})) : t.succeed({
+			stream: r.stream(n, i),
+			contentType: i.contentType ?? "application/octet-stream",
+			size: i.size
+		}))),
+		putStream: (e, r, i) => o("putStream", (a) => a.putStream === void 0 ? n.runCollect(r).pipe(t.flatMap((t) => {
+			let n = new Uint8Array([...t].reduce((e, t) => e + t.byteLength, 0)), r = 0;
+			for (let e of t) n.set(e, r), r += e.byteLength;
+			return a.put(e, n, i);
+		})) : a.putStream(e, r, i)),
+		getRange: (e, n, r) => o("getRange", (i) => i.getRange === void 0 ? i.get(e).pipe(t.map((e) => e.bytes.slice(n, r + 1))) : i.getRange(e, n, r)),
+		bindDataStore: r.bind
+	};
+	return Object.defineProperties(s, Object.getOwnPropertyDescriptors({
+		get root() {
+			return a().root;
+		},
+		get setObjectPublic() {
+			return ["s3", "minio"].includes(a().provider) && a().publicAcl !== !1 ? (e, t) => o("setObjectPublic", (n) => n.setObjectPublic?.(e, t) ?? i("setObjectPublic")) : void 0;
+		},
+		get getUploadUrl() {
+			return [
+				"s3",
+				"minio",
+				"azure"
+			].includes(a().provider) ? (e, t, n) => o("getUploadUrl", (r) => r.getUploadUrl?.(e, t, n) ?? i("getUploadUrl")) : void 0;
+		},
+		get createMultipartUpload() {
+			return ["s3", "minio"].includes(a().provider) ? (e, t, n) => o("createMultipartUpload", (r) => r.createMultipartUpload?.(e, t, n) ?? i("createMultipartUpload")) : void 0;
+		},
+		get presignUploadPart() {
+			return ["s3", "minio"].includes(a().provider) ? (e, t, n, r) => o("presignUploadPart", (a) => a.presignUploadPart?.(e, t, n, r) ?? i("presignUploadPart")) : void 0;
+		},
+		get completeMultipartUpload() {
+			return ["s3", "minio"].includes(a().provider) ? (e, t, n) => o("completeMultipartUpload", (r) => r.completeMultipartUpload?.(e, t, n) ?? i("completeMultipartUpload")) : void 0;
+		},
+		get abortMultipartUpload() {
+			return ["s3", "minio"].includes(a().provider) ? (e, t) => o("abortMultipartUpload", (n) => n.abortMultipartUpload?.(e, t) ?? i("abortMultipartUpload")) : void 0;
+		}
+	}));
+};
+//#endregion
+export { r as makeStorageFacade };

package/dist/connectionSubscriber.js

@@ -0,0 +1,130 @@
+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({
+		kind: "standalone",
+		client: s
+	})]).then(() => void 0), l = () => {
+		c();
+	};
+	a.addEventListener("abort", l, { once: !0 }), o.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
+		};
+		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
+		};
+	} catch (e) {
+		throw await c(), e;
+	} finally {
+		a.removeEventListener("abort", l);
+	}
+}, s = (t) => a.tryPromise({
+	try: async (e) => {
+		if (t.driver !== "resp") throw Error("RESP is required for subscriptions");
+		let n = await o(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 t = p.then(e);
+			return p = t.then(() => void 0, () => void 0), t;
+		}, h = (e) => {
+			for (let t of i) try {
+				t(e);
+			} catch {}
+		}, g = (e) => {
+			let t = e.dispose();
+			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 {
+					e(t, n);
+				} catch {}
+			});
+			let t = () => {
+				c || s !== e || (s = void 0, h({ kind: "disconnected" }), g(e), y());
+			};
+			e.client.on("close", t), e.client.on("reconnecting", t);
+		}, v = async () => {
+			let e = new AbortController();
+			u = e;
+			let n, r = () => {
+				n !== void 0 && g(n);
+			};
+			e.signal.addEventListener("abort", r, { once: !0 });
+			try {
+				n = await o(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;
+				}), n = void 0, h({ kind: "reconnected" });
+			} catch {
+				n !== void 0 && await g(n);
+			} finally {
+				e.signal.removeEventListener("abort", r), u = void 0;
+			}
+		}, y = () => {
+			c || l !== void 0 || d !== void 0 || (l = setTimeout(() => {
+				l = void 0, d = v().finally(() => {
+					d = void 0, !c && s === void 0 && y();
+				});
+			}, 100));
+		};
+		if (_(n), n.client.status !== "ready") throw s = 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;
+		};
+		return {
+			subscribe: (e) => m(async () => {
+				let t = b();
+				if (await t.client.subscribe(e), c || s !== 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);
+			}),
+			onMessage: (e) => (r.add(e), () => {
+				r.delete(e);
+			}),
+			onTransportEvent: (e) => (i.add(e), () => {
+				i.delete(e);
+			}),
+			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();
+				}
+				await d, await p, await f;
+			}
+		};
+	},
+	catch: () => new e({
+		operation: "subscribe",
+		key: "",
+		cause: "Redis subscriber could not be opened"
+	})
+});
+//#endregion
+export { s as connectRedisSubscriber };

package/dist/errors.js

@@ -4,6 +4,10 @@ var t = class extends e.TaggedError()("KvError", {
 	operation: e.String,
 	key: e.String,
 	cause: e.String
-}) {};
+}) {
+	get message() {
+		return this.cause;
+	}
+};
 //#endregion
 export { t as KvError };