clerk-upgrade-migration

Skill do zarządzania uaktualnieniami SDK Clerk i migracją między wersjami. Pomaga w sprawdzeniu dostępnych aktualizacji, przeanalizowaniu zmian niezgodnych z poprzednimi wersjami (breaking changes) oraz bezpiecznym przeprowadzeniu procesu aktualizacji. Obejmuje obsługę deprecation warnings, procedury rollbacku i typowe wzorce migracji dla projektów Next.js, React i Express. Idealny dla deweloperów utrzymujących aplikacje z integracją Clerk.

1. Sprawdź aktualnie zainstalowane wersje pakietów Clerk poleceniem npm list @clerk/nextjs @clerk/clerk-react @clerk/express, aby zobaczyć, które pakiety są w użyciu i jakie mają wersje.

2. Wyświetl dostępne aktualizacje za pomocą npm outdated | grep clerk, aby dowiedzieć się, które wersje są nowsze, oraz npm view @clerk/nextjs version, aby sprawdzić najnowszą dostępną wersję.

3. Zapoznaj się z breaking changes dla docelowej wersji, odwiedzając changelog na clerk.com/changelog oraz GitHub releases na github.com/clerk/javascript/releases, aby zidentyfikować wymagane zmiany w kodzie.

4. Utwórz nową gałąź git poleceniem git checkout -b chore/upgrade-clerk, aby izolować zmiany związane z aktualizacją.

5. Zainstaluj nowe wersje pakietów poleceniem npm install @clerk/nextjs@latest @clerk/themes@latest (lub odpowiadające pakiety dla twojego stosu technologicznego), pamiętając że wszystkie pakiety Clerk muszą mieć zgodne numery wersji.

6. Zaktualizuj kod aplikacji zgodnie z identified breaking changes, na przykład dodając await do auth(), zmieniając authMiddleware na clerkMiddleware, lub aktualizując ścieżki importu na @clerk/nextjs/server, a następnie przetestuj zmiany w środowisku testowym przed wdrożeniem na produkcję.