clerk-upgrade-migration

Upgrade Clerk SDK versions and handle breaking changes.\nUse when upgrading Clerk packages, migrating to new SDK versions,\nor handling deprecation warnings.\nTrigger with phrases like \

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ę.