releases.shpreview
Apollo GraphQL/Apollo Client/@apollo/client-codemod-migrate-3-to-4@1.0.0

@apollo/client-codemod-migrate-3-to-4@1.0.0

$npx -y @buildinternet/releases show rel_iBfHf5lmJL8i9tydB8_3M

Major Changes

  • #12727 b845906 Thanks @jerelmiller! - Add a codemod that renames old import locations from 3.x entrypoint to their 4.x entrypoint.

    Run the codemod using the following command:

    npx @apollo/client-codemod-migrate-3-to-4 --parser tsx ./src/**/*.{ts,tsx}

    The codemod supports .js, .jsx, .ts, and .tsx files.

  • #12851 32bc830 Thanks @phryneas! - Add a new clientSetup codemod step which applies the following steps from the migration guide to your Apollo Client setup code:

    • Moves uri, headers and credentials to the link option and creates a new HttpLink instance
    • Moves name and version into a clientAwareness option
    • Adds a localState option with a new LocalState instance, moves resolvers, and removes typeDefs and fragmentMatcher options
    • Changes the connectToDevTools option to devtools.enabled
    • Renames disableNetworkFetches to prioritizeCacheValues
    • If dataMasking is enabled, adds a template for global type augmentation to re-enable data masking types
    • Adds the incrementalHandler option and adds a template for global type augmentation to accordingly type network responses in custom links

Minor Changes

  • #12818 d1e9503 Thanks @phryneas! - Extend imports codemod, add new links and removals (via #12838) codemods.

Patch Changes

  • #12846 71ccfb5 Thanks @phryneas! - Add a new legacyEntryPoints transformation step that moves imports from old legacy entry points like @apollo/client/main.cjs or @apollo/client/react/react.cjs to the new entry points like @apollo/client or @apollo/client/react.

  • #12775 454ec78 Thanks @jerelmiller! - Don't export gql from @apollo/client/react entrypoint. Import from @apollo/client instead.

  • #12858 6440e8b Thanks @phryneas! - adjust the clientSetup codemod so that it removes the TCacheShape type argument from all ApolloClient usages (types and constructor calls).

Fetched April 11, 2026