@apollo/client 4.0.0-alpha.14 → 4.0.0-alpha.16

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-chicken-hide.md

@@ -1,17 +0,0 @@
----
-"@apollo/client": minor
----
-
-Add the ability to detect if an error was an error was emitted from the link chain. This is useful if your application throws custom errors in other areas of the application and you'd like to differentiate them from errors emitted by the link chain itself.
-
-To detect if an error was emitted from the link chain, use `LinkError.is`.
-
-```ts
-import { LinkError } from "@apollo/client";
-
-client.query({ query }).catch((error) => {
-  if (LinkError.is(error)) {
-    // This error originated from the link chain
-  }
-});
-```

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/olive-cougars-ring.md

@@ -1,9 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove local resolvers APIs from `ApolloClient` in favor of `localState`. Methods removed are:
-- `addResolvers`
-- `getResolvers`
-- `setResolvers`
-- `setLocalStateFragmentMatcher`

package/.changeset/orange-suits-laugh.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-Adjust `useMutation` types to better handle required variables. When required variables are missing, TypeScript will now complain if they are not provided either to the hook or the returned `mutate` function. Providing required variables to `useMutation` will make them optional in the returned `mutate` function.

package/.changeset/perfect-ducks-reflect.md

@@ -1,12 +0,0 @@
----
-"@apollo/client": major
----
-
-`ApolloLink.execute` now requires a third argument which provides the `client` that initiated the request to the link chain. If you use `execute` directly, add a third argument with a `client` property:
-
-```ts
-ApolloLink.execute(link, operation, { client });
-
-// or if you import the `execute` function directly:
-execute(link, operation, { client });
-```

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,161 +0,0 @@
-{
-  "mode": "pre",
-  "tag": "alpha",
-  "initialVersions": {
-    "@apollo/client": "3.12.2"
-  },
-  "changesets": [
-    "afraid-grapes-call",
-    "afraid-moons-arrive",
-    "beige-mirrors-talk",
-    "brave-moons-juggle",
-    "brave-radios-wait",
-    "bright-ads-share",
-    "calm-frogs-remain",
-    "calm-seals-relate",
-    "chatty-planes-grin",
-    "clean-sheep-hide",
-    "clever-zebras-mate",
-    "cool-bikes-shake",
-    "cool-kiwis-hunt",
-    "cuddly-spiders-tie",
-    "curvy-flies-accept",
-    "curvy-pianos-count",
-    "dirty-cobras-change",
-    "dirty-eagles-poke",
-    "dirty-trees-pump",
-    "early-eggs-develop",
-    "eighty-squids-fix",
-    "eleven-kangaroos-jump",
-    "empty-rabbits-move",
-    "few-crabs-move",
-    "fluffy-shoes-applaud",
-    "forty-hairs-occur",
-    "forty-shrimps-fry",
-    "forty-tomatoes-punch",
-    "four-countries-clean",
-    "four-ghosts-watch",
-    "fresh-moose-hope",
-    "friendly-olives-refuse",
-    "funny-boats-wink",
-    "funny-jeans-invent",
-    "funny-terms-deny",
-    "fuzzy-seahorses-hunt",
-    "fuzzy-tips-sit",
-    "gentle-badgers-train",
-    "gentle-waves-cough",
-    "giant-apes-thank",
-    "giant-bags-share",
-    "gold-oranges-double",
-    "good-dolphins-peel",
-    "gorgeous-chefs-tap",
-    "great-roses-jog",
-    "grumpy-vans-type",
-    "healthy-apes-sneeze",
-    "hip-vans-act",
-    "hot-cycles-notice",
-    "hungry-bikes-cough",
-    "itchy-chefs-run",
-    "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-parrots-bow",
-    "little-spoons-kick",
-    "loud-cows-raise",
-    "lucky-hats-push",
-    "lucky-sheep-explain",
-    "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-chicken-hide",
-    "odd-lemons-relax",
-    "olive-cougars-ring",
-    "orange-suits-laugh",
-    "perfect-ducks-reflect",
-    "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",
-    "serious-items-develop",
-    "serious-moons-juggle",
-    "seven-dragons-repair",
-    "seven-foxes-melt",
-    "seven-schools-carry",
-    "shaggy-pugs-add",
-    "shiny-carrots-invent",
-    "short-jokes-jam",
-    "short-months-complain",
-    "short-tomatoes-attend",
-    "silly-knives-exist",
-    "silly-seas-confess",
-    "sixty-bats-cry",
-    "slimy-chicken-melt",
-    "slimy-maps-press",
-    "slow-ravens-explain",
-    "small-buttons-rhyme",
-    "small-cycles-rescue",
-    "small-kids-film",
-    "small-poems-rest",
-    "smart-rats-explode",
-    "smooth-coins-collect",
-    "smooth-pens-reply",
-    "soft-mails-clean",
-    "sour-kids-deliver",
-    "sour-pillows-guess",
-    "spotty-mugs-poke",
-    "strange-seahorses-impress",
-    "strong-rivers-fry",
-    "stupid-pumpkins-travel",
-    "swift-rivers-share",
-    "tall-bikes-develop",
-    "tall-cups-suffer",
-    "tame-doors-shop",
-    "tame-points-work",
-    "tender-swans-flash",
-    "thick-books-grin",
-    "thin-peas-hear",
-    "thirty-pens-jump",
-    "tidy-pandas-punch",
-    "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",
-    "wicked-kiwis-buy",
-    "witty-paws-marry",
-    "yellow-cats-judge",
-    "young-phones-fold",
-    "young-snails-grin",
-    "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/serious-items-develop.md

@@ -1,17 +0,0 @@
----
-"@apollo/client": major
----
-
-Third-party caches must now implement the `fragmentMatches` API. Additionally `fragmentMatches` must be able to handle both `InlineFragmentNode` and `FragmentDefinitionNode` nodes.
-
-```ts
-class MyCache extends ApolloCache {
-  // This is now required
-  public fragmentMatches(
-    fragment: InlineFragmentNode | FragmentDefinitionNode,
-    typename: string
-  ): boolean {
-    return // ... logic to determine if typename matches fragment
-  }
-}
-```

package/.changeset/serious-moons-juggle.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-`client.query` no longer supports `notifyOnNetworkStatusChange` in options. An error will be thrown if this option is set. The effects of this option were not observable by `client.query` since `client.query` emits a single result.

package/.changeset/seven-dragons-repair.md

@@ -1,14 +0,0 @@
----
-"@apollo/client": patch
----
-
-Update format of the error message for `CombinedGraphQLErrors` and `CombinedProtocolErrors` to be more like v3.x.
-
-```diff
-console.log(error.message);
-- `The GraphQL server returned with errors:
-- - Email not found
-- - Username already in use`
-+ `Email not found
-+ Username already in use`
-```

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/seven-schools-carry.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": minor
----
-
-Add a `client` property to the `operation` passed to the link chain. This `client` is set as the `client` making the request to the link chain.

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/short-tomatoes-attend.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove `TContext` generic argument from all types that use it. `TContext` is replaced with `DefaultContext` which can be modified using declaration merging.

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/silly-seas-confess.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Drop `graphql` v15 as a valid peer dependency.

package/.changeset/sixty-bats-cry.md

@@ -1,6 +0,0 @@
----
-"@apollo/client": major
----
-
-Reworked the logic for then a loading state is triggered. If the link chain responds synchronously, a loading state will be omitted, otherwise it will be triggered.
-If local resolvers are used, the time window for "sync vs async" starts as soon as `@exports` variables are resolved.

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/).