Clerk
Backend & InfraOfficial JavaScript repository for Clerk authentication
Release History
@clerk/react-router@3.1.01 featureThis release introduces an internal component, <OAuthConsent />, for handling zero-config OAuth consent screens during redirects. It also updates several internal dependencies.
@clerk/expo@3.1.103 fixesThis patch release addresses several bugs related to OAuth sign-in flows and view rendering issues on iOS and Android, alongside dependency updates.
@clerk/nextjs@7.1.01 fix1 featureThis release introduces an internal hook for OAuth consent metadata fetching and patches a high-severity denial-of-service vulnerability in Next.js by updating the devDependency.
@clerk/express@2.1.11 fixThis patch release forwards the clockSkewInMs option from clerkMiddleware to authenticateRequest and updates internal dependencies.
@clerk/react@6.3.02 featuresThis release introduces new features for handling OAuth consent flows via the OAuthApplication resource and the internal useOAuthConsent hook, alongside minor dependency updates.
@clerk/vue@2.0.12This patch release primarily involves updating the internal dependency @clerk/shared to version 4.7.0.
@clerk/react-router@3.0.131 featureThis patch release simplifies keyless service initialization and updates several internal Clerk dependencies.
@clerk/clerk-js@6.7.01 featureThis release introduces the OAuthApplication resource and getConsentInfo() method to support custom OAuth consent flows, alongside minor dependency updates.
@clerk/shared@4.7.03 featuresThis release introduces new features related to OAuth consent management, including a new resource and an internal hook for fetching consent metadata.
@clerk/testing@2.0.13This patch release primarily updates internal dependencies, specifically @clerk/shared and @clerk/backend, to newer versions.
@clerk/fastify@3.1.11This patch release primarily involves updating internal dependencies, specifically @clerk/shared and @clerk/backend, to newer versions.
@clerk/chrome-extension@3.1.10This patch release updates dependencies across several Clerk packages, including clerk-js, react, shared, and ui.
@clerk/expo-passkeys@1.0.11This patch release primarily involved updating internal dependencies, specifically bumping @clerk/shared to version 4.7.0.
@clerk/agent-toolkit@0.3.13This patch release primarily updates internal dependencies, specifically @clerk/shared and @clerk/backend, to newer versions.
@clerk/astro@3.0.131 featureThis patch release bumps the Astro devDependency floor for a security fix and simplifies the keyless service initialization process. It also updates internal Clerk dependencies.
@clerk/backend@3.2.9This patch release primarily involves updating the internal dependency @clerk/shared to version 4.7.0.
@clerk/nuxt@2.2.01 featureThis release introduces a convenient Keyless quickstart for Nuxt users and updates several internal Clerk dependencies.
@clerk/tanstack-react-start@1.0.13This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/react, @clerk/shared, and @clerk/backend.
@clerk/ui@1.5.1This patch release updates internal dependencies, specifically @clerk/shared and @clerk/localizations, to newer patch versions.
@clerk/hono@0.1.11This patch release primarily consists of dependency updates for @clerk/shared and @clerk/backend.
@clerk/localizations@4.4.1This patch release primarily involved updating internal dependencies, specifically bumping @clerk/shared to version 4.7.0.
@clerk/clerk-js@6.6.01 fix1 featureThis release introduces support for rendering the Banned badge in organization member lists and includes several patch fixes, notably improving types for sign-in/sign-up creation methods and fixing a modal bug.
@clerk/agent-toolkit@0.3.121 fixThis patch release primarily addresses a security vulnerability by updating the @modelcontextprotocol/sdk dependency and includes minor updates to internal shared and backend packages.
@clerk/expo@3.1.91 featureThis patch release re-exports the `useAPIKeys()` hook and updates internal dependencies, including addressing a security vulnerability in `esbuild`.
@clerk/chrome-extension@3.1.9This patch release primarily consists of dependency updates across several Clerk packages, including clerk-js, shared, ui, and react.
@clerk/shared@4.6.01 fix1 featureThis release introduces support for rendering the Banned badge in organization member lists and includes type improvements for sign-in/sign-up creation methods.
@clerk/localizations@4.4.01 fix1 featureThis release introduces support for rendering the Banned badge in organization member lists and fixes an issue where the API keys Revoke modal could become stuck disabled under localization.
@clerk/expo-passkeys@1.0.10This patch release primarily involved updating dependencies, specifically releasing @clerk/shared to version 4.6.0.
@clerk/ui@1.5.01 featureThis release introduces support for displaying the Banned badge in organization member lists and updates internal dependencies.
@clerk/astro@3.0.12This patch release updates internal dependencies, specifically @clerk/shared to v4.6.0 and @clerk/backend to v3.2.8.
@clerk/express@2.1.0This release deprecates the `requireAuth()` middleware in favor of more explicit authentication handling using `clerkMiddleware` and `getAuth`. Dependencies were also updated.
@clerk/react@6.2.1This patch release primarily involved updating dependencies, specifically releasing @clerk/shared to version 4.6.0.
@clerk/nuxt@2.1.2This patch release primarily focused on updating internal dependencies across several Clerk packages, including shared, backend, and Vue components.
@clerk/tanstack-react-start@1.0.12This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/shared, @clerk/backend, and @clerk/react.
@clerk/nextjs@7.0.121 featureThis patch release introduces the re-export of the `useAPIKeys()` hook and updates several internal Clerk dependencies.
@clerk/hono@0.1.10This patch release updates dependencies, including bumping the floor for the `hono` devDependency to incorporate an upstream security fix.
@clerk/fastify@3.1.10This patch release updates internal dependencies, specifically @clerk/shared to v4.6.0 and @clerk/backend to v3.2.8.
@clerk/testing@2.0.12This patch release updates internal dependencies, specifically @clerk/shared to v4.6.0 and @clerk/backend to v3.2.8.
@clerk/vue@2.0.11This patch release primarily involved updating dependencies, specifically releasing @clerk/shared to version 4.6.0.
@clerk/react-router@3.0.12This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, and react.
@clerk/backend@3.2.8This patch release primarily involved updating dependencies, specifically releasing @clerk/shared to version 4.6.0.
@clerk/ui@1.4.01 fix1 featureThis release introduces the general availability of API Keys functionality via the new <APIKeys /> component and useAPIKeys() hook, alongside minor UI adjustments to OrganizationList.
@clerk/hono@0.1.9This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/react@6.2.03 featuresThis release introduces API keys as a generally available feature, adding the new <APIKeys /> component and the useAPIKeys() hook. Dependencies were also updated.
@clerk/clerk-js@6.5.03 featuresThis release introduces API keys as a generally available feature, adding the <APIKeys /> component and the useAPIKeys() hook. Dependencies were also updated.
@clerk/localizations@4.3.2This patch release primarily involved updating internal dependencies, specifically bumping @clerk/shared to version 4.5.0.
@clerk/agent-toolkit@0.3.11This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/react-router@3.0.11This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/fastify@3.1.9This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/expo@3.1.8This patch release primarily consists of dependency updates across several Clerk packages, including shared, react, and clerk-js.
@clerk/nextjs@7.0.11This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/vue@2.0.10This patch release primarily involved updating internal dependencies, specifically bumping @clerk/shared to version 4.5.0.
@clerk/astro@3.0.11This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/testing@2.0.11This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/shared@4.5.03 featuresAPI keys functionality has reached general availability, introducing the new <APIKeys /> component and the useAPIKeys() hook for developers.
@clerk/chrome-extension@3.1.8This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/ui, @clerk/shared, @clerk/react, and @clerk/clerk-js.
@clerk/tanstack-react-start@1.0.11This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/express@2.0.11This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/backend@3.2.71 fixThis patch release fixes an issue where specific POST requests were causing incorrect handshake redirects, leading to 405 errors. Non-GET requests are now correctly excluded from handshake and multi-domain sync eligibility.
@clerk/nuxt@2.1.1This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 3.2.7.
@clerk/expo-passkeys@1.0.9This patch release primarily involves updating internal dependencies, specifically bumping @clerk/shared to version 4.5.0.
@clerk/clerk-js@6.4.01 fix3 featuresThis release introduces support for seat-based billing plans and the new EnterpriseConnection resource. A minor typing correction was made for enterprise connection retrieval.
@clerk/agent-toolkit@0.3.8This patch release includes dependency updates for @clerk/shared to version 4.4.0 and @clerk/backend to version 3.2.4.
@clerk/nextjs@7.0.8This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, and react.
@clerk/expo-passkeys@1.0.7This patch release primarily focuses on updating internal dependencies, specifically bumping @clerk/shared to version 4.4.0.
@clerk/express@2.0.8This patch release primarily focuses on updating internal dependencies, specifically upgrading @clerk/shared to v4.4.0 and @clerk/backend to v3.2.4.
@clerk/nuxt@2.0.81 featureThis patch introduces automatic API URL derivation from publishable keys for staging environments, aligning SDK behavior, and updates several internal dependencies.
@clerk/chrome-extension@3.1.6This patch release primarily consists of dependency updates across several Clerk packages, including clerk-js, shared, ui, and react.
@clerk/expo@3.1.62 featuresThis patch introduces fallback stubs for subpath exports to improve React Native bundler compatibility and reintroduces two-way session synchronization for Expo native components.
@clerk/astro@3.0.8This patch release primarily consists of dependency updates to @clerk/shared and @clerk/backend.
@clerk/testing@2.0.81 featureThis patch release introduces improved resilience for token fetching by adding exponential backoff retry logic for specific HTTP error codes. It also updates internal dependencies.
@clerk/fastify@3.1.6This patch release primarily involves updating internal dependencies, specifically @clerk/shared to version 4.4.0 and @clerk/backend to version 3.2.4.
@clerk/shared@4.4.02 fixes3 featuresThis release introduces support for seat-based billing plans and the new EnterpriseConnection resource. It also includes minor type correction for enterprise connection retrieval and general bug fixes.
@clerk/react-router@3.0.8This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, and react.
@clerk/hono@0.1.6This patch release primarily involves updating internal dependencies, specifically @clerk/shared to version 4.4.0 and @clerk/backend to version 3.2.4.
@clerk/react@6.1.4This patch release primarily focuses on updating internal dependencies, specifically bumping @clerk/shared to version 4.4.0.
@clerk/localizations@4.3.06 fixes2 featuresThis release introduces support for seat-based billing plans and allows linking external accounts to enterprise accounts via UserProfile. It also includes numerous localization improvements and dependency updates.
@clerk/vue@2.0.8This patch release primarily focuses on updating internal dependencies, specifically bumping the version of @clerk/shared to 4.4.0.
@clerk/tanstack-react-start@1.0.8This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, and react.
@clerk/ui@1.3.02 fixes3 featuresThis release introduces support for seat-based billing plans and the new EnterpriseConnection resource. It also includes several patch fixes for error handling and UI placeholders.
@clerk/backend@3.2.42 fixes1 featureThis patch release introduces EnterpriseAccount classes to restore SSO data and fixes an issue where the frontend API proxy mishandled server-side redirects.
@clerk/clerk-js@6.3.34 fixesThis patch release focuses on stability, fixing issues related to cookie handling, token caching, and default prop values for satellite synchronization.
@clerk/react@6.1.3This patch introduces a deprecation for the `signOutOptions` prop on `<SignOutButton />`, encouraging migration to `redirectUrl` and `sessionId` props.
@clerk/astro@3.0.71 fixThis patch release primarily addresses a compatibility issue with Cloudflare Pages environments and updates internal dependencies.
@clerk/localizations@4.2.41 fixThis patch release primarily addresses a missing Dutch translation in the organization profile section, ensuring the primary button label displays correctly.
@clerk/agent-toolkit@0.3.7This patch release primarily involved updating dependencies, specifically bumping @clerk/backend to version 3.2.3.
@clerk/express@2.0.7This patch release primarily consists of dependency updates, specifically updating @clerk/backend to version 3.2.3.
@clerk/fastify@3.1.5This patch release primarily involved updating dependencies, specifically bumping @clerk/backend to version 3.2.3.
@clerk/hono@0.1.5This patch release primarily involved updating dependencies, specifically bumping @clerk/backend to version 3.2.3.
@clerk/react-router@3.0.7This patch release primarily focused on updating internal dependencies for @clerk/react and @clerk/backend.
@clerk/testing@2.0.7This patch release primarily involved updating dependencies, specifically bumping @clerk/backend to version 3.2.3.
@clerk/nextjs@7.0.7This patch release primarily focuses on updating internal dependencies for @clerk/react and @clerk/backend packages.
@clerk/expo@3.1.53 fixes1 featureThis patch release introduces configuration flexibility for Apple Sign In in Expo and resolves several critical build and architecture compatibility issues affecting Android builds with recent Expo SDKs and pnpm workspaces.
@clerk/chrome-extension@3.1.5This patch release primarily focuses on updating internal dependencies across several Clerk packages, including @clerk/ui, @clerk/react, and @clerk/clerk-js.
@clerk/nuxt@2.0.7This patch release primarily consists of dependency updates for @clerk/vue and @clerk/backend.
@clerk/tanstack-react-start@1.0.7This patch release primarily focused on updating internal dependencies for @clerk/react and @clerk/backend.
@clerk/vue@2.0.7This patch introduces a deprecation for the `signOutOptions` prop on `<SignOutButton />`, encouraging migration to `redirectUrl` and `sessionId` props.
@clerk/ui@1.2.4Breaking2 fixesThis patch moves React dependencies to peer dependencies and resolves TypeScript typing issues and a false positive CSS warning.
@clerk/backend@3.2.33 fixesThis patch release addresses several critical bugs, including fixes for asset decoding errors, incorrect default behavior for satellite auto-sync, and dropped set-cookie headers in the frontend proxy.
@clerk/clerk-js@5.125.71 featureThis patch release introduces an optional `intent` parameter to `session.touch()` for better backend optimization and updates internal dependencies.
Common Errors
SerovalDeserializationError1 reportSerovalDeserializationError in Clerk often arises from trying to serialize complex data structures like dates or functions stored in user metadata. To fix this, either serialize these values into simpler formats such as ISO strings or primitive data types before storing them in Clerk, or exclude them entirely from the metadata. Ensure the data passed can be handled by the serialization/deserialization process.
SerovalMissingInstanceError1 reportThe "SerovalMissingInstanceError" in Clerk often arises when your metadata (public or private) contains complex data structures like Promises, Dates, or custom class instances that Seroval (Clerk's serialization library) can't natively serialize. To fix this, either convert these complex data types into simple serializable formats like strings or numbers *before* storing them in metadata, or implement a custom serializer/deserializer for those types within your Clerk app, as outlined in Clerk's documentation.
SerovalMissingPluginError1 reportThe "SerovalMissingPluginError" in Clerk typically arises when the serialization library (Seroval) used by Clerk lacks a plugin to handle specific data types present in your application's Clerk data, such as custom objects in public or private metadata. To fix this, identify the problematic data type and install the corresponding Seroval plugin, for example, use `npm install seroval-plugins-arraybuffer` if encountering ArrayBuffer errors and register it with `registerSerovalPlugins([ArrayBufferPlugin])` during your application's initialization. Ensure the plugins are installed on both server and client if server-side rendering is involved.
SerovalMissingReferenceError1 reportThe "SerovalMissingReferenceError" in Clerk often arises when serializing complex objects, particularly user metadata, that contain circular references or unserializable data types like functions or symbols. To fix this, ensure your public and private metadata only contain primitive data types (strings, numbers, booleans) or serializable objects. Consider using a custom serialization function (like `JSON.stringify` with a replacer) to prune or transform the metadata before passing it to Clerk functions like `getAuth` or user update methods.
SerovalMissingReferenceForIdError1 reportThe "SerovalMissingReferenceForIdError" in Clerk often arises when the server attempts to serialize user metadata containing circular references or complex data structures that Seroval (Clerk's serialization library) cannot handle by default. To resolve this, either simplify the problematic metadata fields (e.g., flatten nested objects, remove circular references) or configure Clerk's `serialize` option to use a more robust serialization method like `JSON.stringify` for user metadata. Verify that custom afterAuth/beforeAuth functions are not modifying the clerk object improperly which is creating the error.
SerovalParserError1 reportSerovalParserError in Clerk often arises when private metadata contains unserializable data structures like functions or circular references. To fix this, either remove unserializable data from your private metadata or use a serialization library such as `superjson` to transform the data into a serializable format before saving it to Clerk, and deserialize it upon retrieval. Also ensure your `clerk.config.ts` or equivalent is correctly configured to handle custom serialization if needed.
Related Backend & Infra Packages
Production-Grade Container Scheduling and Management
Node.js JavaScript runtime ✨🐢🚀✨
Promise based HTTP client for the browser and node.js
A modern runtime for JavaScript and TypeScript.
Deliver web apps with confidence 🚀
Incredibly fast JavaScript runtime, bundler, test runner, and package manager – all in one
Subscribe to Updates
Get notified when new versions are released