@voltro/cli 0.59.0 → 0.61.0

package/dist/{start-DNtIlBcn.js → start-bqT4GRH0.js}

@@ -1,5 +1,5 @@
 import { i as e, t } from "./nodeEnvironment-cGFAj1J8.js";
-import { $ as n, $t as r, A as i, B as a, D as o, E as s, Et as c, F as l, Ft as u, G as d, H as ee, I as f, It as p, J as m, K as te, L as h, Lt as g, M as _, N as v, O as y, P as b, Pt as x, Q as ne, Qt as S, R as C, Rt as w, T as re, U as ie, W as ae, X as T, Y as E, Yt as oe, Z as se, a as ce, bt as le, c as D, en as ue, et as de, ft as fe, h as O, it as pe, j as me, jt as k, k as he, lt as A, m as j, mt as ge, n as _e, nt as ve, ot as ye, q as M, rt as be, s as xe, st as Se, tn as Ce, tt as N, u as we, xt as Te, z as P } from "./webDev-CBN9KkyQ.js";
+import { $ as n, $t as r, A as i, B as a, D as o, E as s, Et as c, F as l, Ft as u, G as d, H as ee, I as f, It as p, J as m, K as te, L as h, Lt as g, M as _, N as v, O as y, P as b, Pt as x, Q as S, Qt as C, R as ne, Rt as w, T as re, U as ie, W as ae, X as T, Y as E, Yt as oe, Z as se, a as ce, bt as le, c as D, en as ue, et as de, ft as fe, h as O, it as pe, j as me, jt as k, k as he, lt as A, m as j, mt as ge, n as _e, nt as ve, ot as ye, q as M, rt as be, s as xe, st as Se, tn as Ce, tt as N, u as we, xt as Te, z as P } from "./webDev-CYjhmOTZ.js";
 import { A as F, I as Ee, M as De, O as Oe, g as ke, j as Ae, o as je } from "./inspect-PcC5J-Dl.js";
 import { r as Me } from "./appPort-B_HpJ_ck.js";
 import { o as Ne, t as Pe } from "./connectionConfig-Bk9IC7D0.js";
@@ -16,13 +16,14 @@ import { createLogger as H, printReadyBlock as et } from "@voltro/logger";
 import { appMode as tt, frameworkVersion as nt, setProcessBootPath as rt } from "@voltro/protocol/identity";
 import { applyKeepAlive as it, maybeCompress as U, negotiateEncoding as at, resolveKeepAlive as ot, snapshotMetricsSync as st } from "@voltro/runtime";
 import { Effect as ct } from "effect";
-import { createHash as W } from "node:crypto";
-import { resolveBroadcastProvider as lt } from "@voltro/plugin-broadcast";
-import { createServer as ut } from "node:http";
+import { createRequire as W } from "node:module";
+import { createHash as lt } from "node:crypto";
+import { resolveBroadcastProvider as ut } from "@voltro/plugin-broadcast";
+import { createServer as dt } from "node:http";
 //#region src/inertPublicEnv.ts
-var dt = "VOLTRO_PUBLIC_", ft = (e, t) => {
+var ft = "VOLTRO_PUBLIC_", pt = (e, t) => {
 	let n = [];
-	for (let [r, i] of Object.entries(e)) if (r.startsWith(dt) && i !== void 0 && i !== "") {
+	for (let [r, i] of Object.entries(e)) if (r.startsWith(ft) && i !== void 0 && i !== "") {
 		if (t === void 0 || !(r in t)) {
 			n.push({
 				key: r,
@@ -36,15 +37,15 @@ var dt = "VOLTRO_PUBLIC_", ft = (e, t) => {
 		});
 	}
 	return n.sort((e, t) => e.key.localeCompare(t.key));
-}, pt = (e) => {
+}, mt = (e) => {
 	let t = e.map((e) => e.baked === "absent" ? `  • ${e.key} — not in the bundle at all` : `  • ${e.key} — the bundle carries a DIFFERENT value; the built one wins`);
 	return `${e.length} VOLTRO_PUBLIC_* variable${e.length === 1 ? "" : "s"} set in this process's environment cannot reach the browser:\n${t.join("\n")}\n  Public values are BAKED into the bundle by \`voltro build\` — that is what makes them
   readable in a browser — so they must exist when the bundle is BUILT, not when it runs.
   → pass them to the build (a Docker build-arg / CI build step), not as deployment env.`;
-}, mt = (e) => `W/"${W("md5").update(e).digest("hex")}"`, ht = (e) => {
+}, ht = (e) => `W/"${lt("md5").update(e).digest("hex")}"`, gt = (e) => {
 	let { response: t, status: n, headers: r, body: i, requestHeaders: a } = e, o = r["cache-control"], s = (typeof o == "string" ? o : "").toLowerCase();
 	if (i === void 0 || n !== 200 || s.includes("no-store")) return !1;
-	let c = r["content-type"], l = typeof c == "string" ? c : void 0, u = r.etag, d = typeof u == "string" ? u : mt(i), ee = a["if-none-match"];
+	let c = r["content-type"], l = typeof c == "string" ? c : void 0, u = r.etag, d = typeof u == "string" ? u : ht(i), ee = a["if-none-match"];
 	if (ee !== void 0 && ee.split(",").some((e) => e.trim() === d)) return t.writeHead(304, {
 		...r,
 		etag: d
@@ -64,7 +65,7 @@ var dt = "VOLTRO_PUBLIC_", ft = (e, t) => {
 		etag: d
 	};
 	return f.compressed && delete p["content-length"], t.writeHead(n, p), t.end(Buffer.from(f.bytes)), !0;
-}, G = H({ scope: "voltro:start:cdc" }), gt = (e) => (t) => {
+}, G = H({ scope: "voltro:start:cdc" }), _t = (e) => (t) => {
 	let n = 0;
 	for (let [r, i] of e.tableSubscriptionsByPattern) {
 		if (!i.includes(t)) continue;
@@ -75,13 +76,13 @@ var dt = "VOLTRO_PUBLIC_", ft = (e, t) => {
 		}));
 	}
 	return n;
-}, K = () => Pe() ? Ne() : null, _t = (e) => {
-	let t = e.channel ?? "framework_changes", n = e.revalidateChannel ?? "voltro_revalidate", r = gt(e), i = null, a = null;
+}, vt = () => Pe() ? Ne() : null, yt = (e) => {
+	let t = e.channel ?? "framework_changes", n = e.revalidateChannel ?? "voltro_revalidate", r = _t(e), i = null, a = null;
 	return {
 		start: async () => {
 			let o = e.tableSubscriptionsByPattern.size > 0, s = e.onRevalidate !== void 0;
 			if (!o && !s) return G.debug("skipped — no pages declare cacheInvalidatesOn and no revalidation handler is wired"), !1;
-			let c = K();
+			let c = vt();
 			if (!c && !o) return G.debug("no database configured — the revalidation LISTEN line is unavailable"), !1;
 			if (!c) return G.warn(`${e.tableSubscriptionsByPattern.size} route(s) declare \`cacheInvalidatesOn\` and will NOT be invalidated live — no database is configured for this web process. Set DB_URL (or DB_HOST / PG_HOST) so the CDC listener can connect; until then those routes go stale until their \`revalidate\` window expires.`, { routes: [...e.tableSubscriptionsByPattern.keys()] }), !1;
 			i = new (await (import("pg"))).default.Client(c), await i.connect(), a = (i) => {
@@ -123,7 +124,7 @@ var dt = "VOLTRO_PUBLIC_", ft = (e, t) => {
 			}
 		}
 	};
-}, vt = H({ scope: "voltro:start:isr-cache" }), q = "voltro_isr_cache", yt = (e) => `
+}, K = H({ scope: "voltro:start:isr-cache" }), bt = "voltro_isr_cache", xt = (e) => `
 CREATE TABLE IF NOT EXISTS ${e} (
   cache_key                TEXT PRIMARY KEY,
   html                     TEXT NOT NULL,
@@ -134,9 +135,9 @@ CREATE TABLE IF NOT EXISTS ${e} (
   stale_while_revalidate_ms BIGINT NOT NULL DEFAULT 0
 );
 CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
-`, bt = (e) => {
-	let t = e.tableName ?? q, { client: n } = e, r = /* @__PURE__ */ new Map(), i = !1, a = (async () => {
-		i || (i = !0, await n.query(yt(t)));
+`, St = (e) => {
+	let t = e.tableName ?? bt, { client: n } = e, r = /* @__PURE__ */ new Map(), i = !1, a = (async () => {
+		i || (i = !0, await n.query(xt(t)));
 	})().then(async () => {
 		let e = await n.query(`SELECT * FROM ${t}`);
 		for (let t of e.rows) r.set(t.cache_key, {
@@ -148,10 +149,10 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			staleWhileRevalidateMs: Number(t.stale_while_revalidate_ms)
 		});
 	}).catch((e) => {
-		vt.warn("postgres bootstrap failed", {}, e);
+		K.warn("postgres bootstrap failed", {}, e);
 	}), o = (e, t) => {
 		a.then(() => n.query(e, t)).catch((e) => {
-			vt.warn("postgres write failed", {}, e);
+			K.warn("postgres write failed", {}, e);
 		});
 	}, s = /* @__PURE__ */ new Map(), c = (e) => {
 		s.set(e, (s.get(e) ?? 0) + 1);
@@ -202,21 +203,21 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			return Array.from(r.entries());
 		}
 	};
-}, J = H({ scope: "voltro:start:revalidate" }), xt = (e) => {
+}, q = H({ scope: "voltro:start:revalidate" }), Ct = (e) => {
 	try {
 		let t = JSON.parse(e);
 		return (t.kind === "path" || t.kind === "table" || t.kind === "tag") && typeof t.value == "string" && t.value.length > 0 && (t.tenant === void 0 || typeof t.tenant == "string") ? {
 			kind: t.kind,
 			value: t.value,
 			...t.tenant === void 0 ? {} : { tenant: t.tenant }
-		} : (J.warn("bad revalidation payload (shape)", { payload: e }), null);
+		} : (q.warn("bad revalidation payload (shape)", { payload: e }), null);
 	} catch {
-		return J.warn("bad revalidation payload (not JSON)", { payload: e }), null;
+		return q.warn("bad revalidation payload (not JSON)", { payload: e }), null;
 	}
-}, St = (e, t) => {
+}, wt = (e, t) => {
 	if (t.kind === "table" || t.kind === "tag") {
 		let n = e.tableSink(t.value);
-		return J.info(`revalidate ${t.kind} '${t.value}' → dropped ${n} cache entries`, {
+		return q.info(`revalidate ${t.kind} '${t.value}' → dropped ${n} cache entries`, {
 			kind: t.kind,
 			value: t.value,
 			dropped: n
@@ -225,7 +226,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 	let n = t.value, r = (e) => t.tenant === void 0 || e.split("|").includes(`tenant=${t.tenant}`), i = e.regexByPattern.get(n);
 	if (i !== void 0) {
 		let a = e.renderModeByPattern.get(n);
-		if (a !== "isr") return J.error(`revalidatePath('${n}') targets a '${a ?? "unknown"}' route — only \`renderMode: 'isr'\` routes have cache entries to drop. Static HTML is a build artifact this process never re-renders; rebuild to change it.`, {
+		if (a !== "isr") return q.error(`revalidatePath('${n}') targets a '${a ?? "unknown"}' route — only \`renderMode: 'isr'\` routes have cache entries to drop. Static HTML is a build artifact this process never re-renders; rebuild to change it.`, {
 			path: n,
 			renderMode: a ?? "unknown"
 		}), 0;
@@ -233,27 +234,67 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			let t = e.split("|")[0] ?? e;
 			return i.test(t) && r(e);
 		});
-		return J.info(`revalidate path pattern '${n}' → dropped ${o} cache entries`, {
+		return q.info(`revalidate path pattern '${n}' → dropped ${o} cache entries`, {
 			path: n,
 			dropped: o,
 			...t.tenant === void 0 ? {} : { tenant: t.tenant }
 		}), o;
 	}
 	let a = [...e.regexByPattern.entries()].find(([, e]) => e.test(n));
-	if (a === void 0) return J.error(`revalidatePath('${n}') matches no declared route — nothing was dropped. Pass a declared route pattern (e.g. /blog/[slug]) or a concrete path of one.`, { path: n }), 0;
+	if (a === void 0) return q.error(`revalidatePath('${n}') matches no declared route — nothing was dropped. Pass a declared route pattern (e.g. /blog/[slug]) or a concrete path of one.`, { path: n }), 0;
 	let o = e.renderModeByPattern.get(a[0]);
-	if (o !== "isr") return J.error(`revalidatePath('${n}') targets a '${o ?? "unknown"}' route (${a[0]}) — only \`renderMode: 'isr'\` routes have cache entries to drop.`, {
+	if (o !== "isr") return q.error(`revalidatePath('${n}') targets a '${o ?? "unknown"}' route (${a[0]}) — only \`renderMode: 'isr'\` routes have cache entries to drop.`, {
 		path: n,
 		route: a[0],
 		renderMode: o ?? "unknown"
 	}), 0;
 	let s = e.cache.invalidateBy((e) => (e.split("|")[0] ?? e) === n && r(e));
-	return J.info(`revalidate path '${n}' → dropped ${s} cache entries`, {
+	return q.info(`revalidate path '${n}' → dropped ${s} cache entries`, {
 		path: n,
 		dropped: s,
 		...t.tenant === void 0 ? {} : { tenant: t.tenant }
 	}), s;
-}, Y = H({ scope: "voltro:start" }), Ct = nt() ?? "unknown", X = (e) => e instanceof Error && e._voltroControl === "redirect" && typeof e.location == "string", wt = (e) => e instanceof Error && e._voltroControl === "not-found", Tt = {
+}, Tt = async (e) => {
+	let t = W(R(e, "package.json")), n;
+	try {
+		n = t.resolve("@voltro/plugin-sentry/server");
+	} catch {
+		return { reason: "SENTRY_DSN is set but `@voltro/plugin-sentry` is not installed in this app — the web server cannot report SSR errors. → `pnpm add @voltro/plugin-sentry` in the web app." };
+	}
+	try {
+		return await import(V(n).href);
+	} catch (e) {
+		return { reason: `@voltro/plugin-sentry/server resolved but could not be loaded: ${e instanceof Error ? e.message : String(e)}` };
+	}
+}, Et = async (e, t, n, r = {}) => {
+	let i = t.SENTRY_DSN;
+	if (i === void 0 || i === "") return;
+	let a = await (r.load ?? Tt)(e);
+	if ("reason" in a) {
+		n.warn(a.reason);
+		return;
+	}
+	let o = {
+		dsn: i,
+		environment: t.SENTRY_ENVIRONMENT,
+		release: t.SENTRY_RELEASE,
+		traces: !1
+	}, s = await a.initSentryServer(o, n);
+	if (s !== void 0) return n.info("sentry active", {
+		...a.sentryActiveFields(s, o),
+		process: "web"
+	}), (e, t) => {
+		try {
+			s.sdk.captureException(e, {
+				tags: {
+					"voltro.process": "web",
+					"voltro.stage": t.stage
+				},
+				...t.pathname === void 0 ? {} : { extra: { pathname: t.pathname } }
+			});
+		} catch {}
+	};
+}, J = H({ scope: "voltro:start" }), Dt = nt() ?? "unknown", Ot = (e) => e instanceof Error && e._voltroControl === "redirect" && typeof e.location == "string", kt = (e) => e instanceof Error && e._voltroControl === "not-found", At = {
 	".html": "text/html; charset=utf-8",
 	".js": "application/javascript",
 	".mjs": "application/javascript",
@@ -271,13 +312,13 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 	".woff": "font/woff",
 	".woff2": "font/woff2",
 	".txt": "text/plain; charset=utf-8"
-}, Et = (e) => Tt[L(e).toLowerCase()] ?? "application/octet-stream", Dt = (e) => e.replace(/<script\b(?=[^>]*\btype="module")(?:(?!<\/script>).)*<\/script>/gi, "").replace(/<script\b(?=[^>]*\bsrc=)(?:(?!<\/script>).)*<\/script>/gi, "").replace(/<link\b[^>]*\brel="modulepreload"[^>]*>/gi, ""), Z = async (e) => {
+}, jt = (e) => At[L(e).toLowerCase()] ?? "application/octet-stream", Mt = (e) => e.replace(/<script\b(?=[^>]*\btype="module")(?:(?!<\/script>).)*<\/script>/gi, "").replace(/<script\b(?=[^>]*\bsrc=)(?:(?!<\/script>).)*<\/script>/gi, "").replace(/<link\b[^>]*\brel="modulepreload"[^>]*>/gi, ""), Y = async (e) => {
 	try {
 		return await B.stat(e), !0;
 	} catch {
 		return !1;
 	}
-}, Ot = (e) => {
+}, Nt = (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("/");
@@ -286,8 +327,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		paramNames: t,
 		priority: n
 	};
-}, kt = (e) => e.map((e) => {
-	let { regex: t, paramNames: n, priority: r } = Ot(e.pattern);
+}, Pt = (e) => e.map((e) => {
+	let { regex: t, paramNames: n, priority: r } = Nt(e.pattern);
 	return {
 		pattern: e.pattern,
 		file: e.file,
@@ -296,7 +337,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		paramNames: n,
 		priority: r
 	};
-}).slice().sort((e, t) => e.priority - t.priority), At = (e, t) => {
+}).slice().sort((e, t) => e.priority - t.priority), Ft = (e, t) => {
 	for (let n of t) {
 		let t = n.regex.exec(e);
 		if (!t) continue;
@@ -308,7 +349,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		};
 	}
 	return null;
-}, jt = null, Mt, Nt = (e, t) => t === void 0 ? Promise.resolve() : (Mt ??= (async () => {
+}, X = null, It, Lt = (e, t) => t === void 0 ? Promise.resolve() : (It ??= (async () => {
 	try {
 		let n = await e.getHelpers(), r = n.apiDescriptors?.[t];
 		if (r === void 0) return;
@@ -316,9 +357,9 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		if (i === void 0) return;
 		i(t, await r());
 	} catch {}
-})(), Mt), Pt = async (e) => {
+})(), It), Rt = async (e) => {
 	let { provider: t, route: r, params: i, pathname: a, dirs: o, shellTemplate: s, requestHeaders: c, requestUrl: l = "", apiOrigin: u, apiName: d } = e;
-	await Nt(t, d);
+	await Lt(t, d);
 	let { search: p } = be(l), g = await ie(ae(e.middlewares ?? [], {
 		route: r.pattern,
 		pathname: a
@@ -328,9 +369,9 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		headers: c,
 		cookies: ee(c.cookie),
 		route: r.pattern
-	}, e.onCookieWarning), y = await t.getPage(r.pattern, r.file), x = e.forceSsrRender === !0 ? "ssr" : ze(y, r.file), ne = x === "isr" && y.ppr === !0, S = x === "isr" && e.holesOnly !== !0 ? h(g.headers) : g.headers, C = xe(u, S.cookie, {
+	}, e.onCookieWarning), y = await t.getPage(r.pattern, r.file), x = e.forceSsrRender === !0 ? "ssr" : ze(y, r.file), S = x === "isr" && y.ppr === !0, C = x === "isr" && e.holesOnly !== !0 ? h(g.headers) : g.headers, ne = xe(u, C.cookie, {
 		apiName: d,
-		headers: S
+		headers: C
 	});
 	if (e.holesOnly === !0) {
 		if (typeof y.loader != "function") return null;
@@ -343,8 +384,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 					pathname: a,
 					search: p,
 					signal: e.signal,
-					headers: S,
-					query: C,
+					headers: C,
+					query: ne,
 					isServer: !0
 				},
 				helpers: await t.getHelpers(),
@@ -355,7 +396,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 	}
 	let w = x === "spa" && we(o, r.dirChain).some((e) => e.hasLayout);
 	if (x !== "ssr" && x !== "isr" && !w) return null;
-	let re = we(o, r.dirChain), oe = {}, ce = null, le, ue = new AbortController(), fe = ne ? b(S, r.pattern) : S;
+	let re = we(o, r.dirChain), oe = {}, ce = null, le, ue = new AbortController(), fe = S ? b(C, r.pattern) : C;
 	try {
 		(await t.getHelpers()).beginStoreSeeds(), {chain: le, segmentLoaderData: oe} = await D({
 			entries: re,
@@ -368,7 +409,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				search: p,
 				signal: ue.signal,
 				headers: fe,
-				query: C,
+				query: ne,
 				isServer: !0
 			}
 		}), typeof y.loader == "function" && !w && (ce = await y.loader({
@@ -377,18 +418,18 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			search: p,
 			signal: ue.signal,
 			headers: fe,
-			query: C,
+			query: ne,
 			isServer: !0
 		}));
 	} catch (e) {
-		if (X(e)) return {
+		if (Ot(e)) return {
 			control: "redirect",
 			status: e.status,
 			location: e.location,
 			setCookies: g.setCookies,
 			responseHeaders: g.responseHeaders
 		};
-		if (wt(e)) return {
+		if (kt(e)) return {
 			control: "not-found",
 			setCookies: g.setCookies,
 			responseHeaders: g.responseHeaders
@@ -399,11 +440,11 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 	w || await te({
 		pageMod: y,
 		params: i,
-		query: C,
+		query: ne,
 		apiName: d,
 		seed: O.seedPreloadedSubscription,
 		seedFailure: O.seedPreloadedSubscriptionFailure,
-		onError: ({ tag: e, apiName: t }, n) => Y.warn("preload seed failed", {
+		onError: ({ tag: e, apiName: t }, n) => J.warn("preload seed failed", {
 			tag: e,
 			apiName: t,
 			pathname: a
@@ -421,11 +462,11 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 	};
 	if (x === "isr" && g.cspNonce !== void 0) throw Error(`page '${r.pattern}' is renderMode 'isr' while middleware.ts mints a cspNonce — an isr render is CACHED and a cached nonce is a lie the browser enforces. Use renderMode 'ssr' for nonce'd pages, or a hash-based CSP for isr.`);
 	let me = {
-		cookies: ne ? v(f(g.cookies), r.pattern) : x === "isr" ? f(g.cookies) : g.cookies,
+		cookies: S ? v(f(g.cookies), r.pattern) : x === "isr" ? f(g.cookies) : g.cookies,
 		headers: fe,
 		url: l,
 		...e.formFlash === void 0 ? {} : { formFlash: e.formFlash }
-	}, k = O.i18n?.resolve(S.cookie, S["accept-language"]), he = {
+	}, k = O.i18n?.resolve(C.cookie, C["accept-language"]), he = {
 		lang: k?.locale ?? me.cookies["voltro:locale"] ?? "en",
 		...k?.timeZone === void 0 ? {} : { timeZone: k.timeZone },
 		renderedAt: Date.now()
@@ -478,7 +519,10 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 						...g.cspNonce === void 0 ? {} : { nonce: g.cspNonce }
 					}),
 					onShellError: (e) => {
-						Y.error("spa layout shell render failed", { pathname: a }, e), r.writeHead(500, { "content-type": "text/plain; charset=utf-8" }), r.end("server error");
+						J.error("spa layout shell render failed", { pathname: a }, e), Q?.(e, {
+							stage: "spa-layout-shell",
+							pathname: a
+						}), r.writeHead(500, { "content-type": "text/plain; charset=utf-8" }), r.end("server error");
 					}
 				})
 			};
@@ -504,9 +548,9 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		loaderData: ce,
 		segmentLoaderData: oe,
 		pageLoaderRan: typeof y.loader == "function",
-		...ne ? { ppr: !0 } : {}
+		...S ? { ppr: !0 } : {}
 	});
-	ne && _(j.stateInput, r.pattern);
+	S && _(j.stateInput, r.pattern);
 	let ge = {
 		descriptor: pe,
 		params: i,
@@ -520,8 +564,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			locale: k.locale
 		} : {}
 	}, _e = (t) => {
-		if (jt === null || x !== "ssr" && x !== "isr" || typeof y.ogImage != "function" || t.includes("og:image")) return "";
-		let n = S["x-tenant"], i = jt.signOgUrl({
+		if (X === null || x !== "ssr" && x !== "isr" || typeof y.ogImage != "function" || t.includes("og:image")) return "";
+		let n = C["x-tenant"], i = X.signOgUrl({
 			pattern: r.pattern,
 			params: e.params,
 			...n === void 0 ? {} : { tenant: n }
@@ -556,13 +600,16 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 					...g.cspNonce === void 0 ? {} : { nonce: g.cspNonce }
 				}),
 				onShellError: (e) => {
-					Y.error("ssr shell render failed", { pathname: a }, e), t.writeHead(500, { "content-type": "text/plain; charset=utf-8" }), t.end("server error");
+					J.error("ssr shell render failed", { pathname: a }, e), Q?.(e, {
+						stage: "ssr-shell",
+						pathname: a
+					}), t.writeHead(500, { "content-type": "text/plain; charset=utf-8" }), t.end("server error");
 				}
 			})
 		};
 	}
 	let { html: Se, meta: Ce } = O.renderPageToHtml(ge), Te = ye(Ce), F = M(m(s.replace("<div id=\"root\"></div>", `<div id="root">${Se}</div>`), Te), he);
-	A === "none" && (F = Dt(F));
+	A === "none" && (F = Mt(F));
 	let Ee = x === "isr" ? I(y.revalidate) : null;
 	return {
 		html: g.cspNonce === void 0 ? F : T(F, g.cspNonce),
@@ -571,7 +618,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		setCookies: g.setCookies,
 		responseHeaders: g.responseHeaders
 	};
-}, Q = (e) => e === "" ? "/" : e, Ft = async (e) => {
+}, Z = (e) => e === "" ? "/" : e, zt = async (e) => {
 	let t = await import(V(e).href);
 	return {
 		kind: "bundle",
@@ -582,18 +629,18 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			return typeof r == "function" ? await r() : r;
 		},
 		async getLayout(e) {
-			let n = t.layouts[Q(e)];
-			if (!n) throw Error(`[voltro start] ssr bundle missing layout for dir ${Q(e)}`);
+			let n = t.layouts[Z(e)];
+			if (!n) throw Error(`[voltro start] ssr bundle missing layout for dir ${Z(e)}`);
 			return typeof n == "function" ? await n() : n;
 		},
 		async getError(e) {
-			let n = t.errors[Q(e)];
-			if (!n) throw Error(`[voltro start] ssr bundle missing error for dir ${Q(e)}`);
+			let n = t.errors[Z(e)];
+			if (!n) throw Error(`[voltro start] ssr bundle missing error for dir ${Z(e)}`);
 			return typeof n == "function" ? await n() : n;
 		},
 		async getPending(e) {
-			let n = t.pendings[Q(e)];
-			if (!n) throw Error(`[voltro start] ssr bundle missing pending for dir ${Q(e)}`);
+			let n = t.pendings[Z(e)];
+			if (!n) throw Error(`[voltro start] ssr bundle missing pending for dir ${Z(e)}`);
 			return typeof n == "function" ? await n() : n;
 		},
 		async getHelpers() {
@@ -601,8 +648,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		},
 		async close() {}
 	};
-}, It = async (e, t) => {
-	let n = await S("vite", () => import("vite")), r = (await import("@vitejs/plugin-react")).default, i = (await import("@tailwindcss/vite")).default, a = await n.createServer({
+}, Bt = async (e, t) => {
+	let n = await C("vite", () => import("vite")), r = (await import("@vitejs/plugin-react")).default, i = (await import("@tailwindcss/vite")).default, a = await n.createServer({
 		root: t,
 		envPrefix: "__VOLTRO_VITE_ENV_DISABLED__",
 		plugins: [r(), i()],
@@ -621,8 +668,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		logLevel: "warn"
 	}), o = R(e, "src", "pages"), s = (e) => e === "" ? o : R(o, e), c = g({
 		limit: w(),
-		onColdStart: (e) => Y.debug("ssr cold-compile start", { id: e }),
-		onColdEnd: (e, { durationMs: t, failed: n }) => Y.debug(`ssr cold-compile ${n ? "FAILED" : "end"} ${t}ms`, {
+		onColdStart: (e) => J.debug("ssr cold-compile start", { id: e }),
+		onColdEnd: (e, { durationMs: t, failed: n }) => J.debug(`ssr cold-compile ${n ? "FAILED" : "end"} ${t}ms`, {
 			id: e,
 			ms: t,
 			...n ? { failed: !0 } : {}
@@ -649,19 +696,20 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			await a.close();
 		}
 	};
-}, Lt = async (t) => {
+}, Q, $ = async (t) => {
 	let n = Ye(), f = await j(t);
 	if (!f) return {
 		ran: !1,
 		exitCode: 0
 	};
-	if (f.type !== "web") return Y.error("only web apps are supported by `voltro start`"), {
+	if (f.type !== "web") return J.error("only web apps are supported by `voltro start`"), {
 		ran: !0,
 		exitCode: 1
 	};
+	Q = await Et(t, process.env, J);
 	{
 		let e = s(f);
-		if (e !== void 0) return Y.error(`voltro start: refusing to boot — ${e}`), {
+		if (e !== void 0) return J.error(`voltro start: refusing to boot — ${e}`), {
 			ran: !0,
 			exitCode: 1
 		};
@@ -670,19 +718,19 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		rawEnv: f.env,
 		appType: "web",
 		root: t,
-		log: Y,
+		log: J,
 		generateTypes: !1
 	}), te = m.publicValues;
 	n.mark("config");
 	let h = ue();
-	fe(h), Y.info("booting voltro start", { app: f.name ?? "(unnamed)" });
+	fe(h), J.info("booting voltro start", { app: f.name ?? "(unnamed)" });
 	let g = Me({
 		kind: "web",
 		configPort: f.port,
 		env: process.env,
 		dashboardPin: process.env[pe] === "1"
 	});
-	for (let e of g.warnings) Y.warn(e);
+	for (let e of g.warnings) J.warn(e);
 	let _ = g.port, v = R(t, ".framework");
 	{
 		let e;
@@ -691,11 +739,11 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		} catch {
 			e = void 0;
 		}
-		let t = ft(process.env, e);
-		t.length > 0 && Y.warn(pt(t));
+		let t = pt(process.env, e);
+		t.length > 0 && J.warn(mt(t));
 	}
-	let b = R(v, "dist"), S = R(b, "index.html");
-	if (!await Z(S)) return Y.error("no built dist found — run `voltro build` first", { distDir: b }), {
+	let b = R(v, "dist"), C = R(b, "index.html");
+	if (!await Y(C)) return J.error("no built dist found — run `voltro build` first", { distDir: b }), {
 		ran: !0,
 		exitCode: 1
 	};
@@ -709,78 +757,78 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		status: "booting",
 		logFile: E.path
 	}).catch(() => {});
-	let se = R(b, "_voltro", "shell.html"), D = await Z(se) ? await B.readFile(se, "utf8") : await B.readFile(S, "utf8"), de = await O(t, f), ve = Fe(f), M = Xe(f), N = _e(de[0]), P = de[0]?.name, ze = /* @__PURE__ */ new Set(), I = (e) => {
-		ze.has(e.name) || (ze.add(e.name), Y.warn(`middleware.ts wrote the cookie "${e.name}" with the HttpOnly default — a browser SDK cannot read it`, {
+	let se = R(b, "_voltro", "shell.html"), D = await Y(se) ? await B.readFile(se, "utf8") : await B.readFile(C, "utf8"), de = await O(t, f), ve = Fe(f), M = Xe(f), N = _e(de[0]), P = de[0]?.name, ze = /* @__PURE__ */ new Set(), I = (e) => {
+		ze.has(e.name) || (ze.add(e.name), J.warn(`middleware.ts wrote the cookie "${e.name}" with the HttpOnly default — a browser SDK cannot read it`, {
 			cookie: e.name,
 			hint: "If your IdP client reads this from `document.cookie` (Supabase's `createBrowserClient` does), pass `httpOnly: false`. Otherwise the SSR render succeeds and the user is signed out at the first client-side call. Set `httpOnly: true` explicitly to silence this."
 		}));
 	}, L = await a(t);
-	L.length > 0 && Y.info(`middleware.ts loaded — ${L.length} middleware(s): ` + L.map((e) => e.exportName).join(", "));
+	L.length > 0 && J.info(`middleware.ts loaded — ${L.length} middleware(s): ` + L.map((e) => e.exportName).join(", "));
 	let z, V = null, H = process.env.SSR_CACHE === "postgres";
-	if (H && Pe()) V = new (await (import("pg"))).default.Client(Ne()), await V.connect(), z = bt({ client: V }), Y.info("isr cache backend: postgres", { table: "voltro_isr_cache" });
+	if (H && Pe()) V = new (await (import("pg"))).default.Client(Ne()), await V.connect(), z = St({ client: V }), J.info("isr cache backend: postgres", { table: "voltro_isr_cache" });
 	else if (H) {
 		let t = "SSR_CACHE=postgres, but nothing in the environment names a database (looked for DB_URL, DB_PRIMARY_URL, DB_DIRECT_URL, DB_MIGRATE_URL, DB_HOST, PG_HOST).";
-		if (e()) throw Y.fatal(`${t} Refusing to fall back to the per-process memory cache: it is not shared between instances and does not survive a restart, so the pages this process serves would differ from its replicas' with nothing to indicate it.`), Error("[voltro start] SSR_CACHE=postgres with no database configured");
-		z = Ve(), Y.warn(`${t} Falling back to the per-process memory cache — this would be a hard failure in production.`);
-	} else z = Ve(), Y.info("isr cache backend: memory (per-process)", { hint: "set SSR_CACHE=postgres for persistent storage" });
+		if (e()) throw J.fatal(`${t} Refusing to fall back to the per-process memory cache: it is not shared between instances and does not survive a restart, so the pages this process serves would differ from its replicas' with nothing to indicate it.`), Error("[voltro start] SSR_CACHE=postgres with no database configured");
+		z = Ve(), J.warn(`${t} Falling back to the per-process memory cache — this would be a hard failure in production.`);
+	} else z = Ve(), J.info("isr cache backend: memory (per-process)", { hint: "set SSR_CACHE=postgres for persistent storage" });
 	await o(t, f, de, te);
-	let nt = R(t, "src", "pages"), { pages: rt, dirs: U } = await re(nt), W = kt(rt);
-	C(L, W.map((e) => e.pattern)), n.mark("scan");
-	let dt = R(b, "server", "ssrEntry.js"), G = await Z(dt);
-	if (!G && process.env.NODE_ENV === "production") throw Y.fatal(`production \`voltro start\` requires a precompiled SSR bundle at ${dt} but it is missing. Run \`voltro build\` before serving — production renders from the bundle and never compiles on demand.`), Error(`[voltro start] missing SSR bundle at ${dt}`);
-	let K = G ? await Ft(dt) : await It(t, v);
-	Y.info(`ssr loader: ${K.kind}`, {
-		kind: K.kind,
-		...K.kind === "middleware" ? { hint: "no pre-built SSR bundle found; run `voltro build` to enable bundle mode" } : {}
+	let nt = R(t, "src", "pages"), { pages: rt, dirs: U } = await re(nt), W = Pt(rt);
+	ne(L, W.map((e) => e.pattern)), n.mark("scan");
+	let lt = R(b, "server", "ssrEntry.js"), ft = await Y(lt);
+	if (!ft && process.env.NODE_ENV === "production") throw J.fatal(`production \`voltro start\` requires a precompiled SSR bundle at ${lt} but it is missing. Run \`voltro build\` before serving — production renders from the bundle and never compiles on demand.`), Error(`[voltro start] missing SSR bundle at ${lt}`);
+	let G = ft ? await zt(lt) : await Bt(t, v);
+	J.info(`ssr loader: ${G.kind}`, {
+		kind: G.kind,
+		...G.kind === "middleware" ? { hint: "no pre-built SSR bundle found; run `voltro build` to enable bundle mode" } : {}
 	}), n.mark("provider");
-	let vt = K.getPageMeta?.();
+	let vt = G.getPageMeta?.();
 	c(t);
-	let q = /* @__PURE__ */ new Map(), yt = 0;
+	let K = /* @__PURE__ */ new Map(), bt = 0;
 	for (let e of rt) {
 		let t = vt?.[e.pattern];
 		if (t) {
-			q.set(e.pattern, t);
+			K.set(e.pattern, t);
 			continue;
 		}
 		try {
-			let t = await K.getPage(e.pattern, e.file);
-			q.set(e.pattern, Re(t, e.file)), yt++;
+			let t = await G.getPage(e.pattern, e.file);
+			K.set(e.pattern, Re(t, e.file)), bt++;
 		} catch (t) {
-			Y.warn("failed to load page metadata", { pattern: e.pattern }, t);
+			J.warn("failed to load page metadata", { pattern: e.pattern }, t);
 		}
 	}
-	let J = /* @__PURE__ */ new Map();
-	for (let [e, t] of q) {
+	let xt = /* @__PURE__ */ new Map();
+	for (let [e, t] of K) {
 		if (t.interactive !== "islands") continue;
 		let n = R(b, "island-shells", `${k(e)}.html`);
 		try {
-			J.set(e, await B.readFile(n, "utf8"));
+			xt.set(e, await B.readFile(n, "utf8"));
 		} catch {
-			Y.warn("islands page has no built per-page shell — serving the full app shell", {
+			J.warn("islands page has no built per-page shell — serving the full app shell", {
 				pattern: e,
 				expected: n
 			});
 		}
 	}
-	Y.info(`registered ${q.size} route(s)`, {
-		count: q.size,
-		fromManifest: q.size - yt,
-		fromModules: yt
+	J.info(`registered ${K.size} route(s)`, {
+		count: K.size,
+		fromManifest: K.size - bt,
+		fromModules: bt
 	}), n.mark("routes");
-	let X = /* @__PURE__ */ new Set();
-	for (let e of W) q.get(e.pattern)?.renderMode === "spa" && we(U, e.dirChain).some((e) => e.hasLayout) && X.add(e.pattern);
-	X.size > 0 && Y.info(`${X.size} spa route(s) render an SSR layout shell`, { patterns: [...X] });
-	let wt = /* @__PURE__ */ new Map();
-	for (let [e, t] of q) t.cacheInvalidatesOn.length > 0 && wt.set(e, t.cacheInvalidatesOn);
+	let q = /* @__PURE__ */ new Set();
+	for (let e of W) K.get(e.pattern)?.renderMode === "spa" && we(U, e.dirChain).some((e) => e.hasLayout) && q.add(e.pattern);
+	q.size > 0 && J.info(`${q.size} spa route(s) render an SSR layout shell`, { patterns: [...q] });
 	let Tt = /* @__PURE__ */ new Map();
-	for (let e of W) Tt.set(e.pattern, e.regex);
+	for (let [e, t] of K) t.cacheInvalidatesOn.length > 0 && Tt.set(e, t.cacheInvalidatesOn);
+	let Ot = /* @__PURE__ */ new Map();
+	for (let e of W) Ot.set(e.pattern, e.regex);
 	{
-		let n = new Set([...q].filter(([, e]) => (e.renderMode === "ssr" || e.renderMode === "isr") && e.hasOgImage).map(([e]) => e));
+		let n = new Set([...K].filter(([, e]) => (e.renderMode === "ssr" || e.renderMode === "isr") && e.hasOgImage).map(([e]) => e));
 		if (n.size > 0) {
 			let { secret: r, fromEnv: i } = Te();
-			if (!i && e()) throw Y.fatal(`${n.size} ssr route(s) export ogImage, but VOLTRO_OG_SECRET is unset. Behind a load balancer the signing replica and the fetching replica differ, so a per-boot secret would 403 every cross-replica image fetch. Set VOLTRO_OG_SECRET (any long random value, same on every replica).`), Error("[voltro start] ssr ogImage routes need VOLTRO_OG_SECRET in a deploy environment");
+			if (!i && e()) throw J.fatal(`${n.size} ssr route(s) export ogImage, but VOLTRO_OG_SECRET is unset. Behind a load balancer the signing replica and the fetching replica differ, so a per-boot secret would 403 every cross-replica image fetch. Set VOLTRO_OG_SECRET (any long random value, same on every replica).`), Error("[voltro start] ssr ogImage routes need VOLTRO_OG_SECRET in a deploy environment");
 			let a = new Map(rt.map((e) => [e.pattern, e.file]));
-			jt = le({
+			X = le({
 				root: t,
 				fonts: f.fonts,
 				cache: z,
@@ -788,45 +836,45 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				isOgSsrRoute: (e) => n.has(e),
 				getPageModule: async (e) => {
 					let t = a.get(e);
-					return t === void 0 ? null : await K.getPage(e, t);
+					return t === void 0 ? null : await G.getPage(e, t);
 				}
-			}), Y.info(`og route active for ${n.size} ssr route(s)`, { secret: i ? "env" : "per-boot" });
+			}), J.info(`og route active for ${n.size} ssr route(s)`, { secret: i ? "env" : "per-boot" });
 		}
 	}
-	let Dt = /* @__PURE__ */ new Map();
-	for (let [e, t] of q) Dt.set(e, t.renderMode);
-	let Ot = [...q.values()].some((e) => e.renderMode === "isr"), Mt = {
+	let kt = /* @__PURE__ */ new Map();
+	for (let [e, t] of K) kt.set(e, t.renderMode);
+	let At = [...K.values()].some((e) => e.renderMode === "isr"), Mt = {
 		cache: z,
-		tableSink: gt({
+		tableSink: _t({
 			cache: z,
-			tableSubscriptionsByPattern: wt,
-			regexByPattern: Tt
+			tableSubscriptionsByPattern: Tt,
+			regexByPattern: Ot
 		}),
-		regexByPattern: Tt,
-		renderModeByPattern: Dt
+		regexByPattern: Ot,
+		renderModeByPattern: kt
 	}, Nt = (e) => {
-		let t = xt(e);
-		t && St(Mt, t);
-	}, Q = _t({
+		let t = Ct(e);
+		t && wt(Mt, t);
+	}, It = yt({
 		cache: z,
-		tableSubscriptionsByPattern: wt,
-		regexByPattern: Tt,
-		...Ot ? { onRevalidate: Nt } : {}
-	}), Lt = await Q.start(), $ = null, Rt = null;
-	if (Ot) {
-		let e = lt({}, process.env);
+		tableSubscriptionsByPattern: Tt,
+		regexByPattern: Ot,
+		...At ? { onRevalidate: Nt } : {}
+	}), Lt = await It.start(), Z = null, $ = null;
+	if (At) {
+		let e = ut({}, process.env);
 		if (e.crossReplica) try {
-			Rt = e.provider;
+			$ = e.provider;
 			let t = Ie(process.env);
-			$ = await ct.runPromise(e.provider.subscribe(t, Nt)), Y.info(`revalidation subscriber: broker (${e.provider.name})`, { channel: t });
+			Z = await ct.runPromise(e.provider.subscribe(t, Nt)), J.info(`revalidation subscriber: broker (${e.provider.name})`, { channel: t });
 		} catch (e) {
-			Y.warn("revalidation broker subscribe failed — broker leg disabled", {}, e), Rt = null;
+			J.warn("revalidation broker subscribe failed — broker leg disabled", {}, e), $ = null;
 		}
-		Lt && $ === null && Y.info("revalidation subscriber: postgres LISTEN (voltro_revalidate)"), !Lt && $ === null && Y.warn("isr routes exist, but this web process has NO revalidation transport: no database is configured for the LISTEN line and no broker is configured. `revalidatePath` / `revalidateTable` / `revalidateTag` from the api will not reach this process — cached pages stay until their own `revalidate` window expires. Set DB_URL (postgres) or BROADCAST_URL (redis:// or nats://) on BOTH the api and this web deployment.");
+		Lt && Z === null && J.info("revalidation subscriber: postgres LISTEN (voltro_revalidate)"), !Lt && Z === null && J.warn("isr routes exist, but this web process has NO revalidation transport: no database is configured for the LISTEN line and no broker is configured. `revalidatePath` / `revalidateTable` / `revalidateTag` from the api will not reach this process — cached pages stay until their own `revalidate` window expires. Set DB_URL (postgres) or BROADCAST_URL (redis:// or nats://) on BOTH the api and this web deployment.");
 	}
 	n.mark("cdc");
-	let zt = Le(), Bt = rt.map((e) => {
-		let t = q.get(e.pattern);
+	let Vt = Le(), Ht = rt.map((e) => {
+		let t = K.get(e.pattern);
 		return {
 			pattern: e.pattern,
 			file: e.file,
@@ -841,17 +889,17 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			hasMeta: t?.hasMeta ?? !1,
 			hasGetStaticPaths: t?.hasGetStaticPaths ?? !1
 		};
-	}), Vt = U.map((e) => ({
+	}), Ut = U.map((e) => ({
 		dir: e.dir,
 		hasLayout: e.hasLayout,
 		hasError: e.hasError,
 		hasPending: e.hasPending,
 		hasNotFound: e.hasNotFound
-	})), Ht = V ? "postgres" : "memory", Ut = {
+	})), Wt = V ? "postgres" : "memory", Gt = {
 		kind: "web",
 		meta: {
 			name: f.name ?? "(unnamed)",
-			voltroVersion: Ct,
+			voltroVersion: Dt,
 			port: _,
 			mode: tt(),
 			apis: Object.entries(f.apis ?? {}).map(([e, t]) => {
@@ -862,8 +910,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				return t.url !== void 0 && (n.url = t.url), n;
 			})
 		},
-		routes: Bt,
-		dirs: Vt,
+		routes: Ht,
+		dirs: Ut,
 		cache: () => {
 			let e = Date.now(), t = z.snapshot().map(([t, n]) => ({
 				key: t,
@@ -876,13 +924,13 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				staleWhileRevalidateMs: n.staleWhileRevalidateMs
 			}));
 			return {
-				backend: Ht,
+				backend: Wt,
 				size: z.size(),
 				entries: t
 			};
 		},
 		metrics: () => st()
-	}, Wt = async (e, n) => {
+	}, Kt = async (e, n) => {
 		let r = e.split("?")[0] ?? "/";
 		if (f.name === "voltroDashboard" && r === "/api/dashboard/registry") try {
 			let e = await Ge();
@@ -927,8 +975,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				body: JSON.stringify({ apps: t })
 			};
 		}
-		if (jt !== null && r === "/_voltro/og") {
-			let t = await jt.handle(new URL(e, "http://localhost"));
+		if (X !== null && r === "/_voltro/og") {
+			let t = await X.handle(new URL(e, "http://localhost"));
 			if (t !== null) return {
 				status: t.status,
 				headers: { ...t.headers },
@@ -947,7 +995,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			};
 		}
 		if (r !== "/_voltro/inspect/stream") {
-			let t = ke(e, Ut, n);
+			let t = ke(e, Gt, n);
 			if (t !== null) return {
 				status: t.status,
 				headers: {
@@ -957,7 +1005,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				body: t.body
 			};
 		}
-		let i = At(r, W), a = i ? q.get(i.route.pattern)?.renderMode : void 0, o = a === "ssr" || a === "isr" || (i ? X.has(i.route.pattern) : !1), s = [];
+		let i = Ft(r, W), a = i ? K.get(i.route.pattern)?.renderMode : void 0, o = a === "ssr" || a === "isr" || (i ? q.has(i.route.pattern) : !1), s = [];
 		if (!o && L.length > 0) {
 			let t = ae(L, {
 				route: void 0,
@@ -978,7 +1026,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			...e,
 			"set-cookie": s.map(d)
 		}, u = r === "/" ? R(b, "index.html") : R(b, r.replace(/^\//, ""), "index.html");
-		if (!o && await Z(u)) {
+		if (!o && await Y(u)) {
 			let e = await B.readFile(u);
 			return {
 				status: 200,
@@ -996,18 +1044,18 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		};
 		if (/\.[a-z0-9]+$/i.test(r)) {
 			let e = R(b, r.replace(/^\//, ""));
-			if (await Z(e)) {
+			if (await Y(e)) {
 				let t = $e(r, M), i = at(n["accept-encoding"]), a = i === "br" ? `${e}.br` : i === "gzip" ? `${e}.gz` : void 0;
-				if (a !== void 0 && await Z(a)) {
+				if (a !== void 0 && await Y(a)) {
 					let n = await B.readFile(e);
 					return {
 						status: 200,
 						headers: c({
-							"content-type": Et(e),
+							"content-type": jt(e),
 							"cache-control": t,
 							"content-encoding": i === "br" ? "br" : "gzip",
 							vary: "Accept-Encoding",
-							etag: mt(n)
+							etag: ht(n)
 						}),
 						body: await B.readFile(a)
 					};
@@ -1016,19 +1064,19 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				return {
 					status: 200,
 					headers: c({
-						"content-type": Et(e),
+						"content-type": jt(e),
 						"cache-control": t
 					}),
 					body: o
 				};
 			}
 		}
-		let p = At(r, W);
+		let p = Ft(r, W);
 		if (!p) {
 			let i = ce(U, r);
 			if (i !== void 0) try {
-				let a = await Pt({
-					provider: K,
+				let a = await Rt({
+					provider: G,
 					root: t,
 					route: {
 						pattern: "<not-found>",
@@ -1060,7 +1108,10 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 					body: a.html
 				};
 			} catch (e) {
-				Y.warn("not-found.tsx failed to render — serving the plain 404", { pathname: r }, e instanceof Error ? e : Error(String(e)));
+				J.warn("not-found.tsx failed to render — serving the plain 404", { pathname: r }, e instanceof Error ? e : Error(String(e))), Q?.(e, {
+					stage: "not-found-render",
+					pathname: r
+				});
 			}
 			return {
 				status: 404,
@@ -1071,7 +1122,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				body: "not found"
 			};
 		}
-		let m = q.get(p.route.pattern), te = n["x-tenant"] ?? "anonymous", g = (await K.getHelpers()).i18n?.resolve(n.cookie, n["accept-language"])?.locale, _ = He(r, {
+		let m = K.get(p.route.pattern), te = n["x-tenant"] ?? "anonymous", g = (await G.getHelpers()).i18n?.resolve(n.cookie, n["accept-language"])?.locale, _ = He(r, {
 			...m?.tenantAware ? { tenant: te } : {},
 			...g ? { locale: g } : {}
 		}), v = m?.ppr === !0 && m.renderMode === "isr", y = (i, a) => ({
@@ -1086,14 +1137,14 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 					...a
 				}), o.write(i), (async () => {
 					try {
-						let i = await Pt({
-							provider: K,
+						let i = await Rt({
+							provider: G,
 							root: t,
 							route: p.route,
 							params: p.params,
 							pathname: r,
 							dirs: U,
-							shellTemplate: J.get(p.route.pattern) ?? D,
+							shellTemplate: xt.get(p.route.pattern) ?? D,
 							requestHeaders: n,
 							apiOrigin: N,
 							apiName: P,
@@ -1108,23 +1159,26 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 							res: o,
 							helpers: i.holes.helpers,
 							page: i.holes.page,
-							log: Y
+							log: J
 						}) : o.writableEnded || o.end();
 					} catch (e) {
-						Y.warn("ppr hole pass failed", { url: r }, e), o.writableEnded || o.end();
+						J.warn("ppr hole pass failed", { url: r }, e), Q?.(e, {
+							stage: "ppr-holes",
+							pathname: r
+						}), o.writableEnded || o.end();
 					}
 				})();
 			}
-		}), x = z.get(_), S = Date.now();
-		if (x && Ue(x, S)) return h.emit("cache", {
+		}), x = z.get(_), C = Date.now();
+		if (x && Ue(x, C)) return h.emit("cache", {
 			kind: "HIT",
 			key: _,
-			ageMs: S - x.renderedAt
+			ageMs: C - x.renderedAt
 		}), v ? y(x.html, {
 			"cache-control": Ze(M, x.revalidateMs, x.staleWhileRevalidateMs),
 			"x-voltro-cache": "HIT",
 			"x-voltro-cache-key": _,
-			"x-voltro-cache-age-ms": String(S - x.renderedAt)
+			"x-voltro-cache-age-ms": String(C - x.renderedAt)
 		}) : {
 			status: 200,
 			headers: {
@@ -1133,27 +1187,27 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				"x-voltro-rendered-by": "isr",
 				"x-voltro-cache": "HIT",
 				"x-voltro-cache-key": _,
-				"x-voltro-cache-age-ms": String(S - x.renderedAt)
+				"x-voltro-cache-age-ms": String(C - x.renderedAt)
 			},
 			body: x.html
 		};
-		if (x && Be(x, S)) {
+		if (x && Be(x, C)) {
 			h.emit("cache", {
 				kind: "STALE",
 				key: _,
-				ageMs: S - x.renderedAt
+				ageMs: C - x.renderedAt
 			});
 			let i = z.generation(_);
 			return (async () => {
 				try {
-					let a = await Pt({
-						provider: K,
+					let a = await Rt({
+						provider: G,
 						root: t,
 						route: p.route,
 						params: p.params,
 						pathname: r,
 						dirs: U,
-						shellTemplate: J.get(p.route.pattern) ?? D,
+						shellTemplate: xt.get(p.route.pattern) ?? D,
 						requestHeaders: n,
 						apiOrigin: N,
 						apiName: P,
@@ -1163,7 +1217,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 						buffered: !0
 					});
 					if (a && "html" in a && a.renderMode === "isr" && a.revalidateMs !== null) {
-						let e = q.get(p.route.pattern)?.staleWhileRevalidateMs ?? 0, t = Date.now();
+						let e = K.get(p.route.pattern)?.staleWhileRevalidateMs ?? 0, t = Date.now();
 						z.set(_, {
 							html: a.html,
 							renderedAt: t,
@@ -1171,16 +1225,19 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 							servableUntil: t + a.revalidateMs + e,
 							revalidateMs: a.revalidateMs,
 							staleWhileRevalidateMs: e
-						}, { ifGeneration: i }) || Y.info("SWR refresh discarded — the entry was purged while it rendered", { key: _ });
+						}, { ifGeneration: i }) || J.info("SWR refresh discarded — the entry was purged while it rendered", { key: _ });
 					}
 				} catch (e) {
-					Y.warn("background SWR refresh failed", { url: r }, e);
+					J.warn("background SWR refresh failed", { url: r }, e), Q?.(e, {
+						stage: "swr-refresh",
+						pathname: r
+					});
 				}
 			})(), v ? y(x.html, {
 				"cache-control": Ze(M, x.revalidateMs, x.staleWhileRevalidateMs),
 				"x-voltro-cache": "STALE",
 				"x-voltro-cache-key": _,
-				"x-voltro-cache-age-ms": String(S - x.renderedAt)
+				"x-voltro-cache-age-ms": String(C - x.renderedAt)
 			}) : {
 				status: 200,
 				headers: {
@@ -1189,20 +1246,20 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 					"x-voltro-rendered-by": "isr",
 					"x-voltro-cache": "STALE",
 					"x-voltro-cache-key": _,
-					"x-voltro-cache-age-ms": String(S - x.renderedAt)
+					"x-voltro-cache-age-ms": String(C - x.renderedAt)
 				},
 				body: x.html
 			};
 		}
 		try {
-			let i = z.generation(_), a = await Pt({
-				provider: K,
+			let i = z.generation(_), a = await Rt({
+				provider: G,
 				root: t,
 				route: p.route,
 				params: p.params,
 				pathname: r,
 				dirs: U,
-				shellTemplate: J.get(p.route.pattern) ?? D,
+				shellTemplate: xt.get(p.route.pattern) ?? D,
 				requestHeaders: n,
 				apiOrigin: N,
 				apiName: P,
@@ -1250,7 +1307,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				"x-voltro-rendered-by": a.renderMode
 			});
 			if (a.renderMode === "isr" && a.revalidateMs !== null) {
-				let e = Date.now(), t = q.get(p.route.pattern)?.staleWhileRevalidateMs ?? 0;
+				let e = Date.now(), t = K.get(p.route.pattern)?.staleWhileRevalidateMs ?? 0;
 				z.set(_, {
 					html: a.html,
 					renderedAt: e,
@@ -1258,7 +1315,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 					servableUntil: e + a.revalidateMs + t,
 					revalidateMs: a.revalidateMs,
 					staleWhileRevalidateMs: t
-				}, { ifGeneration: i }) || Y.info("miss fill discarded — the entry was purged while it rendered", { key: _ }), l["x-voltro-cache"] = "MISS", l["x-voltro-cache-key"] = _, l["x-voltro-cache-revalidate-ms"] = String(a.revalidateMs), t > 0 && (l["x-voltro-cache-swr-ms"] = String(t)), h.emit("cache", {
+				}, { ifGeneration: i }) || J.info("miss fill discarded — the entry was purged while it rendered", { key: _ }), l["x-voltro-cache"] = "MISS", l["x-voltro-cache-key"] = _, l["x-voltro-cache-revalidate-ms"] = String(a.revalidateMs), t > 0 && (l["x-voltro-cache-swr-ms"] = String(t)), h.emit("cache", {
 					kind: "MISS",
 					key: _,
 					revalidateMs: a.revalidateMs,
@@ -1277,7 +1334,10 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				body: a.html
 			};
 		} catch (e) {
-			return Y.error("render error", { url: r }, e), ne(e) ? {
+			return J.error("render error", { url: r }, e), Q?.(e, {
+				stage: "render",
+				pathname: r
+			}), S(e) ? {
 				status: 500,
 				headers: {
 					"content-type": "text/plain; charset=utf-8",
@@ -1297,12 +1357,12 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				body: "server error"
 			};
 		}
-	}, Gt = !1, Kt = i(f.health, () => Gt), qt = p({
+	}, qt = !1, Jt = i(f.health, () => qt), Yt = p({
 		apiName: P,
 		apiOrigin: N,
 		loadDescriptors: async () => {
 			if (P === void 0) return;
-			let e = (await K.getHelpers()).apiDescriptors?.[P];
+			let e = (await G.getHelpers()).apiDescriptors?.[P];
 			return e === void 0 ? void 0 : await e();
 		},
 		rpcQuery: (e, t) => xe(N, e, {
@@ -1310,14 +1370,14 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			headers: t
 		}),
 		resolveLocale: async (e, t) => {
-			let n = await K.getHelpers(), r = u(t, n.i18n?.locales);
+			let n = await G.getHelpers(), r = u(t, n.i18n?.locales);
 			return r === void 0 ? n.i18n?.resolve(e.cookie, e["accept-language"])?.locale ?? "en" : r;
 		},
 		renderErrorPage: async ({ path: e, headers: n, flash: r }) => {
-			let { pathname: i } = be(e), a = At(i, W);
+			let { pathname: i } = be(e), a = Ft(i, W);
 			if (!a) return;
-			let o = await Pt({
-				provider: K,
+			let o = await Rt({
+				provider: G,
 				root: t,
 				route: a.route,
 				params: a.params,
@@ -1335,19 +1395,19 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			});
 			return o !== null && "html" in o ? o.html : void 0;
 		}
-	}), Jt = ot(f), Yt = ut(async (e, t) => {
+	}), Xt = ot(f), Zt = dt(async (e, t) => {
 		let n = e.url ?? "/", i = Date.now(), a = {};
 		for (let [t, n] of Object.entries(e.headers)) n !== void 0 && (a[t.toLowerCase()] = Array.isArray(n) ? n.join(", ") : n);
-		let o = n.split("?")[0] ?? "/", s = (e.method ?? "GET").toUpperCase(), c = he(Kt, o);
+		let o = n.split("?")[0] ?? "/", s = (e.method ?? "GET").toUpperCase(), c = he(Jt, o);
 		if (c !== void 0) {
-			let e = await y(Kt, c);
+			let e = await y(Jt, c);
 			t.writeHead(e.status, {
 				"content-type": "text/plain",
 				"cache-control": "no-store"
 			}), t.end(e.body);
 			return;
 		}
-		if (!(o.startsWith(x) && await qt(e, t))) {
+		if (!(o.startsWith(x) && await Yt(e, t))) {
 			if (s === "OPTIONS" && o.startsWith("/_voltro/inspect")) {
 				let e = Oe(a.origin);
 				t.writeHead(204, e), t.end();
@@ -1475,8 +1535,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				return;
 			}
 			try {
-				let e = await Wt(n, a);
-				if (e.stream ? e.stream(t) : ht({
+				let e = await Kt(n, a);
+				if (e.stream ? e.stream(t) : gt({
 					response: t,
 					status: e.status,
 					headers: e.headers,
@@ -1492,8 +1552,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 						renderedBy: e.headers["x-voltro-rendered-by"],
 						cache: e.headers["x-voltro-cache"]
 					});
-					let n = At(o, W)?.route.pattern ?? (e.status === 404 ? "<unmatched>" : "<asset>");
-					zt.record({
+					let n = Ft(o, W)?.route.pattern ?? (e.status === 404 ? "<unmatched>" : "<asset>");
+					Vt.record({
 						kind: "request",
 						tag: n,
 						durationMs: t,
@@ -1505,10 +1565,10 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			}
 		}
 	});
-	await new Promise((e) => Yt.listen(_, "::", e)), Gt = !0, n.mark("ready"), it(Yt, Jt), Y.info(`listening on http://localhost:${_}`, {
+	await new Promise((e) => Zt.listen(_, "::", e)), qt = !0, n.mark("ready"), it(Zt, Xt), J.info(`listening on http://localhost:${_}`, {
 		port: _,
 		distDir: b
-	}), Y.debug("dynamic + ssr/isr routes resolve via SSR loader");
+	}), J.debug("dynamic + ssr/isr routes resolve via SSR loader");
 	try {
 		await We({
 			id: T,
@@ -1522,7 +1582,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		let e = Se(t);
 		if (e) {
 			let t = await ye({ dashboardAppPath: e });
-			t.status === "launched" ? Y.info(`dashboard launched at http://localhost:${t.port}`, { port: t.port }) : t.status === "already-running" && Y.debug(`dashboard already running on :${t.port}`, { port: t.port });
+			t.status === "launched" ? J.info(`dashboard launched at http://localhost:${t.port}`, { port: t.port }) : t.status === "already-running" && J.debug(`dashboard already running on :${t.port}`, { port: t.port });
 		}
 		setInterval(() => {
 			We({
@@ -1536,7 +1596,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			}).catch(() => {});
 		}, 1e4).unref();
 	} catch (e) {
-		Y.warn("runtime-registry write failed", {}, e);
+		J.warn("runtime-registry write failed", {}, e);
 	}
 	et({
 		app: f.name ?? "unnamed",
@@ -1544,38 +1604,38 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		url: `http://localhost:${_}`,
 		bootMs: n.total()
 	});
-	let Xt = n.phaseBreakdown();
-	Y.info(`start: ready in ${n.total()}ms`, {
+	let Qt = n.phaseBreakdown();
+	J.info(`start: ready in ${n.total()}ms`, {
 		bootMs: n.total(),
-		...Xt ? { phases: Xt } : {}
+		...Qt ? { phases: Qt } : {}
 	});
-	let Zt = !1, Qt = (e) => async () => {
-		if (!Zt) {
-			if (Zt = !0, Y.info(`received ${e}, shutting down`, { signal: e }), Yt.close(), await Q.stop(), $) try {
-				$();
+	let $t = !1, en = (e) => async () => {
+		if (!$t) {
+			if ($t = !0, J.info(`received ${e}, shutting down`, { signal: e }), Zt.close(), await It.stop(), Z) try {
+				Z();
 			} catch {}
-			if (Rt) try {
-				await ct.runPromise(Rt.close());
+			if ($) try {
+				await ct.runPromise($.close());
 			} catch {}
 			if (V) try {
 				await V.end();
 			} catch {}
-			await K.close(), await Ke(T), await E.dispose(), process.exit(0);
+			await G.close(), await Ke(T), await E.dispose(), process.exit(0);
 		}
 	};
-	process.on("SIGINT", Qt("SIGINT")), process.on("SIGTERM", Qt("SIGTERM"));
-	let $t = process.ppid;
-	if ($t > 1) {
+	process.on("SIGINT", en("SIGINT")), process.on("SIGTERM", en("SIGTERM"));
+	let tn = process.ppid;
+	if (tn > 1) {
 		let e = setInterval(() => {
-			(process.ppid !== $t || process.ppid === 1) && (clearInterval(e), Qt("SIGTERM")());
+			(process.ppid !== tn || process.ppid === 1) && (clearInterval(e), en("SIGTERM")());
 		}, 2e3);
 		e.unref();
 	}
 	return new Promise(() => {});
-}, $ = async (e) => {
+}, Vt = async (e) => {
 	rt("start"), t("start");
-	let n = e.find((e) => !e.startsWith("-")) ?? process.cwd(), r = await Lt(z(n));
-	return r.ran ? r.exitCode : (Y.error("no web app found at this path"), 1);
+	let n = e.find((e) => !e.startsWith("-")) ?? process.cwd(), r = await $(z(n));
+	return r.ran ? r.exitCode : (J.error("no web app found at this path"), 1);
 };
 //#endregion
-export { Lt as n, $ as t };
+export { $ as n, Vt as t };