feat(onboarding): track setup copy actions

src/components/dashboard/AppOnboardingFlow.vue

@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import type { Database } from '~/types/supabase.types'
 import type {
+  OnboardingActionEvent,
   OnboardingDetailsEvent,
   OnboardingDetailsEventProperties,
   OnboardingIntent,
@@ -980,9 +981,11 @@ async function seedDemoData() {
   }
 }
 
-async function copyText(text: string) {
+async function copyText(text: string, event?: OnboardingActionEvent) {
   try {
     await navigator.clipboard.writeText(text)
+    if (event)
+      progressTracker?.trackActionEvent(event)
     toast.success(t('copied-to-clipboard'))
   }
   catch (error) {
@@ -1005,10 +1008,11 @@ async function copyCliCommand() {
   if (!apiKey.value)
     return
 
-  await copyText(cliCommand.value)
+  await copyText(cliCommand.value, 'onboarding_cli_init_command_copied')
 }
 
 async function copyAiInstructions() {
+  progressTracker?.trackActionEvent('onboarding_ai_instructions_copy_clicked')
   try {
     await loadApiKey()
   }
@@ -1025,13 +1029,13 @@ async function copyAiInstructions() {
       {
         text: t('app-onboarding-ai-help-copy-without-key'),
         role: 'secondary',
-        handler: () => copyText(createAiHelpPrompt(redactedCliCommand.value)),
+        handler: () => copyText(createAiHelpPrompt(redactedCliCommand.value), 'onboarding_ai_instructions_copied_without_api_key'),
       },
       {
         text: t('app-onboarding-ai-help-copy-with-key'),
         role: 'primary',
         disabled: !apiKey.value,
-        handler: () => copyText(createAiHelpPrompt(cliCommand.value)),
+        handler: () => copyText(createAiHelpPrompt(cliCommand.value), 'onboarding_ai_instructions_copied_with_api_key'),
       },
     ],
   })

src/utils/onboardingProgressAnalytics.ts

@@ -5,6 +5,11 @@ export const ONBOARDING_ANALYTICS_VERSION = 2
 export type OnboardingAnalyticsFlow = 'pre_org' | 'existing_org'
 export type OnboardingAnalyticsStep = 'intent' | 'details' | 'organization' | 'choice' | 'install' | 'setup'
 export type OnboardingIntent = 'ota' | 'builder' | 'both' | 'exploring'
+export type OnboardingActionEvent
+  = | 'onboarding_ai_instructions_copy_clicked'
+    | 'onboarding_ai_instructions_copied_with_api_key'
+    | 'onboarding_ai_instructions_copied_without_api_key'
+    | 'onboarding_cli_init_command_copied'
 export type OnboardingDetailsEvent
   = | 'onboarding_app_id_entered'
     | 'onboarding_app_id_help_opened'
@@ -172,8 +177,18 @@ export function createOnboardingProgressTracker(options: CreateOnboardingProgres
     safelyCapture(name, { ...properties, ...details })
   }
 
+  function trackActionEvent(name: OnboardingActionEvent) {
+    if (!activeStep)
+      return
+
+    const properties = sharedProperties(activeStep)
+    if (properties)
+      safelyCapture(name, properties)
+  }
+
   return {
     completeStep,
+    trackActionEvent,
     trackDetailsEvent,
     viewStep,
   }

tests/app-onboarding-progress-integration.unit.test.ts

@@ -38,6 +38,20 @@ describe('app onboarding progress analytics integration', () => {
     expect(onboardingSource).toContain("pushEvent('onboarding_intent_selected', config.supaHost, {")
   })
 
+  it.concurrent('tracks AI instruction and CLI copy actions', () => {
+    const copyActions = sourceBetween('async function copyText(', 'function goToInstallStep()')
+    const clipboardWriteIndex = copyActions.indexOf('await navigator.clipboard.writeText(text)')
+    const actionTrackIndex = copyActions.indexOf('progressTracker?.trackActionEvent(event)')
+    const catchIndex = copyActions.indexOf('catch (error)')
+    expect(copyActions).toContain("trackActionEvent('onboarding_ai_instructions_copy_clicked')")
+    expect(copyActions).toContain("'onboarding_ai_instructions_copied_with_api_key'")
+    expect(copyActions).toContain("'onboarding_ai_instructions_copied_without_api_key'")
+    expect(copyActions).toContain("'onboarding_cli_init_command_copied'")
+    expect(clipboardWriteIndex).toBeGreaterThanOrEqual(0)
+    expect(actionTrackIndex).toBeGreaterThan(clipboardWriteIndex)
+    expect(actionTrackIndex).toBeLessThan(catchIndex)
+  })
+
   it.concurrent('keeps the unload warning scoped to unfinished pre-org onboarding', () => {
     expect(onboardingSource).toContain('useBeforeUnloadWarning(Boolean(props.preOrg))')
     const creation = sourceBetween('async function createOrganizationAndApp()', 'async function createAppRecord(')

tests/onboarding-progress-analytics.unit.test.ts

@@ -137,6 +137,32 @@ describe('onboarding progress analytics', () => {
     )
   })
 
+  it.concurrent('associates copy actions with the active onboarding step', () => {
+    const capture = vi.fn()
+    const tracker = createOnboardingProgressTracker({
+      capture,
+      flow: 'existing_org',
+      resumed: true,
+      steps: ['details', 'choice', 'install'],
+      supaHost: 'https://supabase.capgo.test',
+    })
+
+    tracker.viewStep('install')
+    tracker.trackActionEvent('onboarding_cli_init_command_copied')
+
+    expect(capture).toHaveBeenLastCalledWith(
+      'onboarding_cli_init_command_copied',
+      'https://supabase.capgo.test',
+      expect.objectContaining({
+        flow: 'existing_org',
+        onboarding_attempt_id: expect.any(String),
+        onboarding_version: 2,
+        resumed: true,
+        step: 'install',
+      }),
+    )
+  })
+
   it.concurrent('deduplicates completion for one visit and resets timing after back navigation', () => {
     let now = 10
     const capture = vi.fn()