deepgram-upgrade-migration

# Deepgram Upgrade Migration ## Current State !`npm list @deepgram/sdk 2>/dev/null | grep deepgram || echo 'SDK not installed'` ## Overview Guide for Deepgram SDK version upgrades (v3 -> v4 -> v5) and model migrations (Nova-2 -> Nova-3). Includes breaking change maps, side-by-side API comparison, A/B testing scripts, automated validation, and rollback procedures. ## SDK Version History | Version | Client Init | STT API | Live API | TTS API | Status | |---------|------------|---------|----------|---------|--------| | v3.x | `createClient(key)` | `listen.prerecorded.transcribeUrl()` | `listen.live()` | `speak.request()` | Stable | | v4.x | `createClient(key)` | `listen.prerecorded.transcribeUrl()` | `listen.live()` | `speak.request()` | Stable | | v5.x | `new DeepgramClient({apiKey})` | `listen.v1.media.transcribeUrl()` | `listen.v1.connect()` | `speak.v1.audio.generate()` | Beta | ## Instructions ### Step 1: Identify Current Version and Breaking Changes ```bash # Check installed version npm list @deepgram/sdk # Check latest available npm view @deepgram/sdk versions --json | tail -5 ``` ### Step 2: v3/v4 to v5 Migration Map ```typescript // ============= CLIENT CREATION ============= // v3/v4: import { createClient } from '@deepgram/sdk'; const dg = createClient(process.env.DEEPGRAM_API_KEY!); // v5: import { DeepgramClient } from '@deepgram/sdk'; const dg = new DeepgramClient({ apiKey: process.env.DEEPGRAM_API_KEY }); // ============= PRE-RECORDED STT =============...