Catch erroneous use of `deployments view [deployment-id] --experiment…

…al-versions` command (#5405)

.changeset/tough-suns-punch.md

@@ -0,0 +1,7 @@
+---
+"wrangler": patch
+---
+
+chore: add `wrangler deployments view [deployment-id] --experimental-versions` command
+
+This command will display an error message which points the user to run either `wrangler deployments status --experimental-versions` or `wrangler versions view <version-id> --experimental-versions` instead.

packages/wrangler/src/__tests__/versions/deployments/deployments.view.test.ts

@@ -0,0 +1,22 @@
+import { UserError } from "../../../errors";
+import { runWrangler } from "../../helpers/run-wrangler";
+
+describe("deployments view", () => {
+	test("error when run with no args", async () => {
+		const result = runWrangler("deployments view  --x-versions");
+
+		await expect(result).rejects.toMatchInlineSnapshot(
+			`[Error: \`wrangler deployments view\` has been renamed \`wrangler deployments status --x-versions\`. Please use that command instead.]`
+		);
+		await expect(result).rejects.toBeInstanceOf(UserError);
+	});
+
+	test("error when run with positional arg", async () => {
+		const result = runWrangler("deployments view dummy-id  --x-versions");
+
+		await expect(result).rejects.toMatchInlineSnapshot(
+			`[Error: \`wrangler deployments view <deployment-id>\` has been renamed \`wrangler versions view [version-id] --x-versions\`. Please use that command instead.]`
+		);
+		await expect(result).rejects.toBeInstanceOf(UserError);
+	});
+});

packages/wrangler/src/versions/deployments/index.ts

@@ -6,6 +6,10 @@ import {
 	versionsDeploymentsStatusHandler,
 	versionsDeploymentsStatusOptions,
 } from "./status";
+import {
+	versionsDeploymentsViewHandler,
+	versionsDeploymentsViewOptions,
+} from "./view";
 import type { CommonYargsArgv } from "../../yargs-types";
 
 export default function registerVersionsDeploymentsSubcommands(
@@ -23,5 +27,11 @@ export default function registerVersionsDeploymentsSubcommands(
 			"See the current state of your production [beta]",
 			versionsDeploymentsStatusOptions,
 			versionsDeploymentsStatusHandler
+		)
+		.command(
+			"view [deployment-id]",
+			false,
+			versionsDeploymentsViewOptions,
+			versionsDeploymentsViewHandler
 		);
 }

packages/wrangler/src/versions/deployments/view.ts

@@ -0,0 +1,41 @@
+import { UserError } from "../../errors";
+import { printWranglerBanner } from "../../update-check";
+import type {
+	CommonYargsArgv,
+	StrictYargsOptionsToInterface,
+} from "../../yargs-types";
+
+export type VersionsDeploymentsViewArgs = StrictYargsOptionsToInterface<
+	typeof versionsDeploymentsViewOptions
+>;
+
+export function versionsDeploymentsViewOptions(yargs: CommonYargsArgv) {
+	return yargs
+		.option("name", {
+			describe: "Name of the worker",
+			type: "string",
+			requiresArg: true,
+		})
+		.positional("deployment-id", {
+			describe:
+				"Deprecated. Deployment ID is now referred to as Version ID. Please use `wrangler versions view [version-id]` instead.",
+			type: "string",
+			requiresArg: true,
+		});
+}
+
+export async function versionsDeploymentsViewHandler(
+	args: VersionsDeploymentsViewArgs
+) {
+	await printWranglerBanner();
+
+	if (args.deploymentId === undefined) {
+		throw new UserError(
+			"`wrangler deployments view` has been renamed `wrangler deployments status --x-versions`. Please use that command instead."
+		);
+	} else {
+		throw new UserError(
+			"`wrangler deployments view <deployment-id>` has been renamed `wrangler versions view [version-id] --x-versions`. Please use that command instead."
+		);
+	}
+}