[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M796J8D99X28YKXPRAPP11V4":3,"skill-same:01M796J8D99X28YKXPRAPP11V4":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":35,"commitSha":36,"skillDirectory":37,"forksCount":38,"repositoryHtmlUrl":39,"repositoryHomepageUrl":6,"ownerHtmlUrl":40,"ownerBlogUrl":41,"ownerDescription":42,"updatedAt":43,"install":44,"resources":57},"01M796J8D99X28YKXPRAPP11V4","supabase-upgrade-migration",null,"Upgrade Supabase SDK and CLI versions with breaking-change detection and automated code migration.\nUse when upgrading @supabase\u002Fsupabase-js (v1→v2 or minor bumps), migrating auth\u002Frealtime\u002Fstorage\nAPIs, or updating the Supabase CLI. Trigger with phrases like \"upgrade supabase\",\n\"supabase breaking changes\", \"migrate supabase v2\", \"update supabase SDK\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--supabase-pack--supabase-upgrade-migration\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: supabase-upgrade-migration\ndescription: |\n  Upgrade Supabase SDK and CLI versions with breaking-change detection and automated code migration.\n  Use when upgrading @supabase\u002Fsupabase-js (v1→v2 or minor bumps), migrating auth\u002Frealtime\u002Fstorage\n  APIs, or updating the Supabase CLI. Trigger with phrases like \"upgrade supabase\",\n  \"supabase breaking changes\", \"migrate supabase v2\", \"update supabase SDK\".\nallowed-tools: Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(pip:*), Bash(supabase:*), Bash(git:*), Grep, Glob\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ncompatible-with: claude-code, codex, openclaw\ntags: [saas, supabase, migration, upgrade, sdk]\n---\n\n# Supabase Upgrade Migration\n\n## Overview\n\nUpgrade `@supabase\u002Fsupabase-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`\u002F`error` destructuring, realtime API overhaul), minor version bumps, `@supabase\u002Fssr` adoption, and Python SDK upgrades via `pip install --upgrade supabase`.\n\n## Current State\n\n!`npm list @supabase\u002Fsupabase-js 2>\u002Fdev\u002Fnull | grep supabase || echo 'supabase-js not installed'`\n!`supabase --version 2>\u002Fdev\u002Fnull || echo 'CLI not installed'`\n!`pip show supabase 2>\u002Fdev\u002Fnull | grep Version || echo 'Python SDK not installed'`\n\n## Prerequisites\n\n- `@supabase\u002Fsupabase-js` or the Python `supabase` package installed in the project\n- Git with a clean working tree (no uncommitted changes)\n- Test suite available for post-upgrade verification\n- Node.js >= 18 (for supabase-js v2) or Python >= 3.8 (for Python SDK)\n\n## Instructions\n\n### Step 1: Audit Versions, Scan Usage, and Review Breaking Changes\n\nCheck every installed Supabase package and find all import sites in the codebase.\n\n```bash\n# Check current SDK version\nnpm list @supabase\u002Fsupabase-js\n\n# Check CLI version\nsupabase --version\n\n# Check Python SDK version\npip show supabase | grep Version\n\n# Find all JS\u002FTS Supabase imports\ngrep -rn \"from '@supabase\u002Fsupabase-js'\" --include=\"*.ts\" --include=\"*.tsx\" --include=\"*.js\" src\u002F lib\u002F app\u002F 2>\u002Fdev\u002Fnull\ngrep -rn \"createClient\" --include=\"*.ts\" --include=\"*.tsx\" --include=\"*.js\" src\u002F lib\u002F app\u002F 2>\u002Fdev\u002Fnull\n\n# Find all Python Supabase imports\ngrep -rn \"from supabase\" --include=\"*.py\" src\u002F app\u002F 2>\u002Fdev\u002Fnull\n```\n\n**supabase-js v1 → v2 breaking changes:**\n\n| v1 Pattern | v2 Replacement | Notes |\n|-----------|---------------|-------|\n| `createClient(url, key)` | `createClient(url, key)` | Signature unchanged, but return type differs |\n| `supabase.auth.session()` | `supabase.auth.getSession()` | Sync → async, returns `{ data: { session } }` |\n| `supabase.auth.user()` | `supabase.auth.getUser()` | Sync → async, returns `{ data: { user } }` |\n| `supabase.auth.signIn({ email, password })` | `supabase.auth.signInWithPassword({ email, password })` | Method split by auth type |\n| `supabase.auth.signIn({ provider: 'google' })` | `supabase.auth.signInWithOAuth({ provider: 'google' })` | OAuth separated |\n| `supabase.auth.signIn({ email })` | `supabase.auth.signInWithOtp({ email })` | Magic link separated |\n| `supabase.auth.api.resetPasswordForEmail(e)` | `supabase.auth.resetPasswordForEmail(e)` | `.api` namespace removed |\n| `{ data: subscription }` from `onAuthStateChange` | `{ data: { subscription } }` | Extra destructuring level |\n| `error.message` string parsing | `error.code` enum (`PGRST116`, etc.) | Reliable error matching |\n| `.single()` returns error on 0 rows | `.maybeSingle()` for optional rows | New method for nullable results |\n| `supabase.from('t').on('INSERT', cb).subscribe()` | `supabase.channel('c').on('postgres_changes', ...).subscribe()` | Realtime v2 channel API |\n| `supabase.storage.from('b').download('path')` | Same, but returns `{ data: Blob, error }` | Consistent error\u002Fdata tuple |\n\n**Realtime v2 migration detail:**\n\n```typescript\n\u002F\u002F v1 realtime\nsupabase\n  .from('messages')\n  .on('INSERT', (payload) => console.log(payload.new))\n  .subscribe()\n\n\u002F\u002F v2 realtime — channel-based API\nsupabase\n  .channel('messages-insert')\n  .on('postgres_changes', { event: 'INSERT', schema: 'public', table: 'messages' },\n    (payload) => console.log(payload.new))\n  .subscribe()\n```\n\n### Step 2: Run the Upgrade and Apply Code Migrations\n\nCreate a branch, install new packages, and transform code to match v2 APIs.\n\n```bash\n# Create upgrade branch\ngit checkout -b upgrade-supabase-sdk\n\n# Upgrade JS\u002FTS SDK\nnpm install @supabase\u002Fsupabase-js@latest\n\n# Upgrade SSR helper (if used with Next.js\u002FSvelteKit\u002FNuxt)\nnpm install @supabase\u002Fssr@latest\n\n# Upgrade CLI\nnpm install -g supabase@latest\n\n# Upgrade Python SDK\npip install --upgrade supabase\n\n# Regenerate TypeScript types from linked project\nnpx supabase gen types typescript --linked > lib\u002Fdatabase.types.ts\n\n# Generate a database migration if schema drifted\nnpx supabase db diff --use-migra -f upgrade_check\n```\n\nApply auth code migrations:\n\n```typescript\n\u002F\u002F BEFORE (v1 auth patterns)\nconst session = supabase.auth.session()\nconst user = supabase.auth.user()\nconst { error } = await supabase.auth.signIn({ email, password })\nconst { data: subscription } = supabase.auth.onAuthStateChange(callback)\n\n\u002F\u002F AFTER (v2 auth patterns)\nconst { data: { session } } = await supabase.auth.getSession()\nconst { data: { user } } = await supabase.auth.getUser()\nconst { error } = await supabase.auth.signInWithPassword({ email, password })\nconst { data: { subscription } } = supabase.auth.onAuthStateChange(callback)\n```\n\nApply error handling migration:\n\n```typescript\n\u002F\u002F BEFORE (v1 — string matching)\nif (error.message.includes('not found')) { ... }\n\n\u002F\u002F AFTER (v2 — structured error codes)\nif (error.code === 'PGRST116') { ... }  \u002F\u002F \"not found\" → PGRST116\n```\n\n### Step 3: Verify, Test, and Prepare Rollback\n\n```bash\n# Type check (catches 90% of migration issues)\nnpx tsc --noEmit\n\n# Run test suite\nnpm test\n\n# Python tests\npython -m pytest tests\u002F -v\n\n# Manual smoke test critical auth flows:\n# 1. Sign up → confirm email → sign in with password\n# 2. OAuth sign in → callback handling\n# 3. Password reset → email → reset form\n# 4. Session refresh across page navigations\n# 5. Realtime subscription connect\u002Fdisconnect\n# 6. Storage upload\u002Fdownload round-trip\n```\n\n**Rollback procedure** (if upgrade causes issues):\n\n```bash\n# Option A: Pin to previous version\nnpm install @supabase\u002Fsupabase-js@\u003Cprevious-version>\npip install supabase==\u003Cprevious-version>\n\n# Option B: Revert the branch\ngit stash && git checkout main\n```\n\n## Output\n\n- `@supabase\u002Fsupabase-js` upgraded to latest version with `npm list` confirmation\n- All `supabase.auth.signIn()` calls migrated to `signInWithPassword` \u002F `signInWithOAuth` \u002F `signInWithOtp`\n- Sync auth methods (`session()`, `user()`) replaced with async `getSession()` \u002F `getUser()`\n- Realtime subscriptions migrated from `.on()` to channel-based API\n- `data`\u002F`error` destructuring updated where return shapes changed\n- TypeScript types regenerated from current schema\n- Test suite passing, type checking clean\n- Rollback branch or version pin documented\n\n## Error Handling\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| `Property 'session' does not exist` | v1 sync `.session()` removed in v2 | Replace with `await supabase.auth.getSession()` |\n| `Property 'signIn' does not exist` | `signIn` split into multiple methods in v2 | Use `signInWithPassword`, `signInWithOAuth`, or `signInWithOtp` |\n| `supabase.auth.api` is undefined | `.api` namespace removed in v2 | Call methods directly on `supabase.auth.*` |\n| `TypeError: supabase.from(...).on is not a function` | Realtime API replaced in v2 | Use `supabase.channel().on('postgres_changes', ...)` |\n| Type errors after `gen types` | Database schema changed between versions | Update application code to match new generated types |\n| `PGRST116` error on `.single()` | Zero rows returned (v2 throws) | Use `.maybeSingle()` for optional lookups |\n| `ERR_REQUIRE_ESM` after upgrade | v2 is ESM-only in some bundlers | Update `tsconfig.json` to `\"module\": \"esnext\"` or use dynamic `import()` |\n| `AuthSessionMissingError` | `getSession()` called before auth initialized | Wrap in `onAuthStateChange` listener or check `session !== null` |\n\n## Examples\n\n**Full v1 → v2 auth migration (Next.js):**\n\n```typescript\n\u002F\u002F lib\u002Fsupabase.ts — client initialization (unchanged API)\nimport { createClient } from '@supabase\u002Fsupabase-js'\nimport type { Database } from '.\u002Fdatabase.types'\n\nexport const supabase = createClient\u003CDatabase>(\n  process.env.NEXT_PUBLIC_SUPABASE_URL!,\n  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!\n)\n```\n\n```typescript\n\u002F\u002F app\u002Flogin\u002Fpage.tsx — v2 auth flow\nexport async function login(email: string, password: string) {\n  const { data, error } = await supabase.auth.signInWithPassword({\n    email,\n    password,\n  })\n  if (error) {\n    \u002F\u002F v2: use error.code instead of parsing error.message\n    if (error.code === 'invalid_credentials') {\n      return { success: false, message: 'Invalid email or password' }\n    }\n    throw error\n  }\n  return { success: true, session: data.session }\n}\n```\n\n```typescript\n\u002F\u002F hooks\u002FuseAuth.ts — v2 session listener\nimport { useEffect, useState } from 'react'\nimport { supabase } from '@\u002Flib\u002Fsupabase'\nimport type { Session } from '@supabase\u002Fsupabase-js'\n\nexport function useAuth() {\n  const [session, setSession] = useState\u003CSession | null>(null)\n\n  useEffect(() => {\n    \u002F\u002F v2: getSession is async, returns nested { data: { session } }\n    supabase.auth.getSession().then(({ data: { session } }) => {\n      setSession(session)\n    })\n\n    \u002F\u002F v2: subscription nested one level deeper\n    const { data: { subscription } } = supabase.auth.onAuthStateChange(\n      (_event, session) => setSession(session)\n    )\n\n    return () => subscription.unsubscribe()\n  }, [])\n\n  return session\n}\n```\n\n**Python SDK upgrade:**\n\n```python\n# Before (supabase-py \u003C 2.0)\nfrom supabase import create_client\nsupabase = create_client(url, key)\ndata = supabase.table(\"users\").select(\"*\").execute()\nusers = data[\"data\"]\n\n# After (supabase-py >= 2.0)\nfrom supabase import create_client, Client\nsupabase: Client = create_client(url, key)\nresponse = supabase.table(\"users\").select(\"*\").execute()\nusers = response.data  # attribute access, not dict\n```\n\n## Resources\n\n- [supabase-js v2 Migration Guide](https:\u002F\u002Fsupabase.com\u002Fdocs\u002Fguides\u002Fupgrade-to-supabase-js-v2) — official step-by-step\n- [supabase-js Releases](https:\u002F\u002Fgithub.com\u002Fsupabase\u002Fsupabase-js\u002Freleases) — changelog for every version\n- [Supabase CLI Releases](https:\u002F\u002Fgithub.com\u002Fsupabase\u002Fcli\u002Freleases) — CLI changelog\n- [Auth Helpers Migration](https:\u002F\u002Fsupabase.com\u002Fdocs\u002Fguides\u002Fauth\u002Fserver-side\u002Fmigrating-to-ssr-package) — `@supabase\u002Fauth-helpers` → `@supabase\u002Fssr`\n- [Realtime v2 Guide](https:\u002F\u002Fsupabase.com\u002Fdocs\u002Fguides\u002Frealtime) — channel-based API reference\n- [supabase-py Releases](https:\u002F\u002Fgithub.com\u002Fsupabase-community\u002Fsupabase-py\u002Freleases) — Python SDK changelog\n\n## Next Steps\n\nFor CI integration with the upgraded SDK, see `supabase-ci-integration`. For database migration workflows after schema changes, see `supabase-migration-deep-dive`.\n","# Supabase Upgrade Migration\n\n## Overview\n\nUpgrade `@supabase\u002Fsupabase-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`\u002F`error` destructuring, realtime API overhaul), minor version bumps, `@supabase\u002Fssr` adoption, and Python SDK upgrades via `pip install --upgrade supabase`.\n\n## Current State\n\n!`npm list @supabase\u002Fsupabase-js 2>\u002Fdev\u002Fnull | grep supabase || echo 'supabase-js not installed'`\n!`supabase --version 2>\u002Fdev\u002Fnull || echo 'CLI not installed'`\n!`pip show supabase 2>\u002Fdev\u002Fnull | grep Version || echo 'Python SDK not installed'`\n\n## Prerequisites\n\n- `@supabase\u002Fsupabase-js` or the Python `supabase` package installed in the project\n- Git with a clean working tree (no uncommitted changes)\n- Test suite available for post-upgrade verification\n- Node.js >= 18 (for supabase-js v2) or Python >= 3.8 (for Python SDK)\n\n## Instructions\n\n### Step 1: Audit Versions, Scan Usage, and Review Breaking Changes\n\nCheck every installed Supabase package and find all import sites in the codebase.\n\n```bash\n# Check current SDK version\nnpm list @supabase\u002Fsupabase-js\n\n# Check CLI version\nsupabase --version\n\n# Check Python SDK version\npip show supabase | grep Version\n\n# Find all JS\u002FTS Supabase imports\ngrep -rn \"from '@supabase\u002Fsupabase-js'\" --include=\"*.ts\" --include=\"*.tsx\" --include=\"*.js\" src\u002F lib\u002F app\u002F 2>\u002Fdev\u002Fnull\ngrep -rn \"createClient\" --include=\"*.ts\" --include=\"*.tsx\" --include=\"*.js\" src\u002F lib\u002F app\u002F 2>\u002Fdev\u002Fnull\n\n# Find all Python Supabase imports\ngrep -rn \"from supabase\" --include=\"*.py\" src\u002F app\u002F 2>\u002Fdev\u002Fnull\n```\n\n**supabase-js v1 → v2 breaking changes:**\n\n| v1 Pattern | v2 Replacement | Notes |\n|-----------|---------------|-------|\n| `createClient(url, key)` | `createClient(url, key)` | Signature unchanged, but return type differs |\n| `supabase.auth.session()` | `supabase.auth.getSession()` | Sync → async, returns `{ data: { session } }` |\n| `supabase.auth.user()` | `supabase.auth.getUser()` | Sync → async, returns `{ data: { user } }` |\n| `supabase.auth.signIn({ email, password })` | `supabase.auth.signInWithPassword({ email, password })` | Method split by auth type |\n| `supabase.auth.signIn({ provider: 'google' })` | `supabase.auth.signInWithOAuth({ provider: 'google' })` | OAuth separated |\n| `supabase.auth.signIn({ email })` | `supabase.auth.signInWithOtp({ email })` | Magic link separated |\n| `supabase.auth.api.resetPasswordForEmail(e)` | `supabase.auth.resetPasswordForEmail(e)` | `.api` namespace removed |\n| `{ data: subscription }` from `onAuthStateChange` | `{ data: { subscription } }` | Extra destructuring level |\n| `error.message` string parsing | `error.code` enum (`PGRST116`, etc.) | Reliable error matching |\n| `.single()` returns error on 0 rows | `.maybeSingle()` for optional rows | New method for nullable results |\n| `supabase.from('t').on('INSERT', cb).subscribe()` | `supabase.channel('c').on('postgres_changes', ...).subscribe()` | Realtime v2 channel API |\n| `supabase.storage.from('b').download('path')` | Same, but returns `{ data: Blob, error }` | Consistent error\u002Fdata tuple |\n\n**Realtime v2 migration detail:**\n\n```typescript\n\u002F\u002F v1 realtime\nsupabase\n  .from('messages')\n  .on('INSERT', (payload) => console.log(payload.new))\n  .subscribe()\n\n\u002F\u002F v2 realtime — channel-based API\nsupabase\n  .channel('messages-insert')\n  .on('postgres_changes', { event: 'INSERT', schema: 'public', table: 'messages' },\n    (payload) => console.log(payload.new))\n  .subscribe()\n```\n\n### Step 2: Run the Upgrade and Apply Code Migrations\n\nCreate a branch, install new packages, and transform code to match v2 APIs.\n\n```bash\n# Create upgrade branch\ngit checkout -b upgrade-supabase-sdk\n\n# Upgrade JS\u002FTS SDK\nnpm install @supabase\u002Fsupabase-js@latest\n\n# Upgrade SSR helper (if used with Next.js\u002FSvelteKit\u002FNuxt)\nnpm install @supabase\u002Fssr@latest\n\n# Upgrade CLI\nnpm install -g supabase@latest\n\n# Upgrade Python SDK\npip install --upgrade supabase\n\n# Regenerate TypeScript types from linked project\nnpx supabase gen types typescript --linked > lib\u002Fdatabase.types.ts\n\n# Generate a database migration if schema drifted\nnpx supabase db diff --use-migra -f upgrade_check\n```\n\nApply auth code migrations:\n\n```typescript\n\u002F\u002F BEFORE (v1 auth patterns)\nconst session = supabase.auth.session()\nconst user = supabase.auth.user()\nconst { error } = await supabase.auth.signIn({ email, password })\nconst { data: subscription } = supabase.auth.onAuthStateChange(callback)\n\n\u002F\u002F AFTER (v2 auth patterns)\nconst { data: { session } } = await supabase.auth.getSession()\nconst { data: { user } } = await supabase.auth.getUser()\nconst { error } = await supabase.auth.signInWithPassword({ email, password })\nconst { data: { subscription } } = supabase.auth.onAuthStateChange(callback)\n```\n\nApply error handling migration:\n\n```typescript\n\u002F\u002F BEFORE (v1 — string matching)\nif (error.message.includes('not found')) { ... }\n\n\u002F\u002F AFTER (v2 — structured error codes)\nif (error.code === 'PGRST116') { ... }  \u002F\u002F \"not found\" → PGRST116\n```\n\n### Step 3: Verify, Test, and Prepare Rollback\n\n```bash\n# Type check (catches 90% of migration issues)\nnpx tsc --noEmit\n\n# Run test suite\nnpm test\n\n# Python tests\npython -m pytest tests\u002F -v\n\n# Manual smoke test critical auth flows:\n# 1. Sign up → confirm email → sign in with password\n# 2. OAuth sign in → callback handling\n# 3. Password reset → email → reset form\n# 4. Session refresh across page navigations\n# 5. Realtime subscription connect\u002Fdisconnect\n# 6. Storage upload\u002Fdownload round-trip\n```\n\n**Rollback procedure** (if upgrade causes issues):\n\n```bash\n# Option A: Pin to previous version\nnpm install @supabase\u002Fsupabase-js@\u003Cprevious-version>\npip install supabase==\u003Cprevious-version>\n\n# Option B: Revert the branch\ngit stash && git checkout main\n```\n\n## Output\n\n- `@supabase\u002Fsupabase-js` upgraded to latest version with `npm list` confirmation\n- All `supabase.auth.signIn()` calls migrated to `signInWithPassword` \u002F `signInWithOAuth` \u002F `signInWithOtp`\n- Sync auth methods (`session()`, `user()`) replaced with async `getSession()` \u002F `getUser()`\n- Realtime subscriptions migrated from `.on()` to channel-based API\n- `data`\u002F`error` destructuring updated where return shapes changed\n- TypeScript types regenerated from current schema\n- Test suite passing, type checking clean\n- Rollback branch or version pin documented\n\n## Error Handling\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| `Property 'session' does not exist` | v1 sync `.session()` removed in v2 | Replace with `await supabase.auth.getSession()` |\n| `Property 'signIn' does not exist` | `signIn` split into multiple methods in v2 | Use `signInWithPassword`, `signInWithOAuth`, or `signInWithOtp` |\n| `supabase.auth.api` is undefined | `.api` namespace removed in v2 | Call methods directly on `supabase.auth.*` |\n| `TypeError: supabase.from(...).on is not a function` | Realtime API replaced in v2 | Use `supabase.channel().on('postgres_changes', ...)` |\n| Type errors after `gen types` | Database schema changed between versions | Update application code to match new generated types |\n| `PGRST116` error on `.single()` | Zero rows returned (v2 throws) | Use `.maybeSingle()` for optional lookups |\n| `ERR_REQUIRE_ESM` after upgrade | v2 is ESM-only in some bundlers | Update `tsconfig.json` to `\"module\": \"esnext\"` or use dynamic `import()` |\n| `AuthSessionMissingError` | `getSession()` called before auth initialized | Wrap in `onAuthStateChange` listener or check `session !== null` |\n\n## Examples\n\n**Full v1 → v2 auth migration (Next.js):**\n\n```typescript\n\u002F\u002F lib\u002Fsupabase.ts — client initialization (unchanged API)\nimport { createClient } from '@supabase\u002Fsupabase-js'\nimport type { Database } from '.\u002Fdatabase.types'\n\nexport const supabase = createClient\u003CDatabase>(\n  process.env.NEXT_PUBLIC_SUPABASE_URL!,\n  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!\n)\n```\n\n```typescript\n\u002F\u002F app\u002Flogin\u002Fpage.tsx — v2 auth flow\nexport async function login(email: string, password: string) {\n  const { data, error } = await supabase.auth.signInWithPassword({\n    email,\n    password,\n  })\n  if (error) {\n    \u002F\u002F v2: use error.code instead of parsing error.message\n    if (error.code === 'invalid_credentials') {\n      return { success: false, message: 'Invalid email or password' }\n    }\n    throw error\n  }\n  return { success: true, session: data.session }\n}\n```\n\n```typescript\n\u002F\u002F hooks\u002FuseAuth.ts — v2 session listener\nimport { useEffect, useState } from 'react'\nimport { supabase } from '@\u002Flib\u002Fsupabase'\nimport type { Session } from '@supabase\u002Fsupabase-js'\n\nexport function useAuth() {\n  const [session, setSession] = useState\u003CSession | null>(null)\n\n  useEffect(() => {\n    \u002F\u002F v2: getSession is async, returns nested { data: { session } }\n    supabase.auth.getSession().then(({ data: { session } }) => {\n      setSession(session)\n    })\n\n    \u002F\u002F v2: subscription nested one level deeper\n    const { data: { subscription } } = supabase.auth.onAuthStateChange(\n      (_event, session) => setSession(session)\n    )\n\n    return () => subscription.unsubscribe()\n  }, [])\n\n  return session\n}\n```\n\n**Python SDK upgrade:**\n\n```python\n# Before (supabase-py \u003C 2.0)\nfrom supabase import create_client\nsupabase = create_client(url, key)\ndata = supabase.table(\"users\").select(\"*\").execute()\nusers = data[\"data\"]\n\n# After (supabase-py >= 2.0)\nfrom supabase import create_client, Client\nsupabase: Client = create_client(url, key)\nresponse = supabase.table(\"users\").select(\"*\").execute()\nusers = response.data  # attribute access, not dict\n```\n\n## Resources\n\n- [supabase-js v2 Migration Guide](https:\u002F\u002Fsupabase.com\u002Fdocs\u002Fguides\u002Fupgrade-to-supabase-js-v2) — official step-by-step\n- [supabase-js Releases](https:\u002F\u002Fgithub.com\u002Fsupabase\u002Fsupabase-js\u002Freleases) — changelog for every version\n- [Supabase CLI Releases](https:\u002F\u002Fgithub.com\u002Fsupabase\u002Fcli\u002Freleases) — CLI changelog\n- [Auth Helpers Migration](https:\u002F\u002Fsupabase.com\u002Fdocs\u002Fguides\u002Fauth\u002Fserver-side\u002Fmigrating-to-ssr-package) — `@supabase\u002Fauth-helpers` → `@supabase\u002Fssr`\n- [Realtime v2 Guide](https:\u002F\u002Fsupabase.com\u002Fdocs\u002Fguides\u002Frealtime) — channel-based API reference\n- [supabase-py Releases](https:\u002F\u002Fgithub.com\u002Fsupabase-community\u002Fsupabase-py\u002Freleases) — Python SDK changelog\n\n## Next Steps\n\nFor CI integration with the upgraded SDK, see `supabase-ci-integration`. For database migration workflows after schema changes, see `supabase-migration-deep-dive`.\n",{"name":5,"tags":24,"author":30,"license":15,"version":31,"description":32,"allowed-tools":33,"compatible-with":34},[25,26,27,28,29],"saas","supabase","migration","upgrade","sdk","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Upgrade Supabase SDK and CLI versions with breaking-change detection and automated code migration.\nUse when upgrading @supabase\u002Fsupabase-js (v1→v2 or minor bumps), migrating auth\u002Frealtime\u002Fstorage\nAPIs, or updating the Supabase CLI. Trigger with phrases like \"upgrade supabase\",\n\"supabase breaking changes\", \"migrate supabase v2\", \"update supabase SDK\".\n","Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(pip:*), Bash(supabase:*), Bash(git:*), Grep, Glob","claude-code, codex, openclaw","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--supabase-pack--supabase-upgrade-migration",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":45,"prompt":55,"zipAvailable":56},[46,49,52],{"tool":47,"command":48},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill supabase-upgrade-migration",{"tool":50,"command":51},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill supabase-upgrade-migration",{"tool":53,"command":54},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill supabase-upgrade-migration","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--supabase-pack--supabase-upgrade-migration\u002FSKILL.md",true,[],[59,66,73,80,87,95],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]