@voltro/cli 0.44.0 → 0.45.0

package/dist/{codegen-CbpGCWLG.js → codegen-sbN1Y8PB.js}

@@ -152,7 +152,7 @@ var p = /* @__PURE__ */ new Set(/* @__PURE__ */ "crypto.fs.path.os.net.http.http
 		return !1;
 	};
 	return t(e);
-}, F = async (t) => {
+}, F = async (e) => I(e), I = async (t) => {
 	let r = [], i = async (t) => {
 		let o = await a.readdir(t, { withFileTypes: !0 });
 		for (let a of o) {
@@ -162,8 +162,8 @@ var p = /* @__PURE__ */ new Set(/* @__PURE__ */ "crypto.fs.path.os.net.http.http
 		}
 	};
 	return await i(t), r;
-}, I = (e) => typeof e == "object" && !!e && "kind" in e && "name" in e && (e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream"), L = Symbol.for("@effect/workflow/Workflow"), R = (e) => typeof e == "object" && !!e && L in e && "name" in e && typeof e.name == "string", z = async (e) => Promise.all(e.map((e) => import(s(e).href))), B = async (e) => {
-	let t = [], n = await z(e);
+}, L = (e) => typeof e == "object" && !!e && "kind" in e && "name" in e && (e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream"), R = Symbol.for("@effect/workflow/Workflow"), z = (e) => typeof e == "object" && !!e && R in e && "name" in e && typeof e.name == "string", B = async (e) => Promise.all(e.map((e) => import(s(e).href))), V = async (e) => {
+	let t = [], n = await B(e);
 	for (let [r, i] of e.entries()) {
 		let e = n[r], a = /* @__PURE__ */ new Set();
 		for (let [n, r] of Object.entries(e)) {
@@ -171,7 +171,7 @@ var p = /* @__PURE__ */ new Set(/* @__PURE__ */ "crypto.fs.path.os.net.http.http
 				if (a.has(r)) continue;
 				a.add(r);
 			}
-			if (I(r)) {
+			if (L(r)) {
 				if (!l(r)) continue;
 				t.push({
 					file: i,
@@ -185,7 +185,7 @@ var p = /* @__PURE__ */ new Set(/* @__PURE__ */ "crypto.fs.path.os.net.http.http
 				exportName: n,
 				rpcTag: r.name,
 				kind: "event"
-			}) : R(r) && t.push({
+			}) : z(r) && t.push({
 				file: i,
 				exportName: n,
 				rpcTag: r.name,
@@ -194,19 +194,19 @@ var p = /* @__PURE__ */ new Set(/* @__PURE__ */ "crypto.fs.path.os.net.http.http
 		}
 	}
 	return t;
-}, V = async (e) => {
-	let t = [], n = e.filter((e) => j.test(e)), r = await z(n);
+}, H = async (e) => {
+	let t = [], n = e.filter((e) => j.test(e)), r = await B(n);
 	for (let [e, i] of n.entries()) for (let [n, a] of Object.entries(r[e])) f(a) && t.push({
 		file: i,
 		exportName: n,
 		name: a.name
 	});
 	return t;
-}, H = (e) => {
+}, U = (e) => {
 	let t = (e, t) => e.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((e, n) => (n === 0 && !t ? e.charAt(0).toLowerCase() : e.charAt(0).toUpperCase()) + e.slice(1)).join(""), n = e.split(".");
 	return `${t(n[0] ?? "rpc", !1)}${n.slice(1).map((e) => t(e, !0)).join("")}Rpc`;
-}, U = /^[A-Za-z][A-Za-z0-9]*([._-][A-Za-z0-9]+)*$/, W = (e, t) => {
-	let n = (e) => r(t, e.file).replace(/\\/g, "/"), i = e.filter((e) => !U.test(e.rpcTag));
+}, W = /^[A-Za-z][A-Za-z0-9]*([._-][A-Za-z0-9]+)*$/, G = (e, t) => {
+	let n = (e) => r(t, e.file).replace(/\\/g, "/"), i = e.filter((e) => !W.test(e.rpcTag));
 	if (i.length > 0) throw Error(`invalid rpc tag — a procedure/workflow \`name\` must start with a letter and
 use only letters, digits, and \`.\` \`-\` \`_\` separators (the tag becomes a JS
 identifier in the generated rpcGroup):
@@ -214,7 +214,7 @@ identifier in the generated rpcGroup):
 ${i.map((e) => `  • "${e.rpcTag}"  (${n(e)})`).join("\n")}\n`);
 	let a = /* @__PURE__ */ new Map();
 	for (let t of e) {
-		let e = H(t.rpcTag), n = a.get(e);
+		let e = U(t.rpcTag), n = a.get(e);
 		n ? n.push(t) : a.set(e, [t]);
 	}
 	let o = [...a.values()].filter((e) => new Set(e.map((e) => e.rpcTag)).size > 1);
@@ -222,8 +222,8 @@ ${i.map((e) => `  • "${e.rpcTag}"  (${n(e)})`).join("\n")}\n`);
 generated identifier (separators are normalized away). Rename one so they
 differ by more than a \`.\`/\`-\`/\`_\`:
 
-${o.map((e) => `  ${H(e[0].rpcTag)}:\n` + e.map((e) => `    - "${e.rpcTag}"  (${n(e)})`).join("\n")).join("\n\n")}\n`);
-}, G = (e) => {
+${o.map((e) => `  ${U(e[0].rpcTag)}:\n` + e.map((e) => `    - "${e.rpcTag}"  (${n(e)})`).join("\n")).join("\n\n")}\n`);
+}, K = (e) => {
 	switch (e) {
 		case "query": return 0;
 		case "mutation": return 1;
@@ -232,7 +232,7 @@ ${o.map((e) => `  ${H(e[0].rpcTag)}:\n` + e.map((e) => `    - "${e.rpcTag}"  (${
 		case "event": return 4;
 		case "workflow": return 5;
 	}
-}, K = (e, t) => {
+}, q = (e, t) => {
 	let n = /* @__PURE__ */ new Map();
 	for (let t of e) n.has(t.rpcTag) || n.set(t.rpcTag, t);
 	let i = [...n.keys()], a = (e) => r(t, n.get(e).file).replace(/\\/g, "/"), o = [];
@@ -247,8 +247,8 @@ can't be both a leaf and a namespace. Rename one side (e.g. give the
 workflow/procedure a nested name like "<prefix>.run"):
 
 ${o.join("\n\n")}\n`);
-}, q = "// source-fingerprint: ", J = async (e) => {
-	let t = [...await F(e)].sort(), n = d("sha1");
+}, J = "// source-fingerprint: ", Y = async (e) => {
+	let t = [...await I(e)].sort(), n = d("sha1");
 	for (let i of t) {
 		let t = "";
 		try {
@@ -257,7 +257,7 @@ ${o.join("\n\n")}\n`);
 		n.update(`${r(e, i).replace(/\\/g, "/")}\u0000${t}\u0000`);
 	}
 	return n.digest("hex").slice(0, 16);
-}, Y = async (e) => {
+}, X = async (e) => {
 	let t = async (e) => {
 		let r = await a.readdir(e, { withFileTypes: !0 }).catch(() => []);
 		for (let t of r) if (!N.has(t.name) && t.isFile() && t.name === "rpcGroup.generated.ts") return n(e, t.name);
@@ -268,8 +268,8 @@ ${o.join("\n\n")}\n`);
 		}
 	};
 	return t(i(e));
-}, X = async (e) => {
-	let n = await Y(e);
+}, Z = async (e) => {
+	let n = await X(e);
 	if (n === void 0) return { kind: "absent" };
 	let r = "";
 	try {
@@ -282,7 +282,7 @@ ${o.join("\n\n")}\n`);
 		kind: "stale",
 		file: n,
 		reason: "the generated group carries no freshness stamp"
-	} : await J(t(n)) === i ? {
+	} : await Y(t(n)) === i ? {
 		kind: "fresh",
 		file: n
 	} : {
@@ -290,7 +290,7 @@ ${o.join("\n\n")}\n`);
 		file: n,
 		reason: "a descriptor changed since the group was generated"
 	};
-}, Z = (e, n, i, a = [], s = [], c = !1, l = !1, u = [], f = "") => {
+}, Q = (e, n, i, a = [], s = [], c = !1, l = !1, u = [], f = "") => {
 	let p = s.length > 0, m = s.flatMap((e) => [{
 		file: e.file,
 		exportName: e.exportName,
@@ -307,20 +307,20 @@ ${o.join("\n\n")}\n`);
 		rpcTag: e.tag,
 		kind: e.kind
 	}));
-	K([
+	q([
 		...i,
 		...m,
 		...g
-	], e), W([
+	], e), G([
 		...i,
 		...m,
 		...g
 	], e);
-	let _ = (e) => e.replace(/[^a-zA-Z0-9_$]/g, "_"), v = (e) => `__src_agent_${_(e.name)}`, y = (e) => `__agentRoutes_${_(e.name)}`, b = a.length > 0, x = a.map((e, t) => `import { ${e.name} as __pe${t} } from '${e.module}'`), S = b ? ", __voltroPluginErrors" : "", C = h.length > 0, w = h.map((e, t) => `import { ${e.name} as __prpc${t} } from '${e.module}'`), T = (e) => e === "query" ? "queryToRpc" : e === "mutation" ? "mutationToRpc" : "actionToRpc", E = h.map((e, t) => `export const ${H(e.tag)} = ${T(e.kind)}(__prpc${t}${S})`), D = h.map((e) => `  ${H(e.tag)},`), O = [...i].sort((e, t) => e.kind === t.kind ? e.rpcTag < t.rpcTag ? -1 : 1 : G(e.kind) - G(t.kind)), k = t(n), A = (e) => `__src_${H(e.rpcTag)}`, j = (e) => {
+	let _ = (e) => e.replace(/[^a-zA-Z0-9_$]/g, "_"), v = (e) => `__src_agent_${_(e.name)}`, y = (e) => `__agentRoutes_${_(e.name)}`, b = a.length > 0, x = a.map((e, t) => `import { ${e.name} as __pe${t} } from '${e.module}'`), S = b ? ", __voltroPluginErrors" : "", C = h.length > 0, w = h.map((e, t) => `import { ${e.name} as __prpc${t} } from '${e.module}'`), T = (e) => e === "query" ? "queryToRpc" : e === "mutation" ? "mutationToRpc" : "actionToRpc", E = h.map((e, t) => `export const ${U(e.tag)} = ${T(e.kind)}(__prpc${t}${S})`), D = h.map((e) => `  ${U(e.tag)},`), O = [...i].sort((e, t) => e.kind === t.kind ? e.rpcTag < t.rpcTag ? -1 : 1 : K(e.kind) - K(t.kind)), k = t(n), A = (e) => `__src_${U(e.rpcTag)}`, j = (e) => {
 		let t = `./${r(k, e.file).replace(/\\/g, "/").replace(/\.tsx?$/, "")}`;
 		return `import { ${e.exportName} as ${A(e)} } from '${t}'`;
 	}, M = (e) => {
-		let t = H(e.rpcTag), n = A(e);
+		let t = U(e.rpcTag), n = A(e);
 		return e.kind === "query" ? `export const ${t} = queryToRpc(${n}${S})` : e.kind === "mutation" ? `export const ${t} = mutationToRpc(${n}${S})` : e.kind === "action" ? `export const ${t} = actionToRpc(${n}${S})` : e.kind === "stream" ? `export const ${t} = streamToRpc(${n}${S})` : e.kind === "event" ? `export const ${t} = eventToRpc(${n}${S})` : [
 			`export const ${t} = Rpc.make('${e.rpcTag}', {`,
 			`  payload: strictInput(${n}.payloadSchema),`,
@@ -349,16 +349,16 @@ ${o.join("\n\n")}\n`);
 		"__voltroConnectionSubmitToken",
 		"__voltroConnectionDisconnect"
 	] : [], V = [
-		...O.map((e) => `  ${H(e.rpcTag)},`),
-		...s.flatMap((e) => [`  ${H(`${e.name}.send`)},`, `  ${H(`${e.name}.messages`)},`]),
+		...O.map((e) => `  ${U(e.rpcTag)},`),
+		...s.flatMap((e) => [`  ${U(`${e.name}.send`)},`, `  ${U(`${e.name}.messages`)},`]),
 		...I.map((e) => `  ${e},`),
 		...L.map((e) => `  ${e},`),
 		...z.map((e) => `  ${e},`),
 		...B.map((e) => `  ${e},`),
 		...D
-	].join("\n"), U = ["queryToRpc"];
-	(O.some((e) => e.kind === "mutation") || h.some((e) => e.kind === "mutation")) && U.push("mutationToRpc"), (O.some((e) => e.kind === "action") || F || p || h.some((e) => e.kind === "action")) && U.push("actionToRpc"), O.some((e) => e.kind === "stream") && U.push("streamToRpc"), O.some((e) => e.kind === "event") && U.push("eventToRpc"), F && U.push("strictInput", "WorkflowRunHandleSchema", "workflowCancelDescriptor", "workflowDomainEventsQueryDescriptor", "workflowEventDeliveriesQueryDescriptor", "workflowResumeDescriptor", "workflowRunEventsQueryDescriptor", "workflowRunQueryDescriptor", "workflowRunsQueryDescriptor", "workflowRunStepsQueryDescriptor", "workflowSignalDescriptor", "workflowUpdateDescriptor"), c && U.push("mutationToRpc", "undoLogQueryDescriptor", "undoApplyDescriptor", "undoRedoDescriptor"), R && U.push("mutationToRpc", "approvalsPendingQueryDescriptor", "approvalsDecideDescriptor"), l && U.push("mutationToRpc", "actionToRpc", "connectionsListQueryDescriptor", "connectionStartDescriptor", "connectionSubmitTokenDescriptor", "connectionDisconnectDescriptor"), (O.some((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream") || p || F || c || R || l || C) && U.push("normalizeDescriptor");
-	let J = [...new Set(U)].sort(), Y = [...O.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => [e.rpcTag, A(e)]), ...s.flatMap((e) => [[`${e.name}.send`, `${y(e)}.send`], [`${e.name}.messages`, `${y(e)}.messages`]])], X = [
+	].join("\n"), H = ["queryToRpc"];
+	(O.some((e) => e.kind === "mutation") || h.some((e) => e.kind === "mutation")) && H.push("mutationToRpc"), (O.some((e) => e.kind === "action") || F || p || h.some((e) => e.kind === "action")) && H.push("actionToRpc"), O.some((e) => e.kind === "stream") && H.push("streamToRpc"), O.some((e) => e.kind === "event") && H.push("eventToRpc"), F && H.push("strictInput", "WorkflowRunHandleSchema", "workflowCancelDescriptor", "workflowDomainEventsQueryDescriptor", "workflowEventDeliveriesQueryDescriptor", "workflowResumeDescriptor", "workflowRunEventsQueryDescriptor", "workflowRunQueryDescriptor", "workflowRunsQueryDescriptor", "workflowRunStepsQueryDescriptor", "workflowSignalDescriptor", "workflowUpdateDescriptor"), c && H.push("mutationToRpc", "undoLogQueryDescriptor", "undoApplyDescriptor", "undoRedoDescriptor"), R && H.push("mutationToRpc", "approvalsPendingQueryDescriptor", "approvalsDecideDescriptor"), l && H.push("mutationToRpc", "actionToRpc", "connectionsListQueryDescriptor", "connectionStartDescriptor", "connectionSubmitTokenDescriptor", "connectionDisconnectDescriptor"), (O.some((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream") || p || F || c || R || l || C) && H.push("normalizeDescriptor");
+	let W = [...new Set(H)].sort(), Y = [...O.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => [e.rpcTag, A(e)]), ...s.flatMap((e) => [[`${e.name}.send`, `${y(e)}.send`], [`${e.name}.messages`, `${y(e)}.messages`]])], X = [
 		...F ? [
 			["__voltro.workflow.run", "workflowRunQueryDescriptor"],
 			["__voltro.workflow.runs", "workflowRunsQueryDescriptor"],
@@ -414,14 +414,14 @@ ${o.join("\n\n")}\n`);
 			} catch {}
 			return `${e.rpcTag}\u0000${t}`;
 		}).join("
")).digest("hex").slice(0, 16)}`,
-		`${q}${f}`,
+		`${J}${f}`,
 		"// Source files:",
 		...O.map((t) => `//   - ${r(e, t.file).replace(/\\/g, "/")}`),
 		...s.map((t) => `//   - ${r(e, t.file).replace(/\\/g, "/")}  (agent)`),
 		"",
 		F ? "import { Rpc, RpcGroup } from '@effect/rpc'" : "import { RpcGroup } from '@effect/rpc'",
 		...F || P ? ["import { Schema } from 'effect'"] : [],
-		`import { ${J.join(", ")} } from '@voltro/protocol'`,
+		`import { ${W.join(", ")} } from '@voltro/protocol'`,
 		...p ? ["import { agentRouteDescriptors as __voltroAgentRoutes } from '@voltro/ai/agent'"] : [],
 		"",
 		...O.map(j),
@@ -466,7 +466,7 @@ ${o.join("\n\n")}\n`);
 			""
 		] : [],
 		...O.map(M),
-		...s.flatMap((e) => [`export const ${H(`${e.name}.send`)} = actionToRpc(${y(e)}.send${S})`, `export const ${H(`${e.name}.messages`)} = queryToRpc(${y(e)}.messages${S})`]),
+		...s.flatMap((e) => [`export const ${U(`${e.name}.send`)} = actionToRpc(${y(e)}.send${S})`, `export const ${U(`${e.name}.messages`)} = queryToRpc(${y(e)}.messages${S})`]),
 		...F ? [
 			"export const __voltroWorkflowRun = queryToRpc(workflowRunQueryDescriptor)",
 			"export const __voltroWorkflowRuns = queryToRpc(workflowRunsQueryDescriptor)",
@@ -560,8 +560,8 @@ ${o.join("\n\n")}\n`);
 			""
 		] : []
 	].join("\n");
-}, Q = async (e) => {
-	let r = i(e.root), o = await F(r), s = await B(o), c = await V(o), l = await P(r);
+}, $ = async (e) => {
+	let r = i(e.root), o = await I(r), s = await V(o), c = await H(o), l = await P(r);
 	if (s.length === 0 && c.length === 0 && !l && (e.pluginRpcImports?.length ?? 0) === 0) return;
 	let d = ((e) => {
 		if (e.length === 0) return r;
@@ -580,7 +580,7 @@ ${o.join("\n\n")}\n`);
 		"workflows"
 	]), p = (e) => e.slice(e.lastIndexOf("/") + 1), m = d;
 	for (; m !== r && f.has(p(m));) m = m.slice(0, m.lastIndexOf("/")) || "/";
-	let h = i(e.outputFile ?? n(m, "rpcGroup.generated.ts")), g = [...new Map((e.pluginErrorImports ?? []).map((e) => [`${e.module}#${e.name}`, e])).values()], _ = [...new Map((e.pluginRpcImports ?? []).map((e) => [e.tag, e])).values()], v = await J(t(h)), y = Z(r, h, s, g, c, u(), l, _, v), b = [];
+	let h = i(e.outputFile ?? n(m, "rpcGroup.generated.ts")), g = [...new Map((e.pluginErrorImports ?? []).map((e) => [`${e.module}#${e.name}`, e])).values()], _ = [...new Map((e.pluginRpcImports ?? []).map((e) => [e.tag, e])).values()], v = await Y(t(h)), y = Q(r, h, s, g, c, u(), l, _, v), b = [];
 	for (let t of e.pluginContributions ?? []) {
 		let e = null;
 		try {
@@ -602,4 +602,4 @@ ${o.join("\n\n")}\n`);
 	return S !== x && await a.writeFile(h, x, "utf8"), await D(h), h;
 };
 //#endregion
-export { D as a, T as c, w as i, J as n, E as o, Q as r, C as s, X as t };
+export { w as a, C as c, F as i, T as l, Y as n, D as o, $ as r, E as s, Z as t };

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-fsnezHLH.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-sfpGV694.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";