elevenlabs-upgrade-migration

# ElevenLabs Upgrade & Migration ## Overview Guide for upgrading the ElevenLabs SDK and migrating between model generations. Covers the JS SDK package rename, model ID changes, and API endpoint evolution. ## Prerequisites - Current ElevenLabs SDK installed - Git for version control - Test suite available - Staging environment for validation ## Instructions ### Step 1: Check Current Versions ```bash # Node.js SDK npm list @elevenlabs/elevenlabs-js 2>/dev/null || npm list elevenlabs 2>/dev/null npm view @elevenlabs/elevenlabs-js version # Python SDK pip show elevenlabs | grep -E "^(Name|Version)" # Check what models your account has access to curl -s https://api.elevenlabs.io/v1/models \ -H "xi-api-key: ${ELEVENLABS_API_KEY}" | \ jq '[.[] | {model_id, name}]' ``` ### Step 2: JS SDK Package Migration The official Node.js package changed names: | Era | Package | Import | |-----|---------|--------| | Legacy | `elevenlabs` (community) | `import ElevenLabs from "elevenlabs"` | | Current | `@elevenlabs/elevenlabs-js` | `import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"` | **Migration steps:** ```bash # Remove old package npm uninstall elevenlabs # Install current official SDK npm install @elevenlabs/elevenlabs-js # Create upgrade branch git checkout -b upgrade/elevenlabs-sdk ``` **Update imports:** ```typescript // BEFORE (legacy community package) import ElevenLabs from "elevenlabs"; const client = new ElevenLabs({ apiKey: "..." }); // AFTER (official...