@voltro/cli 0.53.0 → 0.54.0

package/dist/mobileCommand-D9O6iq3D.js

@@ -0,0 +1,428 @@
+import { a as e, r as t } from "./subcommandNames-CDzfEtKV.js";
+import { t as n } from "./cliArgs-D4p8n7EE.js";
+import { s as r } from "./fileConventions-l-RIXbx8.js";
+import { t as i } from "./workspaceDeps-RKEkX92S.js";
+import { join as a, relative as o, resolve as s, sep as c } from "node:path";
+import { promises as l } from "node:fs";
+import { pathToFileURL as u } from "node:url";
+//#region src/mobileCodegen.ts
+var d = "voltro.mobile.ts", f = a(".framework", "mobileApis.generated.ts"), p = (e) => e.replace(/[^a-zA-Z0-9]/g, "_"), m = async (e) => {
+	let t = a(e, d);
+	try {
+		await l.stat(t);
+	} catch {
+		return { present: !1 };
+	}
+	try {
+		let e = (await import(`${u(t).href}?t=${Date.now()}`)).default;
+		return e === void 0 || typeof e != "object" || e.apis === void 0 ? {
+			present: !0,
+			error: /* @__PURE__ */ Error(`${d} 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))
+		};
+	}
+}, h = (e, t) => {
+	let n = t.filter(([, e]) => e.package !== void 0).map(([e, t]) => {
+		let n = `${p(e)}Group`, r = `${p(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 ${d} to get typed hooks for it.` : `  { ${[
+		`name: ${JSON.stringify(e)}`,
+		`group: ${p(e)}Group`,
+		`descriptors: ${p(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 ${d}. 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 ${d} for apis this app does not build. */`,
+			"export const MOBILE_API_URLS: Readonly<Record<string, string>> = {",
+			...i,
+			"}"
+		] : [],
+		""
+	].join("\n");
+}, g = async (e) => {
+	let t = s(e), n = await m(t);
+	if (!n.present) return { kind: "not-a-mobile-app" };
+	if ("error" in n) return {
+		kind: "refused",
+		reason: `${d} could not be loaded — ${n.error.message}`
+	};
+	let r = Object.entries(n.binding.apis);
+	if (r.length === 0) return {
+		kind: "refused",
+		reason: `${d} 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 i(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 o = a(t, f), c = h(t, r);
+	await l.mkdir(a(t, ".framework"), { recursive: !0 });
+	let u = null;
+	try {
+		u = await l.readFile(o, "utf8");
+	} catch {}
+	return u !== c && await l.writeFile(o, c, "utf8"), {
+		kind: "wrote",
+		file: o,
+		apis: r.map(([e]) => e)
+	};
+}, _ = (e, t) => t.kind === "wrote" ? `voltro codegen: wrote ${o(e, t.file)} (apis ${t.apis.join(", ")})` : t.kind === "refused" ? `voltro codegen: ${t.reason} — refusing to write.` : `voltro codegen: no ${d} here — not a mobile app.`, v = a(".framework", "deepLinks.generated.ts"), y = [a("src", "app"), "app"], b = /\.(tsx|ts|jsx|js)$/, x = (e) => {
+	let t = e.split(c).join("/");
+	if (!b.test(t)) return {
+		kind: "skip",
+		reason: "not a route file extension"
+	};
+	if (/\.(test|spec)\.[jt]sx?$/.test(t)) return {
+		kind: "skip",
+		reason: "a test file"
+	};
+	if (/\+api\.[jt]sx?$/.test(t) || /\+api\.[jt]sx?$/.test(t)) return {
+		kind: "skip",
+		reason: "an Expo Router API route, not a screen"
+	};
+	if (r.test(t)) return {
+		kind: "skip",
+		reason: "a *.deepLink.ts inside the router directory"
+	};
+	let n = t.replace(b, "").split("/"), i = [];
+	for (let [e, t] of n.entries()) {
+		let r = e === n.length - 1;
+		if (t.startsWith("+")) return {
+			kind: "skip",
+			reason: `\`${t}\` is an Expo Router special file, not a screen`
+		};
+		if (t.startsWith("_")) return {
+			kind: "skip",
+			reason: `\`${t}\` is not a route (Expo Router reserves the \`_\` prefix)`
+		};
+		if (t.startsWith(".")) return {
+			kind: "skip",
+			reason: "a dot-file"
+		};
+		if (!(t.startsWith("(") && t.endsWith(")"))) {
+			if (t.startsWith("[...") && t.endsWith("]")) return {
+				kind: "skip",
+				reason: `\`${t}\` is a catch-all — the matcher has no catch-all segment, so declare this one in a \`*.deepLink.ts\``
+			};
+			if (t.startsWith("[") && t.endsWith("]")) {
+				let e = t.slice(1, -1).replace(/^\[|\]$/g, "");
+				if (e.length === 0) return {
+					kind: "skip",
+					reason: "an empty dynamic segment"
+				};
+				i.push(`:${e}`);
+				continue;
+			}
+			r && t === "index" || i.push(t);
+		}
+	}
+	return {
+		kind: "route",
+		pattern: `/${i.join("/")}`.replace(/\/{2,}/g, "/")
+	};
+}, S = (e, t) => {
+	let n = e.split("/"), r = t.split("/");
+	for (let e = 0; e < Math.min(n.length, r.length); e++) {
+		let t = n[e].startsWith(":");
+		if (t !== r[e].startsWith(":")) return t ? 1 : -1;
+	}
+	return n.length === r.length ? e < t ? -1 : +(e > t) : n.length - r.length;
+}, C = async (e, t) => {
+	let n;
+	try {
+		n = await l.readdir(e, { withFileTypes: !0 });
+	} catch {
+		return;
+	}
+	for (let r of n) {
+		if (r.name.startsWith(".") || r.name === "node_modules") continue;
+		let n = a(e, r.name);
+		r.isDirectory() ? await C(n, t) : t(n);
+	}
+}, w = async (e) => {
+	try {
+		return await l.stat(e), !0;
+	} catch {
+		return !1;
+	}
+}, T = async (e) => {
+	for (let t of y) if (await w(a(e, t))) return t;
+	return null;
+}, E = async (e) => {
+	let t = await T(e), n = [], i = [];
+	if (await C(e, (a) => {
+		let s = o(e, a);
+		if (s.startsWith("..") || !r.test(a)) return;
+		let l = s.split(c).join("/");
+		if (t !== null && l.startsWith(`${t.split(c).join("/")}/`)) {
+			i.push(l);
+			return;
+		}
+		n.push({
+			file: l,
+			importPath: `../${l.replace(/\.ts$/, "")}`
+		});
+	}), i.length > 0) return {
+		kind: "refused",
+		reason: `${i.join(", ")} — a *.deepLink.ts inside \`${t}\` becomes a SCREEN. Expo Router routes every .ts/.tsx under its app directory, so this file ships a route named after itself. Move it outside the router directory (e.g. src/lib/).`
+	};
+	let s = [], l = [];
+	if (t !== null) {
+		let n = a(e, t);
+		await C(n, (t) => {
+			let r = x(o(n, t)), i = o(e, t).split(c).join("/");
+			r.kind === "route" ? s.push({
+				pattern: r.pattern,
+				file: i
+			}) : l.push({
+				file: i,
+				reason: r.reason
+			});
+		});
+	}
+	let u = /* @__PURE__ */ new Set(), d = s.sort((e, t) => S(e.pattern, t.pattern)).filter((e) => !u.has(e.pattern) && (u.add(e.pattern), !0));
+	return {
+		kind: "collected",
+		table: {
+			routerDir: t,
+			declared: n.sort((e, t) => e.file < t.file ? -1 : +(e.file > t.file)),
+			derived: d,
+			skipped: l.sort((e, t) => e.file < t.file ? -1 : +(e.file > t.file))
+		}
+	};
+}, D = (e) => `declared${e}`, O = (e) => {
+	let t = [
+		"// GENERATED BY `voltro mobile codegen` — do not edit; regenerate with",
+		"// `voltro mobile codegen`.",
+		"//",
+		"// The app's deep-link table, from two sources:",
+		"//",
+		`//   · DERIVED — one link per Expo Router screen under \`${e.routerDir ?? "(no router directory found)"}\`.`,
+		"//     A screen is reachable by URL, so its link needs no file.",
+		"//   · DECLARED — every `*.deepLink.ts` in the app. These come FIRST, so a",
+		"//     declared link for a pattern overrides the derived one for it.",
+		"",
+		"import { defineDeepLink, deepLinkHref, type DeepLinkDescriptor } from '@voltro/react-native'"
+	];
+	for (let [n, r] of e.declared.entries()) t.push(`import ${D(n)} from '${r.importPath}'`);
+	return t.push("", "/** Patterns derived from the router tree, most specific first. */", "export const DERIVED_DEEP_LINK_PATTERNS = [", ...e.derived.map((e) => `  ${JSON.stringify(e.pattern)}, // ${e.file}`), "] as const", "", "/** Deep links declared by hand (`*.deepLink.ts`). */", "export const DECLARED_DEEP_LINKS: ReadonlyArray<DeepLinkDescriptor> = [", ...e.declared.map((e, t) => `  ${D(t)}, // ${e.file}`), "]", ""), e.skipped.length > 0 && t.push("// Router files that are NOT deep links. Listed rather than dropped: a", "// screen missing from the table above is otherwise indistinguishable from", "// one that has no link.", ...e.skipped.map((e) => `//   ${e.file} — ${e.reason}`), ""), t.push("/**", " * The app's deep links, bound to a navigate function (expo-router's `router.push`).", " *", " * Order is the resolution order — `matchFirstDeepLink` is first-match-wins.", " * A derived pattern a declared link already covers is dropped here rather", " * than listed twice.", " */", "export const deepLinks = (", "  navigate: (href: string) => void,", "): ReadonlyArray<DeepLinkDescriptor> => {", "  const declaredPatterns = new Set(DECLARED_DEEP_LINKS.map((link) => link.pattern))", "  const derived: ReadonlyArray<string> = DERIVED_DEEP_LINK_PATTERNS", "  return [", "    ...DECLARED_DEEP_LINKS,", "    ...derived", "      .filter((pattern) => !declaredPatterns.has(pattern))", "      .map((pattern) =>", "        defineDeepLink({", "          pattern,", "          // A derived link navigates to the screen it was derived FROM —", "          // the same path, with the captured params put back.", "          handler: (params) => navigate(deepLinkHref(pattern, params)),", "        })),", "  ]", "}", ""), t.join("\n");
+}, k = async (e) => {
+	let t = await E(e);
+	if (t.kind === "refused") return t;
+	let n = a(e, v), r = O(t.table);
+	await l.mkdir(a(e, ".framework"), { recursive: !0 });
+	let i = null;
+	try {
+		i = await l.readFile(n, "utf8");
+	} catch {}
+	return i !== r && await l.writeFile(n, r, "utf8"), {
+		kind: "wrote",
+		file: n,
+		derived: t.table.derived.length,
+		declared: t.table.declared.length,
+		skipped: t.table.skipped,
+		routerDir: t.table.routerDir
+	};
+}, A = (e) => {
+	let t = /pattern\s*:\s*(['"`])(\/[^'"`\n]*)\1/.exec(e);
+	return t === null ? null : t[2];
+}, j = async (e, t) => {
+	let n = [], r = [];
+	for (let i of t.declared) {
+		let t = "";
+		try {
+			t = await l.readFile(a(e, i.file), "utf8");
+		} catch {}
+		let o = A(t);
+		o === null ? r.push(i.file) : n.push(o);
+	}
+	return {
+		patterns: n,
+		unreadable: r
+	};
+}, M = /^[A-Z0-9]{10}$/, N = /^[A-Za-z][A-Za-z0-9_-]*(\.[A-Za-z0-9_-]+)+$/, P = /^[A-Za-z][A-Za-z0-9_]*(\.[A-Za-z0-9_]+)+$/, F = (e) => {
+	let t = e.split("/").map((e) => e.startsWith(":") ? "*" : e).join("/");
+	return t.length === 0 ? "/" : t;
+}, I = (e) => {
+	let t = e.trim().replace(/[:\s]/g, "").toUpperCase();
+	return /^[0-9A-F]{64}$/.test(t) ? (t.match(/.{2}/g) ?? []).join(":") : null;
+}, L = (e) => {
+	let t = [], n = e.appleTeamId.trim().toUpperCase();
+	M.test(n) || t.push(`apple team id ${JSON.stringify(e.appleTeamId)} is not a 10-character Team ID. Find it in the Apple Developer portal under Membership details, and pass it as \`--team-id\` (or set VOLTRO_APPLE_TEAM_ID).`), N.test(e.bundleIdentifier) || t.push(`ios bundle identifier ${JSON.stringify(e.bundleIdentifier)} is not reverse-DNS. It comes from the Expo config's \`ios.bundleIdentifier\`.`), P.test(e.androidPackage) || t.push(`android package ${JSON.stringify(e.androidPackage)} is not a Java package name. It comes from the Expo config's \`android.package\`.`);
+	let r = [];
+	for (let n of e.sha256CertFingerprints) {
+		let e = I(n);
+		e === null ? t.push(`${JSON.stringify(n)} is not a SHA-256 fingerprint (32 hex bytes). Get it with \`keytool -list -v -keystore <your.keystore>\`, or from Play Console → Setup → App signing.`) : r.includes(e) || r.push(e);
+	}
+	if (e.sha256CertFingerprints.length === 0 && t.push("no android signing fingerprint. Pass `--fingerprint <sha256>` (repeatable — a debug keystore and Play App Signing are different certificates and BOTH must be listed, or App Links verify in one build and not the other)."), e.patterns.length === 0 && t.push("the app answers no deep links, so an association file would grant the app nothing. Add a screen under the router directory, or a `*.deepLink.ts`."), t.length > 0) return {
+		kind: "refused",
+		reasons: t
+	};
+	let i = /* @__PURE__ */ new Set(), a = e.patterns.map((e) => ({
+		pattern: e,
+		component: F(e)
+	})).filter(({ component: e }) => !i.has(e) && (i.add(e), !0)).map(({ pattern: e, component: t }) => ({
+		"/": t,
+		comment: `opens the app for ${e}`
+	}));
+	return {
+		kind: "built",
+		aasa: { applinks: { details: [{
+			appIDs: [`${n}.${e.bundleIdentifier}`],
+			components: a
+		}] } },
+		assetLinks: [{
+			relation: ["delegate_permission/common.handle_all_urls"],
+			target: {
+				namespace: "android_app",
+				package_name: e.androidPackage,
+				sha256_cert_fingerprints: r
+			}
+		}]
+	};
+}, R = "apple-app-site-association", z = "assetlinks.json", B = ".well-known", V = [
+	"app.config.ts",
+	"app.config.js",
+	"app.config.json",
+	"app.json"
+], H = async (e) => {
+	try {
+		return await l.stat(e), !0;
+	} catch {
+		return !1;
+	}
+}, U = async (e) => {
+	for (let t of V) {
+		let n = a(e, t);
+		if (await H(n)) try {
+			if (t.endsWith(".json")) {
+				let e = JSON.parse(await l.readFile(n, "utf8"));
+				return {
+					kind: "loaded",
+					config: e.expo ?? e,
+					file: n
+				};
+			}
+			let e = (await import(`${u(n).href}?t=${Date.now()}`)).default, r = typeof e == "function" ? e({ config: {} }) : e;
+			return r === void 0 || typeof r != "object" ? {
+				kind: "failed",
+				file: n,
+				error: /* @__PURE__ */ Error("no default export with an Expo config object")
+			} : {
+				kind: "loaded",
+				config: r,
+				file: n
+			};
+		} catch (e) {
+			return {
+				kind: "failed",
+				file: n,
+				error: e instanceof Error ? e : Error(String(e))
+			};
+		}
+	}
+	return { kind: "absent" };
+}, W = async (e) => {
+	let t = await g(e);
+	return t.kind === "not-a-mobile-app" ? {
+		apis: t,
+		deepLinks: null
+	} : {
+		apis: t,
+		deepLinks: await k(e)
+	};
+}, G = (e, t) => {
+	console.log(_(e, t.apis));
+	let n = t.deepLinks;
+	if (n === null) return 1;
+	if (n.kind === "refused") return console.error(`voltro mobile codegen: ${n.reason}`), 1;
+	let r = t.apis.kind !== "wrote";
+	n.routerDir === null ? console.log(`voltro mobile codegen: wrote ${o(e, n.file)} (${n.declared} declared link(s); no Expo Router directory found, so nothing was derived)`) : console.log(`voltro mobile codegen: wrote ${o(e, n.file)} (${n.derived} link(s) derived from ${n.routerDir}, ${n.declared} declared)`);
+	for (let e of n.skipped) e.reason.includes("catch-all") && console.log(`  not derived: ${e.file} — ${e.reason}`);
+	return +!!r;
+}, K = async (e) => G(e, await W(e)), q = (e, t) => {
+	let n = e.indexOf(t);
+	if (n !== -1 && n + 1 < e.length) return e[n + 1];
+	let r = e.find((e) => e.startsWith(`${t}=`));
+	return r === void 0 ? void 0 : r.slice(t.length + 1);
+}, J = (e, t) => {
+	let n = [];
+	for (let [r, i] of e.entries()) i === t && r + 1 < e.length ? n.push(e[r + 1]) : i.startsWith(`${t}=`) && n.push(i.slice(t.length + 1));
+	return n;
+}, Y = async (e, t) => {
+	let n = await U(e);
+	if (n.kind === "absent") return console.error(`voltro mobile links: no Expo config in ${e} (looked for ${V.join(", ")}) — this is not a mobile app.`), 1;
+	if (n.kind === "failed") return console.error(`voltro mobile links: ${o(e, n.file)} could not be loaded — ${n.error.message}.`), console.error("  Refusing to write: the association files would carry no bundle id and would publish anyway."), 1;
+	let r = await E(e);
+	if (r.kind === "refused") return console.error(`voltro mobile links: ${r.reason}`), 1;
+	let i = await j(e, r.table);
+	for (let e of i.unreadable) console.error(`voltro mobile links: ${e} declares a computed \`pattern\`, which cannot be read without running the module. Its path is NOT in the generated files — spell the pattern as a string literal, or add it by hand afterwards.`);
+	let c = [...i.patterns, ...r.table.derived.map((e) => e.pattern)], u = L({
+		bundleIdentifier: n.config.ios?.bundleIdentifier ?? "",
+		appleTeamId: q(t, "--team-id") ?? process.env.VOLTRO_APPLE_TEAM_ID ?? "",
+		androidPackage: n.config.android?.package ?? "",
+		sha256CertFingerprints: [...J(t, "--fingerprint"), ...process.env.VOLTRO_ANDROID_CERT_FINGERPRINT === void 0 ? [] : [process.env.VOLTRO_ANDROID_CERT_FINGERPRINT]],
+		patterns: c
+	});
+	if (u.kind === "refused") {
+		console.error("voltro mobile links: refusing to write —");
+		for (let e of u.reasons) console.error(`  · ${e}`);
+		return 1;
+	}
+	let d = s(e, q(t, "--out") ?? ".well-known");
+	await l.mkdir(d, { recursive: !0 });
+	let f = a(d, R), p = a(d, z);
+	await l.writeFile(f, `${JSON.stringify(u.aasa, null, 2)}\n`, "utf8"), await l.writeFile(p, `${JSON.stringify(u.assetLinks, null, 2)}\n`, "utf8");
+	let m = u.aasa.applinks.details[0].components.length;
+	console.log(`voltro mobile links: wrote ${o(e, f)} (${m} path component(s))`), console.log(`voltro mobile links: wrote ${o(e, p)}`), console.log(`  Serve both from https://<your-domain>/${B}/ as application/json, over https, with no redirect. iOS fetches the association file itself — a redirect is a silent failure.`);
+	let h = n.config.ios?.associatedDomains ?? [];
+	return h.length === 0 ? console.log("  NOTE: the Expo config declares no `ios.associatedDomains`. iOS will not fetch the association file until it does — add `ios: { associatedDomains: [\"applinks:<your-domain>\"] }`.") : console.log(`  ios.associatedDomains: ${h.join(", ")}`), 0;
+}, X = {
+	codegen: (e) => K(e),
+	links: (e, t) => Y(e, t)
+}, Z = async (r) => {
+	let i = r[0];
+	if (i === void 0 || i === "--help" || i === "-h" || !(i in X)) return i !== void 0 && i !== "--help" && i !== "-h" && console.error(`voltro mobile: unknown subcommand ${JSON.stringify(i)}`), console.log(`voltro mobile ${e(t)}`), console.log(""), console.log("  codegen [app]   regenerate the api binding + the deep-link table"), console.log("  links [app]     emit apple-app-site-association + assetlinks.json"), console.log(""), console.log("  --team-id <id>            Apple Team ID (or VOLTRO_APPLE_TEAM_ID)"), console.log("  --fingerprint <sha256>    Android signing cert SHA-256 (repeatable,"), console.log("                            or VOLTRO_ANDROID_CERT_FINGERPRINT)"), console.log("  --out <dir>               where to write them (default: .well-known/)"), i === void 0 || i === "--help" || i === "-h" ? 0 : 1;
+	let a = r.slice(1), o = s(n(a, Q) ?? process.cwd());
+	return X[i](o, a);
+}, Q = [
+	"--fingerprint",
+	"--out",
+	"--team-id"
+];
+//#endregion
+export { d as a, Z as i, G as n, W as r, U as t };

package/dist/mobileCommand-DAum7tsG.js

@@ -0,0 +1,2 @@
+import { i as e } from "./mobileCommand-D9O6iq3D.js";
+export { e as runMobileCommand };

package/dist/{pageConvention-C938S8oC.js → pageConvention-CMpfDN6r.js}

@@ -1,4 +1,4 @@
-import { E as e } from "./fileConventions-DASGEmj-.js";
+import { D as e } from "./fileConventions-l-RIXbx8.js";
 //#region src/pageConvention.ts
 var t = (t) => e.test(t), n = (e) => e.replace(/page\.tsx$/, "page.test.tsx");
 //#endregion

package/dist/{privacyCommand-DWTQMC6R.js → privacyCommand-BCa2OoZG.js}

@@ -1,6 +1,6 @@
 import { t as e } from "./cliError-BmdYnghb.js";
 import { i as t, n, t as r } from "./cliArgs-D4p8n7EE.js";
-import { b as i, x as a } from "./fileConventions-DASGEmj-.js";
+import { S as i, x as a } from "./fileConventions-l-RIXbx8.js";
 import { n as o } from "./cliOutput-D1tSBoRM.js";
 import { join as s, resolve as c } from "node:path";
 import { promises as l } from "node:fs";
@@ -38,7 +38,7 @@ var _ = d({ scope: "voltro:privacy" }), v = /* @__PURE__ */ new Set([
 	return await r(e), n;
 }, x = (e) => typeof e == "object" && !!e && "tableName" in e && "fields" in e && typeof e.tableName == "string", S = async (e) => {
 	f();
-	let t = 0, n = 0, r = [...await b(e, a), ...await b(e, i)];
+	let t = 0, n = 0, r = [...await b(e, i), ...await b(e, a)];
 	for (let e of r) {
 		let r;
 		try {

package/dist/{probeCommand-DkGGLknv.js → probeCommand-_C0YU207.js}

@@ -108,7 +108,7 @@ server and in this shell.`);
 }, m = async (e) => {
 	let t = /* @__PURE__ */ new Map();
 	try {
-		let { walk: n, loadDiscovered: r } = await import("./dev-GjJWAYo2.js"), i = await r(await n(e)), a = [
+		let { walk: n, loadDiscovered: r } = await import("./dev-cKUiZZsB.js"), i = await r(await n(e)), a = [
 			...i.queries,
 			...i.mutations,
 			...i.actions,

package/dist/{projectScaffold-EzlErR4E.js → projectScaffold-CJfP-xbT.js}

@@ -1,2 +1,2 @@
-import { c as e, l as t, s as n } from "./projectScaffold-B4dmTlwT.js";
+import { c as e, l as t, s as n } from "./projectScaffold-CSN0OzBV.js";
 export { n as runAddApp, e as runCreateProject, t as runListTemplates };

package/dist/{projectScaffold-B4dmTlwT.js → projectScaffold-CSN0OzBV.js}

@@ -1,7 +1,7 @@
-import { a as e, i as t, n, r, t as i } from "./templates-BR-fb4SP.js";
+import { a as e, i as t, n, r, t as i } from "./templates-BTWZkJJT.js";
 import { i as a, n as o, t as s } from "./cloudClient-DWL-Hw_T.js";
 import { t as c } from "./cliRuntime-Dh7UDinH.js";
-import { n as l } from "./agentsMd-0l980yhL.js";
+import { n as l } from "./agentsMd-BaLC10Na.js";
 import { n as u } from "./addCommand-C05L9tZh.js";
 import { a as d, n as f, r as p } from "./baselineCommand-Ck2Xm8M7.js";
 import { basename as m, dirname as h, join as g, resolve as _ } from "node:path";

package/dist/renderModeScan-43yQ2opo.js

@@ -0,0 +1,147 @@
+import { dirname as e, join as t, resolve as n } from "node:path";
+import { readFile as r } from "node:fs/promises";
+//#region src/isrCache.ts
+var i = () => {
+	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());
+		}
+	};
+}, a = (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;
+}, o = (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("|");
+}, s = (e, t) => e.expiresAt > t, c = (e, t) => e.expiresAt <= t && e.servableUntil > t, l = [
+	"static",
+	"spa",
+	"ssr",
+	"isr"
+], u = (e) => typeof e == "string" && l.includes(e), d = l.map((e) => `'${e}'`).join(" | "), f = (e, t) => `[voltro] ${e}: unknown renderMode '${t}'.\n  Valid values: ${d}.${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)." : ""}`, p = class extends Error {
+	page;
+	value;
+	name = "InvalidRenderModeError";
+	constructor(e, t) {
+		super(f(e, t)), this.page = e, this.value = t;
+	}
+}, m = (e, t = "<page>") => {
+	if (e.renderMode !== void 0 && e.renderMode !== null) {
+		if (!u(e.renderMode)) throw new p(t, String(e.renderMode));
+		return e.renderMode;
+	}
+	return e.dynamic === "force-dynamic" ? "ssr" : (e.dynamic, "static");
+}, h = (e, t = "<page>") => ({
+	renderMode: m(e, t),
+	tenantAware: e.tenantAware === !0,
+	revalidateMs: a(e.revalidate),
+	staleWhileRevalidateMs: a(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
+}), g = /export\s+const\s+renderMode\s*(?::[^=]+)?=\s*['"]([^'"]*)['"]/, _ = (e) => g.exec(e)?.[1] ?? null, v = /export\s*\{([^}]*)\}\s*from\s*['"]([^'"]+)['"]/g, y = (e) => {
+	v.lastIndex = 0;
+	let t;
+	for (; (t = v.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;
+}, b = /export\s*\{([^}]*)\}/g, x = (e) => {
+	if (/export\s+default\b/.test(e)) return !0;
+	b.lastIndex = 0;
+	let t;
+	for (; (t = b.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;
+}, S = async (e, t, n = /* @__PURE__ */ new Set()) => {
+	if (/^export const searchParams\b/m.test(e)) return !0;
+	b.lastIndex = 0;
+	let i;
+	for (; (i = b.exec(e)) !== null;) for (let e of i[1].split(",")) {
+		let t = e.lastIndexOf(" as ");
+		if ((t === -1 ? e : e.slice(t + 4)).trim() === "searchParams") return !0;
+	}
+	if (n.size >= 4) return !1;
+	let a = new RegExp(C, "g"), o;
+	for (; (o = a.exec(e)) !== null;) {
+		let e = o[1];
+		if (e.startsWith(".")) for (let i of w(t, e)) {
+			if (n.has(i)) continue;
+			let e;
+			try {
+				e = await r(i, "utf8");
+			} catch {
+				continue;
+			}
+			let t = new Set(n);
+			if (t.add(i), await S(e, i, t)) return !0;
+			break;
+		}
+	}
+	return !1;
+}, C = String.raw`export\s+\*\s+from\s+['"]([^'"]+)['"]`, w = (r, i) => {
+	let a = n(e(r), i);
+	return /\.[tj]sx?$/.test(i) ? [a] : [
+		`${a}.tsx`,
+		`${a}.ts`,
+		t(a, "index.tsx"),
+		t(a, "index.ts")
+	];
+}, T = async (e, n) => {
+	let i = (await Promise.all(n.map(async (n) => {
+		let i;
+		try {
+			i = await r(t(e, n.file), "utf8");
+		} catch {
+			return null;
+		}
+		let a = _(i);
+		return a !== null && !u(a) ? f(t("src", "pages", n.file), a) : a === "isr" && await S(i, t(e, n.file)) ? `${t("src", "pages", n.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.` : x(i) ? null : `${t("src", "pages", n.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 { h as a, m as c, c as d, i as f, l as i, o as l, _ as n, u as o, a as p, y as r, f as s, T as t, s as u };

package/dist/{renderProfile-CskIgAfn.js → renderProfile-DvrhVJHa.js}

@@ -1,5 +1,5 @@
-import { h as e } from "./fileConventions-DASGEmj-.js";
-import { i as t, n, o as r, r as i, s as a } from "./renderModeScan-CUbOeOAg.js";
+import { g as e } from "./fileConventions-l-RIXbx8.js";
+import { i as t, n, o as r, r as i, s as a } from "./renderModeScan-43yQ2opo.js";
 import { dirname as o, join as s, relative as c, resolve as l } from "node:path";
 import { Effect as u } from "effect";
 import { readFile as d, readdir as f } from "node:fs/promises";

package/dist/{runtimeTrace-c0APJz7E.js → runtimeTrace-CGWx1Q6l.js}

@@ -1,4 +1,4 @@
-import { n as e } from "./apiBuild-CaPfoWku.js";
+import { n as e } from "./apiBuild-DTWp0S_q.js";
 import { join as t, resolve as n, sep as r } from "node:path";
 import { existsSync as i, promises as a } from "node:fs";
 import { createLogger as o } from "@voltro/logger";

package/dist/{sdkgen-BiQCgIEr.js → sdkgen-CDGHQUFj.js}

@@ -422,7 +422,7 @@ let package = Package(
 		await l.mkdir(o(e), { recursive: !0 }), await l.writeFile(e, n.content, "utf8");
 	}
 }, X = async (e) => {
-	let { offlineManifest: t } = await import("./checkCommand-D2ZduVlh.js"), { manifest: n } = await t(e);
+	let { offlineManifest: t } = await import("./checkCommand-L7DTlpIF.js"), { manifest: n } = await t(e);
 	return n;
 }, Z = async (e) => {
 	let t = J(await (e.manifestProvider ?? X)(e.root), {

package/dist/serveCommand-BiPe8BJm.js

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