From 317073e629387ca3f7e3b3430e5d5a6b4cd3cea4 Mon Sep 17 00:00:00 2001
From: Sarah Schneider <sarahs@users.noreply.github.com>
Date: Mon, 20 Oct 2025 11:21:24 -0400
Subject: [PATCH] Add programmatic CTA build option (#58041)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/content-render/scripts/cta-builder.ts | 64 +++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/src/content-render/scripts/cta-builder.ts b/src/content-render/scripts/cta-builder.ts
index df1c706593b7..f5aae6097073 100644
--- a/src/content-render/scripts/cta-builder.ts
+++ b/src/content-render/scripts/cta-builder.ts
@@ -64,6 +64,19 @@ program
     validateUrl(options)
   })
 
+// Add programmatic build command
+program
+  .command('build')
+  .description('Build a CTA URL programmatically with flags (outputs URL only)')
+  .requiredOption('--url <url>', 'Base URL for the CTA')
+  .requiredOption('--product <product>', 'Product reference (copilot, ghec, desktop)')
+  .requiredOption('--type <type>', 'CTA type (trial, purchase, engagement)')
+  .requiredOption('--style <style>', 'CTA style (button, text)')
+  .option('--plan <plan>', 'Plan reference (free, pro, business, enterprise)')
+  .action((options) => {
+    buildProgrammaticCTA(options)
+  })
+
 // Default to interactive mode
 program.action(() => {
   interactiveBuilder()
@@ -542,3 +555,54 @@ async function validateUrl(options: { url?: string }): Promise<void> {
     console.error(chalk.red('❌ An error occurred:'), error)
   }
 }
+
+// Programmatic build command handler
+async function buildProgrammaticCTA(options: {
+  url: string
+  product: string
+  type: string
+  style: string
+  plan?: string
+}): Promise<void> {
+  try {
+    // Validate base URL
+    let baseUrl: string
+    try {
+      baseUrl = new URL(options.url).toString()
+    } catch (error) {
+      console.error(
+        `Invalid base URL: ${options.url} - ${error instanceof Error ? error.message : error}`,
+      )
+      process.exit(1)
+    }
+
+    // Build CTA parameters object
+    const params: CTAParams = {
+      ref_product: options.product,
+      ref_type: options.type,
+      ref_style: options.style,
+    }
+
+    // Add optional parameters
+    if (options.plan) {
+      params.ref_plan = options.plan
+    }
+
+    // Validate parameters against schema
+    const validation = validateCTAParams(params)
+    if (!validation.isValid) {
+      // Output validation errors to stderr and exit with error code
+      validation.errors.forEach((error) => {
+        console.error(`Validation error: ${error}`)
+      })
+      process.exit(1)
+    }
+
+    // Build and output the URL (stdout only)
+    const ctaUrl = buildCTAUrl(baseUrl, params)
+    console.log(ctaUrl)
+  } catch (error) {
+    console.error(`Build failed: ${error}`)
+    process.exit(1)
+  }
+}