Clerk
Backend & InfraOfficial JavaScript repository for Clerk authentication
Release History
@clerk/chrome-extension@2.9.6This patch release primarily involves updating the dependency for @clerk/clerk-js to version 5.125.1.
@clerk/clerk-expo@2.19.27This patch release primarily updates the dependency for @clerk/clerk-js to version 5.125.1.
@clerk/clerk-js@5.125.11 fixThis patch release addresses a specific bug related to organization invitation acceptance flow.
@clerk/nextjs@6.38.2This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/agent-toolkit@0.2.26This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/express@1.7.74This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/nuxt@1.13.24This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/fastify@2.6.26This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/remix@4.13.41This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/tanstack-react-start@0.29.6This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/astro@2.17.6This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/react-router@2.4.8This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/testing@1.14.1This patch release primarily involved updating internal dependencies, specifically bumping @clerk/backend to version 2.32.1.
@clerk/backend@2.32.1This patch updates the OrganizationInvitationStatus enum to include the new 'expired' status to align with recent API changes.
@clerk/clerk-react@5.61.1This patch release primarily involved updating the dependency for @clerk/shared to version 3.47.0.
@clerk/clerk-expo@2.19.26This patch release primarily consists of dependency updates across several Clerk packages, including clerk-js, shared, clerk-react, and types.
@clerk/agent-toolkit@0.2.25This patch release primarily focuses on updating internal dependencies, including @clerk/shared, @clerk/backend, and @clerk/types.
@clerk/backend@2.32.02 featuresThis release introduces support for the Agent Tasks API endpoint and exports a new testing helper for creating these tasks. Dependencies were also updated.
@clerk/remix@4.13.40This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/astro@2.17.5This patch release primarily focused on updating internal dependencies, including @clerk/shared, @clerk/backend, and @clerk/types.
@clerk/types@4.101.18This patch release primarily involves updating the internal dependency @clerk/shared to version 3.47.0.
@clerk/themes@2.4.55This patch release primarily involves updating the dependency on @clerk/shared to version 3.47.0.
@clerk/elements@0.24.11This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/shared, @clerk/clerk-react, and @clerk/types.
@clerk/clerk-js@5.125.01 featureThis release introduces support for displaying proration and account credits on payment attempts and statements, alongside dependency updates.
@clerk/testing@1.14.02 featuresThis release introduces support for the Agent Tasks API endpoint and exports a new helper for creating agent testing tasks in Playwright and Cypress environments. Dependencies were also updated.
@clerk/react-router@2.4.7This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/fastify@2.6.25This patch release primarily focused on updating internal dependencies, including @clerk/shared, @clerk/backend, and @clerk/types.
@clerk/nextjs@6.38.1This patch release primarily focuses on updating internal dependencies across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/chrome-extension@2.9.5This patch release primarily consists of dependency updates for several Clerk packages, including clerk-js, shared, and clerk-react.
@clerk/shared@3.47.01 featureThis minor release introduces support for displaying proration and account credits on payment attempts and statements.
@clerk/express@1.7.73This patch release primarily focuses on updating internal dependencies, including @clerk/shared, @clerk/backend, and @clerk/types.
@clerk/expo-passkeys@0.4.37This patch release primarily involved updating the internal dependency @clerk/shared to version 3.47.0.
@clerk/vue@1.17.16This patch release primarily involved updating internal dependencies to newer versions of @clerk/shared and @clerk/types.
@clerk/nuxt@1.13.23This patch release primarily focuses on updating internal dependencies across several Clerk packages, including shared, backend, types, and vue.
@clerk/tanstack-react-start@0.29.5This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/localizations@3.37.01 featureThis release introduces support for displaying proration and account credits on payment attempts and statements, along with dependency updates.
@clerk/fastify@2.6.24This patch release primarily consists of dependency updates across several internal Clerk packages, including shared, backend, and types.
@clerk/astro@2.17.4This patch release primarily consists of dependency updates across several internal Clerk packages, including shared, backend, and types.
@clerk/chrome-extension@2.9.4This patch release primarily consists of dependency updates across several Clerk packages, including clerk-js, clerk-react, and shared.
@clerk/remix@4.13.39This patch release primarily consists of dependency updates across several Clerk packages, including clerk-react, shared, backend, and types.
@clerk/themes@2.4.54This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 3.46.0.
@clerk/nuxt@1.13.22This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, types, and Vue components.
@clerk/elements@0.24.10This patch release primarily consists of dependency updates for several Clerk packages, including @clerk/clerk-react, @clerk/shared, and @clerk/types.
@clerk/nextjs@6.38.01 fix1 featureThis release introduces a new MFA setup session task and resolves an infinite redirect loop issue encountered when deploying Next.js applications using Clerk development instances to Netlify.
@clerk/agent-toolkit@0.2.24This patch release primarily consists of dependency updates across several internal Clerk packages, including shared, backend, and types.
@clerk/localizations@3.36.02 featuresThis release introduces support for MFA setup sessions and account credits in checkout, alongside minor dependency updates.
@clerk/react-router@2.4.6This patch release primarily consists of dependency updates across several Clerk packages, including clerk-react, shared, backend, and types.
@clerk/clerk-expo@2.19.25This patch release primarily consists of dependency updates across several Clerk packages, including clerk-js, clerk-react, shared, and types.
@clerk/clerk-js@5.124.02 fixes2 featuresThis release introduces support for MFA setup sessions and account credits. It also includes fixes related to cookie domain scoping and BaseRouter state synchronization after OAuth popups.
@clerk/express@1.7.72This patch release primarily consists of dependency updates across several internal Clerk packages, including @clerk/shared, @clerk/backend, and @clerk/types.
@clerk/vue@1.17.15This patch release primarily consists of dependency updates for @clerk/shared and @clerk/types.
@clerk/expo-passkeys@0.4.36This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 3.46.0.
@clerk/clerk-react@5.61.01 featureThis release introduces a new MFA setup session task for handling required MFA after sign-in and sign-up, alongside dependency updates.
@clerk/types@4.101.17This patch release primarily involved updating the dependency for @clerk/shared to version 3.46.0.
@clerk/testing@1.13.38This patch release primarily consists of dependency updates for several internal Clerk packages, including shared, backend, and types.
@clerk/tanstack-react-start@0.29.4This patch release primarily consists of dependency updates across several Clerk packages, including clerk-react, shared, backend, and types.
@clerk/shared@3.46.02 featuresThis minor release introduces MFA setup session handling and adds support for account credits in the checkout flow.
@clerk/backend@2.31.21 fixThis patch release primarily addresses a type annotation fix in the backend for JwtTemplatesApi.list and updates internal dependencies.
@clerk/shared@3.45.11 fixThis patch release updates cookie settings for .replit.dev origins and consolidates the list of third-party domains.
@clerk/clerk-js@5.123.12 fixesThis patch release addresses a bug in React Native navigation and updates cookie handling for .replit.dev origins. It also includes minor dependency updates.
@clerk/react-router@2.4.5This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/clerk-react@5.60.2This patch release primarily involves updating internal dependencies, specifically @clerk/shared to version 3.45.1.
@clerk/elements@0.24.9This patch release primarily consists of dependency updates across several Clerk packages, including shared, clerk-react, and types.
@clerk/agent-toolkit@0.2.23This patch release primarily consists of dependency updates across several core Clerk packages.
@clerk/express@1.7.71This patch release primarily consists of dependency updates for several internal Clerk packages.
@clerk/astro@2.17.3This patch release primarily consists of dependency updates for several internal Clerk packages.
@clerk/expo-passkeys@0.4.35This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 3.45.1.
@clerk/backend@2.31.1This patch release primarily consists of dependency updates for @clerk/shared and @clerk/types.
@clerk/localizations@3.35.5This patch release primarily involved updating internal dependencies, specifically @clerk/types to version 4.101.16.
@clerk/remix@4.13.38This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/vue@1.17.14This patch release updates internal dependencies for @clerk/shared and @clerk/types to newer patch versions.
@clerk/testing@1.13.37This patch release primarily consists of dependency updates for several internal Clerk packages, including shared, backend, and types.
@clerk/tanstack-react-start@0.29.3This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/nextjs@6.37.5This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/fastify@2.6.23This patch release primarily consists of dependency updates across several internal Clerk packages.
@clerk/nuxt@1.13.21This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, types, and Vue components.
@clerk/types@4.101.16This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 3.45.1.
@clerk/themes@2.4.53This patch release primarily involves updating the dependency for @clerk/shared to version 3.45.1.
@clerk/clerk-expo@2.19.24This patch release primarily consists of dependency updates across several Clerk packages, including shared, clerk-js, clerk-react, and types.
@clerk/chrome-extension@2.9.3This patch release updates several internal Clerk packages to new patch versions, including @clerk/shared, @clerk/clerk-js, and @clerk/clerk-react.
@clerk/nextjs@6.37.4This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/astro@2.17.21 fixThis patch release fixes a loading issue with Clerk components when using ClientRouter and updates several internal Clerk dependencies.
@clerk/clerk-expo@2.19.23This patch release primarily consists of dependency updates across several Clerk packages, including clerk-js, shared, clerk-react, and types.
@clerk/clerk-js@5.123.04 fixes2 featuresThis release introduces the `username` field to `PublicUserData` and promotes `providerUserId` as the standard for external account IDs. Several bugs related to sign-in flows and performance have also been addressed.
@clerk/elements@0.24.8This patch release primarily consists of dependency updates for several Clerk packages, including shared, clerk-react, and types.
@clerk/chrome-extension@2.9.2This patch release primarily involves updating internal dependencies across several Clerk packages, including clerk-js, shared, and clerk-react.
@clerk/vue@1.17.13This patch release primarily involved updating internal dependencies, specifically @clerk/shared and @clerk/types, to newer versions.
@clerk/fastify@2.6.22This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, and types.
@clerk/clerk-react@5.60.1This patch release primarily involves updating the internal dependency @clerk/shared to version 3.45.0.
@clerk/express@1.7.70This patch release primarily consists of dependency updates for internal Clerk packages, including @clerk/shared, @clerk/backend, and @clerk/types.
@clerk/expo-passkeys@0.4.34This patch release primarily involves updating the internal dependency @clerk/shared to version 3.45.0.
@clerk/nuxt@1.13.20This patch release primarily focuses on updating internal dependencies across several Clerk packages, including shared, backend, types, and Vue components.
@clerk/types@4.101.15This patch release primarily involves updating the internal dependency @clerk/shared to version 3.45.0.
@clerk/testing@1.13.36This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, and types.
@clerk/tanstack-react-start@0.29.2This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/shared@3.45.01 featureThis minor release introduces a new field to the PublicUserData object for enhanced user data exposure.
@clerk/remix@4.13.37This patch release primarily focuses on updating internal dependencies across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/themes@2.4.52This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 3.45.0.
@clerk/react-router@2.4.4This patch release primarily focuses on updating internal dependencies across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/localizations@3.35.4This patch release primarily involved updating dependencies, specifically @clerk/types to version 4.101.15.
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