chore(repo): upgrade monorepo to Node.js 24 by jacekradko · Pull Request #8351 · clerk/javascript

jacekradko · 2026-04-18T03:45:53Z

Summary

Upgrades the monorepo development environment to Node.js 24
Maintains Node ≥20.9.0 compatibility for published packages
Updates CI workflows to test both Node 24 and Node 20

Changes

Updated root package.json engines to require Node ≥24.15.0
Updated .nvmrc to Node 24.15.0
Updated CI workflows to use Node 24 as primary version
Added Node 20 to CI test matrix for published package compatibility
Updated release workflow caching to Node 24

Test plan

Build passes with Node 24
Tests pass with Node 24
Published packages still work with Node 20 (with expected engine warnings)
CI configuration updated to test both versions

- Update root package.json engines to require Node >=24.15.0 - Update .nvmrc to Node 24.15.0 - Update CI workflows to use Node 24 as primary version - Add Node 20 to CI test matrix for published package compatibility - Update release workflow caching to Node 24 Published packages maintain Node >=20.9.0 compatibility as specified in their individual engines fields. This change only affects the monorepo development environment and CI/CD pipelines.

changeset-bot · 2026-04-18T03:45:59Z

🦋 Changeset detected

Latest commit: 878fbb8

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 10 packages

Name	Type
@clerk/backend	Patch
@clerk/react-router	Patch
@clerk/tanstack-react-start	Patch
@clerk/astro	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/testing	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2026-04-18T03:45:59Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Apr 25, 2026 1:55am

coderabbitai · 2026-04-18T03:48:07Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

📝 Walkthrough

Walkthrough

Updated Node.js target from 22.x to 24.15.0 across project configs and CI: .nvmrc, package.json engines.node, GitHub Actions composite defaults (.github/actions/init*.yml), CI matrix and gating (.github/workflows/ci.yml), and release cache matrix (.github/workflows/release.yml). Added two changeset files (.changeset/giant-mirrors-find.md, .changeset/node24-clerk-request-signal.md). Modified request-cloning behavior: packages/backend/src/tokens/clerkRequest.ts now constructs a RequestInit (using a Proxy for non-string input) that omits the original request’s signal, and packages/react-router/src/server/utils.ts no longer copies request.signal when patching requests. No public exported signatures changed.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely describes the main objective of the pull request: upgrading the monorepo to Node.js 24.
Description check	✅ Passed	The description is directly related to the changeset, providing a clear summary of changes, test plan results, and alignment with the PR objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

pkg-pr-new · 2026-04-18T03:48:32Z

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@8351

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@8351

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@8351

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@8351

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@8351

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@8351

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@8351

@clerk/express

npm i https://pkg.pr.new/@clerk/express@8351

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@8351

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@8351

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@8351

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@8351

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@8351

@clerk/react

npm i https://pkg.pr.new/@clerk/react@8351

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@8351

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@8351

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@8351

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@8351

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@8351

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@8351

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@8351

commit: 878fbb8

vercel · 2026-04-20T21:53:31Z

Deployment failed with the following error:

You must set up Two-Factor Authentication before accessing this team.

View Documentation: https://vercel.com/docs/two-factor-authentication

- Bump default node-version in init actions from 22 to 24 so integration-tests run on the version required by engines.node - In ClerkRequest, build init explicitly when cloning a Request to avoid undici extracting a cross-realm signal (e.g. from NextRequest), which Node 24's stricter instanceof check rejects - Also fixes a latent precedence bug where a provided init was silently dropped

- Pin node-version to 24.15.0 in init actions, matrix, and pkg-pr-new step so the engines.node check (>=24.15.0) is satisfied - Use a Proxy to intercept the 'signal' read when cloning a Request, instead of eagerly reading individual properties (which broke in environments like Cloudflare Workers where Request.cache is not implemented)

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.github/workflows/ci.yml:
- Around line 221-224: CI matrix includes an unsupported "node-version: 20"
entry; remove that entry so the matrix only contains the supported
"node-version: 24.15.0". Edit the matrix block that lists the node-version
values (the YAML key "node-version" in the job matrix) and delete the line with
"20", leaving the existing "24.15.0" (and keep "test-filter" and "filter-label"
entries unchanged); verify no other job or matrix elsewhere still references
node 20.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

Run ID: 4d516f8e-f4a5-4b0a-a1fa-a36126cee8dc

📥 Commits

Reviewing files that changed from the base of the PR and between d70ee79 and e9f8d1a.

📒 Files selected for processing (4)

.github/actions/init-blacksmith/action.yml
.github/actions/init/action.yml
.github/workflows/ci.yml
packages/backend/src/tokens/clerkRequest.ts

🚧 Files skipped from review as they are similar to previous changes (3)

.github/actions/init-blacksmith/action.yml
.github/actions/init/action.yml
packages/backend/src/tokens/clerkRequest.ts

…n compat

wobsoriano · 2026-04-24T15:53:29Z

+    // When cloning a Request by passing it as init, hide its `signal`. Undici's
+    // Request constructor in Node 24 performs a strict instanceof check on the
+    // signal and rejects ones from a different realm (e.g. NextRequest). Using a
+    // Proxy keeps property access lazy so environments that don't implement
+    // optional getters (e.g. Cloudflare Workers' Request lacks `cache`) still work.
+    let cloneInit: RequestInit | undefined;
+    if (init) {
+      cloneInit = init;
+    } else if (typeof input !== 'string') {
+      cloneInit = new Proxy(input as Request, {
+        get(target, prop) {
+          if (prop === 'signal') {
+            return undefined;
+          }
+          return Reflect.get(target, prop, target);
+        },
+      }) as unknown as RequestInit;
+    }
+    super(url, cloneInit);


Can confirm this makes sense. Undici validates init.signal when constructing a Request, and that can reject signals coming from framework-specific request objects

https://github.com/nodejs/undici/blob/main/lib/web/fetch/request.js#L1077-L1085

…oxy and patchRequest

wobsoriano

🚀

jacekradko added 2 commits April 17, 2026 22:45

chore: add changeset for Node 24 upgrade

d50f674

github-actions Bot added the actions label Apr 18, 2026

vercel Bot deployed to Preview April 18, 2026 03:46 View deployment

Merge branch 'main' into jacek/upgrade-to-node-24

6d4945a

vercel Bot deployed to Preview April 20, 2026 13:23 View deployment

Merge branch 'main' into jacek/upgrade-to-node-24

9bf6afa

Merge branch 'main' into jacek/upgrade-to-node-24

711329c

vercel Bot deployed to Preview April 21, 2026 23:13 View deployment

jacekradko changed the title ~~chore: upgrade monorepo to Node.js 24~~ chore(repo): upgrade monorepo to Node.js 24 Apr 22, 2026

github-actions Bot added the backend label Apr 22, 2026

vercel Bot deployed to Preview April 22, 2026 02:11 View deployment

vercel Bot deployed to Preview April 22, 2026 02:50 View deployment

coderabbitai Bot reviewed Apr 22, 2026

View reviewed changes

Comment thread .github/workflows/ci.yml Outdated

fix(react-router): omit signal from patchRequest clone for Node 24

8d74519

github-actions Bot added the react-router label Apr 22, 2026

vercel Bot deployed to Preview April 22, 2026 02:59 View deployment

fix(backend): satisfy curly lint rule in ClerkRequest signal proxy

8619779

vercel Bot deployed to Preview April 22, 2026 03:24 View deployment

ci(repo): pin minimum-supported Node 20.9.0 in unit-test matrix

b736bc2

vercel Bot deployed to Preview April 23, 2026 02:41 View deployment

ci(repo): bump unit-test Node 20 matrix to 20.19.0 for build toolchai…

a14d934

…n compat

vercel Bot deployed to Preview April 23, 2026 03:01 View deployment

Merge branch 'main' into jacek/upgrade-to-node-24

05d014c

vercel Bot deployed to Preview April 23, 2026 17:08 View deployment

Merge branch 'main' into jacek/upgrade-to-node-24

7913812

vercel Bot deployed to Preview April 24, 2026 12:11 View deployment

bratsos reviewed Apr 24, 2026

View reviewed changes

Comment thread .claude/scheduled_tasks.lock Outdated

bratsos reviewed Apr 24, 2026

View reviewed changes

Comment thread .changeset/giant-mirrors-find.md Outdated

wobsoriano requested changes Apr 24, 2026

View reviewed changes

bratsos reviewed Apr 24, 2026

View reviewed changes

Comment thread packages/backend/src/tokens/clerkRequest.ts

jacekradko added 2 commits April 24, 2026 12:05

Delete .claude/scheduled_tasks.lock

844e18c

Delete .changeset/giant-mirrors-find.md

d0bffa3

vercel Bot deployed to Preview April 24, 2026 17:06 View deployment

fix(backend,tanstack-react-start): omit cross-realm AbortSignal in pr…

06f4e3c

…oxy and patchRequest

github-actions Bot added the tanstack label Apr 25, 2026

vercel Bot deployed to Preview April 25, 2026 01:53 View deployment

Merge branch 'main' into jacek/upgrade-to-node-24

878fbb8

vercel Bot deployed to Preview April 25, 2026 01:55 View deployment

jacekradko requested a review from wobsoriano April 25, 2026 01:56

wobsoriano approved these changes Apr 25, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore(repo): upgrade monorepo to Node.js 24#8351

chore(repo): upgrade monorepo to Node.js 24#8351
jacekradko wants to merge 17 commits intomainfrom
jacek/upgrade-to-node-24

jacekradko commented Apr 18, 2026

Uh oh!

changeset-bot Bot commented Apr 18, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Apr 18, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Apr 18, 2026 •

edited

Loading

Reviews paused

Walkthrough

Estimated code review effort

Uh oh!

pkg-pr-new Bot commented Apr 18, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Apr 20, 2026

Uh oh!

coderabbitai Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

wobsoriano Apr 24, 2026

Uh oh!

Uh oh!

Uh oh!

wobsoriano left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

jacekradko commented Apr 18, 2026

Summary

Changes

Test plan

Uh oh!

changeset-bot Bot commented Apr 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel Bot commented Apr 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Apr 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

Estimated code review effort

Uh oh!

pkg-pr-new Bot commented Apr 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel Bot commented Apr 20, 2026

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

wobsoriano Apr 24, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

wobsoriano left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

changeset-bot Bot commented Apr 18, 2026 •

edited

Loading

vercel Bot commented Apr 18, 2026 •

edited

Loading

coderabbitai Bot commented Apr 18, 2026 •

edited

Loading

pkg-pr-new Bot commented Apr 18, 2026 •

edited

Loading