@clerk/upgrade 0.2.1 → 0.4.0

package/dist/versions/{v5/next → core-2/nextjs}/import-clerk-js-version.md

@@ -1,7 +1,8 @@
 ---
 title: '`CLERK_JS_VERSION` constant removed'
 matcher: "import\\s+{[\\s\\S]*?CLERK_JS_VERSION[\\s\\S]*?from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 
-This deprecated constant has been removed as an export from `@clerk/nextjs`. We recommend setting the `NEXT_PUBLIC_CLERK_JS_VERSION` environment variable and using this instead.
+This deprecated constant has been removed as an export from `@clerk/nextjs`. Instead, set and use the `NEXT_PUBLIC_CLERK_JS_VERSION` environment variable.

package/dist/versions/{v5/next → core-2/nextjs}/import-domain.md

@@ -1,7 +1,8 @@
 ---
 title: '`DOMAIN` constant removed'
 matcher: "import\\s+{[\\s\\S]*?DOMAIN[\\s\\S]*?from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 
-This deprecated constant has been removed as an export from `@clerk/nextjs`. We recommend setting the `NEXT_PUBLIC_CLERK_DOMAIN` environment variable and using this instead.
+This deprecated constant has been removed as an export from `@clerk/nextjs`. Instead, set and use the `NEXT_PUBLIC_CLERK_DOMAIN` environment variable.

package/dist/versions/{v5/next → core-2/nextjs}/import-is-satellite.md

@@ -1,7 +1,8 @@
 ---
 title: '`IS_SATELLITE` constant removed'
 matcher: "import\\s+{[\\s\\S]*?IS_SATELLITE[\\s\\S]*?from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 
-This deprecated constant has been removed as an export from `@clerk/nextjs`. We recommend setting the `NEXT_PUBLIC_CLERK_IS_SATELLITE` environment variable and using this instead.
+This deprecated constant has been removed as an export from `@clerk/nextjs`. Instead, set and use the `NEXT_PUBLIC_CLERK_IS_SATELLITE` environment variable.

package/dist/versions/{v5/next → core-2/nextjs}/import-nextjs-api.md

@@ -1,5 +1,6 @@
 ---
 title: '`@clerk/nextjs/api` import removed'
+category: 'deprecation-removal'
 matcher: "@clerk\\/nextjs\\/api"
 ---
 
@@ -8,12 +9,12 @@ The import subpath `@clerk/nextjs/api` has been removed. This includes the follo
 ```js
 // These have been removed
 import {
-	ClerkMiddleware,
-	ClerkMiddlewareOptions,
-	LooseAuthProp,
-	RequireAuthProp,
-	StrictAuthProp,
-	WithAuthProp,
+  ClerkMiddleware,
+  ClerkMiddlewareOptions,
+  LooseAuthProp,
+  RequireAuthProp,
+  StrictAuthProp,
+  WithAuthProp,
 } from '@clerk/nextjs/api';
 ```
 

package/dist/versions/{v5/next → core-2/nextjs}/import-nextjs-app-beta.md

@@ -1,5 +1,6 @@
 ---
 title: '`@clerk/nextjs/app-beta` import removed'
+category: 'deprecation-removal'
 matcher: "@clerk\\/nextjs\\/app-beta"
 ---
 
@@ -7,4 +8,4 @@ If you are using the `@clerk/nextjs/app-beta` import anywhere, it should use `@
 
 Make this change carefully as some behavior may have changed between our beta and stable releases. You can refer to [our documentation](https://clerk.com/docs/quickstarts/nextjs) and/or [approuter example](https://github.com/clerk/clerk-nextjs-app-quickstart) for up-to-date usage.
 
-The `@clerk/nextjs` import will work with both app router and pages router.
+The `@clerk/nextjs` import will work with both App Router and Pages Router.

package/dist/versions/{v5/next → core-2/nextjs}/import-nextjs-edge-middleware.md

@@ -1,5 +1,6 @@
 ---
 title: '`@clerk/nextjs/edge-middleware` import removed'
+category: 'deprecation-removal'
 matcher: "@clerk\\/nextjs\\/edge-middleware"
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/import-nextjs-edge-middlewarefiles.md

@@ -1,5 +1,6 @@
 ---
 title: '`@clerk/nextjs/edge-middlewarefiles` import removed'
+category: 'deprecation-removal'
 matcher: "@clerk\\/nextjs\\/edge-middlewarefiles"
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/import-nextjs-ssr.md

@@ -1,6 +1,7 @@
 ---
 title: '`@clerk/nextjs/ssr` import removed'
 matcher: "@clerk\\/nextjs\\/ssr"
+category: 'deprecation-removal'
 replaceWithString: '@clerk/nextjs'
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/import-proxy-url.md

@@ -1,7 +1,8 @@
 ---
 title: '`PROXY_URL` constant removed'
 matcher: "import\\s+{[\\s\\S]*?PROXY_URL[\\s\\S]*?from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 
-This deprecated constant has been removed as an export from `@clerk/nextjs`. We recommend setting the `NEXT_PUBLIC_CLERK_PROXY_URL` environment variable and using this instead.
+This deprecated constant has been removed as an export from `@clerk/nextjs`. Instead, set and use the `NEXT_PUBLIC_CLERK_PROXY_URL` environment variable.

package/dist/versions/{v5/next → core-2/nextjs}/import-publishable-key.md

@@ -1,7 +1,8 @@
 ---
 title: '`PUBLISHABLE_KEY` constant removed'
 matcher: "import\\s+{[\\s\\S]*?PUBLISHABLE_KEY[\\s\\S]*?from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 
-This deprecated constant has been removed as an export from `@clerk/nextjs`. We recommend setting the `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` environment variable and using this instead.
+This deprecated constant has been removed as an export from `@clerk/nextjs`. Instead, set and use the `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` environment variable.

package/dist/versions/{v5/next → core-2/nextjs}/import-secret-key.md

@@ -1,7 +1,8 @@
 ---
 title: '`SECRET_KEY` constant removed'
 matcher: "import\\s+{[\\s\\S]*?SECRET_KEY[\\s\\S]*?from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 
-This deprecated constant has been removed as an export from `@clerk/nextjs`. We recommend setting the `CLERK_SECRET_KEY` environment variable and using this instead.
+This deprecated constant has been removed as an export from `@clerk/nextjs`. Instead, set and use the `CLERK_SECRET_KEY` environment variable.

package/dist/versions/{v5/next → core-2/nextjs}/import-sign-in-url.md

@@ -1,7 +1,8 @@
 ---
 title: '`SIGN_IN_URL` constant removed'
 matcher: "import\\s+{[\\s\\S]*?SIGN_IN_URL[\\s\\S]*?from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 
-This deprecated constant has been removed as an export from `@clerk/nextjs`. We recommend setting the `NEXT_PUBLIC_CLERK_SIGN_IN_URL` environment variable and using this instead.
+This deprecated constant has been removed as an export from `@clerk/nextjs`. Instead, set and use the `NEXT_PUBLIC_CLERK_SIGN_IN_URL` environment variable.

package/dist/versions/{v5/next → core-2/nextjs}/import-sign-up-url.md

@@ -1,7 +1,8 @@
 ---
 title: '`SIGN_UP_URL` constant removed'
 matcher: "import\\s+{[\\s\\S]*?SIGN_UP_URL[\\s\\S]*?from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 
-This deprecated constant has been removed as an export from `@clerk/nextjs`. We recommend setting the `NEXT_PUBLIC_CLERK_SIGN_UP_URL` environment variable and using this instead.
+This deprecated constant has been removed as an export from `@clerk/nextjs`. Instead, set and use the `NEXT_PUBLIC_CLERK_SIGN_UP_URL` environment variable.

package/dist/versions/{v5/next → core-2/nextjs}/isclerkapiresponserror-import-change.md

@@ -2,6 +2,7 @@
 title: '`isClerkAPIResponseError` import moved under `/errors`'
 matcher: "import\\s+{[\\s\\S]*?isClerkAPIResponseError[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
 matcherFlags: 'm'
+category: 'top-level-imports'
 replaceWithString: 'nextjs/errors'
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/isemaillinkerror-import-change.md

@@ -2,6 +2,7 @@
 title: '`isEmailLinkError` import moved under `/errors`'
 matcher: "import\\s+{[\\s\\S]*?isEmailLinkError[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
 matcherFlags: 'm'
+category: 'top-level-imports'
 replaceWithString: 'nextjs/errors'
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/isknownerror-import-change.md

@@ -2,6 +2,7 @@
 title: '`isKnownError` import moved under `/errors`'
 matcher: "import\\s+{[\\s\\S]*?isKnownError[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
 matcherFlags: 'm'
+category: 'top-level-imports'
 replaceWithString: 'nextjs/errors'
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/min-nextjs-version.md

@@ -1,6 +1,8 @@
 ---
 title: 'Upgrade nextjs to v13 or higher'
+category: 'version'
 matcher: "dependencies\":\\s*{[\\s\\S]*?\"next\":\\s*\"(?:^|~|>|=|\\s)*(?:10|11|12)\\..*?"
+matcherFlags: 'm'
 ---
 
 If you're using `@clerk/nextjs`, you will need to update your Next.js project to `13.0.4` or later. Check out Next's upgrade guides for help:

package/dist/versions/{v5/next → core-2/nextjs}/multisessionappsupport-import-change.md

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

package/dist/versions/{v5/next → core-2/nextjs}/next-public-clerk-js-url.md

@@ -1,6 +1,7 @@
 ---
 title: '`NEXT_PUBLIC_CLERK_JS` should be `NEXT_PUBLIC_CLERK_JS_URL`'
+category: 'deprecation-removal'
 matcher: 'NEXT_PUBLIC_CLERK_JS[^_]*$'
 ---
 
-If you are using `NEXT_PUBLIC_CLERK_JS` as an environment variable, it should be changed to `NEXT_PUBLIC_CLERK_JS_URL` instead. We renamed this variable for consistency across public APIs. Make sure to also check your production host configuration when changing environment variable values.
+If you are using `NEXT_PUBLIC_CLERK_JS` as an environment variable, it should be changed to `NEXT_PUBLIC_CLERK_JS_URL` instead. This variable was renamed for consistency across public APIs. Make sure to also check your production host configuration when changing environment variable values.

package/dist/versions/{v5/next → core-2/nextjs}/redirect-import-change.md

@@ -2,6 +2,7 @@
 title: '`redirect` import moved under `/server`'
 matcher: "import\\s+{[\\s\\S]*?[,\\s]redirect[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
 matcherFlags: 'm'
+category: 'top-level-imports'
 replaceWithString: 'nextjs/server'
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/redirecttosignin-import-path.md

@@ -1,6 +1,7 @@
 ---
-title: '`redirectToSignIn` import moved under `/server/'
+title: '`redirectToSignIn` import moved under `/server'
 matcher: "import\\s+{[\\s\\S]*?[,\\s]redirectToSignIn[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+category: 'top-level-imports'
 replaceWithString: 'nextjs/server'
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/redirecttosignup-import-path.md

@@ -1,6 +1,7 @@
 ---
-title: '`redirectToSignUp` import path changed'
+title: '`redirectToSignUp` import moved under `/server`'
 matcher: "import\\s+{[\\s\\S]*?[,\\s]redirectToSignUp[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+category: 'top-level-imports'
 replaceWithString: 'nextjs/server'
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/signjwt-import-change.md

@@ -2,6 +2,7 @@
 title: '`signJwt` import moved under `/server`'
 matcher: "import\\s+{[\\s\\S]*?signJwt[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
 matcherFlags: 'm'
+category: 'top-level-imports'
 replaceWithString: 'nextjs/server'
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/verifyjwt-import-change.md

@@ -2,6 +2,7 @@
 title: '`verifyJwt` import moved under `/server`'
 matcher: "import\\s+{[\\s\\S]*?verifyJwt[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
 matcherFlags: 'm'
+category: 'top-level-imports'
 replaceWithString: 'nextjs/server'
 ---
 

package/dist/versions/{v5/next → core-2/nextjs}/verifytoken-import-change.md

@@ -2,6 +2,7 @@
 title: '`verifyToken` import moved under `/server`'
 matcher: "import\\s+{[\\s\\S]*?verifyToken[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
 matcherFlags: 'm'
+category: 'top-level-imports'
 replaceWithString: 'nextjs/server'
 ---
 

package/dist/versions/core-2/nextjs/with-clerk-middleware-removed.md

@@ -0,0 +1,56 @@
+---
+title: '`withClerkMiddleware` removed'
+category: 'middleware'
+matcher: "withClerkMiddleware\\("
+---
+
+`withClerkMiddleware` has been deprecated and is now removed in v5. We recommend moving to `clerkMiddleware` instead. Please read the [clerkMiddleware guide](https://clerk.com/docs/references/nextjs/clerk-middleware) for more details. Here’s an example of how a simple middleware setup might look before and after.
+
+```js
+// Before: using withClerkMiddleware
+import { withClerkMiddleware } from '@clerk/nextjs/server';
+import { NextResponse } from 'next/server';
+import type { NextRequest } from 'next/server';
+
+const publicPaths = ['/', '/sign-in', '/sign-up'];
+
+const isPublic = (path: string) => {
+  return publicPaths.find(x => path.match(new RegExp(`^${x}$`.replace('*$', '($|/)'))));
+
+  if (isPublic(request.nextUrl.pathname)) {
+    return NextResponse.next();
+  }
+  const { userId } = getAuth(request);
+
+  if (!userId) {
+    const signInUrl = new URL('/sign-in', request.url);
+    signInUrl.searchParams.set('redirect_url', request.url);
+    return NextResponse.redirect(signInUrl);
+  }
+};
+
+export default withClerkMiddleware((req: NextRequest) => {
+  return NextResponse.next();
+});
+
+export const config = {
+  matcher: ['/((?!static|.*\\..*|_next|favicon.ico).*)', '/'],
+};
+```
+
+```js
+// After: using clerkMiddleware
+import { clerkMiddleware, createRouteMatcher } from '@clerk/nextjs';
+
+const isPublicRoute = createRouteMatcher(['/', '/sign-in', '/sign-up']);
+
+export default clerkMiddleware((auth, req) => {
+  if (isPublicRoute(req)) return;
+
+  auth().protect();
+});
+
+export const config = {
+  matcher: ['/((?!.+\\.[\\w]+$|_next).*)', '/', '/(api|trpc)(.*)'],
+};
+```

package/dist/versions/{v5 → core-2}/node/cjs-esm-instance.md

@@ -1,6 +1,7 @@
 ---
 title: '`cjs/instance` and `esm/instance` imports no longer needed'
 matcher: "@clerk\\/clerk-sdk-node(\\/(?:cjs|esm)\\/instance)"
+category: 'cjs-esm-instance'
 replaceWithString: ''
 ---
 

package/dist/versions/{v5 → core-2}/node/clerkexpressrequireauth-apikey.md

@@ -1,6 +1,7 @@
 ---
 title: '`apiKey` -> `secretKey` as param to ClerkExpressRequireAuth'
 matcher: "ClerkExpressRequireAuth\\([\\s\\S]*?apiKey:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/clerkexpressrequireauth-frontendapi.md

@@ -1,6 +1,7 @@
 ---
 title: '`frontendApi` -> `publishableKey` as param to ClerkExpressRequireAuth'
 matcher: "ClerkExpressRequireAuth\\([\\s\\S]*?frontendApi:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/clerkexpresswithauth-apikey.md

@@ -1,6 +1,7 @@
 ---
 title: '`apiKey` -> `secretKey` as param to ClerkExpressWithAuth'
 matcher: "ClerkExpressWithAuth\\([\\s\\S]*?apiKey:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/clerkexpresswithauth-frontendapi.md

@@ -1,6 +1,7 @@
 ---
 title: '`frontendApi` -> `publishableKey` as param to ClerkExpressWithAuth'
 matcher: "ClerkExpressWithAuth\\([\\s\\S]*?frontendApi:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/createclerkclient-apikey.md

@@ -1,6 +1,7 @@
 ---
 title: '`apiKey` -> `secretKey` as param to createClerkClient'
 matcher: "createClerkClient\\([\\s\\S]*?apiKey:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/createclerkclient-frontendapi.md

@@ -1,6 +1,7 @@
 ---
 title: '`frontendApi` -> `publishableKey` as param to createClerkClient'
 matcher: "createClerkClient\\([\\s\\S]*?frontendApi:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/createclerkexpressrequireauth-apikey.md

@@ -1,6 +1,7 @@
 ---
 title: '`apiKey` -> `secretKey` as param to createClerkExpressRequireAuth'
 matcher: "createClerkExpressRequireAuth\\([\\s\\S]*?apiKey:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/createclerkexpressrequireauth-frontendapi.md

@@ -1,6 +1,7 @@
 ---
 title: '`frontendApi` -> `publishableKey` as param to createClerkExpressRequireAuth'
 matcher: "createClerkExpressRequireAuth\\([\\s\\S]*?frontendApi:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/createclerkexpresswithauth-apikey.md

@@ -1,6 +1,7 @@
 ---
 title: '`apiKey` -> `secretKey` as param to createClerkExpressWithAuth'
 matcher: "createClerkExpressWithAuth\\([\\s\\S]*?apiKey:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/createclerkexpresswithauth-frontendapi.md

@@ -1,6 +1,7 @@
 ---
 title: '`frontendApi` -> `publishableKey` as param to createClerkExpressWithAuth'
 matcher: "createClerkExpressWithAuth\\([\\s\\S]*?frontendApi:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/node/legacyauthobject-removed.md

@@ -3,7 +3,7 @@ title: '`LegacyAuthObject` type -> `AuthObject`'
 matcher: '(?:LegacyAuthObject|LooseAuthProp|StrictAuthProp)'
 ---
 
-We changed the values that our middleware adds to the `request` object after running. Previously it returned a `LegacyAuthObject` type, and now it returns an `AuthObject` type, the difference between the two types is as such:
+We changed the values that our middleware adds to the `request` object after running. Previously it returned a `LegacyAuthObject` type, and now it returns an `AuthObject` type, the difference between the two types is as such:
 
 ```diff
 - type LegacyAuthObject = {
@@ -14,7 +14,7 @@ We changed the values that our middleware adds to the `request` object after r
     getToken: ServerGetToken | null;
     debug: AuthObjectDebug | null;
 -   claims: JwtPayload | null;
--   sessionClaims: JwtPayload | null;
++   sessionClaims: JwtPayload | null;
 +   orgId: string | undefined | null;
 +   orgRole: OrganizationCustomRoleKey | undefined | null;
 +   orgSlug: string | undefined | null;
@@ -23,4 +23,4 @@ We changed the values that our middleware adds to the `request` object after r
   }
 ```
 
-If you were using the `claims` key on the request after running middleware, you will need to instead use `sessionClaims`. Additionally, if you were using the `LooseAuthProp` or `StrictAuthProp` exported types anywhere, note that these have been adjusted to fit the shape of the new middleware response typing.
+If you were using the `claims` key on the request after running middleware, you will need to instead use `sessionClaims`. Additionally, if you were using the `LooseAuthProp` or `StrictAuthProp` exported types anywhere, note that these have been adjusted to fit the shape of the new middleware response typing.

package/dist/versions/{v5 → core-2}/node/setclerkapikey.md

@@ -1,6 +1,7 @@
 ---
 title: '`setClerkApiKey` removed, pass `secretKey` to `createClerkClient` instead'
 matcher: "setClerkApiKey\\("
+category: 'setter-removal'
 ---
 
 Setters that change options on the singleton `clerkClient` instance have been removed. Instead, pass the option directly to `createClerkClient` - see [the documentation](https://clerk.com/docs/references/nodejs/overview#customizing-resources) for more detail. Note that the name `apiKey` should now be `secretKey` as well.

package/dist/versions/{v5 → core-2}/node/setclerkapiversion.md

@@ -1,6 +1,7 @@
 ---
 title: '`setClerkApiVersion` removed, pass options to `createClerkClient` instead'
 matcher: "setClerkApiVersion\\("
+category: 'setter-removal'
 ---
 
 Setters that change options on the singleton `clerkClient` instance have been removed. Instead, pass the option directly to `createClerkClient` - see [the documentation](https://clerk.com/docs/references/nodejs/overview#customizing-resources) for more detail.

package/dist/versions/{v5 → core-2}/node/setclerkhttpoptions.md

@@ -1,6 +1,7 @@
 ---
 title: '`setClerkHttpOptions` removed, pass options to `createClerkClient` instead'
 matcher: "setClerkHttpOptions\\("
+category: 'setter-removal'
 ---
 
 Setters that change options on the singleton `clerkClient` instance have been removed. Instead, pass the option directly to `createClerkClient` - see [the documentation](https://clerk.com/docs/references/nodejs/overview#customizing-resources) for more detail.

package/dist/versions/{v5 → core-2}/node/setclerkserverapiurl.md

@@ -1,6 +1,7 @@
 ---
 title: '`setClerkServerApiUrl` removed, pass options to `createClerkClient` instead'
 matcher: "setClerkServerApiUrl\\("
+category: 'setter-removal'
 ---
 
 Setters that change options on the singleton `clerkClient` instance have been removed. Instead, pass the option directly to `createClerkClient` - see [the documentation](https://clerk.com/docs/references/nodejs/overview#customizing-resources) for more detail.

package/dist/versions/core-2/react/api-url-value-change.md

@@ -0,0 +1,8 @@
+---
+title: '`API_URL` value has changed'
+matcher: "import\\s+{[\\s\\S]*?[,\\s]API_URL[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/clerk-react[\\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 → core-2}/remix/clerk-import-change.md

@@ -1,6 +1,7 @@
 ---
 title: '`Clerk` -> `{ createClerkClient }`'
 matcher: "import\\s+{[\\s\\S]*?[,\\s]Clerk[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/remix[\\s\\S]*?['\"]"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/remix/clerkerrorboundary-removed.md

@@ -1,6 +1,7 @@
 ---
 title: '`ClerkErrorBoundary` removed'
 matcher: "import\\s+{[\\s\\S]*?ClerkErrorBoundary[\\s\\S]*?from\\s+['\"]@clerk\\/remix[\\s\\S]*?['\"]"
+category: 'error-boundary-removed'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/remix/createclerkclient-apikey.md

@@ -1,6 +1,7 @@
 ---
 title: '`apiKey` -> `secretKey` as argument to createClerkClient'
 matcher: "createClerkClient\\({[\\s\\S]*?apiKey:[\\s\\S]*?}\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/remix/getauth-apikey.md

@@ -1,6 +1,7 @@
 ---
 title: '`apiKey` -> `secretKey` as argument to getAuth'
 matcher: "getAuth\\({[\\s\\S]*?apiKey:[\\s\\S]*?}\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/remix/rootauthloader-apikey.md

@@ -1,6 +1,7 @@
 ---
 title: '`apiKey` -> `secretKey` as argument to rootAuthLoader'
 matcher: "rootAuthLoader\\({[\\s\\S]*?apiKey:[\\s\\S]*?}\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/remix/rootauthloader-frontendapi.md

@@ -1,6 +1,7 @@
 ---
 title: '`frontendApi` -> `publishableKey` as argument to rootAuthLoader'
 matcher: "rootAuthLoader\\({[\\s\\S]*?frontendApi:[\\s\\S]*?}\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 

package/dist/versions/{v5 → core-2}/shared/useorganizationlist-organizationlist.md

@@ -9,11 +9,11 @@ The deprecated `organizationList` param to `useOrganizationList` has been remove
 ```js
 // before
 const { organizationList } = useOrganizationList({
-	organizationList: { limit: 10, offset: 1 },
+  organizationList: { limit: 10, offset: 1 },
 });
 
 // after
 const { memberships } = useOrganizationList({
-	userMemberships: { initialPage: 1, pageSize: 10 },
+  userMemberships: { initialPage: 1, pageSize: 10 },
 });
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerk/upgrade",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "license": "MIT",
   "type": "module",
   "main": "dist/cli.js",
@@ -23,6 +23,7 @@
   "dependencies": {
     "@inkjs/ui": "^1.0.0",
     "@jescalan/ink-markdown": "^2.0.0",
+    "ejs": "3.1.9",
     "globby": "^14.0.0",
     "gray-matter": "^4.0.3",
     "index-to-position": "^0.1.2",

package/dist/util/generate-export-change.js

@@ -1,7 +0,0 @@
-// WIP, a util script used for quickly generating a large number of nearly identical change files
-const movedToServer = ['MultisessionAppSupport', 'auth', 'currentUser', 'authMiddleware',
-// deprecated
-'clerkMiddleware',
-// new
-'redirectToSignIn', 'redirectToSignUp', 'buildClerkProps', 'verifyToken', 'isClerkAPIResponseError', 'isEmailLinkError', 'isKnownError', 'isMetamaskError', 'EmailLinkErrorCode', 'withClerk', 'withSession', 'withUser', 'WithClerk', 'WithSession', 'WithUser'];
-const clerkBackendExports = ['createClerkClient', 'verifyToken'];

package/dist/util/step-sequencer.js

@@ -1,31 +0,0 @@
-import { useState } from 'react';
-
-// This was an attempt to write a function that would clean up the step-by-step
-// nature of the CLI but I couldn't get it working the way I wanted quick enough
-// so shelving it for now.
-export function createStepSequence() {
-  const [step, setStep] = useState(0);
-  const StepSequence = ({
-    children
-  }) => {
-    const stepToRender = [].concat(children).filter((_, idx) => {
-      return idx === step;
-    });
-    if (!stepToRender.length) return [];
-    if (stepToRender[0].props.condition === false) {
-      setStep(step + 1);
-    } else {
-      return stepToRender;
-    }
-  };
-  const Step = ({
-    condition,
-    children
-  }) => {
-    return children;
-  };
-  const nextStep = () => {
-    setStep(step + 1);
-  };
-  return [StepSequence, Step, nextStep];
-}