@voltro/cli 0.44.1 → 0.46.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-CB6_3sX0.js

@@ -0,0 +1,144 @@
+import { B as e, Sn as t, l as n, u as r, xn as i } from "./dev-8hTEnN6s.js";
+import { dt as a } from "./webDev-B4IEMB0n.js";
+import { r as o, u as s } from "./frameworkTableAssembly-BPlPfU07.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 (r) => {
+	let { config: i, present: a, error: o } = await n(r);
+	if (a && i === 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 = i?.plugins ?? [], { pluginContributions: c, pluginErrorImports: d, pluginRpcImports: f } = await e(s, i?.name ?? u(r), r), p = await l({
+		root: r,
+		...c.length > 0 ? { pluginContributions: c } : {},
+		...d.length > 0 ? { pluginErrorImports: d } : {},
+		...f.length > 0 ? { pluginRpcImports: f } : {},
+		...i?.name === void 0 ? {} : { apiName: i.name }
+	});
+	if (!p) return { kind: "nothing-to-write" };
+	let m = await w(r, i), h = await t(p, m);
+	return {
+		kind: "wrote",
+		file: p,
+		plugins: s.length,
+		errorSchemas: d.length,
+		routes: f.length,
+		tables: m.size,
+		dts: h
+	};
+}, w = async (e, t) => {
+	let n = await c(e), { tables: a, featureMix: l } = await r(n), u = s({
+		nodeEnv: process.env.NODE_ENV,
+		declared: t?.schema
+	}), d = o({
+		mix: l,
+		plugins: t?.plugins ?? [],
+		gates: u
+	});
+	return i(a, d, t?.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-DSZjgyCL.js}

@@ -5640,6 +5640,55 @@ 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")
+	}),
+	S({
+		version: "0.46.0",
+		id: "0.46.0/01_typed-aggregate-source",
+		title: "an aggregate’s `incremental.source` is typechecked against the app’s tables",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => /\bincremental\s*:/.test(e.getFullText())),
+		note: (/* @__PURE__ */ "An aggregate that opts into incremental maintenance names the table whose(CDC deltas drive it:((    incremental: { source: 'tasks', op: 'count' }((That name is now checked against your app’s tables, the same way a query’s(`source:` has been since 0.45.0.((WHY IT MATTERS MORE HERE((A name matching no table does not error. The runner subscribes to something(nothing writes, no delta ever arrives, and the aggregate quietly stops(tracking its input — while every read of it still succeeds and still returns(a number. There is no failing request to notice.((WHEN IT STARTS APPLYING((At your next `voltro dev` or `voltro codegen`, not at this upgrade — those(write `voltro-tables.generated.d.ts`, and that file is what narrows the type.(Until it exists the field is `string`, exactly as it is today.((WHAT TO DO((Boot once and read what `tsc` flags. A flagged name is either misspelled or(renamed away — a real defect, and that aggregate has not been maintaining —(or it is computed at runtime, in which case annotate it `string`.((The boot also warns now: an aggregate whose CDC source resolves to no table(is named in the same stale-`source:` warning queries and streams appear in.".split("(")).join("\n")
 	})
 ], Y = /* @__PURE__ */ new Set([
 	"node_modules",

package/dist/{commands-CYkHTox2.js → commands-C-hxgAGr.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-DyoYst4j.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-CEVO0GWF.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-CXAXTjZL.js").then((t) => t.runCheckCommand(e)),
 		help: {
 			usage: "[--json] [--offline] [--process <name>] [--diff removeTable:<name>]",
 			flags: [
@@ -139,7 +139,7 @@ var c = () => {
 		name: "eval",
 		summary: "Replay recorded agent/AI runs (*.eval.ts) against the current model, judge with assertions + an optional LLM judge, and gate the deploy (exit 1 on regression). Flags: --json, --branch [--pr <n>], --threshold <0..1>.",
 		status: "wired",
-		run: (e) => import("./evalCommand-6RUfPen4.js").then((t) => t.runEvalCommand(e)),
+		run: (e) => import("./evalCommand-Db01Kbng.js").then((t) => t.runEvalCommand(e)),
 		help: {
 			usage: "[--json] [--branch [--pr <n>]] [--threshold <0..1>]",
 			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-BRrG_sGf.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-DUuaCIyn.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-CB6_3sX0.js").then((t) => t.runCodegenCommand(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro codegen", "regenerate rpcGroup.generated.ts for the app in the cwd"]],
@@ -199,7 +199,7 @@ var c = () => {
 		name: "migrate",
 		summary: "Apply the declared schema to the database (alias of `db apply` — diffs declared vs live and emits the ALTERs). `--create-only` for the bootstrap-only CREATE TABLE IF NOT EXISTS path.",
 		status: "wired",
-		run: (e) => import("./migrate-DN47p2PG.js").then((t) => t.runMigrateCommand(e)),
+		run: (e) => import("./migrate-CM1qwalu.js").then((t) => t.runMigrateCommand(e)),
 		help: {
 			usage: "[app] [--create-only]",
 			flags: [["--create-only", "only CREATE TABLE IF NOT EXISTS — never ALTER (bootstrap)"]],
@@ -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-CuNl9cbh.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-B_NPVGUf.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-Btl2Jz1a.js");
 				return e(a(t), !0);
 			}
-			let { tryRunWebServe: n } = await import("./webDev-BLKBO34K.js"), r = await n(a(t));
+			let { tryRunWebServe: n } = await import("./webDev-B79ji8M5.js"), r = await n(a(t));
 			if (!r.ran) {
-				let { runServeDispatch: t } = await import("./serveCommand-Dg_E1ev4.js");
+				let { runServeDispatch: t } = await import("./serveCommand-BNHMVXyp.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-Btl2Jz1a.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-co6yadYz.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-BRNM06vK.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-CrPAwOgo.js").then((t) => t.runDormancyCommand(e)),
 		help: {
 			usage: "[app] [--port <n>] [--app-port <n>] [--idle-grace-ms <n>] [--tick-ms <n>]",
 			flags: [
@@ -399,7 +399,7 @@ var c = () => {
 		name: "start",
 		summary: "Production runtime: serves dist + SSR-on-demand for ssr/isr pages.",
 		status: "wired",
-		run: (e) => import("./start-BAlGcjF5.js").then((t) => t.runStartCommand(e)),
+		run: (e) => import("./start-DvlYDyAr.js").then((t) => t.runStartCommand(e)),
 		help: {
 			usage: "[app]",
 			examples: [["voltro start", "serve a built web app (dist + SSR-on-demand)"]],
@@ -453,7 +453,7 @@ var c = () => {
 		name: "db",
 		summary: "Database subcommands. Declarative flow: plan, apply, branch, plans, drift [--accept], squash, restore-snapshot. File migrations: generate [name], migrate, rollback, status, files, rollback-file. Data + housekeeping: seed, gc-snapshots, adopt. Credentials at rest: scan-credentials (find plaintext), encrypt-column (migrate a populated column onto .encrypted()).",
 		status: "wired",
-		run: (e) => import("./dbCommand-BvQeKQOb.js").then((t) => t.runDbCommand(e)),
+		run: (e) => import("./dbCommand-C2XK63Dd.js").then((t) => t.runDbCommand(e)),
 		help: {
 			usage: t(n),
 			examples: [
@@ -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-k0ezbQWa.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-CT5AvVg7.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-CT5AvVg7.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-DsSxsn_b.js").then((t) => t.runEmbeddingsCommand(e)),
 		help: {
 			usage: "backfill <table> --text <field> --vector <field> [--model <m>] [--batch <n>] [--dry-run]",
 			flags: [