[Bug]: Keeps trying to load react-query-4 and Hydrate

[davidosomething]

Package Scope

@suspensive/react-query

Bug description

in my package.json:

    "@suspensive/react": "^3.15.1",
    "@suspensive/react-query": "^3.15.1",
...
    "@tanstack/react-query": "^5.90.11",

pnpm why @suspensive/react-query-4
...
dependencies:
@suspensive/react-query 3.15.1
└── @suspensive/react-query-4 3.15.1

when i try to run vite on a tanstack start project:

✘ [ERROR] No matching export in "node_modules/.pnpm/@tanstack+react-query@5.90.11_react@19.2.0/node_modules/@tanstack/react-query/build/modern/index.js" for import "Hydrate"

    node_modules/.pnpm/@suspensive+react-query-4@3.15.1_@tanstack+react-query@5.90.11_react@19.2.0__react@19.2.0/node_modules/@suspensive/react-query-4/dist/QueriesHydration-C8w5Rm3q.mjs:3:9:
      3 │ import { Hydrate, QueryClient, dehydrate } from "@tanstack/react-query";
        │          ~~~~~~~
        ╵          hydrate

  Did you mean to import "hydrate" instead?

    node_modules/.pnpm/@tanstack+query-core@5.90.11/node_modules/@tanstack/query-core/build/modern/index.js:56:2:
      56 │   hydrate,
         ╵   ~~~~~~~

/home/davidosomething/projects/x/node_modules/.pnpm/esbuild@0.25.11/node_modules/esbuild/lib/main.js:1467
  let error = new Error(text);
              ^

Expected behavior

installs and does not include @suspensive+react-query-4@3.15.1

To Reproduce

pnpm 10.24.0
node v24.11.1

Possible Solution

No response

etc.

No response

[coauthors]

People can be co-author:

Candidate	Reasons	Count	Add this as commit message
@davidosomething	#1851 (comment) #1851 (comment) #1851	3	Co-authored-by: davidosomething <609213+davidosomething@users.noreply.github.com>
@gwansikk	#1851 (comment) #1851 (comment) #1851 (comment)	3	Co-authored-by: gwansikk <39869096+gwansikk@users.noreply.github.com>
@manudeli	#1851 (comment)	1	Co-authored-by: manudeli <61593290+manudeli@users.noreply.github.com>

[davidosomething]

Figured it out -- had to run suspensive-react-query fix to rebuild for v5

[manudeli]

Figured it out -- had to run suspensive-react-query fix to rebuild for v5

Or you can use @suspensive/react-query-5 directly too. We expected that you wouldn't need to run that command to fix it.
@davidosomething Could you share a reproducible repository? We’d like to clone it and dig into the issue. 🙏

@gwansikk Could I assign you to resolve this issue please? If we can't resolve this issue, I wanna support only @suspensive/react-query-4, @suspensive/react-query-5 directly without @suspensive/react-query in next major version

[davidosomething]

I was able to recreate in https://github.com/davidosomething/suspensive-1851 -- by default it seems to use v4 on a new tanstack-start project

https://github.com/davidosomething/suspensive-1851

• created using npm create @tanstack/start@latest with react-query
• added @suspensive/react-query @ 3.15.1 to package.json
• pnpm install installed
• created a demo SuspenseQuery in Header and then tried to pnpm dev and it failed

> suspensive-1851@ dev /home/davidosomething/projects/suspensive-1851
> vite dev --port 3000


  VITE v7.2.6  ready in 865 ms

  ➜  Local:   http://localhost:3000/
  ➜  Network: use --host to expose
  ➜  press h + enter to show help
file:///home/davidosomething/projects/suspensive-1851/node_modules/.pnpm/@suspensive+react-query-4@3.17.0_@tanstack+react-query@5.90.11_react@19.2.0__react@19.2.0/node_modules/@suspensive/react-query-4/dist/QueriesHydration-D-iXKM2g.mjs:4
import { Hydrate, QueryClient, dehydrate } from "@tanstack/react-query";
         ^^^^^^^
SyntaxError: The requested module '@tanstack/react-query' does not provide an export named 'Hydrate'
    at ModuleJob.#_instantiate (node:internal/modules/esm/module_job:254:21)
    ... 8 lines matching cause stack trace ...
    at /home/davidosomething/projects/suspensive-1851/src/routes/__root.tsx:9:1 {
  cause: file:///home/davidosomething/projects/suspensive-1851/node_modules/.pnpm/@suspensive+react-query-4@3.17.0_@tanstack+react-query@5.90.11_react@19.2.0__react@19.2.0/node_modules/@suspensive/react-query-4/dist/QueriesHydration-D-iXKM2g.mjs:4
  import { Hydrate, QueryClient, dehydrate } from "@tanstack/react-query";
           ^^^^^^^
  SyntaxError: The requested module '@tanstack/react-query' does not provide an export named 'Hydrate'
      at ModuleJob.#_instantiate (node:internal/modules/esm/module_job:254:21)
      at ModuleJob.run (node:internal/modules/esm/module_job:369:5)
      at onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:671:26)
      at ModuleRunner.directRequest (file:///home/davidosomething/projects/suspensive-1851/node_modules/.pnpm/vite@7.2.6_@types+node@22.19.1_jiti@2.6.1_lightningcss@1.30.2_tsx@4.21.0/node_modules/vite/dist/node/module-runner.js:1109:20)
      at ModuleRunner.cachedRequest (file:///home/davidosomething/projects/suspensive-1851/node_modules/.pnpm/vite@7.2.6_@types+node@22.19.1_jiti@2.6.1_lightningcss@1.30.2_tsx@4.21.0/node_modules/vite/dist/node/module-runner.js:1053:73)
      at /home/davidosomething/projects/suspensive-1851/src/components/Header.tsx:1:1
      at ESModulesEvaluator.runInlinedModule (file:///home/davidosomething/projects/suspensive-1851/node_modules/.pnpm/vite@7.2.6_@types+node@22.19.1_jiti@2.6.1_lightningcss@1.30.2_tsx@4.21.0/node_modules/vite/dist/node/module-runner.js:913:3)
      at ModuleRunner.directRequest (file:///home/davidosomething/projects/suspensive-1851/node_modules/.pnpm/vite@7.2.6_@types+node@22.19.1_jiti@2.6.1_lightningcss@1.30.2_tsx@4.21.0/node_modules/vite/dist/node/module-runner.js:1146:59)
      at ModuleRunner.cachedRequest (file:///home/davidosomething/projects/suspensive-1851/node_modules/.pnpm/vite@7.2.6_@types+node@22.19.1_jiti@2.6.1_lightningcss@1.30.2_tsx@4.21.0/node_modules/vite/dist/node/module-runner.js:1053:73)
      at /home/davidosomething/projects/suspensive-1851/src/routes/__root.tsx:9:1,
  status: 500,
  statusText: undefined,
  headers: undefined,
  data: undefined,
  body: undefined,
  unhandled: true
}

[gwansikk]

Thank you for reporting the issue. I am aware of the problem and will address it as soon as possible.

[gwansikk]

Currently, suspensive/react-query v3 supports both v4 and v5 of tanstack/react-query simultaneously.
This is made possible through a mechanism where, during the postinstall phase, suspensive/react-query runs a script to detect the version of tanstack/react-query installed in the user’s environment and then exports the appropriate suspensive version.
(More information is available here: https://suspensive.org/docs/react-query/tanstack-query-compatibility)

This issue is due to a change in script execution policy in pnpm 10.4 and does not affect npm or yarn users.

The issue arises with pnpm v10.4 and above, which restricts third-party scripts by default (they must be explicitly allowed).
As a result, suspensive/react-query cannot detect the user's installed version of tanstack/react-query and defaults to exporting v4, causing a mismatch error.
(For example, the user has tanstack/react-query v5, but suspensive/react-query-4 is exported, leading to a Hydrate error.)

Solutions:

1. If using pnpm 10.4 or above, enable approve-builds

Explicitly approve suspensive/react-query to allow it to run its install scripts.
This allows the correct version to be matched at postinstall.

pnpm approve-builds

After approving, delete node_modules and reinstall for the script to run properly.

ref: https://pnpm.io/cli/approve-builds

---

2. Use the Suspensive CLI (Recommended)

An official CLI tool is provided to resolve the versioning issue manually:

npx suspensive-react-query fix

ref: https://suspensive.org/ko/docs/react-query/tanstack-query-compatibility#fix

---

3. Manually install version-specific packages (Not recommended)

• For tanstack/react-query v4: use @suspensive/react-query-4
• For tanstack/react-query v5: use @suspensive/react-query-5

This bypasses the auto-detection but requires you to manage versions manually.

ref:

• https://www.npmjs.com/package/@suspensive/react-query-4
• https://www.npmjs.com/package/@suspensive/react-query-5

[gwansikk]

@gwansikk Could I assign you to resolve this issue please? If we can't resolve this issue, I wanna support only @suspensive/react-query-4, @suspensive/react-query-5 directly without @suspensive/react-query in next major version

I agree. However, I would like to try all the necessary solutions only if the issue persists.
Currently, I’m not sure how to resolve the problem, but I’ll look into how other libraries handle similar cases and attempt a fix based on that.
(Another thought is that since this issue is caused by pnpm’s unique script execution policy changes, I’m not fully convinced that providing versions manually is the right approach.)

Additionally, I’ve heard reports that the automatic version-matching mechanism also causes issues in Yarn Berry environments.
I’ll look into it and try the necessary measures accordingly.