Release 4.0 #12201

jerelmiller · 2024-12-09T18:23:39Z

Staging branch for all 4.0 changes

svc-apollo-docs · 2024-12-09T18:23:43Z

🛠️ Docs preview building...

The preview is currently being built.

Build ID: 7c1e3325e91f9e6e896fc41e

changeset-bot · 2024-12-09T18:23:43Z

⚠️ No Changeset found

Latest commit: 0517163

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

pkg-pr-new · 2024-12-09T18:24:35Z

npm i https://pkg.pr.new/apollographql/apollo-client/@apollo/client@12201

commit: 0517163

netlify · 2024-12-09T18:24:48Z

✅ Deploy Preview for apollo-client-docs ready!

Name	Link
🔨 Latest commit	`50dc13f`
🔍 Latest deploy log	https://app.netlify.com/sites/apollo-client-docs/deploys/6802796ab822e40008318f86
😎 Deploy Preview	https://deploy-preview-12201--apollo-client-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

github-actions · 2024-12-09T18:25:06Z

size-limit report 📦

Path	Size
dist/apollo-client.min.cjs	0 B (-100% 🔽)
import { ApolloClient, InMemoryCache, HttpLink } from "@apollo/client" (CJS)	42.7 KB (-15.93% 🔽)
import { ApolloClient, InMemoryCache, HttpLink } from "@apollo/client" (production) (CJS)	37.78 KB (-21.1% 🔽)
import { ApolloClient, InMemoryCache, HttpLink } from "@apollo/client"	32.65 KB (-10.14% 🔽)
import { ApolloClient, InMemoryCache, HttpLink } from "@apollo/client" (production)	26.97 KB (-20.06% 🔽)
import { ApolloProvider } from "@apollo/client/react"	5.7 KB (+353.31% 🔺)
import { ApolloProvider } from "@apollo/client/react" (production)	960 B (-24.41% 🔽)
import { useQuery } from "@apollo/client/react"	6.99 KB (-30.74% 🔽)
import { useQuery } from "@apollo/client/react" (production)	2.23 KB (-75.26% 🔽)
import { useLazyQuery } from "@apollo/client/react"	6.89 KB (-27.37% 🔽)
import { useMutation } from "@apollo/client/react"	6.22 KB (+72.03% 🔺)
import { useMutation } from "@apollo/client/react" (production)	1.48 KB (-47.87% 🔽)
import { useSubscription } from "@apollo/client/react"	6.57 KB (+48.47% 🔺)
import { useSubscription } from "@apollo/client/react" (production)	1.81 KB (-48.03% 🔽)
import { useSuspenseQuery } from "@apollo/client/react"	8.34 KB (+41.69% 🔺)
import { useSuspenseQuery } from "@apollo/client/react" (production)	3.62 KB (-20.59% 🔽)
import { useBackgroundQuery } from "@apollo/client/react"	8.13 KB (+51.02% 🔺)
import { useBackgroundQuery } from "@apollo/client/react" (production)	3.38 KB (-16.39% 🔽)
import { useLoadableQuery } from "@apollo/client/react"	8.07 KB (+47.53% 🔺)
import { useLoadableQuery } from "@apollo/client/react" (production)	3.36 KB (-18.35% 🔽)
import { useReadQuery } from "@apollo/client/react"	6.37 KB (+85.53% 🔺)
import { useReadQuery } from "@apollo/client/react" (production)	1.62 KB (-51.87% 🔽)
import { useFragment } from "@apollo/client/react"	6.45 KB (+172.98% 🔺)
import { useFragment } from "@apollo/client/react" (production)	1.7 KB (-26.44% 🔽)
import { useLazyQuery } from "@apollo/client/react" (production)	2.13 KB (+100% 🔺)

* move from `ts-node` to `node --experimental-strip-types`, create `build.ts` * remove `engines` field, specify `devEngines` * adjust node version for CI * fix up some more syntax * prettier * adjust precheck, bump minimal lockfile version to 3 * convert jest config to esm * move `entryPoints` to TS, make it work in mjs and jest * run rollup with ts config * update a few more node calls * some more typings * move all scripts to function invocation * migrate `prepareChangestsRelease` too * remove scripts that are not called manually * convert `prepareDist` to TS * migrate `precheck.js` * `version.js->ts` * use jest ts config * prettier * dirname.cjs->cts * dirname-related import fixes * fix up new knip issues * delete `devEngines` instead of `engines` field * require node 23.6 instead of 22.6

… `ApolloQueryResult` (#12333)

…LazyQuery` (#12359)

…#12379)

* omit rollup build step * verifyVersion: verify different entry point * build esm and cjs (with `.cjs` extension) into different folders * add a validation check to see if sourcemaps are correct * adjustments * remove `rewriteSourceMaps` step the `inlineSources` tsconfig options already does that * processInvariants step * run `prepareDist` * prettier * fix up processInvariant exceptions * delete test for rolled-up build * tests: older compilation target * additional tsconfig adjustments * format * fix up invariants processing * add `version` step * rename option * migrate `inlineInheritDoc` step * migrate `postprocessDist` over * remove dead code * fix up comment framing * remove stray `console.log` * update size limits * move `renameJsFilesToCjs` file out * remove obsolete setting of `type: "module"` in `prepareDist` * `processComments`: exit early * add changeset

* add babel transform * remove unneccessary packages * Update config/babel.ts * Clean up Prettier, Size-limit, and Api-Extractor --------- Co-authored-by: phryneas <[email protected]>

* move entry points out of `entryPoints` into `package.json` exports * build working, jest not working * formatter * fixup jest * add custom resolver, explicitly import `__DEV__` * prettier * missing import * import `__DEV__` when inserted by `processInvariants` * no more type checking in jest * use same tsconfig for tests * reorder ci steps * update api reports * use conditions in size limits * fix up a bunch of things * attw green * remove side-effect import for `utilities/globals` * mark `__DEV__` export as `boolean` in all envs * add section for `.d.cts` * size-limit plugin, more dev mode * work around api extractor package resolution * knip: ignore `size-limit-apollo-plugin` * some more cleanup * add step to script * fixup * more changelog * size-limits for better between-build comparison * add two new eslint rules * apply eslint autofixes * manually fix a bunch of internal-cross-imports * adjust sizes * ignore a few cross-imports that are fine * prettier * api-exports * move side effects for `setVerbosity` into `utilities/globals/environment` * fix up circularities, add check * move `invariantWrappers.ts` into `invariant/shared.ts` * inline ts-invariant, no more side effects in __DEV__ declaration * update exports * lint * fix up a bunch of imports * forgotten file * fix up import * set default log level for tests * fix up dev entrypoint circularity * fix up a few things around invariant, changelog * disable eslint rule for wrapping reexport * add `/index.js` and `folder/folder.cjs` entry points to exports field * add CI step to run publint * create `legacyEntryPoints` instead with a subpath pattern in package.json * reconfigure integration tests to work around npm bug * fix imports in integration tests * actually call IIFE * skip "latest React" intallation for cra4 and cra5 * also run integration tests with react 18 * pin 18.3.1 * fix up node esm tests * just keep 18.3.0 * deduplicate test setup * move files out of accidentally nested folder * also run forgotten jobs * integration test dep mgmt * downgrade a tick * force downgrade in lockfile * dedupe only where necessary * npmrc * update @vitejs/plugin-react-swc and vite * skip two more runs * dump package lock * adjust dedupe command * try switching to pnpm * adjust run commands * add `--no-frozen-lockfile` * hoist * use overrides correctly * drop CRA4 integration test * CI * add playwright dep on root level * prettierignore pnpm-lock.yaml * fixup next.js integration test * fix up more imports * format * changesets * some cleanup * chores * Update config/build.ts Co-authored-by: Jerel Miller <[email protected]> * Update .changeset/real-gorillas-move.md Co-authored-by: Jerel Miller <[email protected]> * Clean up Prettier, Size-limit, and Api-Extractor * adjust next integration test `ci-preparations` command * adjust import in integration test --------- Co-authored-by: Jerel Miller <[email protected]> Co-authored-by: phryneas <[email protected]>

* switch imports to entry-point imports in tests where possible * configure eslint plugin, update * first run * remove `"import/extensions"` eslint rule it's no longer necessary as we now use `"moduleResolution": "NodeNext"` that also makes the patch obsolete * more reordering * final import order? * remove `import/extensions` everywhere * run format * api-reports * fixup typecheck command * size-limits * format * fixup dirname ts quirk * run typecheck first * cleanup * update size-limits

…re` (#12739)

Co-authored-by: Lenz Weber-Tronic <[email protected]> Co-authored-by: phryneas <[email protected]>

Co-authored-by: Lenz Weber-Tronic <[email protected]> Co-authored-by: jerelmiller <[email protected]>

…operation`. (#12748) Co-authored-by: Jerel Miller <[email protected]> Co-authored-by: jerelmiller <[email protected]>

* Add refetchObservableQueries * Bind differently * Use non-deprecated method name * Add changeset * Rerun api report * Update size limits * adjust changeset * remove duplicate runtime assignment --------- Co-authored-by: Lenz Weber-Tronic <[email protected]>

* inline React Compiler runtime * remove runtime peerDependency * export tests * fix CRA5? * comment * api report * add as `react-compiler` export condition * use compiled version in CI tests * ensure `react-compiler` export isn't swallowed * also add `@apollo/client/react/compiled` entry point * legacy node10 exports * chores * remove exports condition * Clean up Prettier, Size-limit, and Api-Extractor * changeset --------- Co-authored-by: phryneas <[email protected]>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

apollo-librarian · 2025-07-07T16:30:39Z

❌ Docs preview failed

The preview failed to build.

Build ID: 622bb401d5ff5d81cf3a93c3

Errors

react/api/react/hooks

No item found for @apollo/client/react!useQuery:function(1)

…gment` (#12757) * add `dataState` to `useFragment`, `DataValue` type to `useSuspenseFragment` * Update .changeset/slimy-meals-work.md Co-authored-by: Jerel Miller <[email protected]> * Update .changeset/slimy-pots-bow.md Co-authored-by: Jerel Miller <[email protected]> --------- Co-authored-by: Jerel Miller <[email protected]>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Lenz Weber-Tronic <[email protected]>

apollo-librarian · 2025-07-16T07:51:14Z

🛠️ Docs preview building...

The preview is currently being built.

Build ID: 26a114346dc826872c9d2933

* changeset annotations * moar * forgot to save a file * finish categorization * add categorized changesets * start ordering changesets into stories * `rxjs` and `ObservableQuery` reordering * PR review feedback * update categorization

apollo-librarian · 2025-07-17T12:10:29Z

🛠️ Docs preview building...

The preview is currently being built.

Build ID: 22829ed7ba91ef2d2ce973c6

* changeset annotations * moar * forgot to save a file * finish categorization * add categorized changesets * start ordering changesets into stories * `rxjs` and `ObservableQuery` reordering * delete unused documentation files * documentation updates for `ObservableQuery` api docs * remove unused frontmatter * update `useQuery` documented interfaces, split into sub-namespaces * document new `notifyOnNetworkStatus` default values * more adjustments * more `ObservableQuery` changes * some more adjustments * chores * introduce basic claude setup * some additional changes to the `queries` page * more canonicalReference updates * PR suggestions * Apply suggestions from code review Co-authored-by: Jerel Miller <[email protected]> * more feedback * move `ObservableMethods` into `ObservableQuery.DocumentationTypes` * chores --------- Co-authored-by: Jerel Miller <[email protected]>

…aState` to `watchFragment` (#12776) Co-authored-by: Lenz Weber-Tronic <[email protected]> Co-authored-by: jerelmiller <[email protected]>

apollo-librarian · 2025-07-17T17:16:59Z

🛠️ Docs preview building...

The preview is currently being built.

Build ID: df7722e7279956aaab343eef

apollo-librarian · 2025-07-17T20:22:46Z

🛠️ Docs preview building...

The preview is currently being built.

Build ID: 99c8e51571f4d94c83e05f6d

…nts the same as fields without arguments (#12370) Co-authored-by: Jerel Miller <[email protected]>

apollo-librarian · 2025-07-17T21:57:12Z

🛠️ Docs preview building...

The preview is currently being built.

Build ID: 622bb401d5ff5d81cf3a93c3

jerelmiller and others added 25 commits January 28, 2025 14:58

Merge branch 'main' into release-4.0

3623e28

some more knip reportings (#12314)

b69d07b

remove dependency on mocha from memory tests (#12320)

2a62324

Merge remote-tracking branch 'origin/main' into release-4.0

f88e807

Fix tests affected by change to cache (#12330)

0429fb9

Deprecate partial and ensure its correctness. Fix type of data in…

3e4beaa

… `ApolloQueryResult` (#12333)

update node-version for React canary test cronjob

7733209

Merge remote-tracking branch 'origin/main' into release-4.0

fa7e6b8

Fix failing fetchMore test added in 3.12.11 (#12358)

bf37eef

Remove onCompleted and onError callbacks from useQuery and `use…

ebb4d96

…LazyQuery` (#12359)

Merge remote-tracking branch 'origin/main' into release-4.0

84cc504

Fix failing tests due to changes in 4.0 branch (#12373)

0e00395

Remove deprecated ignoreResults option from useMutation (#12376)

a0c996a

Remove deprecated UpdateQueryFn type (#12374)

0fa4914

Merge remote-tracking branch 'origin/main' into release-4.0

9ed45c5

Remove addTypename option from InMemoryCache and MockedProvider (…

ef892b4

…#12379)

Rework build process 2/?: add babel transform (#12382)

033723b

* add babel transform * remove unneccessary packages * Update config/babel.ts * Clean up Prettier, Size-limit, and Api-Extractor --------- Co-authored-by: phryneas <[email protected]>

Remove leftover of addTypename (#12406)

a6a978e

Remove unneeded devtools code (#12397)

2545a54

Use {} instead of Object.create(null) (#12402)

903c3ef

Minor refactor (#12390)

388ba97

jerelmiller and others added 2 commits June 25, 2025 11:12

Fix type of error argument for onError callback to `subscribeToMo…

b184754

…re` (#12739)

4.0 import rename codemod (#12727)

b845906

Co-authored-by: Lenz Weber-Tronic <[email protected]> Co-authored-by: phryneas <[email protected]>

phryneas force-pushed the release-4.0 branch from 8a155cf to b845906 Compare June 27, 2025 08:53

allow Complete and Partial datastate type overrides (#12740)

1c6e03c

github-actions bot mentioned this pull request Jun 27, 2025

Version Packages (rc) #12741

Merged

jerelmiller and others added 9 commits June 27, 2025 11:28

Improve operation type for SetContextLink (#12742)

575bf3e

Co-authored-by: Lenz Weber-Tronic <[email protected]> Co-authored-by: jerelmiller <[email protected]>

Fix a bug where the new operationType property wasn't passed into `…

e1ca85e

…operation`. (#12748) Co-authored-by: Jerel Miller <[email protected]> Co-authored-by: jerelmiller <[email protected]>

Version Packages (rc) (#12741)

0e686a1

Merge branch 'main' into release-4.0

9c859b0

Version Packages (rc) (#12754)

5ff16fb

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

install packages in postrelease step so semver is available

7a204f5

fix docmodel command and docs build (#12758)

5ce6a1d

phryneas and others added 5 commits July 8, 2025 15:18

Version Packages (rc) (#12765)

978dda6

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Lenz Weber-Tronic <[email protected]>

Don't export gql from /react entrypoint (#12775)

454ec78

Apply document transforms on client.read* APIs (#12774)

511b4f3

add a job to build & upload the docmodel

29322a6

changeset categorization (#12744)

f29fb62

* changeset annotations * moar * forgot to save a file * finish categorization * add categorized changesets * start ordering changesets into stories * `rxjs` and `ObservableQuery` reordering * PR review feedback * update categorization

phryneas and others added 2 commits July 17, 2025 17:12

Report masked fragment as complete for nested partial data + add `dat…

bce9b74

…aState` to `watchFragment` (#12776) Co-authored-by: Lenz Weber-Tronic <[email protected]> Co-authored-by: jerelmiller <[email protected]>

Fix changeset script (#12780)

f738265

InMemoryCache: store fields with an empty object of optional argume…

0517163

…nts the same as fields without arguments (#12370) Co-authored-by: Jerel Miller <[email protected]>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Release 4.0 #12201

Release 4.0 #12201

jerelmiller commented Dec 9, 2024

Uh oh!

svc-apollo-docs commented Dec 9, 2024 •

edited

Loading

Uh oh!

changeset-bot bot commented Dec 9, 2024 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Dec 9, 2024 •

edited

Loading

Uh oh!

netlify bot commented Dec 9, 2024 •

edited

Loading

Uh oh!

github-actions bot commented Dec 9, 2024 •

edited

Loading

Uh oh!

apollo-librarian bot commented Jul 7, 2025 •

edited

Loading

Uh oh!

apollo-librarian bot commented Jul 16, 2025

Uh oh!

apollo-librarian bot commented Jul 17, 2025

Uh oh!

apollo-librarian bot commented Jul 17, 2025

Uh oh!

apollo-librarian bot commented Jul 17, 2025

Uh oh!

apollo-librarian bot commented Jul 17, 2025

Uh oh!

Uh oh!

Release 4.0 #12201

Are you sure you want to change the base?

Release 4.0 #12201

Conversation

jerelmiller commented Dec 9, 2024

Uh oh!

svc-apollo-docs commented Dec 9, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🛠️ Docs preview building...

Uh oh!

changeset-bot bot commented Dec 9, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

pkg-pr-new bot commented Dec 9, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

netlify bot commented Dec 9, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for apollo-client-docs ready!

Uh oh!

github-actions bot commented Dec 9, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

size-limit report 📦

Uh oh!

apollo-librarian bot commented Jul 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

❌ Docs preview failed

Errors

Uh oh!

apollo-librarian bot commented Jul 16, 2025

🛠️ Docs preview building...

Uh oh!

apollo-librarian bot commented Jul 17, 2025

🛠️ Docs preview building...

Uh oh!

apollo-librarian bot commented Jul 17, 2025

🛠️ Docs preview building...

Uh oh!

apollo-librarian bot commented Jul 17, 2025

🛠️ Docs preview building...

Uh oh!

apollo-librarian bot commented Jul 17, 2025

🛠️ Docs preview building...

Uh oh!

Uh oh!

svc-apollo-docs commented Dec 9, 2024 •

edited

Loading

changeset-bot bot commented Dec 9, 2024 •

edited

Loading

pkg-pr-new bot commented Dec 9, 2024 •

edited

Loading

netlify bot commented Dec 9, 2024 •

edited

Loading

github-actions bot commented Dec 9, 2024 •

edited

Loading

apollo-librarian bot commented Jul 7, 2025 •

edited

Loading