feat(upgrade): Codemods for prop removals by jacekradko · Pull Request #7297 · clerk/javascript

jacekradko · 2025-11-24T16:59:55Z

Description

Adding codemods for the breaking prop removals. Also show notes around next steps for some prop removals that might require manual changes

TODO

capture stats from codemod
add message when manual edit might be necessary

Related: #7243

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

vercel · 2025-11-24T16:59:59Z

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

1 Skipped Deployment

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Skipped			Dec 4, 2025 8:29pm

changeset-bot · 2025-11-24T17:00:01Z

⚠️ No Changeset found

Latest commit: 30db721

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

coderabbitai · 2025-11-24T17:00:03Z

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch feat/prop-removal-codemods

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

jacekradko · 2025-12-03T15:28:16Z

!snapshot

clerk-cookie · 2025-12-03T15:30:26Z

Hey @jacekradko - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.2.5-snapshot.v20251203152900
@clerk/astro	3.0.0-snapshot.v20251203152900
@clerk/backend	3.0.0-snapshot.v20251203152900
@clerk/chrome-extension	3.0.0-snapshot.v20251203152900
@clerk/clerk-js	6.0.0-snapshot.v20251203152900
@clerk/dev-cli	1.0.0-snapshot.v20251203152900
@clerk/expo	3.0.0-snapshot.v20251203152900
@clerk/expo-passkeys	1.0.0-snapshot.v20251203152900
@clerk/express	2.0.0-snapshot.v20251203152900
@clerk/fastify	2.6.5-snapshot.v20251203152900
@clerk/localizations	4.0.0-snapshot.v20251203152900
@clerk/nextjs	7.0.0-snapshot.v20251203152900
@clerk/nuxt	2.0.0-snapshot.v20251203152900
@clerk/react	6.0.0-snapshot.v20251203152900
@clerk/react-router	3.0.0-snapshot.v20251203152900
@clerk/shared	4.0.0-snapshot.v20251203152900
@clerk/tanstack-react-start	1.0.0-snapshot.v20251203152900
@clerk/testing	2.0.0-snapshot.v20251203152900
@clerk/ui	1.0.0-snapshot.v20251203152900
@clerk/upgrade	2.0.0-snapshot.v20251203152900
@clerk/vue	2.0.0-snapshot.v20251203152900

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.2.5-snapshot.v20251203152900 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.0-snapshot.v20251203152900 --save-exact

@clerk/backend

npm i @clerk/backend@3.0.0-snapshot.v20251203152900 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.0.0-snapshot.v20251203152900 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.0.0-snapshot.v20251203152900 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@1.0.0-snapshot.v20251203152900 --save-exact

@clerk/expo

npm i @clerk/expo@3.0.0-snapshot.v20251203152900 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.0-snapshot.v20251203152900 --save-exact

@clerk/express

npm i @clerk/express@2.0.0-snapshot.v20251203152900 --save-exact

@clerk/fastify

npm i @clerk/fastify@2.6.5-snapshot.v20251203152900 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.0.0-snapshot.v20251203152900 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.0-snapshot.v20251203152900 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.0.0-snapshot.v20251203152900 --save-exact

@clerk/react

npm i @clerk/react@6.0.0-snapshot.v20251203152900 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.0-snapshot.v20251203152900 --save-exact

@clerk/shared

npm i @clerk/shared@4.0.0-snapshot.v20251203152900 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.0-snapshot.v20251203152900 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.0-snapshot.v20251203152900 --save-exact

@clerk/ui

npm i @clerk/ui@1.0.0-snapshot.v20251203152900 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.0-snapshot.v20251203152900 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.0-snapshot.v20251203152900 --save-exact

pkg-pr-new · 2025-12-03T20:15:17Z

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7297

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 30db721

jacekradko · 2025-12-03T20:33:28Z

!snapshot

clerk-cookie · 2025-12-03T20:35:32Z

Hey @jacekradko - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.2.5-snapshot.v20251203203405
@clerk/astro	3.0.0-snapshot.v20251203203405
@clerk/backend	3.0.0-snapshot.v20251203203405
@clerk/chrome-extension	3.0.0-snapshot.v20251203203405
@clerk/clerk-js	6.0.0-snapshot.v20251203203405
@clerk/dev-cli	1.0.0-snapshot.v20251203203405
@clerk/expo	3.0.0-snapshot.v20251203203405
@clerk/expo-passkeys	1.0.0-snapshot.v20251203203405
@clerk/express	2.0.0-snapshot.v20251203203405
@clerk/fastify	2.6.5-snapshot.v20251203203405
@clerk/localizations	4.0.0-snapshot.v20251203203405
@clerk/nextjs	7.0.0-snapshot.v20251203203405
@clerk/nuxt	2.0.0-snapshot.v20251203203405
@clerk/react	6.0.0-snapshot.v20251203203405
@clerk/react-router	3.0.0-snapshot.v20251203203405
@clerk/shared	4.0.0-snapshot.v20251203203405
@clerk/tanstack-react-start	1.0.0-snapshot.v20251203203405
@clerk/testing	2.0.0-snapshot.v20251203203405
@clerk/ui	1.0.0-snapshot.v20251203203405
@clerk/upgrade	2.0.0-snapshot.v20251203203405
@clerk/vue	2.0.0-snapshot.v20251203203405

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.2.5-snapshot.v20251203203405 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.0-snapshot.v20251203203405 --save-exact

@clerk/backend

npm i @clerk/backend@3.0.0-snapshot.v20251203203405 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.0.0-snapshot.v20251203203405 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.0.0-snapshot.v20251203203405 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@1.0.0-snapshot.v20251203203405 --save-exact

@clerk/expo

npm i @clerk/expo@3.0.0-snapshot.v20251203203405 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.0-snapshot.v20251203203405 --save-exact

@clerk/express

npm i @clerk/express@2.0.0-snapshot.v20251203203405 --save-exact

@clerk/fastify

npm i @clerk/fastify@2.6.5-snapshot.v20251203203405 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.0.0-snapshot.v20251203203405 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.0-snapshot.v20251203203405 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.0.0-snapshot.v20251203203405 --save-exact

@clerk/react

npm i @clerk/react@6.0.0-snapshot.v20251203203405 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.0-snapshot.v20251203203405 --save-exact

@clerk/shared

npm i @clerk/shared@4.0.0-snapshot.v20251203203405 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.0-snapshot.v20251203203405 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.0-snapshot.v20251203203405 --save-exact

@clerk/ui

npm i @clerk/ui@1.0.0-snapshot.v20251203203405 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.0-snapshot.v20251203203405 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.0-snapshot.v20251203203405 --save-exact

jacekradko · 2025-12-04T14:32:02Z

!snapshot

clerk-cookie · 2025-12-04T14:34:14Z

Hey @jacekradko - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.2.7-snapshot.v20251204143242
@clerk/astro	3.0.0-snapshot.v20251204143242
@clerk/backend	3.0.0-snapshot.v20251204143242
@clerk/chrome-extension	3.0.0-snapshot.v20251204143242
@clerk/clerk-js	6.0.0-snapshot.v20251204143242
@clerk/dev-cli	1.0.0-snapshot.v20251204143242
@clerk/expo	3.0.0-snapshot.v20251204143242
@clerk/expo-passkeys	1.0.0-snapshot.v20251204143242
@clerk/express	2.0.0-snapshot.v20251204143242
@clerk/fastify	2.6.7-snapshot.v20251204143242
@clerk/localizations	4.0.0-snapshot.v20251204143242
@clerk/nextjs	7.0.0-snapshot.v20251204143242
@clerk/nuxt	2.0.0-snapshot.v20251204143242
@clerk/react	6.0.0-snapshot.v20251204143242
@clerk/react-router	3.0.0-snapshot.v20251204143242
@clerk/shared	4.0.0-snapshot.v20251204143242
@clerk/tanstack-react-start	1.0.0-snapshot.v20251204143242
@clerk/testing	2.0.0-snapshot.v20251204143242
@clerk/ui	1.0.0-snapshot.v20251204143242
@clerk/upgrade	2.0.0-snapshot.v20251204143242
@clerk/vue	2.0.0-snapshot.v20251204143242

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.2.7-snapshot.v20251204143242 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.0-snapshot.v20251204143242 --save-exact

@clerk/backend

npm i @clerk/backend@3.0.0-snapshot.v20251204143242 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.0.0-snapshot.v20251204143242 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.0.0-snapshot.v20251204143242 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@1.0.0-snapshot.v20251204143242 --save-exact

@clerk/expo

npm i @clerk/expo@3.0.0-snapshot.v20251204143242 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.0-snapshot.v20251204143242 --save-exact

@clerk/express

npm i @clerk/express@2.0.0-snapshot.v20251204143242 --save-exact

@clerk/fastify

npm i @clerk/fastify@2.6.7-snapshot.v20251204143242 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.0.0-snapshot.v20251204143242 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.0-snapshot.v20251204143242 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.0.0-snapshot.v20251204143242 --save-exact

@clerk/react

npm i @clerk/react@6.0.0-snapshot.v20251204143242 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.0-snapshot.v20251204143242 --save-exact

@clerk/shared

npm i @clerk/shared@4.0.0-snapshot.v20251204143242 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.0-snapshot.v20251204143242 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.0-snapshot.v20251204143242 --save-exact

@clerk/ui

npm i @clerk/ui@1.0.0-snapshot.v20251204143242 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.0-snapshot.v20251204143242 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.0-snapshot.v20251204143242 --save-exact

jacekradko · 2025-12-04T17:49:30Z

!snapshot

clerk-cookie · 2025-12-04T17:51:49Z

Hey @jacekradko - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.2.7-snapshot.v20251204175016
@clerk/astro	3.0.0-snapshot.v20251204175016
@clerk/backend	3.0.0-snapshot.v20251204175016
@clerk/chrome-extension	3.0.0-snapshot.v20251204175016
@clerk/clerk-js	6.0.0-snapshot.v20251204175016
@clerk/dev-cli	1.0.0-snapshot.v20251204175016
@clerk/expo	3.0.0-snapshot.v20251204175016
@clerk/expo-passkeys	1.0.0-snapshot.v20251204175016
@clerk/express	2.0.0-snapshot.v20251204175016
@clerk/fastify	2.6.7-snapshot.v20251204175016
@clerk/localizations	4.0.0-snapshot.v20251204175016
@clerk/nextjs	7.0.0-snapshot.v20251204175016
@clerk/nuxt	2.0.0-snapshot.v20251204175016
@clerk/react	6.0.0-snapshot.v20251204175016
@clerk/react-router	3.0.0-snapshot.v20251204175016
@clerk/shared	4.0.0-snapshot.v20251204175016
@clerk/tanstack-react-start	1.0.0-snapshot.v20251204175016
@clerk/testing	2.0.0-snapshot.v20251204175016
@clerk/ui	1.0.0-snapshot.v20251204175016
@clerk/upgrade	2.0.0-snapshot.v20251204175016
@clerk/vue	2.0.0-snapshot.v20251204175016

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.2.7-snapshot.v20251204175016 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.0-snapshot.v20251204175016 --save-exact

@clerk/backend

npm i @clerk/backend@3.0.0-snapshot.v20251204175016 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.0.0-snapshot.v20251204175016 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.0.0-snapshot.v20251204175016 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@1.0.0-snapshot.v20251204175016 --save-exact

@clerk/expo

npm i @clerk/expo@3.0.0-snapshot.v20251204175016 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.0-snapshot.v20251204175016 --save-exact

@clerk/express

npm i @clerk/express@2.0.0-snapshot.v20251204175016 --save-exact

@clerk/fastify

npm i @clerk/fastify@2.6.7-snapshot.v20251204175016 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.0.0-snapshot.v20251204175016 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.0-snapshot.v20251204175016 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.0.0-snapshot.v20251204175016 --save-exact

@clerk/react

npm i @clerk/react@6.0.0-snapshot.v20251204175016 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.0-snapshot.v20251204175016 --save-exact

@clerk/shared

npm i @clerk/shared@4.0.0-snapshot.v20251204175016 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.0-snapshot.v20251204175016 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.0-snapshot.v20251204175016 --save-exact

@clerk/ui

npm i @clerk/ui@1.0.0-snapshot.v20251204175016 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.0-snapshot.v20251204175016 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.0-snapshot.v20251204175016 --save-exact

brkalow

Is there an easy way to specify core 3 related codemods or is it adhoc?

feat(upgrade): prop removal code mods

794bf7f

vercel Bot temporarily deployed to Preview November 24, 2025 16:59 Inactive

jacekradko changed the base branch from main to vincent-and-the-doctor November 24, 2025 17:00

jacekradko changed the title ~~chore(repo): Use node@20 in CI (#6848)~~ feat(upgrade): Codemods for prop removals Nov 24, 2025

Merge branch 'vincent-and-the-doctor' into feat/prop-removal-codemods

9773941

vercel Bot deployed to Preview December 1, 2025 17:39

View deployment

wip

fb1d5dc

vercel Bot temporarily deployed to Preview December 2, 2025 03:14 Inactive

Merge branch 'vincent-and-the-doctor' into feat/prop-removal-codemods

7834a49

vercel Bot deployed to Preview December 2, 2025 17:30

View deployment

Merge branch 'vincent-and-the-doctor' into feat/prop-removal-codemods

7ca7797

jacekradko marked this pull request as ready for review December 3, 2025 15:00

vercel Bot deployed to Preview December 3, 2025 15:01

View deployment

streamline codemods so you don't need to enter globs twice

9eb0e46

vercel Bot temporarily deployed to Preview December 3, 2025 20:12 Inactive

format

df0c069

vercel Bot temporarily deployed to Preview December 3, 2025 20:27 Inactive

collect transform stats

1a91b6c

vercel Bot temporarily deployed to Preview December 4, 2025 02:31 Inactive

Merge branch 'vincent-and-the-doctor' into feat/prop-removal-codemods

e54ef2e

vercel Bot deployed to Preview December 4, 2025 13:30

View deployment

jacekradko changed the title ~~feat(upgrade): Codemods for prop removals~~ feat(upgrade): Codemods for prop removals Dec 4, 2025

Merge branch 'vincent-and-the-doctor' into feat/prop-removal-codemods

c31cf1b

vercel Bot deployed to Preview December 4, 2025 14:29

View deployment

wip

3288fbe

vercel Bot temporarily deployed to Preview December 4, 2025 17:38 Inactive

wip

dd15573

vercel Bot temporarily deployed to Preview December 4, 2025 19:13 Inactive

wip

68a5269

vercel Bot temporarily deployed to Preview December 4, 2025 19:59 Inactive

wip

e0b39ec

vercel Bot temporarily deployed to Preview December 4, 2025 20:18 Inactive

wip

9cac081

vercel Bot temporarily deployed to Preview December 4, 2025 20:19 Inactive

fix double ;; issue

30db721

vercel Bot temporarily deployed to Preview December 4, 2025 20:29 Inactive

brkalow approved these changes Dec 4, 2025

View reviewed changes

jacekradko merged commit e7c69c6 into vincent-and-the-doctor Dec 4, 2025
34 of 41 checks passed

jacekradko deleted the feat/prop-removal-codemods branch December 4, 2025 21:00

Conversation

jacekradko commented Nov 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

TODO

Checklist

Type of change

Uh oh!

vercel Bot commented Nov 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented Nov 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

coderabbitai Bot commented Nov 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

jacekradko commented Dec 3, 2025

Uh oh!

clerk-cookie commented Dec 3, 2025

Uh oh!

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

Uh oh!

Uh oh!

jacekradko commented Dec 3, 2025

Uh oh!

clerk-cookie commented Dec 3, 2025

Uh oh!

jacekradko commented Dec 4, 2025

Uh oh!

clerk-cookie commented Dec 4, 2025

Uh oh!

jacekradko commented Dec 4, 2025

Uh oh!

clerk-cookie commented Dec 4, 2025

Uh oh!

brkalow left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

This branch was previously deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

jacekradko commented Nov 24, 2025 •

edited

Loading

vercel Bot commented Nov 24, 2025 •

edited

Loading

changeset-bot Bot commented Nov 24, 2025 •

edited

Loading

coderabbitai Bot commented Nov 24, 2025 •

edited

Loading

pkg-pr-new Bot commented Dec 3, 2025 •

edited

Loading