Version 19.0.0

Major

• Updated Node.js support to ^20.9.0 || >=22.0.0.

• Use the TypeScript v5.5+ JSDoc tag @import to import types in modules. To migrate: Upgrade TypeScript to v5.5+.

• Updated the peer dependency @apollo/client to ^4.0.0, fixing #359.

• Added a new peer dependency rxjs at ^7.3.0. This is an Apollo Client v4 requirement.

• The function createUploadLink has been removed and the upload terminating Apollo Link is now the exported class UploadHttpLink that extends ApolloLink. To migrate:

  - import createUploadLink from "apollo-upload-client/createUploadLink.mjs";
  + import UploadHttpLink from "apollo-upload-client/UploadHttpLink.mjs";
  
    const terminatingLink =
  -   createUploadLink({
  +   new UploadHttpLink({
        // Options…
      });

• Updated dev dependencies, some of which require newer Node.js versions than previously supported.

Minor

• Added a new function createUploadLink option includeUnusedVariables defaulting to false to toggle including unused GraphQL variables in the request (similar to the Apollo BaseHttpLink option includeUnusedVariables), via #348.

Patch

• Avoid the deprecated Apollo Link HTTP utility function createSignalIfSupported.
• Improved the upload terminating Apollo Link request handler code:
  • Moved all of it into a single constructed Observer that’s returned regardless of errors.
  • More type safe.
• Updated the package scripts:
  • Reordered and renamed scripts.
  • Replaced npm run with node --run.
  • Target test modules with a glob.
• Updated GitHub Actions CI config:
  • Updated workflow triggers.
  • Run checks in separate jobs.
  • Removed custom step names.
  • Updated actions/checkout to v5.
  • Updated actions/setup-node to v4.
  • Replaced npm run with node --run.
  • Run tests with Node.js v20, v22, v24.
• Enabled the TypeScript compiler options noUnusedLocals and noUnusedParameters.
• Migrated to the ESLint v9 CLI and “flat” config.
• In tests, removed the no longer needed polyfill for the global File.
• In tests, use ApolloLink.from instead of the deprecated Apollo Link utility function concat.
• Improved internal comments.
• Corrected the package field browserslist to match what’s documented in the readme.
• Removed readme advice to consider polyfilling certain globals as they now exist in all supported environments.
• Improved readme examples.
• Fixed a typo in the changelog entry for v18.0.0.