@voltro/cli 0.44.1 → 0.45.0

package/dist/codegenCommand-CQOLytL-.js

@@ -0,0 +1,144 @@
+import { bn as e, l as t, u as n, xn as r, z as i } from "./dev-DAM5CnAa.js";
+import { dt as a } from "./webDev-101csg6Q.js";
+import { r as o, u as s } from "./frameworkTableAssembly-oMPBKqlE.js";
+import { i as c, r as l } from "./codegen-sbN1Y8PB.js";
+import { basename as u, join as d, relative as f, resolve as p } from "node:path";
+import { promises as m } from "node:fs";
+import { pathToFileURL as h } from "node:url";
+//#region src/mobileCodegen.ts
+var g = "voltro.mobile.ts", _ = d(".framework", "mobileApis.generated.ts"), v = (e) => e.replace(/[^a-zA-Z0-9]/g, "_"), y = async (e) => {
+	let t = d(e, g);
+	try {
+		await m.stat(t);
+	} catch {
+		return { present: !1 };
+	}
+	try {
+		let e = (await import(`${h(t).href}?t=${Date.now()}`)).default;
+		return e === void 0 || typeof e != "object" || e.apis === void 0 ? {
+			present: !0,
+			error: /* @__PURE__ */ Error(`${g} has no default export with an \`apis\` map`)
+		} : {
+			present: !0,
+			binding: e
+		};
+	} catch (e) {
+		return {
+			present: !0,
+			error: e instanceof Error ? e : Error(String(e))
+		};
+	}
+}, b = (e, t) => {
+	let n = t.filter(([, e]) => e.package !== void 0).map(([e, t]) => {
+		let n = `${v(e)}Group`, r = `${v(e)}Descriptors`;
+		return `import { ${n === "appGroup" ? "appGroup" : `appGroup as ${n}`}, ${r === "appDescriptors" ? "appDescriptors" : `appDescriptors as ${r}`} } from '${t.package}/rpcGroup'`;
+	}), r = t.map(([e, t]) => t.package === void 0 ? `  // ${JSON.stringify(e)}: declared with \`url\` only — no local rpc surface to import.\n  //   Add \`package: '<the api package>'\` to ${g} to get typed hooks for it.` : `  { ${[
+		`name: ${JSON.stringify(e)}`,
+		`group: ${v(e)}Group`,
+		`descriptors: ${v(e)}Descriptors`,
+		`wsUrl: wsUrl(${JSON.stringify(e)})`
+	].join(", ")} },`), i = t.filter(([, e]) => e.url !== void 0).map(([e, t]) => `  ${JSON.stringify(e)}: ${JSON.stringify(t.url)},`);
+	return [
+		"// GENERATED BY `voltro codegen` — do not edit; regenerate with `voltro codegen`.",
+		"//",
+		`// The api bindings declared in ${g}. Only the BINDING is`,
+		"// generated: the procedure types ride the imports below, so a schema change",
+		"// in an api needs no regeneration here.",
+		"",
+		...n,
+		"import type { MobileApiBinding } from '@voltro/react-native'",
+		"",
+		"/** Every api this app talks to, bound to a runtime-resolved ws URL.",
+		" *",
+		" * The URL is a parameter because it differs per environment and `localhost`",
+		" * on a device is the DEVICE — see `resolveDevWsUrl` in @voltro/react-native. */",
+		"export const mobileApis = (",
+		"  wsUrl: (apiName: string) => string,",
+		"): ReadonlyArray<MobileApiBinding> => [",
+		...r,
+		"]",
+		"",
+		"/** Api names in declaration order — the keys the hooks bind to. */",
+		`export const MOBILE_API_NAMES = [${t.map(([e]) => JSON.stringify(e)).join(", ")}] as const`,
+		...i.length > 0 ? [
+			"",
+			`/** URLs declared in ${g} for apis this app does not build. */`,
+			"export const MOBILE_API_URLS: Readonly<Record<string, string>> = {",
+			...i,
+			"}"
+		] : [],
+		""
+	].join("\n");
+}, x = async (e) => {
+	let t = p(e), n = await y(t);
+	if (!n.present) return { kind: "not-a-mobile-app" };
+	if ("error" in n) return {
+		kind: "refused",
+		reason: `${g} could not be loaded — ${n.error.message}`
+	};
+	let r = Object.entries(n.binding.apis);
+	if (r.length === 0) return {
+		kind: "refused",
+		reason: `${g} declares no apis`
+	};
+	for (let [e, t] of r) if (t.package === void 0 && t.url === void 0) return {
+		kind: "refused",
+		reason: `api ${JSON.stringify(e)} declares neither \`package\` nor \`url\``
+	};
+	for (let [e, n] of r) if (n.package !== void 0 && await a(t, n.package) === null) return {
+		kind: "refused",
+		reason: `api ${JSON.stringify(e)}: ${n.package} is not a workspace dependency of this app. Add it to the app's package.json (\`"${n.package}": "workspace:*"\`) and install.`
+	};
+	let i = d(t, _), o = b(t, r);
+	await m.mkdir(d(t, ".framework"), { recursive: !0 });
+	let s = null;
+	try {
+		s = await m.readFile(i, "utf8");
+	} catch {}
+	return s !== o && await m.writeFile(i, o, "utf8"), {
+		kind: "wrote",
+		file: i,
+		apis: r.map(([e]) => e)
+	};
+}, S = (e, t) => t.kind === "wrote" ? `voltro codegen: wrote ${f(e, t.file)} (apis ${t.apis.join(", ")})` : t.kind === "refused" ? `voltro codegen: ${t.reason} — refusing to write.` : `voltro codegen: no ${g} here — not a mobile app.`, C = async (e) => {
+	let { config: n, present: a, error: o } = await t(e);
+	if (a && n === null) return {
+		kind: "refused",
+		reason: "app.config.ts exists but could not be loaded" + (o === void 0 ? "" : ` — ${o instanceof Error ? o.message : String(o)}`)
+	};
+	let s = n?.plugins ?? [], { pluginContributions: c, pluginErrorImports: d, pluginRpcImports: f } = await i(s, n?.name ?? u(e), e), p = await l({
+		root: e,
+		...c.length > 0 ? { pluginContributions: c } : {},
+		...d.length > 0 ? { pluginErrorImports: d } : {},
+		...f.length > 0 ? { pluginRpcImports: f } : {},
+		...n?.name === void 0 ? {} : { apiName: n.name }
+	});
+	if (!p) return { kind: "nothing-to-write" };
+	let m = await w(e, n), h = await r(p, m);
+	return {
+		kind: "wrote",
+		file: p,
+		plugins: s.length,
+		errorSchemas: d.length,
+		routes: f.length,
+		tables: m.size,
+		dts: h
+	};
+}, w = async (t, r) => {
+	let i = await c(t), { tables: a, featureMix: l } = await n(i), u = s({
+		nodeEnv: process.env.NODE_ENV,
+		declared: r?.schema
+	}), d = o({
+		mix: l,
+		plugins: r?.plugins ?? [],
+		gates: u
+	});
+	return e(a, d, r?.analytics?.tables ?? []);
+}, T = async (e) => {
+	let t = p(e.find((e) => !e.startsWith("-")) ?? process.cwd()), n = await x(t);
+	if (n.kind !== "not-a-mobile-app") return console.log(S(t, n)), n.kind === "wrote" ? 0 : 1;
+	let r = await C(t);
+	return r.kind === "refused" ? (console.error(`voltro codegen: ${r.reason} — refusing to write.`), console.error("  The generated file would omit every plugin's error union and client routes, and would typecheck, so the omission would only surface as a missing error tag at runtime."), 1) : r.kind === "nothing-to-write" ? (console.log("voltro codegen: no rpc primitives found — nothing to write."), 0) : (console.log(`voltro codegen: wrote ${f(t, r.file)} (plugins ${r.plugins}, error schemas ${r.errorSchemas}, plugin routes ${r.routes})`), console.log(r.dts.action === "removed" ? `  removed ${f(t, r.dts.path)} — no tables declared, so \`source:\` is \`string\` again` : r.dts.action === "skipped" ? "  no tables declared — `source:` stays `string`" : `  ${r.dts.action} ${f(t, r.dts.path)} (${r.tables} table name(s) typed for \`source:\`)`), r.plugins > 0 && r.errorSchemas === 0 && console.log("  note: no plugin contributed a cross-cutting error schema, so the wire error union carries only each procedure's own `error:`. Expected if none of your plugins declare `errorSchemas` — but `guards:` needs @voltro/plugin-rbac for its ScopeError to decode typed."), 0);
+};
+//#endregion
+export { C as regenerateRpcGroup, T as runCodegenCommand };

package/dist/{codemodRunner-BKTnaGOz.js → codemodRunner-5ZhDH3rB.js}

@@ -5640,6 +5640,47 @@ var b = (e, t, n) => {
 			"emptied of its old rows and holding part of the new ones. If you relied on per-table resume for a replace,",
 			"that is the non-atomic path."
 		].join("\n")
+	}),
+	S({
+		version: "0.45.0",
+		id: "0.45.0/01_typed-source-table-name",
+		title: "`source:` is typechecked against the app’s tables, from the next `voltro dev`",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => /\bsource\s*:/.test(e.getFullText())),
+		note: [
+			"`source:` on a query or stream is now typed against your app’s own tables.",
+			"A name no table carries is a COMPILE error instead of a subscription that",
+			"silently never updates.",
+			"",
+			"WHEN IT STARTS APPLYING",
+			"",
+			"Not now — at your next `voltro dev` (or `voltro codegen`). Those write",
+			"`voltro-tables.generated.d.ts` beside the generated rpc group, and that file",
+			"is what narrows the type. Until it exists, `source:` is `string`, exactly as",
+			"it is today. This note exists because the error appears one command later",
+			"than the upgrade that caused it.",
+			"",
+			"WHAT TO DO",
+			"",
+			"Boot once, then read what `tsc` flags. Each site is one of two things:",
+			"",
+			"  • a name that is misspelled, or was renamed away — a REAL defect this",
+			"    just surfaced. That query’s view was never updating. Fix the name.",
+			"",
+			"  • a source computed at runtime — correct as written. Annotate it",
+			"    `ReactivitySourceValue` (exported from `@voltro/protocol`), which is the",
+			"    wide `string | ReactivityChannel` shape.",
+			"",
+			"Reach for the second only when the value genuinely is not a literal. Widening",
+			"a name you could have spelled turns a found defect back into a quiet one.",
+			"",
+			"Eager-loaded relations are a common source of the first kind: a query that",
+			"loads a relation must also declare that relation’s table (and, for a",
+			"many-to-many, the junction). `voltro doctor` reports those.",
+			"",
+			"To opt out entirely, delete `voltro-tables.generated.d.ts` and exclude it",
+			"from your tsconfig; `source:` widens back to `string`."
+		].join("\n")
 	})
 ], Y = /* @__PURE__ */ new Set([
 	"node_modules",

package/dist/{commands-CYkHTox2.js → commands-CEkVoFM5.js}

@@ -91,7 +91,7 @@ var c = () => {
 		name: "dev",
 		summary: "Start the local development server (auto-discovers routes / mutations).",
 		status: "wired",
-		run: (e) => import("./dev-BZO5aLdr.js").then((t) => t.runDev(e)),
+		run: (e) => import("./dev-P4HyeY9W.js").then((t) => t.runDev(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro dev", "boot the app in the current directory"], ["voltro dev apps/acme/api", "boot a specific app"]],
@@ -109,7 +109,7 @@ var c = () => {
 		name: "dashboard",
 		summary: "Serve the DevTools dashboard standalone (from @voltro/dashboard). Targets via VOLTRO_DASHBOARD_APPS; --port to override.",
 		status: "wired",
-		run: (e) => import("./dashboardCommand-DHDmlo9A.js").then((t) => t.runDashboardCommand(e)),
+		run: (e) => import("./dashboardCommand-0ahyp-zA.js").then((t) => t.runDashboardCommand(e)),
 		help: {
 			usage: "[--port <n>]",
 			flags: [["--port <n>", "port to serve the dashboard on"]],
@@ -121,7 +121,7 @@ var c = () => {
 		name: "check",
 		summary: "Verify the app graph (blast-radius checks) against a running api; LLM-shaped --json diagnostics. Flags: --json, --process <p>, --diff removeTable:<name>.",
 		status: "wired",
-		run: (e) => import("./checkCommand-AlbawIal.js").then((t) => t.runCheckCommand(e)),
+		run: (e) => import("./checkCommand-lrzwOzV1.js").then((t) => t.runCheckCommand(e)),
 		help: {
 			usage: "[--json] [--offline] [--process <name>] [--diff removeTable:<name>]",
 			flags: [
@@ -155,7 +155,7 @@ var c = () => {
 		name: "webhooks",
 		summary: "Outbound-webhook artefacts. `consumer` generates the ZERO-DEPENDENCY Standard-Webhooks verification package a subscriber installs, from this app's own declared events; `events` lists the events a subscriber can register for. Usage: voltro webhooks <consumer|events> [path] [--out <dir>] [--name <pkg>] [--json].",
 		status: "wired",
-		run: (e) => import("./webhooksCommand-BfO_JF2b.js").then((t) => t.runWebhooksCommand(e)),
+		run: (e) => import("./webhooksCommand-C0iZZfaI.js").then((t) => t.runWebhooksCommand(e)),
 		help: {
 			usage: "<consumer|events> [path] [--out <dir>] [--name <pkg>] [--json]",
 			flags: [
@@ -171,7 +171,7 @@ var c = () => {
 		name: "evolve",
 		summary: "Schema-evolution copilot: propose an observed-graph-driven codemod + a branch-verified backfill for a schema change (rename/retype/split/drop a column, rename a table). Dry-run by default; --write applies. Usage: voltro evolve rename-column <table>.<col> --to <newName> [--write] [--json].",
 		status: "wired",
-		run: (e) => import("./evolveCommand-CBV3-TtK.js").then((t) => t.runEvolveCommand(e)),
+		run: (e) => import("./evolveCommand-qdlP-R9G.js").then((t) => t.runEvolveCommand(e)),
 		help: {
 			usage: "<rename-column|rename-table|retype-column|split-column|drop-column> <target> [--to <new>] [--write]",
 			flags: [
@@ -188,7 +188,7 @@ var c = () => {
 		name: "codegen",
 		summary: "Emit rpcGroup.generated.ts from discovered route / mutation descriptors.",
 		status: "wired",
-		run: (e) => import("./codegenCommand-iClXoRCW.js").then((t) => t.runCodegenCommand(e)),
+		run: (e) => import("./codegenCommand-CQOLytL-.js").then((t) => t.runCodegenCommand(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro codegen", "regenerate rpcGroup.generated.ts for the app in the cwd"]],
@@ -211,7 +211,7 @@ var c = () => {
 		name: "test",
 		summary: "Run vitest against the app at the cwd (auto-discovers *.test.ts/tsx).",
 		status: "wired",
-		run: (e) => import("./test-CLYXrZ2F.js").then((t) => t.runTestCommand(e)),
+		run: (e) => import("./test-CHb7UwvE.js").then((t) => t.runTestCommand(e)),
 		help: {
 			usage: "[dir] [filter…] [--watch] [-t <pattern>]",
 			flags: [
@@ -259,7 +259,7 @@ var c = () => {
 		name: "info",
 		summary: "Report versions (CLI, node, every installed @voltro/* — flags lockstep skew), package manager, and dialect. --json for CI. Exits 1 on version skew.",
 		status: "wired",
-		run: (e) => import("./infoCommand-DJoA9cKD.js").then((t) => t.runInfoCommand(e)),
+		run: (e) => import("./infoCommand-CNWPSUcW.js").then((t) => t.runInfoCommand(e)),
 		help: {
 			usage: "[--json]",
 			flags: [["--json", "machine-readable report"]],
@@ -280,7 +280,7 @@ var c = () => {
 		name: "env",
 		summary: "Inspect/sync the typed-env manifest. Subcommands: check (default), sync (.env.example), types (env.generated.d.ts for CI tsc), turbo.",
 		status: "wired",
-		run: (e) => import("./envCommand-CpCbYAgR.js").then((t) => t.runEnvCommand(e)),
+		run: (e) => import("./envCommand-CviRZx1L.js").then((t) => t.runEnvCommand(e)),
 		help: {
 			usage: "[check|sync|types|turbo] [--force]",
 			flags: [["--force", "overwrite the generated file instead of refusing on a conflict"]],
@@ -309,12 +309,12 @@ var c = () => {
 		run: async (e) => {
 			let t = e.find((e) => !e.startsWith("-")) ?? process.cwd();
 			if (e.includes("--preflight")) {
-				let { runServePreflight: e } = await import("./doctorCommand-BeLOwq7S.js");
+				let { runServePreflight: e } = await import("./doctorCommand-2K1dIzYk.js");
 				return e(a(t), !0);
 			}
 			let { tryRunWebServe: n } = await import("./webDev-BLKBO34K.js"), r = await n(a(t));
 			if (!r.ran) {
-				let { runServeDispatch: t } = await import("./serveCommand-Dg_E1ev4.js");
+				let { runServeDispatch: t } = await import("./serveCommand-DY2jLy0o.js");
 				return t(e);
 			}
 			return r.exitCode;
@@ -342,13 +342,13 @@ var c = () => {
 		handlesHelp: !0,
 		summary: "Preflight an app for production: the precompiled serve bundle, hand-rolled primitives (naming the shipped one), @voltro/* version skew, executors with no access check, `.serverOnly()` leaks, and junction-FK gaps.",
 		status: "wired",
-		run: (e) => import("./doctorCommand-BeLOwq7S.js").then((t) => t.runDoctorCommand(e))
+		run: (e) => import("./doctorCommand-2K1dIzYk.js").then((t) => t.runDoctorCommand(e))
 	},
 	{
 		name: "build",
 		summary: "Production build for a web app (vite build + per-page SSG pre-render).",
 		status: "wired",
-		run: (e) => import("./build-Ckc-FA7d.js").then((t) => t.runBuildCommand(e)),
+		run: (e) => import("./build-yvsLG77U.js").then((t) => t.runBuildCommand(e)),
 		help: {
 			usage: "[app] [--target <t>]",
 			flags: [["--target <t>", "build target"]],
@@ -364,7 +364,7 @@ var c = () => {
 		name: "prune-runtime",
 		summary: "Trim a deployed web tree’s node_modules to the reachable runtime set (standalone image slimming).",
 		status: "wired",
-		run: (e) => import("./runtimeTrace-DJ9tPhrc.js").then((t) => t.runPruneRuntimeCommand(e)),
+		run: (e) => import("./runtimeTrace-BDZSt9W_.js").then((t) => t.runPruneRuntimeCommand(e)),
 		hidden: !0
 	},
 	{
@@ -382,7 +382,7 @@ var c = () => {
 		name: "dormancy",
 		summary: "Single-node scale-to-zero: front the API with a wake-orchestrator that stops the app when idle and brings it back on a request or a due wakeup (cron/workflow). Needs a SQL store. Flags: --port, --app-port, --idle-grace-ms, --tick-ms.",
 		status: "wired",
-		run: (e) => import("./dormancyCommand-lQxdrU8C.js").then((t) => t.runDormancyCommand(e)),
+		run: (e) => import("./dormancyCommand-BqQz7lbM.js").then((t) => t.runDormancyCommand(e)),
 		help: {
 			usage: "[app] [--port <n>] [--app-port <n>] [--idle-grace-ms <n>] [--tick-ms <n>]",
 			flags: [
@@ -469,7 +469,7 @@ var c = () => {
 		name: "data",
 		summary: "Export/import + backup/restore of app data. Logical (rows + optional assets): export <dir> [--tenant <id>|--tables a,b] [--assets] [--compression zstd|gzip|none] [--consistency live|snapshot]; import <dir> [--assets] [--no-verify]. Native (rows ONLY — no blobs): backup <dir> / restore <dir> (pg_dump/mariadb-dump/…). Resumable; typed-NDJSON; content-addressed assets on the logical path.",
 		status: "wired",
-		run: (e) => import("./dataCommand-WFn8CM11.js").then((t) => t.runDataCommand(e)),
+		run: (e) => import("./dataCommand-D4IlZcih.js").then((t) => t.runDataCommand(e)),
 		help: {
 			usage: "<export|import|backup|restore> <dir> [options]",
 			flags: [
@@ -524,20 +524,20 @@ var c = () => {
 		handlesHelp: !0,
 		summary: "Upgrade the app to the latest framework: bump every @voltro/* dependency (across ALL workspace members, install once at the workspace root), then run the codemods shipped with the target version. Flags: --to <version>, --from <version>, --codemods-only, --dry-run, --force, --exact, --help. After: run `voltro db apply`.",
 		status: "wired",
-		run: (e) => import("./updateCommand-DcKVmLVN.js").then((t) => t.runUpdateCommand(e))
+		run: (e) => import("./updateCommand-BH6EGuCc.js").then((t) => t.runUpdateCommand(e))
 	},
 	{
 		name: "_apply-codemods",
 		summary: "Internal: apply shipped codemods for a framework version jump (re-exec target of `voltro update`).",
 		status: "wired",
 		hidden: !0,
-		run: (e) => import("./updateCommand-DcKVmLVN.js").then((t) => t.runApplyCodemods(e))
+		run: (e) => import("./updateCommand-BH6EGuCc.js").then((t) => t.runApplyCodemods(e))
 	},
 	{
 		name: "embeddings",
 		summary: "Embeddings tooling. Subcommand: backfill <table> --text <field> --vector <field> [--model <m>] [--model-field <f>] [--batch <n>] [--dry-run] — (re)embed rows the vectorEmbedding() mixin missed.",
 		status: "wired",
-		run: (e) => import("./embeddingsCommand-ByBTju6X.js").then((t) => t.runEmbeddingsCommand(e)),
+		run: (e) => import("./embeddingsCommand-DJyArpU4.js").then((t) => t.runEmbeddingsCommand(e)),
 		help: {
 			usage: "backfill <table> --text <field> --vector <field> [--model <m>] [--batch <n>] [--dry-run]",
 			flags: [

package/dist/{dashboardCommand-DHDmlo9A.js → dashboardCommand-0ahyp-zA.js}

@@ -1,4 +1,4 @@
-import { d as e } from "./dev-D-JZ6CGQ.js";
+import { d as e } from "./dev-DAM5CnAa.js";
 import { H as t, z as n } from "./webDev-101csg6Q.js";
 import { t as r } from "./start-Ds3xyn8R.js";
 import { join as i } from "node:path";