fix({react,preact}-query): add NoInfer to infinite and suspense hook return types

[S-jooyoung]

🎯 Changes

Follow-up to #8639: useQuery's return types already fence TData with NoInfer, but useInfiniteQuery, useSuspenseQuery, and useSuspenseInfiniteQuery still let an explicitly annotated result type reverse-infer TData — an annotation that contradicts the actual queryFn/select type compiles fine and then fails at runtime (the scenario reported in #8639).

• Wrap TData in the return types of useInfiniteQuery (all three overloads), useSuspenseQuery, and useSuspenseInfiniteQuery, in both react-query and preact-query (mirroring the cross-package approach of fix({react,preact}-query): default 'TData' of infinite query options to 'InfiniteData' #11147).
• Use a distributive wrapper (type NarrowableNoInfer<T> = T extends unknown ? NoInfer<T> : never) instead of plain NoInfer: plain NoInfer breaks negative-branch discriminated-union narrowing on data — the regression useQuery return type NoInfer preserves reverse-inference guard but breaks discriminated-union narrowing #11018 reports for useQuery, and the same shape fix(react-query): preserve narrowing with NoInfer #11022 proposes there. I kept the helper file-local to avoid touching useQuery.ts and conflicting with that PR; happy to consolidate once either lands.
• Add type tests for each hook: the annotated-result reverse-inference guard (mirroring the existing useQuery test) plus a discriminated-union narrowing case.

Runtime behavior is unchanged — types only.

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

• This change affects published code, and I have generated a changeset.
• This change is docs/CI/dev-only (no release).

🤖 Generated with Claude Code

Summary by CodeRabbit

• Bug Fixes

  • Improved TypeScript type inference for infinite and suspense query hooks.
  • Explicitly annotated result types no longer incorrectly influence inferred query data types.
  • Preserved discriminated-union narrowing when transforming or selecting query data.

• Tests

  • Added coverage for improved inference and type narrowing across React and Preact query hooks.

[coderabbitai]

📝 Walkthrough

Walkthrough

React Query and Preact Query hooks now use distributive NarrowableNoInfer wrappers for returned TData. Type tests cover inference against annotated results and discriminated-union narrowing. A changeset records patch releases.

Changes

Query hook type inference

Layer / File(s)	Summary
React hook return typing and validation packages/react-query/src/useInfiniteQuery.ts, packages/react-query/src/useSuspenseInfiniteQuery.ts, packages/react-query/src/useSuspenseQuery.ts, packages/react-query/src/__tests__/*	React hooks apply NarrowableNoInfer to returned data types. Type tests verify query-argument inference and discriminated-union narrowing.
Preact hook return typing and validation packages/preact-query/src/useInfiniteQuery.ts, packages/preact-query/src/useSuspenseInfiniteQuery.ts, packages/preact-query/src/useSuspenseQuery.ts, packages/preact-query/src/__tests__/*, .changeset/noinfer-infinite-suspense-hooks.md	Preact hooks apply the same return-type wrapper. Matching type tests cover inference and narrowing. The changeset records patch releases for both query packages.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

• TanStack/query#11147: Both PRs modify TData typing and inference for infinite-query hooks.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly identifies the NoInfer changes to infinite and suspense query hook return types in both React and Preact packages.
Description check	✅ Passed	The description explains the motivation, implementation, tests, checklist completion, runtime impact, and changeset release impact.
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.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/preact-query/src/__tests__/useInfiniteQuery.test-d.tsx`:
- Line 178: Remove the duplicate `{ type: 'second'; second: string }` member
from each affected type assertion, retaining exactly one member in
packages/preact-query/src/__tests__/useInfiniteQuery.test-d.tsx:178,
packages/preact-query/src/__tests__/useSuspenseInfiniteQuery.test-d.tsx:129, and
packages/preact-query/src/__tests__/useSuspenseQuery.test-d.tsx:118. Preserve
the surrounding NarrowableNoInfer assertions.

🪄 Autofix

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: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: cc8a149c-fd6a-4ab5-a1f5-5016d40cf785

📥 Commits

Reviewing files that changed from the base of the PR and between 46d7f02 and f29d2ff.

📒 Files selected for processing (13)

• .changeset/noinfer-infinite-suspense-hooks.md
• packages/preact-query/src/__tests__/useInfiniteQuery.test-d.tsx
• packages/preact-query/src/__tests__/useSuspenseInfiniteQuery.test-d.tsx
• packages/preact-query/src/__tests__/useSuspenseQuery.test-d.tsx
• packages/preact-query/src/useInfiniteQuery.ts
• packages/preact-query/src/useSuspenseInfiniteQuery.ts
• packages/preact-query/src/useSuspenseQuery.ts
• packages/react-query/src/__tests__/useInfiniteQuery.test-d.tsx
• packages/react-query/src/__tests__/useSuspenseInfiniteQuery.test-d.tsx
• packages/react-query/src/__tests__/useSuspenseQuery.test-d.tsx
• packages/react-query/src/useInfiniteQuery.ts
• packages/react-query/src/useSuspenseInfiniteQuery.ts
• packages/react-query/src/useSuspenseQuery.ts