supabase-upgrade-migration

# Supabase Upgrade Migration ## Overview Upgrade `@supabase/supabase-js` and the Supabase CLI with breaking-change detection, automated code migration, and rollback planning. Covers the v1-to-v2 migration path (auth method renames, `data`/`error` destructuring, realtime API overhaul), minor version bumps, `@supabase/ssr` adoption, and Python SDK upgrades via `pip install --upgrade supabase`. ## Current State !`npm list @supabase/supabase-js 2>/dev/null | grep supabase || echo 'supabase-js not installed'` !`supabase --version 2>/dev/null || echo 'CLI not installed'` !`pip show supabase 2>/dev/null | grep Version || echo 'Python SDK not installed'` ## Prerequisites - `@supabase/supabase-js` or the Python `supabase` package installed in the project - Git with a clean working tree (no uncommitted changes) - Test suite available for post-upgrade verification - Node.js >= 18 (for supabase-js v2) or Python >= 3.8 (for Python SDK) ## Instructions ### Step 1: Audit Versions, Scan Usage, and Review Breaking Changes Check every installed Supabase package and find all import sites in the codebase. ```bash # Check current SDK version npm list @supabase/supabase-js # Check CLI version supabase --version # Check Python SDK version pip show supabase | grep Version # Find all JS/TS Supabase imports grep -rn "from '@supabase/supabase-js'" --include="*.ts" --include="*.tsx" --include="*.js" src/ lib/ app/ 2>/dev/null grep -rn "createClient" --include="*.ts" --include="*.tsx" --incl...