@clerk/astro
4.1.27 · 18 Nov 2026MIT46.5k / weekRepositoryHomepagenpmAtom feed
Upgrading @clerk/astro From 3.0.11 to 3.4.20
45 releases in betweenevery note read
Reading releases, release notes and advisories…
Before you upgrade
Tick each one off as you go- Breaking3.4.0
- Deprecated3.4.8
Security
Fixes 2 advisories affecting 3.0.11
- Official Clerk JavaScript SDKs: Middleware-based route protection bypasscritical · GHSA-vqx2-fgx2-5wq9
- Clerk has an authorization bypass when combining organization, billing, or reverification checkshigh · GHSA-w24r-5266-9c3c
- 3.4.19
Escape
<,>, and/when serializing the Clerk auth state into SSR<script>tags, preventing a</script>sequence inside user-controllable session claims from breaking out of the script element (stored XSS). The embedded JSON still parses to identical values on the client. - 3.0.13
Bump
astrodevDependency floor to5.18.1to pick up an upstream security fix.
Release by release
3.4.20nothing new or fixed in the note
- Security
Escape
<,>, and/when serializing the Clerk auth state into SSR<script>tags, preventing a</script>sequence inside user-controllable session claims from breaking out of the script element (stored XSS). The embedded JSON still parses to identical values on the client. - Fixed
Fix Astro initialization when bundled
uiorprefetchUI: falseis passed to the integration.
- Security
3.4.9 – 3.4.1810 releases, nothing new or fixed in the notes
- Deprecated
Deprecate
createRouteMatcher()in favor of resource-based auth checks. - Fixed
Fix custom user button menu item rendering for Astro's stricter compiler.
- Deprecated
3.4.4 – 3.4.74 releases, nothing new or fixed in the notes
- Fixed
Align the
HeadlessBrowserClerk.load()parameter type with the runtime behavior by accepting the fullClerkOptions, includingisSatellite. The clerk-js implementation has always accepted and usedisSatellitefromload()options — it's the only way to configure a satellite app when using@clerk/clerk-jsdirectly — but the type previously excluded it, producing a contradictory generated API reference and type errors for direct consumers.
- Fixed
- Fixed
Migrate the build pipeline to tsdown and TypeScript 6.0. This is an internal tooling change with no intended changes to the public API or runtime behavior.
- Fixed
3.4.1nothing new or fixed in the note
86 internal lines (docs, tests, tooling) left out.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.