@voltro/plugin-broadcast 0.85.0 → 0.87.0

package/dist/providers.js

@@ -0,0 +1,95 @@
+import { BroadcastError as e } from "./types.js";
+import { Effect as t } from "effect";
+//#region src/providers.ts
+var n = (t, n, r) => new e({
+	provider: t,
+	message: n,
+	transient: !0,
+	...r === void 0 ? {} : { cause: r }
+}), r = (t, n, r) => new e({
+	provider: t,
+	message: n,
+	transient: !1,
+	...r === void 0 ? {} : { cause: r }
+}), i = () => {
+	let e = /* @__PURE__ */ new Set();
+	return {
+		subscribe: (t) => (e.add(t), () => {
+			e.delete(t);
+		}),
+		emit: (t) => {
+			for (let n of e) try {
+				n(t);
+			} catch {}
+		}
+	};
+}, a = /* @__PURE__ */ new Map(), o = (e) => {
+	let t = a.get(e);
+	return t || (t = { handlers: /* @__PURE__ */ new Map() }, a.set(e, t)), t;
+}, s = (e) => {
+	a.delete(e);
+}, c = (e = `default-${Math.random().toString(36).slice(2)}`) => {
+	let n = /* @__PURE__ */ new Set();
+	return {
+		name: "memory",
+		publish: (n, r) => t.sync(() => {
+			let t = a.get(e)?.handlers.get(n);
+			if (t) for (let e of t) try {
+				e(r);
+			} catch {}
+		}),
+		subscribe: (r, i) => t.sync(() => {
+			let t = o(e), s = t.handlers.get(r) ?? /* @__PURE__ */ new Set(), c = (e) => i(e);
+			s.add(c), t.handlers.set(r, s);
+			let l = () => {
+				n.delete(l), s.delete(c), s.size === 0 && t.handlers.get(r) === s && t.handlers.delete(r), t.handlers.size === 0 && a.get(e) === t && a.delete(e);
+			};
+			return n.add(l), l;
+		}),
+		close: () => t.sync(() => {
+			for (let e of n) e();
+		})
+	};
+}, l = (e, a) => {
+	let o = i(), s = /* @__PURE__ */ new Set(), c, l, u = !1, d, f = (e) => (s.add(e), e.then(() => s.delete(e), () => s.delete(e)), e), p = (n) => {
+		if (u) return Promise.reject(r(e, "Broadcast consumer is closed"));
+		if (c !== void 0) return c;
+		let i = t.runPromiseWith(n)(a.pubsub).then((e) => (l = e.onTransportEvent(o.emit), e));
+		return c = i, i.catch(() => {
+			c === i && (c = void 0);
+		}), i;
+	};
+	return {
+		name: e,
+		onTransportEvent: o.subscribe,
+		publish: (i, a) => t.flatMap(t.context(), (o) => t.tryPromise({
+			try: () => f((async () => {
+				let n = await p(o);
+				if (u) throw r(e, "Broadcast consumer is closed");
+				await t.runPromiseWith(o)(n.publish(i, a));
+			})()),
+			catch: () => n(e, `${e} publication failed`)
+		})),
+		subscribe: (i, a) => t.flatMap(t.context(), (o) => t.tryPromise({
+			try: () => f((async () => {
+				let n = await p(o);
+				if (u) throw r(e, "Broadcast consumer is closed");
+				let s = !0, c = await t.runPromiseWith(o)(n.subscribe(i, (e) => {
+					s && !u && a(e);
+				}));
+				if (u) throw s = !1, await t.runPromiseWith(o)(c), r(e, "Broadcast consumer is closed");
+				return () => {
+					s && (s = !1, f(t.runPromiseWith(o)(c)).catch(() => void 0));
+				};
+			})()),
+			catch: () => n(e, `${e} subscription failed`)
+		})),
+		close: () => t.flatMap(t.context(), (e) => t.promise(() => d ??= (async () => {
+			if (u = !0, await Promise.allSettled([...s]), l?.(), c !== void 0) try {
+				await t.runPromiseWith(e)((await c).close);
+			} catch {}
+		})()))
+	};
+}, u = (e) => l("redis", e), d = (e) => l("nats", e);
+//#endregion
+export { c as memoryProvider, d as natsProvider, u as redisProvider, s as resetMemoryBus };

package/dist/publishQueue.js

@@ -0,0 +1,64 @@
+import { Effect as e } from "effect";
+//#region src/publishQueue.ts
+var t = (t, n, r, i, a = {}, o = () => {}) => {
+	let s = a.maxMessages ?? 1024, c = a.maxBytes ?? 8388608, l = a.timeoutMs ?? 5e3, u = a.shutdownTimeoutMs ?? 1e3;
+	for (let [e, t] of Object.entries({
+		maxMessages: s,
+		maxBytes: c,
+		timeoutMs: l,
+		shutdownTimeoutMs: u
+	})) if (!Number.isSafeInteger(t) || t < 1) throw Error(`broadcast ${e} must be a positive safe integer`);
+	let d = [], f = 0, p = 0, m = !1, h = 0, g = !1, _ = !1, v, y, b = !1, x, S = /* @__PURE__ */ new Set(), C = () => {
+		for (let e of S) e();
+		S.clear();
+	}, w = (e) => {
+		m || i(e), m = !0;
+	}, T = () => {
+		if (g || b || v !== void 0) return;
+		let i = d[f];
+		if (!i && !m) {
+			C();
+			return;
+		}
+		let a = h, s = i?.payload ?? r(a);
+		i && (d[f] = void 0, f++, f * 2 >= d.length && (d = d.slice(f), f = 0)), x = new AbortController(), b = !0;
+		let c = setTimeout(() => {
+			w("publish timed out; peers need a resync");
+		}, l);
+		y = e.runPromise(t.publish(n, s), { signal: x.signal }).then(() => {
+			g || o(), !i && h === a && (m = !1);
+		}, () => {
+			g || (w("publish failed — cross-replica fan-out degraded, local reactivity unaffected; peers need a resync"), v = setTimeout(() => {
+				v = void 0, T();
+			}, 500));
+		}).finally(() => {
+			clearTimeout(c), i && (p -= i.bytes), y = void 0, b = !1, x = void 0, g ? C() : T();
+		});
+	};
+	return {
+		enqueue: (e, t) => {
+			if (_ || g) return;
+			if (h = t, m || d.length - f + +!!b >= s) {
+				w("publish queue full; peers need a resync"), T();
+				return;
+			}
+			let n = e(), r = Buffer.byteLength(n, "utf8");
+			p + r > c ? (w("publish byte budget exceeded; peers need a resync"), T()) : (p += r, d.push({
+				payload: n,
+				bytes: r
+			}), T());
+		},
+		close: async () => {
+			_ = !0, v !== void 0 && (clearTimeout(v), v = void 0), T();
+			let e;
+			(y || d.length > f || m) && await new Promise((t) => {
+				let n = () => {
+					S.delete(n), t();
+				};
+				S.add(n), e = setTimeout(n, u);
+			}), e !== void 0 && clearTimeout(e), g = !0, (y || d.length > f || m) && i("shutdown deadline reached; unsent changes require peer resync"), d = [], f = 0, v !== void 0 && clearTimeout(v), x?.abort(), y && await Promise.race([y, new Promise((e) => setImmediate(e))]), p = 0, C();
+		}
+	};
+};
+//#endregion
+export { t as createPublishQueue };

package/dist/resolve.js

@@ -0,0 +1,70 @@
+import { memoryProvider as e, natsProvider as t, redisProvider as n } from "./providers.js";
+import { Effect as r } from "effect";
+//#region src/resolve.ts
+var i = (e) => {
+	if (!/^(redis|nats):[A-Za-z][A-Za-z0-9_-]*$/.test(e)) throw Error("Broadcast connections require redis:name or nats:name references");
+	return e.startsWith("nats:") ? "nats" : "redis";
+}, a = (a, o, s = () => r.fail(/* @__PURE__ */ Error("Broadcast requires the app connection registry"))) => {
+	let c = [], l = (e, i, a) => {
+		c.push({
+			kind: e,
+			role: i,
+			...a === void 0 ? {} : { reference: a }
+		});
+		let o = r.suspend(() => s(i));
+		return e === "nats" ? t({ pubsub: o }) : n({ pubsub: o });
+	}, u;
+	if (typeof a.provider == "object") {
+		if (a.connection !== void 0) throw Error("A custom Broadcast provider cannot also select a registry connection");
+		u = a.provider;
+	} else {
+		let t = a.provider ?? o.BROADCAST_PROVIDER;
+		if (t !== void 0 && ![
+			"redis",
+			"nats",
+			"memory"
+		].includes(t)) throw Error("Broadcast provider must be redis, nats or memory");
+		let n = a.connection === void 0 ? void 0 : i(a.connection), r = t ?? n ?? (o.BROADCAST_NATS_URL || o.NATS_URL ? "nats" : o.BROADCAST_REDIS_URL || o.REDIS_URL ? "redis" : "memory");
+		if (n !== void 0 && r !== n) throw Error("Broadcast provider must match its connection kind");
+		u = r === "memory" ? e() : l(r === "nats" ? "nats" : "redis", "broadcast", a.connection);
+	}
+	let d = /* @__PURE__ */ new Map();
+	for (let e of [
+		"events",
+		"members",
+		"presence",
+		"revalidate"
+	]) {
+		let t = a[e];
+		t !== void 0 && d.set(e, l(i(t), e, t));
+	}
+	if (d.size === 0) return {
+		provider: u,
+		crossReplica: u.name !== "memory",
+		selections: c
+	};
+	let f = [.../* @__PURE__ */ new Set([u, ...d.values()])], p = (e) => {
+		let t = e.slice(e.indexOf(":") + 1).split(":")[0];
+		return d.get(t) ?? u;
+	};
+	return {
+		provider: {
+			name: [...new Set(f.map((e) => e.name))].join("+"),
+			publish: (e, t) => p(e).publish(e, t),
+			subscribe: (e, t) => p(e).subscribe(e, t),
+			onTransportEvent: (e) => {
+				let t = /* @__PURE__ */ new WeakSet(), n = f.flatMap((n) => n.onTransportEvent === void 0 ? [] : [n.onTransportEvent((n) => {
+					t.has(n) || (t.add(n), e(n));
+				})]);
+				return () => {
+					for (let e of n) e();
+				};
+			},
+			close: () => r.forEach(f, (e) => e.close(), { discard: !0 }).pipe(r.asVoid)
+		},
+		crossReplica: f.some((e) => e.name !== "memory"),
+		selections: c
+	};
+};
+//#endregion
+export { a as resolveBroadcastProvider };

package/dist/types.js

@@ -0,0 +1,11 @@
+import { DEFAULT_BROADCAST_NAMESPACE as e, channelFor as t } from "./namespace.js";
+import { Schema as n } from "effect";
+//#region src/types.ts
+var r = class extends n.TaggedError()("BroadcastError", {
+	provider: n.String,
+	message: n.String,
+	transient: n.Boolean,
+	cause: n.optional(n.Unknown)
+}) {}, i = t(e, "changes");
+//#endregion
+export { i as BROADCAST_CHANNEL, r as BroadcastError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-broadcast",
-  "version": "0.85.0",
+  "version": "0.87.0",
   "description": "Cross-replica reactivity — a pub/sub message bus (Redis / NATS / memory) that fans out app-mutation ChangeEvents to every replica behind a load balancer. ADDITIVE to inline emit: local reactivity survives a broker outage; cross-replica degrades gracefully. Closes the single-instance gap for every non-postgres dialect (postgres keeps native LISTEN/NOTIFY).",
   "keywords": [
     "voltro",
@@ -33,12 +33,9 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.85.0",
-    "@voltro/protocol": "0.85.0"
-  },
-  "optionalDependencies": {
-    "@nats-io/transport-node": "^3.4.0",
-    "ioredis": "^5.11.1"
+    "@voltro/database": "0.87.0",
+    "@voltro/protocol": "0.87.0",
+    "@voltro/kv": "0.87.0"
   },
   "peerDependencies": {
     "effect": "4.0.1"