@prisma/cli 3.0.0-alpha.9 → 3.0.0-beta.1

package/dist/presenters/app.js

@@ -1,4 +1,5 @@
 import { renderDeployOutputRows } from "../lib/app/deploy-output.js";
+import { formatDomainFailureFix } from "../lib/app/domain-guidance.js";
 import { renderList, renderShow, serializeList } from "../output/patterns.js";
 //#region src/presenters/app.ts
 function renderAppBuild(context, descriptor, result) {
@@ -44,74 +45,6 @@ function formatDuration(durationMs) {
 	if (durationMs < 1e3) return `${durationMs}ms`;
 	return `${(durationMs / 1e3).toFixed(1)}s`;
 }
-function renderAppUpdateEnv(context, descriptor, result) {
-	return renderShow({
-		title: "Updating environment variables for the selected app.",
-		descriptor,
-		fields: [
-			{
-				key: "project",
-				value: result.projectId
-			},
-			{
-				key: "app",
-				value: result.app.name
-			},
-			{
-				key: "deployment",
-				value: result.deployment.id
-			},
-			{
-				key: "status",
-				value: result.deployment.status,
-				tone: toneForStatus(result.deployment.status)
-			},
-			...result.deployment.url ? [{
-				key: "url",
-				value: result.deployment.url,
-				tone: "link"
-			}] : [],
-			{
-				key: "variables",
-				value: formatVariableNames(result.variables),
-				tone: result.variables.length > 0 ? "default" : "dim"
-			}
-		]
-	}, context.ui);
-}
-function serializeAppUpdateEnv(result) {
-	return result;
-}
-function renderAppListEnv(context, descriptor, result) {
-	return renderShow({
-		title: "Listing environment variables for the selected app.",
-		descriptor,
-		fields: [
-			{
-				key: "project",
-				value: result.projectId
-			},
-			{
-				key: "app",
-				value: result.app?.name ?? "not selected",
-				tone: result.app ? "default" : "dim"
-			},
-			{
-				key: "deployment",
-				value: result.deployment?.id ?? "none",
-				tone: result.deployment ? toneForStatus(result.deployment.status) : "dim"
-			},
-			{
-				key: "variables",
-				value: formatVariableNames(result.variables),
-				tone: result.variables.length > 0 ? "default" : "dim"
-			}
-		]
-	}, context.ui);
-}
-function serializeAppListEnv(result) {
-	return result;
-}
 function renderAppListDeploys(context, descriptor, result) {
 	return renderList({
 		title: "Listing deployments for the selected app.",
@@ -253,6 +186,105 @@ function renderAppOpen(context, descriptor, result) {
 function serializeAppOpen(result) {
 	return result;
 }
+function renderAppDomainAdd(context, descriptor, result) {
+	return renderShow({
+		title: result.existing ? "Showing the existing custom domain for the selected app." : "Adding a custom domain to the selected app.",
+		descriptor,
+		fields: [
+			...domainTargetFields(result),
+			{
+				key: "hostname",
+				value: result.domain.hostname
+			},
+			{
+				key: "status",
+				value: result.domain.status,
+				tone: toneForDomainStatus(result.domain.status)
+			},
+			...domainDnsFields(result.domain)
+		]
+	}, context.ui);
+}
+function serializeAppDomainAdd(result) {
+	return result;
+}
+function renderAppDomainShow(context, descriptor, result) {
+	return renderShow({
+		title: "Showing custom domain status.",
+		descriptor,
+		fields: [
+			...domainTargetFields(result),
+			{
+				key: "hostname",
+				value: result.domain.hostname
+			},
+			{
+				key: "status",
+				value: result.domain.status,
+				tone: toneForDomainStatus(result.domain.status)
+			},
+			...domainFailureFields(result.domain),
+			{
+				key: "cert expires",
+				value: formatOptionalUtcDate(result.domain.certExpiresAt),
+				tone: result.domain.certExpiresAt ? "default" : "dim"
+			},
+			{
+				key: "created",
+				value: formatUtcDate(result.domain.createdAt),
+				tone: "dim"
+			},
+			...domainDnsFields(result.domain)
+		]
+	}, context.ui);
+}
+function serializeAppDomainShow(result) {
+	return result;
+}
+function renderAppDomainRemove(context, descriptor, result) {
+	return renderShow({
+		title: "Removing a custom domain from the selected app.",
+		descriptor,
+		fields: [
+			...domainTargetFields(result),
+			{
+				key: "hostname",
+				value: result.hostname
+			},
+			{
+				key: "removed",
+				value: result.removed ? "yes" : "no",
+				tone: result.removed ? "success" : "dim"
+			}
+		]
+	}, context.ui);
+}
+function serializeAppDomainRemove(result) {
+	return result;
+}
+function renderAppDomainRetry(context, descriptor, result) {
+	return renderShow({
+		title: "Retrying custom domain verification.",
+		descriptor,
+		fields: [
+			...domainTargetFields(result),
+			{
+				key: "hostname",
+				value: result.domain.hostname
+			},
+			{
+				key: "status",
+				value: result.domain.status,
+				tone: toneForDomainStatus(result.domain.status)
+			},
+			...domainFailureFields(result.domain),
+			...domainDnsFields(result.domain)
+		]
+	}, context.ui);
+}
+function serializeAppDomainRetry(result) {
+	return result;
+}
 function renderAppPromote(context, descriptor, result) {
 	return renderShow({
 		title: "Switching the live deployment for the selected app.",
@@ -380,13 +412,80 @@ function toneForStatus(status) {
 	if (status === "failed" || status === "error") return "error";
 	return "default";
 }
+function toneForDomainStatus(status) {
+	if (status === "active") return "success";
+	if (status === "failed") return "error";
+	if (status === "pending_dns" || status === "verifying" || status === "provisioning_tls" || status === "verified_routing_blocked") return "warning";
+	return "default";
+}
+function domainTargetFields(result) {
+	return [
+		{
+			key: "workspace",
+			value: result.workspace.name
+		},
+		{
+			key: "project",
+			value: result.project.name
+		},
+		{
+			key: "branch",
+			value: result.branch.name
+		},
+		{
+			key: "app",
+			value: result.app.name
+		}
+	];
+}
+function domainDnsFields(domain) {
+	const records = domain.dnsRecords;
+	if (records.length === 0) return [{
+		key: "dns record",
+		value: "not provided by platform",
+		tone: "dim"
+	}];
+	return [{
+		key: "dns record",
+		value: records.map((record) => {
+			const ttl = record.ttl ? ` ttl ${record.ttl}` : "";
+			return `${record.type} ${record.name} -> ${record.value}${ttl}`;
+		}).join(", ")
+	}];
+}
+function formatDomainFailure(domain) {
+	if (!domain.failureReason) return domain.failureCategory ?? "none";
+	return domain.failureCategory ? `${domain.failureCategory} - ${domain.failureReason}` : domain.failureReason;
+}
+function domainFailureFields(domain) {
+	const tone = hasDomainFailure(domain) ? "error" : "dim";
+	return [{
+		key: "failure",
+		value: formatDomainFailure(domain),
+		tone
+	}, ...domainFixFields(domain)];
+}
+function hasDomainFailure(domain) {
+	return Boolean(domain.failureCategory || domain.failureReason);
+}
+function domainFixFields(domain) {
+	const fix = formatDomainFailureFix(domain);
+	return fix ? [{
+		key: "fix",
+		value: fix
+	}] : [];
+}
+function formatOptionalUtcDate(value) {
+	return value ? formatUtcDate(value) : "-";
+}
+function formatUtcDate(value) {
+	const date = new Date(value);
+	if (Number.isNaN(date.getTime())) return value;
+	return `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, "0")}-${String(date.getUTCDate()).padStart(2, "0")} ${String(date.getUTCHours()).padStart(2, "0")}:${String(date.getUTCMinutes()).padStart(2, "0")} UTC`;
+}
 function formatRecentDeployments(deployments) {
 	if (deployments.length === 0) return "none";
 	return deployments.map((deployment) => `${deployment.id}${deployment.live ? " (live)" : ""}`).join(", ");
 }
-function formatVariableNames(variables) {
-	if (variables.length === 0) return "none";
-	return variables.join(", ");
-}
 //#endregion
-export { renderAppBuild, renderAppDeploy, renderAppListDeploys, renderAppListEnv, renderAppOpen, renderAppPromote, renderAppRemove, renderAppRollback, renderAppRun, renderAppShow, renderAppShowDeploy, renderAppUpdateEnv, serializeAppBuild, serializeAppDeploy, serializeAppListDeploys, serializeAppListEnv, serializeAppOpen, serializeAppPromote, serializeAppRemove, serializeAppRollback, serializeAppRun, serializeAppShow, serializeAppShowDeploy, serializeAppUpdateEnv };
+export { renderAppBuild, renderAppDeploy, renderAppDomainAdd, renderAppDomainRemove, renderAppDomainRetry, renderAppDomainShow, renderAppListDeploys, renderAppOpen, renderAppPromote, renderAppRemove, renderAppRollback, renderAppRun, renderAppShow, renderAppShowDeploy, serializeAppBuild, serializeAppDeploy, serializeAppDomainAdd, serializeAppDomainRemove, serializeAppDomainRetry, serializeAppDomainShow, serializeAppListDeploys, serializeAppOpen, serializeAppPromote, serializeAppRemove, serializeAppRollback, serializeAppRun, serializeAppShow, serializeAppShowDeploy };

package/dist/presenters/auth.js

@@ -7,9 +7,10 @@ function renderAuthSuccess(context, descriptor, command, result) {
 			key: "provider",
 			value: providerLabel(result.provider)
 		});
-		if (result.user) rows.push({
+		const userLabel = authUserLabel(result);
+		if (userLabel) rows.push({
 			key: "user",
-			value: result.user.email
+			value: userLabel
 		});
 		if (result.workspace?.name) rows.push({
 			key: "workspace",
@@ -45,10 +46,7 @@ function renderAuthSuccess(context, descriptor, command, result) {
 				value: "signed in",
 				tone: "success"
 			},
-			...result.user ? [{
-				key: "user",
-				value: result.user.email
-			}] : [],
+			...authUserRows(result),
 			...result.provider ? [{
 				key: "provider",
 				value: providerLabel(result.provider)
@@ -69,5 +67,20 @@ function providerLabel(provider) {
 	if (provider === "google") return "Google";
 	return "";
 }
+function authUserLabel(result) {
+	return result.user?.email ?? credentialUserLabel(result);
+}
+function authUserRows(result) {
+	const userLabel = authUserLabel(result);
+	return userLabel ? [{
+		key: "user",
+		value: userLabel
+	}] : [];
+}
+function credentialUserLabel(result) {
+	if (result.credential?.type === "service_token") return result.credential.name ? `<service token: ${result.credential.name}>` : "<service token>";
+	if (result.credential?.type === "management_token") return result.credential.name ? `<management token: ${result.credential.name}>` : "<management token>";
+	return null;
+}
 //#endregion
 export { renderAuthSuccess };

package/dist/presenters/project.js

@@ -1,7 +1,9 @@
+import { renderNextSteps, renderSummaryLine } from "../shell/ui.js";
+import { formatCommandArgument } from "../shell/command-arguments.js";
 import { renderList, renderMutate, renderShow, serializeList } from "../output/patterns.js";
 //#region src/presenters/project.ts
 function renderProjectList(context, descriptor, result) {
-	return renderList({
+	const lines = renderList({
 		title: "Listing projects for the authenticated workspace.",
 		descriptor,
 		parentContext: {
@@ -16,21 +18,42 @@ function renderProjectList(context, descriptor, result) {
 		})),
 		emptyMessage: "No projects found."
 	}, context.ui);
+	if (result.localBinding?.status === "not-linked" || result.localBinding?.status === "invalid") lines.push(...renderNextSteps(["Link an existing Project you choose: prisma-cli project link <id-or-name>", "Create a new Project: prisma-cli project create <name>"]));
+	return lines;
 }
 function serializeProjectList(result) {
-	return serializeList({
-		context: { workspace: result.workspace.name },
-		items: result.projects.map((project) => ({
-			noun: "project",
-			label: project.name,
-			id: project.id,
-			status: null
-		}))
-	});
+	return {
+		...serializeList({
+			context: { workspace: result.workspace.name },
+			items: result.projects.map((project) => ({
+				noun: "project",
+				label: project.name,
+				id: project.id,
+				status: null
+			}))
+		}),
+		localBinding: result.localBinding ?? null
+	};
 }
 function renderProjectShow(context, descriptor, result) {
+	if (result.project === null) {
+		const lines = renderShow({
+			title: "This directory is not linked to a Prisma Project.",
+			descriptor,
+			fields: [{
+				key: "workspace",
+				value: result.workspace.name
+			}, {
+				key: "project",
+				value: "Not linked",
+				tone: "warning"
+			}]
+		}, context.ui);
+		lines.push(...renderNextSteps(["Link an existing Project you choose: prisma-cli project link <id-or-name>", `Create a new Project: prisma-cli project create ${formatCommandArgument(result.suggestedProjectName)}`]));
+		return lines;
+	}
 	return renderShow({
-		title: "Showing the project Prisma resolves for this directory.",
+		title: "Showing this directory's Project binding.",
 		descriptor,
 		fields: [
 			{
@@ -51,6 +74,14 @@ function renderProjectShow(context, descriptor, result) {
 function serializeProjectShow(result) {
 	return result;
 }
+function renderProjectSetup(context, _descriptor, result) {
+	const lines = result.action === "created" ? [renderSummaryLine(context.ui, "success", `Created Project "${result.project.name}"`)] : [];
+	lines.push(renderSummaryLine(context.ui, "success", `Linked "${result.directory}" to Project "${result.project.name}"`), `Saved ${result.localPin.path}`);
+	return lines;
+}
+function serializeProjectSetup(result) {
+	return result;
+}
 function renderGitConnect(context, descriptor, result) {
 	const connection = result.repositoryConnection;
 	return renderMutate({
@@ -108,11 +139,9 @@ function formatProjectSource(source) {
 		case "env": return "environment";
 		case "local-pin": return "local pin";
 		case "platform-mapping": return "platform mapping";
-		case "remembered-local": return "remembered local context";
-		case "package-name": return "package name";
-		case "directory-name": return "directory name";
 		case "created": return "created";
 		case "prompt": return "prompt";
+		case "unbound": return "unbound";
 	}
 }
 function formatGitConnectionDetail(status) {
@@ -124,4 +153,4 @@ function formatGitConnectionDetail(status) {
 	}
 }
 //#endregion
-export { renderGitConnect, renderGitDisconnect, renderProjectList, renderProjectShow, serializeProjectList, serializeProjectShow };
+export { renderGitConnect, renderGitDisconnect, renderProjectList, renderProjectSetup, renderProjectShow, serializeProjectList, serializeProjectSetup, serializeProjectShow };

package/dist/shell/command-arguments.js

@@ -0,0 +1,6 @@
+//#region src/shell/command-arguments.ts
+function formatCommandArgument(value) {
+	return /^[A-Za-z0-9._/-]+$/.test(value) && !value.startsWith("-") ? value : `'${value.replace(/'/g, "'\\''")}'`;
+}
+//#endregion
+export { formatCommandArgument };

package/dist/shell/command-meta.js

@@ -54,7 +54,11 @@ const DESCRIPTORS = [
 		id: "project",
 		path: ["prisma", "project"],
 		description: "Manage and inspect your Prisma projects",
-		examples: ["prisma-cli project list", "prisma-cli project show"]
+		examples: [
+			"prisma-cli project list",
+			"prisma-cli project link proj_123",
+			"prisma-cli project create my-app"
+		]
 	},
 	{
 		id: "app",
@@ -91,9 +95,33 @@ const DESCRIPTORS = [
 			"project",
 			"show"
 		],
-		description: "Show which project is active for this directory",
+		description: "Show this directory's Project binding",
 		examples: ["prisma-cli project show", "prisma-cli project show --project proj_123 --json"]
 	},
+	{
+		id: "project.create",
+		path: [
+			"prisma",
+			"project",
+			"create"
+		],
+		description: "Create a Project and link this directory",
+		examples: ["prisma-cli project create my-app", "prisma-cli project create my-app --json"]
+	},
+	{
+		id: "project.link",
+		path: [
+			"prisma",
+			"project",
+			"link"
+		],
+		description: "Link this directory to a Project",
+		examples: [
+			"prisma-cli project link",
+			"prisma-cli project link proj_123",
+			"prisma-cli project link \"Acme Dashboard\" --json"
+		]
+	},
 	{
 		id: "git.connect",
 		path: [
@@ -180,52 +208,106 @@ const DESCRIPTORS = [
 			"deploy"
 		],
 		description: "Creates a new deployment for the app",
+		longDescription: "Agent skills for guided Next.js deploys are available from the Prisma CLI skill cluster.",
 		examples: [
 			"prisma-cli app deploy",
+			"prisma-cli app deploy --project proj_123",
+			"prisma-cli app deploy --create-project my-app --yes",
 			"prisma-cli app deploy --app my-app --env DATABASE_URL=postgresql://example",
 			"prisma-cli app deploy --app my-app --framework nextjs --http-port 3000",
-			"prisma-cli app deploy --branch feat-login --framework hono"
+			"prisma-cli app deploy --branch feat-login --framework hono",
+			"pnpm dlx skills@latest add prisma/prisma-cli/skills#cli-v<cli-version> --all",
+			"prisma-cli app deploy --framework bun --entry src/server.ts"
 		]
 	},
 	{
-		id: "app.update-env",
+		id: "app.show",
+		path: [
+			"prisma",
+			"app",
+			"show"
+		],
+		description: "Show the app and its current deployment",
+		examples: ["prisma-cli app show", "prisma-cli app show --app hello-world"]
+	},
+	{
+		id: "app.open",
 		path: [
 			"prisma",
 			"app",
-			"update-env"
+			"open"
 		],
-		description: "Create a new deployment with updated environment variables.",
-		examples: ["prisma-cli app update-env --env DATABASE_URL=postgresql://example", "prisma-cli app update-env --app hello-world --env DATABASE_URL=postgresql://another"]
+		description: "Open the app's live URL",
+		examples: ["prisma-cli app open", "prisma-cli app open --app hello-world"]
 	},
 	{
-		id: "app.list-env",
+		id: "app.domain",
 		path: [
 			"prisma",
 			"app",
-			"list-env"
+			"domain"
 		],
-		description: "List environment variable names for the selected app.",
-		examples: ["prisma-cli app list-env", "prisma-cli app list-env --app hello-world"]
+		description: "Manage custom domains for an app",
+		examples: [
+			"prisma-cli app domain add shop.acme.com",
+			"prisma-cli app domain wait shop.acme.com --timeout 15m",
+			"prisma-cli app domain retry shop.acme.com"
+		]
 	},
 	{
-		id: "app.show",
+		id: "app.domain.add",
 		path: [
 			"prisma",
 			"app",
+			"domain",
+			"add"
+		],
+		description: "Register a custom domain on the app's production branch",
+		examples: ["prisma-cli app domain add shop.acme.com"]
+	},
+	{
+		id: "app.domain.show",
+		path: [
+			"prisma",
+			"app",
+			"domain",
 			"show"
 		],
-		description: "Show the app and its current deployment",
-		examples: ["prisma-cli app show", "prisma-cli app show --app hello-world"]
+		description: "Show custom domain status and certificate details",
+		examples: ["prisma-cli app domain show shop.acme.com"]
 	},
 	{
-		id: "app.open",
+		id: "app.domain.remove",
 		path: [
 			"prisma",
 			"app",
-			"open"
+			"domain",
+			"remove"
 		],
-		description: "Open the app's live URL",
-		examples: ["prisma-cli app open", "prisma-cli app open --app hello-world"]
+		description: "Detach a custom domain from the app",
+		examples: ["prisma-cli app domain remove shop.acme.com --yes"]
+	},
+	{
+		id: "app.domain.retry",
+		path: [
+			"prisma",
+			"app",
+			"domain",
+			"retry"
+		],
+		description: "Retry custom domain DNS verification and TLS provisioning",
+		examples: ["prisma-cli app domain retry shop.acme.com"]
+	},
+	{
+		id: "app.domain.wait",
+		path: [
+			"prisma",
+			"app",
+			"domain",
+			"wait"
+		],
+		description: "Wait until a custom domain is active or failed",
+		examples: ["prisma-cli app domain wait shop.acme.com", "prisma-cli app domain wait shop.acme.com --timeout 0 --json"]
 	},
 	{
 		id: "app.logs",
@@ -298,7 +380,8 @@ const DESCRIPTORS = [
 		examples: [
 			"prisma-cli project env list --role production",
 			"prisma-cli project env add STRIPE_KEY=sk_test_xxx --role production",
-			"prisma-cli project env rm STRIPE_KEY --role preview"
+			"prisma-cli project env add DATABASE_URL=postgresql://branch --branch feature/foo",
+			"prisma-cli project env remove STRIPE_KEY --role preview"
 		]
 	},
 	{
@@ -313,6 +396,7 @@ const DESCRIPTORS = [
 		examples: [
 			"prisma-cli project env add STRIPE_KEY=sk_test_xxx --role production",
 			"prisma-cli project env add STRIPE_KEY=sk_test_xxx --role preview",
+			"prisma-cli project env add DATABASE_URL=postgresql://branch --branch feature/foo",
 			"API_URL=https://api.example prisma-cli project env add API_URL --project proj_123 --role preview"
 		]
 	},
@@ -325,7 +409,11 @@ const DESCRIPTORS = [
 			"update"
 		],
 		description: "Replace an existing environment variable's value.",
-		examples: ["prisma-cli project env update STRIPE_KEY=sk_new_xxx --role production", "prisma-cli project env update STRIPE_KEY=sk_new_xxx --role preview"]
+		examples: [
+			"prisma-cli project env update STRIPE_KEY=sk_new_xxx --role production",
+			"prisma-cli project env update STRIPE_KEY=sk_new_xxx --role preview",
+			"prisma-cli project env update DATABASE_URL=postgresql://branch --branch feature/foo"
+		]
 	},
 	{
 		id: "project.env.list",
@@ -336,18 +424,26 @@ const DESCRIPTORS = [
 			"list"
 		],
 		description: "List environment variable metadata for a scope (no values).",
-		examples: ["prisma-cli project env list --role production", "prisma-cli project env list --role preview"]
+		examples: [
+			"prisma-cli project env list --role production",
+			"prisma-cli project env list --role preview",
+			"prisma-cli project env list --branch feature/foo"
+		]
 	},
 	{
-		id: "project.env.rm",
+		id: "project.env.remove",
 		path: [
 			"prisma",
 			"project",
 			"env",
-			"rm"
+			"remove"
 		],
 		description: "Remove an environment variable from a scope.",
-		examples: ["prisma-cli project env rm STRIPE_KEY --role production", "prisma-cli project env rm STRIPE_KEY --role preview"]
+		examples: [
+			"prisma-cli project env remove STRIPE_KEY --role production",
+			"prisma-cli project env remove STRIPE_KEY --role preview",
+			"prisma-cli project env remove DATABASE_URL --branch feature/foo"
+		]
 	}
 ];
 const DESCRIPTORS_BY_ID = new Map(DESCRIPTORS.map((descriptor) => [descriptor.id, descriptor]));