wip

docs/_partials/reverification-route-handler.mdx → docs/_partials/nextjs/reverification-route-handler.mdx

@@ -1,4 +1,4 @@
-The following example uses the [`has()`](/docs/references/nextjs/auth-object#has) helper to check if the user has verified their credentials within a specific time period. The `strict` configuration sets the time period to 10 minutes. If the user hasn't verified their credentials within 10 minutes, the `reverificationErrorResponse` utility is used to return an error.
+The following example uses the [`has()`](/docs/references/backend/types/auth-object#has) helper to check if the user has verified their credentials within a specific time period. The `strict` configuration sets the time period to 10 minutes. If the user hasn't verified their credentials within 10 minutes, the `reverificationErrorResponse` utility is used to return an error.
 
 ```tsx {{ filename: 'app/api/reverification-example/route.ts' }}
 import { auth, reverificationErrorResponse } from '@clerk/nextjs/server'

docs/backend-requests/handling/js-backend-sdks.mdx

@@ -7,7 +7,7 @@ To handle authenticated requests, use one of the following JS Backend SDKs.
 
 ## Clerk Express SDK
 
-The `clerkMiddleware()` function checks the request's cookies and headers for a session JWT. If the user has a valid session, the `clerkMiddleware()` function attaches the [properties](/docs/references/nextjs/auth-object#auth-object-properties) of the authenticated user to the request object.
+The `clerkMiddleware()` function checks the request's cookies and headers for a session JWT. If the user has a valid session, the `clerkMiddleware()` function attaches the [properties](/docs/references/backend/types/auth-object#auth-object-properties) of the authenticated user to the request object.
 
 ```js
 import { clerkMiddleware } from '@clerk/express'
@@ -25,7 +25,7 @@ For more information on the Middleware functions and SDK features, see the [Expr
 
 ## Clerk Fastify SDK
 
-The `clerkPlugin` checks the request's cookies and headers for a session JWT. If the user has a valid session, the `clerkPlugin` attaches the [properties](/docs/references/nextjs/auth-object#auth-object-properties) of the authenticated user to the request object.
+The `clerkPlugin` checks the request's cookies and headers for a session JWT. If the user has a valid session, the `clerkPlugin` attaches the [properties](/docs/references/backend/types/auth-object#auth-object-properties) of the authenticated user to the request object.
 
 ```ts
 import 'dotenv/config'

docs/backend-requests/making/custom-session-token.mdx

@@ -24,7 +24,7 @@ This guide will show you how to customize a session token to include additional
 
   ## Use the custom claims in your application
 
-  The [`Auth`](/docs/references/nextjs/auth-object) object includes a `sessionClaims` property that contains the custom claims you added to your session token. It's returned by the [`useAuth()`](/docs/references/react/use-auth) hook, the [`auth()`](/docs/references/nextjs/auth) and `getAuth()` helpers, and the `request` object in server contexts.
+  The [`Auth`](/docs/references/backend/types/auth-object) object includes a `sessionClaims` property that contains the custom claims you added to your session token. It's returned by the [`auth()`](/docs/references/nextjs/auth) and `getAuth()` helpers, and the `request` object in server contexts.
 
   The following example demonstrates how to access the `fullName` and `primaryEmail` claims that were added to the session token in the last step. This examples are written for Next.js, but they can be adapted to other frameworks by using the appropriate method for accessing the `Auth` object.
 

docs/backend-requests/making/jwt-templates.mdx

@@ -171,7 +171,7 @@ To create a JWT template:
 
 ## Generate a JWT
 
-To generate a token using a template, you can use the `getToken()` method. See the [reference documentation](/docs/references/nextjs/auth-object#get-token) for more information and example usage.
+To generate a token using a template, you can use the `getToken()` method. See the [reference documentation](/docs/references/backend/types/auth-object#get-token) for more information and example usage.
 
 ## Complete example
 

docs/customization/user-button.mdx

@@ -457,7 +457,7 @@ With the above example, the `<UserButton />` menu items will be in the following
 
 ## Conditionally render menu items
 
-To conditionally render menu items based on a user's role or permissions, you can use the [`has()`](/docs/references/nextjs/auth-object#has) helper function:
+To conditionally render menu items based on a user's role or permissions, you can use the [`has()`](/docs/references/backend/types/auth-object#has) helper function:
 
 <Tabs items={["Next.js", "Astro"]}>
   <Tab>

docs/guides/force-organizations.mdx

@@ -72,7 +72,7 @@ This guide will be written for Next.js applications using App Router, but the sa
 
   ### Detect an active organization
 
-  A session will always include an `orgId` via the [`Auth` object](/docs/references/nextjs/auth-object#auth-object-example-with-active-organization). This can be used to detect if a user has an active organization.
+  A session will always include an `orgId` via the [`Auth` object](/docs/references/backend/types/auth-object#auth-object-example-with-active-organization). This can be used to detect if a user has an active organization.
 
   <Tabs items={["App Router Server Component", "App Router Client Component"]}>
     <Tab>

docs/guides/reverification.mdx

@@ -16,11 +16,11 @@ To implement reverification, you need to handle it both on the server- and clien
 
 ### Handle reverification server-side
 
-To handle reverification server-side, use the [`auth.has()`](/docs/references/nextjs/auth-object#has) helper to check if the user has verified their credentials within a specific time period. Pass a [configuration](#supported-verification-configurations) to set the time period you would like. If the user hasn't verified their credentials within that time period, return either `reverificationError` or `reverificationErrorResponse`, depending on the framework you're using. Use the following tabs to see examples for different frameworks.
+To handle reverification server-side, use the [`auth.has()`](/docs/references/backend/types/auth-object#has) helper to check if the user has verified their credentials within a specific time period. Pass a [configuration](#supported-verification-configurations) to set the time period you would like. If the user hasn't verified their credentials within that time period, return either `reverificationError` or `reverificationErrorResponse`, depending on the framework you're using. Use the following tabs to see examples for different frameworks.
 
 <Tabs items={["Next.js Server Action", "Next.js Route Handler", "Ruby on Rails", "Other"]}>
   <Tab>
-    The following example uses the [`has()`](/docs/references/nextjs/auth-object#has) helper to check if the user has verified their credentials within a specific time period. The `strict` configuration sets the time period to 10 minutes. If the user hasn't verified their credentials within 10 minutes, the `reverificationError` utility is used to return an error.
+    The following example uses the [`has()`](/docs/references/backend/types/auth-object#has) helper to check if the user has verified their credentials within a specific time period. The `strict` configuration sets the time period to 10 minutes. If the user hasn't verified their credentials within 10 minutes, the `reverificationError` utility is used to return an error.
 
     ```ts {{ filename: 'app/actions.ts' }}
     'use server'
@@ -45,7 +45,7 @@ To handle reverification server-side, use the [`auth.has()`](/docs/references/ne
   </Tab>
 
   <Tab>
-    <Include src="_partials/reverification-route-handler" />
+    <Include src="_partials/nextjs/reverification-route-handler" />
   </Tab>
 
   <Tab>
@@ -189,7 +189,7 @@ The following example demonstrates how to use the [`useReverification()`](/docs/
 
 ## Supported reverification configurations
 
-To define the time period of the reverification check, you can pass the one of the following configurations to the `has()` helper: `strict_mfa`, `strict`, `moderate`, and `lax`. See the [`has()` reference doc](/docs/references/nextjs/auth-object#check-authorization-params-with-custom-permissions) for more details.
+To define the time period of the reverification check, you can pass the one of the following configurations to the `has()` helper: `strict_mfa`, `strict`, `moderate`, and `lax`. See the [`has()` reference doc](/docs/references/backend/types/auth-object#check-authorization-params-with-custom-permissions) for more details.
 
 ## Caveats
 

docs/manifest.json

@@ -1828,10 +1828,6 @@
                           "title": "`clerkMiddleware()`",
                           "wrap": false,
                           "href": "/docs/references/nextjs/clerk-middleware"
-                        },
-                        {
-                          "title": "Auth Object",
-                          "href": "/docs/references/nextjs/auth-object"
                         }
                       ]
                     ]
@@ -3182,8 +3178,8 @@
                     "items": [
                       [
                         {
-                          "title": "`PaginatedResourceResponse`",
-                          "href": "/docs/references/backend/types/paginated-resource-response"
+                          "title": "`Auth` object",
+                          "href": "/docs/references/backend/types/auth-object"
                         },
                         {
                           "title": "Backend `AllowlistIdentifier` object",
@@ -3220,6 +3216,10 @@
                         {
                           "title": "Backend `User` object",
                           "href": "/docs/references/backend/types/backend-user"
+                        },
+                        {
+                          "title": "`PaginatedResourceResponse`",
+                          "href": "/docs/references/backend/types/paginated-resource-response"
                         }
                       ]
                     ]

docs/organizations/org-slugs-in-urls.mdx

@@ -227,7 +227,7 @@ This guide shows you how to add organization slugs to your app's URLs, configure
 
   <Tabs items={["Server-side","Client-side"]}>
     <Tab>
-      To get organization information on the server-side, access the [`Auth`](/docs/references/nextjs/auth-object) object. In Next.js apps, this object is returned by [`auth()`](/docs/references/nextjs/auth). In other frameworks, use the [`getAuth()`](/docs/references/nextjs/get-auth) helper to get the `Auth` object.
+      To get organization information on the server-side, access the [`Auth`](/docs/references/backend/types/auth-object) object. In Next.js apps, this object is returned by [`auth()`](/docs/references/nextjs/auth). In other frameworks, use the [`getAuth()`](/docs/references/nextjs/get-auth) helper to get the `Auth` object.
 
       To access additional organization information like the organization name, you'll need to [customize the Clerk session token](/docs/backend-requests/making/custom-session-token) to include these details:
 
@@ -241,7 +241,7 @@ This guide shows you how to add organization slugs to your app's URLs, configure
          ```
       1. Select **Save**.
 
-      You can now access the [`sessionClaims`](/docs/references/nextjs/auth-object#:~:text=sessionClaims)
+      Then, access the [`sessionClaims`](/docs/references/backend/types/auth-object#:~:text=sessionClaims)
       on the `Auth` object.
 
       ```tsx {{ filename: 'app/orgs/[slug]/page.tsx', mark: [[23, 24]] }}

docs/organizations/roles-permissions.mdx

@@ -45,11 +45,11 @@ When a user creates a new organization, that user is automatically added as the
 
 Permissions grant users privileged access to resources and operations, like creating and deleting. Clerk supports two types of permissions: System and Custom.
 
-### System Permissions
+### System permissions
 
-Clerk has a set of System Permissions that power [Clerk’s Frontend API](/docs/reference/frontend-api){{ target: '_blank' }} and [organization-related Clerk components](/docs/components/overview#organization-components). They are a baseline set of permissions that Clerk needs to operate functionally.
+Clerk has a set of system permissions that power [Clerk's Frontend API](/docs/reference/frontend-api){{ target: '_blank' }} and [organization-related Clerk components](/docs/components/overview#organization-components). They are a baseline set of permissions that Clerk needs to operate functionally.
 
-Clerk’s System Permissions consist of the following:
+Clerk’s system permissions consist of the following:
 
 - Manage Organization (`org:sys_profile:manage`)
 - Delete Organization (`org:sys_profile:delete`)
@@ -58,7 +58,7 @@ Clerk’s System Permissions consist of the following:
 - Read domains (`org:sys_domains:read`)
 - Manage domains (`org:sys_domains:manage`)
 
-You can assign these System Permissions to any role.
+You can assign these system permissions to any role.
 
 > [!WARNING]
 > System permissions are not included in session claims. To do permission-checks on the server-side, you must [create custom permissions](/docs/organizations/create-roles-permissions).

docs/organizations/verify-user-permissions.mdx

@@ -14,7 +14,7 @@ Clerk enables two broad approaches to role and permissions-based authorization:
    - Use the [`<Protect>`](/docs/components/protect) component to prevent content from rendering if the active user is unauthorized.
    - Call [`auth.protect()`](/docs/references/nextjs/auth#protect) to throw a `404` error if the active user is unauthorized.
 1. If you would like more control over the response when a user is unauthorized, you can:
-   - Call the [`has()`](/docs/references/nextjs/auth-object#has) helper, which returns `false` if the active user lacks the role or permissions you're checking for. You can _choose_ how your app responds instead of immediately preventing content from rendering or throwing an error.
+   - Call the [`has()`](/docs/references/backend/types/auth-object#has) helper, which returns `false` if the active user lacks the role or permissions you're checking for. You can _choose_ how your app responds instead of immediately preventing content from rendering or throwing an error.
 
 ## Authorization in Client Components
 
@@ -261,7 +261,7 @@ The following examples work for both SSR and CSR.
 
 ## Authorization in Remix Loaders
 
-The following example uses the [`has()`](/docs/references/nextjs/auth-object#has) helper to check if the user has the correct permission. If the user is not authorized, `has()` will return false, causing the loader to redirect the user to the `/request-access` route.
+The following example uses the [`has()`](/docs/references/backend/types/auth-object#has) helper to check if the user has the correct permission. If the user is not authorized, `has()` will return false, causing the loader to redirect the user to the `/request-access` route.
 
 <Tabs items={["Remix"]}>
   <Tab>

docs/quickstarts/express.mdx

@@ -90,7 +90,7 @@ Learn how to integrate Clerk into your Express backend for secure user authentic
 
   ## Add `clerkMiddleware()` to your application
 
-  The [`clerkMiddleware()`](/docs/references/express/overview#clerk-middleware) function checks the request's cookies and headers for a session JWT and, if found, attaches the [`Auth`](/docs/references/nextjs/auth-object#auth-object){{ target: '_blank' }} object to the `request` object under the `auth` key.
+  The [`clerkMiddleware()`](/docs/references/express/overview#clerk-middleware) function checks the request's cookies and headers for a session JWT and, if found, attaches the [`Auth`](/docs/references/backend/types/auth-object#auth-object){{ target: '_blank' }} object to the `request` object under the `auth` key.
 
   ```ts {{ filename: 'index.ts', mark: [3, 7] }}
   import 'dotenv/config'

docs/references/astro/clerk-middleware.mdx

@@ -56,7 +56,7 @@ export const onRequest = clerkMiddleware((auth, context) => {
 
 ### Protect routes based on user authorization status
 
-To protect routes based on user authorization status, use [`auth().has()`](/docs/references/nextjs/auth-object#has){{ target: '_blank' }} to check if the user has the required roles or permissions.
+To protect routes based on user authorization status, use [`auth().has()`](/docs/references/backend/types/auth-object#has){{ target: '_blank' }} to check if the user has the required roles or permissions.
 
 ```tsx {{ filename: 'src/middleware.ts' }}
 import { clerkMiddleware, createRouteMatcher } from '@clerk/astro/server'

docs/references/astro/endpoints.mdx

@@ -27,7 +27,7 @@ export async function GET({ locals }) {
 
 Clerk provides integrations with a number of popular databases.
 
-To retrieve a token from a JWT template and fetch data from an external source, use the [`getToken()`](/docs/references/nextjs/auth-object#get-token){{ target: '_blank' }} method from the [`auth()` local](/docs/references/astro/locals), as shown in the following example:
+To retrieve a token from a JWT template and fetch data from an external source, use the [`getToken()`](/docs/references/backend/types/auth-object#get-token){{ target: '_blank' }} method from the [`auth()` local](/docs/references/astro/locals), as shown in the following example:
 
 ```ts {{ filename: 'src/pages/api/route.ts' }}
 export async function GET({ locals }) {

docs/references/astro/locals.mdx

@@ -3,11 +3,11 @@ title: Locals
 description: Learn how to authenticate your Astro application with Clerk using locals.
 ---
 
-Through Astro [`locals`](https://docs.astro.build/en/guides/middleware/#storing-data-in-contextlocals), Clerk's [`Auth`](/docs/references/nextjs/auth-object){{ target: '_blank' }} and current [`User`](/docs/references/javascript/user/user){{ target: '_blank' }} objects can be accessed between middlewares and pages. These locals are injected when you install the provided [middleware](/docs/references/astro/clerk-middleware).
+Through Astro [`locals`](https://docs.astro.build/en/guides/middleware/#storing-data-in-contextlocals), Clerk's [`Auth`](/docs/references/backend/types/auth-object){{ target: '_blank' }} and current [`User`](/docs/references/javascript/user/user){{ target: '_blank' }} objects can be accessed between middlewares and pages. These locals are injected when you install the provided [middleware](/docs/references/astro/clerk-middleware).
 
 The following guide provides examples of using the [`auth()`](/docs/references/nextjs/auth){{ target: '_blank' }} local to validate an authenticated user and the [`currentUser()`](/docs/references/nextjs/current-user){{ target: '_blank' }} local to access the [`Backend API User`](/docs/references/backend/types/backend-user){{ target: '_blank' }} object for the authenticated user.
 
-## Protect your pages
+## `locals.auth()`
 
 You can use the `auth()` local to protect your pages and forms. It will return the current user's ID if they are signed in, or `null` if they are not. For more information on `auth()`, see the [reference](/docs/references/nextjs/auth){{ target: '_blank' }}.
 
@@ -43,7 +43,7 @@ You can use the `auth()` local to protect your pages and forms. It will return t
   ```
 </CodeBlockTabs>
 
-## Accessing the current user
+## `locals.currentUser()`
 
 Current user data is important for data enrichment. You can use the `currentUser()` local to fetch the current user's data in your pages.
 

docs/references/astro/overview.mdx

@@ -36,7 +36,7 @@ The Astro SDK provides access to Clerk's authentication data through Astro's [`l
 
 #### `Auth` object
 
-`Astro.locals.auth()` returns an `Auth` object. This JavaScript object contains important information like session data, your user's ID, as well as their active organization ID. Learn more about the `Auth` object [here](/docs/references/nextjs/auth-object){{ target: '_blank' }}.
+`Astro.locals.auth()` returns an `Auth` object. This JavaScript object contains important information like session data, your user's ID, as well as their active organization ID. Learn more about the `Auth` object [here](/docs/references/backend/types/auth-object){{ target: '_blank' }}.
 
 ### `clerkMiddleware()`
 

docs/references/backend/overview.mdx

@@ -351,7 +351,7 @@ The following options are available:
 
 ## Get the `userId` and other properties
 
-To access the [properties](/docs/references/nextjs/auth-object#auth-object-properties) of the authenticated user, such as their `userId` or `sessionId`, see the following examples:
+To access the [properties](/docs/references/backend/types/auth-object#auth-object-properties) of the authenticated user, such as their `userId` or `sessionId`, see the following examples:
 
 <Tabs items={["Next.js", "Backend SDKs"]}>
   <Tab>