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

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.

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`.

package/.changeset/sour-colts-tell.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-`ObservableQuery` will now return a `loading: false` state for `fetchPolicy` `standby`, even before subscription

package/.changeset/sour-guests-poke.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove the `@apollo/client/testing/core` entrypoint in favor of `@apollo/client/testing`.

package/.changeset/sour-kids-deliver.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Rename the `@apollo/client/link/core` entrypoint to `@apollo/client/link`.

package/.changeset/sour-pillows-guess.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-The `defaultOptions` and `initialFetchPolicy` options are no longer supported with `useLazyQuery`.
-
-If you use `defaultOptions`, pass those options directly to the hook instead. If you use `initialFetchPolicy`, use `fetchPolicy` instead.

package/.changeset/spotty-mugs-poke.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Dropped the `saveAsLastResult` argument from `ObservableQuery.getCurrentResult`

package/.changeset/strange-seahorses-impress.md

@@ -1,17 +0,0 @@
----
-"@apollo/client": major
----
-
-`useLazyQuery` no longer supports `variables` in the hook options and therefore no longer performs variable merging. The execute function must now be called with `variables` instead.
-
-```ts
-function MyComponent() {
-  const [execute] = useLazyQuery(query);
-
-  function runExecute() {
-    execute({ variables: { ... }});
-  }
-}
-```
-
-This change means the execute function returned from `useLazyQuery` is more type-safe. The execute function will require you to pass a `variables` option if the query type includes required variables.

package/.changeset/strange-walls-march.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-The `error` property is no longer present when `skip` is `true` in `useQuery`.

package/.changeset/strong-rivers-fry.md

@@ -1,34 +0,0 @@
----
-"@apollo/client": major
----
-
-The resolver function's `context` argument (the 3rd argument) has changed to provide additional information without the possibility of name clashes. Previously the `context` argument would spread request context and override the `client` and `cache` properties to give access to both inside of a resolver. The `context` argument takes now takes the following shape:
-
-```ts
-{
-  // the request context. By default `TContextValue` is of type `DefaultContext`,
-  // but can be changed if a `context` function is provided.
-  requestContext: TContextValue,
-  // The client instance making the request
-  client: ApolloClient,
-  // Whether the resolver is run as a result of gathering exported variables
-  // or resolving the value as part of the result
-  phase: "exports" | "resolve"
-}
-```
-
-To migrate, pull any request context from `requestContext` and the `cache` from the `client` property:
-
-```diff
-new LocalState({
-  resolvers: {
-    Query: {
--     myResolver: (parent, args, { someValue, cache }) => {
-+     myResolver: (parent, args, { requestContext, client }) => {
-+       const someValue = requestContext.someValue;
-+       const cache = client.cache;
-      }
-    }
-  }
-});
-```

package/.changeset/stupid-pumpkins-travel.md

@@ -1,13 +0,0 @@
----
-"@apollo/client": major
----
-
-Apollo Client no longer ships with support for `@client` fields out-of-the-box and now must be opt-in. To opt in to use `@client` fields, pass an instantiated `LocalState` instance to the `localState` option. If a query contains `@client` and local state hasn't been configured, an error will be thrown.
-
-```ts
-import { LocalState } from "@apollo/client/local-state";
-
-new ApolloClient({
-  localState: new LocalState(),
-});
-```

package/.changeset/swift-rivers-share.md

@@ -1,13 +0,0 @@
----
-"@apollo/client": major
----
-
-Default the `delay` for all mocked responses passed to `MockLink` using `realisticDelay`. This ensures your test handles loading states by default and is not reliant on a specific timing.
-
-If you would like to restore the old behavior, use a global default delay of `0`.
-
-```ts
-MockLink.defaultOptions = {
-  delay: 0
-}
-```

package/.changeset/tall-bikes-develop.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove `resetResultIdentities` option from `InMemoryCache.gc()`. This affected object canonization which has been removed.

package/.changeset/tall-cups-suffer.md

@@ -1,13 +0,0 @@
----
-"@apollo/client": major
----
-
-### Changes for users of `InMemoryCache`
-
-`cache.diff` now returns `null` instead of an empty object (`{}`) when `returnPartialData` is `true` and the result is empty.
-
-If you use `cache.diff` directly with `returnPartialData: true`, you will need to check for `null` before accessing any other fields on the `result` property. A non-null value indicates that at least one field was present in the cache for the given query document.
-
-### Changes for third-party cache implementations
-
-The client now expects `cache.diff` to return `null` instead of an empty object when there is no data that can be fulfilled from the cache and `returnPartialData` is `true`. If your cache implementation returns an empty object, please update this to return `null`.

package/.changeset/tame-doors-shop.md

@@ -1,14 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove workarounds for streaming with non-WhatWG response bodies to reduce bundle size.
-
-This removes support for `fetch` implementations that return Node Streams, Async Iterators or Blob instances as `Response.body`.
-
-In the WhatWG Fetch specification, [`Response.body`](https://fetch.spec.whatwg.org/#body) is specified as a WhatWG [ReadableStream](https://streams.spec.whatwg.org/#readablestream).
-
-At this point in time, this is natively supported in browsers, `node` and React Native (via [react-native-fetch-api](https://www.npmjs.com/package/react-native-fetch-api), see our [setup instructions for React Native](https://www.apollographql.com/docs/react/integrations/react-native#consuming-multipart-http-via-text-streaming)).
-
-If you are using an older `fetch` polyfill that deviates from the spec, this might not be compatible - for example, [node-fetch](https://github.com/node-fetch/node-fetch?tab=readme-ov-file#interface-body) returns a node `Readable` instead of a `ReadableStream`.
-In those cases, please switch to a compatible alternative such as the `node`-native `fetch`, or `undici`.

package/.changeset/tame-points-work.md

@@ -1,11 +0,0 @@
----
-"@apollo/client": minor
----
-
-Add a new method for static SSR of React components, `prerenderStatic`.
-The old methods, `getDataFromTree`, `getMarkupFromTree` and `renderToStringWithData`
-have been deprecated in favor of `prerenderStatic`.
-
-If used with React 19 and the `prerender` or `prerenderToNodeStream` apis from
-`react-dom/static`, this method can now be used to SSR-prerender suspense-enabled
-hook APIs.

package/.changeset/tender-swans-flash.md

@@ -1,16 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove `loading`, `networkStatus`, and `partial` properties on all promise-based query APIs. These properties were mostly static and were unnecessary since promise resolution guaranteed that the query was not longer loading.
-
-This affects the following APIs:
-- `client.query`
-- `client.refetchQueries`
-- `client.reFetchObservableQueries`
-- `client.resetStore`
-- `observableQuery.fetchMore`
-- `observableQuery.refetch`
-- `observableQuery.reobserve`
-- `observableQuery.setVariables`
-- The `useLazyQuery` `execute` function

package/.changeset/thick-books-grin.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": minor
----
-
-Split out SSR-specific code from useQuery hook, remove RenderPromises

package/.changeset/thin-peas-hear.md

@@ -1,16 +0,0 @@
----
-"@apollo/client": major
----
-
-`notifyOnNetworkStatusChange` now defaults to `true`. This means that loading states will be emitted (core API) or rendered (React) by default when calling `refetch`, `fetchMore`, etc. To maintain the old behavior, set `notifyOnNetworkStatusChange` to `false` in `defaultOptions`.
-
-```ts
-new ApolloClient({
-  defaultOptions: {
-    watchQuery: {
-      // Use the v3 default
-      notifyOnNetworkStatusChange: false
-    }
-  }
-})
-```

package/.changeset/thirty-pens-jump.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove the `fragmentMatcher` option from `ApolloClient`. Custom fragment matchers used with local state are no longer supported. Fragment matching is now performed by the configured `cache` via the `cache.fragmentMatches` API.

package/.changeset/tidy-pandas-punch.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-`ObservableQuery.variables` has been updated to return `TVariables` rather than `TVariables | undefined`. This is more consistent with the runtime value where an empty object (`{}`) will be returned when the `variables` option is not provided.

package/.changeset/tidy-squids-poke.md

@@ -1,12 +0,0 @@
----
-"@apollo/client": major
----
-
-Removes `ObservableQuery.result()` method. If you use this method and need similar functionality, use the `firstValueFrom` helper in RxJS.
-
-```ts
-import { firstValueFrom, from } from "rxjs";
-
-// The `from` is necessary to turn `observableQuery` into an RxJS observable
-const result = await firstValueFrom(from(observableQuery))
-```

package/.changeset/tough-rockets-allow.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": patch
----
-
-Fix an issue where additional response properties were returned on the result returned from `client.mutate`, such as `@defer` payload fields. These properties are now stripped out to correspond to the TypeScript type.

package/.changeset/tough-taxis-smoke.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove the `onCompleted` and `onError` callbacks from `useQuery` and `useLazyQuery`.
-
-See [#12352](https://github.com/apollographql/apollo-client/issues/12352) for more context on this change.

package/.changeset/tough-tips-drop.md

@@ -1,15 +0,0 @@
----
-"@apollo/client": major
----
-
-Subscriptions are no longer eagerly started after calling `client.subscribe`. To kick off the subscription, you will now need to subscribe to the returned observable.
-
-```ts
-// Subscriptions are no longer started when calling subscribe on its own.
-const subscriptionObservable = client.subscribe(...);
-
-// Instead, subscribe to the returned observable to kick off the subscription.
-subscriptionObservable.subscribe({
-  next: (value) => console.log(value)
-});
-```

package/.changeset/tricky-tables-shave.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-GraphQL errors or network errors emitted while using an `errorPolicy` of `ignore` in subscriptions will no longer emit a result if there is no `data` emitted along with the error.

package/.changeset/twenty-snakes-sort.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-`useLazyQuery` will now only execute the query when the execute function is called. Previously `useLazyQuery` would behave like `useQuery` after the first call to the execute function which means changes to options might perform network requests.
-
-You can now safely rerender `useLazyQuery` with new options which will take effect the next time you manually trigger the query.

package/.changeset/unlucky-kiwis-sell.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove the `called` property from `useQuery`.

package/.changeset/unlucky-sheep-change.md

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

package/.changeset/warm-ties-sit.md

@@ -1,7 +0,0 @@
----
-"@apollo/client": major
----
-
-Subscriptions no longer emit errors in the `error` callback and instead provide errors on the `error` property on the result passed to the `next` callback. As a result, errors will no longer automatically terminate the connection allowing additional results to be emitted when the connection stays open.
-
-When an error terminates the downstream connection, a `next` event will be emitted with an `error` property followed by a `complete` event instead.

package/.changeset/wicked-forks-double.md

@@ -1,33 +0,0 @@
----
-"@apollo/client": major
----
-
-Remove `newData` option for mocked responses passed to `MockLink` or the `mocks` option on `MockedProvider`. This option was undocumented and was nearly identical to using the `result` option as a callback.
-
-To replicate the old behavior of `newData`, use `result` as a callback and add the `maxUsageCount` option with a value set to `Number.POSITIVE_INFINITY`.
-
-**with `MockLink`**
-```diff
-new MockLink([
-  {
-    request: { query, variables },
--   newData: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
-+   result: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
-+   maxUsageCount: Number.POSITIVE_INFINITY,
-  }
-])
-```
-
-**with `MockedProvider`**
-```diff
-<MockedProvider
-  mocks={[
-    {
-      request: { query, variables },
--     newData: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
-+     result: (variables) => ({ data: { greeting: "Hello " + variables.greeting } }),
-+     maxUsageCount: Number.POSITIVE_INFINITY,
-    }
-  ]}
-/>
-```

package/.changeset/wicked-kiwis-buy.md

@@ -1,5 +0,0 @@
----
-"@apollo/client": major
----
-
-A call to `ObservableQuery.setVariables` with different variables or a `ObservableQuery.refetch` call will always now guarantee that a value will be emitted from the observable, even if it is deep equal to the previous value.