Clerk
Backend & InfraOfficial JavaScript repository for Clerk authentication
Release History
View all versions →@clerk/vue@2.4.34This patch updates the @clerk/shared dependency to version 4.30.2.
@clerk/expo@4.6.01 featureIntroduced biometric authentication features with `useBiometricCredentials()` and deprecated the older `useTrustedDevices()` exports. This update is backed by new versions of clerk-ios and clerk-android.
@clerk/testing@2.2.30This patch release updates dependencies for @clerk/shared and @clerk/backend to their latest versions.
@clerk/clerk-js@6.30.11 fixThis patch release fixes a bug where verifications could be incorrectly reported as timed out. It also updates the @clerk/shared dependency.
@clerk/localizations@4.15.7This patch updates the @clerk/shared dependency to version 4.30.1. No other changes are noted.
@clerk/react@6.14.71 fixThis patch release fixes a bug where verifications could be incorrectly reported as timed out. It also updates the @clerk/shared dependency.
@clerk/tanstack-react-start@1.5.8This patch release updates dependencies for @clerk/react, @clerk/shared, and @clerk/backend to their latest versions.
@clerk/nextjs@7.8.2This patch release updates dependencies for @clerk/react, @clerk/shared, and @clerk/backend to their latest patch versions.
@clerk/fastify@3.1.73This patch release updates dependencies for @clerk/shared and @clerk/backend to their latest versions.
@clerk/chrome-extension@3.1.76This patch release updates dependencies for several Clerk packages, including clerk-js, react, shared, and ui, to their latest patch versions.
@clerk/hono@0.1.73This patch release updates dependencies for @clerk/shared and @clerk/backend. The specific changes are detailed in the linked commit.
@clerk/express@2.1.63This patch release updates dependencies for @clerk/shared and @clerk/backend to their latest versions.
@clerk/nuxt@3.0.15This patch release updates dependencies for @clerk/shared, @clerk/backend, and @clerk/vue to their latest patch versions.
@clerk/expo@4.5.4This patch release updates dependencies for Clerk's JavaScript packages, including clerk-js, react, and shared.
@clerk/react-router@3.6.17This patch release updates dependencies for @clerk/react, @clerk/shared, and @clerk/backend to their latest versions.
@clerk/ui@1.30.81 fixThis patch release fixes a bug where verifications could be incorrectly reported as timed out. It also updates dependencies for @clerk/shared and @clerk/localizations.
@clerk/astro@4.0.19This patch release updates dependencies for @clerk/shared and @clerk/backend to their latest versions.
@clerk/vue@2.4.33This patch updates the @clerk/shared dependency to version 4.30.1.
@clerk/shared@4.30.11 fixThis patch release fixes a bug where verifications could be incorrectly reported as timed out.
@clerk/electron@0.0.37This patch release updates dependencies for Clerk's JavaScript packages, including clerk-js, react, and shared.
@clerk/expo-passkeys@2.0.15This patch updates the @clerk/shared dependency to version 4.30.1.
@clerk/backend@3.16.12This patch updates the @clerk/shared dependency to version 4.30.1. No other changes are noted.
@clerk/localizations@4.15.6This patch release includes updates to dependencies, specifically for @clerk/shared version 4.30.0.
@clerk/clerk-js@6.30.01 fixThis release fixes a bug in OAuth account transfers that required additional verification, ensuring they no longer reset. Dependencies have also been updated.
@clerk/shared@4.30.04 fixesThis release fixes several issues related to OAuth account transfers, enterprise SSO redirect URLs, and navigation within the Clerk provider. It also polishes error message copy for better clarity.
Common Errors
SyntaxError2 reportsSerovalDeserializationError1 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.
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