Skip to content

Conversation

wobsoriano
Copy link
Member

@wobsoriano wobsoriano commented Sep 23, 2025

Description

TanStack Router v1.132.0 RC introduced features that include breaking changes to our custom server handler, which breaks our Clerk TanStack Start SDK integration. This PR will maintain compatibility while waiting for the next version which will have the updated API and be the last API before TanStack Start and our SDK goes to stable 🥳

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

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Summary by CodeRabbit

  • Chores
    • Prepared a minor release for the TanStack React Start integration.
    • Pinned TanStack dependencies to stable pre-RC versions to improve stability and avoid potential breaking changes.
    • Tightened peer dependency ranges to require versions below 1.132.0 for compatibility.
    • Ensures consistent development environment by removing caret ranges and using exact versions.
    • No user-facing changes; existing apps remain unaffected if using supported TanStack versions.

Copy link

changeset-bot bot commented Sep 23, 2025

🦋 Changeset detected

Latest commit: 08d750f

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

This PR includes changesets to release 1 package
Name Type
@clerk/tanstack-react-start Minor

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

Copy link

vercel bot commented Sep 23, 2025

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

Project Deployment Preview Comments Updated (UTC)
clerk-js-sandbox Ready Ready Preview Comment Sep 23, 2025 9:54pm

Copy link
Contributor

coderabbitai bot commented Sep 23, 2025

Walkthrough

This PR adds a changeset for a minor release and updates package.json in packages/tanstack-react-start to pin devDependency versions and constrain peerDependency ranges for @tanstack/react-router and @tanstack/react-start below 1.132.0.

Changes

Cohort / File(s) Change Summary
Release metadata
\.changeset/fast-dolls-float.md
Adds a changeset marking a minor release for "@clerk/tanstack-react-start" and noting TanStack version constraints (<1.132.0).
Package manifest constraints
packages/tanstack-react-start/package.json
Pins devDependencies @tanstack/react-router and @tanstack/react-start to 1.131.34; tightens peerDependencies to "^1.131.0 <1.132.0"; no code changes.

Sequence Diagram(s)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

I thump with joy—versions snug and neat,
Pinned like carrots in a tidy seat.
Peer bounds set, below the RC’s crest,
I hop through semvers, doing my best.
Minor release breeze, whiskers twitch—
Dependency garden, no sneaky glitch.

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The title is concise and accurately summarizes the primary change: constraining TanStack dependencies for the tanstack-react-start package to pre-RC versions; this directly matches the package.json peer dependency adjustments and the changeset in the PR, so a reviewer scanning history will understand the main intent.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch rob/tanstack-pre-rc

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

Copy link

pkg-pr-new bot commented Sep 23, 2025

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@6845

@clerk/clerk-expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/clerk-react

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

@clerk/react-router

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

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@6845

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@6845

@clerk/types

npm i https://pkg.pr.new/@clerk/types@6845

@clerk/upgrade

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

@clerk/vue

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

commit: 08d750f

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (3)
.changeset/fast-dolls-float.md (1)

5-5: Tighten wording to list affected packages explicitly.

Spell out “@tanstack/react-router and @tanstack/react-start” to remove ambiguity from “@tanstack/*”.

-Constrained TanStack dependencies to pre-RC versions. Please ensure you're using `@tanstack/*` versions below `1.132.0`.
+Constrained TanStack dependencies to pre-RC versions. Please ensure you're using `@tanstack/react-router` and `@tanstack/react-start` versions below `1.132.0`.
packages/tanstack-react-start/package.json (2)

79-81: Good dev pinning to pre‑RC; consider adding pnpm overrides to prevent accidental hoisting.

In monorepos, a higher RC elsewhere can hoist and leak via dedupe. pnpm.overrides at the package level guarantees 1.131.34 resolution for local dev.

Add overrides:

 {
   "name": "@clerk/tanstack-react-start",
   ...
   "devDependencies": {
     "@tanstack/react-router": "1.131.34",
     "@tanstack/react-start": "1.131.34",
     "esbuild-plugin-file-path-extensions": "^2.1.4"
   },
+  "pnpm": {
+    "overrides": {
+      "@tanstack/react-router": "1.131.34",
+      "@tanstack/react-start": "1.131.34"
+    }
+  },
   "peerDependencies": {
     ...
   }
 }

84-86: Use explicit bounded ranges; <1.132.0 already excludes prereleases

Replace ^1.131.0 <1.132.0 with >=1.131.0 <1.132.0 for clarity across npm/Yarn/pnpm — both forms are equivalent, and node-semver will NOT match prereleases like 1.132.0-rc.* unless the range mentions a prerelease or includePrerelease is used.

-    "@tanstack/react-router": "^1.131.0 <1.132.0",
-    "@tanstack/react-start": "^1.131.0 <1.132.0",
+    "@tanstack/react-router": ">=1.131.0 <1.132.0",
+    "@tanstack/react-start": ">=1.131.0 <1.132.0",
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 8ff6155 and 08d750f.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (2)
  • .changeset/fast-dolls-float.md (1 hunks)
  • packages/tanstack-react-start/package.json (1 hunks)
🧰 Additional context used
📓 Path-based instructions (3)
.changeset/**

📄 CodeRabbit inference engine (.cursor/rules/monorepo.mdc)

Automated releases must use Changesets.

Files:

  • .changeset/fast-dolls-float.md
**/*.{js,jsx,ts,tsx,json,css,scss,md,yaml,yml}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

Use Prettier for consistent code formatting

Files:

  • packages/tanstack-react-start/package.json
packages/*/package.json

📄 CodeRabbit inference engine (.cursor/rules/global.mdc)

All publishable packages should be placed under the packages/ directory

packages/*/package.json: All publishable packages must be located in the 'packages/' directory.
All packages must be published under the @clerk namespace on npm.
Semantic versioning must be used across all packages.

Files:

  • packages/tanstack-react-start/package.json
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (24)
  • GitHub Check: Integration Tests (react-router, chrome)
  • GitHub Check: Integration Tests (nextjs, chrome, 15)
  • GitHub Check: Integration Tests (billing, chrome)
  • GitHub Check: Integration Tests (machine, chrome)
  • GitHub Check: Integration Tests (nextjs, chrome, 14)
  • GitHub Check: Integration Tests (vue, chrome)
  • GitHub Check: Integration Tests (expo-web, chrome)
  • GitHub Check: Integration Tests (custom, chrome)
  • GitHub Check: Integration Tests (nuxt, chrome)
  • GitHub Check: Integration Tests (sessions, chrome)
  • GitHub Check: Integration Tests (tanstack-react-start, chrome)
  • GitHub Check: Integration Tests (astro, chrome)
  • GitHub Check: Integration Tests (tanstack-react-router, chrome)
  • GitHub Check: Integration Tests (quickstart, chrome)
  • GitHub Check: Integration Tests (elements, chrome)
  • GitHub Check: Integration Tests (generic, chrome)
  • GitHub Check: Integration Tests (localhost, chrome)
  • GitHub Check: Integration Tests (ap-flows, chrome)
  • GitHub Check: Integration Tests (express, chrome)
  • GitHub Check: Publish with pkg-pr-new
  • GitHub Check: Unit Tests (22, **)
  • GitHub Check: Unit Tests (18, --filter=@clerk/astro --filter=@clerk/backend --filter=@clerk/express --filter=@c...
  • GitHub Check: Static analysis
  • GitHub Check: semgrep-cloud-platform/scan
🔇 Additional comments (1)
.changeset/fast-dolls-float.md (1)

1-3: Changeset looks correct; confirm release type aligns with policy.

Minor bump makes sense, but narrowing peer ranges can be construed as breaking for users already on 1.132.0 RC. Confirm this matches your semver/release policy for the SDK.

Would you like to bump this to major to reflect the stricter peer range, or keep minor since RC users are already broken?

@panteliselef
Copy link
Member

@wobsoriano this should be safe to merge then, right ?

@wobsoriano
Copy link
Member Author

@wobsoriano this should be safe to merge then, right ?

Yes!

@wobsoriano wobsoriano merged commit a39f2fc into main Sep 24, 2025
42 checks passed
@wobsoriano wobsoriano deleted the rob/tanstack-pre-rc branch September 24, 2025 15:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants