@prisma/cli 2.20.1 → 3.0.0-alpha.1

package/dist/presenters/branch.js

@@ -0,0 +1,111 @@
+import { renderList, renderMutate, renderShow, serializeList } from "../output/patterns.js";
+//#region src/presenters/branch.ts
+function renderBranchList(context, descriptor, result) {
+	return renderList({
+		title: "Listing branches for the linked project.",
+		descriptor,
+		parentContext: {
+			key: "project",
+			value: result.projectName ?? "not linked"
+		},
+		items: result.branches.map((branch) => ({
+			noun: "branch",
+			label: branch.name,
+			id: branch.id,
+			status: branch.active ? "active" : null
+		})),
+		emptyMessage: "No branches found."
+	}, context.ui);
+}
+function serializeBranchList(result) {
+	return serializeList({
+		context: { project: result.projectName ?? "not linked" },
+		items: result.branches.map((branch) => ({
+			noun: "branch",
+			label: branch.name,
+			id: branch.id,
+			status: branch.active ? "active" : null
+		}))
+	});
+}
+function serializeBranchShow(result) {
+	return {
+		linkedProjectId: result.linkedProjectId,
+		projectName: result.projectName,
+		branch: {
+			name: result.branch.name,
+			kind: result.branch.kind,
+			active: result.branch.active,
+			remoteState: result.branch.remoteState,
+			liveDeployment: result.branch.liveDeployment
+		}
+	};
+}
+function renderBranchShow(context, descriptor, result) {
+	const fields = [
+		{
+			key: "project",
+			value: result.projectName ?? "not linked",
+			tone: result.projectName ? "default" : "dim"
+		},
+		{
+			key: "branch",
+			value: result.branch.name,
+			tone: result.branch.active ? "success" : "default"
+		},
+		{
+			key: "kind",
+			value: result.branch.kind
+		}
+	];
+	if (result.branch.liveDeployment) {
+		fields.push({
+			key: "status",
+			value: result.branch.liveDeployment.status,
+			tone: toneForDeploymentStatus(result.branch.liveDeployment.status)
+		});
+		if (result.branch.liveDeployment.url) fields.push({
+			key: "url",
+			value: result.branch.liveDeployment.url,
+			tone: "link"
+		});
+	} else if (!result.branch.remoteState) fields.push({
+		key: "remote state",
+		value: "not created yet",
+		tone: "dim"
+	});
+	return renderShow({
+		title: "Showing the current active branch context.",
+		descriptor,
+		fields
+	}, context.ui);
+}
+function toneForDeploymentStatus(status) {
+	if (status === "ready" || status === "active" || status === "healthy") return "success";
+	if (status === "pending" || status === "building" || status === "starting") return "warning";
+	if (status === "failed" || status === "error") return "error";
+	return "default";
+}
+function renderBranchUse(context, descriptor, result) {
+	return renderMutate({
+		title: "Changing the local default branch context.",
+		descriptor,
+		context: [{
+			key: "project",
+			value: result.projectName ?? "not linked",
+			tone: result.projectName ? "default" : "dim"
+		}, {
+			key: "branch",
+			value: result.branch.name
+		}],
+		operationDescription: "Applying active branch change",
+		operationCount: 1,
+		details: ["Active branch updated in local CLI state for this repo."],
+		alerts: result.branch.kind === "production" ? [{
+			tone: "warning",
+			text: "Production is protected and durable. Use with care"
+		}] : void 0
+	}, context.ui);
+}
+//#endregion
+export { renderBranchList, renderBranchShow, renderBranchUse, serializeBranchList, serializeBranchShow };

package/dist/presenters/project.js

@@ -0,0 +1,84 @@
+import { renderList, renderMutate, renderShow, serializeList } from "../output/patterns.js";
+//#region src/presenters/project.ts
+function renderProjectList(context, descriptor, result) {
+	return renderList({
+		title: "Listing projects for the authenticated workspace.",
+		descriptor,
+		parentContext: {
+			key: "workspace",
+			value: result.workspace.name
+		},
+		items: result.projects.map((project) => ({
+			noun: "project",
+			label: project.name,
+			id: project.id,
+			status: result.linkedProjectId === project.id ? "linked" : null
+		})),
+		emptyMessage: "No projects found."
+	}, context.ui);
+}
+function serializeProjectList(result) {
+	return serializeList({
+		context: { workspace: result.workspace.name },
+		items: result.projects.map((project) => ({
+			noun: "project",
+			label: project.name,
+			id: project.id,
+			status: result.linkedProjectId === project.id ? "linked" : null
+		}))
+	});
+}
+function renderProjectShow(context, descriptor, result) {
+	if (!result.linkedProjectId) return renderShow({
+		title: "Showing the linked project for the current repo.",
+		descriptor,
+		fields: [{
+			key: "project",
+			value: "not linked",
+			tone: "dim"
+		}]
+	}, context.ui);
+	if (!result.project || !result.workspace) return renderShow({
+		title: "Showing the linked project for the current repo.",
+		descriptor,
+		fields: [{
+			key: "project",
+			value: "linked",
+			tone: "success"
+		}, {
+			key: "remote details",
+			value: "unavailable until you sign in",
+			tone: "dim"
+		}]
+	}, context.ui);
+	return renderShow({
+		title: "Showing the linked project for the current repo.",
+		descriptor,
+		fields: [{
+			key: "project",
+			value: result.project.name
+		}, {
+			key: "workspace",
+			value: result.workspace.name
+		}]
+	}, context.ui);
+}
+function renderProjectLink(context, descriptor, result) {
+	if (!result.project || !result.workspace) throw new Error("Linked project result must be enriched for human output.");
+	return renderMutate({
+		title: "Linking the current repo to an existing project.",
+		descriptor,
+		context: [{
+			key: "project",
+			value: result.project.name
+		}, {
+			key: "workspace",
+			value: result.workspace.name
+		}],
+		operationDescription: "Applying local project link",
+		operationCount: 1,
+		details: ["Project link written to local repo config."]
+	}, context.ui);
+}
+//#endregion
+export { renderProjectLink, renderProjectList, renderProjectShow, serializeProjectList };

package/dist/shell/command-meta.js

@@ -0,0 +1,329 @@
+//#region src/shell/command-meta.ts
+const COMMAND_DESCRIPTOR_ID = Symbol("prisma.commandDescriptorId");
+const DESCRIPTORS = [
+	{
+		id: "root",
+		path: ["prisma"],
+		description: "Unified Prisma CLI.",
+		docsPath: "docs/product/command-principles.md",
+		examples: ["prisma auth login", "prisma project list"],
+		longDescription: "The Prisma CLI groups commands by developer workflow and keeps human and agent behavior aligned."
+	},
+	{
+		id: "auth",
+		path: ["prisma", "auth"],
+		description: "Authentication and identity commands.",
+		docsPath: "docs/product/command-spec.md#prisma-auth-login",
+		examples: ["prisma auth login", "prisma auth whoami"]
+	},
+	{
+		id: "auth.login",
+		path: [
+			"prisma",
+			"auth",
+			"login"
+		],
+		description: "Start an authenticated CLI session.",
+		docsPath: "docs/product/command-spec.md#prisma-auth-login",
+		examples: ["prisma auth login"]
+	},
+	{
+		id: "auth.logout",
+		path: [
+			"prisma",
+			"auth",
+			"logout"
+		],
+		description: "Clear the current CLI session.",
+		docsPath: "docs/product/command-spec.md#prisma-auth-logout",
+		examples: ["prisma auth logout"]
+	},
+	{
+		id: "auth.whoami",
+		path: [
+			"prisma",
+			"auth",
+			"whoami"
+		],
+		description: "Show the current authenticated identity.",
+		docsPath: "docs/product/command-spec.md#prisma-auth-whoami",
+		examples: ["prisma auth whoami", "prisma auth whoami --json"]
+	},
+	{
+		id: "project",
+		path: ["prisma", "project"],
+		description: "Project discovery and repo linking commands.",
+		docsPath: "docs/product/command-spec.md#prisma-project-list",
+		examples: ["prisma project list", "prisma project show"]
+	},
+	{
+		id: "app",
+		path: ["prisma", "app"],
+		description: "App deployment and release commands.",
+		docsPath: "docs/product/command-spec.md#prisma-app-deploy---app-name---entry-path---build-type-autobunnextjsnuxtastrotanstack-start---http-port-port---env-namevalue",
+		examples: [
+			"prisma app build --build-type nextjs",
+			"prisma app deploy --app hello-world --build-type nextjs --http-port 3000",
+			"prisma app deploy --app hello-world --build-type nuxt"
+		]
+	},
+	{
+		id: "branch",
+		path: ["prisma", "branch"],
+		description: "Branch context and safety commands.",
+		docsPath: "docs/product/command-spec.md#prisma-branch-list",
+		examples: ["prisma branch list", "prisma branch use production"]
+	},
+	{
+		id: "project.list",
+		path: [
+			"prisma",
+			"project",
+			"list"
+		],
+		description: "List projects for the authenticated workspace.",
+		docsPath: "docs/product/command-spec.md#prisma-project-list",
+		examples: ["prisma project list", "prisma project list --json"]
+	},
+	{
+		id: "project.show",
+		path: [
+			"prisma",
+			"project",
+			"show"
+		],
+		description: "Show the linked project for the current repo.",
+		docsPath: "docs/product/command-spec.md#prisma-project-show",
+		examples: ["prisma project show", "prisma project show --json"]
+	},
+	{
+		id: "project.link",
+		path: [
+			"prisma",
+			"project",
+			"link"
+		],
+		description: "Link the current repo to an existing project.",
+		docsPath: "docs/product/command-spec.md#prisma-project-link-project",
+		examples: ["prisma project link", "prisma project link proj_123"]
+	},
+	{
+		id: "branch.list",
+		path: [
+			"prisma",
+			"branch",
+			"list"
+		],
+		description: "List branches for the linked project.",
+		docsPath: "docs/product/command-spec.md#prisma-branch-list",
+		examples: ["prisma branch list", "prisma branch list --json"]
+	},
+	{
+		id: "branch.show",
+		path: [
+			"prisma",
+			"branch",
+			"show"
+		],
+		description: "Show the current active branch context.",
+		docsPath: "docs/product/command-spec.md#prisma-branch-show",
+		examples: ["prisma branch show", "prisma branch show --json"]
+	},
+	{
+		id: "branch.use",
+		path: [
+			"prisma",
+			"branch",
+			"use"
+		],
+		description: "Change the local default branch context.",
+		docsPath: "docs/product/command-spec.md#prisma-branch-use-name",
+		examples: ["prisma branch use", "prisma branch use production"]
+	},
+	{
+		id: "app.build",
+		path: [
+			"prisma",
+			"app",
+			"build"
+		],
+		description: "Build the local app into a deployable artifact.",
+		docsPath: "docs/product/command-spec.md#prisma-app-build---entry-path---build-type-autobunnextjsnuxtastrotanstack-start",
+		examples: [
+			"prisma app build --build-type nextjs",
+			"prisma app build --build-type nuxt",
+			"prisma app build --build-type bun --entry server.ts"
+		]
+	},
+	{
+		id: "app.run",
+		path: [
+			"prisma",
+			"app",
+			"run"
+		],
+		description: "Start a local framework dev server.",
+		docsPath: "docs/product/command-spec.md#prisma-app-run---entry-path---build-type-autobunnextjs---port-port",
+		examples: ["prisma app run --build-type nextjs", "prisma app run --build-type bun --entry server.ts --port 3000"]
+	},
+	{
+		id: "app.deploy",
+		path: [
+			"prisma",
+			"app",
+			"deploy"
+		],
+		description: "Build and release the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-deploy---app-name---entry-path---build-type-autobunnextjsnuxtastrotanstack-start---http-port-port---env-namevalue",
+		examples: [
+			"prisma app deploy",
+			"prisma app deploy --app hello-world --env DATABASE_URL=postgresql://example",
+			"prisma app deploy --app hello-world --build-type nextjs --http-port 3000",
+			"prisma app deploy --app hello-world --build-type nuxt"
+		]
+	},
+	{
+		id: "app.update-env",
+		path: [
+			"prisma",
+			"app",
+			"update-env"
+		],
+		description: "Create a new deployment with updated environment variables.",
+		docsPath: "docs/product/command-spec.md#prisma-app-update-env---app-name---env-namevalue",
+		examples: ["prisma app update-env --env DATABASE_URL=postgresql://example", "prisma app update-env --app hello-world --env DATABASE_URL=postgresql://another"]
+	},
+	{
+		id: "app.list-env",
+		path: [
+			"prisma",
+			"app",
+			"list-env"
+		],
+		description: "List environment variable names for the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-list-env---app-name",
+		examples: ["prisma app list-env", "prisma app list-env --app hello-world"]
+	},
+	{
+		id: "app.show",
+		path: [
+			"prisma",
+			"app",
+			"show"
+		],
+		description: "Show the current state of the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-show---app-name",
+		examples: ["prisma app show", "prisma app show --app hello-world"]
+	},
+	{
+		id: "app.open",
+		path: [
+			"prisma",
+			"app",
+			"open"
+		],
+		description: "Open the live URL for the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-open---app-name",
+		examples: ["prisma app open", "prisma app open --app hello-world"]
+	},
+	{
+		id: "app.logs",
+		path: [
+			"prisma",
+			"app",
+			"logs"
+		],
+		description: "Show or stream logs for a deployment.",
+		docsPath: "docs/product/command-spec.md#prisma-app-logs---app-name---deployment-id",
+		examples: ["prisma app logs", "prisma app logs --deployment dep_123"]
+	},
+	{
+		id: "app.list-deploys",
+		path: [
+			"prisma",
+			"app",
+			"list-deploys"
+		],
+		description: "List deployments for the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-list-deploys---app-name",
+		examples: ["prisma app list-deploys", "prisma app list-deploys --app hello-world"]
+	},
+	{
+		id: "app.show-deploy",
+		path: [
+			"prisma",
+			"app",
+			"show-deploy"
+		],
+		description: "Show one deployment in detail.",
+		docsPath: "docs/product/command-spec.md#prisma-app-show-deploy-deployment",
+		examples: ["prisma app show-deploy dep_123"]
+	},
+	{
+		id: "app.promote",
+		path: [
+			"prisma",
+			"app",
+			"promote"
+		],
+		description: "Switch the live deployment for the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-promote-deployment---app-name",
+		examples: ["prisma app promote dep_123", "prisma app promote dep_123 --app hello-world"]
+	},
+	{
+		id: "app.rollback",
+		path: [
+			"prisma",
+			"app",
+			"rollback"
+		],
+		description: "Restore the selected app to an earlier deployment.",
+		docsPath: "docs/product/command-spec.md#prisma-app-rollback---app-name---to-deployment",
+		examples: ["prisma app rollback", "prisma app rollback --app hello-world --to dep_123"]
+	},
+	{
+		id: "app.remove",
+		path: [
+			"prisma",
+			"app",
+			"remove"
+		],
+		description: "Remove the selected app from the linked project.",
+		docsPath: "docs/product/command-spec.md#prisma-app-remove---app-name--y---yes",
+		examples: ["prisma app remove --app hello-world", "prisma app remove --app hello-world --yes"]
+	}
+];
+const DESCRIPTORS_BY_ID = new Map(DESCRIPTORS.map((descriptor) => [descriptor.id, descriptor]));
+function attachCommandDescriptor(command, descriptorId) {
+	const descriptor = getCommandDescriptor(descriptorId);
+	command[COMMAND_DESCRIPTOR_ID] = descriptor.id;
+	command.description(descriptor.description);
+	return command;
+}
+function getCommandDescriptor(id) {
+	const descriptor = DESCRIPTORS_BY_ID.get(id);
+	if (!descriptor) throw new Error(`Unknown command descriptor "${id}".`);
+	return descriptor;
+}
+function getDescriptorForCommand(command) {
+	const descriptorId = command[COMMAND_DESCRIPTOR_ID];
+	if (descriptorId) return getCommandDescriptor(descriptorId);
+	const path = getCommandPath(command);
+	const descriptor = DESCRIPTORS.find((candidate) => candidate.path.join(" ") === path.join(" "));
+	if (!descriptor) throw new Error(`No command descriptor registered for "${path.join(" ")}".`);
+	return descriptor;
+}
+function getCommandPath(command) {
+	const names = [];
+	let current = command;
+	while (current) {
+		if (current.name()) names.unshift(current.name());
+		current = current.parent ?? null;
+	}
+	return names;
+}
+function formatDescriptorLabel(descriptor) {
+	return descriptor.path.length === 1 ? descriptor.path[0] : descriptor.path.slice(1).join(" ");
+}
+//#endregion
+export { attachCommandDescriptor, formatDescriptorLabel, getCommandDescriptor, getDescriptorForCommand };

package/dist/shell/command-runner.js

@@ -0,0 +1,33 @@
+import { CliError } from "./errors.js";
+import { getCommandDescriptor } from "./command-meta.js";
+import { resolveGlobalFlags } from "./global-flags.js";
+import { createCommandContext } from "./runtime.js";
+import { writeHumanError, writeHumanLines, writeJsonError, writeJsonSuccess } from "./output.js";
+//#region src/shell/command-runner.ts
+async function runCommand(runtime, commandName, options, handler, presenter) {
+	const flags = resolveGlobalFlags(runtime.argv, options);
+	const context = await createCommandContext(runtime, flags);
+	const descriptor = getCommandDescriptor(commandName);
+	try {
+		const success = await handler(context);
+		if (flags.json) {
+			writeJsonSuccess(context.output, {
+				...success,
+				result: presenter.renderJson ? presenter.renderJson(success.result) : success.result
+			});
+			return;
+		}
+		if (flags.quiet) return;
+		writeHumanLines(context.output, presenter.renderHuman(context, descriptor, success.result));
+	} catch (error) {
+		if (error instanceof CliError) {
+			if (flags.json) writeJsonError(context.output, commandName, error);
+			else writeHumanError(context.output, context.ui, error, { trace: flags.trace });
+			process.exitCode = error.exitCode;
+			return;
+		}
+		throw error;
+	}
+}
+//#endregion
+export { runCommand };

package/dist/shell/errors.js

@@ -0,0 +1,66 @@
+//#region src/shell/errors.ts
+var CliError = class extends Error {
+	code;
+	domain;
+	severity;
+	summary;
+	why;
+	fix;
+	debug;
+	where;
+	meta;
+	docsUrl;
+	exitCode;
+	nextSteps;
+	constructor(options) {
+		super(options.summary);
+		this.name = "CliError";
+		this.code = options.code;
+		this.domain = options.domain;
+		this.severity = "error";
+		this.summary = options.summary;
+		this.why = options.why;
+		this.fix = options.fix;
+		this.debug = options.debug ?? null;
+		this.where = options.where ?? null;
+		this.meta = options.meta ?? {};
+		this.docsUrl = options.docsUrl ?? null;
+		this.exitCode = options.exitCode ?? 1;
+		this.nextSteps = options.nextSteps ?? [];
+	}
+};
+function usageError(summary, why, fix, nextSteps = [], domain = "cli") {
+	return new CliError({
+		code: "USAGE_ERROR",
+		domain,
+		summary,
+		why,
+		fix,
+		exitCode: 2,
+		nextSteps
+	});
+}
+function authRequiredError(nextSteps = ["prisma auth login"]) {
+	return new CliError({
+		code: "AUTH_REQUIRED",
+		domain: "auth",
+		summary: "Authentication required",
+		why: "This command needs an authenticated session.",
+		fix: "Run prisma auth login, or rerun the command in a TTY to sign in interactively.",
+		exitCode: 1,
+		nextSteps
+	});
+}
+function featureUnavailableError(summary, why, fix, nextSteps = [], domain = "cli") {
+	return new CliError({
+		code: "FEATURE_UNAVAILABLE",
+		domain,
+		summary,
+		why,
+		fix,
+		exitCode: 1,
+		nextSteps
+	});
+}
+//#endregion
+export { CliError, authRequiredError, featureUnavailableError, usageError };

package/dist/shell/global-flags.js

@@ -0,0 +1,25 @@
+import { Option } from "commander";
+//#region src/shell/global-flags.ts
+function addGlobalFlags(command) {
+	return command.option("--json", "Emit structured JSON output.").option("-q, --quiet", "Reduce human-oriented output.").option("-v, --verbose", "Increase human-oriented output detail.").option("--trace", "Show deeper diagnostics for failures.").option("-y, --yes", "Accept supported confirmation prompts.").addOption(new Option("--interactive", "Force interactive behavior when prompts are supported.")).addOption(new Option("--no-interactive", "Disable interactive behavior and prompts.")).addOption(new Option("--color", "Force color output in supported terminals.")).addOption(new Option("--no-color", "Disable color output."));
+}
+function getExplicitBoolean(argv, positive, negative) {
+	for (let index = argv.length - 1; index >= 0; index -= 1) {
+		const value = argv[index];
+		if (value === positive) return true;
+		if (value === negative) return false;
+	}
+}
+function resolveGlobalFlags(argv, options) {
+	return {
+		json: options.json === true || argv.includes("--json"),
+		quiet: options.quiet === true || argv.includes("--quiet") || argv.includes("-q"),
+		verbose: options.verbose === true || argv.includes("--verbose") || argv.includes("-v"),
+		trace: options.trace === true || argv.includes("--trace"),
+		yes: options.yes === true || argv.includes("--yes") || argv.includes("-y"),
+		interactive: getExplicitBoolean(argv, "--interactive", "--no-interactive"),
+		color: getExplicitBoolean(argv, "--color", "--no-color")
+	};
+}
+//#endregion
+export { addGlobalFlags, resolveGlobalFlags };