Clerk
Backend & InfraOfficial JavaScript repository for Clerk authentication
Release History
@clerk/testing@1.14.7This patch release primarily consists of dependency updates across several internal Clerk packages.
@clerk/clerk-js@5.125.11This patch release updates internal dependencies for @clerk/shared and @clerk/localizations to patch versions.
@clerk/nuxt@1.13.30This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, types, and Vue components.
@clerk/localizations@3.37.6This patch release primarily involves updating the dependency on @clerk/types to version 4.101.24.
@clerk/agent-toolkit@0.2.32This patch release primarily consists of dependency updates across several internal Clerk packages.
@clerk/astro@2.17.12This patch release primarily consists of dependency updates across several internal Clerk packages.
@clerk/chrome-extension@2.9.16This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/shared, @clerk/clerk-js, and @clerk/clerk-react.
@clerk/backend@2.33.4This patch release primarily involved updating internal dependencies to newer versions of @clerk/shared and @clerk/types.
@clerk/remix@4.13.47This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/express@1.7.80This patch release primarily consists of dependency updates across several internal Clerk packages.
@clerk/expo-passkeys@0.4.43This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 3.47.6.
@clerk/elements@0.24.17This patch release primarily consists of dependency updates across several Clerk packages, including shared, clerk-react, and types.
@clerk/nextjs@6.39.4This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/fastify@2.6.32This patch release primarily consists of dependency updates across several internal Clerk packages.
@clerk/react-router@2.4.14This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/types@4.101.24This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 3.47.6.
@clerk/shared@3.47.61 fixThis patch release updates the js-cookie dependency to version 3.0.7 to mitigate a known security vulnerability.
@clerk/tanstack-react-start@0.29.12This patch release primarily consists of dependency updates across several Clerk packages, including shared, backend, clerk-react, and types.
@clerk/vue@1.17.22This patch release primarily involved updating internal dependencies to newer versions of @clerk/shared and @clerk/types.
@clerk/clerk-react@5.61.7This patch release primarily involved updating the internal dependency @clerk/shared to version 3.47.6.
@clerk/themes@2.4.61This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 3.47.6.
@clerk/clerk-expo@2.19.37This patch release primarily consists of dependency updates across various Clerk packages, including shared, clerk-js, clerk-react, and types.
@clerk/react@6.7.1This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 4.13.1.
@clerk/hono@0.1.31This patch release primarily updates internal dependencies, specifically @clerk/shared and @clerk/backend, to maintenance versions.
@clerk/ui@1.13.11 fixThis patch release fixes an issue where subscription management buttons were incorrectly hidden for certain paid seat-based plans. Dependencies were also updated.
@clerk/clerk-js@6.12.1This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 4.13.1.
@clerk/expo@3.2.16This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/shared, @clerk/react, and @clerk/clerk-js.
@clerk/astro@3.3.1This patch release primarily updates internal dependencies, specifically @clerk/shared and @clerk/backend, to newer patch versions.
@clerk/expo-passkeys@1.0.29This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 4.13.1.
@clerk/nextjs@7.4.1This patch release primarily consists of dependency updates across several Clerk packages, including shared, react, and backend.
@clerk/chrome-extension@3.1.30This patch release updates dependencies across several Clerk packages, including @clerk/ui, @clerk/shared, @clerk/react, and @clerk/clerk-js, to their latest patch versions.
@clerk/shared@4.13.11 fixThis patch release updates the js-cookie dependency to version 3.0.7 to mitigate a known security vulnerability.
@clerk/backend@3.4.13This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 4.13.1.
@clerk/express@2.1.21This patch release primarily updates internal dependencies, specifically @clerk/shared and @clerk/backend, to newer patch versions.
@clerk/nuxt@2.5.1This patch release primarily consists of dependency updates across several Clerk packages, including shared, Vue, and backend components.
@clerk/localizations@4.6.8This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 4.13.1.
@clerk/tanstack-react-start@1.3.1This patch release primarily involved updating internal Clerk dependencies to newer patch versions for stability and maintenance.
@clerk/react-router@3.3.11 featureThis patch release forwards redirect URL options from middleware to client state and updates several internal Clerk dependencies.
@clerk/testing@2.0.33This patch release primarily involved updating internal dependencies for @clerk/shared and @clerk/backend.
@clerk/vue@2.3.1This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 4.13.1.
@clerk/fastify@3.1.31This patch release primarily updates internal dependencies, specifically @clerk/shared and @clerk/backend, to maintenance versions.
@clerk/react@6.7.0This release removes the experimental <ConfigureSSO /> component and updates internal dependencies, including @clerk/shared.
@clerk/astro@3.3.0This release removes the experimental <ConfigureSSO /> component and updates internal dependencies.
@clerk/nextjs@7.4.0This release removes the experimental <ConfigureSSO /> component and updates several internal Clerk dependencies.
@clerk/tanstack-react-start@1.3.0This release removes the experimental <ConfigureSSO /> component and updates several internal Clerk dependencies.
@clerk/testing@2.0.32This patch release primarily involved updating internal dependencies, specifically @clerk/shared and @clerk/backend.
@clerk/backend@3.4.12This patch release primarily involved updating internal dependencies, specifically upgrading @clerk/shared to version 4.13.0.
@clerk/clerk-js@6.12.0This release removes the experimental <ConfigureSSO /> component and updates internal dependencies, including @clerk/shared.
@clerk/react-router@3.3.0This release removes the experimental <ConfigureSSO /> component and updates several internal Clerk dependencies.
@clerk/expo@3.2.15This patch release primarily involved updating internal dependencies across several Clerk packages, including clerk-js, shared, and react.
@clerk/localizations@4.6.7This patch release primarily involved updating internal dependencies, specifically upgrading @clerk/shared to version 4.13.0.
@clerk/chrome-extension@3.1.29This patch release primarily consists of dependency updates across several Clerk packages, including clerk-js, shared, react, and ui.
@clerk/shared@4.13.01 fixThis release removes the experimental <ConfigureSSO /> component and cleans up the re-export of error helpers.
@clerk/express@2.1.20This patch release primarily involved updating internal dependencies, specifically @clerk/shared and @clerk/backend.
@clerk/expo-passkeys@1.0.28This patch release primarily involved updating internal dependencies, specifically upgrading @clerk/shared to version 4.13.0.
@clerk/hono@0.1.30This patch release primarily involved updating internal dependencies, specifically @clerk/shared and @clerk/backend.
@clerk/nuxt@2.5.0This release removes the experimental <ConfigureSSO /> component and updates several internal Clerk dependencies.
@clerk/ui@1.13.02 fixes3 featuresThis release introduces the `elevation` appearance option for card components and adds `ProfileCard.Page`. It also removes the `<ConfigureSSO />` component from the experimental path and fixes a layout shift bug in SSO configuration.
@clerk/vue@2.3.0This release removes the experimental <ConfigureSSO /> component and updates internal dependencies, including @clerk/shared.
@clerk/fastify@3.1.301 fixThis patch release removes an unused cookie module and updates dependencies for @clerk/shared and @clerk/backend.
@clerk/vue@2.2.6This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 4.12.2.
@clerk/testing@2.0.31This patch release updates internal dependencies for @clerk/backend and @clerk/shared.
@clerk/ui@1.12.11 fixThis patch release fixes an issue in the SSO configuration component and updates internal dependencies.
@clerk/clerk-js@6.11.31 fixThis patch release primarily addresses a bug fix related to configuring Custom SAML providers within the <ConfigureSSO /> component and updates internal dependencies.
@clerk/expo-passkeys@1.0.27This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 4.12.2.
@clerk/nextjs@7.3.7This patch release primarily consists of dependency updates for several Clerk packages, including backend, shared, and react.
@clerk/chrome-extension@3.1.28This patch release primarily consists of dependency updates across several Clerk packages, including clerk-js, shared, ui, and react.
@clerk/backend@3.4.111 featureThis patch release introduces the new `agentTaskId` field in the Agent Tasks Create response while deprecating the older `taskId` field, alongside minor dependency updates.
@clerk/localizations@4.6.61 fixThis patch release primarily addresses a bug fix related to configuring Custom SAML providers within the <ConfigureSSO /> component and updates internal dependencies.
@clerk/fastify@3.1.29This patch release primarily involved updating internal dependencies for @clerk/backend and @clerk/shared.
@clerk/nuxt@2.4.6This patch release primarily consists of dependency updates for several Clerk packages, including backend, shared, and Vue components.
@clerk/express@2.1.19This patch release updates dependencies for @clerk/backend and @clerk/shared to minor versions 3.4.11 and 4.12.2 respectively.
@clerk/react-router@3.2.7This patch release primarily consists of dependency updates across several Clerk packages, including backend, shared, and react.
@clerk/shared@4.12.21 fixThis patch release addresses a specific configuration issue within the SSO setup for custom SAML providers.
@clerk/tanstack-react-start@1.2.7This patch release primarily consists of dependency updates for several Clerk packages, including backend, shared, and react.
@clerk/expo@3.2.14This patch release updates several internal Clerk packages to newer patch versions.
@clerk/react@6.6.6This patch release primarily involved updating internal dependencies, specifically @clerk/shared to version 4.12.2.
@clerk/hono@0.1.29This patch release updates internal dependencies for @clerk/backend and @clerk/shared.
@clerk/astro@3.2.6This patch release updates internal dependencies for @clerk/backend and @clerk/shared.
@clerk/clerk-js@6.11.11 fix1 featureThis patch release introduces a confirmation step for the experimental SSO configuration component and restores a query client getter for backward compatibility with older shared package versions.
@clerk/hono@0.1.27This patch release primarily focuses on updating internal dependencies, specifically @clerk/shared and @clerk/backend, to newer versions.
@clerk/backend@3.4.91 fixThis patch release primarily focuses on updating internal dependencies, including an update to @clerk/shared to version 4.12.0.
@clerk/astro@3.2.4This patch release primarily consists of dependency updates for @clerk/shared and @clerk/backend packages.
@clerk/express@2.1.17This patch release primarily focuses on updating internal dependencies, specifically @clerk/shared and @clerk/backend, to newer versions.
@clerk/expo-passkeys@1.0.251 fixThis patch release primarily focuses on updating internal dependencies, including an update to @clerk/shared to version 4.12.0.
@clerk/fastify@3.1.27This patch release primarily consists of dependency updates for @clerk/shared and @clerk/backend packages.
@clerk/nextjs@7.3.51 fixThis patch release addresses a high-severity security vulnerability in the Next.js App Router by updating the `next` devDependency. It also updates several internal Clerk packages.
@clerk/testing@2.0.29This patch release primarily involves updating internal dependencies for @clerk/shared and @clerk/backend.
@clerk/localizations@4.6.43 featuresThis patch introduces new configuration steps and UI segmentation for SAML SSO setup within the experimental configuration component. Dependencies were also updated.
@clerk/react@6.6.41 featureThis patch release introduces an enhancement for unstyled button components to handle React elements passed as arrays and updates dependencies, including @clerk/shared to v4.12.0.
@clerk/expo@3.2.12This patch release primarily focuses on updating internal dependencies across several Clerk packages, including @clerk/shared, @clerk/clerk-js, and @clerk/react.
@clerk/vue@2.2.41 fixThis patch release primarily focuses on updating internal dependencies, specifically bumping @clerk/shared to version 4.12.0.
@clerk/nuxt@2.4.4This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/shared, @clerk/backend, and @clerk/vue.
@clerk/react-router@3.2.5This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/shared, @clerk/react, and @clerk/backend.
@clerk/shared@4.12.01 featureThis release introduces a new 'highlightedPlan' prop for the PricingTable component and enhances the experimental SAML configuration flow with multi-mode input and confirmation/test steps.
@clerk/ui@1.11.01 fix2 featuresThis release introduces the ability to use inline bold markup in localization strings and enhances the SAML configuration flow with a segmented control for metadata URL or manual configuration. It also includes security hardening for token substitution.
@clerk/tanstack-react-start@1.2.5This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/shared, @clerk/react, and @clerk/backend.
@clerk/chrome-extension@3.1.26This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/shared, @clerk/ui, @clerk/clerk-js, and @clerk/react.
@clerk/nuxt@2.4.3This patch release primarily consists of dependency updates across several Clerk packages, including @clerk/shared, @clerk/backend, and @clerk/vue.
@clerk/nextjs@7.3.4This patch release primarily focuses on updating internal dependencies across several Clerk packages, including @clerk/shared, @clerk/backend, and @clerk/react.
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