●Change8

Migrating to Apollo Client @apollo/client@4.0.0-rc.11

Version @apollo/client@4.0.0-rc.11 introduces 2 breaking changes. This guide details how to update your code.

Released: 8/14/2025

2
Breaking Changes
2
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

ApolloLink.ResultDefer20220824Handler.TypeOverridesDataMasking

Breaking Changes

●Issue #1

Incremental delivery handlers now require explicit opt‑in to add chunk types to the `ApolloLink.Result` type; you must augment the module with `declare module "@apollo/client" { export interface TypeOverrides extends Defer20220824Handler.TypeOverrides {} }`.

●Issue #2

The `DataMasking` interface has been removed from `@apollo/client` and `@apollo/client/masking`; any imports or usage must be deleted or replaced.

Migration Steps

  1. 1
    Add a module augmentation for `@apollo/client` that extends `TypeOverrides` with `Defer20220824Handler.TypeOverrides` as shown in the release notes.
  2. 2
    Search for and remove any imports or references to `DataMasking` from your codebase.

Release Summary

This release introduces a breaking change requiring explicit type augmentation for incremental delivery handlers and removes the `DataMasking` interface, necessitating code updates.

Need More Details?

View the full release notes and all changes for Apollo Client @apollo/client@4.0.0-rc.11.

View Full Changelog