feat: ✨ introduce json output for cf pages deployment list, as it enables other tools like jq to parse the data

Author: gnekich

packages/wrangler/src/pages/deployments.ts

@@ -28,10 +28,19 @@ export function ListOptions(yargs: CommonYargsArgv) {
 			choices: ["production", "preview"],
 			description: "Environment type to list deployments for",
 		},
+		json: {
+			type: "boolean",
+			description: "Return output as clean JSON",
+			default: false,
+		},
 	});
 }
 
-export async function ListHandler({ projectName, environment }: ListArgs) {
+export async function ListHandler({
+	projectName,
+	environment,
+	json,
+}: ListArgs) {
 	const config = getConfigCache<PagesConfigCache>(PAGES_CONFIG_CACHE_FILENAME);
 	const accountId = await requireAuth(config);
 
@@ -72,6 +81,7 @@ export async function ListHandler({ projectName, environment }: ListArgs) {
 
 	const data = deployments.map((deployment) => {
 		return {
+			Id: deployment.id,
 			Environment: titleCase(deployment.environment),
 			Branch: deployment.deployment_trigger.metadata.branch,
 			Source: shortSha(deployment.deployment_trigger.metadata.commit_hash),
@@ -86,6 +96,10 @@ export async function ListHandler({ projectName, environment }: ListArgs) {
 		account_id: accountId,
 	});
 
-	logger.table(data);
+	if (json) {
+		logger.log(JSON.stringify(data, null, 2));
+	} else {
+		logger.table(data);
+	}
 	metrics.sendMetricsEvent("list pages deployments");
 }