Merge branch 'main' into patch-1

.changeset/friendly-nails-nail.md

@@ -0,0 +1,5 @@
+---
+"@clerk/localizations": patch
+---
+
+pl-PL localization updates

.changeset/real-boats-promise.md

@@ -0,0 +1,5 @@
+---
+"@clerk/upgrade": minor
+---
+
+Enhancing error handling throughout the SDK upgrade flow

.changeset/twelve-frogs-study.md

@@ -0,0 +1,5 @@
+---
+"@clerk/express": patch
+---
+
+Expose `AuthObject` type helper

.github/workflows/ci.yml

@@ -115,7 +115,7 @@ jobs:
         run: |
           if [ "${{ matrix.node-version }}" == "18" ]; then
             echo "Running tests on Node 18 only for packages with LTS support."
-            npx turbo test $TURBO_ARGS --filter="@clerk/astro" --filter="@clerk/backend" --filter="@clerk/express" --filter="@clerk/nextjs" --filter="@clerk/clerk-react" --filter="@clerk/fastify" --filter="@clerk/clerk-sdk-node" --filter="@clerk/shared" --filter="@clerk/remix" --filter="@clerk/tanstack-start" --filter="@clerk/elements"
+            npx turbo test $TURBO_ARGS --filter="@clerk/astro" --filter="@clerk/backend" --filter="@clerk/express" --filter="@clerk/nextjs" --filter="@clerk/clerk-react" --filter="@clerk/clerk-sdk-node" --filter="@clerk/shared" --filter="@clerk/remix" --filter="@clerk/tanstack-start" --filter="@clerk/elements"
           else
             echo "Running tests for all packages on Node 20."
             npx turbo test $TURBO_ARGS

.github/workflows/major-version-check.yml

@@ -1,6 +1,7 @@
 name: Major Version Check
 
 on:
+  workflow_dispatch:
   pull_request:
     types: [opened, edited, synchronize]
   issue_comment:
@@ -20,7 +21,7 @@ jobs:
         uses: actions/github-script@v7
         with:
           script: |
-            const prNumber = context.payload.pull_request.number;
+            const prNumber = context.payload?.pull_request?.number || context.payload?.issue?.number;
 
             // Get list of files changed in the PR
             const { data: files } = await github.rest.pulls.listFiles({
@@ -29,6 +30,18 @@ jobs:
               pull_number: prNumber,
             });
 
+            let pullRequest = context.payload.pull_request;
+
+            if (!pullRequest) {
+              // Fetch the pull request data
+              const pullRequestData = await github.rest.pulls.get({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                pull_number: prNumber,
+              });
+              pullRequest = pullRequestData.data;
+            }
+
             // Check if any changeset files indicate a major bump
             let hasMajorChangeset = false;
             for (const file of files) {
@@ -38,7 +51,7 @@ jobs:
                   owner: context.repo.owner,
                   repo: context.repo.repo,
                   path: file.filename,
-                  ref: context.payload.pull_request.head.sha,
+                  ref: pullRequest.head.sha,
                 });
 
                 const content = Buffer.from(changesetContent.content, changesetContent.encoding).toString();
@@ -58,7 +71,7 @@ jobs:
         uses: actions/github-script@v7
         with:
           script: |
-            const prNumber = context.payload.pull_request.number;
+            const prNumber = context.payload?.pull_request?.number || context.payload?.issue?.number;
             const org = context.repo.owner;
 
             // Get all comments on the PR

.prettierrc

@@ -1,12 +1,12 @@
 {
-  "printWidth": 120,
-  "singleAttributePerLine": true,
   "arrowParens": "avoid",
   "bracketSpacing": true,
   "jsxSingleQuote": true,
+  "plugins": ["prettier-plugin-packagejson", "prettier-plugin-tailwindcss"],
+  "printWidth": 120,
   "semi": true,
+  "singleAttributePerLine": true,
   "singleQuote": true,
   "tabWidth": 2,
-  "trailingComma": "all",
-  "plugins": ["prettier-plugin-tailwindcss"]
+  "trailingComma": "all"
 }

README.md

@@ -39,11 +39,11 @@ Would you like to work on Open Source software and help maintain this repository
 This repository contains the SDKs for environment/platforms that Clerk supports. For example, if you want to use Clerk with Node.js you can install:
 
 ```sh
-npm install @clerk/clerk-sdk-node
+npm install @clerk/backend
 # or
-yarn add @clerk/clerk-sdk-node
+yarn add @clerk/backend
 # or
-pnpm add @clerk/clerk-sdk-node
+pnpm add @clerk/backend
 ```
 
 ## 🎓 Learning Clerk

integration/templates/astro-hybrid/package.json

@@ -1,18 +1,18 @@
 {
   "name": "astro-clerk-hybrid-playground",
-  "type": "module",
   "version": "0.0.1",
+  "type": "module",
   "scripts": {
-    "dev": "astro dev",
-    "start": "astro dev --port $PORT",
+    "astro": "astro",
     "build": "astro check && astro build",
+    "dev": "astro dev",
     "preview": "astro preview --port $PORT",
-    "astro": "astro"
+    "start": "astro dev --port $PORT"
   },
   "dependencies": {
     "@astrojs/check": "^0.9.4",
-    "@astrojs/react": "^3.6.2",
     "@astrojs/node": "^8.3.4",
+    "@astrojs/react": "^3.6.2",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "astro": "^4.15.11",

integration/templates/astro-node/package.json

@@ -1,19 +1,19 @@
 {
   "name": "astro-clerk-playground",
-  "type": "module",
   "version": "0.0.1",
+  "type": "module",
   "scripts": {
-    "dev": "astro dev",
-    "start": "astro dev --port $PORT",
+    "astro": "astro",
     "build": "astro check && astro build",
+    "dev": "astro dev",
     "preview": "astro preview --port $PORT",
-    "astro": "astro"
+    "start": "astro dev --port $PORT"
   },
   "dependencies": {
     "@astrojs/check": "^0.9.4",
+    "@astrojs/node": "^8.3.4",
     "@astrojs/react": "^3.6.2",
     "@astrojs/tailwind": "^5.1.1",
-    "@astrojs/node": "^8.3.4",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "astro": "^4.15.11",

integration/templates/astro-node/src/layouts/ViewTransitionsLayout.astro

@@ -0,0 +1,27 @@
+---
+import { ViewTransitions } from 'astro:transitions';
+
+interface Props {
+  title: string;
+}
+
+const { title } = Astro.props;
+---
+
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="description" content="Astro description" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="generator" content={Astro.generator} />
+    <title>{title}</title>
+    <ViewTransitions />
+  </head>
+  <body>
+    <main>
+      <slot />
+    </main>
+  </body>
+</html>

integration/templates/astro-node/src/pages/transitions/index.astro

@@ -0,0 +1,15 @@
+---
+import { SignedIn, SignedOut, UserButton } from "@clerk/astro/components";
+import Layout from "../../layouts/ViewTransitionsLayout.astro";
+---
+
+<Layout title="Sign in">
+  <div class="w-full flex justify-center">
+    <SignedOut>
+        <a href="/transitions/sign-in">Sign in</a>
+    </SignedOut>
+    <SignedIn>
+        <UserButton />
+    </SignedIn>
+  </div>
+</Layout>

integration/templates/astro-node/src/pages/transitions/sign-in.astro

@@ -0,0 +1,10 @@
+---
+import { SignIn } from "@clerk/astro/components";
+import Layout from "../../layouts/ViewTransitionsLayout.astro";
+---
+
+<Layout title="Sign in">
+  <div class="w-full flex justify-center">
+    <SignIn forceRedirectUrl="/transitions" />
+  </div>
+</Layout>

integration/templates/expo-web/package.json

@@ -1,12 +1,13 @@
 {
   "name": "expo-web",
-  "main": "expo-router/entry",
   "version": "1.0.0",
+  "private": true,
+  "main": "expo-router/entry",
   "scripts": {
-    "dev": "RCT_METRO_PORT=$PORT expo start --web --port $PORT",
     "build": "expo export -p web",
-    "start": "npx serve dist --single",
-    "lint": "expo lint"
+    "dev": "RCT_METRO_PORT=$PORT expo start --web --port $PORT",
+    "lint": "expo lint",
+    "start": "npx serve dist --single"
   },
   "jest": {
     "preset": "jest-expo"
@@ -30,8 +31,8 @@
     "react-native-reanimated": "~3.10.1",
     "react-native-safe-area-context": "4.10.9",
     "react-native-screens": "~3.31.1",
-    "react-native-web": "~0.19.6",
-    "react-native-url-polyfill": "^2.0.0"
+    "react-native-url-polyfill": "^2.0.0",
+    "react-native-web": "~0.19.6"
   },
   "devDependencies": {
     "@babel/core": "^7.20.0",
@@ -42,6 +43,5 @@
     "jest-expo": "~51.0.3",
     "react-test-renderer": "18.2.0",
     "typescript": "~5.6.2"
-  },
-  "private": true
+  }
 }

integration/templates/next-app-router/src/app/api/me/route.ts

@@ -1,6 +1,6 @@
 import { auth } from '@clerk/nextjs/server';
 
-export function GET() {
-  const { userId } = auth();
+export async function GET() {
+  const { userId } = await auth();
   return new Response(JSON.stringify({ userId }));
 }

integration/templates/next-app-router/src/app/api/settings/route.ts

@@ -1,6 +1,6 @@
 import { auth } from '@clerk/nextjs/server';
 
-export function GET() {
-  const { userId } = auth().protect(has => has({ role: 'admin' }) || has({ role: 'org:editor' }));
+export async function GET() {
+  const { userId } = await auth.protect((has: any) => has({ role: 'admin' }) || has({ role: 'org:editor' }));
   return new Response(JSON.stringify({ userId }));
 }

integration/templates/next-app-router/src/app/csp/page.tsx

@@ -1,10 +1,12 @@
 import { headers } from 'next/headers';
 import { ClerkLoaded } from '@clerk/nextjs';
 
-export default function CSPPage() {
+export default async function CSPPage() {
+  const cspHeader = await headers().get('Content-Security-Policy');
+
   return (
     <div>
-      CSP: <pre>{headers().get('Content-Security-Policy')}</pre>
+      CSP: <pre>{cspHeader}</pre>
       <ClerkLoaded>
         <p>clerk loaded</p>
       </ClerkLoaded>

integration/templates/next-app-router/src/app/only-admin/page.tsx

@@ -0,0 +1,3 @@
+export default function Page() {
+  return <div>User is admin</div>;
+}

integration/templates/next-app-router/src/app/organizations-by-id/[id]/page.tsx

@@ -0,0 +1,18 @@
+import { auth } from '@clerk/nextjs/server';
+
+export default async function Home({ params }: { params: { id: string } }) {
+  const { orgId } = await auth();
+
+  if (params.id != orgId) {
+    console.log('Mismatch - returning nothing for now...', params.id, orgId);
+  }
+
+  console.log("I'm the server and I got this id: ", orgId);
+
+  return (
+    <>
+      <p>Org-specific home</p>
+      <p>From auth(), I know your org id is: {orgId}</p>
+    </>
+  );
+}

integration/templates/next-app-router/src/app/organizations-by-id/[id]/settings/page.tsx

@@ -0,0 +1,18 @@
+import { auth } from '@clerk/nextjs/server';
+
+export default async function Home({ params }: { params: { id: string } }) {
+  const { orgId } = await auth();
+
+  if (params.id != orgId) {
+    console.log('Mismatch - returning nothing for now...', params.id, orgId);
+  }
+
+  console.log("I'm the server and I got this id: ", orgId);
+
+  return (
+    <>
+      <p>Org-specific settings</p>
+      <p>From auth(), I know your org id is: {orgId}</p>
+    </>
+  );
+}

integration/templates/next-app-router/src/app/organizations-by-slug/[slug]/page.tsx

@@ -0,0 +1,18 @@
+import { auth } from '@clerk/nextjs/server';
+
+export default async function Home({ params }: { params: { slug: string } }) {
+  const { orgSlug } = await auth();
+
+  if (params.slug != orgSlug) {
+    console.log('Mismatch - returning nothing for now...', params.slug, orgSlug);
+  }
+
+  console.log("I'm the server and I got this slug: ", orgSlug);
+
+  return (
+    <>
+      <p>Org-specific home</p>
+      <p>From auth(), I know your org slug is: {orgSlug}</p>
+    </>
+  );
+}

integration/templates/next-app-router/src/app/organizations-by-slug/[slug]/settings/page.tsx

@@ -0,0 +1,18 @@
+import { auth } from '@clerk/nextjs/server';
+
+export default async function Home({ params }: { params: { slug: string } }) {
+  const { orgSlug } = await auth();
+
+  if (params.slug != orgSlug) {
+    console.log('Mismatch - returning nothing for now...', params.slug, orgSlug);
+  }
+
+  console.log("I'm the server and I got this slug: ", orgSlug);
+
+  return (
+    <>
+      <p>Org-specific settings</p>
+      <p>From auth(), I know your org slug is: {orgSlug}</p>
+    </>
+  );
+}

integration/templates/next-app-router/src/app/page-protected/page.tsx

@@ -1,6 +1,7 @@
 import { auth } from '@clerk/nextjs/server';
 
-export default function Page() {
-  auth().protect();
+export default async function Page() {
+  await auth.protect();
+
   return <div>Protected Page</div>;
 }