@voltro/cli 0.53.0 → 0.54.0

package/templates/apps/mobile-app/tests/deeplinks.test.ts

@@ -1,11 +1,27 @@
+// Deep-link routing, against the GENERATED table.
+//
+// Nothing here names a hand-written link, because there are none: every
+// assertion below is about a link `voltro mobile codegen` derived from a screen
+// under `src/app/`. That is the property worth pinning — add
+// `src/app/invoices/[id].tsx` and `/invoices/42` starts working with no other
+// edit. These tests therefore need the table generated first, which is why the
+// `test` script runs codegen (the same way `start` / `ios` do).
 import { describe, expect, it, vi } from 'vitest'
 import { handleDeepLink, makeDeepLinks } from '../src/lib/deeplinks'
+import { DERIVED_DEEP_LINK_PATTERNS } from '../.framework/deepLinks.generated'
 
 describe('deep links', () => {
+  it('derives one link per screen — nobody wrote this table', () => {
+    // src/app/index.tsx, settings.tsx, orders/[id].tsx. `_layout.tsx` is a
+    // layout, not a screen, and must not be in here.
+    expect([...DERIVED_DEEP_LINK_PATTERNS].sort()).toEqual(['/', '/orders/:id', '/settings'])
+  })
+
   it('routes an order URL to the order screen with the captured id', () => {
     const navigate = vi.fn()
     const links = makeDeepLinks(navigate)
     expect(handleDeepLink(links, '/orders/42')).toBe(true)
+    // A derived link navigates to the screen it came from, params put back.
     expect(navigate).toHaveBeenCalledWith('/orders/42')
   })
 

package/dist/agentsMd-SDDSkyl4.js

@@ -1,2 +0,0 @@
-import { a as e } from "./agentsMd-0l980yhL.js";
-export { e as runAgentsMd };

package/dist/apiBuild-DHtLXYx9.js

@@ -1,2 +0,0 @@
-import { c as e, l as t } from "./apiBuild-CaPfoWku.js";
-export { e as runApiBuild, t as runServeBundleBuild };

package/dist/codegen-BWpt3VgF.js

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

package/dist/codegenCommand-BOiWQ5hz.js

@@ -1,137 +0,0 @@
-import { En as e, Tn as t, V as n, l as r, u as i } from "./dev-C6LGF4iY.js";
-import { Bt as a } from "./webDev-oczpugbx.js";
-import { n as o } from "./frameworkTableAssembly-DKx3ba3S.js";
-import { i as s, r as c } from "./codegen-FEk8AZHb.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";
-//#region src/mobileCodegen.ts
-var h = "voltro.mobile.ts", g = u(".framework", "mobileApis.generated.ts"), _ = (e) => e.replace(/[^a-zA-Z0-9]/g, "_"), v = async (e) => {
-	let t = u(e, h);
-	try {
-		await p.stat(t);
-	} catch {
-		return { present: !1 };
-	}
-	try {
-		let e = (await import(`${m(t).href}?t=${Date.now()}`)).default;
-		return e === void 0 || typeof e != "object" || e.apis === void 0 ? {
-			present: !0,
-			error: /* @__PURE__ */ Error(`${h} 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))
-		};
-	}
-}, y = (e, t) => {
-	let n = t.filter(([, e]) => e.package !== void 0).map(([e, t]) => {
-		let n = `${_(e)}Group`, r = `${_(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 ${h} to get typed hooks for it.` : `  { ${[
-		`name: ${JSON.stringify(e)}`,
-		`group: ${_(e)}Group`,
-		`descriptors: ${_(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 ${h}. 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 ${h} for apis this app does not build. */`,
-			"export const MOBILE_API_URLS: Readonly<Record<string, string>> = {",
-			...i,
-			"}"
-		] : [],
-		""
-	].join("\n");
-}, b = async (e) => {
-	let t = f(e), n = await v(t);
-	if (!n.present) return { kind: "not-a-mobile-app" };
-	if ("error" in n) return {
-		kind: "refused",
-		reason: `${h} could not be loaded — ${n.error.message}`
-	};
-	let r = Object.entries(n.binding.apis);
-	if (r.length === 0) return {
-		kind: "refused",
-		reason: `${h} 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 = u(t, g), o = y(t, r);
-	await p.mkdir(u(t, ".framework"), { recursive: !0 });
-	let s = null;
-	try {
-		s = await p.readFile(i, "utf8");
-	} catch {}
-	return s !== o && await p.writeFile(i, o, "utf8"), {
-		kind: "wrote",
-		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 (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 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(t, i), h = await e(p, m);
-	return {
-		kind: "wrote",
-		file: p,
-		plugins: s.length,
-		errorSchemas: d.length,
-		routes: f.length,
-		tables: m.size,
-		dts: h
-	};
-}, 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;
-	let r = await S(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 { S as regenerateRpcGroup, w as runCodegenCommand };

package/dist/dbCommand-B1EXBC6f.js

@@ -1,2 +0,0 @@
-import { c as e } from "./dbCommand-06O2finM.js";
-export { e as runDbCommand };

package/dist/doctorCommand-B0hX0tdz.js

@@ -1,2 +0,0 @@
-import { b as e, y as t } from "./doctorCommand-etMkflRc.js";
-export { t as runDoctorCommand, e as runServePreflight };

package/dist/fileConventions-DASGEmj-.js

@@ -1,35 +0,0 @@
-//#region src/fileConventions.ts
-var e = /\.(query|mutation|action|stream)\.ts$/, t = /\.(query|mutation|action|stream)\.server\.ts$/, n = /\.event\.ts$/, r = /\.ws\.ts$/, i = /\.workflow\.tsx$/, a = /\.workflow\.server\.tsx$/, o = /\.workflow\.tsx?$/, s = /\.trigger\.tsx?$/, c = /\.cron\.tsx?$/, l = /\.webhook\.tsx?$/, u = /\.outbox\.tsx?$/, d = /\.consumer\.tsx?$/, f = /\.subscribe\.tsx?$/, p = /\.reaction\.tsx?$/, m = /\.aggregate\.tsx?$/, h = /\.expectation\.ts$/, g = /\.budget\.ts$/, _ = /\.experiment\.ts$/, v = /\.startup\.tsx?$/, y = /\.seed\.ts$/, b = /\.relations\.ts$/, x = /\.entity\.ts$|\.schema\.ts$|^schema\.ts$/, S = (e) => o.test(e) && !i.test(e) && !a.test(e), C = /(?:^|\/)page\.tsx$/, w = /\.island\.tsx?$/, T = /\.component\.tsx$/, E = /\.component\.ui\.tsx$/, D = /\.hook\.tsx?$/, O = /\.internal\.tsx?$/, k = /\.types\.tsx?$/, A = /\.fixture\.tsx?$/, j = /\.tracking\.tsx?$/, M = /\.store\.tsx?$/, N = /\.client\.tsx?$/, P = /\.(test|spec)\.tsx?$/, F = [
-	e,
-	t,
-	o,
-	a,
-	s,
-	c,
-	l,
-	u,
-	d,
-	f,
-	p,
-	m,
-	v,
-	h,
-	g,
-	_,
-	y,
-	b,
-	x,
-	/\.route\.tsx?$/,
-	n,
-	r,
-	M,
-	N,
-	/\.(agent|tool|email|connection|serverless|server|config|generated)\.tsx?$/
-], I = (e) => F.some((t) => t.test(e)), L = /* @__PURE__ */ new Set([
-	"layout.tsx",
-	"error.tsx",
-	"loading.tsx",
-	"not-found.tsx"
-]);
-//#endregion
-export { l as A, v as C, j as D, P as E, I as F, S as I, o as M, a as N, s as O, r as P, y as S, f as T, e as _, d as a, b, h as c, D as d, O as f, L as g, C as h, E as i, i as j, k, _ as l, u as m, g as n, c as o, w as p, T as r, n as s, m as t, A as u, t as v, M as w, x, p as y };

package/dist/frameworkTableAssembly-C_7Z-rMs.js

@@ -1,2 +0,0 @@
-import { c as e, n as t } from "./frameworkTableAssembly-DKx3ba3S.js";
-export { t as assembleFrameworkTables, e as loadAppSchemaInputs };

package/dist/renderModeScan-CUbOeOAg.js

@@ -1,122 +0,0 @@
-import { join as e } from "node:path";
-import { readFile as t } from "node:fs/promises";
-//#region src/isrCache.ts
-var n = () => {
-	let e = /* @__PURE__ */ new Map(), t = /* @__PURE__ */ new Map(), n = (e) => {
-		t.set(e, (t.get(e) ?? 0) + 1);
-	};
-	return {
-		get(t) {
-			return e.get(t);
-		},
-		set(n, r, i) {
-			return i?.ifGeneration !== void 0 && (t.get(n) ?? 0) !== i.ifGeneration ? !1 : (e.set(n, r), !0);
-		},
-		generation(e) {
-			return t.get(e) ?? 0;
-		},
-		invalidate(t) {
-			e.delete(t), n(t);
-		},
-		invalidateBy(t) {
-			let r = 0;
-			for (let i of e.keys()) t(i) && (e.delete(i), n(i), r++);
-			return r;
-		},
-		clear() {
-			for (let t of e.keys()) n(t);
-			e.clear();
-		},
-		size() {
-			return e.size;
-		},
-		snapshot() {
-			return Array.from(e.entries());
-		}
-	};
-}, r = (e) => {
-	if (typeof e == "number" && Number.isFinite(e) && e > 0) return e * 1e3;
-	if (typeof e != "string") return null;
-	let t = /^\s*(\d+)\s*(s|seconds?|m|minutes?|h|hours?|d|days?)\s*$/i.exec(e);
-	if (!t) return null;
-	let n = parseInt(t[1], 10);
-	if (!Number.isFinite(n) || n <= 0) return null;
-	let r = t[2].toLowerCase();
-	return r === "s" || r.startsWith("second") ? n * 1e3 : r === "m" || r.startsWith("minute") ? n * 6e4 : r === "h" || r.startsWith("hour") ? n * 36e5 : r === "d" || r.startsWith("day") ? n * 864e5 : null;
-}, i = (e, t = {}) => {
-	let n = [e];
-	return t.tenant !== void 0 && t.tenant !== "" && n.push(`tenant=${t.tenant}`), t.locale !== void 0 && t.locale !== "" && n.push(`lang=${t.locale}`), n.join("|");
-}, a = (e, t) => e.expiresAt > t, o = (e, t) => e.expiresAt <= t && e.servableUntil > t, s = [
-	"static",
-	"spa",
-	"ssr",
-	"isr"
-], c = (e) => typeof e == "string" && s.includes(e), l = s.map((e) => `'${e}'`).join(" | "), u = (e, t) => `[voltro] ${e}: unknown renderMode '${t}'.\n  Valid values: ${l}.${t === "client" || t === "csr" || t === "browser" ? "\n  A page that renders only in the browser is 'spa': it is skipped by the prerender and mounts on the client. If its route has a layout, that layout still renders server-side as an SSR shell." : t === "server" || t === "dynamic" ? "\n  A page rendered per request is 'ssr'." : t === "ssg" || t === "prerender" ? "\n  A page rendered once at build time is 'static' (the default)." : ""}`, d = class extends Error {
-	page;
-	value;
-	name = "InvalidRenderModeError";
-	constructor(e, t) {
-		super(u(e, t)), this.page = e, this.value = t;
-	}
-}, f = (e, t = "<page>") => {
-	if (e.renderMode !== void 0 && e.renderMode !== null) {
-		if (!c(e.renderMode)) throw new d(t, String(e.renderMode));
-		return e.renderMode;
-	}
-	return e.dynamic === "force-dynamic" ? "ssr" : (e.dynamic, "static");
-}, p = (e, t = "<page>") => ({
-	renderMode: f(e, t),
-	tenantAware: e.tenantAware === !0,
-	revalidateMs: r(e.revalidate),
-	staleWhileRevalidateMs: r(e.staleWhileRevalidate) ?? 0,
-	cacheInvalidatesOn: Array.isArray(e.cacheInvalidatesOn) ? e.cacheInvalidatesOn : [],
-	interactive: e.interactive ?? "full",
-	hasLoader: typeof e.loader == "function",
-	hasMeta: e.meta != null,
-	hasGetStaticPaths: typeof e.getStaticPaths == "function",
-	hasOgImage: typeof e.ogImage == "function",
-	ppr: e.ppr === !0
-}), m = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, h = (e) => m.exec(e)?.[1] ?? null, g = /export\s*\{([^}]*)\}\s*from\s*['"]([^'"]+)['"]/g, _ = (e) => {
-	g.lastIndex = 0;
-	let t;
-	for (; (t = g.exec(e)) !== null;) {
-		let e = t[2];
-		if (e.startsWith(".")) for (let n of t[1].split(",")) {
-			let t = n.lastIndexOf(" as ");
-			if ((t === -1 ? n : n.slice(t + 4)).trim() === "renderMode") return e;
-		}
-	}
-	return null;
-}, v = /export\s*\{([^}]*)\}/g, y = (e) => {
-	if (/export\s+default\b/.test(e)) return !0;
-	v.lastIndex = 0;
-	let t;
-	for (; (t = v.exec(e)) !== null;) for (let e of t[1].split(",")) {
-		let t = e.lastIndexOf(" as ");
-		if ((t === -1 ? e : e.slice(t + 4)).trim() === "default") return !0;
-	}
-	return !1;
-}, b = (e) => {
-	if (/^export const searchParams\b/m.test(e)) return !0;
-	v.lastIndex = 0;
-	let t;
-	for (; (t = v.exec(e)) !== null;) for (let e of t[1].split(",")) {
-		let t = e.lastIndexOf(" as ");
-		if ((t === -1 ? e : e.slice(t + 4)).trim() === "searchParams") return !0;
-	}
-	return !1;
-}, x = async (n, r) => {
-	let i = (await Promise.all(r.map(async (r) => {
-		let i;
-		try {
-			i = await t(e(n, r.file), "utf8");
-		} catch {
-			return null;
-		}
-		let a = h(i);
-		return a !== null && !c(a) ? u(e("src", "pages", r.file), a) : a === "isr" && b(i) ? `${e("src", "pages", r.file)} declares BOTH renderMode 'isr' and a \`searchParams\` schema.\n\n  The isr cache is keyed by path (plus tenant+locale) — the query string is not part of\n  the key, so the first request's variant would be cached and served for every other\n  query. A page whose render varies by search params cannot be isr-cached safely.\n\n  Fix: use \`renderMode: 'ssr'\` (per-request render, params fully honoured), or remove\n  the \`searchParams\` export and read the query client-side only.` : y(i) ? null : `${e("src", "pages", r.file)} is a route (a \`page.tsx\` under src/pages/) but exports no default.\n\n  A page's default export IS its component — the router has nothing to render without it,\n  and the failure would otherwise surface only in \`voltro build\`'s prerender as\n  "SSR received a descriptor with no Component", long after the file was written.\n\n  Fix: \`export default function Page() { … }\`, or re-export another page's component\n  (\`export { default } from '../page'\`). If this file is NOT a route, rename it —\n  only the reserved names route, and anything else under src/pages/ is ordinary code\n  that may live beside the page that uses it.`;
-	}))).filter((e) => e !== null);
-	if (i.length !== 0) throw Error(i.join("\n\n"));
-};
-//#endregion
-export { p as a, f as c, o as d, n as f, s as i, i as l, h as n, c as o, r as p, _ as r, u as s, x as t, a as u };

package/dist/serveCommand-DsnrVN3U.js

@@ -1,2 +0,0 @@
-import { n as e } from "./serveCommand-CueKQgzl.js";
-export { e as runServeDispatch };

package/dist/start-BJzZLbt8.js

@@ -1,3 +0,0 @@
-import "./renderModeScan-CUbOeOAg.js";
-import { t as e } from "./start-ekPan8BT.js";
-export { e as runStartCommand };

package/dist/updateCommand-Bqql_rsQ.js

@@ -1,2 +0,0 @@
-import { m as e, p as t } from "./updateCommand-C_8I8Rzo.js";
-export { t as runApplyCodemods, e as runUpdateCommand };