primitive-app 3.2.0-alpha.2 → 3.2.0-alpha.20

package/dist/dev-tools/vite-plugin/index.js

@@ -63,14 +63,21 @@ export const keyboardShortcut = ${JSON.stringify(s)};
 		}
 	};
 }
-var h = ".primitive", g = "config.json", _ = "local.json", v = ".primitive/config.json", y = ".primitive/local.json", b = class extends Error {
+var h = "primitive", g = ".primitive", _ = "config.json", v = "local.json", y = "primitive/config.json", b = ".primitive/local.json";
+function x(e, t) {
+	return `Found ${e} but no ${t}: this project still uses the retired layout under ${g}/, which is never read.`;
+}
+function S(e) {
+	return `No ${y} found in ${e} or any parent directory. Primitive commands run inside a Primitive project: it is where the CLI reads the environment, the app that environment names, and the configuration tree from. Run 'primitive init' to create one.`;
+}
+var C = class extends Error {
 	kind;
 	path;
 	constructor(e, t, n) {
 		super(t), this.name = "PrimitiveEnvError", this.kind = e, this.path = n;
 	}
 };
-function x(e) {
+function w(e) {
 	if (typeof e != "string") return;
 	let t = e.trim();
 	if (!t) return;
@@ -82,156 +89,216 @@ function x(e) {
 	}
 	if (!(n.protocol !== "https:" && n.protocol !== "http:") && !(n.protocol === "http:" && n.hostname !== "localhost" && n.hostname !== "127.0.0.1") && !(n.username || n.password) && !(n.pathname !== "/" && n.pathname !== "") && !(n.search || n.hash)) return n.origin;
 }
-function S(e, t) {
-	return `Environment "${e}" in ${t ? `${v} (${t})` : v} has no "appId". Every environment names exactly one app — add "appId": "<app-id>" to that environment in ${v}. Find the app id in the Primitive admin UI, with 'primitive apps list' run from a directory outside this project, or as the residual "currentAppId" in .primitive/credentials.json if this environment was ever pointed at an app by the retired per-machine app selection.`;
+function T(e, t) {
+	return `Environment "${e}" in ${t ? `${y} (${t})` : y} has no "appId". Every environment names exactly one app — add "appId": "<app-id>" to that environment in ${y}. Find the app id in the Primitive admin UI, with 'primitive apps list' run from another Primitive project, or as the residual "currentAppId" in .primitive/credentials.json if this environment was ever pointed at an app by the retired per-machine app selection.`;
 }
-function C(e) {
+function E(e) {
 	if (typeof e == "string") return e.trim() || void 0;
 }
-function w(e) {
+function D(e) {
 	return e.startsWith("https://") ? "wss://" + e.slice(8) : e.startsWith("http://") ? "ws://" + e.slice(7) : e;
 }
-function T(t = {}) {
+function O(t = {}) {
 	let n = (t.env ?? process.env).PRIMITIVE_PROJECT_CONFIG;
 	if (n) {
 		let t = c(n);
+		if (a(o(t)) === ".primitive") throw new C("stale-layout", x(t, s(o(o(t)), h, _)), t);
 		return e(t) ? t : null;
 	}
 	let r = c(t.cwd ?? process.cwd());
 	for (;;) {
-		let t = s(r, h, g);
+		let t = s(r, h, _);
 		if (e(t)) return t;
-		let n = o(r);
-		if (n === r) return null;
-		r = n;
+		let n = s(r, g, _);
+		if (e(n)) throw new C("stale-layout", x(n, t), n);
+		let i = o(r);
+		if (i === r) return null;
+		r = i;
 	}
 }
-function E(e) {
+function k(e) {
 	let t = o(e);
-	return a(t) === ".primitive" ? o(t) : t;
+	return a(t) === "primitive" ? o(t) : t;
 }
-function D(e) {
-	return s(o(e), _);
+function A(e) {
+	return s(k(e), g, v);
+}
+function j(e) {
+	return e instanceof Error ? e.message : String(e);
 }
-function O(n) {
-	if (!e(n)) throw new b("missing-config", `No ${v} found at ${n}. Run 'primitive init' to create one.`, n);
+function M(n) {
+	if (!e(n)) throw new C("missing-config", S(o(n)), n);
 	let r;
 	try {
 		r = t(n, "utf-8");
 	} catch (e) {
-		throw new b("malformed-config", `Failed to read ${v} (${n}): ${e.message}`, n);
+		throw new C("malformed-config", `Failed to read ${y} (${n}): ${j(e)}`, n);
 	}
 	let i;
 	try {
 		i = JSON.parse(r);
 	} catch (e) {
-		throw new b("malformed-config", `Failed to parse ${v} (${n}): ${e.message}`, n);
+		throw new C("malformed-config", `Failed to parse ${y} (${n}): ${j(e)}`, n);
 	}
-	if (!i || typeof i != "object" || Array.isArray(i)) throw new b("malformed-config", `${v} (${n}) must contain a JSON object at the top level.`, n);
+	if (!i || typeof i != "object" || Array.isArray(i)) throw new C("malformed-config", `${y} (${n}) must contain a JSON object at the top level.`, n);
 	let a = i;
-	if (typeof a.version != "number" || !Number.isInteger(a.version)) throw new b("malformed-config", `${v} (${n}) is missing required integer field "version".`, n);
-	if (a.version !== 1) throw new b("unsupported-version", `${v} (${n}) has version ${a.version}, but this tool understands version 1.`, n);
-	if (!a.environments || typeof a.environments != "object" || Array.isArray(a.environments)) throw new b("malformed-config", `${v} (${n}) is missing required "environments" object.`, n);
-	let o = {};
+	if (typeof a.version != "number" || !Number.isInteger(a.version)) throw new C("malformed-config", `${y} (${n}) is missing required integer field "version".`, n);
+	if (a.version !== 1) throw new C("unsupported-version", `${y} (${n}) has version ${a.version}, but this tool understands version 1.`, n);
+	if (!a.environments || typeof a.environments != "object" || Array.isArray(a.environments)) throw new C("malformed-config", `${y} (${n}) is missing required "environments" object.`, n);
+	let s = {};
 	for (let [e, t] of Object.entries(a.environments)) {
-		if (!t || typeof t != "object" || Array.isArray(t)) throw new b("malformed-config", `Environment "${e}" must be an object in ${v} (${n}).`, n);
+		if (!t || typeof t != "object" || Array.isArray(t)) throw new C("malformed-config", `Environment "${e}" must be an object in ${y} (${n}).`, n);
 		let r = t;
-		if (typeof r.apiUrl != "string" || !r.apiUrl) throw new b("malformed-config", `Environment "${e}" must have a non-empty "apiUrl" string in ${v} (${n}).`, n);
-		let i = C(r.appId);
-		if (!i) throw new b("missing-app-id", S(e, n), n);
-		o[e] = {
+		if (typeof r.apiUrl != "string" || !r.apiUrl) throw new C("malformed-config", `Environment "${e}" must have a non-empty "apiUrl" string in ${y} (${n}).`, n);
+		let i = E(r.appId);
+		if (!i) throw new C("missing-app-id", T(e, n), n);
+		s[e] = {
 			apiUrl: r.apiUrl.replace(/\/$/, ""),
 			appId: i,
 			appName: typeof r.appName == "string" ? r.appName : void 0,
-			webUrl: x(r.webUrl),
+			webUrl: w(r.webUrl),
 			description: typeof r.description == "string" ? r.description : void 0
 		};
 	}
 	return {
 		version: a.version,
 		defaultEnvironment: typeof a.defaultEnvironment == "string" && a.defaultEnvironment ? a.defaultEnvironment : void 0,
-		environments: o
+		environments: s
 	};
 }
-function k(n) {
-	let r = D(n);
-	if (!e(r)) return null;
-	let i = (e) => {
-		throw new b("corrupt-local-state", `${y} (${r}) is unreadable: ${e}. Delete the file or re-run 'primitive env use <name>'.`, r);
-	}, a;
+var N = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+function P(n, r) {
+	let i = A(n);
+	if (!e(i)) return {
+		selectedEnvironment: null,
+		environments: {}
+	};
+	let a = (e) => {
+		throw new C("corrupt-local-state", `${b} (${i}) is unreadable: ${e}. Delete the file or re-run 'primitive env use <name>'.`, i);
+	}, o;
 	try {
-		a = JSON.parse(t(r, "utf-8"));
+		o = JSON.parse(t(i, "utf-8"));
 	} catch (e) {
-		return i(e.message);
+		return a(j(e));
+	}
+	if (!o || typeof o != "object" || Array.isArray(o)) return a("expected a JSON object");
+	let s = o, c = null, l = s.selectedEnvironment;
+	if (l != null && l !== "") {
+		if (typeof l != "string") return a("\"selectedEnvironment\" must be a string");
+		c = l;
 	}
-	if (!a || typeof a != "object" || Array.isArray(a)) return i("expected a JSON object");
-	let o = a.selectedEnvironment;
-	return o == null || o === "" ? null : typeof o == "string" ? o : i("\"selectedEnvironment\" must be a string");
+	return {
+		selectedEnvironment: c,
+		environments: F(s.environments, i, r)
+	};
 }
-function A(e, t) {
-	let n = Object.keys(e.environments), r = n.join(", ") || "(none)", i = t.configPath ? `${v} (${t.configPath})` : v, a = (n, a, o) => {
-		if (!e.environments[n]) throw new b("unknown-environment", `Environment "${n}" is not defined in ${i} (selected ${o}). Available: ${r}`, t.configPath);
+function F(e, t, n) {
+	let r = {};
+	if (e === void 0) return r;
+	if (!e || typeof e != "object" || Array.isArray(e)) throw new C("corrupt-local-state", `${b} (${t}) is unreadable: "environments" must be an object keyed by environment name. Fix or remove "environments" in ${b}.`, t);
+	let i = (e, n) => {
+		throw new C("corrupt-local-state", `${b} (${t}): machine-local environment "${e}" ${n}. Fix or remove the "${e}" entry under "environments" in ${b}.`, t);
+	}, a = n ? Object.keys(n.environments) : null;
+	for (let [t, n] of Object.entries(e)) {
+		N.test(t) || i(t, "is not a valid environment name (letters, digits, dashes and underscores, starting with a letter or digit)"), (!n || typeof n != "object" || Array.isArray(n)) && i(t, "must be an object");
+		let e = n;
+		(typeof e.apiUrl != "string" || !e.apiUrl.trim()) && i(t, "has no \"apiUrl\" string");
+		let o = E(e.appId);
+		o || i(t, "has no \"appId\" naming the app it selects"), (typeof e.tree != "string" || !e.tree.trim()) && i(t, "has no \"tree\" naming the committed environment whose configuration tree it uses");
+		let s = e.tree.trim();
+		a && (a.includes(t) && i(t, `has the name of a committed environment in ${y}; a machine-local environment needs a name of its own`), a.includes(s) || i(t, `has "tree": "${s}", which is not an environment in ${y} (available: ${a.join(", ") || "(none)"})`)), r[t] = {
+			apiUrl: e.apiUrl.trim().replace(/\/$/, ""),
+			appId: o,
+			appName: typeof e.appName == "string" ? e.appName : void 0,
+			tree: s
+		};
+	}
+	return r;
+}
+function I(e, t) {
+	return Object.prototype.hasOwnProperty.call(e.environments, t);
+}
+function L(e, t) {
+	let n = Object.keys(e.environments), r = Object.keys(t.localEnvironments ?? {}), i = [...n, ...r.map((e) => `${e} (local)`)].join(", ") || "(none)", a = t.configPath ? `${y} (${t.configPath})` : y, o = (n, o, s, c = !1) => {
+		if (!I(e, n) && (c || !r.includes(n))) throw new C("unknown-environment", `Environment "${n}" is not defined in ${a} (selected ${s}). Available: ${i}`, t.configPath);
 		return {
 			name: n,
-			source: a
+			source: o
 		};
 	};
-	if (t.explicitEnvName) return a(t.explicitEnvName, "explicit", "explicitly");
-	if (t.envVarName) return a(t.envVarName, "env-var", "via PRIMITIVE_ENV");
-	if (t.localSelection) return a(t.localSelection, "local", `in ${y}`);
-	if (e.defaultEnvironment) return a(e.defaultEnvironment, "default", "as \"defaultEnvironment\"");
+	if (t.explicitEnvName) return o(t.explicitEnvName, "explicit", "explicitly");
+	if (t.envVarName) return o(t.envVarName, "env-var", "via PRIMITIVE_ENV");
+	if (t.localSelection) return o(t.localSelection, "local", `in ${b}`);
+	if (e.defaultEnvironment) return o(e.defaultEnvironment, "default", "as \"defaultEnvironment\"", !0);
 	if (n.length === 1) return {
 		name: n[0],
 		source: "sole"
 	};
-	throw n.length === 0 ? new b("no-selection", `${i} has no environments defined. Run 'primitive env add <name>' or 'primitive init'.`, t.configPath) : new b("no-selection", `No environment selected. Run 'primitive env use <name>', set "defaultEnvironment" in ${i}, or export PRIMITIVE_ENV. Available: ${r}`, t.configPath);
+	throw n.length === 0 ? new C("no-selection", `${a} has no environments defined. Run 'primitive env add <name>' or 'primitive init'.`, t.configPath) : new C("no-selection", `No environment selected. Run 'primitive env use <name>', set "defaultEnvironment" in ${a}, or export PRIMITIVE_ENV. Available: ${i}`, t.configPath);
 }
-function j(e = {}) {
-	let t = e.env ?? process.env, n = e.configPath ?? T({
+function R(e = {}) {
+	let t = e.env ?? process.env, n = e.configPath ?? O({
 		cwd: e.cwd,
 		env: t
 	});
-	if (!n) throw new b("missing-config", `No ${v} found in ${e.cwd ?? process.cwd()} or any parent directory. Run 'primitive init' to create one, or 'primitive env add <name>' to add an environment.`);
-	let r = O(n), { name: i, source: a } = A(r, {
+	if (!n) throw new C("missing-config", S(e.cwd ?? process.cwd()));
+	let r = k(n), i = M(n), a = P(n, i), { name: o, source: s } = L(i, {
 		explicitEnvName: e.explicitEnvName || null,
 		envVarName: t.PRIMITIVE_ENV || null,
-		localSelection: k(n),
+		localSelection: a.selectedEnvironment,
+		localEnvironments: a.environments,
 		configPath: n
-	}), o = r.environments[i];
-	return {
-		name: i,
-		apiUrl: o.apiUrl,
-		wsUrl: w(o.apiUrl),
-		appId: o.appId,
-		appName: o.appName,
-		webUrl: o.webUrl,
-		description: o.description,
-		source: a,
+	}), c = {
+		name: o,
+		source: s,
 		configPath: n,
-		localStatePath: D(n),
-		projectRoot: E(n)
+		localStatePath: A(n),
+		projectRoot: r
+	}, l = I(i, o) ? void 0 : a.environments[o];
+	if (l) return {
+		...c,
+		apiUrl: l.apiUrl,
+		wsUrl: D(l.apiUrl),
+		appId: l.appId,
+		appName: l.appName,
+		webUrl: void 0,
+		description: void 0,
+		tree: l.tree,
+		local: !0
+	};
+	let u = i.environments[o];
+	return {
+		...c,
+		apiUrl: u.apiUrl,
+		wsUrl: D(u.apiUrl),
+		appId: u.appId,
+		appName: u.appName,
+		webUrl: u.webUrl,
+		description: u.description,
+		tree: o,
+		local: !1
 	};
 }
 //#endregion
 //#region src/dev-tools/vite-plugin/primitive-env.ts
-var M = [
+var z = [
 	"VITE_APP_ID",
 	"VITE_API_URL",
 	"VITE_WS_URL",
 	"VITE_APP_NAME"
-], N = "VITE_EXPECTED_PRIMITIVE_ENV", P = /* @__PURE__ */ new Map();
-function F(e, t) {
+], B = "VITE_EXPECTED_PRIMITIVE_ENV", V = /* @__PURE__ */ new Map();
+function H(e, t) {
 	let n = process.env[e];
-	n !== void 0 && n !== "" && P.get(e) !== n || (process.env[e] = t, P.set(e, t));
+	n !== void 0 && n !== "" && V.get(e) !== n || (process.env[e] = t, V.set(e, t));
 }
-function I(e = {}) {
-	return j({
+function U(e = {}) {
+	return R({
 		cwd: e.root,
 		env: e.env,
 		explicitEnvName: e.primitiveEnv ?? null
 	});
 }
-function L(e, t, n) {
+function W(e, t, n) {
 	let r = (e) => n.includes(e) ? "  (overridden)" : "", i = [
 		`[primitive-env] Primitive environment: ${e.name} (selected: ${e.source})`,
 		`[primitive-env]   apiUrl:  ${t.apiUrl}${r("VITE_API_URL")}`,
@@ -242,12 +309,12 @@ function L(e, t, n) {
 	];
 	return n.length > 0 && i.push(`[primitive-env]   overridden by the environment: ${n.join(", ")}`), i.join("\n");
 }
-function R(e, t) {
+function G(e, t) {
 	let n = e?.envDir;
 	return n === !1 ? null : typeof n == "string" && n !== "" ? c(t, n) : t;
 }
-function z(e, t) {
-	let n = process.env[N];
+function K(e, t) {
+	let n = process.env[B];
 	if (n !== void 0 && n !== "") return {
 		value: n,
 		where: "the process environment"
@@ -259,7 +326,7 @@ function z(e, t) {
 		".env.local",
 		".env"
 	]) {
-		let e = W(s(t, n))[N];
+		let e = Z(s(t, n))[B];
 		if (e !== void 0) return {
 			value: e,
 			where: n
@@ -267,47 +334,48 @@ function z(e, t) {
 	}
 	return null;
 }
-function B(e, t, n) {
+function q(e, t, n) {
+	let r = n.local ? `"${n.name}" (machine-local, tree "${n.tree}")` : `"${n.name}"`;
 	return [
-		`[primitive-env] Wrong pair: vite mode "${e}" is declared to run against Primitive environment "${t.value}", but "${n.name}" resolved.`,
-		`[primitive-env]   expected: ${t.value}  (${N} in ${t.where})`,
-		`[primitive-env]   resolved: ${n.name}  (selected: ${n.source})`,
+		`[primitive-env] Wrong pair: vite mode "${e}" is declared to run against Primitive environment "${t.value}", but ${r} resolved.`,
+		`[primitive-env]   expected: ${t.value}  (${B} in ${t.where}; a machine-local environment whose tree is ${t.value} also pairs)`,
+		`[primitive-env]   resolved: ${n.name}  (selected: ${n.source}${n.local ? `; machine-local, tree ${n.tree}` : ""})`,
 		`[primitive-env]   config:   ${n.configPath}`,
 		"",
-		`Run the pair you meant — PRIMITIVE_ENV=${t.value} <command> --mode ${e}, or 'primitive env use ${t.value}' — or change/remove ${N} in ${t.where}.`,
+		`Run the pair you meant — PRIMITIVE_ENV=${t.value} <command> --mode ${e}, or 'primitive env use ${t.value}' — or change/remove ${B} in ${t.where}.`,
 		"",
 		`A mode declares this when its .env.${e} carries values coupled to one backend, so continuing would run this environment's identity with another's configuration.`
 	].join("\n");
 }
-function V(e, t, n) {
-	let r = z(e, t);
-	if (r && r.value !== "" && r.value !== n.name) throw Error(B(e, r, n));
+function J(e, t, n) {
+	let r = K(e, t);
+	if (r && r.value !== "" && r.value !== n.name && !(n.local && r.value === n.tree)) throw Error(q(e, r, n));
 }
-function H(e = {}) {
+function Y(e = {}) {
 	let t = null, n = null, r, i = [], a = !1, o = null;
 	return {
 		name: "primitive-env",
 		enforce: "pre",
 		config(s, c) {
 			a = c?.command === "serve", o = null;
-			let l = s?.root ?? process.cwd(), u = c?.mode ?? "development", d = U(u, l), f = {};
-			for (let e of M) {
-				let t = process.env[e], n = t !== void 0 && P.get(e) !== t ? t : d[e];
+			let l = s?.root ?? process.cwd(), u = c?.mode ?? "development", d = X(u, l), f = {};
+			for (let e of z) {
+				let t = process.env[e], n = t !== void 0 && V.get(e) !== t ? t : d[e];
 				n !== void 0 && n !== "" && (f[e] = n);
 			}
 			let p;
 			try {
-				p = j({
+				p = R({
 					cwd: l,
 					explicitEnvName: e.primitiveEnv ?? null
 				});
 			} catch (e) {
-				if (e instanceof b && e.kind === "missing-config" && f.VITE_APP_ID && f.VITE_API_URL) return console.warn("[primitive-env] No .primitive/config.json found; using VITE_APP_ID / VITE_API_URL from the environment. Run 'primitive init' to make the project the source of truth."), r = f.VITE_APP_NAME, {};
+				if (e instanceof C && e.kind === "missing-config" && f.VITE_APP_ID && f.VITE_API_URL) return console.warn("[primitive-env] No primitive/config.json found; using VITE_APP_ID / VITE_API_URL from the environment. Run 'primitive init' to make the project the source of truth."), r = f.VITE_APP_NAME, {};
 				throw e;
 			}
 			if (!(f.VITE_APP_ID && f.VITE_API_URL)) {
-				let e = R(s, l);
-				V(u, e, p), o = {
+				let e = G(s, l);
+				J(u, e, p), o = {
 					root: l,
 					mode: u,
 					dir: e
@@ -320,25 +388,25 @@ function H(e = {}) {
 				VITE_WS_URL: p.wsUrl,
 				VITE_APP_NAME: p.appName
 			}, h = { "import.meta.env.VITE_PRIMITIVE_ENV": JSON.stringify(p.name) }, g = [];
-			for (let e of M) {
+			for (let e of z) {
 				if (f[e] !== void 0) {
 					g.push(e);
 					continue;
 				}
 				let t = m[e];
-				t !== void 0 && (h[`import.meta.env.${e}`] = JSON.stringify(t), F(e, t));
+				t !== void 0 && (h[`import.meta.env.${e}`] = JSON.stringify(t), H(e, t));
 			}
-			return F("VITE_PRIMITIVE_ENV", p.name), i = g, n = {
+			return H("VITE_PRIMITIVE_ENV", p.name), i = g, n = {
 				apiUrl: f.VITE_API_URL ?? p.apiUrl,
 				wsUrl: f.VITE_WS_URL ?? p.wsUrl,
 				appId: f.VITE_APP_ID ?? p.appId,
 				appName: r
-			}, e.logResolved !== !1 && console.log(L(p, n, g)), g.length > 0 && console.warn(`[primitive-env] Overridden by an explicit value in .env or the shell: ${g.join(", ")}. Remove it to use .primitive/config.json (deploys reject these outright).`), { define: h };
+			}, e.logResolved !== !1 && console.log(W(p, n, g)), g.length > 0 && console.warn(`[primitive-env] Overridden by an explicit value in .env or the shell: ${g.join(", ")}. Remove it to use primitive/config.json (deploys reject these outright).`), { define: h };
 		},
 		configResolved(e) {
 			if (!o || !t) return;
-			let n = R(e, o.root), r = e?.mode ?? o.mode;
-			n === o.dir && r === o.mode || (V(r, n, t), o = {
+			let n = G(e, o.root), r = e?.mode ?? o.mode;
+			n === o.dir && r === o.mode || (J(r, n, t), o = {
 				root: o.root,
 				mode: r,
 				dir: n
@@ -361,17 +429,17 @@ function H(e = {}) {
 		}
 	};
 }
-function U(e, t) {
+function X(e, t) {
 	let n = [
 		".env",
 		".env.local",
 		`.env.${e}`,
 		`.env.${e}.local`
 	], r = {};
-	for (let e of n) Object.assign(r, W(s(t, e)));
+	for (let e of n) Object.assign(r, Z(s(t, e)));
 	return r;
 }
-function W(n) {
+function Z(n) {
 	if (!e(n)) return {};
 	let r = {};
 	for (let e of t(n, "utf-8").split(/\r?\n/)) {
@@ -385,4 +453,4 @@ function W(n) {
 	return r;
 }
 //#endregion
-export { b as PrimitiveEnvError, m as primitiveDevTools, H as primitiveEnv, I as resolvePrimitiveEnv };
+export { C as PrimitiveEnvError, m as primitiveDevTools, Y as primitiveEnv, U as resolvePrimitiveEnv };

package/dist/dev-tools/vite-plugin/primitive-env.d.ts

@@ -2,7 +2,7 @@
  * `primitiveEnv()` — Primitive environment configuration for a Vite app (#2873).
  *
  * A scaffolded app used to type its backend URL and app ID twice: once in
- * `.primitive/config.json` (which every `primitive` command reads) and again in
+ * `primitive/config.json` (which every `primitive` command reads) and again in
  * `.env` / `.env.production`. This plugin removes the second copy. It resolves
  * the selected Primitive environment at config time and `define`s the keys the
  * app already reads: