@prisma/cli 8.0.0-rc.1 → 8.0.0-rc.2

package/dist/lib/app/build-settings.js

@@ -1,98 +0,0 @@
-import path from "node:path";
-import { readFile } from "node:fs/promises";
-import { resolveBuildSettings, resolveConfiguredBuildSettings } from "@prisma/compute-sdk";
-//#region src/lib/app/build-settings.ts
-/** Legacy build-settings file: no longer read or written, only detected for migration. */
-const PRISMA_APP_CONFIG_FILENAME = "prisma.app.json";
-/**
-* Detects a leftover `prisma.app.json`. The file is no longer used: one that
-* matches the effective settings is reported for deletion, one with custom
-* values must be migrated to the compute config so builds never silently
-* change.
-*/
-async function detectLegacyBuildSettings(options) {
-	const configPath = path.join(options.appPath, PRISMA_APP_CONFIG_FILENAME);
-	let content;
-	try {
-		options.signal?.throwIfAborted();
-		content = await readFile(configPath, {
-			encoding: "utf8",
-			signal: options.signal
-		});
-	} catch (error) {
-		if (options.signal?.aborted) throw error;
-		return { kind: "absent" };
-	}
-	let legacy;
-	try {
-		const parsed = JSON.parse(content);
-		const buildCommand = normalizeLegacyBuildCommand(parsed.buildCommand);
-		const outputDirectory = typeof parsed.outputDirectory === "string" ? normalizeRelativePath(parsed.outputDirectory) : void 0;
-		if (buildCommand === void 0 || !outputDirectory) return {
-			kind: "invalid",
-			configPath
-		};
-		legacy = {
-			buildCommand,
-			outputDirectory
-		};
-	} catch {
-		return {
-			kind: "invalid",
-			configPath
-		};
-	}
-	return legacy.buildCommand === options.effective.buildCommand && legacy.outputDirectory === options.effective.outputDirectory ? {
-		kind: "matching",
-		configPath
-	} : {
-		kind: "custom",
-		configPath,
-		...legacy
-	};
-}
-/** Resolves build settings purely from framework inference; nothing is read or written. */
-async function resolveInferredAppBuildSettings(options) {
-	return {
-		status: "inferred",
-		configPath: null,
-		relativeConfigPath: null,
-		settings: await resolveBuildSettings(options)
-	};
-}
-/**
-* Resolves build settings when the compute config owns them: configured
-* fields win, omitted fields fall back to framework defaults.
-*/
-async function resolveConfiguredAppBuildSettings(options) {
-	const configFilename = path.basename(options.configPath);
-	const settings = await resolveConfiguredBuildSettings({
-		appPath: options.appPath,
-		buildType: options.buildType,
-		configured: options.configured,
-		source: `set by ${configFilename}`,
-		signal: options.signal
-	});
-	return {
-		status: "config",
-		configPath: options.configPath,
-		relativeConfigPath: configFilename,
-		settings
-	};
-}
-const WINDOWS_DRIVE_PREFIX = /^[A-Za-z]:/;
-function normalizeLegacyBuildCommand(value) {
-	if (typeof value === "string") return value.trim() || null;
-	if (value === null) return null;
-}
-function normalizeRelativePath(value) {
-	const raw = value.trim().replace(/\\/g, "/");
-	if (raw.length === 0 || raw.split("/").includes("..")) return;
-	if (WINDOWS_DRIVE_PREFIX.test(raw)) return;
-	const normalized = path.posix.normalize(raw);
-	const segments = normalized.split("/");
-	if (path.win32.isAbsolute(value) || path.posix.isAbsolute(normalized) || segments.includes("..")) return;
-	return normalized === "." ? "." : normalized;
-}
-//#endregion
-export { PRISMA_APP_CONFIG_FILENAME, detectLegacyBuildSettings, resolveConfiguredAppBuildSettings, resolveInferredAppBuildSettings };

package/dist/lib/app/build.js

@@ -1,82 +0,0 @@
-import "node:path";
-import "node:fs/promises";
-import { FRAMEWORKS } from "@prisma/compute-sdk/config";
-import { normalizeArtifactSymlinks, resolveBuildStrategy } from "@prisma/compute-sdk";
-//#region src/lib/app/build.ts
-const RESOLVED_APP_BUILD_TYPES = [...frameworkBuildTypesByLastOccurrence()];
-const APP_BUILD_TYPES = ["auto", ...RESOLVED_APP_BUILD_TYPES];
-const APP_BUILD_TYPE_LABELS = APP_BUILD_TYPES.join(", ");
-function frameworkBuildTypesByLastOccurrence() {
-	const buildTypes = /* @__PURE__ */ new Set();
-	for (const framework of FRAMEWORKS) {
-		if (buildTypes.has(framework.buildType)) buildTypes.delete(framework.buildType);
-		buildTypes.add(framework.buildType);
-	}
-	return buildTypes;
-}
-var AppBuildStrategy = class {
-	#appPath;
-	#entrypoint;
-	#buildType;
-	#signal;
-	#buildSettings;
-	constructor(options) {
-		this.#appPath = options.appPath;
-		this.#entrypoint = options.entrypoint;
-		this.#buildType = options.buildType ?? "auto";
-		this.#signal = options.signal;
-		this.#buildSettings = options.buildSettings;
-	}
-	async canBuild(signal = this.#signal) {
-		const { strategy } = await resolveAppBuildStrategy({
-			appPath: this.#appPath,
-			entrypoint: this.#entrypoint,
-			buildType: this.#buildType,
-			signal,
-			buildSettings: this.#buildSettings
-		});
-		return strategy.canBuild(signal);
-	}
-	async execute(signal = this.#signal) {
-		const { artifact } = await executeAppBuild({
-			appPath: this.#appPath,
-			entrypoint: this.#entrypoint,
-			buildType: this.#buildType,
-			signal,
-			buildSettings: this.#buildSettings
-		});
-		return artifact;
-	}
-};
-async function executeAppBuild(options) {
-	const { strategy, buildType } = await resolveAppBuildStrategy({
-		appPath: options.appPath,
-		entrypoint: options.entrypoint,
-		buildType: options.buildType ?? "auto",
-		signal: options.signal,
-		buildSettings: options.buildSettings
-	});
-	const artifact = await strategy.execute(options.signal);
-	try {
-		await normalizeArtifactSymlinks(artifact.directory, options.appPath, options.signal);
-		return {
-			artifact,
-			buildType
-		};
-	} catch (error) {
-		await artifact.cleanup?.().catch(() => void 0);
-		throw error;
-	}
-}
-async function resolveAppBuildStrategy(options) {
-	const buildType = options.buildType === "auto" && options.entrypoint ? "bun" : options.buildType;
-	return resolveBuildStrategy({
-		appPath: options.appPath,
-		buildType,
-		entrypoint: options.entrypoint,
-		buildSettings: options.buildSettings,
-		signal: options.signal
-	});
-}
-//#endregion
-export { APP_BUILD_TYPES, APP_BUILD_TYPE_LABELS, AppBuildStrategy, RESOLVED_APP_BUILD_TYPES, executeAppBuild };

package/dist/lib/app/bun-project.js

@@ -1,45 +0,0 @@
-import path from "node:path";
-import { access, readFile } from "node:fs/promises";
-//#region src/lib/app/bun-project.ts
-async function readBunPackageJson(appPath, signal) {
-	const packageJsonPath = path.join(appPath, "package.json");
-	let content;
-	signal?.throwIfAborted();
-	try {
-		content = await readFile(packageJsonPath, {
-			encoding: "utf8",
-			signal
-		});
-	} catch (error) {
-		if (error.code === "ENOENT") return null;
-		throw new Error(`Failed to read ${packageJsonPath}: ${error instanceof Error ? error.message : String(error)}`);
-	}
-	try {
-		return JSON.parse(content);
-	} catch (error) {
-		throw new Error(`Failed to parse ${packageJsonPath}: ${error instanceof Error ? error.message : String(error)}`);
-	}
-}
-function readBunPackageEntrypoint(packageJson) {
-	return typeof packageJson?.main === "string" ? packageJson.main : void 0;
-}
-async function resolveBunEntrypoint(appPath, explicitEntrypoint, signal) {
-	const packageJson = await readBunPackageJson(appPath, signal);
-	const candidate = explicitEntrypoint ?? readBunPackageEntrypoint(packageJson);
-	if (!candidate) throw new Error("Entrypoint is required. Pass --entry or define package.json main.");
-	if (path.isAbsolute(candidate)) throw new Error("Entrypoint must be a relative path.");
-	const normalized = path.normalize(candidate);
-	if (normalized.startsWith("..") || path.isAbsolute(normalized) || normalized.includes(`${path.sep}..${path.sep}`)) throw new Error("Entrypoint must not escape the app directory.");
-	const entrypointPath = path.join(appPath, normalized);
-	signal?.throwIfAborted();
-	try {
-		await access(entrypointPath);
-		signal?.throwIfAborted();
-	} catch (error) {
-		if (signal?.aborted) throw error;
-		throw new Error(`Entrypoint file does not exist: ${entrypointPath}`);
-	}
-	return normalized.split(path.sep).join("/");
-}
-//#endregion
-export { readBunPackageEntrypoint, readBunPackageJson, resolveBunEntrypoint };

package/dist/lib/app/compute-config.js

@@ -1,145 +0,0 @@
-import { CliError } from "../../errors.js";
-import path from "node:path";
-import { COMPUTE_CONFIG_FILENAME, frameworkByKey, loadComputeConfig } from "@prisma/compute-sdk/config";
-import { matchError } from "better-result";
-//#region src/lib/app/compute-config.ts
-/**
-* Loads the nearest compute config, searching from `cwd` up to the source
-* root (repository or workspace boundary). Thin adapter over the SDK loader
-* keeping the CLI's positional-signal call shape.
-*/
-async function loadComputeConfig$1(cwd, signal) {
-	return loadComputeConfig(cwd, { signal });
-}
-/** Local build/run strategy implied by a configured framework. */
-function computeFrameworkToBuildType(framework) {
-	return frameworkByKey(framework).buildType;
-}
-function mergeComputeDeployInputs(options) {
-	const { cli, target, configFilename } = options;
-	const configAnnotation = `set by ${configFilename}`;
-	const framework = mergeStringInput(cli.framework, "set by --framework", target?.framework ?? void 0, configAnnotation);
-	const entrypoint = mergeStringInput(cli.entrypoint, "set by --entry", target?.entry ?? void 0, configAnnotation);
-	const httpPort = mergeStringInput(cli.httpPort, "set by --http-port", target?.httpPort ? String(target.httpPort) : void 0, configAnnotation);
-	const region = mergeStringInput(cli.region, "set by --region", target?.region ?? void 0, configAnnotation);
-	const cliEnvInputs = cli.envInputs && cli.envInputs.length > 0 ? cli.envInputs : void 0;
-	const configEnvInputs = target && target.envInputs.length > 0 ? target.envInputs : void 0;
-	const envInputs = cliEnvInputs ?? configEnvInputs;
-	const configAppName = readConfigAppName(target, configAnnotation);
-	return {
-		framework,
-		entrypoint,
-		httpPort,
-		region,
-		envInputs,
-		envInputsFromConfig: !cliEnvInputs && configEnvInputs !== void 0,
-		configAppName,
-		appRoot: target?.root ?? void 0
-	};
-}
-function mergeStringInput(cliValue, cliAnnotation, configValue, configAnnotation) {
-	if (cliValue !== void 0) return {
-		value: cliValue,
-		annotation: cliAnnotation
-	};
-	if (configValue) return {
-		value: configValue,
-		annotation: configAnnotation
-	};
-}
-function readConfigAppName(target, configAnnotation) {
-	if (target?.name) return {
-		value: target.name,
-		annotation: configAnnotation
-	};
-	if (target?.key) return {
-		value: target.key,
-		annotation: configAnnotation
-	};
-}
-/**
-* Merges CLI inputs for the local `app build` and `app run` commands with a
-* selected config target. Explicit flags win; `--build-type auto` is the
-* flag default and defers to the configured framework.
-*/
-function mergeComputeLocalInputs(options) {
-	const { cli, target } = options;
-	const cliBuildType = cli.buildType && cli.buildType !== "auto" ? cli.buildType : void 0;
-	const configBuildType = target?.framework ? computeFrameworkToBuildType(target.framework) : void 0;
-	return {
-		entrypoint: cli.entrypoint ?? target?.entry ?? void 0,
-		buildType: cliBuildType ?? configBuildType,
-		buildTypeFromConfig: !cliBuildType && configBuildType !== void 0,
-		port: cli.port ?? (target?.httpPort ? String(target.httpPort) : void 0),
-		appRoot: target?.root ?? void 0
-	};
-}
-function computeConfigErrorToCliError(error, commandName = "deploy") {
-	const command = `prisma-cli app ${commandName}`;
-	return matchError(error, {
-		ComputeConfigAmbiguousError: (ambiguous) => new CliError({
-			code: "COMPUTE_CONFIG_INVALID",
-			domain: "app",
-			summary: "Multiple compute config files found",
-			why: ambiguous.message,
-			fix: `Keep exactly one compute config file, preferably ${COMPUTE_CONFIG_FILENAME}.`,
-			meta: { configPaths: ambiguous.configPaths },
-			exitCode: 2,
-			nextSteps: [command]
-		}),
-		ComputeConfigLoadError: (load) => new CliError({
-			code: "COMPUTE_CONFIG_INVALID",
-			domain: "app",
-			summary: `Could not load ${path.basename(load.configPath)}`,
-			why: load.message,
-			fix: `Fix the error in ${path.basename(load.configPath)} and rerun the command.`,
-			where: load.configPath,
-			meta: { configPath: load.configPath },
-			exitCode: 2,
-			nextSteps: [command]
-		}),
-		ComputeConfigInvalidError: (invalid) => new CliError({
-			code: "COMPUTE_CONFIG_INVALID",
-			domain: "app",
-			summary: `Invalid ${path.basename(invalid.configPath)}`,
-			why: invalid.issues.join(" "),
-			fix: `Edit ${path.basename(invalid.configPath)} so it default-exports defineComputeConfig({ app }) or defineComputeConfig({ apps }).`,
-			where: invalid.configPath,
-			meta: {
-				configPath: invalid.configPath,
-				issues: invalid.issues
-			},
-			exitCode: 2,
-			nextSteps: [command]
-		}),
-		ComputeConfigTargetRequiredError: (required) => new CliError({
-			code: "COMPUTE_CONFIG_TARGET_REQUIRED",
-			domain: "app",
-			summary: "App target required",
-			why: required.message,
-			fix: `Pass the app target, for example ${command} <target>.`,
-			meta: {
-				configPath: required.configPath,
-				availableTargets: required.availableTargets
-			},
-			exitCode: 2,
-			nextSteps: required.availableTargets.map((target) => `${command} ${target}`)
-		}),
-		ComputeConfigTargetUnknownError: (unknown) => new CliError({
-			code: "COMPUTE_CONFIG_TARGET_UNKNOWN",
-			domain: "app",
-			summary: `Unknown app target "${unknown.requestedTarget}"`,
-			why: unknown.message,
-			fix: unknown.availableTargets.length > 0 ? `Pass one of the configured targets: ${unknown.availableTargets.join(", ")}.` : "Remove the target argument; this config defines a single app.",
-			meta: {
-				configPath: unknown.configPath,
-				requestedTarget: unknown.requestedTarget,
-				availableTargets: unknown.availableTargets
-			},
-			exitCode: 2,
-			nextSteps: unknown.availableTargets.length > 0 ? unknown.availableTargets.map((target) => `${command} ${target}`) : [command]
-		})
-	});
-}
-//#endregion
-export { computeConfigErrorToCliError, computeFrameworkToBuildType, loadComputeConfig$1 as loadComputeConfig, mergeComputeDeployInputs, mergeComputeLocalInputs };

package/dist/lib/app/deploy-output.js

@@ -1,24 +0,0 @@
-import { padDisplay } from "../../shell/ui.js";
-//#region src/lib/app/deploy-output.ts
-const DEPLOY_OUTPUT_MIN_LABEL_WIDTH = 9;
-const DEPLOY_OUTPUT_MIN_VALUE_WIDTH = 9;
-const DEPLOY_SETTINGS_MIN_KEY_WIDTH = 10;
-function renderDeployOutputRows(ui, rows) {
-	if (rows.length === 0) return [];
-	const labelWidth = Math.max(DEPLOY_OUTPUT_MIN_LABEL_WIDTH, ...rows.map((row) => row.label.length));
-	const valueWidth = Math.max(DEPLOY_OUTPUT_MIN_VALUE_WIDTH, ...rows.map((row) => row.value?.length ?? 0));
-	return rows.map((row) => {
-		if (!row.value) return `  ${row.label}`;
-		return `  ${padDisplay(row.label, labelWidth)}  ${padDisplay(ui.strong(row.value), valueWidth)}${row.origin ? `  ${ui.dim(`· ${row.origin}`)}` : ""}`.trimEnd();
-	});
-}
-function renderDeploySettingsPreview(ui, rows) {
-	if (rows.length === 0) return [];
-	const keyWidth = Math.max(DEPLOY_SETTINGS_MIN_KEY_WIDTH, ...rows.map((row) => `${row.key}:`.length));
-	const rail = ui.dim("│");
-	return rows.map((row) => {
-		return `${rail}  ${ui.accent(padDisplay(`${row.key}:`, keyWidth))}  ${ui.strong(row.value)}`;
-	});
-}
-//#endregion
-export { renderDeployOutputRows, renderDeploySettingsPreview };

package/dist/lib/app/deploy-plan.js

@@ -1,59 +0,0 @@
-//#region src/lib/app/deploy-plan.ts
-/**
-* Decides whether a deploy covers one app or the whole system. A multi-app
-* config with no target named or inferred deploys every target in declaration
-* order; everything else (single-app config, an explicit/inferred target, or
-* no config at all) is a single deploy.
-*/
-function planAppDeploy(options) {
-	const { config, requestedTarget, hasCreateProject } = options;
-	if (!(config !== null && config.kind === "multi" && !requestedTarget && config.targets.length > 1)) return { mode: "single" };
-	const total = config.targets.length;
-	return {
-		mode: "all",
-		targets: config.targets.map((target, index) => ({
-			targetKey: target.key,
-			index,
-			total,
-			bindsCreateProject: index === 0 && hasCreateProject
-		}))
-	};
-}
-/**
-* Names the per-app inputs present in a deploy-all invocation, in the order
-* they should be reported. An empty list means the run is unambiguous; the
-* caller renders the usage error when it is not.
-*/
-function perAppInputsForDeployAll(inputs) {
-	return [
-		["--app", inputs.appName],
-		["--framework", inputs.framework],
-		["--entry", inputs.entrypoint],
-		["--http-port", inputs.httpPort],
-		["--region", inputs.region],
-		["--env", inputs.envAssignments?.length ? inputs.envAssignments : void 0],
-		[inputs.appIdEnvVar.name, inputs.appIdEnvVar.value]
-	].filter(([, value]) => value !== void 0).map(([flag]) => flag);
-}
-/**
-* Describes a deploy-all run that stopped at the first failing target: which
-* targets already went live and which were never attempted, so the caller can
-* surface a converge path. Pure; the caller folds this into the CliError.
-*/
-function describeDeployAllFailure(options) {
-	const { targetKeys, failedIndex, completed } = options;
-	const failedTarget = targetKeys[failedIndex];
-	const notAttempted = targetKeys.slice(failedIndex + 1);
-	return {
-		failedTarget,
-		completed,
-		notAttempted,
-		contextLines: [
-			`Deploying all apps stopped at "${failedTarget}" (${failedIndex + 1}/${targetKeys.length}).`,
-			...completed.length > 0 ? [`Already live: ${completed.map((entry) => entry.target).join(", ")}.`] : [],
-			...notAttempted.length > 0 ? [`Not attempted: ${notAttempted.join(", ")}.`] : []
-		]
-	};
-}
-//#endregion
-export { describeDeployAllFailure, perAppInputsForDeployAll, planAppDeploy };

package/dist/lib/app/deploy-progress.js

@@ -1,100 +0,0 @@
-import { renderDeployOutputRows } from "./deploy-output.js";
-//#region src/lib/app/deploy-progress.ts
-function createDeployProgressState() {
-	return {
-		buildStarted: false,
-		buildCompleted: false,
-		archiveReady: false,
-		uploadCompleted: false,
-		deploymentId: null,
-		startRequested: false,
-		containerLive: false,
-		deploymentUrl: null,
-		promotedUrl: null
-	};
-}
-function createDeployProgress(output, ui, enabled, state = createDeployProgressState()) {
-	const write = (line) => {
-		if (!enabled) return;
-		output.write(`${line}\n`);
-	};
-	const writeRows = (rows) => {
-		for (const line of renderDeployOutputRows(ui, rows)) write(line);
-	};
-	return {
-		onBuildStart() {
-			state.buildStarted = true;
-			write("Building locally...");
-		},
-		onBuildComplete() {
-			state.buildCompleted = true;
-		},
-		onArchiveReady(byteLength) {
-			state.archiveReady = true;
-			writeRows([{
-				label: "Built",
-				value: formatArtifactSize(byteLength)
-			}]);
-		},
-		onUploadStart() {
-			write("Uploading...");
-		},
-		onDeploymentCreated(deploymentId) {
-			state.deploymentId = deploymentId;
-		},
-		onUploadComplete() {
-			state.uploadCompleted = true;
-			writeRows([{ label: "Uploaded" }]);
-		},
-		onStartRequested() {
-			state.startRequested = true;
-			write("Deploying...");
-		},
-		onRunning(url) {
-			state.containerLive = true;
-			state.deploymentUrl = url;
-			writeRows([{ label: "Deployed" }]);
-		},
-		onPromoted(url) {
-			state.promotedUrl = url;
-		}
-	};
-}
-function formatArtifactSize(byteLength) {
-	return `${(byteLength / 1024 / 1024).toFixed(1)} MB`;
-}
-function createPromoteProgress(output, enabled) {
-	if (!enabled) return;
-	const write = (line) => {
-		output.write(`${line}\n`);
-	};
-	return {
-		onDeploymentStarting(deploymentId) {
-			write(`Starting deployment ${deploymentId}...`);
-		},
-		onDeploymentStartRequested() {
-			write("Requesting deployment start...");
-		},
-		onStatusChange(status) {
-			write(`Status: ${status}`);
-		},
-		onDeploymentRunning() {
-			write("Deployment is running.");
-		},
-		onPromoteStart() {
-			write("Promoting deployment...");
-		},
-		onPromoted(url) {
-			if (url) {
-				write(`Promoted to ${url}.`);
-				return;
-			}
-			write("Promotion complete.");
-		},
-		onPromoteFailed(error) {
-			write(`Promotion failed${error?.message ? `: ${error.message}` : "."}`);
-		}
-	};
-}
-//#endregion
-export { createDeployProgress, createDeployProgressState, createPromoteProgress };

package/dist/lib/app/domain-guidance.js

@@ -1,14 +0,0 @@
-//#region src/lib/app/domain-guidance.ts
-function formatDomainFailureFix(domain) {
-	if (domain.status !== "failed") return null;
-	const dnsRecord = domain.dnsRecords[0];
-	if (domain.failureCategory === "dns") {
-		if (dnsRecord) return `Add ${dnsRecord.type} ${dnsRecord.name} -> ${dnsRecord.value}, then run prisma-cli app domain retry ${domain.hostname}.`;
-		return `DNS verification failed, but the platform did not return a DNS record. Run prisma-cli app domain show ${domain.hostname} later, then retry when the DNS target is available.`;
-	}
-	if (domain.failureCategory === "acme") return `Retry TLS issuance with prisma-cli app domain retry ${domain.hostname}. Contact support if it fails again.`;
-	if (domain.failureCategory === "storage") return `Retry provisioning with prisma-cli app domain retry ${domain.hostname}. Contact support if it fails again.`;
-	return `Run prisma-cli app domain retry ${domain.hostname}. Contact support if it fails again.`;
-}
-//#endregion
-export { formatDomainFailureFix };

package/dist/lib/app/env-config.js

@@ -1,67 +0,0 @@
-import { usageError } from "../../errors.js";
-//#region src/lib/app/env-config.ts
-const VALID_ROLES = new Set(["production", "preview"]);
-function positionalHint(command) {
-	if (command === "add" || command === "update") return "KEY=value ";
-	if (command === "remove") return "KEY ";
-	return "";
-}
-function resolveEnvScope(flags, options) {
-	if (flags.roleName && flags.branchName) throw usageError(`prisma-cli project env ${options.command} accepts either --role or --branch`, "--role targets a project-level config map; --branch targets a preview branch override.", "Pass exactly one scope flag.", [`prisma-cli project env ${options.command} ${positionalHint(options.command)}--role preview`, `prisma-cli project env ${options.command} ${positionalHint(options.command)}--branch feature/foo`], "app");
-	if (flags.roleName) {
-		if (!VALID_ROLES.has(flags.roleName)) throw usageError(`Unknown role "${flags.roleName}"`, "--role accepts production or preview.", "Pass --role production or --role preview.", [`prisma-cli project env ${options.command} --role production`, `prisma-cli project env ${options.command} --role preview`], "app");
-		return {
-			kind: "role",
-			role: flags.roleName
-		};
-	}
-	if (flags.branchName) return {
-		kind: "branch",
-		branchName: flags.branchName
-	};
-	if (options.requireExplicit) {
-		const positional = positionalHint(options.command);
-		throw usageError(`prisma-cli project env ${options.command} requires --role or --branch`, "Writing without an explicit scope is rejected so the command never silently targets production.", "Pass --role production, --role preview, or --branch <git-name>.", [
-			`prisma-cli project env ${options.command} ${positional}--role production`,
-			`prisma-cli project env ${options.command} ${positional}--role preview`,
-			`prisma-cli project env ${options.command} ${positional}--branch feature/foo`
-		], "app");
-	}
-	return null;
-}
-function parseKeyValuePositional(raw, command, env = process.env) {
-	if (!raw) throw usageError(`prisma-cli project env ${command} requires KEY=VALUE`, "No KEY=VALUE positional argument was supplied.", "Pass the variable as KEY=VALUE, e.g. STRIPE_KEY=sk_test_xxx.", [`prisma-cli project env ${command} STRIPE_KEY=sk_test_xxx --role production`], "app");
-	const separatorIndex = raw.indexOf("=");
-	if (separatorIndex === -1) {
-		if (KEY_SHAPE.test(raw)) {
-			validateKey(raw, command);
-			const value = env[raw];
-			if (typeof value === "string" && value.length > 0) return {
-				key: raw,
-				value
-			};
-			throw usageError(`Value for "${raw}" was not provided`, `No KEY=VALUE assignment was supplied, and ${raw} is not set in the current environment.`, "Pass KEY=VALUE or export the variable before running the command.", [`prisma-cli project env ${command} ${raw}=value --role production`, `${raw}=value prisma-cli project env ${command} ${raw} --role production`], "app");
-		}
-		throw usageError(`KEY=VALUE argument is missing the = separator`, `"${raw}" does not contain an = character.`, "Pass the variable as KEY=VALUE, e.g. STRIPE_KEY=sk_test_xxx.", [`prisma-cli project env ${command} STRIPE_KEY=sk_test_xxx --role production`], "app");
-	}
-	const key = raw.slice(0, separatorIndex);
-	const value = raw.slice(separatorIndex + 1);
-	validateKey(key, command);
-	if (value.length === 0) throw usageError(`KEY=VALUE argument has an empty value`, `"${raw}" has an empty value after the = separator.`, `Pass a non-empty value, or use prisma-cli project env remove to remove a variable.`, [`prisma-cli project env ${command} ${key}=value --role production`], "app");
-	return {
-		key,
-		value
-	};
-}
-const KEY_SHAPE = /^[A-Z_][A-Z0-9_]*$/;
-function validateKey(key, command) {
-	if (key.length === 0) throw usageError(`Variable key cannot be empty`, "An empty key was passed.", "Pass an env-var key, e.g. STRIPE_KEY.", [`prisma-cli project env ${command} STRIPE_KEY${command === "remove" ? "" : "=value"} --role production`], "app");
-	if (key.length > 256) throw usageError(`Variable key "${key}" exceeds the 256-character limit`, "Env-var keys are capped at 256 characters by the platform.", "Use a shorter key.", [], "app");
-	if (!KEY_SHAPE.test(key)) throw usageError(`Variable key "${key}" must match the POSIX env-var shape`, "Keys must start with an uppercase letter or underscore and contain only uppercase letters, digits, and underscores.", "Rename the key to match [A-Z_][A-Z0-9_]*.", [`prisma-cli project env ${command} STRIPE_KEY${command === "remove" ? "" : "=value"} --role production`], "app");
-}
-function formatScopeLabel(scope) {
-	if (scope.kind === "role") return scope.role;
-	return `branch:${scope.branchName}`;
-}
-//#endregion
-export { formatScopeLabel, parseKeyValuePositional, resolveEnvScope, validateKey };