feat: add custom_msg websocket type with QR download links

package.json

@@ -95,6 +95,7 @@
     "@types/node": "^25.0.0",
     "@types/node-forge": "^1.3.14",
     "@types/prettyjson": "^0.0.33",
+    "@types/qrcode": "^1.5.6",
     "@types/react": "^18.3.28",
     "@types/tmp": "^0.2.6",
     "@vercel/ncc": "^0.38.4",
@@ -121,6 +122,7 @@
     "ink-spinner": "^5.0.0",
     "jsonwebtoken": "^9.0.3",
     "node-forge": "^1.3.3",
+    "qrcode": "^1.5.4",
     "react": "^18.3.1"
   }
 }

src/build/onboarding/ui/app.tsx

@@ -1,6 +1,7 @@
 import type { FC } from 'react'
 import type { BuildLogger } from '../../request.js'
 import type { ApiKeyData, CertificateData, OnboardingProgress, OnboardingStep, ProfileData } from '../types.js'
+import { handleCustomMsg } from '../../qr.js'
 import { Buffer } from 'node:buffer'
 import { existsSync } from 'node:fs'
 import { copyFile, readFile } from 'node:fs/promises'
@@ -542,6 +543,14 @@
                 return [...prev, line]
               })
             },
+            customMsg: async (kind: string, data: Record<string, unknown>) => {
+              await handleCustomMsg(
+                kind,
+                data,
+                (line: string) => setBuildOutput(prev => [...prev, line]),
+                (line: string) => setBuildOutput(prev => [...prev, line]),
+              )
+            },
           }
 
           setBuildOutput([`Requesting build for ${appId} (ios)...`])

src/build/qr.ts

@@ -0,0 +1,41 @@
+import QRCode from 'qrcode'
+
+/**
+ * Handle a custom_msg from the websocket stream.
+ * Known kinds get rich rendering; unknown kinds get a warning + raw dump.
+ */
+export async function handleCustomMsg(
+  kind: string,
+  data: Record<string, unknown>,
+  log: (line: string) => void,
+  warn: (line: string) => void,
+): Promise<void> {
+  if (kind === 'qr_download_link') {
+    const url = data.url
+    if (typeof url !== 'string') {
+      warn('qr_download_link message missing url field')
+      return
+    }
+
+    try {
+      const qrText = await QRCode.toString(url, { type: 'utf8', errorCorrectionLevel: 'L' })
+      log('')
+      for (const line of qrText.split('\n')) {
+        log(line)
+      }
+      log(url)
+      log('')
+    }
+    catch {
+      // Fallback: just show the URL if QR generation fails
+      log('')
+      log(url)
+      log('')
+    }
+    return
+  }
+
+  // Unknown kind — warn and dump raw data
+  warn(`Unknown message type "${kind}" — you may need to update the CLI`)
+  log(JSON.stringify(data, null, 2))
+}