React router types in rootAuthLoader callback function not working on newest release

[lasseklovstad]

Preliminary Checks

• I have reviewed the documentation: https://clerk.com/docs

• I have searched for existing issues: https://github.com/clerk/javascript/issues

• I have not already reached out to Clerk support via email or Discord (if you have, no need to open an issue here)

• This issue is not a question, general help request, or anything other than a bug report directly related to Clerk. Please ask questions in our Discord community: https://clerk.com/discord.

Reproduction

https://github.com/lasseklovstad/bug-clerk-rootloader-types

Publishable key

.

Description

Steps to reproduce:

1. install the latest libraries from react-router and clerk
2. try using the callback function in rootAuthLoader

Expected behavior:

The types in the callback function is correct

Actual behavior:

The types are any

Environment

System:
    OS: Windows 11 10.0.26100
    CPU: (12) x64 Intel(R) Core(TM) i7-10850H CPU @ 2.70GHz
    Memory: 12.68 GB / 31.78 GB
  Binaries:
    Node: 22.13.1 - C:\Program Files\nodejs\node.EXE
    npm: 10.9.2 - C:\Program Files\nodejs\npm.CMD
    pnpm: 10.2.1 - C:\Program Files\nodejs\pnpm.CMD
    bun: 1.2.2 - ~\.bun\bin\bun.EXE
  Browsers:
    Edge: Chromium (134.0.3124.51)
    Internet Explorer: 11.0.26100.1882
  npmPackages:
    @clerk/react-router: ^1.4.6 => 1.4.6
    @react-router/dev: ^7.5.3 => 7.6.1
    @react-router/node: ^7.5.3 => 7.6.1
    @react-router/serve: ^7.5.3 => 7.6.1
    @tailwindcss/vite: ^4.1.4 => 4.1.7
    @types/node: ^20 => 20.17.50
    @types/react: ^19.1.2 => 19.1.5
    @types/react-dom: ^19.1.2 => 19.1.5
    isbot: ^5.1.27 => 5.1.28
    react: ^19.1.0 => 19.1.0
    react-dom: ^19.1.0 => 19.1.0
    react-router: ^7.5.3 => 7.6.1
    tailwindcss: ^4.1.4 => 4.1.7
    typescript: ^5.8.3 => 5.8.3
    vite: ^6.3.3 => 6.3.5
    vite-tsconfig-paths: ^5.1.4 => 5.1.4

[lasseklovstad]

It seems like they renamed the internal react-router/route-module export to react-router/internal, which is causing this issue i guess.

https://github.com/remix-run/react-router/blob/main/CHANGELOG.md#unstable-changes

[lasseklovstad]

I also notices when reading the docs that th callback option is wrong it is using req but it is actually request
https://clerk.com/docs/references/react-router/root-auth-loader

[LekoArts]

Thanks for the issue! I've put up a PR to update the docs here: clerk/clerk-docs#2264

[lasseklovstad]

No problem! Could it be an option to refactor rootAuthLoader not to be dependent on LoaderFunctionArgs but just the Request? Then you won't have to rely on the internal types of react-router.

Edit:
I see in the source code that the clerk library finds the env variables from the context. SO I guess for some envirements like cloudflare it is dependent on the AppLoadContext... You could avoid this by letting the user just pass inn the variables them self. With the new middleware context introduced some changes needs to be done i guess.

[LekoArts]

Throughout our SDKs we follow the pattern of preferring environment variables over having our users to pass options. So I wouldn't want to change this for the React Router SDK alone.

I have a PR in draft to update the types, we need to decide whether to put this into a minor or major. If the latter, if we want to change anything else. #6019

[LekoArts]

@lasseklovstad Can you please try the preview of the PR in your environment and report back?

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

I removed the reliance on these internal types completely, it should behave the same in older and newer versions now.

[lasseklovstad]

@LekoArts looks good to me

[LekoArts]

Thanks for testing, appreciate it 👍