@voltro/cli 0.36.0 → 0.38.0

package/dist/serveEntry.js

@@ -1,5 +1,5 @@
 import { t as e } from "./loadEnv-D9nEOClM.js";
 import { r as t } from "./appModuleLoader-C9r9mxZt.js";
 import { i as n } from "./dialectDriver-CgXnDfec.js";
-import { t as r } from "./serveCommand-VVGcIMIw.js";
+import { t as r } from "./serveCommand-DnY4VS3D.js";
 export { e as loadDotEnv, t as registerAppModules, n as registerDriver, r as runServe };

package/dist/{start-BgN62boB.js → start-CidwCcjl.js}

@@ -1,3 +1,3 @@
 import "./renderModeScan-D7J1B7Kw.js";
-import { t as e } from "./start-T4VesWiM.js";
+import { t as e } from "./start-RCh6qKFe.js";
 export { e as runStartCommand };

package/dist/{start-T4VesWiM.js → start-RCh6qKFe.js}

@@ -1,6 +1,6 @@
 import { i as e, t } from "./nodeEnvironment-cGFAj1J8.js";
 import { r as n } from "./appPort-B_HpJ_ck.js";
-import { A as r, B as i, C as a, D as o, E as s, H as c, I as l, J as u, N as d, O as f, P as p, S as m, T as ee, U as h, V as g, a as _, b as v, d as y, f as b, i as x, j as S, k as te, n as ne, q as C, s as re, st as ie, ut as w, w as T, x as E, y as ae, z as D } from "./webDev-Dybxew86.js";
+import { A as r, B as i, C as a, D as o, E as s, H as c, I as l, J as u, N as d, O as f, P as p, S as m, T as ee, U as h, V as g, a as _, b as v, d as y, f as b, i as x, j as S, k as te, lt as C, n as w, ot as ne, q as T, s as re, w as E, x as ie, y as ae, z as D } from "./webDev-BKdD7c_a.js";
 import { o as O, t as k } from "./connectionConfig-UFlIEiys.js";
 import { A, D as j, a as M, h as oe, j as N, k as se } from "./inspect-CjTYzAs_.js";
 import { a as ce, c as P, d as le, f as ue, l as F, p as I, u as de } from "./renderModeScan-D7J1B7Kw.js";
@@ -210,10 +210,10 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 }, Ne = async (e) => {
 	let { provider: t, route: n, params: i, pathname: c, dirs: l, shellTemplate: u, requestHeaders: d, requestUrl: p = "", apiOrigin: ee, apiName: h } = e, { search: g } = r(p), v = x(ee, d.cookie, { apiName: h }), y = await t.getPage(n.pattern, n.file), b = P(y, n.file), S = b === "spa" && re(l, n.dirChain).some((e) => e.hasLayout);
 	if (b !== "ssr" && b !== "isr" && !S) return null;
-	let ne = re(l, n.dirChain), C = {}, ie = null, w, ae = new AbortController();
+	let C = re(l, n.dirChain), w = {}, ne = null, T, ae = new AbortController();
 	try {
-		(await t.getHelpers()).beginStoreSeeds(), {chain: w, segmentLoaderData: C} = await _({
-			entries: ne,
+		(await t.getHelpers()).beginStoreSeeds(), {chain: T, segmentLoaderData: w} = await _({
+			entries: C,
 			loadLayout: (e) => t.getLayout(e.dir),
 			loadError: (e) => t.getError(e.dir),
 			loadPending: (e) => t.getPending(e.dir),
@@ -225,7 +225,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				headers: d,
 				query: v
 			}
-		}), typeof y.loader == "function" && !S && (ie = await y.loader({
+		}), typeof y.loader == "function" && !S && (ne = await y.loader({
 			params: i,
 			pathname: c,
 			search: g,
@@ -243,7 +243,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		throw e;
 	}
 	let D = await t.getHelpers();
-	S || await E({
+	S || await ie({
 		pageMod: y,
 		params: i,
 		query: v,
@@ -263,7 +263,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		ErrorBoundary: y.ErrorBoundary,
 		Pending: y.Pending,
 		renderMode: b,
-		chain: w
+		chain: T
 	}, k = {
 		cookies: D.parseCookieHeader(d.cookie),
 		headers: d,
@@ -280,7 +280,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 				params: i,
 				pathname: c,
 				search: g,
-				segmentLoaderData: C,
+				segmentLoaderData: w,
 				requestContext: k,
 				...A ? {
 					outerWrap: A.outerWrap,
@@ -297,7 +297,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			let n = a({ shell: u });
 			return {
 				renderMode: "spa",
-				stream: (i) => T({
+				stream: (i) => E({
 					res: i,
 					shell: n,
 					htmlLang: t,
@@ -332,8 +332,8 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		pathname: c,
 		renderMode: b,
 		interactive: j,
-		loaderData: ie,
-		segmentLoaderData: C,
+		loaderData: ne,
+		segmentLoaderData: w,
 		pageLoaderRan: typeof y.loader == "function"
 	}), oe = {
 		descriptor: O,
@@ -357,7 +357,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		let e = A?.locale ?? k.cookies["voltro:locale"] ?? "en", t = a({ shell: u });
 		return {
 			renderMode: "ssr",
-			stream: (n) => T({
+			stream: (n) => E({
 				res: n,
 				shell: t,
 				htmlLang: e,
@@ -415,7 +415,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		async close() {}
 	};
 }, Fe = async (e, t) => {
-	let n = await w("vite", () => import("vite")), r = (await import("@vitejs/plugin-react")).default, i = (await import("@tailwindcss/vite")).default, a = await n.createServer({
+	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()],
@@ -432,7 +432,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		},
 		appType: "custom",
 		logLevel: "warn"
-	}), o = L(e, "src", "pages"), s = (e) => e === "" ? o : L(o, e), c = C({
+	}), o = L(e, "src", "pages"), s = (e) => e === "" ? o : L(o, e), c = T({
 		limit: u(),
 		onColdStart: (e) => q.debug("ssr cold-compile start", { id: e }),
 		onColdEnd: (e, { durationMs: t, failed: n }) => q.debug(`ssr cold-compile ${n ? "FAILED" : "end"} ${t}ms`, {
@@ -472,7 +472,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		ran: !0,
 		exitCode: 1
 	};
-	let { resolved: o } = await ie({
+	let { resolved: o } = await ne({
 		rawEnv: a.env,
 		appType: "web",
 		root: t,
@@ -494,17 +494,17 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		ran: !0,
 		exitCode: 1
 	};
-	let C = a.name ?? "unnamed", w = he("web", C, m), T = ge(C);
+	let C = a.name ?? "unnamed", T = he("web", C, m), E = ge(C);
 	await fe({
-		id: w,
+		id: T,
 		name: C,
 		kind: "web",
 		url: `http://localhost:${m}`,
 		pid: process.pid,
 		status: "booting",
-		logFile: T.path
+		logFile: E.path
 	}).catch(() => {});
-	let E = L(x, "_voltro", "shell.html"), P = await Z(E) ? await z.readFile(E, "utf8") : await z.readFile(te, "utf8"), I = await b(t, a), ye = ne(I[0]), be = I[0]?.name, R, B = null, xe = process.env.SSR_CACHE === "postgres";
+	let ie = L(x, "_voltro", "shell.html"), P = await Z(ie) ? await z.readFile(ie, "utf8") : await z.readFile(te, "utf8"), I = await b(t, a), ye = w(I[0]), be = I[0]?.name, R, B = null, xe = process.env.SSR_CACHE === "postgres";
 	if (xe && k()) B = new (await (import("pg"))).default.Client(O()), await B.connect(), R = De({ client: B }), q.info("isr cache backend: postgres", { table: "voltro_isr_cache" });
 	else if (xe) {
 		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).";
@@ -1023,13 +1023,13 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 	}), q.debug("dynamic + ssr/isr routes resolve via SSR loader");
 	try {
 		await fe({
-			id: w,
+			id: T,
 			name: C,
 			kind: "web",
 			url: `http://localhost:${m}`,
 			pid: process.pid,
 			status: "live",
-			logFile: T.path
+			logFile: E.path
 		});
 		let e = p(t);
 		if (e) {
@@ -1038,13 +1038,13 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 		}
 		setInterval(() => {
 			fe({
-				id: w,
+				id: T,
 				name: C,
 				kind: "web",
 				url: `http://localhost:${m}`,
 				pid: process.pid,
 				status: "live",
-				logFile: T.path
+				logFile: E.path
 			}).catch(() => {});
 		}, 1e4).unref();
 	} catch (e) {
@@ -1066,7 +1066,7 @@ CREATE INDEX IF NOT EXISTS ${e}_servable_until_idx ON ${e} (servable_until);
 			if (Ge = !0, q.info(`received ${e}, shutting down`, { signal: e }), Ue.close(), await $.stop(), B) try {
 				await B.end();
 			} catch {}
-			await K.close(), await me(w), await T.dispose(), process.exit(0);
+			await K.close(), await me(T), await E.dispose(), process.exit(0);
 		}
 	};
 	process.on("SIGINT", Ke("SIGINT")), process.on("SIGTERM", Ke("SIGTERM"));

package/dist/startEntry.js

@@ -1,3 +1,3 @@
 import { t as e } from "./loadEnv-D9nEOClM.js";
-import { t } from "./start-T4VesWiM.js";
+import { t } from "./start-RCh6qKFe.js";
 export { e as loadDotEnv, t as runStartCommand };

package/dist/startup.d.ts

@@ -3,6 +3,35 @@ import { StartupContext } from '@voltro/runtime';
 import { StartupFn } from '@voltro/runtime';
 import { SyncLogger } from '@voltro/logger';
 
+/**
+ * How long a startup may run before the boot refuses it.
+ *
+ * ── Why there is a ceiling at all, and why it used to be 2 seconds ─────────
+ *
+ * The old value was 2000 ms and it was not a ceiling — it was a RACE the boot
+ * always won. A startup slower than that was reported as fine and the boot
+ * moved on, so a rejection arriving afterwards had nothing left to refuse.
+ *
+ * That race existed to protect one shape: a startup that never returns because
+ * it holds a fiber until shutdown. Counted before changing it, that shape
+ * appears in ZERO of the four startups this framework ships — `warm.startup.tsx`
+ * (twice), `searchBackfill.startup.tsx` and the memory fixture's all return.
+ * `warm` is the one to copy: it starts an interval, hands the teardown back
+ * through `onShutdown`, and returns.
+ *
+ * So the race protected the shape we discourage and penalised the shape we
+ * teach — and the penalised one includes `searchBackfill`, our own example,
+ * which awaits a full-table query plus an index backfill and is the likeliest
+ * thing in the box to exceed two seconds. Slow AND failing put a consumer back
+ * in exactly the silent state this file was fixed for.
+ *
+ * 60 seconds because the number now has one job: turn "hangs forever" into
+ * something diagnosable. It must never fire for honest work, and a boot that
+ * refuses after a minute with a message naming the file beats one that waits
+ * for a fiber that is never coming.
+ */
+export declare const DEFAULT_STARTUP_TIMEOUT_MS = 60000;
+
 export declare interface DiscoveredStartup {
     readonly file: string;
     readonly id: string;
@@ -13,7 +42,7 @@ export declare const loadStartupFiles: (files: ReadonlyArray<string>, log: SyncL
 
 /** Run every discovered startup. Returns a handle whose `shutdown()`
  *  drains every registered teardown LIFO. */
-export declare const runStartups: (startups: ReadonlyArray<DiscoveredStartup>, store: DataStore, parentLog: SyncLogger) => Promise<StartupHandle>;
+export declare const runStartups: (startups: ReadonlyArray<DiscoveredStartup>, store: DataStore, parentLog: SyncLogger, ceilingMs?: number) => Promise<StartupHandle>;
 
 export { StartupContext }
 
@@ -23,4 +52,14 @@ export declare interface StartupHandle {
     readonly shutdown: () => Promise<void>;
 }
 
+/**
+ * The ceiling, from `VOLTRO_STARTUP_TIMEOUT_MS`.
+ *
+ * An app with a genuinely long backfill raises it; the env var is the whole
+ * knob, and the refusal names it so nobody has to find this constant. Not an
+ * `app.config.ts` field: this is an operational safety limit, not a design
+ * choice about the app, and the parameter below is the seam if that changes.
+ */
+export declare const startupTimeoutMsFromEnv: (envValue: string | undefined) => number;
+
 export { }

package/dist/startup.js

@@ -1,2 +1,2 @@
-import { n as e, t } from "./startupRunner-DPGFchOa.js";
-export { t as loadStartupFiles, e as runStartups };
+import { i as e, n as t, r as n, t as r } from "./startupRunner-CEqQq7ax.js";
+export { r as DEFAULT_STARTUP_TIMEOUT_MS, t as loadStartupFiles, n as runStartups, e as startupTimeoutMsFromEnv };

package/dist/startupRunner-CEqQq7ax.js

@@ -0,0 +1,108 @@
+import { n as e } from "./appModuleLoader-C9r9mxZt.js";
+import { t } from "./bootRefusal-pgvDxlrU.js";
+import { basename as n } from "node:path";
+import { publishServerError as r } from "@voltro/protocol";
+//#region src/startupRunner.ts
+var i = (e) => e.replace(/\.startup\.tsx?$/, ""), a = async (r, a) => {
+	let o = [];
+	for (let a of r) {
+		let r;
+		try {
+			r = await e(a);
+		} catch (e) {
+			throw t(`startup file \`${a}\` could not be imported — refusing to boot.\n  cause: ${e instanceof Error ? e.message : String(e)}\n
+It was discovered as a startup, so whatever it registers is missing from this process. Skipping it would leave a server that looks healthy.`);
+		}
+		let s = r.default;
+		if (typeof s != "function") throw t(`startup file \`${a}\` has no default-exported function — refusing to boot.\n
+The convention is a DEFAULT-exported function, not a \`defineX\` wrapper:
+
+    export default async (ctx) => { /* register here */ }
+
+A named export is discovered and never runs, which is indistinguishable from a startup that ran and did nothing.`);
+		o.push({
+			file: a,
+			id: i(n(a)),
+			fn: s
+		});
+	}
+	return o;
+}, o = 6e4, s = (e) => {
+	let t = Number(e);
+	return Number.isFinite(t) && t > 0 ? t : o;
+}, c = async (e, n, i, a = s(process.env.VOLTRO_STARTUP_TIMEOUT_MS)) => {
+	let o = [];
+	for (let s of e) {
+		let e = i.child(`startup:${s.id}`), c = {
+			store: n,
+			log: e,
+			id: s.id,
+			onShutdown: (e) => {
+				o.push({
+					id: s.id,
+					cb: e
+				});
+			}
+		}, l, u = !1;
+		try {
+			let e = s.fn(c);
+			if (e instanceof Promise) {
+				let t, n = new Promise((e) => {
+					t = setTimeout(() => e("timeout"), a);
+				});
+				try {
+					u = await Promise.race([e.then(() => "done", (e) => (l = e, r({
+						error: e,
+						source: "startup",
+						name: s.id
+					}), "done")), n]) === "timeout";
+				} finally {
+					t !== void 0 && clearTimeout(t);
+				}
+			}
+		} catch (e) {
+			l = e, r({
+				error: e,
+				source: "startup",
+				name: s.id
+			});
+		}
+		if (l !== void 0) throw e.error("startup: failed", { file: s.file }, l), t(`startup \`${s.id}\` failed — refusing to boot.\n  file: ${s.file}\n  cause: ${l instanceof Error ? l.message : String(l)}\n
+A startup is where an app REGISTERS things the request path depends on (\`setRowFilter\` is the one that matters most). Continuing past a failed one produces a server that looks healthy and is missing whatever the startup was there to install — which is why this used to be a warning and is now a refusal.
+
+If this failure IS acceptable, catch it inside the startup function itself, where the decision is visible to a reviewer.`);
+		if (u) throw e.error("startup: never returned", {
+			file: s.file,
+			ceilingMs: a
+		}), t(`startup \`${s.id}\` did not return within ${a}ms — refusing to boot.\n  file: ${s.file}\n
+A startup must START its work and RETURN. Hand the teardown back through
+\`onShutdown\` instead of awaiting forever:
+
+    export default async ({ store, log, onShutdown }) => {
+      const timer = setInterval(() => sync(store), 60_000)
+      onShutdown(() => clearInterval(timer))
+    }
+
+Awaiting a fiber that resolves only on shutdown used to be allowed, and it
+is what made a slow startup that then FAILED unreportable — the boot had
+already moved on, so nothing was left to refuse.
+
+If this startup is legitimately slower than ${a}ms, raise\nVOLTRO_STARTUP_TIMEOUT_MS — or, better, do the registration first and the
+long work after, so a failure in the long half cannot hide a missing
+registration.`);
+		e.info("startup: registered");
+	}
+	return { shutdown: async () => {
+		for (let e = o.length - 1; e >= 0; e--) {
+			let { id: t, cb: n } = o[e], r = i.child(`startup:${t}`);
+			try {
+				let e = n();
+				e instanceof Promise && await Promise.race([e, new Promise((e) => setTimeout(e, 5e3))]);
+			} catch (e) {
+				r.warn("startup: teardown threw", {}, e);
+			}
+		}
+	} };
+};
+//#endregion
+export { s as i, a as n, c as r, o as t };

package/dist/subcommandNames-CKG5Dz3a.js

@@ -0,0 +1,27 @@
+//#region src/subcommandNames.ts
+var e = [
+	"plan",
+	"apply",
+	"branch",
+	"plans",
+	"drift",
+	"squash",
+	"restore-snapshot",
+	"generate",
+	"migrate",
+	"rollback",
+	"status",
+	"files",
+	"rollback-file",
+	"seed",
+	"gc-snapshots",
+	"adopt",
+	"scan-credentials",
+	"encrypt-column"
+], t = [
+	"scope",
+	"export",
+	"erase"
+], n = (e) => `<${e.join("|")}>`;
+//#endregion
+export { t as n, n as r, e as t };

package/dist/{templates-De8IR5-c.js → templates-BR-fb4SP.js}

@@ -4,10 +4,7 @@ import { fileURLToPath as s } from "node:url";
 //#region src/templates.ts
 var c = e(s(import.meta.url)), l = (() => {
 	let n = process.env.VOLTRO_TEMPLATES_DIR;
-	if (n) {
-		let e = t(n, "apps");
-		if (i(e)) return e;
-	}
+	if (n) return t(n, "apps");
 	let a = r(c, "..", "templates", "apps"), o = c;
 	for (let n = 0; n < 12; n++) {
 		for (let e of ["voltro-templates", ".voltro-templates"]) {

package/dist/{test-CI6iDsYc.js → test-DIQ0jlkQ.js}

@@ -79,7 +79,7 @@ var d = l({ scope: "voltro:test" }), f = (e) => {
 }, C = async (e) => {
 	let t = m(e);
 	if (!o(t.root)) return console.error(`voltro test: no such directory: ${t.root}`), 1;
-	let { checkRpcGroupFreshness: n } = await import("./codegen-ChBi_hVa.js"), r = await n(t.root);
+	let { checkRpcGroupFreshness: n } = await import("./codegen-uYrrDzQv.js"), r = await n(t.root);
 	if (r.kind === "stale") return console.error(`voltro test: ${r.file} is stale — ${r.reason}.`), console.error("  The tests would run against the previously generated procedure group, pass, and prove nothing about the descriptors you just edited.\n  Run `voltro codegen` (or boot `voltro dev` once) and try again."), 1;
 	d.info("running vitest", {
 		root: t.root,

package/dist/updateCommand-B0J_T9Vs.js

@@ -0,0 +1,2 @@
+import { f as e, p as t } from "./updateCommand-CmksX7m_.js";
+export { e as runApplyCodemods, t as runUpdateCommand };

package/dist/{updateCommand-CwnUK_mf.js → updateCommand-CmksX7m_.js}

@@ -1,4 +1,4 @@
-import { n as e, r as t, t as n } from "./codemodRunner-DjQGrdmg.js";
+import { n as e, r as t, t as n } from "./codemodRunner-CXgQ-ecJ.js";
 import { basename as r, dirname as i, join as a, relative as o, resolve as s } from "node:path";
 import { existsSync as c, readFileSync as l, readdirSync as u, statSync as d, writeFileSync as f } from "node:fs";
 import { totalmem as p } from "node:os";