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

package/dist/controllers/app-env.js

@@ -1,502 +0,0 @@
-import { CliError, authRequiredError, usageError, workspaceRequiredError } from "../errors.js";
-import { authenticatedManagementApiClient } from "../auth/guard.js";
-import { formatScopeLabel, parseKeyValuePositional, resolveEnvScope } from "../lib/app/env-config.js";
-import { readEnvFileAssignments } from "../lib/app/env-file.js";
-import { readLocalGitBranch } from "../lib/git/local-branch.js";
-import { projectResolutionErrorToCliError, resolveProjectTarget } from "../lib/project/resolution.js";
-import { requireAuthenticatedAuthState } from "./auth.js";
-import { listRealWorkspaceProjects } from "./project.js";
-import { apiCallError, findVariableByNaturalKey, toMetadata } from "./app-env-api.js";
-import { runEnvAddFile, runEnvUpdateFile } from "./app-env-file.js";
-//#region src/controllers/app-env.ts
-async function runEnvAdd(context, rawAssignment, flags) {
-	const source = resolveEnvWriteSource(rawAssignment, flags.filePath, "add");
-	const scope = resolveEnvScope(flags, {
-		requireExplicit: true,
-		command: "add"
-	});
-	if (!scope) throw usageError(`prisma-cli project env add requires --role or --branch`, "Writing without an explicit scope is rejected.", "Pass --role production, --role preview, or --branch <git-name>.", ["prisma-cli project env add KEY=value --role production"], "app");
-	const input = await resolveEnvWriteInput(context, source, "add");
-	const { client, projectId, verboseContext } = await requireClientAndProject(context, flags.projectRef, "project env add");
-	const resolved = await resolveScopeToApi(client, projectId, scope, {
-		createBranchIfMissing: true,
-		signal: context.runtime.signal
-	});
-	if (input.kind === "file") return runEnvAddFile(context, client, projectId, resolved, input.filePath, input.assignments, verboseContext);
-	if (await findVariableByNaturalKey(client, projectId, input.key, resolved, context.runtime.signal)) throw new CliError({
-		code: "ENV_VARIABLE_ALREADY_EXISTS",
-		domain: "app",
-		summary: `Variable "${input.key}" already exists in ${formatScopeLabel(scope)}`,
-		why: "A variable with this key already exists in the targeted scope.",
-		fix: "Use `prisma-cli project env update` to change an existing variable's value.",
-		exitCode: 1,
-		nextSteps: [`prisma-cli project env update ${input.key}=<new-value> ${formatScopeFlag(scope)}`]
-	});
-	const warnings = scope.kind === "branch" && !await findVariableByNaturalKey(client, projectId, input.key, {
-		descriptor: {
-			kind: "role",
-			role: "preview"
-		},
-		apiTarget: {
-			class: "preview",
-			branchId: null
-		}
-	}, context.runtime.signal) ? [`Variable "${input.key}" does not exist in preview. It will only exist on ${formatScopeLabel(scope)}.`] : [];
-	const { data, error, response } = await client.POST("/v1/environment-variables", {
-		body: {
-			projectId,
-			class: resolved.apiTarget.class,
-			...resolved.apiTarget.branchId !== null ? { branchId: resolved.apiTarget.branchId } : {},
-			key: input.key,
-			value: input.value
-		},
-		signal: context.runtime.signal
-	});
-	if (error || !data) throw apiCallError(`Failed to add ${input.key}`, response, error);
-	return {
-		command: "project.env.add",
-		result: {
-			projectId,
-			verboseContext,
-			scope: resolved.descriptor,
-			variable: toMetadata(data.data, resolved.descriptor)
-		},
-		warnings,
-		nextSteps: []
-	};
-}
-async function runEnvUpdate(context, rawAssignment, flags) {
-	const source = resolveEnvWriteSource(rawAssignment, flags.filePath, "update");
-	const scope = resolveEnvScope(flags, {
-		requireExplicit: true,
-		command: "update"
-	});
-	if (!scope) throw usageError(`prisma-cli project env update requires --role or --branch`, "Writing without an explicit scope is rejected.", "Pass --role production, --role preview, or --branch <git-name>.", ["prisma-cli project env update KEY=value --role production"], "app");
-	const input = await resolveEnvWriteInput(context, source, "update");
-	const { client, projectId, verboseContext } = await requireClientAndProject(context, flags.projectRef, "project env update");
-	const resolved = await resolveScopeToApi(client, projectId, scope, {
-		createBranchIfMissing: false,
-		signal: context.runtime.signal
-	});
-	if (input.kind === "file") return runEnvUpdateFile(context, client, projectId, resolved, input.filePath, input.assignments, verboseContext);
-	const existing = await findVariableByNaturalKey(client, projectId, input.key, resolved, context.runtime.signal);
-	if (!existing) throw new CliError({
-		code: "ENV_VARIABLE_NOT_FOUND",
-		domain: "app",
-		summary: `Variable "${input.key}" not found in ${formatScopeLabel(scope)}`,
-		why: "No variable with this key exists in the targeted scope.",
-		fix: "Use `prisma-cli project env add` to create a new variable.",
-		exitCode: 1,
-		nextSteps: [`prisma-cli project env add ${input.key}=<value> ${formatScopeFlag(scope)}`]
-	});
-	const { data, error, response } = await client.PATCH("/v1/environment-variables/{envVarId}", {
-		params: { path: { envVarId: existing.id } },
-		body: { value: input.value },
-		signal: context.runtime.signal
-	});
-	if (error || !data) throw apiCallError(`Failed to update value for ${input.key}`, response, error);
-	return {
-		command: "project.env.update",
-		result: {
-			projectId,
-			verboseContext,
-			scope: resolved.descriptor,
-			variable: toMetadata(data.data, resolved.descriptor)
-		},
-		warnings: [],
-		nextSteps: []
-	};
-}
-function resolveEnvWriteSource(rawAssignment, filePath, command) {
-	if (filePath !== void 0 && rawAssignment !== void 0) throw usageError(`prisma-cli project env ${command} accepts either KEY=VALUE or --file`, "The command received both a positional assignment and a dotenv file path.", "Pass one input source.", [`prisma-cli project env ${command} KEY=value --role preview`, `prisma-cli project env ${command} --file .env --role preview`], "app");
-	if (filePath !== void 0) {
-		if (filePath.length === 0) throw usageError(`prisma-cli project env ${command} --file requires a path`, "The --file flag was passed without a file path.", "Pass a readable dotenv file path.", [`prisma-cli project env ${command} --file .env --role preview`], "app");
-		return {
-			kind: "file",
-			filePath
-		};
-	}
-	if (rawAssignment === void 0) throw usageError(`prisma-cli project env ${command} requires KEY=VALUE or --file`, "No environment variable input was supplied.", "Pass a single KEY=VALUE assignment or a dotenv file path.", [`prisma-cli project env ${command} KEY=value --role preview`, `prisma-cli project env ${command} --file .env --role preview`], "app");
-	return {
-		kind: "single",
-		rawAssignment
-	};
-}
-async function resolveEnvWriteInput(context, source, command) {
-	if (source.kind === "file") return {
-		kind: "file",
-		filePath: source.filePath,
-		assignments: await readEnvFileAssignments(context.runtime.cwd, source.filePath, command)
-	};
-	return {
-		kind: "single",
-		...parseKeyValuePositional(source.rawAssignment, command, context.runtime.env)
-	};
-}
-async function runEnvList(context, flags) {
-	const explicit = resolveEnvScope(flags, {
-		requireExplicit: false,
-		command: "list"
-	});
-	const { client, projectId, verboseContext } = await requireClientAndProject(context, flags.projectRef, "project env list");
-	const resolved = await resolveListScopeToApi(client, projectId, explicit ?? void 0, {
-		cwd: context.runtime.cwd,
-		signal: context.runtime.signal
-	});
-	const variables = resolved.kind === "scoped" ? await listVariables(client, projectId, {
-		scope: resolved.addScope,
-		descriptor: resolved.descriptor,
-		apiTarget: resolved.apiTarget
-	}, context.runtime.signal) : await listOverviewVariables(client, projectId, context.runtime.signal);
-	return {
-		command: "project.env.list",
-		result: {
-			projectId,
-			verboseContext,
-			scope: resolved.descriptor,
-			target: resolved.target,
-			variables: variables.map((row) => toMetadata(row, resolved.descriptor))
-		},
-		warnings: [],
-		nextSteps: variables.length === 0 ? [`prisma-cli project env add KEY=value ${formatScopeFlag(resolved.addScope)}`] : []
-	};
-}
-async function runEnvRemove(context, key, flags) {
-	if (!key) throw usageError("prisma-cli project env remove requires KEY", "No KEY positional argument was supplied.", "Pass the variable name to remove, e.g. STRIPE_KEY.", ["prisma-cli project env remove STRIPE_KEY --role production"], "app");
-	const scope = resolveEnvScope(flags, {
-		requireExplicit: true,
-		command: "remove"
-	});
-	if (!scope) throw usageError("prisma-cli project env remove requires --role or --branch", "Writing without an explicit scope is rejected.", "Pass --role production, --role preview, or --branch <git-name>.", [`prisma-cli project env remove ${key} --role production`], "app");
-	const { client, projectId, verboseContext } = await requireClientAndProject(context, flags.projectRef, "project env remove");
-	const resolved = await resolveScopeToApi(client, projectId, scope, {
-		createBranchIfMissing: false,
-		signal: context.runtime.signal
-	});
-	const existing = await findVariableByNaturalKey(client, projectId, key, resolved, context.runtime.signal);
-	if (!existing) throw new CliError({
-		code: "ENV_VARIABLE_NOT_FOUND",
-		domain: "app",
-		summary: `Variable "${key}" not found in ${formatScopeLabel(scope)}`,
-		why: "No variable with this key exists in the targeted scope, so there is nothing to remove.",
-		fix: "Run prisma-cli project env list with the same scope to see the available variables.",
-		exitCode: 1,
-		nextSteps: [`prisma-cli project env list ${formatScopeFlag(scope)}`]
-	});
-	const { error, response } = await client.DELETE("/v1/environment-variables/{envVarId}", {
-		params: { path: { envVarId: existing.id } },
-		signal: context.runtime.signal
-	});
-	if (error) throw apiCallError(`Failed to remove ${key}`, response, error);
-	return {
-		command: "project.env.remove",
-		result: {
-			projectId,
-			verboseContext,
-			scope: resolved.descriptor,
-			key
-		},
-		warnings: [],
-		nextSteps: []
-	};
-}
-async function requireClientAndProject(context, explicitProject, commandName) {
-	const authState = await requireAuthenticatedAuthState(context);
-	const client = await authenticatedManagementApiClient(context.runtime.env, context.runtime.signal);
-	if (!client) throw authRequiredError(["prisma-cli auth login"]);
-	const workspace = authState.workspace;
-	if (!workspace) throw workspaceRequiredError();
-	const targetResult = await resolveProjectTarget({
-		context,
-		workspace,
-		explicitProject,
-		listProjects: () => listRealWorkspaceProjects(client, context.runtime.signal),
-		commandName
-	});
-	if (targetResult.isErr()) throw projectResolutionErrorToCliError(targetResult.error);
-	const target = targetResult.value;
-	return {
-		client,
-		projectId: target.project.id,
-		verboseContext: {
-			workspace,
-			project: target.project,
-			resolution: target.resolution
-		}
-	};
-}
-async function resolveScopeToApi(client, projectId, scope, options) {
-	if (scope.kind === "role") return {
-		scope,
-		descriptor: {
-			kind: "role",
-			role: scope.role
-		},
-		apiTarget: {
-			class: scope.role,
-			branchId: null
-		}
-	};
-	const branch = options.createBranchIfMissing ? await resolveOrCreateBranch(client, projectId, scope.branchName, options.signal) : await resolveExistingBranch(client, projectId, scope.branchName, options.signal);
-	if (branch.role === "production") throw new CliError({
-		code: "ENV_BRANCH_SCOPE_IS_PRODUCTION",
-		domain: "app",
-		summary: `Branch "${scope.branchName}" is the production branch`,
-		why: "Production variables are project-level only; branch overrides apply to preview branches.",
-		fix: "Use --role production for the production branch.",
-		exitCode: 1,
-		nextSteps: ["prisma-cli project env list --role production"]
-	});
-	return {
-		scope,
-		descriptor: {
-			kind: "branch",
-			branchName: branch.gitName,
-			branchId: branch.id
-		},
-		apiTarget: {
-			class: "preview",
-			branchId: branch.id
-		}
-	};
-}
-async function resolveListScopeToApi(client, projectId, explicit, options) {
-	if (explicit) {
-		const resolved = await resolveScopeToApi(client, projectId, explicit, {
-			createBranchIfMissing: false,
-			signal: options.signal
-		});
-		return {
-			kind: "scoped",
-			descriptor: resolved.descriptor,
-			target: targetFromExplicitScope(resolved.descriptor),
-			apiTarget: resolved.apiTarget,
-			addScope: resolved.scope
-		};
-	}
-	const gitBranch = await readLocalGitBranch(options.cwd, options.signal);
-	if (gitBranch) {
-		const branch = (await listBranchesByName(client, projectId, gitBranch, options.signal))[0];
-		if (!branch) return {
-			kind: "scoped",
-			descriptor: {
-				kind: "role",
-				role: "preview"
-			},
-			target: {
-				source: "local-git",
-				branchName: gitBranch,
-				branchExists: false,
-				envMap: "preview"
-			},
-			apiTarget: {
-				class: "preview",
-				branchId: null
-			},
-			addScope: {
-				kind: "branch",
-				branchName: gitBranch
-			}
-		};
-		if (branch.role === "production") return {
-			kind: "scoped",
-			descriptor: {
-				kind: "role",
-				role: "production"
-			},
-			target: {
-				source: "local-git",
-				branchName: branch.gitName,
-				branchId: branch.id,
-				branchRole: branch.role,
-				branchExists: true,
-				envMap: "production"
-			},
-			apiTarget: {
-				class: "production",
-				branchId: null
-			},
-			addScope: {
-				kind: "role",
-				role: "production"
-			}
-		};
-		return {
-			kind: "scoped",
-			descriptor: {
-				kind: "branch",
-				branchName: branch.gitName,
-				branchId: branch.id
-			},
-			target: {
-				source: "local-git",
-				branchName: branch.gitName,
-				branchId: branch.id,
-				branchRole: branch.role,
-				branchExists: true,
-				envMap: "preview"
-			},
-			apiTarget: {
-				class: "preview",
-				branchId: branch.id
-			},
-			addScope: {
-				kind: "branch",
-				branchName: branch.gitName
-			}
-		};
-	}
-	return {
-		kind: "overview",
-		descriptor: { kind: "overview" },
-		target: {
-			source: "overview",
-			envMap: "overview"
-		},
-		addScope: {
-			kind: "role",
-			role: "preview"
-		}
-	};
-}
-function targetFromExplicitScope(scope) {
-	if (scope.kind === "branch") return {
-		source: "explicit",
-		branchName: scope.branchName,
-		branchId: scope.branchId,
-		branchRole: "preview",
-		branchExists: true,
-		envMap: "preview"
-	};
-	if (scope.kind === "role") return {
-		source: "explicit",
-		envMap: scope.role
-	};
-	return {
-		source: "overview",
-		envMap: "overview"
-	};
-}
-function formatScopeFlag(scope) {
-	if (scope.kind === "role") return `--role ${scope.role}`;
-	return `--branch ${scope.branchName}`;
-}
-async function listBranchesByName(client, projectId, branchName, signal) {
-	const { data, error, response } = await client.GET("/v1/projects/{projectId}/branches", {
-		params: {
-			path: { projectId },
-			query: { gitName: branchName }
-		},
-		signal
-	});
-	if (error || !data) throw apiCallError(`Failed to resolve branch "${branchName}"`, response, error);
-	return data.data;
-}
-async function resolveExistingBranch(client, projectId, branchName, signal) {
-	const branch = (await listBranchesByName(client, projectId, branchName, signal))[0];
-	if (!branch) throw new CliError({
-		code: "ENV_BRANCH_NOT_FOUND",
-		domain: "app",
-		summary: `Branch "${branchName}" not found`,
-		why: "Branch update, list, and remove commands only target existing preview branches.",
-		fix: "Create the branch by deploying it, or use `project env add --branch` to create its first override.",
-		exitCode: 1,
-		nextSteps: [`prisma-cli project env add KEY=value --branch ${branchName}`]
-	});
-	return branch;
-}
-async function resolveOrCreateBranch(client, projectId, branchName, signal) {
-	const existing = (await listBranchesByName(client, projectId, branchName, signal))[0];
-	if (existing) return existing;
-	if (!await projectHasDefaultBranch(client, projectId, signal)) throw new CliError({
-		code: "ENV_BRANCH_CREATE_REQUIRES_DEFAULT_BRANCH",
-		domain: "app",
-		summary: `Cannot create branch "${branchName}" from project env`,
-		why: "Creating the first branch would make it the project default, but branch overrides are preview-only.",
-		fix: "Create or deploy the default branch first, then add the branch override.",
-		exitCode: 1,
-		nextSteps: ["prisma-cli app deploy --branch main"]
-	});
-	const { data, error, response } = await client.POST("/v1/projects/{projectId}/branches", {
-		params: { path: { projectId } },
-		body: {
-			gitName: branchName,
-			isDefault: false
-		},
-		signal
-	});
-	if (error || !data) {
-		if (response?.status === 409) {
-			const raced = (await listBranchesByName(client, projectId, branchName, signal))[0];
-			if (raced) return raced;
-		}
-		throw apiCallError(`Failed to create branch "${branchName}"`, response, error);
-	}
-	return data.data;
-}
-async function projectHasDefaultBranch(client, projectId, signal) {
-	let cursor;
-	while (true) {
-		const query = {};
-		if (cursor !== void 0) query.cursor = cursor;
-		const result = await client.GET("/v1/projects/{projectId}/branches", {
-			params: {
-				path: { projectId },
-				query
-			},
-			signal
-		});
-		if (result.error || !result.data) throw apiCallError("Failed to check project default branch", result.response, result.error);
-		if (result.data.data.some((branch) => branch.isDefault)) return true;
-		if (!result.data.pagination.hasMore || !result.data.pagination.nextCursor) return false;
-		cursor = result.data.pagination.nextCursor;
-	}
-}
-async function listVariables(client, projectId, resolved, signal) {
-	return materializeEffectiveRows(await collectEnvironmentVariables(client, projectId, signal, {
-		className: resolved.apiTarget.class,
-		filter: (row) => rowMatchesScope(row, resolved)
-	}), resolved);
-}
-async function listOverviewVariables(client, projectId, signal) {
-	return (await collectEnvironmentVariables(client, projectId, signal, { filter: (row) => row.branchId === null && (row.class === "production" || row.class === "preview") })).sort((left, right) => {
-		const roleOrder = roleSortOrder(left.class) - roleSortOrder(right.class);
-		return roleOrder !== 0 ? roleOrder : left.key.localeCompare(right.key);
-	});
-}
-async function collectEnvironmentVariables(client, projectId, signal, options) {
-	const collected = [];
-	let cursor;
-	while (true) {
-		const query = { projectId };
-		if (options.className !== void 0) query.class = options.className;
-		if (cursor !== void 0) query.cursor = cursor;
-		const result = await client.GET("/v1/environment-variables", {
-			params: { query },
-			signal
-		});
-		if (result.error || !result.data) throw apiCallError(`Failed to list environment variables`, result.response, result.error);
-		const page = result.data.data.filter(options.filter);
-		collected.push(...page);
-		if (!result.data.pagination.hasMore || !result.data.pagination.nextCursor) break;
-		cursor = result.data.pagination.nextCursor;
-	}
-	return collected;
-}
-function roleSortOrder(role) {
-	return role === "production" ? 0 : 1;
-}
-function rowMatchesScope(row, resolved) {
-	if (row.class !== resolved.apiTarget.class) return false;
-	if (resolved.apiTarget.branchId === null) return row.branchId === null;
-	return row.branchId === null || row.branchId === resolved.apiTarget.branchId;
-}
-function materializeEffectiveRows(rows, resolved) {
-	if (resolved.apiTarget.branchId === null) return rows;
-	const byKey = /* @__PURE__ */ new Map();
-	for (const row of rows) if (row.branchId === null && !byKey.has(row.key)) byKey.set(row.key, row);
-	for (const row of rows) if (row.branchId === resolved.apiTarget.branchId) byKey.set(row.key, row);
-	return [...byKey.values()].sort((left, right) => left.key.localeCompare(right.key));
-}
-//#endregion
-export { runEnvAdd, runEnvList, runEnvRemove, runEnvUpdate };