@clerk/upgrade 0.1.0 → 0.2.0

package/dist/versions/v5/common/usemagiclink.md

@@ -4,4 +4,4 @@ matcher: 'useMagicLink'
 replaceWithString: 'useEmailLink'
 ---
 
-Across Clerk's documentation and codebases the term "magic link" was changed to "email link" as it more accurately reflects the functionality.
+Across Clerk's documentation and codebases the term "magic link" was changed to "email link" as it more accurately reflects functionality.

package/dist/versions/v5/common/user-getorganizationinvitations-arguments-chanaged.md

@@ -0,0 +1,15 @@
+---
+title: '`User.getOrganizationInvitations` arguments changed'
+matcher: "\\.getOrganizationInvitations\\("
+---
+
+There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
+
+```diff
+  const { data } = await user.getOrganizationInvitations({
+-   limit: 10,
++   pageSize: 10,
+-   offset: 10,
++   initialPage: 2,
+  })
+```

package/dist/versions/v5/common/user-getorganizationmemberships-arguments-chanaged.md

@@ -0,0 +1,15 @@
+---
+title: '`User.getOrganizationMemberships` arguments changed'
+matcher: "\\.getOrganizationMemberships\\("
+---
+
+There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
+
+```diff
+  const { data } = await user.getOrganizationMemberships({
+-   limit: 10,
++   pageSize: 10,
+-   offset: 10,
++   initialPage: 2,
+  })
+```

package/dist/versions/v5/common/user-getorganizationsuggestions-arguments-chanaged.md

@@ -0,0 +1,15 @@
+---
+title: '`User.getOrganizationSuggestions` arguments changed'
+matcher: "\\.getOrganizationSuggestions\\("
+---
+
+There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
+
+```diff
+  const { data } = await user.getOrganizationSuggestions({
+-   limit: 10,
++   pageSize: 10,
+-   offset: 10,
++   initialPage: 2,
+  })
+```

package/dist/versions/v5/common/userprofile-prop.md

@@ -5,4 +5,9 @@ matcherFlags: 'm'
 replaceWithString: 'userProfileProps'
 ---
 
-The `userProfile` prop on [the `UserButton` component](https://clerk.com/docs/references/javascript/clerk/user-button#user-button-component) has been changed to `userProfileProps`. This is purely a name change, none of the values need to be updated
+The `userProfile` prop on [the `UserButton` component](https://clerk.com/docs/references/javascript/clerk/user-button#user-button-component) has been changed to `userProfileProps`. This is purely a name change, none of the values need to be updated.
+
+```diff
+- <UserButton userProfile={} />
++ <UserButton userProfileProps={} />
+```

package/dist/versions/v5/expo/clerkprovider-frontendapi.md

@@ -4,14 +4,11 @@ matcher: "<ClerkProvider[\\s\\S]*?frontendApi=[\\s\\S]*?>"
 matcherFlags: 'm'
 ---
 
-The `frontendApi` prop passed to `ClerkProvider` must be changed to `publishableKey`. The value also must be updated to be a publishable key rather than a frontend API key, [here’s more information on how to do this](TODO)
+The `frontendApi` prop passed to `ClerkProvider` must be changed to `publishableKey`. The value also must be updated to be a publishable key rather than a frontend API key. Publishable keys can be found in your Clerk dashboard.
 
-```js
+```diff
 import { ClerkProvider } from '@clerk/clerk-expo';
 
-// before
-<ClerkProvider frontendApi='...' />
-
-// after
-<ClerkProvider publishableKey='...' />
+- <ClerkProvider frontendApi='...' />
++ <ClerkProvider publishableKey='...' />
 ```

package/dist/versions/v5/fastify/api-url-value-change.md

@@ -1,6 +1,8 @@
 ---
 title: '`API_URL` value has changed'
-matcher: "API_URL.*?from\\s['\"]@clerk\\/fastify\\/constants['\"]"
+matcher: "API_URL[\\s\\S]*?from\\s*['\"]@clerk\\/fastify\\/constants['\"]"
+matcherFlags: 'm'
+warning: true
 ---
 
 The value of this export has changed from `https://api.clerk.dev` to `https://api.clerk.com`. If you were relying on the text content of this value not changing, you may need to make adjustments.

package/dist/versions/v5/fastify/clerk-import-change.md

@@ -0,0 +1,12 @@
+---
+title: '`Clerk` -> `{ createClerkClient }`'
+matcher: "import\\s+{[\\s\\S]*?[,\\s]Clerk[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/fastify[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+---
+
+The `Clerk` default import has changed to `createClerkClient` and been moved to a named import rather than default. You must update your import path in order for it to work correctly. Example below of the fix that needs to be made:
+
+```diff
+- import Clerk from "@clerk/fastify"
++ import { createClerkClient } from "@clerk/fastify"
+```

package/dist/versions/v5/fastify/clerkplugin-frontendapi.md

@@ -6,12 +6,9 @@ matcherFlags: 'm'
 
 The `frontendApi` argument passed to `clerkPlugin` must be changed to `publishableKey`. Note that the values of the two keys are different, so both keys and values need to be changed. You can find your application's publishable key in the Clerk dashboard.
 
-```js
+```diff
 import { clerkPlugin } from '@clerk/fastify';
 
-// before
-fastify.register(clerkPlugin, { frontendApi: '...' });
-
-// after
-fastify.register(clerkPlugin, { publishableKey: '...' });
+- fastify.register(clerkPlugin, { frontendApi: '...' });
++ fastify.register(clerkPlugin, { publishableKey: '...' });
 ```

package/dist/versions/v5/fastify/createclerkclient-apikey.md

@@ -1,17 +1,14 @@
 ---
 title: '`apiKey` -> `secretKey` as param to createClerkClient'
-matcher: "createClerkClient\\({.*?apiKey:.*?}\\)"
+matcher: "createClerkClient\\([\\s\\S]*?apiKey:[\\s\\S]*?\\)"
 matcherFlags: 'm'
 ---
 
 The `apiKey` argument passed to `createClerkClient` must be changed to `secretKey`.
 
-```js
+```diff
 import { createClerkClient } from '@clerk/fastify';
 
-// before
-createClerkClient({ apiKey: '...' });
-
-// after
-createClerkClient({ secretKey: '...' });
+- createClerkClient({ apiKey: '...' });
++ createClerkClient({ secretKey: '...' });
 ```

package/dist/versions/v5/fastify/createclerkclient-frontendapi.md

@@ -1,17 +1,14 @@
 ---
 title: '`frontendApi` -> `publishableKey` as param to createClerkClient'
-matcher: "createClerkClient\\({.*?frontendApi:.*?}\\)"
+matcher: "createClerkClient\\([\\s\\S]*?frontendApi:[\\s\\S]*?\\)"
 matcherFlags: 'm'
 ---
 
 The `frontendApi` argument passed to `createClerkClient` must be changed to `publishableKey`. Note that the values of the two keys are different, so both keys and values need to be changed. You can find your application's publishable key in the Clerk dashboard.
 
-```js
+```diff
 import { createClerkClient } from '@clerk/fastify';
 
-// before
-createClerkClient({ frontendApi: '...' });
-
-// after
-createClerkClient({ publishableKey: '...' });
+- createClerkClient({ frontendApi: '...' });
++ createClerkClient({ publishableKey: '...' });
 ```

package/dist/versions/v5/gatsby/api-url-value-change.md

@@ -1,6 +1,8 @@
 ---
 title: '`API_URL` value has changed'
-matcher: "API_URL.*?from\\s['\"]gatsby-plugin-clerk\\/constants['\"]"
+matcher: "import\\s+{[\\s\\S]*?[,\\s]API_URL[,\\s][\\s\\S]*?from\\s+['\"]gatsby-plugin-clerk\\/constants[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+warning: true
 ---
 
 - The value of this export has changed from `https://api.clerk.dev` to `https://api.clerk.com`. If you were relying on the text content of this value not changing, you may need to make adjustments.

package/dist/versions/v5/gatsby/clerk-import-change.md

@@ -0,0 +1,12 @@
+---
+title: '`Clerk` -> `{ createClerkClient }`'
+matcher: "import\\s+{[\\s\\S]*?[,\\s]Clerk[,\\s][\\s\\S]*?from\\s+['\"]gatsby-plugin-clerk[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+---
+
+The `Clerk` default import has changed to `createClerkClient` and been moved to a named import rather than default. You must update your import path in order for it to work correctly. Example below of the fix that needs to be made:
+
+```diff
+- import Clerk from "gatsby-plugin-clerk"
++ import { createClerkClient } from "gatsby-plugin-clerk"
+```

package/dist/versions/v5/gatsby/createclerkclient-apikey.md

@@ -1,17 +1,14 @@
 ---
 title: '`apiKey` -> `secretKey` as param to createClerkClient'
-matcher: "createClerkClient\\({.*?apiKey:.*?}\\)"
+matcher: "createClerkClient\\([\\s\\S]*?apiKey:[\\s\\S]*?\\)"
 matcherFlags: 'm'
 ---
 
 The `apiKey` argument passed to `createClerkClient` must be changed to `secretKey`.
 
-```js
+```diff
 import { createClerkClient } from 'gatsby-plugin-clerk/api';
 
-// before
-createClerkClient({ apiKey: '...' });
-
-// after
-createClerkClient({ secretKey: '...' });
+- createClerkClient({ apiKey: '...' });
++ createClerkClient({ secretKey: '...' });
 ```

package/dist/versions/v5/gatsby/createclerkclient-frontendapi.md

@@ -1,17 +1,14 @@
 ---
 title: '`frontendApi` -> `publishableKey` as param to createClerkClient'
-matcher: "createClerkClient\\({.*?frontendApi:.*?}\\)"
+matcher: "createClerkClient\\([\\s\\S]*?frontendApi:[\\s\\S]*?\\)"
 matcherFlags: 'm'
 ---
 
 The `frontendApi` argument passed to `createClerkClient` must be changed to `publishableKey`. Note that the values of the two keys are different, so both keys and values need to be changed. You can find your application's publishable key in the Clerk dashboard.
 
-```js
+```diff
 import { createClerkClient } from 'gatsby-plugin-clerk/api';
 
-// before
-createClerkClient({ frontendApi: '...' });
-
-// after
-createClerkClient({ publishableKey: '...' });
+- createClerkClient({ frontendApi: '...' });
++ createClerkClient({ publishableKey: '...' });
 ```

package/dist/versions/v5/index.js

@@ -3,16 +3,16 @@ const load = createLoader({
   version: '5',
   baseUrl: 'https://clerk.com/docs/upgrade-guides/v5'
 });
-const reactChangesList = ['magiclinkerrorcode', 'usemagiclink', 'ismagiclinkerror', 'magiclinkerror', 'handlemagiclinkverification', 'clerkprovider-frontendapi-2', 'setsession', 'navigate-to-routerpush-routerreplace', 'afterswitchorganizationurl', 'appearance-organizationpreview-organizationswitcher', 'useorganization-invitationlist', 'useorganization-membershiplist', 'useorganizations', 'userprofile-prop', 'organizationprofile-settings', 'userprofile-security', 'mfa-dropdown', 'connected-accounts-dropdown', 'userbuttonpopoveractionbuttontext-removed', 'userbuttontrigger-userbuttonbox-invert', 'organizationswitcherpopoveractionbuttontext-removed', 'card-changes', 'alternativemethods-backlink', 'button-to-organizationlistcreateorganizationactionbutton', 'remove-socialbuttonsblockbuttonarrow', 'remove-identitypreview-avatar', 'withsession-removed', 'withclerk-removed', 'withuser-removed-2', 'withclerk-hof-removed', 'withsession-hof-removed', 'withuser-hof-removed', 'multisessionappsupport-import-change', 'clerkprovideroptionswrapper-dropped', 'aftersignouturl-behavior-change', 'aftersigninurl-behavior-change-2', 'aftersignupurl-behavior-change', 'new-localization-keys', 'removed-localization-keys', 'changed-localization-keys', 'signoutcallback-to-redirecturl'];
+const reactChangesList = ['magiclinkerrorcode', 'usemagiclink', 'ismagiclinkerror', 'magiclinkerror', 'handlemagiclinkverification', 'clerkprovider-frontendapi-2', 'setsession', 'navigate-to-routerpush-routerreplace', 'afterswitchorganizationurl', 'appearance-organizationpreview-organizationswitcher', 'useorganization-invitationlist', 'useorganization-membershiplist', 'useorganizations', 'userprofile-prop', 'organizationprofile-settings', 'userprofile-security', 'mfa-dropdown', 'connected-accounts-dropdown', 'userbuttonpopoveractionbuttontext-removed', 'userbuttontrigger-userbuttonbox-invert', 'organizationswitcherpopoveractionbuttontext-removed', 'card-changes', 'alternativemethods-backlink', 'button-to-organizationlistcreateorganizationactionbutton', 'remove-socialbuttonsblockbuttonarrow', 'remove-identitypreview-avatar', 'withsession-removed', 'withclerk-removed', 'withuser-removed-2', 'withclerk-hof-removed', 'withsession-hof-removed', 'withuser-hof-removed', 'multisessionappsupport-import-change', 'clerkprovideroptionswrapper-dropped', 'aftersignouturl-behavior-change', 'aftersigninurl-behavior-change-2', 'aftersignupurl-behavior-change', 'new-localization-keys', 'removed-localization-keys', 'changed-localization-keys', 'signoutcallback-to-redirecturl', 'min-react-version', 'getorganizationlist-return-type-change', 'getorganizationinvitationlist-return-type-change', 'getorganizationmembershiplist-return-type-change', 'organization-getroles-arguments-changed', 'organization-getmemberships-arguments-changed', 'organization-getdomains-arguments-change', 'organization-getinvitations-arguments-changed', 'organization-getmembershiprequests-arguments-changed', 'user-getorganizationinvitations-arguments-chanaged', 'user-getorganizationsuggestions-arguments-chanaged', 'user-getorganizationmemberships-arguments-chanaged'];
 export default {
-  nextjs: load('next', ['api-key-to-secret-key', 'frontend-api-to-publishable-key', 'with-clerk-middleware-removed', 'auth-middleware-deprecated', 'clerk-js-version-next-public', 'authmiddleware-apikey', 'authmiddleware-frontendapi', 'createclerkclient-apikey', 'createclerkclient-frontendapi', 'getauth-apikey', 'clerkprovider-frontendapi-2', 'import-nextjs-app-beta', 'import-nextjs-ssr', 'import-nextjs-edge-middleware', 'import-nextjs-edge-middlewarefiles', 'import-api-url', 'import-api-version', 'import-clerk-js-url', 'import-clerk-js-version', 'import-domain', 'import-is-satellite', 'import-proxy-url', 'import-publishable-key', 'import-secret-key', 'import-sign-in-url', 'import-sign-up-url', 'import-nextjs-api', 'api-url-value-change', 'ismagiclinkerror', 'usemagiclink', 'magiclinkerrorcode', 'setsession', 'organizationprofile-settings', 'userprofile-security', 'mfa-dropdown', 'connected-accounts-dropdown', 'userbuttonpopoveractionbuttontext-removed', 'userbuttontrigger-userbuttonbox-invert', 'organizationswitcherpopoveractionbuttontext-removed', 'card-changes', 'alternativemethods-backlink', 'button-to-organizationlistcreateorganizationactionbutton', 'remove-socialbuttonsblockbuttonarrow', 'remove-identitypreview-avatar', 'multisessionappsupport-import-change', 'auth-import-change', 'currentuser-import-change', 'authmiddleware-import-change', 'buildclerkprops-import-change', 'verifytoken-import-change', 'verifyjwt-import-change', 'decodejwt-import-change', 'signjwt-import-change', 'constants-import-change', 'createauthenticaterequest-import-change', 'createisomorphicrequest-import-change', 'clerk-import-change', 'isclerkapiresponserror-import-change', 'isemaillinkerror-import-change', 'isknownerror-import-change', 'ismetamaskerror-import-change', 'withsession-removed', 'withclerk-removed', 'withuser-removed-2', 'withclerk-hof-removed', 'withsession-hof-removed', 'withuser-hof-removed', 'next-public-clerk-js-url', 'aftersignouturl-behavior-change', 'aftersigninurl-behavior-change-2', 'aftersignupurl-behavior-change', 'new-localization-keys', 'removed-localization-keys', 'changed-localization-keys', 'signoutcallback-to-redirecturl']),
+  nextjs: load('next', ['api-key-to-secret-key', 'frontend-api-to-publishable-key', 'with-clerk-middleware-removed', 'auth-middleware-deprecated', 'clerk-js-version-next-public', 'authmiddleware-apikey', 'authmiddleware-frontendapi', 'createclerkclient-apikey', 'createclerkclient-frontendapi', 'getauth-apikey', 'clerkprovider-frontendapi-2', 'import-nextjs-app-beta', 'import-nextjs-ssr', 'import-nextjs-edge-middleware', 'import-nextjs-edge-middlewarefiles', 'import-api-url', 'import-api-version', 'import-clerk-js-url', 'import-clerk-js-version', 'import-domain', 'import-is-satellite', 'import-proxy-url', 'import-publishable-key', 'import-secret-key', 'import-sign-in-url', 'import-sign-up-url', 'import-nextjs-api', 'api-url-value-change', 'ismagiclinkerror', 'usemagiclink', 'magiclinkerrorcode', 'setsession', 'organizationprofile-settings', 'userprofile-security', 'mfa-dropdown', 'connected-accounts-dropdown', 'userbuttonpopoveractionbuttontext-removed', 'userbuttontrigger-userbuttonbox-invert', 'organizationswitcherpopoveractionbuttontext-removed', 'card-changes', 'alternativemethods-backlink', 'button-to-organizationlistcreateorganizationactionbutton', 'remove-socialbuttonsblockbuttonarrow', 'remove-identitypreview-avatar', 'multisessionappsupport-import-change', 'auth-import-change', 'currentuser-import-change', 'authmiddleware-import-change', 'buildclerkprops-import-change', 'verifytoken-import-change', 'verifyjwt-import-change', 'decodejwt-import-change', 'signjwt-import-change', 'constants-import-change', 'createauthenticaterequest-import-change', 'createisomorphicrequest-import-change', 'clerk-import-change', 'isclerkapiresponserror-import-change', 'isemaillinkerror-import-change', 'isknownerror-import-change', 'ismetamaskerror-import-change', 'withsession-removed', 'withclerk-removed', 'withuser-removed-2', 'withclerk-hof-removed', 'withsession-hof-removed', 'withuser-hof-removed', 'next-public-clerk-js-url', 'aftersignouturl-behavior-change', 'aftersigninurl-behavior-change-2', 'aftersignupurl-behavior-change', 'new-localization-keys', 'removed-localization-keys', 'changed-localization-keys', 'signoutcallback-to-redirecturl', 'min-nextjs-version', 'redirecttosignin-import-path', 'redirecttosignup-import-path', 'getorganizationlist-return-type-change', 'getorganizationinvitationlist-return-type-change', 'getorganizationmembershiplist-return-type-change', 'organization-getroles-arguments-changed', 'organization-getmemberships-arguments-changed', 'organization-getdomains-arguments-change', 'organization-getinvitations-arguments-changed', 'organization-getmembershiprequests-arguments-changed', 'user-getorganizationinvitations-arguments-chanaged', 'user-getorganizationsuggestions-arguments-chanaged', 'user-getorganizationmemberships-arguments-chanaged']),
   // since we export clerk-react at the top level from the gatsby plugin
   // if you're using gatsby, we also need to scan for the react changes
-  gatsby: load('gatsby', dedupeMerge(reactChangesList, ['api-key-to-secret-key', 'createclerkclient-apikey', 'apikey-to-publishable-key', 'createclerkclient-frontendapi', 'ismagiclinkerror', 'usemagiclink', 'magiclinkerrorcode', 'setsession', 'api-url-value-change', 'withserverauth-return-type'])),
-  remix: load('remix', ['clerkerrorboundary-removed', 'createclerkclient-apikey', 'rootauthloader-apikey', 'getauth-apikey', 'clerkprovider-frontendapi-2', 'rootauthloader-frontendapi', 'frontend-api-to-publishable-key', 'api-key-to-secret-key', 'ismagiclinkerror', 'magiclinkerrorcode', 'usemagiclink', 'setsession', 'aftersignouturl-behavior-change', 'aftersigninurl-behavior-change-2', 'aftersignupurl-behavior-change', 'new-localization-keys', 'removed-localization-keys', 'changed-localization-keys', 'signoutcallback-to-redirecturl']),
-  expo: load('expo', ['apikey-to-publishable-key', 'ismagiclinkerror', 'usemagiclink', 'magiclinkerrorcode', 'setsession', 'organizationprofile-settings', 'userprofile-security', 'mfa-dropdown', 'connected-accounts-dropdown', 'userbuttonpopoveractionbuttontext-removed', 'userbuttontrigger-userbuttonbox-invert', 'organizationswitcherpopoveractionbuttontext-removed', 'card-changes', 'alternativemethods-backlink', 'button-to-organizationlistcreateorganizationactionbutton', 'remove-socialbuttonsblockbuttonarrow', 'remove-identitypreview-avatar', 'aftersignouturl-behavior-change', 'aftersigninurl-behavior-change-2', 'aftersignupurl-behavior-change', 'new-localization-keys', 'removed-localization-keys', 'changed-localization-keys', 'signoutcallback-to-redirecturl']),
-  fastify: load('fastify', ['api-key-to-secret-key', 'api-url-value-change', 'frontend-api-to-publishable-key', 'createclerkclient-apikey', 'createclerkclient-frontendapi', 'clerkplugin-frontendapi']),
-  node: load('node', ['package-rename', 'api-key-to-secret-key', 'api-url-value-change', 'frontend-api-to-publishable-key', 'clerkexpressrequireauth-apikey', 'clerkexpresswithauth-apikey', 'createclerkclient-apikey', 'createclerkexpressrequireauth-apikey', 'createclerkexpresswithauth-apikey', 'createclerkclient-frontendapi', 'createclerkexpressrequireauth-frontendapi', 'clerkexpressrequireauth-frontendapi', 'createclerkexpresswithauth-frontendapi', 'clerkexpresswithauth-frontendapi', 'setclerkapikey', 'setclerkapiversion', 'setclerkhttpoptions', 'setclerkserverapiurl', 'cjs-esm-instance', 'legacyauthobject-removed']),
+  gatsby: load('gatsby', dedupeMerge(reactChangesList, ['api-key-to-secret-key', 'createclerkclient-apikey', 'apikey-to-publishable-key', 'createclerkclient-frontendapi', 'ismagiclinkerror', 'usemagiclink', 'magiclinkerrorcode', 'setsession', 'api-url-value-change', 'withserverauth-return-type', 'clerk-import-change'])),
+  remix: load('remix', ['clerkerrorboundary-removed', 'createclerkclient-apikey', 'rootauthloader-apikey', 'getauth-apikey', 'clerkprovider-frontendapi-2', 'rootauthloader-frontendapi', 'frontend-api-to-publishable-key', 'api-key-to-secret-key', 'ismagiclinkerror', 'magiclinkerrorcode', 'usemagiclink', 'setsession', 'aftersignouturl-behavior-change', 'aftersigninurl-behavior-change-2', 'aftersignupurl-behavior-change', 'new-localization-keys', 'removed-localization-keys', 'changed-localization-keys', 'signoutcallback-to-redirecturl', 'clerk-import-change', 'getorganizationlist-return-type-change', 'getorganizationinvitationlist-return-type-change', 'getorganizationmembershiplist-return-type-change', 'organization-getroles-arguments-changed', 'organization-getmemberships-arguments-changed', 'organization-getdomains-arguments-change', 'organization-getinvitations-arguments-changed', 'organization-getmembershiprequests-arguments-changed', 'user-getorganizationinvitations-arguments-chanaged', 'user-getorganizationsuggestions-arguments-chanaged', 'user-getorganizationmemberships-arguments-chanaged']),
+  expo: load('expo', ['apikey-to-publishable-key', 'ismagiclinkerror', 'usemagiclink', 'magiclinkerrorcode', 'setsession', 'organizationprofile-settings', 'userprofile-security', 'mfa-dropdown', 'connected-accounts-dropdown', 'userbuttonpopoveractionbuttontext-removed', 'userbuttontrigger-userbuttonbox-invert', 'organizationswitcherpopoveractionbuttontext-removed', 'card-changes', 'alternativemethods-backlink', 'button-to-organizationlistcreateorganizationactionbutton', 'remove-socialbuttonsblockbuttonarrow', 'remove-identitypreview-avatar', 'aftersignouturl-behavior-change', 'aftersigninurl-behavior-change-2', 'aftersignupurl-behavior-change', 'new-localization-keys', 'removed-localization-keys', 'changed-localization-keys', 'signoutcallback-to-redirecturl', 'getorganizationlist-return-type-change', 'getorganizationinvitationlist-return-type-change', 'getorganizationmembershiplist-return-type-change']),
+  fastify: load('fastify', ['api-key-to-secret-key', 'api-url-value-change', 'frontend-api-to-publishable-key', 'createclerkclient-apikey', 'createclerkclient-frontendapi', 'clerkplugin-frontendapi', 'clerk-import-change']),
+  node: load('node', ['api-key-to-secret-key', 'api-url-value-change', 'frontend-api-to-publishable-key', 'clerkexpressrequireauth-apikey', 'clerkexpresswithauth-apikey', 'createclerkclient-apikey', 'createclerkexpressrequireauth-apikey', 'createclerkexpresswithauth-apikey', 'createclerkclient-frontendapi', 'createclerkexpressrequireauth-frontendapi', 'clerkexpressrequireauth-frontendapi', 'createclerkexpresswithauth-frontendapi', 'clerkexpresswithauth-frontendapi', 'setclerkapikey', 'setclerkapiversion', 'setclerkhttpoptions', 'setclerkserverapiurl', 'cjs-esm-instance', 'legacyauthobject-removed', 'clerk-import-change']),
   react: load('react', reactChangesList),
   js: load('js', ['magiclinkerror', 'ismagiclinkerror', 'magiclinkerrorcode', 'usemagiclink', 'handlemagiclinkverification', 'external-account-avatarurl',
   // shared w/ all
@@ -34,7 +34,7 @@ export default {
 
   chromeExtension: load('chromeExtension', ['clerkprovider-tokencache']),
   localizations: load('localization', ['new-localization-keys', 'removed-localization-keys', 'changed-localization-keys']),
-  backend: load('backend', ['api-url-value-changed', 'verifyjwt-import-path-move', 'decodejwt-import-path-move', 'signjwt-import-path-move', 'constants-import-path-move', 'redirect-import-path-move', 'createauthenticaterequest-import-path-move', 'createisomorphicrequest-import-path-move', 'createclerkclient-frontendapi', 'authenticaterequest-params-change', 'clerk-import', 'externalaccount-picture', 'externalaccountjson-avatarurl', 'organization-logourl', 'organizationjson-logourl', 'user-profileimageurl', 'userjson-profileimageurl', 'organizationmembershippublicuserdata-profileimageurl', 'organizationmembershippublicuserdatajson-profileimageurl', 'clockskewinseconds', 'pkgversion', 'client-unstableoptions-removed', 'httpoptions-removed', 'createisomorphicrequest-removed', 'createemail-removed', 'signjwterror-import-move', 'tokenverificationerror-import-move', 'tokenverificationerroraction-import-move', 'tokenverificationerrorreason-import-move', 'membershiprole', 'getorganizationmembershiplist-return-signature', 'getorganizationlist-return-signature', 'getorganizationinvitationlist-return-signature']),
+  backend: load('backend', ['api-url-value-changed', 'verifyjwt-import-path-move', 'decodejwt-import-path-move', 'signjwt-import-path-move', 'constants-import-path-move', 'redirect-import-path-move', 'createauthenticaterequest-import-path-move', 'createisomorphicrequest-import-path-move', 'createclerkclient-frontendapi', 'authenticaterequest-params-change', 'clerk-import', 'externalaccount-picture', 'externalaccountjson-avatarurl', 'organization-logourl', 'organizationjson-logourl', 'user-profileimageurl', 'userjson-profileimageurl', 'organizationmembershippublicuserdata-profileimageurl', 'organizationmembershippublicuserdatajson-profileimageurl', 'clockskewinseconds', 'pkgversion', 'client-unstableoptions-removed', 'httpoptions-removed', 'createisomorphicrequest-removed', 'createemail-removed', 'signjwterror-import-move', 'tokenverificationerror-import-move', 'tokenverificationerroraction-import-move', 'tokenverificationerrorreason-import-move', 'membershiprole', 'getorganizationmembershiplist-return-signature', 'getorganizationlist-return-signature', 'getorganizationinvitationlist-return-signature', 'buildrequesturl-removed']),
   types: [],
   redwood: [],
   express: []

package/dist/versions/v5/js/organization-create-string.md

@@ -6,10 +6,7 @@ matcherFlags: 'm'
 
 Passing a string as an argument to `Organization.create` is no longer possible - instead, pass an object with the `name` property.
 
-```js
-// before
-Organization.create('...');
-
-// after
-Organization.create({ name: '...' });
+```diff
+- Organization.create('...');
++ Organization.create({ name: '...' });
 ```

package/dist/versions/v5/js/organization-getdomains-arguments-change.md

@@ -6,12 +6,7 @@ matcher: "\\.getDomains\\("
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
 
 ```diff
-  import Clerk from "@clerk/clerk-js"
-
-  const clerk = new Clerk()
-  await clerk.load()
-
-  const { data: orgs } = await clerk.organization.getDomains({
+  const { data } = await organization.getDomains({
 -   limit: 10,
 +   pageSize: 10,
 -   offset: 10,

package/dist/versions/v5/js/organization-getinvitations-arguments-changed.md

@@ -6,12 +6,7 @@ matcher: "\\.getInvitations\\("
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
 
 ```diff
-  import Clerk from "@clerk/clerk-js"
-
-  const clerk = new Clerk()
-  await clerk.load()
-
-  const { data: orgs } = await clerk.organization.getInvitations({
+  const { data } = await organization.getInvitations({
 -   limit: 10,
 +   pageSize: 10,
 -   offset: 10,

package/dist/versions/v5/js/organization-getmembershiprequests-arguments-changed.md

@@ -6,12 +6,7 @@ matcher: "\\.getMembershipRequests\\("
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
 
 ```diff
-  import Clerk from "@clerk/clerk-js"
-
-  const clerk = new Clerk()
-  await clerk.load()
-
-  const { data: orgs } = await clerk.organization.getMembershipRequests({
+  const { data } = await organization.getMembershipRequests({
 -   limit: 10,
 +   pageSize: 10,
 -   offset: 10,

package/dist/versions/v5/js/organization-getmemberships-arguments-changed.md

@@ -6,12 +6,7 @@ matcher: "\\.getMemberships\\("
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
 
 ```diff
-  import Clerk from "@clerk/clerk-js"
-
-  const clerk = new Clerk()
-  await clerk.load()
-
-  const { data: orgs } = await clerk.organization.getMemberships({
+  const { data } = await organization.getMemberships({
 -   limit: 10,
 +   pageSize: 10,
 -   offset: 10,

package/dist/versions/v5/js/organization-getpendinginvitations.md

@@ -5,10 +5,7 @@ matcher: "\\.getPendingInvitations\\("
 
 The `Organization.getPendingInvitations()` method has been removed. You can use `Organization.getInvitations` instead.
 
-```js
-// before
-Organization.getPendingInvitations();
-
-// after
-Organization.getInvitations({ status: 'pending' });
+```diff
+- Organization.getPendingInvitations();
++ Organization.getInvitations({ status: 'pending' });
 ```

package/dist/versions/v5/js/organization-getroles-arguments-changed.md

@@ -6,12 +6,7 @@ matcher: "\\.getRoles\\("
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
 
 ```diff
-  import Clerk from "@clerk/clerk-js"
-
-  const clerk = new Clerk()
-  await clerk.load()
-
-  const { data: orgs } = await clerk.organization.getRoles({
+  const { data } = await organization.getRoles({
 -   limit: 10,
 +   pageSize: 10,
 -   offset: 10,

package/dist/versions/v5/js/redirecttohome.md

@@ -10,4 +10,4 @@ To set the `afterSignUpUrl` or `afterSignInUrl`, you can:
     - [pass the desired values into ClerkProvider](https://clerk.com/docs/components/clerk-provider#properties)
     - if using nextjs SDK, set with `NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL` or `NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL`
     - if using remix SDK, set with `CLERK_AFTER_SIGN_IN_URL` or `CLERK_AFTER_SIGN_UP_URL`
-    - If not using a react-based SDK, they can be passed into `Clerk.load` as such: `Clerk.load({ afterSignUpUrl: ‘x’, afterSignInUrl: ‘y’ })`
+    - If not using a react-based SDK, they can be passed into `Clerk.load` as such: `Clerk.load({ afterSignUpUrl: 'x', afterSignInUrl: 'y' })`

package/dist/versions/v5/js/router-navigate-push-replace.md

@@ -0,0 +1,18 @@
+---
+title: '`navigate` argument to `Clerk.load` replaced by `routerPush` and `routerReplace`'
+matcher: "Clerk\\.load\\([\\s\\S]*?navigate:[\\s\\S]*?\\)"
+matcherFlags: 'm'
+---
+
+The `navigate` option allowed developers to override the default navigation behavior with a custom function. However, navigate was only able to push, not replace routes. We have now added the capability for the router to push or replace, and as such, updated `Clerk.load` so that it can handle either depending on the circumstance.
+
+Two new arguments have been added to options that can be passed to `Clerk.load` that replace the single `navigate` argument, and can be used to override the default navigation behavior for either a push or replace navigation. For more information on what push and replace mean in relation to the browser history api, [check out these wonderful MDN docs](https://developer.mozilla.org/en-US/docs/Web/API/History_API/Working_with_the_History_API).
+
+If you’d like to keep the same behavior as you had with the single `navigate` argument, pass the exact same function to as both the `routerPush` and `routerReplace` arguments and the behavior will be identical. For example:
+
+```diff
+- Clerk.load({ navigate: x => x })
++ Clerk.load({ routerPush: x => x, routerReplace: x => x })
+```
+
+However, you now have the option to differentiate behavior based on whether the navigation will be a push or replace.

package/dist/versions/v5/js/signup-attemptweb3walletverification-generatedsignature.md

@@ -1,6 +1,7 @@
 ---
 title: '`generatedSignature` -> `signature` as param of Signup.attemptWeb3WalletVerification()'
-matcher: "attemptWeb3WalletVerification\\(\\s*{\\.*?generatedSignature:"
+matcher: "attemptWeb3WalletVerification\\([\\s\\S]*?generatedSignature:[\\s\\S]*?\\)"
+matcherFlags: 'm'
 ---
 
 The `generatedSignature` param to [`Signup.attemptWeb3WalletVerification()`](https://clerk.com/docs/references/javascript/sign-up/web3-verification#attempt-web3-wallet-verification) has been removed. Instead, use the `signature` param. Note that this param takes a string, where the `generatedSignature` param took a function, so both key and value will need to change.

package/dist/versions/v5/js/user-createexternalaccount-redirecturl.md

@@ -1,6 +1,6 @@
 ---
 title: '`redirect_url` -> `redirectUrl` as param of `User.createExternalAccount`'
-matcher: "createExternalAccount\\(\\s*{\\.*?(redirect_url):"
+matcher: "createExternalAccount\\(\\s*{[\\s\\S]*?(redirect_url):[\\s\\S]*?\\)"
 replaceWithString: 'redirectUrl'
 ---
 

package/dist/versions/v5/js/user-getorganizationinvitations-arguments-chanaged.md

@@ -6,12 +6,7 @@ matcher: "\\.getOrganizationInvitations\\("
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
 
 ```diff
-  import Clerk from "@clerk/clerk-js"
-
-  const clerk = new Clerk()
-  await clerk.load()
-
-  const { data: orgs } = await clerk.user.getOrganizationInvitations({
+  const { data } = await user.getOrganizationInvitations({
 -   limit: 10,
 +   pageSize: 10,
 -   offset: 10,

package/dist/versions/v5/js/user-getorganizationmemberships-arguments-chanaged.md

@@ -6,12 +6,7 @@ matcher: "\\.getOrganizationMemberships\\("
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
 
 ```diff
-  import Clerk from "@clerk/clerk-js"
-
-  const clerk = new Clerk()
-  await clerk.load()
-
-  const { data: orgs } = await clerk.user.getOrganizationMemberships({
+  const { data } = await user.getOrganizationMemberships({
 -   limit: 10,
 +   pageSize: 10,
 -   offset: 10,

package/dist/versions/v5/js/user-getorganizationsuggestions-arguments-chanaged.md

@@ -6,12 +6,7 @@ matcher: "\\.getOrganizationSuggestions\\("
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:
 
 ```diff
-  import Clerk from "@clerk/clerk-js"
-
-  const clerk = new Clerk()
-  await clerk.load()
-
-  const { data: orgs } = await clerk.user.getOrganizationSuggestions({
+  const { data } = await user.getOrganizationSuggestions({
 -   limit: 10,
 +   pageSize: 10,
 -   offset: 10,

package/dist/versions/v5/js/user-update-password.md

@@ -1,6 +1,6 @@
 ---
 title: "`User.update({ password: 'x' })` -> `User.updatePassword('x')`"
-matcher: "\\.update\\(\\s*{.*?password:"
+matcher: "\\.update\\([\\s\\S]*?password:[\\s\\S]*?\\)"
 matcherFlags: 'm'
 ---
 

package/dist/versions/v5/next/api-url-value-change.md

@@ -2,6 +2,7 @@
 title: '`API_URL` value has changed'
 matcher: "API_URL[\\s\\S]+?from\\s+['\"]@clerk\\/nextjs\\/server['\"]"
 matcherFlags: 'm'
+warning: true
 ---
 
 The value of this export has changed from `https://api.clerk.dev` to `https://api.clerk.com`. If you were relying on the text content of this value not changing, you may need to make adjustments.

package/dist/versions/v5/next/auth-import-change.md

@@ -1,6 +1,6 @@
 ---
 title: '`auth` import moved under `/server`'
-matcher: "import\\s+{[\\s\\S]*?auth[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcher: "import\\s+{[\\s\\S]*?[,\\s]auth[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
 matcherFlags: 'm'
 replaceWithString: 'nextjs/server'
 ---

package/dist/versions/v5/next/authmiddleware-frontendapi.md

@@ -4,6 +4,11 @@ matcher: "authMiddleware\\({[\\s\\S]*?frontendApi:[\\s\\S]*?}\\)"
 matcherFlags: 'm'
 ---
 
-<!-- TODO: is there a possible issue with import matching? this from `@clerk/nextjs` -->
-
 The `frontendApi` argument passed to `authMiddleware` must be changed to `publishableKey`
+
+```diff
+import { authMiddleware } from "@clerk/nextjs/server"
+
+- authMiddleware({ frontendApi: '...' })
++ authMiddleware({ publishableKey: '...' })
+```

package/dist/versions/v5/next/constants-import-change.md

@@ -1,6 +1,6 @@
 ---
 title: '`constants` import moved under `/server`'
-matcher: "import\\s+{[\\s\\S]*?constants[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcher: "import\\s+{[\\s\\S]*?[,\\s]constants[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
 matcherFlags: 'm'
 replaceWithString: 'nextjs/server'
 ---

package/dist/versions/v5/next/createclerkclient-apikey.md

@@ -6,12 +6,9 @@ matcherFlags: 'm'
 
 The `apiKey` argument passed to `createClerkClient` must be changed to `secretKey`.
 
-```js
+```diff
 import { createClerkClient } from '@clerk/nextjs/server';
 
-// before
-createClerkClient({ apiKey: '...' });
-
-// after
-createClerkClient({ secretKey: '...' });
+- createClerkClient({ apiKey: '...' });
++ createClerkClient({ secretKey: '...' });
 ```

package/dist/versions/v5/next/createclerkclient-frontendapi.md

@@ -6,12 +6,9 @@ matcherFlags: 'm'
 
 The `frontendApi` argument passed to `createClerkClient` must be changed to `publishableKey`. Note that the values of the two keys are different, so both keys and values need to be changed. You can find your application's publishable key in the Clerk dashboard.
 
-```js
+```diff
 import { createClerkClient } from '@clerk/nextjs/server';
 
-// before
-createClerkClient({ frontendApi: '...' });
-
-// after
-createClerkClient({ publishableKey: '...' });
+- createClerkClient({ frontendApi: '...' });
++ createClerkClient({ publishableKey: '...' });
 ```

package/dist/versions/v5/next/getauth-apikey.md

@@ -4,6 +4,9 @@ matcher: "getAuth\\({[\\s\\S]*?apiKey:[\\s\\S]*?}\\)"
 matcherFlags: 'm'
 ---
 
-<!-- TODO: is there a possible issue with import matching? this from `@clerk/nextjs/server` -->
+The `apiKey` argument passed to `getAuth` must be changed to `secretKey`.
 
-The `apiKey` argument passed to `getAuth` must be changed to `secretKey`
+```diff
+- getAuth({ apiKey: '...' })
++ getAuth({ secretKey: '...' })
+```