Add SDK-specificity to Authentication flows, User management, and Session management sections

docs/_partials/authenticate-req.mdx

@@ -2,17 +2,22 @@
 import { createClerkClient } from '@clerk/backend'
 
 export async function GET(req: Request) {
+  // Initialize the JS Backend SDK
+  // This varies depending on the SDK you're using
+  // https://clerk.com/docs/js-backend/getting-started/quickstart
   const clerkClient = createClerkClient({
     secretKey: process.env.CLERK_SECRET_KEY,
     publishableKey: process.env.CLERK_PUBLISHABLE_KEY,
   })
 
-  const { isSignedIn } = await clerkClient.authenticateRequest(req, {
-    jwtKey: process.env.CLERK_JWT_KEY,
+  // Use the `authenticateRequest()` method to verify the token
+  const { isAuthenticated } = await clerkClient.authenticateRequest(req, {
     authorizedParties: ['https://example.com'],
+    jwtKey: process.env.CLERK_JWT_KEY,
   })
 
-  if (!isSignedIn) {
+  // Protect the route from unauthenticated users
+  if (!isAuthenticated) {
     return Response.json({ status: 401 })
   }
 

docs/_partials/backend/usage.mdx

@@ -1,2 +1,2 @@
 > [!NOTE]
-> Importing `clerkClient` varies based on your framework. Refer to the [JS Backend SDK overview](/docs/js-backend/getting-started/quickstart) for usage details, including guidance on [how to access the `userId` and other properties](/docs/js-backend/getting-started/quickstart#get-the-user-id-and-other-properties).
+> Using `clerkClient` varies based on your framework. Refer to the [JS Backend SDK overview](/docs/js-backend/getting-started/quickstart) for usage details, including guidance on [how to access the `userId` and other properties](/docs/js-backend/getting-started/quickstart#get-the-user-id-and-other-properties).

docs/_partials/create-invitation.mdx

@@ -0,0 +1,123 @@
+<Tabs items={["Next.js", "Astro", "Express", "React Router", "Tanstack React Start"]}>
+  <Tab>
+    ```ts {{ filename: 'app/api/example/route.ts' }}
+    import { clerkClient } from '@clerk/nextjs/server'
+    import { NextResponse } from 'next/server'
+
+    export async function GET() {
+      try {
+        const client = await clerkClient()
+        const invitation = await client.invitations.createInvitation({
+          emailAddress: '[email protected]',
+          redirectUrl: 'https://www.example.com/my-sign-up',
+          publicMetadata: {
+            example: 'metadata',
+            example_nested: {
+              nested: 'metadata',
+            },
+          },
+        })
+        return NextResponse.json({ message: 'Invitation created', invitation })
+      } catch (error) {
+        console.log(error)
+        return NextResponse.json({ error: 'Error creating invitation' })
+      }
+    }
+    ```
+  </Tab>
+
+  <Tab>
+    ```tsx {{ filename: 'src/api/example.ts' }}
+    import type { APIRoute } from 'astro'
+    import { clerkClient } from '@clerk/astro/server'
+
+    export const GET: APIRoute = async (context) => {
+      await clerkClient(context).invitations.createInvitation({
+        emailAddress: '[email protected]',
+        redirectUrl: 'https://www.example.com/my-sign-up',
+        publicMetadata: {
+          example: 'metadata',
+          example_nested: {
+            nested: 'metadata',
+          },
+        },
+      })
+
+      return new Response(JSON.stringify({ success: true }), { status: 200 })
+    }
+    ```
+  </Tab>
+
+  <Tab>
+    ```ts {{ filename: 'public.ts' }}
+    import { getAuth, clerkClient } from '@clerk/express'
+
+    app.post('/createUser', async (req, res) => {
+      await clerkClient.invitations.createInvitation({
+        emailAddress: '[email protected]',
+        redirectUrl: 'https://www.example.com/my-sign-up',
+        publicMetadata: {
+          example: 'metadata',
+          example_nested: {
+            nested: 'metadata',
+          },
+        },
+        password: 'password',
+      })
+
+      res.status(200).json({ success: true })
+    })
+    ```
+  </Tab>
+
+  <Tab>
+    ```tsx {{ filename: 'app/routes/example.tsx' }}
+    import { clerkClient } from '@clerk/react-router/server'
+    import type { Route } from './+types/example'
+
+    export async function loader(args: Route.LoaderArgs) {
+      await clerkClient.invitations.createInvitation({
+        emailAddress: '[email protected]',
+        redirectUrl: 'https://www.example.com/my-sign-up',
+        publicMetadata: {
+          example: 'metadata',
+          example_nested: {
+            nested: 'metadata',
+          },
+        },
+      })
+
+      return { success: true }
+    }
+    ```
+  </Tab>
+
+  <Tab>
+    ```tsx {{ filename: 'app/routes/api/example.tsx' }}
+    import { json } from '@tanstack/react-start'
+    import { createFileRoute } from '@tanstack/react-router'
+    import { clerkClient } from '@clerk/tanstack-react-start/server'
+
+    export const ServerRoute = createFileRoute('/api/example')({
+      server: {
+        handlers: {
+          GET: async () => {
+            await clerkClient().invitations.createInvitation({
+              emailAddress: '[email protected]',
+              redirectUrl: 'https://www.example.com/my-sign-up',
+              publicMetadata: {
+                example: 'metadata',
+                example_nested: {
+                  nested: 'metadata',
+                },
+              },
+            })
+
+            return json({ success: true })
+          },
+        },
+      },
+    })
+    ```
+  </Tab>
+</Tabs>

docs/_partials/create-user.mdx

@@ -0,0 +1,92 @@
+<Tabs items={["Next.js", "Astro", "Express", "React Router", "Tanstack React Start"]}>
+  <Tab>
+    ```ts {{ filename: 'app/api/example/route.ts' }}
+    import { auth, clerkClient } from '@clerk/nextjs/server'
+    import { NextResponse } from 'next/server'
+
+    export async function GET() {
+      try {
+        const client = await clerkClient()
+        const user = await client.users.createUser({
+          emailAddress: ['[email protected]'],
+          password: 'password',
+        })
+        return NextResponse.json({ message: 'User created', user })
+      } catch (error) {
+        console.log(error)
+        return NextResponse.json({ error: 'Error creating user' })
+      }
+    }
+    ```
+  </Tab>
+
+  <Tab>
+    ```tsx {{ filename: 'src/api/example.ts' }}
+    import type { APIRoute } from 'astro'
+    import { clerkClient } from '@clerk/astro/server'
+
+    export const GET: APIRoute = async (context) => {
+      await clerkClient(context).users.createUser({
+        emailAddress: ['[email protected]'],
+        password: 'password',
+      })
+
+      return new Response(JSON.stringify({ success: true }), { status: 200 })
+    }
+    ```
+  </Tab>
+
+  <Tab>
+    ```ts {{ filename: 'public.ts' }}
+    import { getAuth, clerkClient } from '@clerk/express'
+
+    app.post('/createUser', async (req, res) => {
+      await clerkClient.users.createUser({
+        emailAddress: ['[email protected]'],
+        password: 'password',
+      })
+
+      res.status(200).json({ success: true })
+    })
+    ```
+  </Tab>
+
+  <Tab>
+    ```tsx {{ filename: 'app/routes/example.tsx' }}
+    import { clerkClient, getAuth } from '@clerk/react-router/server'
+    import type { Route } from './+types/example'
+
+    export async function loader(args: Route.LoaderArgs) {
+      await clerkClient.users.createUser({
+        emailAddress: ['[email protected]'],
+        password: 'password',
+      })
+
+      return { success: true }
+    }
+    ```
+  </Tab>
+
+  <Tab>
+    ```tsx {{ filename: 'app/routes/api/example.tsx' }}
+    import { json } from '@tanstack/react-start'
+    import { createFileRoute } from '@tanstack/react-router'
+    import { clerkClient } from '@clerk/tanstack-react-start/server'
+
+    export const ServerRoute = createFileRoute('/api/example')({
+      server: {
+        handlers: {
+          GET: async () => {
+            await clerkClient().users.createUser({
+              emailAddress: ['[email protected]'],
+              password: 'my-secure-password',
+            })
+
+            return json({ success: true })
+          },
+        },
+      },
+    })
+    ```
+  </Tab>
+</Tabs>

docs/_partials/delete-user.mdx

@@ -0,0 +1,82 @@
+<Tabs items={["Next.js", "Astro", "Express", "React Router", "Tanstack React Start"]}>
+  <Tab>
+    ```ts {{ filename: 'app/api/example/route.ts' }}
+    import { auth, clerkClient } from '@clerk/nextjs/server'
+    import { NextResponse } from 'next/server'
+
+    export async function GET() {
+      const { userId } = await auth()
+
+      await clerkClient.users.deleteUser(userId)
+
+      return NextResponse.json({ success: true })
+    }
+    ```
+  </Tab>
+
+  <Tab>
+    ```tsx {{ filename: 'src/api/example.ts' }}
+    import type { APIRoute } from 'astro'
+    import { clerkClient } from '@clerk/astro/server'
+
+    export const GET: APIRoute = async (context) => {
+      const { userId } = context.locals.auth()
+
+      await clerkClient(context).users.deleteUser(userId)
+
+      return new Response(JSON.stringify({ success: true }), { status: 200 })
+    }
+    ```
+  </Tab>
+
+  <Tab>
+    ```ts {{ filename: 'public.ts' }}
+    import { getAuth, clerkClient } from '@clerk/express'
+
+    app.post('/deleteUser', async (req, res) => {
+      const { userId } = getAuth(req)
+
+      await clerkClient.users.deleteUser(userId)
+
+      res.status(200).json({ success: true })
+    })
+    ```
+  </Tab>
+
+  <Tab>
+    ```tsx {{ filename: 'app/routes/example.tsx' }}
+    import { clerkClient, getAuth } from '@clerk/react-router/server'
+    import type { Route } from './+types/example'
+
+    export async function loader(args: Route.LoaderArgs) {
+      const { userId } = await getAuth(args)
+
+      await clerkClient.users.deleteUser(userId)
+
+      return { success: true }
+    }
+    ```
+  </Tab>
+
+  <Tab>
+    ```tsx {{ filename: 'app/routes/api/example.tsx' }}
+    import { json } from '@tanstack/react-start'
+    import { createFileRoute } from '@tanstack/react-router'
+    import { auth, clerkClient } from '@clerk/tanstack-react-start/server'
+
+    export const ServerRoute = createFileRoute('/api/example')({
+      server: {
+        handlers: {
+          GET: async () => {
+            const { userId } = await auth()
+
+            await clerkClient().users.deleteUser(userId)
+
+            return json({ success: true })
+          },
+        },
+      },
+    })
+    ```
+  </Tab>
+</Tabs>