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

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/poor-spiders-hunt.md

@@ -1,23 +0,0 @@
----
-"@apollo/client": minor
----
-
-Move `MockLink` types to `MockLink` namespace. This affects the `MockedResponse`, `MockLinkOptions`, and `ResultFunction` types. These types are still exported but are deprecated in favor of the namespace. To migrate, use the types on the `MockLink` namespace instead.
-
-```diff
-import {
-- MockedResponse,
-- MockLinkOptions,
-- ResultFunction,
-+ MockLink
-} from "@apollo/client/testing";
-
-- const mocks: MockedResponse = [];
-+ const mocks: MockLink.MockedResponse = [];
-
-- const result: ResultFunction = () => {/* ... */ }
-+ const result: MockLink.ResultFunction = () => {/* ... */ }
-
-- const options: MockLinkOptions = {}
-+ const options: MockLink.Options = {}
-```

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,168 +0,0 @@
-{
-  "mode": "pre",
-  "tag": "alpha",
-  "initialVersions": {
-    "@apollo/client": "3.12.2"
-  },
-  "changesets": [
-    "afraid-grapes-call",
-    "afraid-moons-arrive",
-    "beige-mirrors-talk",
-    "beige-spiders-hope",
-    "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",
-    "poor-spiders-hunt",
-    "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",
-    "selfish-spoons-approve",
-    "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-ants-bake",
-    "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-colts-tell",
-    "sour-guests-poke",
-    "sour-kids-deliver",
-    "sour-pillows-guess",
-    "spotty-mugs-poke",
-    "strange-seahorses-impress",
-    "strange-walls-march",
-    "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/selfish-spoons-approve.md

@@ -1,44 +0,0 @@
----
-"@apollo/client": major
----
-
-Move internal testing utilities in `@apollo/client/testing` to `@apollo/client/testing/internal` and remove deprecated testing utilities. Some of the testing utilities exported from the `@apollo/client/testing` endpoint were not considered stable. As a result of this change, testing utilities or types exported from `@apollo/client/testing` are now considered stable and will not undergo breaking changes.
-
-The following APIs were removed. To migrate, update usages of the following APIs as such:
-
-**`createMockClient`**
-
-```diff
-- const client = createMockClient(data, query, variables);
-+ const client = new ApolloClient({
-+   cache: new InMemoryCache(),
-+   link: new MockLink([
-+     {
-+       request: { query, variables },
-+       result: { data },
-+     }
-+   ]),
-+ });
-```
-
-**`mockObservableLink`**
-
-```diff
-- const link = mockObservableLink();
-+ const link = new MockSubscriptionLink();
-```
-
-**`mockSingleLink`**
-
-```diff
-- const link = mockSingleLink({
--   request: { query, variables },
--   result: { data },
-- });
-+ const link = new MockLink([
-+   {
-+     request: { query, variables },
-+     result: { data },
-+   }
-+ ]);
-```

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-ants-bake.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-`useQuery`: only advance `previousData` if `data` actually changed

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/small-poems-rest.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Don't `broadcastQueries` when a query is torn down.