@voltro/cli 0.52.0 → 0.54.0

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

@@ -1,10 +1,10 @@
 import { t as e } from "./cliArgs-D4p8n7EE.js";
-import { a as t, l as n } from "./codegen-VF479Cnb.js";
+import { a as t, l as n } from "./codegen-DSLM8Su9.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-DvDUV9wq.js";
-import { S as u } from "./doctorCommand-DtfJ3FA6.js";
+import { r as l } from "./fileTaxonomy-CbyMQYx_.js";
+import { S as u } from "./doctorCommand-DCiFVMtZ.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";
@@ -170,9 +170,9 @@ var h = (e) => (e === void 0 ? [] : typeof e == "string" ? [e] : e).filter((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"), 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(() => []);
+	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev-cKUiZZsB.js"), { buildRpcEntry: i } = await import("./manifestBuild-C4-J1-m_.js"), { buildCapabilityManifest: a } = await import("./inspect-CuoDInfZ.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");
+		let { mergePluginRoutesInto: e } = await import("./dev-cKUiZZsB.js");
 		e({
 			plugins: c,
 			queries: s.queries,
@@ -189,7 +189,7 @@ var h = (e) => (e === void 0 ? [] : typeof e == "string" ? [e] : e).filter((e) =
 		...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) => ({
+	], { assembleFrameworkTables: d } = await import("./frameworkTableAssembly-IPD1pUnZ.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
 	}))], h = c;

package/dist/{checkCommand-2SbqzukH.js → checkCommand-L7DTlpIF.js}

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

package/dist/{cloudCmd-QUXh-b5w.js → cloudCmd-DzKcSYuy.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-B4dmTlwT.js";
+import { d as c, f as l, o as u } from "./projectScaffold-CSN0OzBV.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-VF479Cnb.js → codegen-DSLM8Su9.js}

@@ -1,4 +1,4 @@
-import { b as e, o as t, y as n } from "./fileConventions-DOqD3lPS.js";
+import { S as e, c as t, x as n } from "./fileConventions-l-RIXbx8.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/codegen-DjgxEOnD.js

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

package/dist/codegenCommand-CG_Vx4lc.js

@@ -0,0 +1,41 @@
+import { Dn as e, En as t, V as n, l as r, u as i } from "./dev-CmuvUKRq.js";
+import { n as a } from "./frameworkTableAssembly-D7LJuALW.js";
+import { i as o, r as s } from "./codegen-DSLM8Su9.js";
+import { n as c, r as l } from "./mobileCommand-D9O6iq3D.js";
+import { basename as u, relative as d, resolve as f } from "node:path";
+//#region src/codegenCommand.ts
+var p = 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 c = i?.plugins ?? [], { pluginContributions: l, pluginErrorImports: d, pluginRpcImports: f } = await n(c, i?.name ?? u(t), t), p = await s({
+		root: t,
+		...l.length > 0 ? { pluginContributions: l } : {},
+		...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 h = await m(t, i), g = await e(p, h);
+	return {
+		kind: "wrote",
+		file: p,
+		plugins: c.length,
+		errorSchemas: d.length,
+		routes: f.length,
+		tables: h.size,
+		dts: g
+	};
+}, m = async (e, n) => {
+	let r = await o(e), { tables: s } = await i(r), c = await a({ root: e });
+	return t(s, c, n?.analytics?.tables ?? []);
+}, h = async (e) => {
+	let t = f(e.find((e) => !e.startsWith("-")) ?? process.cwd()), n = await l(t);
+	if (n.apis.kind !== "not-a-mobile-app") return c(t, n);
+	let r = await p(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 ${d(t, r.file)} (plugins ${r.plugins}, error schemas ${r.errorSchemas}, plugin routes ${r.routes})`), console.log(r.dts.action === "removed" ? `  removed ${d(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} ${d(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 { p as regenerateRpcGroup, h as runCodegenCommand };

package/dist/{codemodRunner-r7J9lIa7.js → codemodRunner-Cd4xkC6u.js}

@@ -1,7 +1,7 @@
-import { E as e, O as t, P as n, T as r, d as i, f as a, h as o, i as s, l as c, r as l, u } from "./fileConventions-DOqD3lPS.js";
-import { t as d } from "./pageConvention-CzUiSbtU.js";
+import { A as e, D as t, I as n, O as r, _ as i, d as a, f as o, i as s, m as c, p as l, r as u } from "./fileConventions-l-RIXbx8.js";
+import { t as d } from "./pageConvention-CMpfDN6r.js";
 import { r as f } from "./tsconfigPaths-BWXBWgcl.js";
-import { a as p, i as m, t as h } from "./fileTaxonomy-DvDUV9wq.js";
+import { a as p, i as m, t as h } from "./fileTaxonomy-CbyMQYx_.js";
 import { basename as g, dirname as _, join as v, relative as ee } from "node:path";
 import { existsSync as y, readFileSync as te, statSync as ne } from "node:fs";
 import { execFileSync as re } from "node:child_process";
@@ -1503,7 +1503,7 @@ var S = (e, t, n) => {
 }, dt = /\.page\.tsx$/, F = (e) => {
 	let t = e.includes("\\src\\pages\\") ? "\\src\\pages\\" : "/src/pages/", n = e.indexOf(t);
 	return n === -1 ? null : e.slice(0, n);
-}, ft = (e) => e.endsWith(".tsx") && !o.has(e) && !d(e) && !/\.island\.tsx$/.test(e) && !dt.test(e), pt = w({
+}, ft = (e) => e.endsWith(".tsx") && !i.has(e) && !d(e) && !/\.island\.tsx$/.test(e) && !dt.test(e), pt = w({
 	version: "0.14.0",
 	id: "0.14.0/03_pages-suffix",
 	title: "Pages are declared with a .page.tsx suffix",
@@ -1553,18 +1553,18 @@ var S = (e, t, n) => {
 	}
 }), mt = [
 	/\.page\.tsx$/,
-	a,
+	c,
 	s,
-	l,
 	u,
-	t,
-	i,
-	c,
+	o,
 	e,
-	r
+	l,
+	a,
+	r,
+	t
 ], ht = (e) => {
 	let t = g(e);
-	return !/\.tsx?$/.test(t) || o.has(t) || n(t) || t === "index.ts" || t === "index.tsx" || t === "app.config.ts" ? !1 : !mt.some((e) => e.test(t));
+	return !/\.tsx?$/.test(t) || i.has(t) || n(t) || t === "index.ts" || t === "index.tsx" || t === "app.config.ts" ? !1 : !mt.some((e) => e.test(t));
 }, gt = (e) => {
 	let t = [], n = [], r = [], i = [];
 	for (let [a, o] of e.getExportedDeclarations()) {
@@ -6032,6 +6032,104 @@ var S = (e, t, n) => {
 			"    (that is what plugin-ratelimit's httpShield does now — a Redis outage",
 			"    must not become a self-inflicted API outage)."
 		].join("\n")
+	}),
+	w({
+		version: "0.53.0",
+		id: "0.53.0/01_conflict-columns-take-the-table",
+		title: "`missingConflictColumns` takes the table and classifies absent vs NULL",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => e.getFullText().includes("missingConflictColumns")),
+		note: [
+			"`missingConflictColumns(conflictColumns, row)` is now",
+			"`missingConflictColumns(table, conflictColumns, row)`, and it returns",
+			"`{ column, reason: \"absent\" | \"null\" }` entries instead of bare names.",
+			"",
+			"Pass the table definition (the same value `missingRequiredColumns` takes).",
+			"With it, DB-generated columns (`generatedAs`) are skipped: the database",
+			"computes those and rejects an explicit value, so their absence from a",
+			"payload is correct — the old signature could not know that and flagged",
+			"them. Pass `undefined` only when no definition is available; nothing is",
+			"skipped then.",
+			"",
+			"The `reason` field separates two different bugs the old flat list merged:",
+			"`absent` (the payload never set the key) and `null` (the key is present but",
+			"NULL — and NULL never matches a unique conflict target, so the write would",
+			"always INSERT; use a plain insert for NULL-keyed rows, or make the column",
+			"NOT NULL)."
+		].join("\n")
+	}),
+	w({
+		version: "0.53.0",
+		id: "0.53.0/02_empty-struct-input-flipped",
+		title: "`input: Schema.Struct({})` procedures flipped from accept-everything to reject-everything in 0.37.0",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => /input:\s*Schema\.Struct\(\{\s*\}\)/.test(e.getFullText())),
+		note: [
+			"This repository declares procedures with `input: Schema.Struct({})`. Since",
+			"0.37.0 (an undeclared input field rejects the call), that shape flipped",
+			"HARDER than any other: an empty struct used to accept every payload, and",
+			"now rejects every non-empty one. A caller that always sent a field —",
+			"a table hook sending `{ limit }`, say — fails on the live subscription and",
+			"the SSR seed of the same page at once.",
+			"",
+			"Check those procedures first — the list takes a minute to produce and",
+			"yields the most expensive hits:",
+			"",
+			"  grep -rn 'input: Schema.Struct({})' <api root>",
+			"",
+			"For each: either the callers genuinely send nothing (fine — the empty",
+			"struct is the strongest declaration a procedure can make), or a caller",
+			"sends fields the schema must now declare."
+		].join("\n")
+	}),
+	w({
+		version: "0.53.0",
+		id: "0.53.0/03_validation-messages-are-ids",
+		title: "Form validation messages are ids + catalog now, not effect developer text",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => {
+			let t = e.getFullText();
+			return /Expected .*, actual|is missing/.test(t) || /\.errors\[|useFormBinding\(/.test(t);
+		}),
+		note: [
+			"Form validation messages changed shape:",
+			"",
+			"- `errors[field]` values are TRANSLATED texts from a message catalog",
+			"  (built-in en/de, locale from `<html lang>` or the `locale:` option),",
+			"  no longer effect developer sentences. If you laid regexes over",
+			"  \"Expected string, actual undefined\" to derive translation keys,",
+			"  delete them and wire your catalog instead:",
+			"",
+			"    useFormBinding('users.create', { messages: (id, params) => t(id, params) })",
+			"",
+			"- `errors` keys are the FULL dotted path now (`address.city`,",
+			"  `entries.0.startsAt`) — a nested issue no longer collapses to its",
+			"  top-level segment. Code reading `errors.address` for a nested struct",
+			"  must read the leaf path it renders.",
+			"",
+			"- `validateFields` also returns `issues` — `{ path, id, params, fallback }`",
+			"  per failure — for widget kits that resolve messages themselves."
+		].join("\n")
+	}),
+	w({
+		version: "0.53.0",
+		id: "0.53.0/04_widget-kind-gained-array",
+		title: "WidgetKind gained 'array' and 'reference' — total widget registries need two new entries",
+		kind: "manual",
+		appliesTo: ({ project: e }) => e.getSourceFiles().some((e) => /Record<WidgetKind/.test(e.getFullText())),
+		note: [
+			"This repository types a widget registry as `Record<WidgetKind, …>`.",
+			"`WidgetKind` gained `'array'` (arrays of structs are field arrays now)",
+			"and `'reference'` (a formField({ reference }) table picker), so the total",
+			"map needs two new entries. With no dedicated UI yet, map both to your",
+			"custom/render-prop widget — that is what the built-in registry does:",
+			"",
+			"  array: CustomWidget,",
+			"  reference: CustomWidget,",
+			"",
+			"Partial registries (`Partial<Record<WidgetKind, …>>` or per-kind lookups)",
+			"need nothing."
+		].join("\n")
 	})
 ], J = /* @__PURE__ */ new Set([
 	"node_modules",