@voltro/web 0.1.0

package/dist/frameworkBoot-DBOFujAI.js

@@ -0,0 +1,596 @@
+import { AppClientsContext as e } from "./hooks.js";
+import { c as t, l as n, r, s as i } from "./defaultFallbacks-Bg_X-9Wv.js";
+import { createContext as a, useCallback as o, useContext as s, useEffect as c, useRef as l, useState as u, useSyncExternalStore as d } from "react";
+import { Context as f, Layer as p, ManagedRuntime as m } from "effect";
+import * as h from "@effect/platform/Socket";
+import * as g from "@effect/platform/Headers";
+import { RpcClient as _, RpcSerialization as v } from "@effect/rpc";
+import { FrameworkRuntimesProvider as y, RpcErrorBus as b, SubscriptionCache as ee, ssrClientProxy as te, ssrStubHandle as ne, subscribeClientTraces as re } from "@voltro/client";
+import { Fragment as x, jsx as S, jsxs as C } from "react/jsx-runtime";
+//#region src/reconnect.ts
+var w = a(null), ie = () => s(w) ?? (() => {}), ae = 150, T = 220, E = () => {
+	let e = d(n, i, i).some((e) => e.kind === "loading" || e.kind === "reconnecting"), [t, r] = u(!1);
+	return c(() => {
+		if (!e) {
+			r(!1);
+			return;
+		}
+		let t = setTimeout(() => r(!0), ae);
+		return () => clearTimeout(t);
+	}, [e]), /* @__PURE__ */ C("div", {
+		"aria-hidden": "true",
+		"data-voltro-nav-indicator": "",
+		style: {
+			position: "fixed",
+			right: 18,
+			bottom: 18,
+			zIndex: 2147483646,
+			pointerEvents: "none",
+			opacity: +!!t,
+			transform: t ? "translateY(0) scale(1)" : "translateY(4px) scale(0.96)",
+			transition: `opacity ${T}ms ease, transform ${T}ms ease`,
+			display: "grid",
+			placeItems: "center",
+			width: 34,
+			height: 34,
+			borderRadius: 999,
+			background: "color-mix(in oklch, canvas 78%, transparent)",
+			backdropFilter: "blur(6px)",
+			WebkitBackdropFilter: "blur(6px)",
+			border: "1px solid color-mix(in oklch, canvastext 12%, transparent)",
+			boxShadow: "0 4px 14px color-mix(in oklch, canvastext 16%, transparent)"
+		},
+		children: [/* @__PURE__ */ S("span", { "data-voltro-nav-spinner": "" }), /* @__PURE__ */ S("style", { children: oe })]
+	});
+}, oe = "\n@keyframes voltroNavSpin { to { transform: rotate(360deg); } }\n[data-voltro-nav-spinner] {\n  width: 16px;\n  height: 16px;\n  border-radius: 50%;\n  border: 2px solid color-mix(in oklch, canvastext 22%, transparent);\n  border-top-color: color-mix(in oklch, canvastext 78%, transparent);\n  animation: voltroNavSpin 0.7s linear infinite;\n}\n@media (prefers-reduced-motion: reduce) {\n  [data-voltro-nav-spinner] { animation-duration: 1.6s; }\n}\n", se = (e) => Math.min(500 * 2 ** Math.min(e - 1, 4), 5e3), ce = 2, D = 2e3, O = () => typeof window < "u" && !1, le = () => typeof window > "u" ? null : `${window.location.origin}/`, ue = 2e4, k = "voltro:wedge-reload-at", de = () => {
+	try {
+		let e = Number(window.sessionStorage.getItem(k) ?? "0"), t = Date.now();
+		if (t - e < ue) return;
+		window.sessionStorage.setItem(k, String(t));
+	} catch {}
+	window.location.reload();
+}, fe = () => ({
+	resolved: null,
+	retryToken: 0,
+	failureCount: 0,
+	generation: 0,
+	reconnectStatusDispose: null,
+	everOpened: !1,
+	healthPollHandle: null
+}), A = (e) => {
+	e.healthPollHandle !== null && (clearInterval(e.healthPollHandle), e.healthPollHandle = null);
+}, j = (e) => {
+	e.cache.destroy(e.runtime), e.runtime.dispose();
+}, pe = (e) => {
+	let n = e.apis, r = e.buildClient, i = e.onChange, a = e.retryDelayMs ?? se, o = e.stableWindowMs ?? 5e3, s = e.scheduler?.setTimeout ?? ((e, t) => setTimeout(e, t)), c = e.scheduler?.clearTimeout ?? ((e) => {
+		clearTimeout(e);
+	}), l = e.scheduler?.queueMicrotask ?? queueMicrotask, u = /* @__PURE__ */ new Map();
+	for (let e of n) u.set(e.name, fe());
+	let d = !1, f = /* @__PURE__ */ new Set(), p = (e, t) => {
+		let n = s(() => {
+			f.delete(n), e();
+		}, t);
+		return f.add(n), n;
+	}, m = () => {
+		if (d) return;
+		let e = /* @__PURE__ */ new Map();
+		for (let [t, n] of u) n.resolved && e.set(t, n.resolved);
+		i(e, n.every((t) => e.has(t.name)));
+	}, h = (e) => {
+		if (d) return;
+		let n = u.get(e.name);
+		if (!n) return;
+		n.failureCount += 1;
+		let r = a(n.failureCount), i = ++n.retryToken;
+		if (n.reconnectStatusDispose ||= t({
+			id: `voltro:supervisor:${e.name}`,
+			kind: "reconnecting",
+			label: "Reconnecting…"
+		}), O() && n.everOpened && n.failureCount >= ce && n.healthPollHandle === null) {
+			let e = le();
+			e && (n.healthPollHandle = setInterval(() => {
+				fetch(e, {
+					method: "GET",
+					cache: "no-store",
+					signal: AbortSignal.timeout(D)
+				}).then((e) => {
+					e.status < 500 && de();
+				}).catch(() => {});
+			}, D));
+		}
+		p(() => {
+			d || n.retryToken === i && (n.generation += 1, g(e));
+		}, r);
+	}, g = async (e) => {
+		if (d) return;
+		let t = u.get(e.name);
+		if (!t) return;
+		let n = t.generation, i = () => {
+			if (d || t.generation !== n) return;
+			t.everOpened = !0, A(t), t.retryToken++;
+			let e = t.failureCount;
+			p(() => {
+				d || t.failureCount === e && (t.failureCount = 0);
+			}, o);
+		}, a = (r) => {
+			d || t.generation !== n || h(e);
+		};
+		try {
+			let o = await r(e, n, i, a);
+			if (d || t.generation !== n) {
+				j(o);
+				return;
+			}
+			let s = t.resolved;
+			t.resolved = o, t.reconnectStatusDispose &&= (t.reconnectStatusDispose(), null), m(), s && j(s);
+		} catch {
+			if (d || t.generation !== n) return;
+			h(e);
+		}
+	};
+	return n.length === 0 ? (i(/* @__PURE__ */ new Map(), !0), {
+		dispose: () => {
+			d = !0;
+		},
+		reconnect: () => {}
+	}) : (l(() => {
+		if (!d) for (let e of n) g(e);
+	}), {
+		dispose: () => {
+			if (!d) {
+				d = !0;
+				for (let e of f) c(e);
+				f.clear();
+				for (let [, e] of u) e.resolved && j(e.resolved), e.reconnectStatusDispose && e.reconnectStatusDispose(), A(e);
+				u.clear();
+			}
+		},
+		reconnect: () => {
+			if (!d) for (let e of n) {
+				let t = u.get(e.name);
+				t && (t.retryToken += 1, t.generation += 1, t.failureCount = 0, A(t), g(e));
+			}
+		}
+	});
+}, M = {
+	log: console.log.bind(console),
+	info: console.info.bind(console),
+	warn: console.warn.bind(console),
+	error: console.error.bind(console),
+	debug: console.debug.bind(console)
+}, me = 200, he = 400, N = 20, P = 1e3, F = (e) => {
+	if (typeof e == "string") return e;
+	if (e === void 0) return "undefined";
+	if (e === null) return "null";
+	if (e instanceof Error) return e.stack ?? e.message;
+	if (typeof e == "object") try {
+		return JSON.stringify(e, I());
+	} catch {
+		return Object.prototype.toString.call(e);
+	}
+	return String(e);
+}, I = () => {
+	let e = /* @__PURE__ */ new WeakSet();
+	return (t, n) => {
+		if (typeof n == "object" && n) {
+			if (e.has(n)) return "[Circular]";
+			e.add(n);
+		}
+		return n;
+	};
+}, L = (e, t) => e.length > t ? `${e.slice(0, t)}…` : e, R = /%[sdifoOc]/g, z = (e) => {
+	if (e.length === 0) return {
+		message: "",
+		rest: []
+	};
+	let t = e[0];
+	if (typeof t != "string" || !R.test(t)) return {
+		message: F(t),
+		rest: e.slice(1)
+	};
+	R.lastIndex = 0;
+	let n = 1;
+	return {
+		message: t.replace(R, (t) => {
+			if (t === "%c") return n++, "";
+			if (n >= e.length) return t;
+			let r = e[n++];
+			switch (t) {
+				case "%s": return r === void 0 ? "undefined" : r === null ? "null" : String(r);
+				case "%d":
+				case "%i": {
+					let e = typeof r == "number" ? Math.trunc(r) : parseInt(String(r), 10);
+					return Number.isFinite(e) ? String(e) : "NaN";
+				}
+				case "%f": {
+					let e = typeof r == "number" ? r : parseFloat(String(r));
+					return Number.isFinite(e) ? String(e) : "NaN";
+				}
+				case "%o":
+				case "%O": return F(r);
+				default: return t;
+			}
+		}),
+		rest: e.slice(n)
+	};
+}, B = (e) => {
+	let t = e.flushAfterMs ?? he, n = `${e.baseUrl.replace(/\/+$/, "")}/_voltro/inspect/clientLog`, r = [], i = null, a = !1, o = () => {
+		if (i !== null && (clearTimeout(i), i = null), r.length === 0) return;
+		let t = r;
+		r = [];
+		let a = {
+			app: e.appName,
+			page: typeof window < "u" ? window.location.pathname : void 0,
+			ua: typeof navigator < "u" ? L(navigator.userAgent, 200) : void 0,
+			entries: t
+		};
+		try {
+			fetch(n, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify(a),
+				keepalive: !0,
+				credentials: "omit"
+			}).catch(() => {});
+		} catch {}
+	}, s = () => {
+		i === null && (i = setTimeout(o, t));
+	}, c = (e, t) => {
+		if (a) return;
+		r.length >= me && r.shift();
+		let n = t.find((e) => e instanceof Error), i = t.find((e) => typeof e == "object" && !!e && "componentStack" in e), c = typeof i?.componentStack == "string" ? i.componentStack : void 0, l = t[0] instanceof Error ? {
+			message: t[0].message,
+			rest: t.slice(1)
+		} : z(t), u = L(l.message, P), d = l.rest.filter((e) => e !== n && e !== i).map((e) => L(F(e), P)), f;
+		n ? (f = n.stack ?? n.message, c && (f += `\n\nComponent stack:${c}`)) : e === "error" && (f = (/* @__PURE__ */ Error()).stack);
+		let p = {
+			ts: Date.now(),
+			level: e,
+			message: u,
+			...d.length > 0 ? { args: d } : {},
+			...f === void 0 ? {} : { stack: f }
+		};
+		r.push(p), r.length >= N ? o() : s();
+	}, l = (e) => (...t) => {
+		M[e](...t), c(e, t);
+	};
+	console.log = l("log"), console.info = l("info"), console.warn = l("warn"), console.error = l("error"), console.debug = l("debug");
+	let u = () => {
+		o();
+	};
+	return typeof window < "u" && (window.addEventListener("beforeunload", u), window.addEventListener("pagehide", u)), { dispose: () => {
+		a = !0, o(), i !== null && (clearTimeout(i), i = null), console.log = M.log, console.info = M.info, console.warn = M.warn, console.error = M.error, console.debug = M.debug, typeof window < "u" && (window.removeEventListener("beforeunload", u), window.removeEventListener("pagehide", u));
+	} };
+}, ge = 500, V = /* @__PURE__ */ new Set(), H = (e) => {
+	if (!V.has(e) && (V.add(e), V.size > ge)) {
+		let e = V.values().next().value;
+		e !== void 0 && V.delete(e);
+	}
+}, U = /* @__PURE__ */ new Set(), W = (e) => (U.add(e), () => {
+	U.delete(e);
+}), _e = (e) => {
+	for (let t of U) try {
+		t(e);
+	} catch {}
+}, ve = {
+	log: "log",
+	info: "info",
+	warn: "warn",
+	error: "error",
+	debug: "debug"
+}, G = {
+	log: "color: #888;",
+	info: "color: #2563eb;",
+	warn: "color: #c2410c;",
+	error: "color: #b91c1c; font-weight: 600;",
+	debug: "color: #6b7280;"
+}, K = (e) => {
+	if (typeof EventSource > "u") return { dispose: () => {} };
+	let t = `${e.baseUrl.replace(/\/+$/, "")}/_voltro/inspect/stream?live=1`, n = null, r = !1, i = null, a = () => {
+		r || (n = new EventSource(t), n.addEventListener("log", (t) => {
+			try {
+				let n = JSON.parse(t.data).payload;
+				if (!n || typeof n.message != "string" || n.scope === "client") return;
+				let r = n.level === void 0 ? "log" : ve[n.level], i = n.scope ? ` ${n.scope}` : "";
+				M[r](`%c[server ${e.originLabel}${i}]%c ${n.message}`, G[r], "", ...n.fields ? [n.fields] : []);
+			} catch {}
+		}), n.addEventListener("trace", (t) => {
+			try {
+				let n = JSON.parse(t.data).payload;
+				if (!n || n.status !== "error" || typeof n.traceId != "string" || !V.has(n.traceId)) return;
+				let r = n.name ?? "span", i = n.statusMessage && n.statusMessage.length > 0 ? n.statusMessage : `${r} failed`;
+				_e({
+					traceId: n.traceId,
+					spanName: r,
+					api: e.originLabel,
+					message: i,
+					ts: Date.now()
+				}), M.error(`%c[trace ${e.originLabel}]%c ${r} failed — ${i} (trace ${n.traceId})`, G.error, "");
+			} catch {}
+		}), n.addEventListener("error", () => {
+			n && n.readyState === EventSource.CLOSED && (n = null, !r && i === null && (i = setTimeout(() => {
+				i = null, a();
+			}, 2e3)));
+		}));
+	};
+	return a(), { dispose: () => {
+		r = !0, i !== null && (clearTimeout(i), i = null), n?.close(), n = null;
+	} };
+}, q = {
+	card: "oklch(0.21 0.006 285)",
+	cardRaised: "oklch(0.25 0.007 285)",
+	border: "oklch(1 0 0 / 14%)",
+	fg: "oklch(0.98 0.005 285)",
+	muted: "oklch(0.65 0.012 285)",
+	danger: "oklch(0.7 0.21 22)",
+	dangerDim: "oklch(0.5 0.18 22 / 25%)"
+}, J = "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', monospace", ye = "ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif", be = 0, xe = () => {
+	let [e, t] = u([]);
+	if (c(() => W((e) => {
+		t((t) => {
+			if (t.some((t) => t.traceId === e.traceId && t.spanName === e.spanName)) return t;
+			let n = [...t, {
+				...e,
+				id: ++be
+			}];
+			return n.length > 4 ? n.slice(n.length - 4) : n;
+		});
+	}), []), e.length === 0) return null;
+	let n = (e) => t((t) => t.filter((t) => t.id !== e));
+	return /* @__PURE__ */ S("div", {
+		style: {
+			position: "fixed",
+			right: 16,
+			bottom: 16,
+			zIndex: 2147483646,
+			display: "flex",
+			flexDirection: "column",
+			gap: 10,
+			maxWidth: 380,
+			fontFamily: ye,
+			pointerEvents: "none"
+		},
+		children: e.map((e) => /* @__PURE__ */ S(Se, {
+			toast: e,
+			onDismiss: () => n(e.id)
+		}, e.id))
+	});
+}, Se = ({ toast: e, onDismiss: t }) => {
+	let [n, i] = u(!1), a = `voltro logs --trace ${e.traceId}`;
+	return /* @__PURE__ */ C("div", {
+		style: {
+			pointerEvents: "auto",
+			background: q.card,
+			border: `1px solid ${q.danger}`,
+			borderLeft: `3px solid ${q.danger}`,
+			borderRadius: 10,
+			padding: "12px 14px",
+			boxShadow: "0 8px 28px rgba(0,0,0,0.45)",
+			color: q.fg,
+			fontSize: 13,
+			lineHeight: 1.45
+		},
+		children: [
+			/* @__PURE__ */ C("div", {
+				style: {
+					display: "flex",
+					alignItems: "center",
+					justifyContent: "space-between",
+					gap: 8
+				},
+				children: [/* @__PURE__ */ S("span", {
+					style: {
+						color: q.danger,
+						fontWeight: 600,
+						fontSize: 12,
+						letterSpacing: .3
+					},
+					children: "⚠ Backend error"
+				}), /* @__PURE__ */ S("button", {
+					onClick: t,
+					"aria-label": "Dismiss",
+					style: {
+						background: "transparent",
+						border: "none",
+						color: q.muted,
+						cursor: "pointer",
+						fontSize: 16,
+						lineHeight: 1,
+						padding: 0
+					},
+					children: "×"
+				})]
+			}),
+			/* @__PURE__ */ C("div", {
+				style: {
+					marginTop: 6,
+					color: q.muted,
+					fontSize: 11.5
+				},
+				children: [
+					/* @__PURE__ */ S("span", {
+						style: {
+							fontFamily: J,
+							color: q.fg
+						},
+						children: e.api
+					}),
+					" · ",
+					/* @__PURE__ */ S("span", {
+						style: { fontFamily: J },
+						children: e.spanName
+					})
+				]
+			}),
+			/* @__PURE__ */ S("div", {
+				style: {
+					marginTop: 4,
+					color: q.fg,
+					wordBreak: "break-word"
+				},
+				children: e.message
+			}),
+			/* @__PURE__ */ S("button", {
+				onClick: () => {
+					r(a).then((e) => {
+						e !== "failed" && (i(!0), setTimeout(() => i(!1), 1500));
+					});
+				},
+				title: "Copy command",
+				style: {
+					marginTop: 10,
+					display: "block",
+					width: "100%",
+					textAlign: "left",
+					background: q.cardRaised,
+					border: `1px solid ${q.border}`,
+					borderRadius: 6,
+					padding: "6px 8px",
+					color: q.muted,
+					fontFamily: J,
+					fontSize: 11,
+					cursor: "pointer"
+				},
+				children: n ? "✓ copied" : a
+			})
+		]
+	});
+}, Ce = (e) => {
+	try {
+		let t = new URL(e);
+		return `${t.protocol === "wss:" ? "https:" : "http:"}//${t.host}`;
+	} catch {
+		return "";
+	}
+}, Y = (e, t) => /^wss?:\/\//i.test(e) || /^https?:\/\//i.test(e) ? Ce(e) : `/_voltro/api/${t}`, we = typeof performance < "u" ? performance.now() : Date.now(), X = () => {
+	if (typeof window > "u") return !1;
+	try {
+		if (window.localStorage?.getItem("framework_debug") === "1") return !0;
+	} catch {}
+	return {
+		BASE_URL: "/",
+		DEV: !1,
+		MODE: "production",
+		PROD: !0,
+		SSR: !1
+	}.DEV === !0;
+}, Z = (e, ...t) => {
+	if (!X()) return;
+	let n = ((typeof performance < "u" ? performance.now() : Date.now()) - we).toFixed(0).padStart(6, " ");
+	console.log(`[fw ${e} +${n}ms]`, ...t);
+}, Q = 3e3, Te = 0, Ee = (e, t, n, r) => p.succeed(h.WebSocketConstructor, (i, a) => {
+	let o = ++Te;
+	Z(e, `ws#${o} create gen=${t} url=${i}`);
+	let s = new globalThis.WebSocket(i, a), c = !1, l = !1, u = (e) => {
+		l || (l = !0, r(e));
+	}, d = (t) => (n) => {
+		let r = t === "close" ? `code=${n.code}` : "type=error";
+		Z(e, `ws#${o} ${t} opened=${c} issued=${l} ${r}`), u(t);
+	};
+	return s.addEventListener("open", () => {
+		c = !0, Z(e, `ws#${o} open gen=${t}`), n();
+	}), s.addEventListener("close", d("close")), s.addEventListener("error", d("error")), setTimeout(() => {
+		if (!c && !l) {
+			Z(e, `ws#${o} connect-timeout gen=${t} (no open within ${Q}ms)`), u("connect-timeout");
+			try {
+				s.close();
+			} catch {}
+		}
+	}, Q), s;
+}), De = async (e, t, n, r) => {
+	class i extends f.Tag(`@voltro/web/AppClient/${e.name}`)() {}
+	let a = _.layerProtocolSocket().pipe(p.provide(v.layerJson), p.provide(h.layerWebSocket(e.wsUrl)), p.provide(Ee(e.name, t, n, r))), o = typeof e.headers == "function" ? await e.headers() : e.headers, s = p.scoped(i, _.make(e.group)).pipe(p.provide(a)), c = o ? p.locallyScoped(_.currentHeaders, g.fromInput(o)) : p.empty;
+	Z(e.name, `build gen=${t}: making runtime`);
+	let l = m.make(p.merge(s, c));
+	try {
+		let n = await l.runPromise(i);
+		Z(e.name, `build gen=${t}: runtime resolved`);
+		let r = new b();
+		return {
+			runtime: l,
+			client: n,
+			cache: new ee({ errorBus: r }),
+			errorBus: r
+		};
+	} catch (n) {
+		throw Z(e.name, `build gen=${t}: runtime FAILED, disposing`, n.message ?? n), l.dispose(), n;
+	}
+}, $ = ({ apis: t, children: n, chrome: r }) => {
+	let [i, a] = u(() => ({
+		initialized: t.length === 0,
+		clients: /* @__PURE__ */ new Map()
+	})), s = l(null), d = o(() => {
+		s.current?.reconnect();
+	}, []), [f, p] = u(!1);
+	c(() => {
+		p(!0);
+	}, []), c(() => {
+		let e = pe({
+			apis: t,
+			buildClient: De,
+			onChange: (e, t) => {
+				a({
+					clients: e,
+					initialized: t
+				});
+			}
+		});
+		return s.current = e, () => {
+			e.dispose(), s.current === e && (s.current = null);
+		};
+	}, [t]), c(() => {
+		if (!X() || typeof window > "u") return;
+		let e = [], n = [], r = t[0]?.name ?? "web";
+		e.push(B({
+			baseUrl: window.location.origin,
+			appName: r
+		}));
+		for (let e of t) {
+			let t = Y(e.wsUrl, e.name);
+			t.length !== 0 && n.push(K({
+				baseUrl: t,
+				originLabel: e.name
+			}));
+		}
+		let i = re((e) => H(e.traceId));
+		return () => {
+			for (let t of e) t.dispose();
+			for (let e of n) e.dispose();
+			i();
+		};
+	}, [t]);
+	let m = new Map(t.map((e) => [e.name, i.clients.get(e.name)?.client ?? te])), h = new Map(t.map((e) => {
+		let t = i.clients.get(e.name);
+		return t ? [e.name, {
+			runtime: t.runtime,
+			cache: t.cache,
+			client: t.client,
+			descriptors: e.descriptors,
+			inspectBaseUrl: Y(e.wsUrl, e.name),
+			errorBus: t.errorBus
+		}] : [e.name, {
+			...ne,
+			descriptors: e.descriptors
+		}];
+	}));
+	return /* @__PURE__ */ S(w.Provider, {
+		value: d,
+		children: /* @__PURE__ */ S(y, {
+			apis: h,
+			children: /* @__PURE__ */ C(e.Provider, {
+				value: m,
+				children: [n, f ? /* @__PURE__ */ C(x, { children: [
+					/* @__PURE__ */ S(E, {}),
+					r,
+					X() ? /* @__PURE__ */ S(xe, {}) : null
+				] }) : null]
+			})
+		})
+	});
+}, Oe = ({ App: e, apis: t, Devtools: n }) => /* @__PURE__ */ S($, {
+	apis: t,
+	chrome: n ? /* @__PURE__ */ S(n, {}) : null,
+	children: /* @__PURE__ */ S(e, {})
+});
+//#endregion
+export { K as a, E as c, B as i, w as l, $ as n, H as o, z as r, W as s, Oe as t, ie as u };

package/dist/frameworkBoot.d.ts

@@ -0,0 +1,64 @@
+import { ComponentType } from 'react';
+import { ReactNode } from 'react';
+import { Rpc } from '@effect/rpc';
+import { RpcGroup } from '@effect/rpc';
+
+export declare interface ClientDescriptorMap {
+    readonly [rpcTag: string]: {
+        readonly kind: 'query' | 'mutation' | 'action' | 'stream' | 'workflow';
+        readonly source?: string;
+        readonly targets?: ReadonlyArray<{
+            readonly table: string;
+            readonly op: 'insert' | 'update' | 'delete';
+            readonly order?: 'prepend' | 'append';
+        }>;
+    };
+}
+
+export declare const FrameworkBoot: ({ App, apis, Devtools }: FrameworkBootProps) => ReactNode;
+
+export declare interface FrameworkBootProps {
+    readonly App: ComponentType;
+    readonly apis: ReadonlyArray<MountedApi>;
+    /** Optional devtools overlay. Rendered as a sibling to <App/>
+     *  inside the FrameworkRuntimesProvider tree so its hooks
+     *  (useFrameworkRuntimes etc.) resolve. PascalCase because it is a
+     *  React component reference rendered as <Devtools/>. */
+    readonly Devtools?: ComponentType;
+}
+
+export declare interface MountedApi {
+    readonly name: string;
+    readonly group: RpcGroup.RpcGroup<Rpc.Any>;
+    readonly descriptors: ClientDescriptorMap;
+    readonly wsUrl: string;
+    readonly headers?: ResolvableHeaders | undefined;
+}
+
+/**
+ * Auth headers for an api's WS rpc client. @effect/rpc sends these in the
+ * per-request MESSAGE frame (NOT the WS upgrade — a browser can't set upgrade
+ * headers), so the server's AuthMiddleware sees them on every call; this is
+ * what lets a cross-origin api authenticate WS subscriptions. A thunk is
+ * resolved fresh on every (re)connect, so a rotating token (e.g. a Supabase
+ * access token) is pulled anew per connect instead of freezing at first mount.
+ */
+export declare type ResolvableHeaders = Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+
+export declare const VoltroRuntimeProvider: ({ apis, children, chrome }: VoltroRuntimeProviderProps) => ReactNode;
+
+export declare interface VoltroRuntimeProviderProps {
+    /** The apis to mount (name, group, descriptors, wsUrl, headers). */
+    readonly apis: ReadonlyArray<MountedApi>;
+    /** Rendered inside the resolved runtime contexts — the host's tree. */
+    readonly children: ReactNode;
+    /** Optional extra chrome rendered (post-hydration only) inside the
+     *  runtime contexts, alongside the framework's own NavigationIndicator
+     *  + trace-error overlay. The framework's own web bootstrap passes its
+     *  Devtools overlay here (see `FrameworkBoot`); foreign hosts leave it
+     *  unset. Gated behind the same post-mount flag as the rest of the
+     *  chrome so it never trips a hydration mismatch. */
+    readonly chrome?: ReactNode;
+}
+
+export { }

package/dist/frameworkBoot.js

@@ -0,0 +1,2 @@
+import { n as e, t } from "./frameworkBoot-DBOFujAI.js";
+export { t as FrameworkBoot, e as VoltroRuntimeProvider };

package/dist/hooks.d.ts

@@ -0,0 +1,28 @@
+import { Context } from 'react';
+
+/**
+ * Map of api name → resolved typed rpc client. Installed by the
+ * framework's mount() bootstrap. Consumers read it via useAppClient().
+ */
+export declare type AppClients = ReadonlyMap<string, unknown>;
+
+export declare const AppClientsContext: Context<AppClients | null>;
+
+/**
+ * Returns the typed rpc client mounted under `apiName`. Generic narrows
+ * the result to the caller's group; pass `typeof appGroup` from the api's
+ * generated rpcGroup module:
+ *
+ *   import type { appGroup } from '@app/api/rpcGroup'
+ *   import type { RpcClient, RpcGroup } from '@effect/rpc'
+ *   type ApiClient = RpcClient.RpcClient<RpcGroup.Rpcs<typeof appGroup>>
+ *
+ *   const client = useAppClient<ApiClient>('api')
+ *   const { data } = useSubscription('api', () => client.todos.list({}), [])
+ *
+ * Throws if no api is mounted under `apiName` (typo, missing entry in
+ * app.config.ts, or app not mounted yet).
+ */
+export declare const useAppClient: <Client>(apiName: string) => Client;
+
+export { }