@voltro/cli 0.55.0 → 0.56.0

package/bin/voltro.mjs

@@ -17,8 +17,32 @@ import { existsSync } from 'node:fs'
 import { createRequire } from 'node:module'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 import { dirname, join, resolve } from 'node:path'
+import { enableCompileCache } from 'node:module'
 import { resolveNodeEnvironment } from './nodeEnvironment.mjs'
 
+// V8 CODE CACHE — the cheapest cold-boot win there is, and it needs no build
+// change: node caches the compiled bytecode of every module it loads and reuses
+// it on the next boot from the same files.
+//
+// Measured on the reference fixtures (5 fresh processes, median):
+//   `voltro start`  166 ms → 93 ms  (−44 %)   cache 936 KB
+//   `voltro serve`  287 ms → 215 ms (−25 %)   cache 3.1 MB
+// The `modules` phase — node init + loading the precompiled bundle — is 46 % of
+// a web boot and 65 % of an api boot, so this lands where the seconds are.
+//
+// `NODE_COMPILE_CACHE` set → node already enabled it before this file ran; do
+// nothing (and never override the operator's directory). Unset → the default
+// location under the OS temp dir, which survives process restarts on the same
+// host. That covers dev and a warm container restart; a scale-from-zero
+// container starts with an EMPTY temp dir, which is why the shipped Dockerfiles
+// point the variable at a directory the image BAKES during the boot smoke.
+//
+// Wrapped: `enableCompileCache` is Node 22+, and a failure to cache must never
+// be a failure to boot.
+if (process.env.NODE_COMPILE_CACHE === undefined) {
+  try { enableCompileCache?.() } catch { /* cache is an optimisation, never a requirement */ }
+}
+
 // FAST PATH — `voltro serve <app>` with a precompiled SERVE BUNDLE boots from that
 // ONE artefact IN THIS PROCESS: no child `node --import tsx`, no CLI command
 // graph. `voltro build` esbuilds the whole serve path (framework + effect +

package/dist/{apiBuild-CMvLJM_K.js → apiBuild-Bdaetr37.js}

@@ -1,14 +1,18 @@
-import { p as e } from "./dev-Ca_A_S9v.js";
-import { Kt as t } from "./webDev-B7vNj4Bq.js";
+import { p as e } from "./dev-Dw263KPu.js";
+import { Wt as t } from "./webDev-C53hJdcL.js";
 import { t as n } from "./dialectDriver-czCHYpeH.js";
 import { dirname as r, isAbsolute as i, join as a, relative as o, resolve as s } from "node:path";
-import { existsSync as c, promises as l } from "node:fs";
-import { fileURLToPath as u } from "node:url";
-import { createLogger as d } from "@voltro/logger";
-import { createRequire as f } from "node:module";
-//#region src/apiBuild.ts
-var p = d({ scope: "voltro:build" }), m = (e) => {
-	let t = r(u(import.meta.url));
+import { existsSync as c, promises as l, readFileSync as u } from "node:fs";
+import { fileURLToPath as d } from "node:url";
+import { createLogger as f } from "@voltro/logger";
+import { frameworkVersion as p } from "@voltro/protocol/identity";
+import { createRequire as m } from "node:module";
+//#region src/bundleBanner.ts
+var h = () => {
+	let e = p(), t = "import { createRequire as __voltroRequire } from 'node:module'; const require = __voltroRequire(import.meta.url);";
+	return e === void 0 ? t : `globalThis.__VOLTRO_FRAMEWORK_VERSION__ = ${JSON.stringify(e)};\n${t}`;
+}, g = f({ scope: "voltro:build" }), _ = (e) => {
+	let t = r(d(import.meta.url));
 	for (let n of [
 		".js",
 		".ts",
@@ -18,7 +22,7 @@ var p = d({ scope: "voltro:build" }), m = (e) => {
 		if (c(r)) return { [`@voltro/cli/${e}`]: r };
 	}
 	return {};
-}, h = async (e) => {
+}, v = async (e) => {
 	let t = a(e, "package.json");
 	if (!c(t)) return [];
 	let r = {};
@@ -32,7 +36,7 @@ var p = d({ scope: "voltro:build" }), m = (e) => {
 	} catch {
 		return [];
 	}
-	let i = f(t);
+	let i = m(t);
 	return n.filter((e) => {
 		if (r[e] === void 0) return !1;
 		try {
@@ -41,7 +45,7 @@ var p = d({ scope: "voltro:build" }), m = (e) => {
 			return !1;
 		}
 	});
-}, g = /(?:\.(?:query|mutation|action|stream)(?:\.server)?\.ts|\.workflow(?:\.server)?\.tsx|\.(?:subscribe|reaction|aggregate|agent|tool|webhook|cron|trigger|outbox|consumer|connection|email)(?:\.server)?\.tsx?|\.(?:startup|seed)\.tsx?|\.(?:entity|schema|relations|migration|event|ws|expectation|budget|experiment)\.ts|(?:^|\/)schema\.ts)$/, _ = (e) => /\.(ts|tsx)$/.test(e) && !/\.(test|spec)\.[tj]sx?$/.test(e), v = async (t) => (await e(t)).filter((e) => g.test(e) && _(e) && !e.includes(`${t}/.framework/`)), y = {
+}, y = /(?:\.(?:query|mutation|action|stream)(?:\.server)?\.ts|\.workflow(?:\.server)?\.tsx|\.(?:subscribe|reaction|aggregate|agent|tool|webhook|cron|trigger|outbox|consumer|connection|email)(?:\.server)?\.tsx?|\.(?:startup|seed)\.tsx?|\.(?:entity|schema|relations|migration|event|ws|expectation|budget|experiment)\.ts|(?:^|\/)schema\.ts)$/, b = (e) => /\.(ts|tsx)$/.test(e) && !/\.(test|spec)\.[tj]sx?$/.test(e), x = async (t) => (await e(t)).filter((e) => y.test(e) && b(e) && !e.includes(`${t}/.framework/`)), S = {
 	name: "externalize-bare",
 	setup(e) {
 		e.onResolve({ filter: /.*/ }, (e) => {
@@ -52,12 +56,12 @@ var p = d({ scope: "voltro:build" }), m = (e) => {
 			};
 		});
 	}
-}, b = async (e) => {
+}, C = async (e) => {
 	let n = await t("esbuild", () => import("esbuild")), r = a(e, ".framework"), i = a(r, "dist-api");
 	await l.mkdir(r, { recursive: !0 });
-	let u = [...await v(e)], d = a(e, "app.config.ts");
-	if (c(d) && u.push(d), u.length === 0) return p.warn("api build: no handlers or app.config found — nothing to precompile", { root: e }), null;
-	let f = a(e, "tsconfig.json"), m = {
+	let u = [...await x(e)], d = a(e, "app.config.ts");
+	if (c(d) && u.push(d), u.length === 0) return g.warn("api build: no handlers or app.config found — nothing to precompile", { root: e }), null;
+	let f = a(e, "tsconfig.json"), p = {
 		bundle: !0,
 		format: "esm",
 		platform: "node",
@@ -66,36 +70,38 @@ var p = d({ scope: "voltro:build" }), m = (e) => {
 		jsx: "automatic",
 		jsxImportSource: "react",
 		absWorkingDir: e,
+		minify: !0,
+		keepNames: !0,
 		...c(f) ? { tsconfig: f } : {},
-		plugins: [y]
-	}, h = await n.build({
-		...m,
+		plugins: [S]
+	}, m = await n.build({
+		...p,
 		entryPoints: u,
 		write: !1,
 		metafile: !0,
 		outdir: i
-	}), g = Object.keys(h.metafile.inputs).map((t) => s(e, t)).filter((t) => t.startsWith(`${e}/`) && !t.includes("/node_modules/") && !t.includes("/.framework/") && _(t)), b = [
+	}), h = Object.keys(m.metafile.inputs).map((t) => s(e, t)).filter((t) => t.startsWith(`${e}/`) && !t.includes("/node_modules/") && !t.includes("/.framework/") && b(t)), _ = [
 		"// GENERATED BY `voltro build` — do not edit; overwritten on next build.",
 		"// Precompiled api entry: the single bundle the serve runtime loads instead",
 		"// of importing every handler/schema source at boot. See apiBuild.ts /",
 		"// appModuleLoader.ts.",
 		""
-	], x = [];
-	g.forEach((t, n) => {
-		b.push(`import * as m${n} from ${JSON.stringify(t)}`), x.push(`  ${JSON.stringify(o(e, t))}: m${n},`);
-	}), b.push("", "export const modules: Record<string, unknown> = {", ...x, "}", "");
-	let S = a(r, "apiEntry.ts");
-	return await l.writeFile(S, b.join("\n"), "utf8"), await n.build({
-		...m,
-		entryPoints: [S],
+	], v = [];
+	h.forEach((t, n) => {
+		_.push(`import * as m${n} from ${JSON.stringify(t)}`), v.push(`  ${JSON.stringify(o(e, t))}: m${n},`);
+	}), _.push("", "export const modules: Record<string, unknown> = {", ...v, "}", "");
+	let y = a(r, "apiEntry.ts");
+	return await l.writeFile(y, _.join("\n"), "utf8"), await n.build({
+		...p,
+		entryPoints: [y],
 		outfile: a(i, "apiEntry.js"),
 		metafile: !1,
 		write: !0
-	}), p.info("api build: precompiled bundle written", {
-		modules: g.length,
+	}), g.info("api build: precompiled bundle written", {
+		modules: h.length,
 		out: a(".framework", "dist-api", "apiEntry.js")
 	}), a(i, "apiEntry.js");
-}, x = (e) => a(e, ".framework", "dist-api", "apiEntry.js"), S = [
+}, w = (e) => a(e, ".framework", "dist-api", "apiEntry.js"), T = [
 	"better-sqlite3",
 	"pg-native",
 	"@tursodatabase/*",
@@ -107,8 +113,13 @@ var p = d({ scope: "voltro:build" }), m = (e) => {
 	"@img/*",
 	"fontkit",
 	"subset-font",
-	"satori"
-], C = [
+	"satori",
+	"@azure/storage-blob",
+	"@aws-sdk/*",
+	"@smithy/*",
+	"@react-email/render",
+	"@sentry/profiling-node"
+], E = [
 	"tsx",
 	"esbuild",
 	"vite",
@@ -116,42 +127,60 @@ var p = d({ scope: "voltro:build" }), m = (e) => {
 	"@tailwindcss/*",
 	"rolldown",
 	"lightningcss"
-], w = (e, t) => t.some((t) => t.endsWith("/*") ? e === t.slice(0, -2) || e.startsWith(t.slice(0, -1)) : e === t || e.startsWith(`${t}/`)), T = (e, t) => `const { createRequire } = require('node:module')
+], D = (e, t) => t.some((t) => t.endsWith("/*") ? e === t.slice(0, -2) || e.startsWith(t.slice(0, -1)) : e === t || e.startsWith(`${t}/`)), O = (e, t) => `const { createRequire } = require('node:module')
 const { join } = require('node:path')
 const reqApp = createRequire(join(process.cwd(), 'package.json'))
-const drivers = ${JSON.stringify(t)}\nlet mod\nfor (const d of drivers) {\n  try { mod = createRequire(reqApp.resolve(d + '/package.json'))(${JSON.stringify(e)}); break } catch (e) {}\n}\nif (!mod) { try { mod = reqApp(${JSON.stringify(e)}) } catch (e) {} }\nif (!mod) mod = require(${JSON.stringify(e)})\nmodule.exports = mod\n`, E = (e, t, n) => ({
-	name: "native-leaf-runtime-resolver",
-	setup(r) {
-		r.onResolve({ filter: /.*/ }, (e) => {
-			let r = e.path;
-			if (!(r.startsWith(".") || i(r) || r.startsWith("node:")) && !(/^effect$/.test(r) || r.startsWith("@effect/") || r.startsWith("@voltro/"))) {
-				if (w(r, S)) return {
-					path: r,
-					namespace: "native-leaf"
-				};
-				if (w(r, C)) return {
-					path: r,
-					external: !0
-				};
-				for (let n of [e.resolveDir, t]) if (n) try {
-					f(a(n, "_.js")).resolve(r);
-					return;
-				} catch {}
-				return n.add(r), {
-					path: r,
-					external: !0
-				};
-			}
-		}), r.onLoad({
-			filter: /.*/,
-			namespace: "native-leaf"
-		}, (t) => ({
-			contents: T(t.path, [...e, "@voltro/cli"]),
-			loader: "js"
-		}));
+const drivers = ${JSON.stringify(t)}\nlet mod\nfor (const d of drivers) {\n  try { mod = createRequire(reqApp.resolve(d + '/package.json'))(${JSON.stringify(e)}); break } catch (e) {}\n}\nif (!mod) { try { mod = reqApp(${JSON.stringify(e)}) } catch (e) {} }\nif (!mod) mod = require(${JSON.stringify(e)})\nmodule.exports = mod\n`, k = (e) => {
+	try {
+		let t = JSON.parse(u(a(e, "package.json"), "utf8"));
+		return Object.keys({
+			...t.dependencies,
+			...t.devDependencies,
+			...t.optionalDependencies
+		}).filter((e) => e.startsWith("@voltro/plugin-"));
+	} catch {
+		return [];
 	}
-}), D = (e) => a(e, ".framework", "dist-api", "serveBundle", "serveEntry.js"), O = 1e3, k = async (e, t) => {
-	let n = t - O, r = 0, i = async (e) => {
+}, A = (e, t, n) => {
+	let r = [
+		...e,
+		...k(t),
+		"@voltro/cli"
+	];
+	return {
+		name: "native-leaf-runtime-resolver",
+		setup(e) {
+			e.onResolve({ filter: /.*/ }, (e) => {
+				let r = e.path;
+				if (!(r.startsWith(".") || i(r) || r.startsWith("node:")) && !(/^effect$/.test(r) || r.startsWith("@effect/") || r.startsWith("@voltro/"))) {
+					if (D(r, T)) return {
+						path: r,
+						namespace: "native-leaf"
+					};
+					if (D(r, E)) return {
+						path: r,
+						external: !0
+					};
+					for (let n of [e.resolveDir, t]) if (n) try {
+						m(a(n, "_.js")).resolve(r);
+						return;
+					} catch {}
+					return n.add(r), {
+						path: r,
+						external: !0
+					};
+				}
+			}), e.onLoad({
+				filter: /.*/,
+				namespace: "native-leaf"
+			}, (e) => ({
+				contents: O(e.path, r),
+				loader: "js"
+			}));
+		}
+	};
+}, j = (e) => a(e, ".framework", "dist-api", "serveBundle", "serveEntry.js"), M = 1e3, N = async (e, t) => {
+	let n = t - M, r = 0, i = async (e) => {
 		let t;
 		try {
 			t = await l.readdir(e, { withFileTypes: !0 });
@@ -170,12 +199,12 @@ const drivers = ${JSON.stringify(t)}\nlet mod\nfor (const d of drivers) {\n  try
 		}
 	};
 	return await i(e), r;
-}, A = async (e) => {
+}, P = async (e) => {
 	let n = await t("esbuild", () => import("esbuild")), r = a(e, ".framework"), i = a(r, "dist-api", "serveBundle");
 	await l.mkdir(r, { recursive: !0 });
-	let u = Date.now(), d = [...await v(e)], f = a(e, "app.config.ts");
+	let u = Date.now(), d = [...await x(e)], f = a(e, "app.config.ts");
 	if (c(f) && d.push(f), d.length === 0) return null;
-	let g = a(e, "tsconfig.json"), b = await n.build({
+	let p = a(e, "tsconfig.json"), m = await n.build({
 		entryPoints: d,
 		bundle: !0,
 		write: !1,
@@ -186,28 +215,28 @@ const drivers = ${JSON.stringify(t)}\nlet mod\nfor (const d of drivers) {\n  try
 		jsx: "automatic",
 		jsxImportSource: "react",
 		logLevel: "silent",
-		plugins: [y],
+		plugins: [S],
 		outdir: a(i, ".probe"),
-		...c(g) ? { tsconfig: g } : {}
-	}), x = Object.keys(b.metafile.inputs).map((t) => s(e, t)).filter((t) => t.startsWith(`${e}/`) && !t.includes("/node_modules/") && !t.includes("/.framework/") && _(t)), S = await h(e), C = /* @__PURE__ */ new Set(), w = [
+		...c(p) ? { tsconfig: p } : {}
+	}), y = Object.keys(m.metafile.inputs).map((t) => s(e, t)).filter((t) => t.startsWith(`${e}/`) && !t.includes("/node_modules/") && !t.includes("/.framework/") && b(t)), C = await v(e), w = /* @__PURE__ */ new Set(), T = [
 		"// GENERATED BY `voltro build` — do not edit; overwritten on next build.",
 		"import { join as __join, dirname as __dirname, resolve as __resolve } from 'node:path'",
 		"import { pathToFileURL as __pathToFileURL, fileURLToPath as __fileURLToPath } from 'node:url'",
 		"import { runServe as __runServe, registerAppModules, registerDriver, loadDotEnv } from '@voltro/cli/serveEntry'",
-		...S.map((e, t) => `import * as __drv${t} from ${JSON.stringify(e)}`),
+		...C.map((e, t) => `import * as __drv${t} from ${JSON.stringify(e)}`),
 		"const __isMain = Boolean(process.argv[1]) && import.meta.url === __pathToFileURL(process.argv[1]).href",
 		"if (__isMain) process.chdir(__resolve(__dirname(__fileURLToPath(import.meta.url)), '..', '..', '..'))",
 		"const __root = process.cwd()",
 		"registerAppModules({",
-		...x.map((t) => `  [__join(__root, ${JSON.stringify(o(e, t))})]: () => import(${JSON.stringify(t)}),`),
+		...y.map((t) => `  [__join(__root, ${JSON.stringify(o(e, t))})]: () => import(${JSON.stringify(t)}),`),
 		"})",
-		...S.map((e, t) => `registerDriver(${JSON.stringify(e)}, __drv${t})`),
+		...C.map((e, t) => `registerDriver(${JSON.stringify(e)}, __drv${t})`),
 		"export const runServe = (args = []) => { loadDotEnv([]); return __runServe(args) }",
 		"if (__isMain) runServe(process.argv.slice(2)).then((c) => process.exit(typeof c === 'number' ? c : 0))",
 		""
-	], T = a(r, "serveEntry.ts");
-	await l.writeFile(T, w.join("\n"), "utf8"), await n.build({
-		entryPoints: [T],
+	], E = a(r, "serveEntry.ts");
+	await l.writeFile(E, T.join("\n"), "utf8"), await n.build({
+		entryPoints: [E],
 		bundle: !0,
 		format: "esm",
 		platform: "node",
@@ -215,23 +244,25 @@ const drivers = ${JSON.stringify(t)}\nlet mod\nfor (const d of drivers) {\n  try
 		outdir: i,
 		splitting: !0,
 		write: !0,
-		plugins: [E(S, e, C)],
-		banner: { js: "import { createRequire as __voltroRequire } from 'node:module'; const require = __voltroRequire(import.meta.url);" },
+		minify: !0,
+		keepNames: !0,
+		plugins: [A(C, e, w)],
+		banner: { js: h() },
 		jsx: "automatic",
 		jsxImportSource: "react",
 		logLevel: "silent",
 		absWorkingDir: e,
-		alias: m("serveEntry"),
-		...c(g) ? { tsconfig: g } : {}
+		alias: _("serveEntry"),
+		...c(p) ? { tsconfig: p } : {}
 	});
-	let D = await k(i, u);
-	return p.info("api build: serve bundle written", {
-		appModules: x.length,
-		drivers: S.length > 0 ? S.join(", ") : "none (memory)",
-		...C.size > 0 ? { externalizedOptionalPeers: [...C].join(", ") } : {},
+	let D = await N(i, u);
+	return g.info("api build: serve bundle written", {
+		appModules: y.length,
+		drivers: C.length > 0 ? C.join(", ") : "none (memory)",
+		...w.size > 0 ? { externalizedOptionalPeers: [...w].join(", ") } : {},
 		...D > 0 ? { prunedStaleChunks: D } : {},
 		out: a(".framework", "dist-api", "serveBundle", "serveEntry.js")
 	}), a(i, "serveEntry.js");
 };
 //#endregion
-export { v as a, b as c, m as i, A as l, S as n, E as o, x as r, k as s, g as t, D as u };
+export { x as a, C as c, h as d, _ as i, P as l, T as n, A as o, w as r, N as s, y as t, j as u };

package/dist/apiBuild-Vw1figjO.js

@@ -0,0 +1,2 @@
+import { c as e, l as t } from "./apiBuild-Bdaetr37.js";
+export { e as runApiBuild, t as runServeBundleBuild };

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as e } from "./commands-BBYJ7Q3B.js";
+import { r as e } from "./commands-CWjfThXv.js";
 import { a as t } from "./nodeEnvironment-cGFAj1J8.js";
 import { t as n } from "./loadEnv-D9nEOClM.js";
 import { n as r } from "./cliError-BmdYnghb.js";