@voltro/cli 0.21.0 → 0.22.1

package/dist/{inspectMetrics-DMjWBQif.js → inspectMetrics-9ZSuDeqD.js}

@@ -1,5 +1,5 @@
 import { d as e, u as t, x as n } from "./fileConventions-CBNPZVOV.js";
-import { D as r, E as i, T as a, a as o, p as s, w as c } from "./inspect-Dwx0_tUj.js";
+import { D as r, E as i, T as a, a as o, p as s, w as c } from "./inspect-_ldwsAwH.js";
 import { basename as l, dirname as u, isAbsolute as d, join as f, relative as p, resolve as m } from "node:path";
 import { fileURLToPath as h, pathToFileURL as g } from "node:url";
 import { FileSystem as _ } from "@effect/platform";
@@ -1033,7 +1033,7 @@ __installPublicEnv(publicEnvValues)
 		contentType: "application/json",
 		body: JSON.stringify({ error: "inspect disabled (VOLTRO_INSPECT=off)" })
 	};
-	let r = o(n);
+	let r = o(n, "GET");
 	if (!r.ok) return {
 		status: 401,
 		contentType: "application/json",
@@ -1114,7 +1114,10 @@ __installPublicEnv(publicEnvValues)
 }, Dn = "/_voltro/inspect/logs", On = (e, t, n) => {
 	if (t.headers.authorization !== void 0) return !1;
 	let { token: r } = n;
-	return r === void 0 || r === "" || !n.isLoopback(n.target) ? !1 : (e.setHeader("authorization", `Bearer ${r}`), !0);
+	if (r === void 0 || r === "" || !n.isLoopback(n.target)) return !1;
+	e.setHeader("authorization", `Bearer ${r}`);
+	let i = n.writeToken;
+	return i !== void 0 && i !== "" && t.headers["x-voltro-inspect-write"] === void 0 && e.setHeader("x-voltro-inspect-write", i), !0;
 }, kn = [{
 	match: (e) => typeof e == "string" && e.startsWith("[BABEL] Note: The code generator has deoptimised"),
 	handle: (e, t) => {
@@ -1541,6 +1544,28 @@ import {
 		super(e), this.name = "DeferralNotSupportedError";
 	}
 }, Er = (e) => typeof e == "object" && !!e && e._voltroDeferral === !0, Dr = (e) => {
+	if (!(e instanceof Error)) return;
+	let t = e._voltroControl;
+	if (t === "redirect") {
+		let { location: t, status: n } = e;
+		return typeof t == "string" ? {
+			status: n === 307 || n === 308 ? n : 303,
+			headers: {
+				location: t,
+				"x-voltro-rendered-by": "loader-redirect"
+			},
+			body: ""
+		} : void 0;
+	}
+	if (t === "not-found") return {
+		status: 404,
+		headers: {
+			"content-type": "text/plain; charset=utf-8",
+			"x-voltro-rendered-by": "loader-not-found"
+		},
+		body: "not found"
+	};
+}, Or = (e) => {
 	let { helpers: t } = e, n = t.prepareDeferredLoaderData(e.loaderData, "page"), r = {}, i = {}, a = {};
 	for (let [n, o] of Object.entries(e.segmentLoaderData)) {
 		let e = Number(n), s = t.prepareDeferredLoaderData(o, e);
@@ -1571,8 +1596,8 @@ import {
 			...Object.keys(a).length > 0 ? { deferredSegmentIds: a } : {}
 		}
 	};
-}, Or = (e) => {
-	let { helpers: t, renderInput: n } = e, r = Dr({
+}, kr = (e) => {
+	let { helpers: t, renderInput: n } = e, r = Or({
 		helpers: t,
 		page: e.page,
 		pathname: n.pathname,
@@ -1593,37 +1618,37 @@ import {
 		stateScript: t.renderRouterStateScript(r.stateInput),
 		hasDeferred: r.hasDeferred
 	};
-}, kr = (e) => {
+}, Ar = (e) => {
 	let { html: t, meta: n } = e.helpers.renderPageToHtml(e.prepared.renderInput);
 	return {
 		body: t,
 		meta: n
 	};
-}, Ar = (e) => [
+}, jr = (e) => [
 	...e.extra ?? [],
 	e.helpers.renderMetaToHtml(e.meta),
 	`<meta name="voltro-interactive" content="${e.interactive}" />`,
 	...e.prepared.hasDeferred ? [e.helpers.renderDeferredRegistryScript()] : [],
 	e.prepared.stateScript
-].filter((e) => e.length > 0).join("\n    "), jr = "<div id=\"root\"></div>", Mr = "<div id=\"root\">", Nr = "</div>", Pr = /<script\b[^>]*\btype=["']module["'][^>]*><\/script>[ \t]*\n?/gi, Fr = /\bsrc=["']([^"']+)["']/i, Ir = /<script(?![^>]*\basync\b)([^>]*\btype=["']module["'][^>]*)>/gi, Lr = (e) => {
-	let t = e.keepScriptInHead ?? ((e) => e.startsWith("/@")), n = [], r = e.shell.replace(Pr, (e) => {
-		let r = Fr.exec(e)?.[1];
+].filter((e) => e.length > 0).join("\n    "), Mr = "<div id=\"root\"></div>", Nr = "<div id=\"root\">", Pr = "</div>", Fr = /<script\b[^>]*\btype=["']module["'][^>]*><\/script>[ \t]*\n?/gi, Ir = /\bsrc=["']([^"']+)["']/i, Lr = /<script(?![^>]*\basync\b)([^>]*\btype=["']module["'][^>]*)>/gi, Rr = (e) => {
+	let t = e.keepScriptInHead ?? ((e) => e.startsWith("/@")), n = [], r = e.shell.replace(Fr, (e) => {
+		let r = Ir.exec(e)?.[1];
 		return r === void 0 || t(r) ? e : (n.push(r), "");
 	});
-	e.inlineModuleScriptsAsync && (r = r.replace(Ir, "<script async$1>"));
-	let i = r.indexOf(jr);
-	if (i === -1) throw Error(`[voltro] the generated shell has no \`${jr}\` element, so a streamed response cannot be split around the page body. This is a framework bug unless the app overrode \`.framework/index.html\` by hand.`);
+	e.inlineModuleScriptsAsync && (r = r.replace(Lr, "<script async$1>"));
+	let i = r.indexOf(Mr);
+	if (i === -1) throw Error(`[voltro] the generated shell has no \`${Mr}\` element, so a streamed response cannot be split around the page body. This is a framework bug unless the app overrode \`.framework/index.html\` by hand.`);
 	return {
-		head: `${r.slice(0, i)}${Mr}`,
-		tail: `${Nr}${r.slice(i + 21)}`,
+		head: `${r.slice(0, i)}${Nr}`,
+		tail: `${Pr}${r.slice(i + 21)}`,
 		bootstrapModules: n
 	};
-}, Rr = (e) => e.head.replace("</head>", `    ${e.headInjection}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${e.htmlLang}"`), zr = (e) => {
+}, zr = (e) => e.head.replace("</head>", `    ${e.headInjection}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${e.htmlLang}"`), Br = (e) => {
 	let { res: t, shell: n, htmlLang: r, headInjection: i } = e, a = null, o = !1, s = !1, c = () => {
 		if (s || !o || a === null) return;
 		s = !0, t.statusCode = e.statusCode ?? 200;
 		for (let [n, r] of Object.entries(e.headers ?? {})) t.setHeader(n, r);
-		t.flushHeaders?.(), t.write(Rr({
+		t.flushHeaders?.(), t.write(zr({
 			head: n.head,
 			headInjection: i(a.meta),
 			htmlLang: r
@@ -1653,14 +1678,14 @@ import {
 		return;
 	}
 	c();
-}, X = T({ scope: "voltro:dev:web" }), Br = T({ scope: "vite" }), Vr = await (async () => {
+}, X = T({ scope: "voltro:dev:web" }), Vr = T({ scope: "vite" }), Hr = await (async () => {
 	try {
 		let e = f(u(h(import.meta.url)), "..", "package.json"), t = await A.readFile(e, "utf8");
 		return JSON.parse(t).version ?? "0.0.0";
 	} catch {
 		return "0.0.0";
 	}
-})(), Hr = async () => {
+})(), Ur = async () => {
 	try {
 		let e = u(h(import.meta.url)), t = m(e, "..", "..", "devtools");
 		if (O(f(t, "package.json"))) return t;
@@ -1669,7 +1694,7 @@ import {
 	} catch {
 		return null;
 	}
-}, Ur = (e, t) => e.disableDevtools || !t ? [] : [
+}, Wr = (e, t) => e.disableDevtools || !t ? [] : [
 	"",
 	"// Dev-only in-page devtools overlay. The `import.meta.env.DEV` guard is a",
 	"// compile-time constant, so prod builds strip this whole `if` block — the",
@@ -1679,12 +1704,12 @@ import {
 	"  await import('@voltro/devtools/styles.css')",
 	"  Devtools = (await import('@voltro/devtools')).VoltroDevtools",
 	"}"
-], Wr = (e, t) => e.disableDevtools || !t ? [] : ["  ...(Devtools ? { Devtools } : {}),"], Gr = (e) => e.sentry ? ["import { initSentryBrowser } from '@voltro/plugin-sentry/web'"] : [], Kr = (e) => e.sentry ? [
+], Gr = (e, t) => e.disableDevtools || !t ? [] : ["  ...(Devtools ? { Devtools } : {}),"], Kr = (e) => e.sentry ? ["import { initSentryBrowser } from '@voltro/plugin-sentry/web'"] : [], qr = (e) => e.sentry ? [
 	"",
 	"// Browser-side Sentry (frontend half of the deep integration). Errors +",
 	"// browser rpc spans flow to Sentry, sharing the server transactions' trace.",
 	`await initSentryBrowser(${JSON.stringify(e.sentry)})`
-] : [], qr = (e) => e.env ? ["import './env.public'"] : [], Jr = (e) => {
+] : [], Jr = (e) => e.env ? ["import './env.public'"] : [], Yr = (e) => {
 	let t = [], n = m(e);
 	for (;;) {
 		O(f(n, "pnpm-workspace.yaml")) && t.push(n);
@@ -1693,14 +1718,14 @@ import {
 		n = e;
 	}
 	return t;
-}, Yr = Nn, Xr = (e) => {
+}, Xr = Nn, Zr = (e) => {
 	if (/\/node_modules\/(?:\.pnpm\/[^/]+\/node_modules\/)?(?:react|react-dom|scheduler)\//.test(e)) return "react";
 	let t = /\/([^/]+)\.island\.tsx?$/.exec(e);
 	if (t) return `island-${t[1]}`;
-}, Zr = /export\s+(?:async\s+)?(?:const|function|let|var)\s+loader\b/, Qr = (e) => e.startsWith("(") && e.endsWith(")"), $r = (e) => e.filter((e) => !Qr(e)), ei = (e) => {
-	let n = e.replace(t, "").split("/").filter(Boolean).filter((e) => !Qr(e));
+}, Qr = /export\s+(?:async\s+)?(?:const|function|let|var)\s+loader\b/, $r = (e) => e.startsWith("(") && e.endsWith(")"), ei = (e) => e.filter((e) => !$r(e)), ti = (e) => {
+	let n = e.replace(t, "").split("/").filter(Boolean).filter((e) => !$r(e));
 	return n.length === 0 ? "/" : "/" + n.join("/");
-}, ti = (e) => `${e.replace(t, "").split("/").filter(Boolean).map((e) => e.replace(/[()]/g, "").replace(/\[\.\.\./g, "_rest_").replace(/[[\]]/g, "_")).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_") || "Index"}Page`, Z = (e, t) => e === "" ? `Root${t}` : `${e.split("/").filter(Boolean).map((e) => e.replace(/[()]/g, "").replace(/\[\.\.\./g, "_rest_").replace(/[[\]]/g, "_")).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_") || "Root"}${t}`, Q = async (n) => {
+}, ni = (e) => `${e.replace(t, "").split("/").filter(Boolean).map((e) => e.replace(/[()]/g, "").replace(/\[\.\.\./g, "_rest_").replace(/[[\]]/g, "_")).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_") || "Index"}Page`, Z = (e, t) => e === "" ? `Root${t}` : `${e.split("/").filter(Boolean).map((e) => e.replace(/[()]/g, "").replace(/\[\.\.\./g, "_rest_").replace(/[[\]]/g, "_")).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_") || "Root"}${t}`, Q = async (n) => {
 	let r = [], i = [], a = async (n, o) => {
 		let s = [];
 		try {
@@ -1708,17 +1733,17 @@ import {
 		} catch {
 			return;
 		}
-		let c = s.filter((e) => e.isDirectory()).map((e) => e.name).sort(), l = s.filter((e) => e.isFile() && e.name.endsWith(".tsx") && !Yr(e.name)).map((e) => e.name).sort(), u = new Set(l), d = o.join("/");
+		let c = s.filter((e) => e.isDirectory()).map((e) => e.name).sort(), l = s.filter((e) => e.isFile() && e.name.endsWith(".tsx") && !Xr(e.name)).map((e) => e.name).sort(), u = new Set(l), d = o.join("/");
 		if (l.some((t) => e.has(t))) {
 			let t = u.has("layout.tsx"), r = !1;
 			if (t) try {
 				let e = await A.readFile(f(n, "layout.tsx"), "utf8");
-				r = Zr.test(e);
+				r = Qr.test(e);
 			} catch {}
 			i.push({
 				dir: d,
 				chain: o,
-				contributesToUrl: o.length === 0 || !Qr(o[o.length - 1]),
+				contributesToUrl: o.length === 0 || !$r(o[o.length - 1]),
 				hasLayout: t,
 				hasLayoutLoader: r,
 				hasError: u.has("error.tsx"),
@@ -1732,8 +1757,8 @@ import {
 			let n = d ? `${d}/${e}` : e;
 			r.push({
 				file: n,
-				pattern: ei(n),
-				ident: ti(n),
+				pattern: ti(n),
+				ident: ni(n),
 				dirChain: o
 			});
 		}
@@ -1752,14 +1777,14 @@ import {
 		dirs: s,
 		orphanedSpecials: c
 	};
-}, ni = (e, t) => {
+}, ri = (e, t) => {
 	let n = [];
 	for (let r = 0; r <= t.length; r++) {
 		let i = t.slice(0, r).join("/"), a = e.find((e) => e.dir === i);
 		a && n.push(a);
 	}
 	return n;
-}, ri = async (e) => {
+}, ii = async (e) => {
 	let { entries: t, loadLayout: n, loadError: r, loadPending: i, ctx: a } = e, o = {};
 	return {
 		chain: await Promise.all(t.map(async (e, t) => {
@@ -1781,10 +1806,10 @@ import {
 		})),
 		segmentLoaderData: o
 	};
-}, ii = (e) => {
-	let t = $r(e);
+}, ai = (e) => {
+	let t = ei(e);
 	return t.length === 0 ? "" : "/" + t.join("/");
-}, ai = [
+}, oi = [
 	"// Hot-reload bridge: keep SSR-injected <link rel=\"stylesheet\"> tags",
 	"// in sync with Vite's CSS HMR. Without this, edits to .css files",
 	"// only update the JS-injected <style> overlay; the underlying <link>",
@@ -1877,7 +1902,7 @@ import {
 	"    _vdtErrorStart('Build error')",
 	"  })",
 	"}"
-].join("\n"), oi = (e) => {
+].join("\n"), si = (e) => {
 	let t = [], n = 0, r = e.split("/").filter(Boolean), i = [];
 	for (let e of r) e.startsWith("[[...") && e.endsWith("]]") ? (i.push("(.*)"), t.push(e.slice(5, -2)), n += 2) : e.startsWith("[...") && e.endsWith("]") ? (i.push("(.+)"), t.push(e.slice(4, -1)), n += 3) : e.startsWith("[") && e.endsWith("]") ? (i.push("([^/]+)"), t.push(e.slice(1, -1)), n += 1) : i.push(e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
 	let a = i.join("/");
@@ -1886,8 +1911,8 @@ import {
 		paramNames: t,
 		priority: n
 	};
-}, si = (e) => e.map((e) => {
-	let { regex: t, paramNames: n, priority: r } = oi(e.pattern);
+}, ci = (e) => e.map((e) => {
+	let { regex: t, paramNames: n, priority: r } = si(e.pattern);
 	return {
 		pattern: e.pattern,
 		file: e.file,
@@ -1896,7 +1921,7 @@ import {
 		paramNames: n,
 		priority: r
 	};
-}).slice().sort((e, t) => e.priority - t.priority), ci = (e, t) => {
+}).slice().sort((e, t) => e.priority - t.priority), li = (e, t) => {
 	for (let n of t) {
 		let t = n.regex.exec(e);
 		if (!t) continue;
@@ -1908,7 +1933,7 @@ import {
 		};
 	}
 	return null;
-}, li = async (e, t) => {
+}, ui = async (e, t) => {
 	let n = e;
 	for (;;) {
 		let e = f(n, "node_modules", t);
@@ -1922,7 +1947,7 @@ import {
 		if (r === n) return null;
 		n = r;
 	}
-}, ui = async (e) => {
+}, di = async (e) => {
 	try {
 		let t = await import(g(f(e, "app.config.ts")).href), n = t.default?.port, r = typeof n == "number" ? n : 4e3, i = t.default?.transport?.wsPath, a = typeof i == "string" && i.startsWith("/") ? i : void 0;
 		return a ? {
@@ -1931,7 +1956,7 @@ import {
 		} : { port: r };
 	} catch {}
 	return { port: 4e3 };
-}, di = (e, t) => ({
+}, fi = (e, t) => ({
 	name: e,
 	pkg: t.package,
 	browserWsUrl: t.url,
@@ -1939,7 +1964,7 @@ import {
 	...t.serverUrl ? { serverOrigin: t.serverUrl } : {},
 	...t.headers ? { headers: t.headers } : {},
 	...t.authHeaders ? { hasAuthHeaders: !0 } : {}
-}), fi = (e, t, n) => {
+}), pi = (e, t, n) => {
 	let r = t.transport?.wsPath ?? n.wsPath;
 	return {
 		name: e,
@@ -1951,7 +1976,7 @@ import {
 		...t.headers ? { headers: t.headers } : {},
 		...t.authHeaders ? { hasAuthHeaders: !0 } : {}
 	};
-}, pi = (e) => {
+}, mi = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		if (n.proxyTarget === void 0) continue;
@@ -1959,43 +1984,43 @@ import {
 		if (e) throw Error(`[voltro] api ${JSON.stringify(n.name)} and ${JSON.stringify(e)} both resolve the same-origin WS path ${JSON.stringify(n.browserWsUrl)}. A custom transport.wsPath must be unique per origin (one api per origin may use a fixed path). Give each a distinct wsPath, or drop the override to use the default /ws/<name>.`);
 		t.set(n.browserWsUrl, n.name);
 	}
-}, mi = async (e, t) => {
+}, hi = async (e, t) => {
 	let n = Object.entries(t.apis ?? {}), r = [];
 	for (let [t, i] of n) {
 		if (i.url) {
-			r.push(di(t, i));
+			r.push(fi(t, i));
 			continue;
 		}
-		let n = await li(e, i.package);
+		let n = await ui(e, i.package);
 		if (!n) throw Error(`[voltro dev] api ${JSON.stringify(t)} (package ${JSON.stringify(i.package)}) is not a workspace dep and has no \`url\` set in app.config.ts. External apis need an explicit \`url\` because the framework can't discover their dev port.`);
-		r.push(fi(t, i, await ui(n)));
+		r.push(pi(t, i, await di(n)));
 	}
-	return pi(r), r;
-}, hi = (e) => {
+	return mi(r), r;
+}, gi = (e) => {
 	if (!(!/^wss?:\/\//.test(e) && !/^https?:\/\//.test(e))) try {
 		let t = new URL(e);
 		return t.protocol = t.protocol === "wss:" || t.protocol === "https:" ? "https:" : "http:", `${t.protocol}//${t.host}`;
 	} catch {
 		return;
 	}
-}, gi = (e) => `VOLTRO_API_ORIGIN_${e.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`, _i = (e) => process.env[gi(e)] ?? process.env.VOLTRO_API_ORIGIN, vi = (e, t) => {
+}, _i = (e) => `VOLTRO_API_ORIGIN_${e.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`, vi = (e) => process.env[_i(e)] ?? process.env.VOLTRO_API_ORIGIN, yi = (e, t) => {
 	if (!e) return;
-	let n = _i(e.name) ?? e.serverOrigin;
+	let n = vi(e.name) ?? e.serverOrigin;
 	if (n) {
-		let e = hi(n);
+		let e = gi(n);
 		if (e) return e;
 	}
 	if (t?.allowDevProxy && e.proxyTarget) {
-		let t = hi(e.proxyTarget);
+		let t = gi(e.proxyTarget);
 		if (t) return t;
 	}
-	if (!e.proxyTarget && /^wss?:\/\//.test(e.browserWsUrl)) return hi(e.browserWsUrl);
-}, yi = (e, t, n) => {
+	if (!e.proxyTarget && /^wss?:\/\//.test(e.browserWsUrl)) return gi(e.browserWsUrl);
+}, bi = (e, t, n) => {
 	if (!e) {
 		if (n?.apiName === void 0) return;
 		let e = n.apiName;
 		return async () => {
-			throw Error(`[loader.query] api '${e}' has no server-side origin for SSR. In a split web/api deployment the web pod reaches the api by internal DNS, not the browser's relative wsPath — set ${gi(e)} (or VOLTRO_API_ORIGIN, or apis.${e}.serverUrl in app.config.ts) to the api's internal origin, e.g. http://api.<namespace>.svc.cluster.local. The browser transport is unaffected.`);
+			throw Error(`[loader.query] api '${e}' has no server-side origin for SSR. In a split web/api deployment the web pod reaches the api by internal DNS, not the browser's relative wsPath — set ${_i(e)} (or VOLTRO_API_ORIGIN, or apis.${e}.serverUrl in app.config.ts) to the api's internal origin, e.g. http://api.<namespace>.svc.cluster.local. The browser transport is unaffected.`);
 		};
 	}
 	return async (r, i) => {
@@ -2017,7 +2042,7 @@ import {
 			});
 		} catch (t) {
 			let i = t?.cause?.code ?? String(t?.message ?? t);
-			throw Error(`[loader.query] ${r}: could not reach the api at ${e}/rpc (${i}). ${n?.apiName ? `Set ${gi(n.apiName)} / VOLTRO_API_ORIGIN` : "Set the api server origin"} to the api's SSR-reachable origin (internal cluster DNS in a split deployment).`, { cause: t });
+			throw Error(`[loader.query] ${r}: could not reach the api at ${e}/rpc (${i}). ${n?.apiName ? `Set ${_i(n.apiName)} / VOLTRO_API_ORIGIN` : "Set the api server origin"} to the api's SSR-reachable origin (internal cluster DNS in a split deployment).`, { cause: t });
 		}
 		if (!o.ok) throw Error(`[loader.query] ${r}: HTTP ${o.status} ${await o.text()}`);
 		let s = await o.json();
@@ -2036,7 +2061,7 @@ import {
 		if (u) return l;
 	};
 }, $ = async (e, t, n, r = {}) => {
-	let i = t.title ?? t.name ?? "app", a = t.theme === "dark" ? " class=\"dark\"" : t.theme === "light" ? " class=\"light\"" : "", o = O(f(e, "node_modules", "@voltro", "devtools", "package.json")) || await Hr() !== null, s = t.theme === "system" ? [
+	let i = t.title ?? t.name ?? "app", a = t.theme === "dark" ? " class=\"dark\"" : t.theme === "light" ? " class=\"light\"" : "", o = O(f(e, "node_modules", "@voltro", "devtools", "package.json")) || await Ur() !== null, s = t.theme === "system" ? [
 		"    <script>",
 		"      (function () {",
 		"        var root = document.documentElement",
@@ -2090,13 +2115,13 @@ import {
 			e.hasLayout && e.hasLayoutLoader ? n.push(`import * as ${Z(e.dir, "Layout")}Mod from '${t}/layout.tsx'`) : e.hasLayout && n.push(`import ${Z(e.dir, "Layout")}   from '${t}/layout.tsx'`), e.hasError && n.push(`import ${Z(e.dir, "Error")}    from '${t}/error.tsx'`), e.hasPending && n.push(`import ${Z(e.dir, "Pending")}  from '${t}/loading.tsx'`), e.hasNotFound && n.push(`import ${Z(e.dir, "NotFound")} from '${t}/not-found.tsx'`);
 		}
 		let r = u.map((e) => {
-			let t = ni(d, e.dirChain).map((e) => {
+			let t = ri(d, e.dirChain).map((e) => {
 				let t = [`id: ${JSON.stringify(e.dir || "/")}`], n = JSON.stringify(e.dir);
 				return e.hasLayout && t.push(`Layout:  refs.layouts[${n}]`), e.hasLayoutLoader && t.push(`loader:  refs.layoutLoaders[${n}]`), e.hasError && t.push(`Error:   refs.errors[${n}]`), e.hasPending && t.push(`Pending: refs.pendings[${n}]`), `      { ${t.join(", ")} }`;
 			}).join(",\n");
 			return `    makePageRoute(${JSON.stringify(e.pattern)}, ${t.length > 0 ? `[\n${t},\n    ]` : "undefined"}),`;
 		}), i = d.filter((e) => e.hasNotFound).map((e) => {
-			let t = ii(e.chain), n = ni(d, e.chain).map((e) => {
+			let t = ai(e.chain), n = ri(d, e.chain).map((e) => {
 				let t = [`id: ${JSON.stringify(e.dir || "/")}`], n = JSON.stringify(e.dir);
 				return e.hasLayout && t.push(`Layout: refs.layouts[${n}]`), e.hasError && t.push(`Error:  refs.errors[${n}]`), `        { ${t.join(", ")} }`;
 			}).join(",\n"), r = n.length > 0 ? `\n      chain: [\n${n},\n      ],` : "";
@@ -2335,14 +2360,14 @@ import {
 			"// resolved apis map. Side-effect only — no local component definitions —",
 			"// so downstream invalidations (user page edits) terminate at app.tsx.",
 			"",
-			...qr(t),
+			...Jr(t),
 			"import { mount } from '@voltro/web'",
 			...g,
 			"import { App } from './app'",
 			"import { preloadCurrentRoute } from './routeTable'",
-			...Gr(t),
-			...Ur(t, o),
 			...Kr(t),
+			...Wr(t, o),
+			...qr(t),
 			"",
 			"// Preload the current route's page chunk BEFORE hydration so the first",
 			"// client render matches the SSG/SSR-prerendered HTML. Without it, a lazy",
@@ -2359,10 +2384,10 @@ import {
 			"  apis: {",
 			..._,
 			"  },",
-			...Wr(t, o),
+			...Gr(t, o),
 			"})",
 			"",
-			ai
+			oi
 		].join("\n");
 	} else v = "", y = "", b = [
 		"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
@@ -2370,22 +2395,22 @@ import {
 		"// and calls mount(). Side-effect only, no component definitions, so the",
 		"// user's component file remains the Fast Refresh boundary.",
 		"",
-		...qr(t),
+		...Jr(t),
 		"import { mount } from '@voltro/web'",
 		...g,
 		"import App from '../src/App'",
-		...Gr(t),
-		...Ur(t, o),
 		...Kr(t),
+		...Wr(t, o),
+		...qr(t),
 		"",
 		"mount(App, {",
 		"  apis: {",
 		..._,
 		"  },",
-		...Wr(t, o),
+		...Gr(t, o),
 		"})",
 		"",
-		ai
+		oi
 	].join("\n");
 	let x = f(e, ".framework");
 	await A.mkdir(x, { recursive: !0 }), t.env ? await ht(x, r) : await A.rm(f(x, "env.public.ts"), { force: !0 }), await A.writeFile(f(x, "index.html"), c, "utf8"), await A.writeFile(f(x, "main.tsx"), b, "utf8"), v ? (await A.writeFile(f(x, "app.tsx"), v, "utf8"), await A.writeFile(f(x, "routeTable.ts"), y, "utf8")) : (await A.rm(f(x, "app.tsx"), { force: !0 }), await A.rm(f(x, "routeTable.ts"), { force: !0 }));
@@ -2402,7 +2427,7 @@ import {
 			X.warn(`could not add ${E.join(", ")} to ${S} — add it by hand so the generated directory stays out of git. The build is unaffected.`, { reason: e?.message ?? String(e) });
 		}
 	}
-}, bi = async (e, t) => {
+}, xi = async (e, t) => {
 	try {
 		let n = f(u(e), "project.json");
 		if (!O(n)) return;
@@ -2415,16 +2440,16 @@ import {
 			projectJson: n
 		});
 	} catch {}
-}, xi = (e) => f(e, ".framework", "dist", "server", "appConfig.js"), Si = async (e) => {
-	let t = xi(e), n = O(t) ? t : f(e, "app.config.ts");
+}, Si = (e) => f(e, ".framework", "dist", "server", "appConfig.js"), Ci = async (e) => {
+	let t = Si(e), n = O(t) ? t : f(e, "app.config.ts");
 	try {
 		let e = (await import(g(n).href)).default;
 		return typeof e == "object" && e && "type" in e && e.type === "web" ? e : null;
 	} catch {
 		return null;
 	}
-}, Ci = async (e) => {
-	let t = await Si(e);
+}, wi = async (e) => {
+	let t = await Ci(e);
 	if (!t) return {
 		ran: !1,
 		exitCode: 0
@@ -2432,7 +2457,7 @@ import {
 	An();
 	let n = Qt();
 	ln(n), X.info("booting voltro dev (web)", { app: t.name ?? "(unnamed)" });
-	let u = await mi(e, t);
+	let u = await hi(e, t);
 	for (let e of u) X.info("api wired", {
 		name: e.name,
 		pkg: e.pkg,
@@ -2465,10 +2490,10 @@ import {
 		pid: process.pid,
 		status: "booting",
 		logFile: y.path
-	}).catch(() => {}), await bi(e, g);
+	}).catch(() => {}), await xi(e, g);
 	let { pages: b, dirs: x } = await Q(f(e, "src", "pages")), S = {
 		dirs: x,
-		ssrRoutes: si(b)
+		ssrRoutes: ci(b)
 	}, C = x.map((e) => ({
 		dir: e.dir,
 		hasLayout: e.hasLayout,
@@ -2504,7 +2529,7 @@ import {
 					...r.devDependencies
 				});
 				await Promise.all(i.map(async (n) => {
-					let r = await li(e, n);
+					let r = await ui(e, n);
 					if (!r) return;
 					let i = f(r, "src");
 					try {
@@ -2521,7 +2546,7 @@ import {
 			await Xt({
 				appRoot: e,
 				pages: i
-			}), S.dirs = a, S.ssrRoutes = si(i), X.info("page tree regenerated", {
+			}), S.dirs = a, S.ssrRoutes = ci(i), X.info("page tree regenerated", {
 				reason: n,
 				ms: Date.now() - r,
 				routes: S.ssrRoutes.length
@@ -2611,7 +2636,7 @@ import {
 				}
 				try {
 					let n = Date.now();
-					await $(e, r, await mi(e, r)), ae = r, t.ws && t.ws.send({
+					await $(e, r, await hi(e, r)), ae = r, t.ws && t.ws.send({
 						type: "full-reload",
 						path: "*"
 					}), X.info("app.config.ts soft-regen", {
@@ -2651,7 +2676,7 @@ import {
 			let n = /* @__PURE__ */ new Map();
 			for (let r of u) {
 				if (!r.proxyTarget) continue;
-				let i = await li(e, r.pkg);
+				let i = await ui(e, r.pkg);
 				if (!i) continue;
 				let a = f(i, "rpcGroup.generated.ts");
 				try {
@@ -2699,6 +2724,7 @@ import {
 			On(t, n, {
 				target: e,
 				token: process.env.VOLTRO_INSPECT_TOKEN,
+				writeToken: process.env.VOLTRO_INSPECT_WRITE_TOKEN,
 				isLoopback: r
 			});
 		});
@@ -2900,7 +2926,7 @@ import {
 						r.end(JSON.stringify({ error: "inspect disabled (VOLTRO_INSPECT=off)" }));
 						return;
 					}
-					let a = o(u);
+					let a = o(u, "GET");
 					if (!a.ok) {
 						r.statusCode = 401, r.setHeader("content-type", "application/json");
 						for (let [e, n] of Object.entries(t)) r.setHeader(e, n);
@@ -2934,7 +2960,7 @@ import {
 						kind: "web",
 						meta: {
 							name: t.name ?? "(unnamed)",
-							voltroVersion: Vr,
+							voltroVersion: Hr,
 							port: g,
 							mode: "dev",
 							apis: Object.entries(t.apis ?? {}).map(([e, t]) => {
@@ -3008,7 +3034,7 @@ import {
 				if (r.method !== "GET" && r.method !== "HEAD") return a();
 				let o = r.url ?? "/", s = o.indexOf("?"), c = (s === -1 ? o : o.slice(0, s)) || "/";
 				if (c.startsWith("/@") || c.startsWith("/node_modules/") || c.startsWith("/.framework/") || c.startsWith("/_voltro/") || c === "/main.tsx" || c === "/index.html" || c === "/sw.js" || c === "/favicon.ico" || c === "/robots.txt" || /\.[a-z0-9]+$/i.test(c)) return a();
-				let l = ci(c, S.ssrRoutes);
+				let l = li(c, S.ssrRoutes);
 				if (!l) return a();
 				let d = !he.has(l.route.pattern), p = Date.now();
 				d && X.info(`ssr compiling ${l.route.pattern}`, {
@@ -3030,15 +3056,15 @@ import {
 					}
 				};
 				try {
-					let s = await h("loadPage", async () => await n(f(e, "src", "pages", l.route.file))), _ = Yn(s, f("src", "pages", l.route.file)), v = ni(S.dirs, l.route.dirChain), y = _ === "spa" && v.some((e) => e.hasLayout);
+					let s = await h("loadPage", async () => await n(f(e, "src", "pages", l.route.file))), _ = Yn(s, f("src", "pages", l.route.file)), v = ri(S.dirs, l.route.dirChain), y = _ === "spa" && v.some((e) => e.hasLayout);
 					if (_ !== "ssr" && _ !== "isr" && !y) return a();
 					let b = {};
 					for (let [e, t] of Object.entries(r.headers ?? {})) typeof t == "string" ? b[e] = t : Array.isArray(t) && (b[e] = t.join(", "));
-					let x = yi(vi(u[0], { allowDevProxy: !0 }), b.cookie, { apiName: u[0]?.name }), C = new AbortController(), w = () => C.abort();
+					let x = bi(yi(u[0], { allowDevProxy: !0 }), b.cookie, { apiName: u[0]?.name }), C = new AbortController(), w = () => C.abort();
 					i.once("close", w);
 					let T = null, E = [], D = {};
 					try {
-						(await n("@voltro/web/ssr")).beginStoreSeeds(), {chain: E, segmentLoaderData: D} = await h("loadChain", () => ri({
+						(await n("@voltro/web/ssr")).beginStoreSeeds(), {chain: E, segmentLoaderData: D} = await h("loadChain", () => ii({
 							entries: v,
 							loadLayout: (t) => n(f(e, "src", "pages", t.dir, "layout.tsx")),
 							loadError: (t) => n(f(e, "src", "pages", t.dir, "error.tsx")),
@@ -3075,7 +3101,7 @@ import {
 						cookies: O.parseCookieHeader(b.cookie),
 						headers: b,
 						url: o
-					}, A = s.interactive ?? "full", j = y ? Or({
+					}, A = s.interactive ?? "full", j = y ? kr({
 						helpers: O,
 						page: `src/pages/${l.route.file}`,
 						interactive: A,
@@ -3087,7 +3113,7 @@ import {
 							segmentLoaderData: D,
 							requestContext: k
 						}
-					}) : null, M = y ? null : Dr({
+					}) : null, M = y ? null : Or({
 						helpers: O,
 						page: `src/pages/${l.route.file}`,
 						pathname: c,
@@ -3111,16 +3137,16 @@ import {
 					});
 					let P = await h("readShell", xe), F = await h("transformShell", () => t.transformIndexHtml(o, P)), te = N.map((e) => `<link rel="stylesheet" href="${e}?direct" />`).join("\n    "), I = k.cookies["voltro:locale"] ?? "en", ne = Date.now();
 					if (j) {
-						let e = (e) => Ar({
+						let e = (e) => jr({
 							helpers: O,
 							prepared: j,
 							meta: e,
 							interactive: A,
 							extra: [te]
 						});
-						if (j.hasDeferred) zr({
+						if (j.hasDeferred) Br({
 							res: i,
-							shell: Lr({
+							shell: Rr({
 								shell: F,
 								inlineModuleScriptsAsync: !0
 							}),
@@ -3139,7 +3165,7 @@ import {
 							}
 						});
 						else {
-							let t = kr({
+							let t = Ar({
 								helpers: O,
 								prepared: j
 							}), n = F.replace("<div id=\"root\"></div>", `<div id="root">${t.body}</div>`).replace("</head>", `    ${e(t.meta)}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${I}"`);
@@ -3160,9 +3186,9 @@ import {
 							segmentLoaderData: M.segmentLoaderData,
 							requestContext: k
 						};
-						if (_ === "ssr" && A === "full") zr({
+						if (_ === "ssr" && A === "full") Br({
 							res: i,
-							shell: Lr({
+							shell: Rr({
 								shell: F,
 								inlineModuleScriptsAsync: !0
 							}),
@@ -3208,15 +3234,22 @@ import {
 						}, e), i.statusCode = 500, i.setHeader("content-type", "text/plain; charset=utf-8"), i.end(e.message);
 						return;
 					}
+					let t = Dr(e);
+					if (t) {
+						i.statusCode = t.status;
+						for (let [e, n] of Object.entries(t.headers)) i.setHeader(e, String(n));
+						i.end(t.body);
+						return;
+					}
 					ge(i, "ssr-dev", c, l.route.pattern, e);
 				}
 			});
 		}
-	}, B = Date.now(), Ce = T.version ?? "?", V = await Hr(), we = f(e, "node_modules", "@voltro", "ui-shadcn"), H = O(f(we, "package.json")) ? we : null, Te = [], Ee = await (async () => {
+	}, B = Date.now(), Ce = T.version ?? "?", V = await Ur(), we = f(e, "node_modules", "@voltro", "ui-shadcn"), H = O(f(we, "package.json")) ? we : null, Te = [], Ee = await (async () => {
 		let t = [];
 		for (let n of u) {
 			if (!n.proxyTarget) continue;
-			let r = await li(e, n.pkg);
+			let r = await ui(e, n.pkg);
 			if (r) try {
 				t.push(await A.readFile(f(r, "rpcGroup.generated.ts"), "utf8"));
 			} catch {}
@@ -3291,12 +3324,12 @@ import {
 			host: !0,
 			allowedHosts: t.allowedHosts === !0 || [...t.allowedHosts ?? []],
 			proxy: R,
-			fs: { allow: [e, ...Jr(e)] }
+			fs: { allow: [e, ...Yr(e)] }
 		},
 		appType: "spa",
 		cacheDir: f(k, ".vite"),
 		publicDir: f(e, "public")
-	})).listen(), Br.info(`v${Ce} ready in ${Date.now() - B}ms`, {
+	})).listen(), Vr.info(`v${Ce} ready in ${Date.now() - B}ms`, {
 		version: Ce,
 		bootMs: Date.now() - B
 	}), X.info(`listening on http://localhost:${g}`, {
@@ -3346,16 +3379,16 @@ import {
 		url: `http://localhost:${g}`,
 		bootMs: Date.now() - B
 	}), new Promise(() => {});
-}, wi = async (e) => {
+}, Ti = async (e) => {
 	process.env.NODE_ENV || (process.env.NODE_ENV = "production");
-	let t = await Si(e);
+	let t = await Ci(e);
 	if (!t) return {
 		ran: !1,
 		exitCode: 0
 	};
 	let n = Date.now(), r = X.child("serve");
 	r.info("booting voltro serve (preview)", { app: t.name ?? "(unnamed)" });
-	let i = await mi(e, t);
+	let i = await hi(e, t);
 	for (let e of i) r.info("api wired", {
 		name: e.name,
 		pkg: e.pkg
@@ -3377,7 +3410,7 @@ import {
 		resolve: { dedupe: ["react", "react-dom"] },
 		build: {
 			outDir: "dist",
-			rollupOptions: { output: { manualChunks: Xr } }
+			rollupOptions: { output: { manualChunks: Zr } }
 		},
 		publicDir: f(e, "public")
 	});
@@ -3397,14 +3430,14 @@ import {
 		extras: d,
 		bootMs: Date.now() - n
 	}), new Promise(() => {});
-}, Ti = 5e3, Ei = 6e4, Di = (e, t) => {
+}, Ei = 5e3, Di = 6e4, Oi = (e, t) => {
 	if (e.length === 0) return 0;
 	if (e.length === 1) return e[0];
 	let n = t * (e.length - 1), r = Math.floor(n), i = Math.ceil(n);
 	if (r === i) return e[r];
 	let a = n - r;
 	return e[r] * (1 - a) + e[i] * a;
-}, Oi = (e) => {
+}, ki = (e) => {
 	if (e.length === 0) return {
 		p50: 0,
 		p95: 0,
@@ -3416,15 +3449,15 @@ import {
 	let t = e.slice().sort((e, t) => e - t), n = 0;
 	for (let e of t) n += e;
 	return {
-		p50: Di(t, .5),
-		p95: Di(t, .95),
-		p99: Di(t, .99),
+		p50: Oi(t, .5),
+		p95: Oi(t, .95),
+		p99: Oi(t, .99),
 		mean: n / t.length,
 		min: t[0],
 		max: t[t.length - 1]
 	};
-}, ki = (e = {}) => {
-	let t = e.maxSamples ?? Ti, n = e.defaultWindowMs ?? Ei, r = [];
+}, Ai = (e = {}) => {
+	let t = e.maxSamples ?? Ei, n = e.defaultWindowMs ?? Di, r = [];
 	return {
 		record(e) {
 			L(e), r.push({
@@ -3453,7 +3486,7 @@ import {
 					tag: e.tag,
 					count: e.samples.length,
 					errorCount: n,
-					latencyMs: Oi(t)
+					latencyMs: ki(t)
 				});
 			}
 			return c.sort((e, t) => t.count - e.count), {
@@ -3466,4 +3499,4 @@ import {
 	};
 };
 //#endregion
-export { St as $, Wn as A, gn as B, wr as C, dr as D, ur as E, Nn as F, en as G, sn as H, Pn as I, Rt as J, Xt as K, Dn as L, Gn as M, qn as N, Qn as O, Yn as P, xt as Q, Sn as R, mr as S, lr as T, $t as U, ln as V, Qt as W, Dt as X, kt as Y, Et as Z, Dr as _, we as _t, ri as a, gt as at, Ar as b, mi as c, lt as ct, Xr as d, nt as dt, Ct as et, Q as f, it as ft, Er as g, V as gt, zr as h, Ke as ht, yi as i, yt as it, Xn as j, er as k, Ci as l, st as lt, Lr as m, Ge as mt, Zr as n, G as nt, ni as o, mt as ot, $ as p, rt as pt, Bt as q, vi as r, vt as rt, Si as s, pt as st, ki as t, bt as tt, wi as u, at as ut, Or as v, hr as w, gr as x, kr as y, vn as z };
+export { St as $, Wn as A, gn as B, wr as C, dr as D, ur as E, Nn as F, en as G, sn as H, Pn as I, Rt as J, Xt as K, Dn as L, Gn as M, qn as N, Qn as O, Yn as P, xt as Q, Sn as R, mr as S, lr as T, $t as U, ln as V, Qt as W, Dt as X, kt as Y, Et as Z, Or as _, we as _t, ii as a, gt as at, jr as b, hi as c, lt as ct, Zr as d, nt as dt, Ct as et, Q as f, it as ft, Er as g, V as gt, Br as h, Ke as ht, bi as i, yt as it, Xn as j, er as k, wi as l, st as lt, Rr as m, Ge as mt, Qr as n, G as nt, ri as o, mt as ot, $ as p, rt as pt, Bt as q, yi as r, vt as rt, Ci as s, pt as st, Ai as t, bt as tt, Ti as u, at as ut, kr as v, hr as w, gr as x, Ar as y, vn as z };