fix: tighten cache implementation constraints

[DaleSeo]

As a quick follow-up to PR #13250, this fixes some cache override typing paths that still allowed ApolloCache, while the public mutation and refetch APIs now expect Cache.Implementation. Keeping these constraints aligned ensures that user-declared cache overrides work consistently through QueryInfo, internal refetch options, and deprecated React mutation aliases. We also regenerated the API reports so that the published type surface shows the corrected constraints.

Summary by CodeRabbit

• Chores
  • Aligned cache-related type constraints across the library for consistency. TypeScript users working with custom cache implementations may notice updated type signatures in mutation helpers and query-related APIs.

[changeset-bot]

🦋 Changeset detected

Latest commit: 419e2b5

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

This PR includes changesets to release 1 package

Name	Type
@apollo/client	Patch

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

[apollo-librarian]

✅ Docs preview ready

The preview is ready to be viewed. View the preview

File Changes

0 new, 3 changed, 0 removed

* graphos/routing/(latest)/header-propagation.mdx
* graphos/routing/(latest)/configuration/yaml.mdx
* graphos/routing/(latest)/security/cors.mdx

Build ID: fe99398cf5f6b14f91f73e18
Build Logs: View logs

URL: https://www.apollographql.com/docs/deploy-preview/fe99398cf5f6b14f91f73e18

---

✅ AI Style Review — No Changes Detected

No MDX files were changed in this pull request.

Review Log: View detailed log

This review is AI-generated. Please use common sense when accepting these suggestions, as they may not always be accurate or appropriate for your specific context.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

Run ID: bbc7a8dc-fff9-4da7-91c4-e5f1f55a0699

📥 Commits

Reviewing files that changed from the base of the PR and between 9cd2f1d and 419e2b5.

📒 Files selected for processing (8)

• .api-reports/api-report-core.api.md
• .api-reports/api-report-react.api.md
• .api-reports/api-report.api.md
• .changeset/tidy-cache-type-constraints.md
• .size-limits.json
• src/core/QueryInfo.ts
• src/core/types.ts
• src/react/types/deprecated.ts

---

📝 Walkthrough

Walkthrough

This PR systematically migrates generic TCache type constraints from ApolloCache to Cache.Implementation across core query types, React deprecated mutation helpers, and their API reports, aligning the library's exported type surface with the overridable cache interface.

Changes

Cache Type Constraint Unification

Layer / File(s)	Summary
Core type constraints migration src/core/types.ts, src/core/QueryInfo.ts, .api-reports/api-report-core.api.md, .api-reports/api-report.api.md	InternalRefetchQueriesOptions and QueryInfo update their TCache generic bounds from ApolloCache to Cache.Implementation, with imports switched to Cache from @apollo/client/cache. Generated API reports reflect the signature changes.
React deprecated mutation types constraint migration src/react/types/deprecated.ts, .api-reports/api-report-react.api.md	Deprecated mutation helper types (MutationHookOptions, MutationFunctionOptions, MutationTuple) update their TCache constraints and defaults from ApolloCache to Cache.Implementation, with imports adjusted accordingly. API report is regenerated to match.
Changeset documentation and size limits .changeset/tidy-cache-type-constraints.md, .size-limits.json	Changeset documents the alignment of remaining cache generic constraints with Cache.Implementation. Bundle size limits are updated for four Apollo Client import variants.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• apollographql/apollo-client#13250: Both PRs refactor the same exported/public typings to swap ApolloCache-based TCache constraints/defaults over to Cache.Implementation (including refetch/mutate and React mutation-related generic types), aligning cache typing with the new overridable TypeOverrides.cache mechanism.

Suggested reviewers

• jerelmiller
• phryneas
• pragl

Poem

🐰 From Apollo's cache, a tidy refrain,
Type constraints now unified, crystal and plain,
Cache.Implementation rings out so true,
Generic bounds lessoned—the old ApolloCache too,
Mutations and queries aligned in the chase! 🌙✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'fix: tighten cache implementation constraints' is fully related to the main change in the changeset, which updates TypeScript generic type constraints from ApolloCache to Cache.Implementation across multiple files for consistency.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

src/core/QueryInfo.ts

ESLint skipped: missing config or dependency (missing-dependency). The ESLint configuration references a package that is not available in the sandbox.

src/core/types.ts

ESLint skipped: the ESLint configuration for this file references a package that is not available in the sandbox.

src/react/types/deprecated.ts

ESLint skipped: the ESLint configuration for this file references a package that is not available in the sandbox.

---

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 and usage tips.}

[pkg-pr-new]

npm i https://pkg.pr.new/@apollo/client@13268

commit: 419e2b5

[jerelmiller]

I could have sworn I updated these. I remember doing so, but I must have git reset --hard by accident or something 🤔. Anyways, thanks for getting the rest!