@voltro/cli 0.33.0 → 0.35.0

package/dist/renderModeScan-D7J1B7Kw.js

@@ -0,0 +1,105 @@
+import { join as e } from "node:path";
+import { readFile as t } from "node:fs/promises";
+//#region src/isrCache.ts
+var n = () => {
+	let e = /* @__PURE__ */ new Map();
+	return {
+		get(t) {
+			return e.get(t);
+		},
+		set(t, n) {
+			e.set(t, n);
+		},
+		invalidate(t) {
+			e.delete(t);
+		},
+		invalidateBy(t) {
+			let n = 0;
+			for (let r of e.keys()) t(r) && (e.delete(r), n++);
+			return n;
+		},
+		clear() {
+			e.clear();
+		},
+		size() {
+			return e.size;
+		},
+		snapshot() {
+			return Array.from(e.entries());
+		}
+	};
+}, r = (e) => {
+	if (typeof e == "number" && Number.isFinite(e) && e > 0) return e * 1e3;
+	if (typeof e != "string") return null;
+	let t = /^\s*(\d+)\s*(s|seconds?|m|minutes?|h|hours?|d|days?)\s*$/i.exec(e);
+	if (!t) return null;
+	let n = parseInt(t[1], 10);
+	if (!Number.isFinite(n) || n <= 0) return null;
+	let r = t[2].toLowerCase();
+	return r === "s" || r.startsWith("second") ? n * 1e3 : r === "m" || r.startsWith("minute") ? n * 6e4 : r === "h" || r.startsWith("hour") ? n * 36e5 : r === "d" || r.startsWith("day") ? n * 864e5 : null;
+}, i = (e, t = {}) => {
+	let n = [e];
+	return t.tenant !== void 0 && t.tenant !== "" && n.push(`tenant=${t.tenant}`), t.locale !== void 0 && t.locale !== "" && n.push(`lang=${t.locale}`), n.join("|");
+}, a = (e, t) => e.expiresAt > t, o = (e, t) => e.expiresAt <= t && e.servableUntil > t, s = [
+	"static",
+	"spa",
+	"ssr",
+	"isr"
+], c = (e) => typeof e == "string" && s.includes(e), l = s.map((e) => `'${e}'`).join(" | "), u = (e, t) => `[voltro] ${e}: unknown renderMode '${t}'.\n  Valid values: ${l}.${t === "client" || t === "csr" || t === "browser" ? "\n  A page that renders only in the browser is 'spa': it is skipped by the prerender and mounts on the client. If its route has a layout, that layout still renders server-side as an SSR shell." : t === "server" || t === "dynamic" ? "\n  A page rendered per request is 'ssr'." : t === "ssg" || t === "prerender" ? "\n  A page rendered once at build time is 'static' (the default)." : ""}`, d = class extends Error {
+	page;
+	value;
+	name = "InvalidRenderModeError";
+	constructor(e, t) {
+		super(u(e, t)), this.page = e, this.value = t;
+	}
+}, f = (e, t = "<page>") => {
+	if (e.renderMode !== void 0 && e.renderMode !== null) {
+		if (!c(e.renderMode)) throw new d(t, String(e.renderMode));
+		return e.renderMode;
+	}
+	return e.dynamic === "force-dynamic" ? "ssr" : (e.dynamic, "static");
+}, p = (e, t = "<page>") => ({
+	renderMode: f(e, t),
+	tenantAware: e.tenantAware === !0,
+	revalidateMs: r(e.revalidate),
+	staleWhileRevalidateMs: r(e.staleWhileRevalidate) ?? 0,
+	cacheInvalidatesOn: Array.isArray(e.cacheInvalidatesOn) ? e.cacheInvalidatesOn : [],
+	interactive: e.interactive ?? "full",
+	hasLoader: typeof e.loader == "function",
+	hasMeta: e.meta != null,
+	hasGetStaticPaths: typeof e.getStaticPaths == "function"
+}), m = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, h = (e) => m.exec(e)?.[1] ?? null, g = /export\s*\{([^}]*)\}\s*from\s*['"]([^'"]+)['"]/g, _ = (e) => {
+	g.lastIndex = 0;
+	let t;
+	for (; (t = g.exec(e)) !== null;) {
+		let e = t[2];
+		if (e.startsWith(".")) for (let n of t[1].split(",")) {
+			let t = n.lastIndexOf(" as ");
+			if ((t === -1 ? n : n.slice(t + 4)).trim() === "renderMode") return e;
+		}
+	}
+	return null;
+}, v = /export\s*\{([^}]*)\}/g, y = (e) => {
+	if (/export\s+default\b/.test(e)) return !0;
+	v.lastIndex = 0;
+	let t;
+	for (; (t = v.exec(e)) !== null;) for (let e of t[1].split(",")) {
+		let t = e.lastIndexOf(" as ");
+		if ((t === -1 ? e : e.slice(t + 4)).trim() === "default") return !0;
+	}
+	return !1;
+}, b = async (n, r) => {
+	let i = (await Promise.all(r.map(async (r) => {
+		let i;
+		try {
+			i = await t(e(n, r.file), "utf8");
+		} catch {
+			return null;
+		}
+		let a = h(i);
+		return a !== null && !c(a) ? u(e("src", "pages", r.file), a) : y(i) ? null : `${e("src", "pages", r.file)} is a route (a \`page.tsx\` under src/pages/) but exports no default.\n\n  A page's default export IS its component — the router has nothing to render without it,\n  and the failure would otherwise surface only in \`voltro build\`'s prerender as\n  "SSR received a descriptor with no Component", long after the file was written.\n\n  Fix: \`export default function Page() { … }\`, or re-export another page's component\n  (\`export { default } from '../page'\`). If this file is NOT a route, rename it —\n  only the reserved names route, and anything else under src/pages/ is ordinary code\n  that may live beside the page that uses it.`;
+	}))).filter((e) => e !== null);
+	if (i.length !== 0) throw Error(i.join("\n\n"));
+};
+//#endregion
+export { p as a, f as c, o as d, n as f, s as i, i as l, h as n, c as o, r as p, _ as r, u as s, b as t, a as u };

package/dist/renderProfile-1OWWAAtx.js

@@ -0,0 +1,81 @@
+import { m as e } from "./fileConventions-Cof68_BL.js";
+import { i as t, n, o as r, r as i, s as a } from "./renderModeScan-D7J1B7Kw.js";
+import { dirname as o, join as s, relative as c, resolve as l } from "node:path";
+import { Effect as u } from "effect";
+import { readFile as d, readdir as f } from "node:fs/promises";
+//#region src/static/renderProfile.ts
+var p = /* @__PURE__ */ new Set([
+	"node_modules",
+	"dist",
+	"build",
+	".turbo",
+	".vite",
+	".framework",
+	".git"
+]), m = /export\s+const\s+dynamic\s*=\s*['"]force-(dynamic|static)['"]/, h = /export\s+(?:const|async\s+function|function)\s+getStaticPaths\b/, g = 5, _ = async (e) => {
+	for (let t of [
+		e,
+		`${e}.tsx`,
+		`${e}.ts`,
+		s(e, "index.tsx"),
+		s(e, "index.ts")
+	]) if (/\.[jt]sx?$/.test(t)) try {
+		return {
+			src: await d(t, "utf8"),
+			path: t
+		};
+	} catch {}
+	return null;
+}, v = async (e, t, s) => {
+	let c = e, u = t, d = s;
+	for (let e = 0; e <= g; e++) {
+		let e = n(c);
+		if (e !== null) {
+			if (!r(e)) throw Error(a(u, e));
+			return e;
+		}
+		let t = m.exec(c);
+		if (t) return t[1] === "dynamic" ? "ssr" : "static";
+		let s = i(c);
+		if (s === null) return "static";
+		let f = await _(l(o(d), s));
+		if (f === null) return "static";
+		c = f.src, u = f.path, d = f.path;
+	}
+	return "static";
+}, y = async (n) => {
+	let r = s(n, "src", "pages"), i = [], a = async (t) => {
+		let n;
+		try {
+			n = await f(t, { withFileTypes: !0 });
+		} catch {
+			return;
+		}
+		for (let o of n) {
+			if (p.has(o.name)) continue;
+			let n = s(t, o.name);
+			if (o.isDirectory()) await a(n);
+			else if (o.isFile() && e.test(o.name)) {
+				let e = c(r, n), t = await d(n, "utf8");
+				i.push({
+					file: e,
+					mode: await v(t, s("src", "pages", e), n),
+					dynamic: e.includes("["),
+					hasStaticPaths: h.test(t)
+				});
+			}
+		}
+	};
+	await a(r);
+	let o = Object.fromEntries(t.map((e) => [e, 0]));
+	for (let e of i) o[e.mode]++;
+	let l = i.filter((e) => e.mode === "static" && e.dynamic && !e.hasStaticPaths).map((e) => e.file);
+	return {
+		pages: i,
+		counts: o,
+		dynamicMissing: l,
+		staticSafe: o.ssr === 0 && o.isr === 0 && l.length === 0
+	};
+}, b = (e) => u.promise(() => y(e));
+//#endregion
+export { y as n, b as t };

package/dist/runtimeRegistry-DMeKfTHP.js

@@ -0,0 +1,81 @@
+import { join as e } from "node:path";
+import { promises as t } from "node:fs";
+import { homedir as n } from "node:os";
+//#region src/runtimeRegistry.ts
+var r = e(n(), ".voltro"), i = e(r, "runtime-registry.json"), a = 3e4, o = () => {
+	let e = Math.random().toString(36).slice(2, 10);
+	return `${i}.${process.pid}.${Date.now()}.${e}.tmp`;
+}, s = async () => {
+	await t.mkdir(r, { recursive: !0 });
+}, c = async () => {
+	try {
+		let e = await t.readFile(i, "utf8"), n = JSON.parse(e);
+		return n.version !== 1 || !Array.isArray(n.apps) ? {
+			version: 1,
+			apps: []
+		} : n;
+	} catch {
+		return {
+			version: 1,
+			apps: []
+		};
+	}
+}, l = async (e) => {
+	await s();
+	let n = o();
+	try {
+		await t.writeFile(n, JSON.stringify(e, null, 2), {
+			encoding: "utf8",
+			mode: 384
+		}), await t.rename(n, i), await t.chmod(i, 384).catch(() => {});
+	} catch (e) {
+		try {
+			await t.unlink(n);
+		} catch {}
+		throw e;
+	}
+}, u = (e) => {
+	try {
+		return process.kill(e, 0), !0;
+	} catch {
+		return !1;
+	}
+}, d = (e) => {
+	let t = Date.now();
+	return e.filter((e) => u(e.pid) ? t - new Date(e.heartbeatAt).getTime() < a : !1);
+}, f = async () => {
+	let e = await c(), t = d(e.apps);
+	if (t.length === e.apps.length) return e;
+	try {
+		await l({
+			version: 1,
+			apps: t
+		});
+	} catch {}
+	return {
+		version: 1,
+		apps: t
+	};
+}, p = async (e) => {
+	let t = await c(), n = (/* @__PURE__ */ new Date()).toISOString(), r = t.apps.findIndex((t) => t.id === e.id), i = e.inspectToken ?? process.env.VOLTRO_INSPECT_TOKEN, a = {
+		...e,
+		...i !== void 0 && i !== "" ? { inspectToken: i } : {},
+		registeredAt: r >= 0 ? t.apps[r].registeredAt : n,
+		heartbeatAt: n
+	};
+	await l({
+		version: 1,
+		apps: r >= 0 ? t.apps.map((e, t) => t === r ? a : e) : [...t.apps, a]
+	});
+}, m = async (e) => {
+	try {
+		let t = await c(), n = t.apps.filter((t) => t.id !== e);
+		if (n.length === t.apps.length) return;
+		await l({
+			version: 1,
+			apps: n
+		});
+	} catch {}
+}, h = (e, t, n) => `${e}:${t}:${n}`;
+//#endregion
+export { p as i, f as n, m as r, h as t };

package/dist/runtimeTrace-CH3eUiMw.js

@@ -0,0 +1,91 @@
+import { n as e } from "./apiBuild-DYD_ONLD.js";
+import { join as t, resolve as n, sep as r } from "node:path";
+import { existsSync as i, promises as a } from "node:fs";
+import { createLogger as o } from "@voltro/logger";
+import { createRequire as s } from "node:module";
+//#region src/runtimeTrace.ts
+var c = o({ scope: "voltro:build" }), l = [
+	[
+		".framework",
+		"dist-web",
+		"startBundle",
+		"startEntry.js"
+	],
+	[
+		".framework",
+		"dist",
+		"server",
+		"ssrEntry.js"
+	],
+	[
+		".framework",
+		"dist",
+		"server",
+		"appConfig.js"
+	],
+	[
+		".framework",
+		"dist-api",
+		"serveBundle",
+		"serveEntry.js"
+	]
+], u = ["pg", ...e.filter((e) => !e.includes("*"))], d = async (e) => {
+	let o = t(e, "node_modules");
+	if (!i(o)) return null;
+	let d;
+	try {
+		({nodeFileTrace: d} = await import("@vercel/nft"));
+	} catch {
+		return c.warn("runtime trace skipped — @vercel/nft not installed (image keeps the full node_modules)"), null;
+	}
+	let f = l.map((n) => t(e, ...n)).filter((e) => i(e));
+	if (f.length === 0) return null;
+	let p = s(t(e, "_.js")), m = 0;
+	for (let e of u) try {
+		f.push(p.resolve(e)), m++;
+	} catch {}
+	let { fileList: h } = await d(f, { base: e }), g = /* @__PURE__ */ new Set();
+	for (let t of h) {
+		let i = n(e, t);
+		i.startsWith(o + r) && g.add(i);
+	}
+	let _ = 0, v = async (e) => {
+		let n = !1;
+		for (let r of await a.readdir(e, { withFileTypes: !0 })) {
+			let i = t(e, r.name);
+			if (r.isSymbolicLink()) {
+				n = !0;
+				continue;
+			}
+			r.isDirectory() ? await v(i) ? n = !0 : await a.rmdir(i).catch(() => {
+				n = !0;
+			}) : g.has(i) ? n = !0 : (await a.rm(i).catch(() => {}), _++);
+		}
+		return n;
+	}, y = await v(o);
+	return y || await a.rm(o, {
+		recursive: !0,
+		force: !0
+	}).catch(() => {}), c.info("runtime trace: pruned node_modules to the reachable set", {
+		nativeLeaves: m > 0 ? u.filter((e) => {
+			try {
+				return !!p.resolve(e);
+			} catch {
+				return !1;
+			}
+		}).join(", ") : "none",
+		filesRemoved: _,
+		nodeModules: y ? "pruned" : "removed (fully self-contained)"
+	}), m;
+}, f = async (e) => {
+	let t = e.find((e) => !e.startsWith("-"));
+	if (!t) return c.error("usage: voltro prune-runtime <deploy-dir>"), 1;
+	try {
+		await d(n(t));
+	} catch (e) {
+		c.warn("runtime trace failed — image keeps the full node_modules (not fatal)", {}, e);
+	}
+	return 0;
+};
+//#endregion
+export { f as runPruneRuntimeCommand };

package/dist/scheduleCmd-DQRu6BZC.js

@@ -0,0 +1,149 @@
+import { t as e } from "./cliArgs-D4p8n7EE.js";
+import { n as t } from "./cliOutput-D1tSBoRM.js";
+import { n, o as r, r as i, t as a } from "./inspectFetch-EMuhTG_9.js";
+import { ansi as o } from "@voltro/logger";
+//#region src/scheduleCmd.ts
+var s = () => {
+	console.log(`${o.bold("voltro schedule")} — operate on registered schedules
+
+  ${o.bold("run <name>")}        fire the named schedule once, now
+  ${o.bold("backfill <name>")}   fire every occurrence in an explicit range
+                    (boot backfill only walks from the last recorded run, and
+                    cluster cron caps its own catch-up at one day — a longer
+                    outage needs this verb)
+
+Options
+  --process NAME    target one app by name (default: every live api)
+  --trigger manual|external
+                    (run) how the run is recorded (default: manual)
+  --from ISO --to ISO
+                    (backfill) the range, half-open (from, to]
+  --yes             (backfill) confirm a range above the server's threshold
+  --limit N         (backfill) raise the per-request occurrence cap
+  --format pretty|json
+  --url URL         address a process directly instead of via the local registry
+
+Examples
+  voltro schedule run nightly-reconcile
+  voltro schedule backfill nightly-reconcile --from 2026-08-01T00:00:00Z --to 2026-08-05T00:00:00Z
+  voltro schedule backfill hourly-sync --from 2026-08-10T00:00:00Z --to 2026-08-12T00:00:00Z --yes
+
+The target must expose the inspect surface: set ${o.bold("VOLTRO_INSPECT_TOKEN")} on the
+server and in this shell. \`voltro dev\` mints one per project; \`serve\` / \`start\`
+never mint — inspect stays closed until an operator opens it.`);
+}, c = (e, n, r, i) => {
+	if (i === "json") {
+		t({
+			app: e,
+			schedule: n,
+			runId: r
+		});
+		return;
+	}
+	if (r === null) {
+		console.log(`${o.yellow("○")} ${e}: ${o.bold(n)} not started — no run id.\n  Another replica holds the coordination lock, or the previous run is still going and this schedule's onOverlap is 'skip'.`);
+		return;
+	}
+	console.log(`${o.green("✓")} ${e}: ${o.bold(n)} fired — run ${o.bold(r)}`), console.log(`  watch it: voltro inspect schedules --process ${e}`);
+}, l = (e, t) => {
+	let n = e.indexOf(t);
+	if (n === -1) return;
+	let r = e[n + 1];
+	return r !== void 0 && !r.startsWith("--") ? r : void 0;
+}, u = [
+	"--from",
+	"--to",
+	"--limit",
+	"--format",
+	"--process",
+	"--url",
+	"--token"
+], d = async (s) => {
+	let c = e(s, u);
+	if (c === void 0) return console.error("voltro schedule backfill: a schedule name is required — `voltro schedule backfill <name> --from <iso> --to <iso>`"), 1;
+	let d = n(s);
+	if ("error" in d) return console.error(`voltro schedule backfill: ${d.error}`), 1;
+	let { format: f } = d, { process: p, target: m, rest: h, error: g } = i(d.rest);
+	if (g !== void 0) return console.error(`voltro schedule backfill: ${g}`), 1;
+	let _ = l(h, "--from"), v = l(h, "--to");
+	if (_ === void 0 || v === void 0) return console.error("voltro schedule backfill: both --from and --to are required (ISO instants, e.g. 2026-08-01T00:00:00Z)"), 1;
+	let y = l(h, "--limit"), b = y === void 0 ? void 0 : Number(y);
+	if (b !== void 0 && (!Number.isFinite(b) || b <= 0)) return console.error(`voltro schedule backfill: --limit must be a positive number (got ${y})`), 1;
+	let x = h.includes("--yes"), S = await r(p, m);
+	if (S.length === 0) return console.error("voltro schedule backfill: no live api found.\n  Start one (`voltro dev` / `voltro serve`), or address it directly with --url."), 1;
+	let C = 0;
+	for (let e of S) {
+		let n = await a(e, `/_voltro/inspect/schedules/${encodeURIComponent(c)}/backfill`, {
+			method: "POST",
+			body: {
+				from: _,
+				to: v,
+				confirm: x,
+				...b === void 0 ? {} : { limit: b }
+			}
+		});
+		if (n.kind === "err") {
+			C += 1, console.error(`${o.red("✗")} ${e.name}: ${n.error}`);
+			continue;
+		}
+		let r = n.data;
+		if (n.status === 409 && r?.kind === "refused") {
+			if (C += 1, f === "json") {
+				t({
+					app: e.name,
+					...r
+				});
+				continue;
+			}
+			console.error(`${o.yellow("○")} ${e.name}: refused — ${r.reason}`);
+			continue;
+		}
+		if (n.status < 200 || n.status >= 300) {
+			C += 1;
+			let t = r?.message === void 0 ? r?.error === void 0 ? `HTTP ${n.status}` : String(r.error) : String(r.message);
+			console.error(`${o.red("✗")} ${e.name}: ${t}`), n.status === 401 && console.error("  Set VOLTRO_INSPECT_TOKEN on the server and in this shell.");
+			continue;
+		}
+		if (f === "json") {
+			t({
+				app: e.name,
+				...r
+			});
+			continue;
+		}
+		console.log(`${o.green("✓")} ${e.name}: ${o.bold(c)} backfilled — ${r?.fired ?? 0}/${r?.occurrences ?? 0} firing(s) over ${_} .. ${v}`), console.log(`  review the runs: voltro inspect schedules --process ${e.name}`);
+	}
+	return +(C > 0);
+}, f = async (t) => {
+	let [l, ...f] = t;
+	if (l === void 0 || l === "--help" || l === "-h") return s(), +(l === void 0);
+	if (l === "backfill") return d(f);
+	if (l !== "run") return console.error(`voltro schedule: unknown subcommand "${l}" (expected: run | backfill)`), 1;
+	let p = e(f, u);
+	if (p === void 0) return console.error("voltro schedule run: a schedule name is required — `voltro schedule run <name>`"), 1;
+	let m = n(f);
+	if ("error" in m) return console.error(`voltro schedule run: ${m.error}`), 1;
+	let { format: h } = m, { process: g, target: _, rest: v, error: y } = i(m.rest);
+	if (y !== void 0) return console.error(`voltro schedule run: ${y}`), 1;
+	let b = v[v.indexOf("--trigger") + 1], x = v.includes("--trigger") && b === "external" ? "external" : "manual", S = await r(g, _);
+	if (S.length === 0) return console.error("voltro schedule run: no live api found.\n  Start one (`voltro dev` / `voltro serve`), or address it directly with --url."), 1;
+	let C = 0;
+	for (let e of S) {
+		let t = await a(e, `/_voltro/inspect/schedules/${encodeURIComponent(p)}/fire?trigger=${x}`, { method: "POST" });
+		if (t.kind === "err") {
+			C += 1, console.error(`${o.red("✗")} ${e.name}: ${t.error}`);
+			continue;
+		}
+		if (t.status < 200 || t.status >= 300) {
+			C += 1;
+			let n = t.data, r = n?.message === void 0 ? n?.error === void 0 ? `HTTP ${t.status}` : String(n.error) : String(n.message);
+			console.error(`${o.red("✗")} ${e.name}: ${r}`), t.status === 401 && console.error("  Set VOLTRO_INSPECT_TOKEN on the server and in this shell."), t.status === 404 && console.error("  A 404 here means the app is older than this endpoint, or it is a web app (schedules are api-only).");
+			continue;
+		}
+		let n = t.data?.runId ?? null;
+		c(e.name, p, n, h);
+	}
+	return +(C > 0);
+};
+//#endregion
+export { f as runScheduleCommand };