@voltro/cli 0.50.1 → 0.52.0

package/dist/checkCommand-2SbqzukH.js

@@ -0,0 +1,2 @@
+import { a as e, i as t, o as n } from "./checkCommand-COmqc2cB.js";
+export { t as offlineManifest, e as runCheckCommand, n as toInput };

package/dist/{checkCommand-DsKIjL6k.js → checkCommand-COmqc2cB.js}

@@ -1,19 +1,20 @@
 import { t as e } from "./cliArgs-D4p8n7EE.js";
-import { a as t, l as n } from "./codegen-CrMXs4hb.js";
-import { r } from "./appGraph-Cv2W_wO5.js";
+import { a as t, l as n } from "./codegen-VF479Cnb.js";
+import { r } from "./appGraph-yRuKjOba.js";
 import { n as i } from "./cliOutput-D1tSBoRM.js";
 import { n as a, o, r as s, t as c } from "./inspectFetch-EMuhTG_9.js";
-import { r as l } from "./fileTaxonomy-CJfgOllU.js";
-import { S as u } from "./doctorCommand-DyViaaCP.js";
+import { r as l } from "./fileTaxonomy-DvDUV9wq.js";
+import { S as u } from "./doctorCommand-DtfJ3FA6.js";
 import { resolve as d } from "node:path";
 import { readdirSync as f, statSync as p } from "node:fs";
+import { isReactivityChannelKey as m } from "@voltro/protocol";
 //#region src/observedDiff.ts
-var m = (e) => e === void 0 ? [] : typeof e == "string" ? [e] : e, h = {
+var h = (e) => (e === void 0 ? [] : typeof e == "string" ? [e] : e).filter((e) => !m(e)), g = {
 	insert: ["insert"],
 	update: ["update"],
 	delete: ["delete"],
 	upsert: ["insert", "update"]
-}, g = (e) => e !== "read", _ = (e, t) => `{ table: '${e}', op: '${t}' }`, v = (e, t) => {
+}, _ = (e) => e !== "read", v = (e, t) => `{ table: '${e}', op: '${t}' }`, y = (e, t) => {
 	let n = [], r = new Set(t.exercised), i = /* @__PURE__ */ new Map();
 	for (let e of t.edges) {
 		let t = i.get(e.tag);
@@ -25,19 +26,19 @@ var m = (e) => e === void 0 ? [] : typeof e == "string" ? [e] : e, h = {
 			a.push(t.tag);
 			continue;
 		}
-		let e = `${t.kind}(${t.tag})`, s = t.file, c = i.get(t.tag) ?? [], l = new Set(m(t.source)), u = /* @__PURE__ */ new Map();
+		let e = `${t.kind}(${t.tag})`, s = t.file, c = i.get(t.tag) ?? [], l = new Set(h(t.source)), u = /* @__PURE__ */ new Map();
 		for (let e of t.targets ?? []) {
 			let t = u.get(e.table) ?? /* @__PURE__ */ new Set();
 			t.add(e.op), u.set(e.table, t);
 		}
-		for (let t of c) if (g(t.op)) {
-			let r = h[t.op], i = u.get(t.table);
+		for (let t of c) if (_(t.op)) {
+			let r = g[t.op], i = u.get(t.table);
 			if (i === void 0) n.push({
 				rule: "observed/undeclared-write",
 				node: e,
 				...s === void 0 ? {} : { file: s },
 				breaks: [`writes '${t.table}' (${t.op}) but declares no target for it`, "subscriptions on that table are not invalidated by this mutation"],
-				fix: `add ${r.map((e) => _(t.table, e)).join(" and ")} to this procedure's targets`,
+				fix: `add ${r.map((e) => v(t.table, e)).join(" and ")} to this procedure's targets`,
 				severity: "warn"
 			});
 			else {
@@ -47,7 +48,7 @@ var m = (e) => e === void 0 ? [] : typeof e == "string" ? [e] : e, h = {
 					node: e,
 					...s === void 0 ? {} : { file: s },
 					breaks: [`declares ${[...i].map((e) => `'${e}'`).join(" + ")} on '${t.table}' but performed '${t.op}'`, "the synthesized optimistic patch has the wrong shape"],
-					fix: r.length > 1 ? `an upsert is both halves — declare ${r.map((e) => _(t.table, e)).join(" and ")}` : `change the target op for '${t.table}' to '${a[0]}'`,
+					fix: r.length > 1 ? `an upsert is both halves — declare ${r.map((e) => v(t.table, e)).join(" and ")}` : `change the target op for '${t.table}' to '${a[0]}'`,
 					severity: "warn"
 				});
 			}
@@ -90,7 +91,7 @@ var m = (e) => e === void 0 ? [] : typeof e == "string" ? [e] : e, h = {
 			total: e.length
 		}
 	};
-}, y = (e, n = [], r = 0) => {
+}, b = (e, n = [], r = 0) => {
 	if (r > 12) return n;
 	let i;
 	try {
@@ -114,24 +115,43 @@ var m = (e) => e === void 0 ? [] : typeof e == "string" ? [e] : e, h = {
 		} catch {
 			continue;
 		}
-		o.isDirectory() ? y(i, n, r + 1) : o.isFile() && t.test(a) && n.push(i);
+		o.isDirectory() ? b(i, n, r + 1) : o.isFile() && t.test(a) && n.push(i);
 	}
 	return n;
-}, b = /* @__PURE__ */ new Set(["actors", "tenants"]), x = async (e) => {
+}, x = /* @__PURE__ */ new Set(["actors", "tenants"]), S = async (e) => {
 	try {
 		let { readFile: t } = await import("node:fs/promises"), { join: n } = await import("node:path"), r = await t(n(e, "app.graph.observed.generated.json"), "utf8"), i = JSON.parse(r);
 		return i?.version !== 1 || !Array.isArray(i.edges) || !Array.isArray(i.exercised) ? null : i;
 	} catch {
 		return null;
 	}
-}, S = (e) => {
-	let { exercised: t, total: n } = e.coverage, r = `\nobserved: ${t}/${n} procedures exercised (${n === 0 ? 0 : Math.round(t / n * 100)}%)`;
-	if (e.diagnostics.length === 0) return `${r}\n  no declared/observed mismatches${e.unexercised.length > 0 ? `\n  ${e.unexercised.length} unexercised — no recording, so nothing is claimed about them` : ""}`;
-	let i = e.diagnostics.map((e) => `  ${e.node}${e.file === void 0 ? "" : ` (${e.file})`}\n` + e.breaks.map((e) => `    ${e}`).join("\n") + `\n    fix: ${e.fix}`), a = e.unexercised.length > 0 ? `\n  ${e.unexercised.length} unexercised — no recording, so nothing is claimed about them` : "";
-	return `${r}\n${i.join("\n")}${a}`;
-}, C = (e, t) => ({
+}, C = {
+	unexercised: (e) => `${e} never ran — no observation exists, so nothing is claimed about them`,
+	unobservedReads: (e) => `${e} ran with no table access recorded — indistinguishable from touching nothing, so nothing is claimed about them either`
+}, w = (e, t) => {
+	let n = e.filter((e) => !t.has(e)).sort();
+	return n.length === 0 ? `\ndeclared vs live: all ${e.length} source-declared tags are registered on the server` : `\ndeclared vs live: ${n.length} of ${e.length} source-declared tags are NOT registered on the server\n` + n.map((e) => `  ⚠ ${e} — a generated client calls this and gets "Unknown request tag"`).join("\n") + "\n  fix: if the server runs older code, redeploy; if it is current, plugin route registration was dropped — check the boot line \"plugin routes registered\"";
+}, T = (e) => {
+	let { exercised: t, total: n } = e.coverage;
+	if (n === 0) return "\nobserved: no procedures declared — nothing to compare";
+	let r = `\nobserved: ${t}/${n} procedures exercised (${Math.round(t / n * 100)}%)`, i = Object.keys(C).map((t) => [t, e[t].length]).filter(([, e]) => e > 0), a = i.reduce((e, [, t]) => e + t, t), o = [...i.map(([e, t]) => `  ${C[e](t)}`), ...a === n ? [] : [`  ⚠ ${n - a} of the declared procedures are in none of the counts above — that is a defect in \`voltro check\`, please report it`]].join("\n");
+	if (e.diagnostics.length > 0) {
+		let n = e.diagnostics.length;
+		return [
+			r,
+			`  ${n} declared/observed mismatch${n === 1 ? "" : "es"} among the ${t} that ran`,
+			...e.diagnostics.map((e) => `  ${e.node}${e.file === void 0 ? "" : ` (${e.file})`}\n` + e.breaks.map((e) => `    ${e}`).join("\n") + `\n    fix: ${e.fix}`),
+			...o === "" ? [] : [o]
+		].join("\n");
+	}
+	return [
+		r,
+		t === 0 ? "  nothing was compared — a declaration is only checked against a procedure that RAN" : `  no declared/observed mismatch among the ${t} that ran`,
+		...o === "" ? [] : [o]
+	].join("\n");
+}, E = (e, t) => ({
 	tables: (t.tables ?? []).map((e) => e.name),
-	frameworkOwnedTables: (t.tables ?? []).filter((e) => e.framework === !0 || e.name.startsWith("_voltro_") || b.has(e.name)).map((e) => e.name),
+	frameworkOwnedTables: (t.tables ?? []).filter((e) => e.framework === !0 || e.name.startsWith("_voltro_") || x.has(e.name)).map((e) => e.name),
 	scopes: e.scopes ?? [],
 	procedures: (e.procedures ?? []).map((e) => {
 		let t = (e.guards ?? []).flatMap((e) => e.kind === "scope" ? e.scope ?? [] : []), n = (e.guards ?? []).find((e) => e.kind === "open")?.reason;
@@ -146,27 +166,41 @@ var m = (e) => e === void 0 ? [] : typeof e == "string" ? [e] : e, h = {
 			...e.internal === !0 ? { internal: !0 } : {}
 		};
 	})
-}), w = (e) => e.length === 0 ? "✓ voltro check: no issues" : e.map((e) => {
+}), D = (e) => e.length === 0 ? "✓ voltro check: no issues" : e.map((e) => {
 	let t = e.severity === "error" ? "✗ error" : "⚠ warn", n = e.file ? ` (${e.file})` : "";
 	return `${t}  ${e.rule}  ${e.node}${n}\n    ${e.breaks.join("; ")}\n    fix: ${e.fix}`;
-}).join("\n"), T = async (e) => {
-	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev-Dz9GqA6P.js"), { buildRpcEntry: i } = await import("./manifestBuild-CPjhvM62.js"), { buildCapabilityManifest: a } = await import("./inspect-CuGDYES0.js"), { relative: o } = await import("node:path"), s = await n(await t(e)), c = (t, n, r) => i(t, n, o(e, r)), l = [
-		...s.queries.map((e) => c(e.descriptor, "query", e.file)),
-		...s.mutations.map((e) => c(e.descriptor, "mutation", e.file)),
-		...s.actions.map((e) => c(e.descriptor, "action", e.file)),
-		...s.streams.map((e) => c(e.descriptor, "stream", e.file))
-	], { assembleFrameworkTables: u } = await import("./frameworkTableAssembly-CVDB2hCq.js"), d = await u({ root: e }).catch((e) => (console.warn(`\n⚠  plugin tables could not be collected — this report is INCOMPLETE.\n   ${e instanceof Error ? e.message.split("\n")[0] : String(e)}\n`), [])), f = new Set(s.tables.map((e) => e.tableName)), p = [...[...f].map((e) => ({ name: e })), ...d.map((e) => e.tableName).filter((e) => !f.has(e)).map((e) => ({
+}).join("\n"), O = async (e) => {
+	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev--A3nsxA3.js"), { buildRpcEntry: i } = await import("./manifestBuild-CPjhvM62.js"), { buildCapabilityManifest: a } = await import("./inspect-CuGDYES0.js"), { relative: o } = await import("node:path"), s = await n(await t(e)), c = await r(e).then((e) => e?.plugins ?? []).catch(() => []);
+	try {
+		let { mergePluginRoutesInto: e } = await import("./dev--A3nsxA3.js");
+		e({
+			plugins: c,
+			queries: s.queries,
+			mutations: s.mutations,
+			actions: s.actions,
+			streams: s.streams,
+			log: { info: () => {} }
+		});
+	} catch (e) {
+		console.warn(`\n⚠  plugin rpc routes could not be merged — this report is INCOMPLETE.\n   ${e instanceof Error ? e.message.split("\n")[0] : String(e)}\n`);
+	}
+	let l = (t, n, r) => i(t, n, r.startsWith("plugin:") ? r : o(e, r)), u = [
+		...s.queries.map((e) => l(e.descriptor, "query", e.file)),
+		...s.mutations.map((e) => l(e.descriptor, "mutation", e.file)),
+		...s.actions.map((e) => l(e.descriptor, "action", e.file)),
+		...s.streams.map((e) => l(e.descriptor, "stream", e.file))
+	], { assembleFrameworkTables: d } = await import("./frameworkTableAssembly-C6ETawPR.js"), f = await d({ root: e }).catch((e) => (console.warn(`\n⚠  plugin tables could not be collected — this report is INCOMPLETE.\n   ${e instanceof Error ? e.message.split("\n")[0] : String(e)}\n`), [])), p = new Set(s.tables.map((e) => e.tableName)), m = [...[...p].map((e) => ({ name: e })), ...f.map((e) => e.tableName).filter((e) => !p.has(e)).map((e) => ({
 		name: e,
 		framework: !0
-	}))], m = await r(e).then((e) => e?.plugins ?? []).catch(() => []);
+	}))], h = c;
 	return {
-		manifest: a(l, s.workflows.map((t) => ({
+		manifest: a(u, s.workflows.map((t) => ({
 			tag: t.definition.name ?? "",
 			file: o(e, t.file)
-		})), [], m),
-		tables: { tables: p }
+		})), [], h),
+		tables: { tables: m }
 	};
-}, E = async (t) => {
+}, k = async (t) => {
 	let f = t.flatMap((e) => e === "--json" ? ["--format", "json"] : [e]), p = a(f);
 	if ("error" in p) return console.error(`voltro check: ${p.error}`), 1;
 	let { process: m, target: h, rest: g } = s(p.rest), _;
@@ -186,56 +220,69 @@ var m = (e) => e === void 0 ? [] : typeof e == "string" ? [e] : e, h = {
 		};
 		else return console.error("voltro check --diff: expected removeTable:<name> | removeProcedure:<tag> | removeScope:<name>"), 1;
 	}
-	let b = e(g, ["--diff"]) ?? process.cwd(), E = g.includes("--offline"), D = E ? [] : await o(m, h), O, k;
-	if (D.length === 0) {
-		if (!E && h !== void 0) return console.error("voltro check: --url given but no api reachable there."), 1;
+	let v = e(g, ["--diff"]) ?? process.cwd(), x = g.includes("--offline"), C = x ? [] : await o(m, h), k, A;
+	if (C.length === 0) {
+		if (!x && h !== void 0) return console.error("voltro check: --url given but no api reachable there."), 1;
 		try {
-			let e = await T(d(b));
-			O = e.manifest, k = e.tables;
+			let e = await O(d(v));
+			k = e.manifest, A = e.tables;
 		} catch (e) {
 			return console.error(`voltro check: could not assemble the graph from source: ${e.message}`), console.error("  Start `voltro dev` to check against a running api instead."), 1;
 		}
 	} else {
-		let e = D[0], [t, n] = await Promise.all([c(e, "/_voltro/inspect/manifest"), c(e, "/_voltro/inspect/data/tables")]);
+		let e = C[0], [t, n] = await Promise.all([c(e, "/_voltro/inspect/manifest"), c(e, "/_voltro/inspect/data/tables")]);
 		if (t.kind === "err") return console.error(`voltro check: manifest fetch failed: ${t.error}`), 1;
-		O = t.data, k = n.kind === "ok" ? n.data : { tables: [] };
+		k = t.data, A = n.kind === "ok" ? n.data : { tables: [] };
 	}
-	let A = C(O, k), j = r(A, _), M = [...l(b).findings.map((e) => ({
+	let j = E(k, A), M = r(j, _), N = "";
+	if (C.length > 0) try {
+		N = w(((await O(d(v))).manifest.procedures ?? []).map((e) => e.tag), new Set((k.procedures ?? []).map((e) => e.tag)));
+	} catch {
+		N = "\ndeclared vs live: skipped — no app source at this root to compare against";
+	}
+	let P = [...l(v).findings.map((e) => ({
 		rule: e.rule,
 		node: e.file,
 		file: e.file,
 		breaks: [e.detail],
 		fix: e.fix,
 		severity: e.severity
-	})), ...u(b).map((e) => ({
+	})), ...u(v).map((e) => ({
 		rule: `page/${e.kind}`,
 		node: e.file,
 		file: e.file,
 		breaks: [e.kind === "suffixed-outside-pages" ? "a page.tsx outside src/pages/ never routes" : "no test beside it"],
 		fix: e.kind === "suffixed-outside-pages" ? "move it under src/pages/ into the directory whose route it serves, or rename it — page.tsx is reserved" : "write the test with the file — the name is derivable",
 		severity: e.kind === "suffixed-outside-pages" ? "error" : "warn"
-	}))], N = (await n(b, y(b))).map((e) => ({
+	}))], F = (await n(v, b(v))).map((e) => ({
 		rule: "client/not-browser-safe",
 		node: e.file,
 		file: e.file,
 		breaks: [`reaches the server-only '${e.violation.specifier}' — chain: ${e.violation.chain.join(" → ")}`],
 		fix: "move the server-only code behind a *.server.ts, or drop the .client suffix — an unmarked file makes no claim",
 		severity: "error"
-	})), P = [
-		...j.diagnostics,
-		...M,
-		...N
-	], F = j.ok && !M.some((e) => e.severity === "error") && N.length === 0, I = await x(d(b)), L = I === null ? null : v(A.procedures, I);
-	return p.format === "json" ? i(L === null ? {
-		...j,
-		ok: F,
-		diagnostics: P
-	} : {
-		...j,
-		ok: F,
-		diagnostics: P,
-		observed: L
-	}) : (console.log(w(P)), L !== null && console.log(S(L)), console.log(F ? "\nvoltro check: OK" : "\nvoltro check: FAILED (errors above)")), +!F;
+	})), I = [
+		...M.diagnostics,
+		...P,
+		...F
+	], L = M.ok && !P.some((e) => e.severity === "error") && F.length === 0, R = await S(d(v)), z = R === null ? null : y(j.procedures, R);
+	if (p.format === "json") {
+		let e = z === null ? {
+			...M,
+			ok: L,
+			diagnostics: I
+		} : {
+			...M,
+			ok: L,
+			diagnostics: I,
+			observed: z
+		};
+		i(N === "" ? e : {
+			...e,
+			declaredVsLive: N.trim()
+		});
+	} else console.log(D(I)), z !== null && console.log(T(z)), N !== "" && console.log(N), console.log(L ? "\nvoltro check: OK" : "\nvoltro check: FAILED (errors above)");
+	return +!L;
 };
 //#endregion
-export { E as n, C as r, T as t };
+export { k as a, O as i, w as n, E as o, T as r, C as t };

package/dist/{cloudCmd-F4YJeqM3.js → cloudCmd-QUXh-b5w.js}

@@ -1,7 +1,7 @@
 import { a as e, t } from "./cliArgs-D4p8n7EE.js";
 import { a as n, i as r, n as i, r as a, t as o } from "./cloudClient-DWL-Hw_T.js";
 import { n as s } from "./cliOutput-D1tSBoRM.js";
-import { d as c, f as l, o as u } from "./projectScaffold-mIX_DpSe.js";
+import { d as c, f as l, o as u } from "./projectScaffold-B4dmTlwT.js";
 import { basename as d, join as f, resolve as p } from "node:path";
 import { promises as m } from "node:fs";
 import { ansi as h } from "@voltro/logger";

package/dist/codegen-CctkDO-1.js

@@ -0,0 +1,2 @@
+import { t as e } from "./codegen-VF479Cnb.js";
+export { e as checkRpcGroupFreshness };

package/dist/{codegen-CrMXs4hb.js → codegen-VF479Cnb.js}

@@ -1,4 +1,4 @@
-import { b as e, o as t, y as n } from "./fileConventions-Cof68_BL.js";
+import { b as e, o as t, y as n } from "./fileConventions-DOqD3lPS.js";
 import { dirname as r, join as i, relative as a, resolve as o } from "node:path";
 import { promises as s, readFileSync as c } from "node:fs";
 import { pathToFileURL as l } from "node:url";

package/dist/{codegenCommand-C0S27nbB.js → codegenCommand-DCdG2JN-.js}

@@ -1,7 +1,7 @@
-import { B as e, Sn as t, l as n, u as r, xn as i } from "./dev-C0cbqysu.js";
-import { dt as a } from "./webDev-BbdkzMbd.js";
-import { n as o } from "./frameworkTableAssembly-BwJVEKLr.js";
-import { i as s, r as c } from "./codegen-CrMXs4hb.js";
+import { Cn as e, Sn as t, V as n, l as r, u as i } from "./dev-CRHoCEiy.js";
+import { Ct as a } from "./webDev-BgWL9gKV.js";
+import { n as o } from "./frameworkTableAssembly-w-XnLa3q.js";
+import { i as s, r as c } from "./codegen-VF479Cnb.js";
 import { basename as l, join as u, relative as d, resolve as f } from "node:path";
 import { promises as p } from "node:fs";
 import { pathToFileURL as m } from "node:url";
@@ -100,21 +100,21 @@ var h = "voltro.mobile.ts", g = u(".framework", "mobileApis.generated.ts"), _ =
 		file: i,
 		apis: r.map(([e]) => e)
 	};
-}, x = (e, t) => t.kind === "wrote" ? `voltro codegen: wrote ${d(e, t.file)} (apis ${t.apis.join(", ")})` : t.kind === "refused" ? `voltro codegen: ${t.reason} — refusing to write.` : `voltro codegen: no ${h} here — not a mobile app.`, S = async (r) => {
-	let { config: i, present: a, error: o } = await n(r);
+}, x = (e, t) => t.kind === "wrote" ? `voltro codegen: wrote ${d(e, t.file)} (apis ${t.apis.join(", ")})` : t.kind === "refused" ? `voltro codegen: ${t.reason} — refusing to write.` : `voltro codegen: no ${h} here — not a mobile app.`, S = async (t) => {
+	let { config: i, present: a, error: o } = await r(t);
 	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: u, pluginErrorImports: d, pluginRpcImports: f } = await e(s, i?.name ?? l(r), r), p = await c({
-		root: r,
+	let s = i?.plugins ?? [], { pluginContributions: u, pluginErrorImports: d, pluginRpcImports: f } = await n(s, i?.name ?? l(t), t), p = await c({
+		root: t,
 		...u.length > 0 ? { pluginContributions: u } : {},
 		...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 C(r, i), h = await t(p, m);
+	let m = await C(t, i), h = await e(p, m);
 	return {
 		kind: "wrote",
 		file: p,
@@ -124,9 +124,9 @@ var h = "voltro.mobile.ts", g = u(".framework", "mobileApis.generated.ts"), _ =
 		tables: m.size,
 		dts: h
 	};
-}, C = async (e, t) => {
-	let n = await s(e), { tables: a } = await r(n), c = await o({ root: e });
-	return i(a, c, t?.analytics?.tables ?? []);
+}, C = async (e, n) => {
+	let r = await s(e), { tables: a } = await i(r), c = await o({ root: e });
+	return t(a, c, n?.analytics?.tables ?? []);
 }, w = async (e) => {
 	let t = f(e.find((e) => !e.startsWith("-")) ?? process.cwd()), n = await b(t);
 	if (n.kind !== "not-a-mobile-app") return console.log(x(t, n)), n.kind === "wrote" ? 0 : 1;