speak-upgrade-migration

# Speak Upgrade & Migration ## Overview Upgrade Speak SDK versions, migrate between language learning platforms, and handle API version changes. ## Prerequisites - Completed `speak-install-auth` setup - Valid API credentials configured - Understanding of Speak API patterns ## Instructions ## Current State !`npm list @speak/language-sdk 2>/dev/null || echo 'Speak SDK not installed'` ### Step 1: Check Current Version ```bash npm list @speak/language-sdk npm outdated @speak/language-sdk ``` ### Step 2: Upgrade SDK ```bash npm install @speak/language-sdk@latest npm test # Run tests to verify compatibility ``` ### Step 3: API Version Migration ```typescript // Check for deprecated endpoints const DEPRECATED_ENDPOINTS = [ '/v1/lessons/start', // Replaced by /v1/conversations/start '/v1/speech/score', // Replaced by /v1/pronunciation/assess ]; // Migration map const ENDPOINT_MIGRATION = { '/v1/lessons/start': '/v1/conversations/start', '/v1/speech/score': '/v1/pronunciation/assess', }; ``` ### Step 4: Platform Migration (from Duolingo/Babbel APIs) ```typescript // Map learning data between platforms interface MigrationMapper { mapProficiencyLevel(source: string): 'beginner' | 'intermediate' | 'advanced'; mapLanguageCode(source: string): string; mapProgress(source: any): SpeakProgress; } const duolingoMapper: MigrationMapper = { mapProficiencyLevel(crowns: string) { const c = parseInt(crowns); if (c < 3) return 'beginner'; if (c < 6) ...