@apollo/client 4.0.0-alpha.2 → 4.0.0-alpha.20

package/__cjs/core/index.d.cts

@@ -1,21 +1,21 @@
 export type { ApolloClientOptions, DefaultOptions } from "./ApolloClient.cjs";
-export { ApolloClient, mergeOptions } from "./ApolloClient.cjs";
+export { ApolloClient } from "./ApolloClient.cjs";
 export type { FetchMoreOptions } from "./ObservableQuery.cjs";
 export { ObservableQuery } from "./ObservableQuery.cjs";
 export type { ErrorPolicy, FetchMoreQueryOptions, FetchPolicy, MutationFetchPolicy, MutationOptions, QueryOptions, RefetchWritePolicy, SubscribeToMoreFunction, SubscribeToMoreOptions, SubscribeToMoreUpdateQueryFn, SubscriptionOptions, UpdateQueryMapFn, UpdateQueryOptions, WatchQueryFetchPolicy, WatchQueryOptions, } from "./watchQueryOptions.cjs";
 export { isNetworkRequestSettled, NetworkStatus } from "./networkStatus.cjs";
-export type * from "./types.cjs";
-export type { FragmentMatcher, Resolver } from "./LocalState.cjs";
-export { CombinedGraphQLErrors, CombinedProtocolErrors, ServerError, ServerParseError, UnconventionalError, } from "../errors/index.cjs";
-export type { DataProxy, FieldFunctionOptions, FieldMergeFunction, FieldPolicy, FieldReadFunction, InMemoryCacheConfig, PossibleTypesMap, ReactiveVar, Transaction, TypePolicies, TypePolicy, WatchFragmentOptions, WatchFragmentResult, } from "../cache/index.cjs";
-export type { Cache } from "../cache/index.cjs";
-export { ApolloCache, defaultDataIdFromObject, InMemoryCache, makeVar, MissingFieldError, } from "../cache/index.cjs";
-export type * from "../cache/inmemory/types.cjs";
-export * from "../link/core/index.cjs";
-export * from "../link/http/index.cjs";
-export type { DataMasking, FragmentType, Masked, MaskedDocumentNode, MaybeMasked, Unmasked, } from "../masking/index.cjs";
-export type { DocumentTransformCacheKey, Reference, StoreObject, } from "../utilities/index.cjs";
-export { DocumentTransform, isReference, makeReference, Observable, } from "../utilities/index.cjs";
+export type { ApolloQueryResult, ClientAwareness, DataState, DefaultContext, ErrorLike, GetDataState, InternalRefetchQueriesInclude, InternalRefetchQueriesMap, InternalRefetchQueriesOptions, InternalRefetchQueriesResult, InternalRefetchQueryDescriptor, MethodKeys, MutateResult, MutationQueryReducer, MutationQueryReducersMap, MutationUpdaterFn, MutationUpdaterFunction, OnQueryUpdated, OperationVariables, QueryListener, QueryResult, RefetchQueriesInclude, RefetchQueriesOptions, RefetchQueriesPromiseResults, RefetchQueriesResult, RefetchQueryDescriptor, SubscribeResult, SubscriptionObservable, TypedDocumentNode, } from "./types.cjs";
+export { CombinedGraphQLErrors, CombinedProtocolErrors, LinkError, LocalStateError, ServerError, ServerParseError, UnconventionalError, } from "@apollo/client/errors";
+export type { ApolloReducerConfig, Cache, DataProxy, DiffQueryAgainstStoreOptions, FieldFunctionOptions, FieldMergeFunction, FieldPolicy, FieldReadFunction, IdGetter, IdGetterObj, InMemoryCacheConfig, MergeInfo, MergeTree, NormalizedCache, NormalizedCacheObject, OptimisticStoreItem, PossibleTypesMap, ReactiveVar, ReadMergeModifyContext, ReadQueryOptions, StoreValue, Transaction, TypePolicies, TypePolicy, WatchFragmentOptions, WatchFragmentResult, } from "@apollo/client/cache";
+export { ApolloCache, defaultDataIdFromObject, InMemoryCache, makeVar, MissingFieldError, } from "@apollo/client/cache";
+export { ApolloLink, concat, empty, execute, from, split, } from "@apollo/client/link";
+export type { ApolloPayloadResult, DocumentNode, ExecutionPatchIncrementalResult, ExecutionPatchInitialResult, ExecutionPatchResult, FetchResult, GraphQLRequest, IncrementalPayload, NextLink, Operation, OperationContext, Path, RequestHandler, SingleExecutionResult, } from "@apollo/client/link";
+export { checkFetcher, createHttpLink, createSignalIfSupported, defaultPrinter, fallbackHttpConfig, HttpLink, parseAndCheckHttpResponse, rewriteURIForGET, selectHttpOptionsAndBody, selectHttpOptionsAndBodyInternal, selectURI, serializeFetchParameter, } from "@apollo/client/link/http";
+export type { ClientParseError } from "@apollo/client/link/http";
+export type { DataMasking, FragmentType, Masked, MaskedDocumentNode, MaybeMasked, Unmasked, } from "@apollo/client/masking";
+export type { DocumentTransformCacheKey, Reference, StoreObject, } from "@apollo/client/utilities";
+export { DocumentTransform, isReference, Observable, } from "@apollo/client/utilities";
 export { setVerbosity as setLogVerbosity } from "@apollo/client/utilities/invariant";
 export { disableExperimentalFragmentVariables, disableFragmentWarnings, enableExperimentalFragmentVariables, gql, resetCaches, } from "graphql-tag";
+export { version } from "../version.cjs";
 //# sourceMappingURL=index.d.cts.map

package/__cjs/core/types.d.cts

@@ -1,10 +1,11 @@
 import type { DocumentNode } from "graphql";
+import type { NextNotification, Observable, ObservableNotification } from "rxjs";
 import type { ApolloCache } from "@apollo/client/cache";
 import type { Cache } from "@apollo/client/cache";
-import type { FetchResult } from "@apollo/client/link/core";
+import type { FetchResult } from "@apollo/client/link";
 import type { Unmasked } from "@apollo/client/masking";
-import type { IsStrictlyAny } from "@apollo/client/utilities";
-import type { Resolver } from "./LocalState.cjs";
+import type { DeepPartial } from "@apollo/client/utilities";
+import type { IsAny } from "@apollo/client/utilities/internal";
 import type { NetworkStatus } from "./networkStatus.cjs";
 import type { ObservableQuery } from "./ObservableQuery.cjs";
 import type { QueryInfo } from "./QueryInfo.cjs";
@@ -13,7 +14,12 @@ export type { TypedDocumentNode } from "@graphql-typed-document-node/core";
 export type MethodKeys<T> = {
     [P in keyof T]: T[P] extends Function ? P : never;
 }[keyof T];
+export interface ClientAwareness {
+    name?: string;
+    version?: string;
+}
 export interface DefaultContext extends Record<string, any> {
+    queryDeduplication?: boolean;
 }
 export type QueryListener = (queryInfo: QueryInfo) => void;
 /**
@@ -61,7 +67,7 @@ export interface RefetchQueriesOptions<TCache extends ApolloCache, TResult> {
     optimistic?: boolean;
     onQueryUpdated?: OnQueryUpdated<TResult> | null;
 }
-export type RefetchQueriesPromiseResults<TResult> = IsStrictlyAny<TResult> extends true ? any[] : TResult extends boolean ? ApolloQueryResult<any>[] : TResult extends PromiseLike<infer U> ? U[] : TResult[];
+export type RefetchQueriesPromiseResults<TResult> = IsAny<TResult> extends true ? any[] : TResult extends boolean ? QueryResult<any>[] : TResult extends PromiseLike<infer U> ? U[] : TResult[];
 export interface RefetchQueriesResult<TResult> extends Promise<RefetchQueriesPromiseResults<TResult>> {
     queries: ObservableQuery<any>[];
     results: InternalRefetchQueriesResult<TResult>[];
@@ -70,12 +76,10 @@ export interface InternalRefetchQueriesOptions<TCache extends ApolloCache, TResu
     include?: InternalRefetchQueriesInclude;
     removeOptimistic?: string;
 }
-export type InternalRefetchQueriesResult<TResult> = TResult extends boolean ? Promise<ApolloQueryResult<any>> : TResult;
+export type InternalRefetchQueriesResult<TResult> = TResult extends boolean ? Promise<QueryResult<any>> : TResult;
 export type InternalRefetchQueriesMap<TResult> = Map<ObservableQuery<any>, InternalRefetchQueriesResult<TResult>>;
-export type { QueryOptions as PureQueryOptions };
 export type OperationVariables = Record<string, any>;
-export interface ApolloQueryResult<T> {
-    data: T | undefined;
+export type ApolloQueryResult<TData, TStates extends DataState<TData>["dataState"] = DataState<TData>["dataState"]> = {
     /**
      * The single Error object that is passed to onError and useQuery hooks, and is often thrown during manual `client.query` calls.
      * This will contain both a NetworkError field and any GraphQLErrors.
@@ -91,7 +95,29 @@ export interface ApolloQueryResult<T> {
      * @deprecated This field will be removed in a future version of Apollo Client.
      */
     partial: boolean;
-}
+} & GetDataState<TData, TStates>;
+export type DataState<TData> = {
+    data: TData;
+    /**
+    * Describes the completeness of `data`. - `empty`: No data could be fulfilled from the cache or the result is incomplete. `data` is `undefined`. - `partial`: Some data could be fulfilled from the cache but `data` is incomplete. This is only possible when `returnPartialData` is `true`. - `streaming`: `data` is incomplete as a result of a deferred query and the result is still streaming in. - `complete`: `data` is a fully satisfied query result fulfilled either from the cache or network.
+    */
+    dataState: "complete" | "streaming";
+} | {
+    data: DeepPartial<TData>;
+    /**
+    * Describes the completeness of `data`. - `empty`: No data could be fulfilled from the cache or the result is incomplete. `data` is `undefined`. - `partial`: Some data could be fulfilled from the cache but `data` is incomplete. This is only possible when `returnPartialData` is `true`. - `streaming`: `data` is incomplete as a result of a deferred query and the result is still streaming in. - `complete`: `data` is a fully satisfied query result fulfilled either from the cache or network.
+    */
+    dataState: "partial";
+} | {
+    data: undefined;
+    /**
+    * Describes the completeness of `data`. - `empty`: No data could be fulfilled from the cache or the result is incomplete. `data` is `undefined`. - `partial`: Some data could be fulfilled from the cache but `data` is incomplete. This is only possible when `returnPartialData` is `true`. - `streaming`: `data` is incomplete as a result of a deferred query and the result is still streaming in. - `complete`: `data` is a fully satisfied query result fulfilled either from the cache or network.
+    */
+    dataState: "empty";
+};
+export type GetDataState<TData, TState extends DataState<TData>["dataState"]> = Extract<DataState<TData>, {
+    dataState: TState;
+}>;
 export type MutationQueryReducer<T> = (previousResult: Record<string, any>, options: {
     mutationResult: FetchResult<Unmasked<T>>;
     queryName: string | undefined;
@@ -108,13 +134,99 @@ export type MutationQueryReducersMap<T = {
 export type MutationUpdaterFn<T = {
     [key: string]: any;
 }> = (cache: ApolloCache, mutationResult: FetchResult<T>) => void;
-export type MutationUpdaterFunction<TData, TVariables, TContext, TCache extends ApolloCache> = (cache: TCache, result: Omit<FetchResult<Unmasked<TData>>, "context">, options: {
-    context?: TContext;
+export type MutationUpdaterFunction<TData, TVariables, TCache extends ApolloCache> = (cache: TCache, result: Omit<FetchResult<Unmasked<TData>>, "context">, options: {
+    context?: DefaultContext;
     variables?: TVariables;
 }) => void;
-export interface Resolvers {
-    [key: string]: {
-        [field: string]: Resolver;
+export interface MutateResult<TData = unknown> {
+    /**
+    * The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.
+    */
+    data: TData | undefined;
+    /**
+    * If the mutation produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.
+    * 
+    * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
+    */
+    error?: ErrorLike;
+    /**
+    * Custom extensions returned from the GraphQL server
+    */
+    extensions?: Record<string, unknown>;
+}
+export interface SubscribeResult<TData = unknown> {
+    /**
+    * The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.
+    */
+    data: TData | undefined;
+    /**
+    * If the mutation produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.
+    * 
+    * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
+    */
+    error?: ErrorLike;
+    /**
+    * Custom extensions returned from the GraphQL server
+    */
+    extensions?: Record<string, unknown>;
+}
+export interface QueryResult<TData = unknown> {
+    /**
+    * An object containing the result of your GraphQL query after it completes.
+    * 
+    * This value might be `undefined` if a query results in one or more errors (depending on the query's `errorPolicy`).
+    * 
+    * @docGroup
+    * 
+    * 1. Operation data
+    */
+    data: TData | undefined;
+    /**
+    * If the query produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.
+    * 
+    * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
+    * 
+    * @docGroup
+    * 
+    * 1. Operation data
+    */
+    error?: ErrorLike;
+}
+export declare namespace QueryNotification {
+    type NewNetworkStatus<TData> = NextNotification<{
+        resetError?: boolean;
+    }> & {
+        source: "newNetworkStatus";
+    };
+    type SetResult<TData> = NextNotification<ApolloQueryResult<TData>> & {
+        source: "setResult";
+    };
+    type FromNetwork<TData> = ObservableNotification<ApolloQueryResult<TData>> & {
+        source: "network";
     };
+    type FromCache<TData> = NextNotification<ApolloQueryResult<TData>> & {
+        source: "cache";
+    };
+    type Value<TData> = FromCache<TData> | FromNetwork<TData> | NewNetworkStatus<TData> | SetResult<TData>;
+}
+/** Observable created by initiating a subscription operation. */
+export interface SubscriptionObservable<T> extends Observable<T> {
+    /**
+     * Used to restart the connection to the link chain. Calling this on a
+     * deduplicated subscription will restart the connection for all observables
+     * that share the request.
+     *
+     * @example
+     *
+     * ```ts
+     * const observable = client.subscribe({ query: subscription });
+     * observable.subscribe((value) => {
+     *   // ...
+     * });
+     *
+     * observable.restart();
+     * ```
+     */
+    restart: () => void;
 }
 //# sourceMappingURL=types.d.cts.map

package/__cjs/core/watchQueryOptions.d.cts

@@ -1,9 +1,10 @@
 import type { TypedDocumentNode } from "@graphql-typed-document-node/core";
 import type { DocumentNode } from "graphql";
 import type { ApolloCache } from "@apollo/client/cache";
-import type { FetchResult } from "@apollo/client/link/core";
+import type { FetchResult } from "@apollo/client/link";
 import type { Unmasked } from "@apollo/client/masking";
-import type { DeepPartial, NoInfer } from "@apollo/client/utilities";
+import type { DeepPartial } from "@apollo/client/utilities";
+import type { NoInfer, VariablesOption } from "@apollo/client/utilities/internal";
 import type { IgnoreModifier } from "../cache/core/types/common.cjs";
 import type { ObservableQuery } from "./ObservableQuery.cjs";
 import type { DefaultContext, InternalRefetchQueriesInclude, MutationQueryReducersMap, MutationUpdaterFunction, OnQueryUpdated, OperationVariables } from "./types.cjs";
@@ -16,8 +17,8 @@ import type { DefaultContext, InternalRefetchQueriesInclude, MutationQueryReduce
  * - network-only: return result from network, fail if network call doesn't succeed, save to cache
  * - standby: only for queries that aren't actively watched, but should be available for refetch and updateQueries.
  */
-export type FetchPolicy = "cache-first" | "network-only" | "cache-only" | "no-cache" | "standby";
-export type WatchQueryFetchPolicy = FetchPolicy | "cache-and-network";
+export type FetchPolicy = "cache-first" | "network-only" | "cache-only" | "no-cache";
+export type WatchQueryFetchPolicy = FetchPolicy | "cache-and-network" | "standby";
 export type MutationFetchPolicy = Extract<FetchPolicy, "network-only" | "no-cache">;
 export type RefetchWritePolicy = "merge" | "overwrite";
 /**
@@ -30,7 +31,7 @@ export type ErrorPolicy = "none" | "ignore" | "all";
 /**
  * Query options.
  */
-export interface QueryOptions<TVariables = OperationVariables, TData = unknown> {
+export type QueryOptions<TVariables extends OperationVariables = OperationVariables, TData = unknown> = {
     /**
     * A GraphQL query string parsed into an AST with the gql template literal.
     * 
@@ -40,16 +41,6 @@ export interface QueryOptions<TVariables = OperationVariables, TData = unknown>
     */
     query: DocumentNode | TypedDocumentNode<TData, TVariables>;
     /**
-    * An object containing all of the GraphQL variables your query requires to execute.
-    * 
-    * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
-    * 
-    * @docGroup
-    * 
-    * 1. Operation options
-    */
-    variables?: TVariables;
-    /**
     * Specifies how the query handles a response that returns both GraphQL errors and partial results.
     * 
     * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
@@ -81,51 +72,11 @@ export interface QueryOptions<TVariables = OperationVariables, TData = unknown>
     * 3. Caching options
     */
     fetchPolicy?: FetchPolicy;
-    /**
-    * Specifies the interval (in milliseconds) at which the query polls for updated results.
-    * 
-    * The default value is `0` (no polling).
-    * 
-    * @docGroup
-    * 
-    * 2. Networking options
-    */
-    pollInterval?: number;
-    /**
-    * If `true`, the in-progress query's associated component re-renders whenever the network status changes or a network error occurs.
-    * 
-    * The default value is `false`.
-    * 
-    * @docGroup
-    * 
-    * 2. Networking options
-    */
-    notifyOnNetworkStatusChange?: boolean;
-    /**
-    * If `true`, the query can return partial results from the cache if the cache doesn't contain results for all queried fields.
-    * 
-    * The default value is `false`.
-    * 
-    * @docGroup
-    * 
-    * 3. Caching options
-    */
-    returnPartialData?: boolean;
-}
+} & VariablesOption<NoInfer<TVariables>>;
 /**
  * Watched query options.
  */
-export interface WatchQueryOptions<TVariables extends OperationVariables = OperationVariables, TData = unknown> extends SharedWatchQueryOptions<TVariables, TData> {
-    /**
-    * A GraphQL query string parsed into an AST with the gql template literal.
-    * 
-    * @docGroup
-    * 
-    * 1. Operation options
-    */
-    query: DocumentNode | TypedDocumentNode<TData, TVariables>;
-}
-export interface SharedWatchQueryOptions<TVariables extends OperationVariables, TData> {
+export type WatchQueryOptions<TVariables extends OperationVariables = OperationVariables, TData = unknown> = {
     /**
     * Specifies how the query interacts with the Apollo Client cache during execution (for example, whether it checks the cache for results before sending a request to the server).
     * 
@@ -163,16 +114,6 @@ export interface SharedWatchQueryOptions<TVariables extends OperationVariables,
     */
     refetchWritePolicy?: RefetchWritePolicy;
     /**
-    * An object containing all of the GraphQL variables your query requires to execute.
-    * 
-    * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
-    * 
-    * @docGroup
-    * 
-    * 1. Operation options
-    */
-    variables?: TVariables;
-    /**
     * Specifies how the query handles a response that returns both GraphQL errors and partial results.
     * 
     * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
@@ -205,7 +146,7 @@ export interface SharedWatchQueryOptions<TVariables extends OperationVariables,
     /**
     * If `true`, the in-progress query's associated component re-renders whenever the network status changes or a network error occurs.
     * 
-    * The default value is `false`.
+    * The default value is `true`.
     * 
     * @docGroup
     * 
@@ -230,7 +171,15 @@ export interface SharedWatchQueryOptions<TVariables extends OperationVariables,
     * 2. Networking options
     */
     skipPollAttempt?: () => boolean;
-}
+    /**
+    * A GraphQL query string parsed into an AST with the gql template literal.
+    * 
+    * @docGroup
+    * 
+    * 1. Operation options
+    */
+    query: DocumentNode | TypedDocumentNode<TData, TVariables>;
+} & VariablesOption<NoInfer<TVariables>>;
 export interface NextFetchPolicyContext<TData, TVariables extends OperationVariables> {
     reason: "after-fetch" | "variables-changed";
     observable: ObservableQuery<TData, TVariables>;
@@ -255,7 +204,7 @@ export interface FetchMoreQueryOptions<TVariables, TData = unknown> {
     * 
     * 1. Operation options
     */
-    variables?: Partial<TVariables>;
+    variables?: Partial<NoInfer<TVariables>>;
     context?: DefaultContext;
 }
 export type UpdateQueryOptions<TData, TVariables> = {
@@ -306,16 +255,12 @@ export interface SubscribeToMoreOptions<TData = unknown, TSubscriptionVariables
 export interface SubscribeToMoreFunction<TData, TVariables extends OperationVariables = OperationVariables> {
     <TSubscriptionData = TData, TSubscriptionVariables extends OperationVariables = TVariables>(options: SubscribeToMoreOptions<TData, TSubscriptionVariables, TSubscriptionData, TVariables>): () => void;
 }
-export interface SubscriptionOptions<TVariables = OperationVariables, TData = unknown> {
+export type SubscriptionOptions<TVariables extends OperationVariables = OperationVariables, TData = unknown> = {
     /**
     * A GraphQL document, often created with `gql` from the `graphql-tag` package, that contains a single subscription inside of it.
     */
     query: DocumentNode | TypedDocumentNode<TData, TVariables>;
     /**
-    * An object containing all of the variables your subscription needs to execute
-    */
-    variables?: TVariables;
-    /**
     * How you want your component to interact with the Apollo cache. For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).
     */
     fetchPolicy?: FetchPolicy;
@@ -331,8 +276,8 @@ export interface SubscriptionOptions<TVariables = OperationVariables, TData = un
     * Shared context between your component and your network interface (Apollo Link).
     */
     extensions?: Record<string, any>;
-}
-interface MutationBaseOptions<TData = unknown, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache = ApolloCache> {
+} & VariablesOption<NoInfer<TVariables>>;
+export type MutationOptions<TData = unknown, TVariables extends OperationVariables = OperationVariables, TCache extends ApolloCache = ApolloCache> = {
     /**
     * By providing either an object or a callback function that, when invoked after a mutation, allows you to return optimistic data and optionally skip updates via the `IGNORE` sentinel object, Apollo Client caches this temporary (and potentially incorrect) response until the mutation completes, enabling more responsive UI updates.
     * 
@@ -382,7 +327,7 @@ interface MutationBaseOptions<TData = unknown, TVariables = OperationVariables,
     * 
     * 3. Caching options
     */
-    update?: MutationUpdaterFunction<TData, TVariables, TContext, TCache>;
+    update?: MutationUpdaterFunction<TData, TVariables, TCache>;
     /**
     * Optional callback for intercepting queries whose cache data has been updated by the mutation, as well as any queries specified in the `refetchQueries: [...]` list passed to `client.mutate`.
     * 
@@ -406,35 +351,13 @@ interface MutationBaseOptions<TData = unknown, TVariables = OperationVariables,
     */
     errorPolicy?: ErrorPolicy;
     /**
-    * An object containing all of the GraphQL variables your mutation requires to execute.
-    * 
-    * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
-    * 
-    * @docGroup
-    * 
-    * 1. Operation options
-    */
-    variables?: TVariables;
-    /**
     * If you're using [Apollo Link](https://www.apollographql.com/docs/react/api/link/introduction/), this object is the initial value of the `context` object that's passed along your link chain.
     * 
     * @docGroup
     * 
     * 2. Networking options
     */
-    context?: TContext;
-}
-export interface MutationOptions<TData = unknown, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache = ApolloCache> extends MutationSharedOptions<TData, TVariables, TContext, TCache> {
-    /**
-    * A GraphQL document, often created with `gql` from the `graphql-tag` package, that contains a single mutation inside of it.
-    * 
-    * @docGroup
-    * 
-    * 1. Operation options
-    */
-    mutation: DocumentNode | TypedDocumentNode<TData, TVariables>;
-}
-export interface MutationSharedOptions<TData = unknown, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache = ApolloCache> extends MutationBaseOptions<TData, TVariables, TContext, TCache> {
+    context?: DefaultContext;
     /**
     * Provide `no-cache` if the mutation's result should _not_ be written to the Apollo Client cache.
     * 
@@ -451,6 +374,13 @@ export interface MutationSharedOptions<TData = unknown, TVariables = OperationVa
     * To avoid retaining sensitive information from mutation root field arguments, Apollo Client v3.4+ automatically clears any `ROOT_MUTATION` fields from the cache after each mutation finishes. If you need this information to remain in the cache, you can prevent the removal by passing `keepRootFields: true` to the mutation. `ROOT_MUTATION` result data are also passed to the mutation `update` function, so we recommend obtaining the results that way, rather than using this option, if possible.
     */
     keepRootFields?: boolean;
-}
-export {};
+    /**
+    * A GraphQL document, often created with `gql` from the `graphql-tag` package, that contains a single mutation inside of it.
+    * 
+    * @docGroup
+    * 
+    * 1. Operation options
+    */
+    mutation: DocumentNode | TypedDocumentNode<TData, TVariables>;
+} & VariablesOption<NoInfer<TVariables>>;
 //# sourceMappingURL=watchQueryOptions.d.cts.map

package/__cjs/dev/loadErrorMessageHandler.cjs

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadErrorMessageHandler = loadErrorMessageHandler;
-const tslib_1 = require("tslib");
-const global_js_1 = tslib_1.__importDefault(require("../utilities/globals/global.cjs"));
+const globals_1 = require("@apollo/client/utilities/internal/globals");
 const setErrorMessageHandler_js_1 = require("./setErrorMessageHandler.cjs");
 const symbol_js_1 = require("./symbol.cjs");
 /**
@@ -18,7 +17,7 @@ function loadErrorMessageHandler(...errorCodes) {
 }
 const handler = ((message, args) => {
     if (typeof message === "number") {
-        const definition = global_js_1.default[symbol_js_1.ApolloErrorMessageHandler][message];
+        const definition = globals_1.global[symbol_js_1.ApolloErrorMessageHandler][message];
         if (!message || !definition?.message)
             return;
         message = definition.message;

package/__cjs/dev/loadErrorMessageHandler.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadErrorMessageHandler.cjs","sources":["../../../src/dev/loadErrorMessageHandler.ts"],"sourcesContent":["import type { ErrorCodes } from \"../invariantErrorCodes.js\";\nimport global from \"../utilities/globals/global.js\";\n\nimport type { ErrorMessageHandler } from \"./setErrorMessageHandler.js\";\nimport { setErrorMessageHandler } from \"./setErrorMessageHandler.js\";\nimport { ApolloErrorMessageHandler } from \"./symbol.js\";\n\n/**\n * Injects Apollo Client's default error message handler into the application and\n * also loads the error codes that are passed in as arguments.\n */\nexport function loadErrorMessageHandler(...errorCodes: ErrorCodes[]) {\n  setErrorMessageHandler(handler as typeof handler & ErrorCodes);\n\n  for (const codes of errorCodes) {\n    Object.assign(handler, codes);\n  }\n\n  return handler;\n}\n\nconst handler = ((message: string | number, args: unknown[]) => {\n  if (typeof message === \"number\") {\n    const definition = global[ApolloErrorMessageHandler]![message];\n    if (!message || !definition?.message) return;\n    message = definition.message;\n  }\n  return args.reduce<string>(\n    (msg, arg) => msg.replace(/%[sdfo]/, String(arg)),\n    String(message)\n  );\n}) as ErrorMessageHandler & ErrorCodes;\n"],"names":[],"mappings":";;AAWA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;;AAVA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAGA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAEA,CAAA,CAAA;;;CAGA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAgB,CAAhB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAuC,CAAC,CAAxC,CAAA,CAA2C,CAA3C,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAmE,EAAnE;IACE,CAAF,CAAA,EAAE,CAAF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAwB,CAAxB,CAAyB,CAAzB,CAAA,CAAA,CAAA,CAAA,CAAA,CAA+D,CAAC;IAE9D,CAAF,CAAA,EAAA,CAAO,CAAP,CAAA,CAAA,CAAA,EAAa,CAAb,CAAA,CAAA,CAAA,EAAA,CAAA,EAAsB,CAAtB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAgC,EAAE;QAC9B,CAAJ,CAAA,CAAA,CAAA,CAAA,CAAU,CAAC,CAAX,CAAA,CAAA,CAAA,CAAA,CAAiB,CAAC,CAAlB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAyB,EAAE,CAA3B,CAAA,CAAA,CAAA,CAAgC,CAAC;IAC/B;IAEA,CAAF,CAAA,CAAA,CAAA,CAAA,EAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAgB;AAChB;AAEA,CAAA,CAAA,CAAA,CAAA,EAAM,CAAN,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAgB,CAAC,CAAC,CAAlB,CAAA,CAAA,CAAA,CAAA,CAAA,CAA0C,EAAE,CAA5C,CAAA,CAAA,CAA2D,EAAE,CAA7D,EAAA;IACE,CAAF,EAAA,CAAM,CAAN,CAAA,CAAA,CAAA,CAAA,EAAa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,EAAyB,CAAzB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAiC,EAAE;QAC/B,CAAJ,CAAA,CAAA,CAAA,EAAU,CAAV,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAuB,CAAvB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA6B,CAAC,CAA9B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAuD,CAAE,CAAC,CAA1D,CAAA,CAAA,CAAA,CAAA,CAAA,CAAiE,CAAC;QAC9D,CAAJ,EAAA,CAAQ,CAAC,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,EAAoB,CAAC,CAArB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA+B,CAA/B,CAAiC,CAAjC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAwC;YAAE,CAA1C,CAAA,CAAA,CAAA,CAAA,CAAA;QACI,CAAJ,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAc,CAAd,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAwB,CAAC,CAAzB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAgC;IAC9B;WACO,CAAT,CAAA,CAAA,CAAa,CAAC,CAAd,CAAA,CAAA,CAAA,CAAA,CAAoB,CAChB,CAAC,CADL,CAAA,CACQ,EAAE,CADV,CAAA,CACa,EAAE,CADf,EACkB,CADlB,CAAA,CACqB,CAAC,CADtB,CAAA,CAAA,CAAA,CAAA,CAAA,CAC6B,UAAU,EAAE,CADzC,CAAA,CAAA,CAAA,CAAA,CAC+C,CAAC,CADhD,CAAA,CACmD,CAAC,CAAC,EACjD,CAFJ,CAAA,CAAA,CAAA,CAAA,CAEU,CAAC,CAFX,CAAA,CAAA,CAAA,CAAA,CAAA,CAEkB,CAAC;AAEnB,CAAC,CAAD;"}
+{"version":3,"file":"loadErrorMessageHandler.cjs","sources":["../../../src/dev/loadErrorMessageHandler.ts"],"sourcesContent":["import { global } from \"@apollo/client/utilities/internal/globals\";\n\nimport type { ErrorCodes } from \"../invariantErrorCodes.js\";\n\nimport type { ErrorMessageHandler } from \"./setErrorMessageHandler.js\";\nimport { setErrorMessageHandler } from \"./setErrorMessageHandler.js\";\nimport { ApolloErrorMessageHandler } from \"./symbol.js\";\n\n/**\n * Injects Apollo Client's default error message handler into the application and\n * also loads the error codes that are passed in as arguments.\n */\nexport function loadErrorMessageHandler(...errorCodes: ErrorCodes[]) {\n  setErrorMessageHandler(handler as typeof handler & ErrorCodes);\n\n  for (const codes of errorCodes) {\n    Object.assign(handler, codes);\n  }\n\n  return handler;\n}\n\nconst handler = ((message: string | number, args: unknown[]) => {\n  if (typeof message === \"number\") {\n    const definition = global[ApolloErrorMessageHandler]![message];\n    if (!message || !definition?.message) return;\n    message = definition.message;\n  }\n  return args.reduce<string>(\n    (msg, arg) => msg.replace(/%[sdfo]/, String(arg)),\n    String(message)\n  );\n}) as ErrorMessageHandler & ErrorCodes;\n"],"names":[],"mappings":";;AAYA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAZA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAKA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAEA,CAA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"}

package/__cjs/dev/setErrorMessageHandler.cjs

@@ -1,13 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setErrorMessageHandler = setErrorMessageHandler;
-const tslib_1 = require("tslib");
-const global_js_1 = tslib_1.__importDefault(require("../utilities/globals/global.cjs"));
+const globals_1 = require("@apollo/client/utilities/internal/globals");
 const symbol_js_1 = require("./symbol.cjs");
 /**
  * Overrides the global "Error Message Handler" with a custom implementation.
  */
 function setErrorMessageHandler(handler) {
-    global_js_1.default[symbol_js_1.ApolloErrorMessageHandler] = handler;
+    globals_1.global[symbol_js_1.ApolloErrorMessageHandler] = handler;
 }
 //# sourceMappingURL=setErrorMessageHandler.cjs.map

package/__cjs/dev/setErrorMessageHandler.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"setErrorMessageHandler.cjs","sources":["../../../src/dev/setErrorMessageHandler.ts"],"sourcesContent":["import type { ErrorCodes } from \"../invariantErrorCodes.js\";\nimport global from \"../utilities/globals/global.js\";\n\nimport { ApolloErrorMessageHandler } from \"./symbol.js\";\n\n/**\n * The error message handler is a function that is called when a message is\n * logged or an error is thrown to determine the contents of the error message\n * to be logged or thrown.\n */\nexport type ErrorMessageHandler = {\n  /**\n   * @param message - Usually the error message number (as defined in\n   * `@apollo/client/invariantErrorCodes.js`).\n   * In some edge cases, this can already be a string, that can be passed through\n   * as an error message.\n   *\n   * @param args - The placeholders that can be passed into the error message (pre-stringified).\n   * These relate with the `%s` and `%d` [substitution strings](https://developer.mozilla.org/en-US/docs/Web/API/console#using_string_substitutions)\n   * in the error message defined in `@apollo/client/invariantErrorCodes.js`.\n   *\n   * ⚠️ Note that arguments will only be passed in for error messages.\n   * For normal log messages, you will get an empty array here and they will directly\n   * be passed to `console.log` instead, to have the string subsitution done by the\n   * engine, as that allows for nicer (and in the case of a browser, interactive)\n   * output.\n   *\n   * @returns The error message to be logged or thrown. If it returns `undefined`,\n   *          the mechanism will fall back to the default:\n   *          A link to https://go.apollo.dev/c/err with Apollo Client version,\n   *          the error message number, and the error message arguments encoded into\n   *          the URL hash.\n   */ (message: string | number, args: string[]): string | undefined;\n};\n\n/**\n * Overrides the global \"Error Message Handler\" with a custom implementation.\n */\nexport function setErrorMessageHandler(handler: ErrorMessageHandler) {\n  global[ApolloErrorMessageHandler] = handler as typeof handler & ErrorCodes;\n}\n"],"names":[],"mappings":";;AAsCA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;;AArCA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAEA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAgCA,CAAA,CAAA;;CAEA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAgB,CAAhB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAuC,CAAvC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA;IACE,CAAF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAQ,CAAC,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAkC,EAAlC,EAAsC,CAAtC,CAAA,CAAA,CAAA,CAAA,CAAA,CAA4E;AAC5E;"}
+{"version":3,"file":"setErrorMessageHandler.cjs","sources":["../../../src/dev/setErrorMessageHandler.ts"],"sourcesContent":["import type { ErrorCodes } from \"../invariantErrorCodes.js\";\nimport { global } from \"@apollo/client/utilities/internal/globals\";\n\nimport { ApolloErrorMessageHandler } from \"./symbol.js\";\n\n/**\n * The error message handler is a function that is called when a message is\n * logged or an error is thrown to determine the contents of the error message\n * to be logged or thrown.\n */\nexport type ErrorMessageHandler = {\n  /**\n   * @param message - Usually the error message number (as defined in\n   * `@apollo/client/invariantErrorCodes.js`).\n   * In some edge cases, this can already be a string, that can be passed through\n   * as an error message.\n   *\n   * @param args - The placeholders that can be passed into the error message (pre-stringified).\n   * These relate with the `%s` and `%d` [substitution strings](https://developer.mozilla.org/en-US/docs/Web/API/console#using_string_substitutions)\n   * in the error message defined in `@apollo/client/invariantErrorCodes.js`.\n   *\n   * ⚠️ Note that arguments will only be passed in for error messages.\n   * For normal log messages, you will get an empty array here and they will directly\n   * be passed to `console.log` instead, to have the string subsitution done by the\n   * engine, as that allows for nicer (and in the case of a browser, interactive)\n   * output.\n   *\n   * @returns The error message to be logged or thrown. If it returns `undefined`,\n   *          the mechanism will fall back to the default:\n   *          A link to https://go.apollo.dev/c/err with Apollo Client version,\n   *          the error message number, and the error message arguments encoded into\n   *          the URL hash.\n   */ (message: string | number, args: string[]): string | undefined;\n};\n\n/**\n * Overrides the global \"Error Message Handler\" with a custom implementation.\n */\nexport function setErrorMessageHandler(handler: ErrorMessageHandler) {\n  global[ApolloErrorMessageHandler] = handler as typeof handler & ErrorCodes;\n}\n"],"names":[],"mappings":";;AAsCA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AArCA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAEA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAgCA,CAAA,CAAA;;CAEA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAgB,CAAhB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAuC,CAAvC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA;IACE,CAAF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAQ,CAAC,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAkC,EAAlC,EAAsC,CAAtC,CAAA,CAAA,CAAA,CAAA,CAAA,CAA4E;AAC5E;"}

package/__cjs/errors/CombinedGraphQLErrors.cjs

@@ -1,30 +1,49 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CombinedGraphQLErrors = void 0;
+const internal_1 = require("@apollo/client/utilities/internal");
+const utils_js_1 = require("./utils.cjs");
+function defaultFormatMessage(errors) {
+    return (errors
+        // Handle non-spec-compliant servers: See #1185
+        .filter((e) => e)
+        .map((e) => e.message || "Error message not found.")
+        .join("\n"));
+}
 /**
  * Represents the combined list of GraphQL errors returned from the server in a
  * GraphQL response.
  */
 class CombinedGraphQLErrors extends Error {
+    /** Determine if an error is a `CombinedGraphQLErrors` instance */
+    static is(error) {
+        return (0, utils_js_1.isBranded)(error, "CombinedGraphQLErrors");
+    }
+    /**
+     * Formats the error message used for the error `message` property. Override
+     * to provide your own formatting.
+     */
+    static formatMessage = defaultFormatMessage;
     /**
      * The raw list of GraphQL errors returned in a GraphQL response.
      */
     errors;
-    constructor(errors) {
-        super(formatMessage(errors));
+    /**
+     * Partial data returned in the GraphQL response.
+     */
+    data;
+    constructor(result) {
+        const errors = (0, internal_1.getGraphQLErrorsFromResult)(result);
+        super(CombinedGraphQLErrors.formatMessage(errors, {
+            result,
+            defaultFormatMessage,
+        }));
         this.errors = errors;
+        this.data = result.data;
         this.name = "CombinedGraphQLErrors";
+        (0, utils_js_1.brand)(this);
         Object.setPrototypeOf(this, CombinedGraphQLErrors.prototype);
     }
 }
 exports.CombinedGraphQLErrors = CombinedGraphQLErrors;
-function formatMessage(errors) {
-    const messageList = errors
-        // Handle non-spec-compliant servers: See #1185
-        .filter((e) => e)
-        .map((e) => `- ${e.message}`)
-        .join("\n");
-    return `The GraphQL server returned with errors:
-${messageList}`;
-}
 //# sourceMappingURL=CombinedGraphQLErrors.cjs.map