@clerk/upgrade 0.2.0 → 0.3.0

package/dist/versions/v5/next/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/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/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/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/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/ismetamaskerror-import-change.md

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

package/dist/versions/v5/next/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/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/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/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/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/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/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/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/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/v5/next/with-clerk-middleware-removed.md

@@ -1,5 +1,6 @@
 ---
 title: '`withClerkMiddleware` removed'
+category: 'middleware'
 matcher: "withClerkMiddleware\\("
 ---
 

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

@@ -0,0 +1,8 @@
+---
+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/nextjs/auth-import-change.md

@@ -0,0 +1,14 @@
+---
+title: '`auth` import moved under `/server`'
+matcher: "import\\s+{[\\s\\S]*?[,\\s]auth[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+category: 'top-level-imports'
+replaceWithString: 'nextjs/server'
+---
+
+The `auth` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/server`, as this is a helper that should be only used on the server side. 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 { auth } from "@clerk/nextjs"
++ import { auth } from "@clerk/nextjs/server"
+```

package/dist/versions/v5/nextjs/auth-middleware-deprecated.md

@@ -0,0 +1,50 @@
+---
+title: '`authMiddleware` deprecated'
+matcher: "import\\s+{[\\s\\S]*?authMiddleware[\\s\\S]*?}\\s+from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'middleware'
+matcherFlags: 'm'
+warning: true
+---
+
+The [`authMiddleware`](https://clerk.com/docs/references/nextjs/auth-middleware) API from `@clerk/nextjs` has been marked as deprecated. We highly recommend using [`clerkMiddleware`](https://clerk.com/docs/references/nextjs/clerk-middleware) going forward. `clerkMiddleware` protects no routes by default and you need to add your individual routes you want to opt into protection. Here's an example of having all routes public except for everything under `/dashboard`.
+
+For more documentation on the new `clerkMiddleware` function, check out [our official docs](https://clerk.com/docs/references/nextjs/clerk-middleware)!
+
+**Before:**
+
+```ts
+// middleware.ts
+
+import { authMiddleware } from '@clerk/nextjs';
+
+export default authMiddleware({
+  publicRoutes: req => !req.url.includes('/dashboard'),
+});
+
+export const config = {
+  matcher: ['/((?!.+\\.[\\w]+$|_next)._)', '/', '/(api|trpc)(._)'],
+};
+```
+
+**After:**
+
+```ts
+// middleware.ts
+
+import { clerkMiddleware, createRouteMatcher } from '@clerk/nextjs/server';
+import { NextResponse } from 'next/server';
+
+const isProtectedRoute = createRouteMatcher(['/dashboard(.*)']);
+
+export default clerkMiddleware((auth, request) => {
+  if (isProtectedRoute(request)) {
+    auth().protect();
+  }
+
+  return NextResponse.next();
+});
+
+export const config = {
+  matcher: ['/((?!.+\\.[\\w]+$|_next)._)', '/', '/(api|trpc)(._)'],
+};
+```

package/dist/versions/v5/nextjs/authmiddleware-apikey.md

@@ -0,0 +1,15 @@
+---
+title: '`apiKey` -> `secretKey` as param to `authMiddleware`'
+matcher: "authMiddleware\\({[\\s\\S]*?apiKey:[\\s\\S]*?}\\)"
+category: 'deprecation-removal'
+matcherFlags: 'm'
+---
+
+The `apiKey` argument passed to `authMiddleware` must be changed to `secretKey`.
+
+```diff
+import { authMiddleware } from '@clerk/nextjs';
+
+- authMiddleware({ apiKey: '...' });
++ authMiddleware({ secretKey: '...' });
+```

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

@@ -0,0 +1,15 @@
+---
+title: '`frontendApi` -> `publishableKey` as param to `authMiddleware`'
+matcher: "authMiddleware\\({[\\s\\S]*?frontendApi:[\\s\\S]*?}\\)"
+category: 'deprecation-removal'
+matcherFlags: 'm'
+---
+
+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/nextjs/authmiddleware-import-change.md

@@ -0,0 +1,14 @@
+---
+title: '`authMiddleware` import moved under `/server`'
+matcher: "import\\s+{[\\s\\S]*?authMiddleware[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+category: 'top-level-imports'
+replaceWithString: 'nextjs/server'
+---
+
+The `authMiddleware` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/server`, as this is a helper that should be only used on the server side. You must update your import path in order for it to work correctly. Note as well that `authMiddleware` is deprecated as of this release, and we recommend [using `clerkMiddleware` instead](https://clerk.com/docs/references/nextjs/clerk-middleware). Example below of the fix that needs to be made:
+
+```diff
+- import { authMiddleware } from "@clerk/nextjs"
++ import { authMiddleware } from "@clerk/nextjs/server"
+```

package/dist/versions/v5/nextjs/buildclerkprops-import-change.md

@@ -0,0 +1,14 @@
+---
+title: '`buildClerkProps` import moved under `/server`'
+matcher: "import\\s+{[\\s\\S]*?buildClerkProps[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+category: 'top-level-imports'
+replaceWithString: 'nextjs/server'
+---
+
+The `buildClerkProps` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/server`, as this is a helper that should be only used on the server side. 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 { buildClerkProps } from "@clerk/nextjs"
++ import { buildClerkProps } from "@clerk/nextjs/server"
+```

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

@@ -0,0 +1,13 @@
+---
+title: '`Clerk` import moved under `/server`'
+matcher: "import\\s+{[\\s\\S]*?[,\\s]Clerk[,\\s][\\s\\S]*?from\\s+['\"]@clerk\\/nextjs[\\s\\S]*?['\"]"
+category: 'top-level-imports'
+matcherFlags: 'm'
+---
+
+The `Clerk` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/server`, as this is a helper that should be only used on the server side. You must update your import path in order for it to work correctly. Note as well that the `Clerk` export has changed to `createClerkClient` as part of the v5 changes. Example below of the fix that needs to be made:
+
+```diff
+- import { Clerk } from "@clerk/nextjs"
++ import { createClerkClient } from "@clerk/nextjs/server"
+```

package/dist/versions/v5/nextjs/clerk-js-version-next-public.md

@@ -0,0 +1,9 @@
+---
+title: '`CLERK_JS_VERSION` should be `NEXT_PUBLIC_CLERK_JS_VERSION`'
+category: 'deprecation-removal'
+matcher: '^[^_]*CLERK_JS_VERSION'
+---
+
+If you are using `CLERK_JS_VERSION` as an environment variable, it should be changed to `NEXT_PUBLIC_CLERK_JS_VERSION` instead.
+
+This change brings our SDK up to date with the latest standards for next.js - that public environment variables should have the `NEXT_PUBLIC_` prefix. This env variable is not private, so it should get the public prefix.

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

@@ -0,0 +1,14 @@
+---
+title: '`constants` import moved under `/server`'
+matcher: "import\\s+{[\\s\\S]*?constants[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+category: 'top-level-imports'
+replaceWithString: 'nextjs/server'
+---
+
+The `constants` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/server`, as this is a helper that should be only used on the server side. 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 { constants } from "@clerk/nextjs"
++ import { constants } from "@clerk/nextjs/server"
+```

package/dist/versions/v5/nextjs/createauthenticaterequest-import-change.md

@@ -0,0 +1,14 @@
+---
+title: '`createAuthenticateRequest` import moved under `/server`'
+matcher: "import\\s+{[\\s\\S]*?createAuthenticateRequest[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+category: 'top-level-imports'
+replaceWithString: 'nextjs/server'
+---
+
+The `createAuthenticateRequest` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/server`, as this is a helper that should be only used on the server side. 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 { createAuthenticateRequest } from "@clerk/nextjs"
++ import { createAuthenticateRequest } from "@clerk/nextjs/server"
+```

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

@@ -0,0 +1,15 @@
+---
+title: '`apiKey` -> `secretKey` as param to `createClerkClient`'
+matcher: "createClerkClient\\({[\\s\\S]*?apiKey:[\\s\\S]*?}\\)"
+category: 'deprecation-removal'
+matcherFlags: 'm'
+---
+
+The `apiKey` argument passed to `createClerkClient` must be changed to `secretKey`.
+
+```diff
+import { createClerkClient } from '@clerk/nextjs/server';
+
+- createClerkClient({ apiKey: '...' });
++ createClerkClient({ secretKey: '...' });
+```

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

@@ -0,0 +1,15 @@
+---
+title: '`frontendApi` -> `publishableKey` as param to `createClerkClient`'
+matcher: "createClerkClient\\({[\\s\\S]*?frontendApi:[\\s\\S]*?}\\)"
+category: 'deprecation-removal'
+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.
+
+```diff
+import { createClerkClient } from '@clerk/nextjs/server';
+
+- createClerkClient({ frontendApi: '...' });
++ createClerkClient({ publishableKey: '...' });
+```

package/dist/versions/v5/nextjs/createisomorphicrequest-import-change.md

@@ -0,0 +1,14 @@
+---
+title: '`createIsomorphicRequest` import moved under `/server`'
+matcher: "import\\s+{[\\s\\S]*?createIsomorphicRequest[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+category: 'top-level-imports'
+replaceWithString: 'nextjs/server'
+---
+
+The `createIsomorphicRequest` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/server`, as this is a helper that should be only used on the server side. 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 { createIsomorphicRequest } from "@clerk/nextjs"
++ import { createIsomorphicRequest } from "@clerk/nextjs/server"
+```

package/dist/versions/v5/nextjs/currentuser-import-change.md

@@ -0,0 +1,14 @@
+---
+title: '`currentUser` import moved under `/server`'
+matcher: "import\\s+{[\\s\\S]*?currentUser[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+category: 'top-level-imports'
+replaceWithString: 'nextjs/server'
+---
+
+The `currentUser` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/server`, as this is a helper that should be only used on the server side. 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 { currentUser } from "@clerk/nextjs"
++ import { currentUser } from "@clerk/nextjs/server"
+```

package/dist/versions/v5/nextjs/decodejwt-import-change.md

@@ -0,0 +1,14 @@
+---
+title: '`decodeJwt` import moved under `/server`'
+matcher: "import\\s+{[\\s\\S]*?decodeJwt[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+category: 'top-level-imports'
+replaceWithString: 'nextjs/server'
+---
+
+The `decodeJwt` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/server`, as this is a helper that should be only used on the server side. 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 { decodeJwt } from "@clerk/nextjs"
++ import { decodeJwt } from "@clerk/nextjs/server"
+```

package/dist/versions/v5/nextjs/emaillinkerrorcode-import-change.md

@@ -0,0 +1,14 @@
+---
+title: '`EmailLinkErrorCode` import moved under `/errors`'
+matcher: "import\\s+{[\\s\\S]*?EmailLinkErrorCode[\\s\\S]*?from\\s+['\"]@clerk\\/(nextjs)[\\s\\S]*?['\"]"
+matcherFlags: 'm'
+category: 'top-level-imports'
+replaceWithString: 'nextjs/errors'
+---
+
+The `EmailLinkErrorCode` import path has changed from `@clerk/nextjs` to `@clerk/nextjs/errors`. 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 { EmailLinkErrorCode } from "@clerk/nextjs"
++ import { EmailLinkErrorCode } from "@clerk/nextjs/errors"
+```

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

@@ -0,0 +1,13 @@
+---
+title: '`apiKey` -> `secretKey` as param to `getAuth`'
+matcher: "getAuth\\({[\\s\\S]*?apiKey:[\\s\\S]*?}\\)"
+category: 'deprecation-removal'
+matcherFlags: 'm'
+---
+
+The `apiKey` argument passed to `getAuth` must be changed to `secretKey`.
+
+```diff
+- getAuth({ apiKey: '...' })
++ getAuth({ secretKey: '...' })
+```

package/dist/versions/v5/nextjs/import-api-url.md

@@ -0,0 +1,8 @@
+---
+title: '`API_URL` constant removed'
+matcher: "import\\s+{[\\s\\S]*?API_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`. Instead, set and use the `CLERK_API_URL` environment variable.

package/dist/versions/v5/nextjs/import-api-version.md

@@ -0,0 +1,8 @@
+---
+title: '`API_VERSION` constant removed'
+matcher: "import\\s+{[\\s\\S]*?API_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`. Instead, set and use the `CLERK_API_VERSION` environment variable.

package/dist/versions/v5/nextjs/import-clerk-js-url.md

@@ -0,0 +1,8 @@
+---
+title: '`CLERK_JS_URL` constant removed'
+matcher: "import\\s+{[\\s\\S]*?CLERK_JS_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`. Instead, set and use the `NEXT_PUBLIC_CLERK_JS` environment variable.

package/dist/versions/v5/nextjs/import-clerk-js-version.md

@@ -0,0 +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`. Instead, set and use the `NEXT_PUBLIC_CLERK_JS_VERSION` environment variable.

package/dist/versions/v5/nextjs/import-domain.md

@@ -0,0 +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`. Instead, set and use the `NEXT_PUBLIC_CLERK_DOMAIN` environment variable.

package/dist/versions/v5/nextjs/import-is-satellite.md

@@ -0,0 +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`. Instead, set and use the `NEXT_PUBLIC_CLERK_IS_SATELLITE` environment variable.

package/dist/versions/v5/nextjs/import-nextjs-api.md

@@ -0,0 +1,21 @@
+---
+title: '`@clerk/nextjs/api` import removed'
+category: 'deprecation-removal'
+matcher: "@clerk\\/nextjs\\/api"
+---
+
+The import subpath `@clerk/nextjs/api` has been removed. This includes the following imports:
+
+```js
+// These have been removed
+import {
+  ClerkMiddleware,
+  ClerkMiddlewareOptions,
+  LooseAuthProp,
+  RequireAuthProp,
+  StrictAuthProp,
+  WithAuthProp,
+} from '@clerk/nextjs/api';
+```
+
+If you still need to use any of these functions, they can be instead imported from `@clerk/clerk-sdk-node`.

package/dist/versions/v5/nextjs/import-nextjs-app-beta.md

@@ -0,0 +1,11 @@
+---
+title: '`@clerk/nextjs/app-beta` import removed'
+category: 'deprecation-removal'
+matcher: "@clerk\\/nextjs\\/app-beta"
+---
+
+If you are using the `@clerk/nextjs/app-beta` import anywhere, it should use `@clerk/nextjs` instead. The `app-beta` import has been removed as our approuter support is stable, if there are any places you’re using it you can remove.
+
+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.

package/dist/versions/v5/nextjs/import-nextjs-edge-middleware.md

@@ -0,0 +1,7 @@
+---
+title: '`@clerk/nextjs/edge-middleware` import removed'
+category: 'deprecation-removal'
+matcher: "@clerk\\/nextjs\\/edge-middleware"
+---
+
+This deprecated import has been replaced by `@clerk/nextjs`. Usage should now look as such: `import { authMiddleware } from @clerk/nextjs`. There may be changes in functionality between the two exports depending on how old the version used is, so upgrade with caution.

package/dist/versions/v5/nextjs/import-nextjs-edge-middlewarefiles.md

@@ -0,0 +1,7 @@
+---
+title: '`@clerk/nextjs/edge-middlewarefiles` import removed'
+category: 'deprecation-removal'
+matcher: "@clerk\\/nextjs\\/edge-middlewarefiles"
+---
+
+This deprecated import has been replaced by `@clerk/nextjs`. Usage should now look as such: `import { authMiddleware } from @clerk/nextjs`. There may be changes in functionality between the two exports depending on how old the version used is, so upgrade with caution.

package/dist/versions/v5/nextjs/import-nextjs-ssr.md

@@ -0,0 +1,8 @@
+---
+title: '`@clerk/nextjs/ssr` import removed'
+matcher: "@clerk\\/nextjs\\/ssr"
+category: 'deprecation-removal'
+replaceWithString: '@clerk/nextjs'
+---
+
+If you are importing from `@clerk/nextjs/ssr`, you can use `@clerk/nextjs` instead. Our top-level import supports SSR functionality by default now, so the subpath on the import is no longer needed. This import can be directly replaced without any other considerations.

package/dist/versions/v5/nextjs/import-proxy-url.md

@@ -0,0 +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`. Instead, set and use the `NEXT_PUBLIC_CLERK_PROXY_URL` environment variable.

package/dist/versions/v5/nextjs/import-publishable-key.md

@@ -0,0 +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`. Instead, set and use the `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` environment variable.

package/dist/versions/v5/nextjs/import-secret-key.md

@@ -0,0 +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`. Instead, set and use the `CLERK_SECRET_KEY` environment variable.

package/dist/versions/v5/nextjs/import-sign-in-url.md

@@ -0,0 +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`. Instead, set and use the `NEXT_PUBLIC_CLERK_SIGN_IN_URL` environment variable.