@apollo/client 4.0.0-alpha.9 → 4.0.0-rc.0

package/.changeset/late-trainers-peel.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": patch
----
-
-* dropped the deprecated `DEV` export from `@apollo/client/utilities` and `@apollo/client/utilities/globals`
-* moved the `__DEV__` export from `@apollo/client/utilities/globals` to `@apollo/client/utilities/environment`
-* moved the `invariant`, `newInvariantError` and `InvariantError` exports from `@apollo/client/utilities/globals` to `@apollo/client/utilities/invariant`

package/.changeset/light-apes-rescue.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-`useQuery` no longer returns `reobserve` as part of its result. It was possible to use `reobserve` to set new options on the underlying `ObservableQuery` instance which differed from the options passed to the hook. This could result in unexpected results. Instead prefer to rerender the hook with new options.

package/.changeset/light-dolphins-taste.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-`useLazyQuery` no longer supports SSR environments and will now throw if the `execute` function is called in SSR. If you need to run a query in an SSR environment, use `useQuery` instead.

package/.changeset/light-sloths-end.md

@@ -1,16 +0,0 @@
----
-"@apollo/client": minor
----
-
-Apollo Client is no longer using `ts-invariant`, but ships with a modified variant of it.
-
-The existing export `setLogVerbosity` from `@apollo/client` is still available and
-now points to this new integration.
-**In most cases, you should be using this export.**
-It will no longer adjust the verbosity of `ts-invariant` and as such no longer
-influence other packages relying on `ts-invariant`.
-
-The new entry point `@apollo/client/utilities/invariant` now exports `invariant`,
-`InvariantError` and `setVerbosity`.
-(Note that these tools are mostly meant to be used by Apollo Client and libraries directly
-based on Apollo Client like the `@apollo/client-integration-*` packages.)

package/.changeset/little-spoons-kick.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-`client.mutate` now returns a `MutateResult` instead of `FetchResult`. As a result, the `errors` property has been removed in favor of `error` which is set if either a network error occured or GraphQL errors are returned from the server.
-
-`useMutation` now also returns a `MutateResult` instead of a `FetchResult`.

package/.changeset/loud-cows-raise.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": patch
----
-
-`useQuery` with `ssr: false` - previously, `skip` had a higher priortity than `ssr: false` while `ssr: false` had a higher priority than `fetchPolicy: "standby"` (which is roughly equivalent to `skip`).
-
-This priority has been adjusted so now both `skip` and `fetchPolicy: "standby"` have a higher priority than `ssr: false` and will return `loading: false`, while `ssr: false` will only come after those and will return `loading: true` if those are not set.

package/.changeset/lucky-hats-push.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-The execute function returned from `useLazyQuery` now only supports the `context` and `variables` options. This means that passing options supported by the hook no longer override the hook value.
-
-To change options, rerender the component with new options. These options will take effect with the next query execution.

package/.changeset/many-buses-allow.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-Fix an issue where passing `onError` to `useMutation` would resolve the promise returned by the `mutate` function instead of rejecting when using an `errorPolicy` of `none`.

package/.changeset/many-papayas-hide.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-`ObservableQuery` will no longer terminate on errors and will instead emit a `next` value with an `error` property. This ensures that `ObservableQuery` instances can continue to receive updates after errors are returned in requests without the need to resubscribe to the observable.

package/.changeset/mean-lizards-think.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-Ensure `useLazyQuery` does not return a `partial` property which is not specified by the result type.

package/.changeset/metal-needles-search.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-ObservableQuery: implement the `rxjs` `InteropObservable` interface to ensure `from(observableQuery)` stays possible

package/.changeset/mighty-penguins-wink.md

@@ -1,16 +0,0 @@
----
-"@apollo/client": major
----
-
-Removes the `throwServerError` utility function. Now that `ServerError` is an
-`Error` subclass, you can throw these errors directly:
-
-```js
-import { ServerError } from '@apollo/client';
-
-// instead of
-throwServerError(response, result, 'error message')
-
-// Use
-throw new ServerError('error message', { response, result })
-```

package/.changeset/modern-feet-do.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-`@apollo/client`, `@apollo/client/core` and `@apollo/client/cache` no longer export an empty `Cache` runtime object. This is meant to be a type-only namespace.

package/.changeset/moody-lobsters-listen.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-The `Cache.DiffResult<T>` type is now a union type with better type safety for both complete and partial results. Checking `diff.complete` will now narrow the type of `result` depending on whether the value is `true` or `false`.
-
-When `true`, `diff.result` will be a non-null value equal to the `T` generic type. When `false`, `diff.result` now reports `result` as `DeepPartial<T> | null` indicating that fields in the result may be missing (`DeepPartial<T>`) or empty entirely (`null`).

package/.changeset/nervous-fireants-bow.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": minor
----
-
-Add a `data` property to `CombinedGraphQLErrors` that captures any partial data returned by the GraphQL response when `errors` are also returned.

package/.changeset/nervous-goats-allow.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Removes the `defaultOptions` option from `useQuery`. Use options directly or use the global `ApolloClient` `defaultOptions`.

package/.changeset/nice-donkeys-reflect.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove the `errors` property from the results emitted from `ObservableQuery` or returned from `client.query`. Read errors from the `error` property instead.

package/.changeset/nice-dots-matter.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-Removed the `parser` cache. The functionality has been replaced in a way that doesn't need caching.

package/.changeset/nice-waves-work.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-The result resolved from the promise returned from the execute function in `useLazyQuery` is now an `ApolloQueryResult` type and no longer includes all the fields returned from the `useLazyQuery` hook tuple.
-
-If you need access to the additional properties such as `called`, `refetch`, etc. not included in `ApolloQueryResult`, read them from the hook instead.

package/.changeset/ninety-bags-bake.md

@@ -1,17 +0,0 @@
----
-"@apollo/client": major
----
-
-Mocked responses passed to `MockLink` now accept a callback for the `request.variables` option. This is used to determine if the mock should be matched for a set of request variables. With this change, the `variableMatcher` option has been removed in favor of passing a callback to `variables`. Update by moving the callback function from `variableMatcher` to `request.variables`.
-
-```diff
-new MockLink([
-  {
-    request: {
-      query,
-+     variables: (requestVariables) => true
-    },
--   variableMatcher: (requestVariables) => true
-  }
-]);
-```

package/.changeset/odd-lemons-relax.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-Rename all React hook result types and options. These types have all moved under a namespace that matches the hook name. For example, `useQuery` exports `useQuery.Options` and `useQuery.Result` types. As such, the old hook types have been deprecated and will be removed in v5.

package/.changeset/perfect-vans-give.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-The `@apollo/client` and `@apollo/client/core` entry points are now equal.
-In the next major, the `@apollo/client/core` entry point will be removed.
-Please change imports over from `@apollo/client/core` to `@apollo/client`.

package/.changeset/polite-bees-care.md

@@ -1,26 +0,0 @@
----
-"@apollo/client": major
----
-
-`useLazyQuery` will no longer rerender with the loading state when calling the execute function the first time unless the `notifyOnNetworkStatusChange` option is set to `true` (which is the new default).
-
-If you prefer the behavior from 3.x, rerender the component with
-`notifyOnNetworkStatusChange` set to `false` after the execute function is
-called the first time.
-
-```ts
-function MyComponent() {
-  const [notifyOnNetworkStatusChange, setNotifyOnNetworkStatusChange] = useState(true);
-  const [execute] = useLazyQuery(query, { notifyOnNetworkStatusChange });
-
-  async function runExecute() {
-    await execute();
-
-    // Set to false after the initial fetch to stop receiving notifications
-    // about changes to the loading states.
-    setNotifyOnNetworkStatusChange(false);
-  }
-
-  // ...
-}
-```

package/.changeset/poor-eels-punch.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Mutations no longer report errors if the GraphQL result from the server contains an empty array of errors.

package/.changeset/popular-games-sleep.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Changes the default `Accept` header to `application/graphql-response+json`.

package/.changeset/pre.json

@@ -1,121 +0,0 @@
-{
-  "mode": "pre",
-  "tag": "alpha",
-  "initialVersions": {
-    "@apollo/client": "3.12.2"
-  },
-  "changesets": [
-    "afraid-moons-arrive",
-    "beige-mirrors-talk",
-    "brave-radios-wait",
-    "bright-ads-share",
-    "calm-frogs-remain",
-    "calm-seals-relate",
-    "chatty-planes-grin",
-    "clean-sheep-hide",
-    "clever-zebras-mate",
-    "cool-bikes-shake",
-    "cuddly-spiders-tie",
-    "curvy-pianos-count",
-    "dirty-eagles-poke",
-    "dirty-trees-pump",
-    "early-eggs-develop",
-    "eighty-squids-fix",
-    "eleven-kangaroos-jump",
-    "empty-rabbits-move",
-    "fluffy-shoes-applaud",
-    "forty-hairs-occur",
-    "forty-shrimps-fry",
-    "forty-tomatoes-punch",
-    "four-ghosts-watch",
-    "fresh-moose-hope",
-    "funny-jeans-invent",
-    "fuzzy-tips-sit",
-    "giant-apes-thank",
-    "giant-bags-share",
-    "good-dolphins-peel",
-    "gorgeous-chefs-tap",
-    "grumpy-vans-type",
-    "healthy-apes-sneeze",
-    "hip-vans-act",
-    "hot-cycles-notice",
-    "itchy-drinks-refuse",
-    "itchy-roses-accept",
-    "khaki-keys-deliver",
-    "khaki-spies-work",
-    "kind-fishes-develop",
-    "large-plants-know",
-    "late-trainers-peel",
-    "light-apes-rescue",
-    "light-dolphins-taste",
-    "light-sloths-end",
-    "little-spoons-kick",
-    "loud-cows-raise",
-    "lucky-hats-push",
-    "many-buses-allow",
-    "many-papayas-hide",
-    "mean-lizards-think",
-    "metal-needles-search",
-    "mighty-penguins-wink",
-    "modern-feet-do",
-    "moody-lobsters-listen",
-    "nervous-fireants-bow",
-    "nervous-goats-allow",
-    "nice-donkeys-reflect",
-    "nice-dots-matter",
-    "nice-waves-work",
-    "ninety-bags-bake",
-    "odd-lemons-relax",
-    "perfect-vans-give",
-    "polite-bees-care",
-    "poor-eels-punch",
-    "popular-games-sleep",
-    "purple-bears-flash",
-    "purple-lions-cough",
-    "rare-houses-prove",
-    "real-gorillas-move",
-    "real-teachers-peel",
-    "rich-eagles-cross",
-    "rich-kids-carry",
-    "rude-fans-study",
-    "seven-foxes-melt",
-    "shaggy-pugs-add",
-    "shiny-carrots-invent",
-    "short-jokes-jam",
-    "short-months-complain",
-    "silly-knives-exist",
-    "slimy-chicken-melt",
-    "slimy-maps-press",
-    "slow-ravens-explain",
-    "small-buttons-rhyme",
-    "small-cycles-rescue",
-    "small-kids-film",
-    "smart-rats-explode",
-    "smooth-coins-collect",
-    "smooth-pens-reply",
-    "soft-mails-clean",
-    "sour-pillows-guess",
-    "strange-seahorses-impress",
-    "swift-rivers-share",
-    "tall-bikes-develop",
-    "tall-cups-suffer",
-    "tame-doors-shop",
-    "tame-points-work",
-    "tender-swans-flash",
-    "thick-books-grin",
-    "thin-peas-hear",
-    "tidy-squids-poke",
-    "tough-rockets-allow",
-    "tough-taxis-smoke",
-    "tough-tips-drop",
-    "tricky-tables-shave",
-    "twenty-snakes-sort",
-    "unlucky-kiwis-sell",
-    "unlucky-sheep-change",
-    "warm-ties-sit",
-    "wicked-forks-double",
-    "yellow-cats-judge",
-    "young-phones-fold",
-    "young-turtles-explode"
-  ]
-}

package/.changeset/purple-bears-flash.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Removed the `@apollo/client/react/parser` entry point. There is no replacement.

package/.changeset/purple-lions-cough.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-`ObservableQuery.setVariables` will now resolve with the last emitted result instead of `undefined` when either the variables match the current variables or there are no subscribers to the query.

package/.changeset/rare-houses-prove.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": minor
----
-
-Add `react-server` entry point with stubs for normal exports.

package/.changeset/real-gorillas-move.md

@@ -1,21 +0,0 @@
----
-"@apollo/client": major
----
-
-Apollo Client now defaults to production mode, not development mode, if the
-environment cannot be determined.
-
-In modern bundlers, this should automatically be handled by the bundler loading
-the bundler with the `development` export condition.
-
-If neither the `production` nor the `development` export condition are
-used by the bundler/runtime, Apollo Client will fall back to `globalThis.__DEV__`
-to determine if it should run in production or development mode.
-
-Unlike Apollo Client 3 though, if `globalThis.__DEV__` is not set to `true`,
-Apollo Client will now default to `production`, not to `development`, behaviour.
-
-This switch to *explicilty* requiring `true` also resolves a situation where
-an HTML element with `id="__DEV__"` would create a global `__DEV__` variable
-with a referent to the DOM element, which in the past was picked up as "truthy" and
-would have triggered development mode.

package/.changeset/real-teachers-peel.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Unify error behavior on subscriptions for GraphQL errors and network errors by ensuring network errors are subject to the `errorPolicy`. Network errors that terminate the connection will now be emitted on the `error` property passed to the `next` callback followed by a call to the `complete` callback.

package/.changeset/rich-eagles-cross.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-The `reobserve` option is no longer available in the result returned from `useLazyQuery`. This was considered an internal API and should not be used directly.

package/.changeset/rich-kids-carry.md

@@ -1,9 +0,0 @@
----
-"@apollo/client": major
----
-
-Fix type of `data` property on `ApolloQueryResult`. Previously this field was non-optional, non-null `TData`, however at runtime this value could be set to `undefined`. This field is now reported as `TData | undefined`.
-
-This will affect you in a handful of places:
-- The `data` property emitted from the result passed to the `next` callback from `client.watchQuery`
-- Fetch-based APIs that return an `ApolloQueryResult` type such as `observableQuery.refetch`, `observableQuery.fetchMore`, etc.

package/.changeset/rude-fans-study.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": minor
----
-
-Deprecate the `partial` flag on `ApolloQueryResult` and make it a non-optional property. Previously `partial` was only set conditionally if the result emitted was partial. This value is now available with all results that return an `ApolloQueryResult`.

package/.changeset/seven-foxes-melt.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-The promise returned when calling the execute function from `useLazyQuery` will now reject when using an `errorPolicy` of `none` when GraphQL errors are returned from the result.

package/.changeset/shaggy-pugs-add.md

@@ -1,52 +0,0 @@
----
-"@apollo/client": minor
----
-
-Add ability to specify a default `delay` for all mocked responses passed to `MockLink`. This `delay` can be configured globally (all instances of `MockLink` will use the global defaults), or per-instance (all mocks in a single instance will use the defaults). A `delay` defined on a single mock will supercede all default delays. Per-instance defaults supercede global defaults.
-
-**Global defaults**
-
-```ts
-MockLink.defaultOptions = {
-  // Use a default delay of 20ms for all mocks in all instances without a specified delay
-  delay: 20,
-
-  // altenatively use a callback which will be executed for each mock
-  delay: () => getRandomNumber(),
-
-  // or use the built-in `realisticDelay`. This is the default
-  delay: realisticDelay(),
-}
-```
-
-**Per-instance defaults**
-
-```ts
-new MockLink(
-  [
-    // Use the default delay
-    {
-      request: { query },
-      result: { data: { greeting: 'Hello' }},
-    },
-    {
-      request: { query },
-      result: { data: { greeting: 'Hello' }},
-      // Override the default for this mock
-      delay: 10
-    },
-  ],
-  {
-    defaultOptions: {
-      // Use a default delay of 20ms for all mocks without a specified delay
-      delay: 20,
-
-      // altenatively use a callback which will be executed for each mock
-      delay: () => getRandomNumber(),
-
-      // or use the built-in `realisticDelay`. This is the default
-      delay: realisticDelay(),
-    }
-  }
-);
-```

package/.changeset/shiny-carrots-invent.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove `subscribeAndCount` testing utility from `@apollo/client/testing`.

package/.changeset/short-jokes-jam.md

@@ -1,27 +0,0 @@
----
-"@apollo/client": major
----
-
-Moves all React-related exports to the `@apollo/client/react` entrypoint and out of the main `@apollo/client` entrypoint. This prevents the need to install React in order to use the core client.
-
-The following is a list of exports available in `@apollo/client` that should now import from `@apollo/client/react`.
-- `ApolloConsumer`
-- `ApolloProvider`
-- `createQueryPreloader`
-- `getApolloContext`
-- `skipToken`
-- `useApolloClient`
-- `useBackgroundQuery`
-- `useFragment`
-- `useLazyQuery`
-- `useLoadableQuery`
-- `useMutation`
-- `useQuery`
-- `useQueryRefHandlers`
-- `useReactiveVar`
-- `useReadQuery`
-- `useSubscription`
-- `useSuspenseQuery`
-
-The following is a list of exports available in `@apollo/client/testing` that should now import from `@apollo/client/testing/react`:
-- `MockedProvider`

package/.changeset/short-months-complain.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Throw an error when a client-only query is used in a mocked response passed to `MockLink`.

package/.changeset/silly-knives-exist.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Removes the `urql` multipart subscriptions utilities. Use the native multipart subscriptions support in `urql` instead.

package/.changeset/slimy-chicken-melt.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove deprecated `onSubscriptionData` and `onSubscriptionComplete` callbacks from `useSubscription`. Use `onData` and `onComplete` instead.

package/.changeset/slimy-maps-press.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-Fix up the 4.0 CommonJS build

package/.changeset/slow-ravens-explain.md

@@ -1,19 +0,0 @@
----
-"@apollo/client": major
----
-
-Switch to [RxJS](https://rxjs.dev/) as the observable implementation. `rxjs` is now a peer dependency of Apollo Client which means you will now need to install `rxjs` in addition to `@apollo/client`.
-
-This change is mostly transparent, however transforming values on observables, common in link implementations, differs in RxJS vs `zen-observable`. For example, you could modify values in the link chain emitted from a downstream link by using the `.map` function. In RxJS, this is done with the `.pipe` function and passing a `map` operator instead.
-
-```ts
-import { map } from "rxjs";
-
-const link new ApolloLink((operation, forward) => {
-  return forward(operation).pipe(
-    map((result) => performTransform(result))
-  );
-});
-```
-
-For a full list of operators and comprehensive documentation on the capabilities of RxJS, check out the [documentation](https://rxjs.dev/).

package/.changeset/small-buttons-rhyme.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove the deprecated `canonizeResults` option. It was prone to memory leaks. As such, some results that were referentially equal when `canonizeResults` option was set to `true` no longer retain the same object identity.

package/.changeset/small-cycles-rescue.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-Don't emit a partial cache result from `cache-only` queries when `returnPartialData` is `false`.

package/.changeset/small-kids-film.md

@@ -1,14 +0,0 @@
----
-"@apollo/client": major
----
-
-Rework package publish format (#12329, #12382)
-
-We have reworked the way Apollo Client is packaged.
-
-* shipping ESM and CJS
-* fixing up source maps
-* the build targets a modern runtime environment (browserslist query: `"since 2023, node >= 20, not dead"`)
-* removed the "proxy directory" `package.json` files, e.g. `cache/core/package.json` and `react/package.json`. While these helped with older build tools, modern build tooling uses the `exports` field in the root `package.json` instead and the presence of these files can confuse modern build tooling. If your build tooling still relies on those, please update your imports to import from e.g. `@apollo/client/cache/core/index.js` instead of `@apollo/client/cache/core` - but generally, this should not be necessary.
-* added an `exports` field to `package.json` to expose entry points
-* instead of `globalThis.__DEV__`, Apollo Client now primarily relies on the `development` and `production` exports conditions. It falls back to `globalThis.__DEV__` if the bundler doesn't know these, though.

package/.changeset/smart-rats-explode.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove `ObservableQuery.resetQueryStoreErrors` method. This method reset some internal state that was not consumed elsewhere in the client and resulted in a no-op.

package/.changeset/smooth-coins-collect.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove `fromPromise` utility function. Use [`from`](https://rxjs.dev/api/index/function/from) instead.

package/.changeset/smooth-pens-reply.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-Require environments that support `WeakMap`, `WeakSet` and symbols. Apollo Client would fallback to `Map` and `Set` if the weak versions were not available. This has been removed and expects that these features are available in the source environment.
-
-If you are running in an environment without `WeakMap`, `WeakSet` or symbols, you will need to find appropriate polyfills.

package/.changeset/soft-mails-clean.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-`useLazyQuery` no longer supports calling the execute function in render and will now throw. If you need to execute the query immediately, use `useQuery` instead or move the call to a `useEffect`.