@apollo/client 3.14.0-alpha.0 → 3.14.0-alpha.1

package/core/core.cjs.native.js

@@ -22,7 +22,7 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 
 var equal__default = /*#__PURE__*/_interopDefaultLegacy(equal);
 
-var version = "3.14.0-alpha.0";
+var version = "3.14.0-alpha.1";
 
 function isNonNullObject(obj) {
     return obj !== null && typeof obj === "object";
@@ -195,9 +195,11 @@ function directiveIsNonreactive(dir) {
     return dir.name.value === "nonreactive";
 }
 
+var muteAllDeprecations = Symbol.for("apollo.deprecations");
+var global = globals.global;
 var slot = new optimism.Slot();
 function isMuted(name) {
-    return (slot.getValue() || []).includes(name);
+    return global[muteAllDeprecations] || (slot.getValue() || []).includes(name);
 }
 function muteDeprecations(name) {
     var args = [];
@@ -210,7 +212,7 @@ function warnRemovedOption(options, name, callSite, recommendation) {
     if (recommendation === void 0) { recommendation = "Please remove this option."; }
     warnDeprecated(name, function () {
         if (name in options) {
-            globalThis.__DEV__ !== false && globals.invariant.warn(91, callSite, name, recommendation);
+            globalThis.__DEV__ !== false && globals.invariant.warn(104, callSite, name, recommendation);
         }
     });
 }
@@ -294,6 +296,11 @@ var ObservableQuery =  (function (_super) {
     });
     ObservableQuery.prototype.result = function () {
         var _this = this;
+        if (globalThis.__DEV__ !== false) {
+            warnDeprecated("observableQuery.result", function () {
+                globalThis.__DEV__ !== false && globals.invariant.warn(23);
+            });
+        }
         return new Promise(function (resolve, reject) {
             var observer = {
                 next: function (result) {
@@ -315,8 +322,11 @@ var ObservableQuery =  (function (_super) {
         this.queryInfo.resetDiff();
     };
     ObservableQuery.prototype.getCurrentFullResult = function (saveAsLastResult) {
+        var _this = this;
         if (saveAsLastResult === void 0) { saveAsLastResult = true; }
-        var lastResult = this.getLastResult(true);
+        var lastResult = muteDeprecations("getLastResult", function () {
+            return _this.getLastResult(true);
+        });
         var networkStatus = this.queryInfo.networkStatus ||
             (lastResult && lastResult.networkStatus) ||
             exports.NetworkStatus.ready;
@@ -391,16 +401,34 @@ var ObservableQuery =  (function (_super) {
         }
     };
     ObservableQuery.prototype.getLastResult = function (variablesMustMatch) {
+        if (globalThis.__DEV__ !== false) {
+            warnDeprecated("getLastResult", function () {
+                globalThis.__DEV__ !== false && globals.invariant.warn(24);
+            });
+        }
         return this.getLast("result", variablesMustMatch);
     };
     ObservableQuery.prototype.getLastError = function (variablesMustMatch) {
+        if (globalThis.__DEV__ !== false) {
+            warnDeprecated("getLastError", function () {
+                globalThis.__DEV__ !== false && globals.invariant.warn(25);
+            });
+        }
         return this.getLast("error", variablesMustMatch);
     };
     ObservableQuery.prototype.resetLastResults = function () {
+        if (globalThis.__DEV__ !== false) {
+            warnDeprecated("resetLastResults", function () {
+                globalThis.__DEV__ !== false && globals.invariant.warn(26);
+            });
+        }
         delete this.last;
         this.isTornDown = false;
     };
     ObservableQuery.prototype.resetQueryStoreErrors = function () {
+        if (globalThis.__DEV__ !== false) {
+            globalThis.__DEV__ !== false && globals.invariant.warn(27);
+        }
         this.queryManager.resetErrors(this.queryId);
     };
     ObservableQuery.prototype.refetch = function (variables) {
@@ -420,7 +448,7 @@ var ObservableQuery =  (function (_super) {
             var vars = queryDef.variableDefinitions;
             if (!vars || !vars.some(function (v) { return v.variable.name.value === "variables"; })) {
                 globalThis.__DEV__ !== false && globals.invariant.warn(
-                    22,
+                    28,
                     variables,
                     ((_a = queryDef.name) === null || _a === void 0 ? void 0 : _a.value) || queryDef
                 );
@@ -452,7 +480,7 @@ var ObservableQuery =  (function (_super) {
         var updateQuery = fetchMoreOptions === null || fetchMoreOptions === void 0 ? void 0 : fetchMoreOptions.updateQuery;
         var isCached = this.options.fetchPolicy !== "no-cache";
         if (!isCached) {
-            globals.invariant(updateQuery, 23);
+            globals.invariant(updateQuery, 29);
         }
         return this.queryManager
             .fetchQuery(qid, combinedOptions, exports.NetworkStatus.fetchMore)
@@ -529,7 +557,7 @@ var ObservableQuery =  (function (_super) {
                     options.onError(err);
                     return;
                 }
-                globalThis.__DEV__ !== false && globals.invariant.error(24, err);
+                globalThis.__DEV__ !== false && globals.invariant.error(30, err);
             },
         });
         this.subscriptions.add(subscription);
@@ -542,6 +570,9 @@ var ObservableQuery =  (function (_super) {
     ObservableQuery.prototype.setOptions = function (newOptions) {
         if (globalThis.__DEV__ !== false) {
             warnRemovedOption(newOptions, "canonizeResults", "setOptions");
+            warnDeprecated("setOptions", function () {
+                globalThis.__DEV__ !== false && globals.invariant.warn(31);
+            });
         }
         return this.reobserve(newOptions);
     };
@@ -550,8 +581,11 @@ var ObservableQuery =  (function (_super) {
         assign(this.options, mergedOptions);
     };
     ObservableQuery.prototype.setVariables = function (variables) {
+        var _this = this;
         if (equal.equal(this.variables, variables)) {
-            return this.observers.size ? this.result() : Promise.resolve();
+            return this.observers.size ?
+                muteDeprecations("observableQuery.result", function () { return _this.result(); })
+                : Promise.resolve();
         }
         this.options.variables = variables;
         if (!this.observers.size) {
@@ -635,7 +669,7 @@ var ObservableQuery =  (function (_super) {
         if (pollingInfo && pollingInfo.interval === pollInterval) {
             return;
         }
-        globals.invariant(pollInterval, 25);
+        globals.invariant(pollInterval, 32);
         var info = pollingInfo || (this.pollingInfo = {});
         info.interval = pollInterval;
         var maybeFetch = function () {
@@ -664,8 +698,11 @@ var ObservableQuery =  (function (_super) {
         poll();
     };
     ObservableQuery.prototype.updateLastResult = function (newResult, variables) {
+        var _this = this;
         if (variables === void 0) { variables = this.variables; }
-        var error = this.getLastError();
+        var error = muteDeprecations("getLastError", function () {
+            return _this.getLastError();
+        });
         if (error && this.last && !equal.equal(variables, this.last.variables)) {
             error = void 0;
         }
@@ -741,12 +778,13 @@ var ObservableQuery =  (function (_super) {
         return utilities.preventUnhandledRejection(this.reobserveAsConcast(newOptions, newNetworkStatus).promise.then(this.maskResult));
     };
     ObservableQuery.prototype.resubscribeAfterError = function () {
+        var _this = this;
         var args = [];
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
         var last = this.last;
-        this.resetLastResults();
+        muteDeprecations("resetLastResults", function () { return _this.resetLastResults(); });
         var subscription = this.subscribe.apply(this, args);
         this.last = last;
         return subscription;
@@ -756,7 +794,10 @@ var ObservableQuery =  (function (_super) {
         this.getCurrentFullResult(false), this.variables);
     };
     ObservableQuery.prototype.reportResult = function (result, variables) {
-        var lastError = this.getLastError();
+        var _this = this;
+        var lastError = muteDeprecations("getLastError", function () {
+            return _this.getLastError();
+        });
         var isDifferent = this.isDifferentFromLastResult(result, variables);
         if (lastError || !result.partial || this.options.returnPartialData) {
             this.updateLastResult(result, variables);
@@ -766,7 +807,8 @@ var ObservableQuery =  (function (_super) {
         }
     };
     ObservableQuery.prototype.reportError = function (error, variables) {
-        var errorResult = tslib.__assign(tslib.__assign({}, this.getLastResult()), { error: error, errors: error.graphQLErrors, networkStatus: exports.NetworkStatus.error, loading: false });
+        var _this = this;
+        var errorResult = tslib.__assign(tslib.__assign({}, muteDeprecations("getLastResult", function () { return _this.getLastResult(); })), { error: error, errors: error.graphQLErrors, networkStatus: exports.NetworkStatus.error, loading: false });
         this.updateLastResult(errorResult, variables);
         utilities.iterateObserversSafely(this.observers, "error", (this.last.error = error));
     };
@@ -856,11 +898,11 @@ var ObservableQuery =  (function (_super) {
 }(utilities.Observable));
 utilities.fixObservableSubclass(ObservableQuery);
 function defaultSubscriptionObserverErrorCallback(error) {
-    globalThis.__DEV__ !== false && globals.invariant.error(26, error.message, error.stack);
+    globalThis.__DEV__ !== false && globals.invariant.error(33, error.message, error.stack);
 }
 function logMissingFieldErrors(missing) {
     if (globalThis.__DEV__ !== false && missing) {
-        globalThis.__DEV__ !== false && globals.invariant.debug(27, missing);
+        globalThis.__DEV__ !== false && globals.invariant.debug(34, missing);
     }
 }
 function skipCacheDataFor(fetchPolicy ) {
@@ -963,14 +1005,17 @@ var QueryInfo =  (function () {
         };
     };
     QueryInfo.prototype.setDiff = function (diff) {
-        var _a, _b;
+        var _this = this;
+        var _a;
         var oldDiff = this.lastDiff && this.lastDiff.diff;
-        if (diff && !diff.complete && ((_a = this.observableQuery) === null || _a === void 0 ? void 0 : _a.getLastError())) {
+        if (diff &&
+            !diff.complete &&
+            muteDeprecations("getLastError", function () { var _a; return (_a = _this.observableQuery) === null || _a === void 0 ? void 0 : _a.getLastError(); })) {
             return;
         }
         this.updateLastDiff(diff);
         if (!equal.equal(oldDiff && oldDiff.result, diff && diff.result)) {
-            (_b = this.observableQuery) === null || _b === void 0 ? void 0 : _b["scheduleNotify"]();
+            (_a = this.observableQuery) === null || _a === void 0 ? void 0 : _a["scheduleNotify"]();
         }
     };
     QueryInfo.prototype.setObservableQuery = function (oq) {
@@ -1150,7 +1195,7 @@ var QueryManager =  (function () {
         this.queries.forEach(function (_info, queryId) {
             _this.stopQueryNoBroadcast(queryId);
         });
-        this.cancelPendingFetches(globals.newInvariantError(28));
+        this.cancelPendingFetches(globals.newInvariantError(35));
     };
     QueryManager.prototype.cancelPendingFetches = function (error) {
         this.fetchCancelFns.forEach(function (cancel) { return cancel(error); });
@@ -1164,8 +1209,8 @@ var QueryManager =  (function () {
             return tslib.__generator(this, function (_j) {
                 switch (_j.label) {
                     case 0:
-                        globals.invariant(mutation, 29);
-                        globals.invariant(fetchPolicy === "network-only" || fetchPolicy === "no-cache", 30);
+                        globals.invariant(mutation, 36);
+                        globals.invariant(fetchPolicy === "network-only" || fetchPolicy === "no-cache", 37);
                         mutationId = this.generateMutationId();
                         mutation = this.cache.transformForLink(this.transform(mutation));
                         hasClientExports = this.getDocumentInfo(mutation).hasClientExports;
@@ -1495,10 +1540,10 @@ var QueryManager =  (function () {
     QueryManager.prototype.query = function (options, queryId) {
         var _this = this;
         if (queryId === void 0) { queryId = this.generateQueryId(); }
-        globals.invariant(options.query, 31);
-        globals.invariant(options.query.kind === "Document", 32);
-        globals.invariant(!options.returnPartialData, 33);
-        globals.invariant(!options.pollInterval, 34);
+        globals.invariant(options.query, 38);
+        globals.invariant(options.query.kind === "Document", 39);
+        globals.invariant(!options.returnPartialData, 40);
+        globals.invariant(!options.pollInterval, 41);
         var query = this.transform(options.query);
         return this.fetchQuery(queryId, tslib.__assign(tslib.__assign({}, options), { query: query }))
             .then(function (result) {
@@ -1533,7 +1578,7 @@ var QueryManager =  (function () {
         if (options === void 0) { options = {
             discardWatches: true,
         }; }
-        this.cancelPendingFetches(globals.newInvariantError(35));
+        this.cancelPendingFetches(globals.newInvariantError(42));
         this.queries.forEach(function (queryInfo) {
             if (queryInfo.observableQuery) {
                 queryInfo.networkStatus = exports.NetworkStatus.loading;
@@ -1615,10 +1660,10 @@ var QueryManager =  (function () {
                 if (!included) {
                     var queryName = queryNames.get(nameOrQueryString);
                     if (queryName) {
-                        globalThis.__DEV__ !== false && globals.invariant.warn(36, queryName);
+                        globalThis.__DEV__ !== false && globals.invariant.warn(43, queryName);
                     }
                     else {
-                        globalThis.__DEV__ !== false && globals.invariant.warn(37);
+                        globalThis.__DEV__ !== false && globals.invariant.warn(44);
                     }
                 }
             });
@@ -1631,7 +1676,9 @@ var QueryManager =  (function () {
         var observableQueryPromises = [];
         this.getObservableQueries(includeStandby ? "all" : "active").forEach(function (observableQuery, queryId) {
             var fetchPolicy = observableQuery.options.fetchPolicy;
-            observableQuery.resetLastResults();
+            muteDeprecations("resetLastResults", function () {
+                return observableQuery.resetLastResults();
+            });
             if (includeStandby ||
                 (fetchPolicy !== "standby" && fetchPolicy !== "cache-only")) {
                 observableQueryPromises.push(observableQuery.refetch());
@@ -1944,7 +1991,7 @@ var QueryManager =  (function () {
                 !this.noCacheWarningsByQueryId.has(operationId)) {
                 this.noCacheWarningsByQueryId.add(operationId);
                 globalThis.__DEV__ !== false && globals.invariant.warn(
-                    38,
+                    45,
                     (_c = utilities.getOperationName(document)) !== null && _c !== void 0 ? _c : "Unnamed ".concat(operationType !== null && operationType !== void 0 ? operationType : "operation")
                 );
             }
@@ -2259,7 +2306,7 @@ var LocalState =  (function () {
                         }
                         else {
                             fragment = fragmentMap[selection.name.value];
-                            globals.invariant(fragment, 20, selection.name.value);
+                            globals.invariant(fragment, 21, selection.name.value);
                         }
                         if (fragment && fragment.typeCondition) {
                             typeCondition = fragment.typeCondition.name.value;
@@ -2373,7 +2420,7 @@ var LocalState =  (function () {
                     },
                     FragmentSpread: function (spread, _, __, ___, ancestors) {
                         var fragment = fragmentMap[spread.name.value];
-                        globals.invariant(fragment, 21, spread.name.value);
+                        globals.invariant(fragment, 22, spread.name.value);
                         var fragmentSelections = collectByDefinition(fragment);
                         if (fragmentSelections.size > 0) {
                             ancestors.forEach(function (node) {
@@ -2626,6 +2673,7 @@ var ApolloClient =  (function () {
         }
         if (globalThis.__DEV__ !== false) {
             warnRemovedOption(options, "canonizeResults", "client.watchQuery");
+            warnRemovedOption(options, "partialRefetch", "client.watchQuery");
         }
         return this.queryManager.watchQuery(options);
     };
@@ -2639,6 +2687,10 @@ var ApolloClient =  (function () {
         }
         if (globalThis.__DEV__ !== false) {
             warnRemovedOption(options, "canonizeResults", "client.query");
+            warnRemovedOption(options, "notifyOnNetworkStatusChange", "client.query", "This option does not affect `client.query` and can be safely removed.");
+            if (options.fetchPolicy === "standby") {
+                globalThis.__DEV__ !== false && globals.invariant.warn(19);
+            }
         }
         return this.queryManager.query(options);
     };
@@ -2742,7 +2794,7 @@ var ApolloClient =  (function () {
         result.queries = queries;
         result.results = results;
         result.catch(function (error) {
-            globalThis.__DEV__ !== false && globals.invariant.debug(19, error);
+            globalThis.__DEV__ !== false && globals.invariant.debug(20, error);
         });
         return result;
     };

package/core/types.d.ts

@@ -1,6 +1,6 @@
 import type { DocumentNode, GraphQLFormattedError } from "graphql";
 import type { ApolloCache } from "../cache/index.js";
-import type { FetchResult } from "../link/core/index.js";
+import type { FetchResult, IncrementalPayload } from "../link/core/index.js";
 import type { ApolloError } from "../errors/index.js";
 import type { NetworkStatus } from "./networkStatus.js";
 import type { Resolver } from "./LocalState.js";
@@ -27,7 +27,7 @@ export interface RefetchQueriesOptions<TCache extends ApolloCache<any>, 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> = IsStrictlyAny<TResult> extends true ? any[] : TResult extends boolean ? InteropApolloQueryResult<any>[] : TResult extends PromiseLike<infer U> ? U[] : TResult[];
 export interface RefetchQueriesResult<TResult> extends Promise<RefetchQueriesPromiseResults<TResult>> {
     queries: ObservableQuery<any>[];
     results: InternalRefetchQueriesResult<TResult>[];
@@ -36,11 +36,20 @@ export interface InternalRefetchQueriesOptions<TCache extends ApolloCache<any>,
     include?: InternalRefetchQueriesInclude;
     removeOptimistic?: string;
 }
-export type InternalRefetchQueriesResult<TResult> = TResult extends boolean ? Promise<ApolloQueryResult<any>> : TResult;
+export type InternalRefetchQueriesResult<TResult> = TResult extends boolean ? Promise<InteropApolloQueryResult<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> {
+    /**
+     * 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: T;
     /**
      * A list of any errors that occurred during server-side execution of a GraphQL operation.
@@ -57,6 +66,171 @@ export interface ApolloQueryResult<T> {
     networkStatus: NetworkStatus;
     partial?: boolean;
 }
+/**
+ * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a
+ * bridge between versions for deprecations.
+ */
+export interface InteropApolloQueryResult<T> {
+    /**
+     * 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: T;
+    /**
+     * @deprecated `errors` will no longer available on the result in Apollo Client 4.0.
+     * This value is safe to use in Apollo Client 3.x.
+     *
+     * **Recommended now**
+     *
+     * No action needed
+     *
+     * **When upgrading**
+     *
+     * `errors` has been consolidated to the `error` property. You will need to
+     * read any errors on the `error` property on the resolved value instead.
+     */
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    /**
+     * 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.
+     * See https://www.apollographql.com/docs/react/data/error-handling/ for more information.
+     */
+    error?: ApolloError;
+    /**
+     * @deprecated `loading` will no longer available on the result in Apollo Client 4.0.
+     * This value is always true when the resolved and can safely ignored.
+     */
+    loading: boolean;
+    /**
+     * @deprecated `loading` will no longer available on the result in Apollo Client 4.0.
+     * This value is always `NetworkStatus.ready` or `NetworkStatus.error`. To
+     * determine if the result contains an error, read from the `error` or `errors`
+     * property instead.
+     */
+    networkStatus: NetworkStatus;
+    /**
+     * @deprecated `partial` will no longer available on the result in Apollo Client 4.0.
+     * This value is always `false` if there is a data value since the result
+     * never contains partial cache data.
+     */
+    partial?: boolean;
+}
+/**
+ * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a
+ * bridge between versions for deprecations.
+ */
+interface InteropSingleExecutionResult<TData = Record<string, any>, TContext = DefaultContext, TExtensions = Record<string, any>> {
+    data?: TData | null;
+    /**
+     * @deprecated `context` will no longer available on the result in Apollo Client 4.0.
+     */
+    context?: TContext;
+    /**
+     * @deprecated `errors` is no longer available on the result in Apollo Client 4.0.
+     * This value is safe to use in Apollo Client 3.x.
+     *
+     * **Recommended now**
+     *
+     * No action needed
+     *
+     * **When upgrading**
+     *
+     * `errors` has been consolidated to the `error` property. You will need to
+     * read any errors on the `error` property on the resolved value instead.
+     */
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    extensions?: TExtensions;
+}
+/**
+ * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a
+ * bridge between versions for deprecations.
+ */
+export interface InteropMutationExecutionPatchInitialResult<TData = Record<string, any>, TExtensions = Record<string, any>> {
+    /**
+     * @deprecated `hasNext` will no longer available on the result in Apollo Client 4.0.
+     */
+    hasNext?: boolean;
+    data: TData | null | undefined;
+    /**
+     * @deprecated `incremental` will no longer available on the result in Apollo Client 4.0.
+     */
+    incremental?: never;
+    /**
+     * @deprecated `errors` is no longer available on the result in Apollo Client 4.0.
+     * This value is safe to use in Apollo Client 3.x.
+     *
+     * **Recommended now**
+     *
+     * No action needed
+     *
+     * **When upgrading**
+     *
+     * `errors` has been consolidated to the `error` property. You will need to
+     * read any errors on the `error` property on the resolved value instead.
+     */
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    extensions?: TExtensions;
+}
+/**
+ * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a
+ * bridge between versions for deprecations.
+ */
+export interface InteropMutationExecutionPatchIncrementalResult<TData = Record<string, any>, TExtensions = Record<string, any>> {
+    /**
+     * @deprecated `hasNext` will no longer available on the result in Apollo Client 4.0.
+     * This value is safe to use in Apollo Client 3.x.
+     *
+     * **Recommended now**
+     *
+     * No action needed
+     *
+     * **When upgrading**
+     *
+     * `errors` has been consolidated to the `error` property. You will need to
+     * read any errors on the `error` property on the resolved value instead.
+     */
+    hasNext?: boolean;
+    /**
+     * @deprecated `incremental` will no longer available on the result in Apollo Client 4.0.
+     */
+    incremental?: IncrementalPayload<TData, TExtensions>[];
+    data?: never;
+    /**
+     * @deprecated `errors` is no longer available on the result in Apollo Client 4.0.
+     * This value is safe to use in Apollo Client 3.x.
+     *
+     * **Recommended now**
+     *
+     * No action needed
+     *
+     * **When upgrading**
+     *
+     * `errors` has been consolidated to the `error` property. You will need to
+     * read any errors on the `error` property on the resolved value instead.
+     */
+    errors?: never;
+    extensions?: never;
+}
+/**
+ * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a
+ * bridge between versions for deprecations.
+ */
+export type InteropExecutionPatchResult<TData = Record<string, any>, TExtensions = Record<string, any>> = InteropMutationExecutionPatchInitialResult<TData, TExtensions> | InteropMutationExecutionPatchIncrementalResult<TData, TExtensions>;
+/**
+ * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a
+ * bridge between versions for deprecations.
+ */
+export type InteropMutateResult<TData = Record<string, any>, TContext = DefaultContext, TExtensions = Record<string, any>> = InteropSingleExecutionResult<TData, TContext, TExtensions> | InteropExecutionPatchResult<TData, TExtensions>;
+/**
+ * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a
+ * bridge between versions for deprecations.
+ */
+export type InteropSubscribeResult<TData = Record<string, any>, TContext = DefaultContext, TExtensions = Record<string, any>> = InteropSingleExecutionResult<TData, TContext, TExtensions> | InteropExecutionPatchResult<TData, TExtensions>;
 export type MutationQueryReducer<T> = (previousResult: Record<string, any>, options: {
     mutationResult: FetchResult<Unmasked<T>>;
     queryName: string | undefined;

package/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { DocumentNode, GraphQLFormattedError } from \"graphql\";\n\nimport type { ApolloCache } from \"../cache/index.js\";\nimport type { FetchResult } from \"../link/core/index.js\";\nimport type { ApolloError } from \"../errors/index.js\";\nimport type { NetworkStatus } from \"./networkStatus.js\";\nimport type { Resolver } from \"./LocalState.js\";\nimport type { ObservableQuery } from \"./ObservableQuery.js\";\nimport type { QueryOptions } from \"./watchQueryOptions.js\";\nimport type { Cache } from \"../cache/index.js\";\nimport type { IsStrictlyAny } from \"../utilities/index.js\";\nimport type { Unmasked } from \"../masking/index.js\";\n\nexport type { TypedDocumentNode } from \"@graphql-typed-document-node/core\";\n\nexport type MethodKeys<T> = {\n  [P in keyof T]: T[P] extends Function ? P : never;\n}[keyof T];\n\nexport interface DefaultContext extends Record<string, any> {}\n\nexport type OnQueryUpdated<TResult> = (\n  observableQuery: ObservableQuery<any>,\n  diff: Cache.DiffResult<any>,\n  lastDiff: Cache.DiffResult<any> | undefined\n) => boolean | TResult;\n\nexport type RefetchQueryDescriptor = string | DocumentNode;\nexport type InternalRefetchQueryDescriptor =\n  | RefetchQueryDescriptor\n  | QueryOptions;\n\ntype RefetchQueriesIncludeShorthand = \"all\" | \"active\";\n\nexport type RefetchQueriesInclude =\n  | RefetchQueryDescriptor[]\n  | RefetchQueriesIncludeShorthand;\n\nexport type InternalRefetchQueriesInclude =\n  | InternalRefetchQueryDescriptor[]\n  | RefetchQueriesIncludeShorthand;\n\n// Used by ApolloClient[\"refetchQueries\"]\n// TODO Improve documentation comments for this public type.\nexport interface RefetchQueriesOptions<\n  TCache extends ApolloCache<any>,\n  TResult,\n> {\n  updateCache?: (cache: TCache) => void;\n  // The client.refetchQueries method discourages passing QueryOptions, by\n  // restricting the public type of options.include to exclude QueryOptions as\n  // an available array element type (see InternalRefetchQueriesInclude for a\n  // version of RefetchQueriesInclude that allows legacy QueryOptions objects).\n  include?: RefetchQueriesInclude;\n  optimistic?: boolean;\n  // If no onQueryUpdated function is provided, any queries affected by the\n  // updateCache function or included in the options.include array will be\n  // refetched by default. Passing null instead of undefined disables this\n  // default refetching behavior for affected queries, though included queries\n  // will still be refetched.\n  onQueryUpdated?: OnQueryUpdated<TResult> | null;\n}\n\n// The client.refetchQueries method returns a thenable (PromiseLike) object\n// whose result is an array of Promise.resolve'd TResult values, where TResult\n// is whatever type the (optional) onQueryUpdated function returns. When no\n// onQueryUpdated function is given, TResult defaults to ApolloQueryResult<any>\n// (thanks to default type parameters for client.refetchQueries).\nexport type RefetchQueriesPromiseResults<TResult> =\n  // If onQueryUpdated returns any, all bets are off, so the results array must\n  // be a generic any[] array, which is much less confusing than the union type\n  // we get if we don't check for any. I hoped `any extends TResult` would do\n  // the trick here, instead of IsStrictlyAny, but you can see for yourself what\n  // fails in the refetchQueries tests if you try making that simplification.\n  IsStrictlyAny<TResult> extends true ? any[]\n  : // If the onQueryUpdated function passed to client.refetchQueries returns true\n  // or false, that means either to refetch the query (true) or to skip the\n  // query (false). Since refetching produces an ApolloQueryResult<any>, and\n  // skipping produces nothing, the fully-resolved array of all results produced\n  // will be an ApolloQueryResult<any>[], when TResult extends boolean.\n  TResult extends boolean ? ApolloQueryResult<any>[]\n  : // If onQueryUpdated returns a PromiseLike<U>, that thenable will be passed as\n  // an array element to Promise.all, so we infer/unwrap the array type U here.\n  TResult extends PromiseLike<infer U> ? U[]\n  : // All other onQueryUpdated results end up in the final Promise.all array as\n    // themselves, with their original TResult type. Note that TResult will\n    // default to ApolloQueryResult<any> if no onQueryUpdated function is passed\n    // to client.refetchQueries.\n    TResult[];\n\n// The result of client.refetchQueries is thenable/awaitable, if you just want\n// an array of fully resolved results, but you can also access the raw results\n// immediately by examining the additional { queries, results } properties of\n// the RefetchQueriesResult<TResult> object.\nexport interface RefetchQueriesResult<TResult>\n  extends Promise<RefetchQueriesPromiseResults<TResult>> {\n  // An array of ObservableQuery objects corresponding 1:1 to TResult values\n  // in the results arrays (both the TResult[] array below, and the results\n  // array resolved by the Promise above).\n  queries: ObservableQuery<any>[];\n  // These are the raw TResult values returned by any onQueryUpdated functions\n  // that were invoked by client.refetchQueries.\n  results: InternalRefetchQueriesResult<TResult>[];\n}\n\n// Used by QueryManager[\"refetchQueries\"]\nexport interface InternalRefetchQueriesOptions<\n  TCache extends ApolloCache<any>,\n  TResult,\n> extends Omit<RefetchQueriesOptions<TCache, TResult>, \"include\"> {\n  // Just like the refetchQueries option for a mutation, an array of strings,\n  // DocumentNode objects, and/or QueryOptions objects, or one of the shorthand\n  // strings \"all\" or \"active\", to select every (active) query.\n  include?: InternalRefetchQueriesInclude;\n  // This part of the API is a (useful) implementation detail, but need not be\n  // exposed in the public client.refetchQueries API (above).\n  removeOptimistic?: string;\n}\n\nexport type InternalRefetchQueriesResult<TResult> =\n  // If onQueryUpdated returns a boolean, that's equivalent to refetching the\n  // query when the boolean is true and skipping the query when false, so the\n  // internal type of refetched results is Promise<ApolloQueryResult<any>>.\n  TResult extends boolean ? Promise<ApolloQueryResult<any>>\n  : // Otherwise, onQueryUpdated returns whatever it returns. If onQueryUpdated is\n    // not provided, TResult defaults to Promise<ApolloQueryResult<any>> (see the\n    // generic type parameters of client.refetchQueries).\n    TResult;\n\nexport type InternalRefetchQueriesMap<TResult> = Map<\n  ObservableQuery<any>,\n  InternalRefetchQueriesResult<TResult>\n>;\n\n// TODO Remove this unnecessary type in Apollo Client 4.\nexport type { QueryOptions as PureQueryOptions };\n\nexport type OperationVariables = Record<string, any>;\n\nexport interface ApolloQueryResult<T> {\n  data: T;\n  /**\n   * A list of any errors that occurred during server-side execution of a GraphQL operation.\n   * See https://www.apollographql.com/docs/react/data/error-handling/ for more information.\n   */\n  errors?: ReadonlyArray<GraphQLFormattedError>;\n  /**\n   * The single Error object that is passed to onError and useQuery hooks, and is often thrown during manual `client.query` calls.\n   * This will contain both a NetworkError field and any GraphQLErrors.\n   * See https://www.apollographql.com/docs/react/data/error-handling/ for more information.\n   */\n  error?: ApolloError;\n  loading: boolean;\n  networkStatus: NetworkStatus;\n  // If result.data was read from the cache with missing fields,\n  // result.partial will be true. Otherwise, result.partial will be falsy\n  // (usually because the property is absent from the result object).\n  partial?: boolean;\n}\n\n// This is part of the public API, people write these functions in `updateQueries`.\nexport type MutationQueryReducer<T> = (\n  previousResult: Record<string, any>,\n  options: {\n    mutationResult: FetchResult<Unmasked<T>>;\n    queryName: string | undefined;\n    queryVariables: Record<string, any>;\n  }\n) => Record<string, any>;\n\nexport type MutationQueryReducersMap<T = { [key: string]: any }> = {\n  [queryName: string]: MutationQueryReducer<T>;\n};\n\n/**\n * @deprecated Use `MutationUpdaterFunction` instead.\n */\nexport type MutationUpdaterFn<T = { [key: string]: any }> = (\n  // The MutationUpdaterFn type is broken because it mistakenly uses the same\n  // type parameter T for both the cache and the mutationResult. Do not use this\n  // type unless you absolutely need it for backwards compatibility.\n  cache: ApolloCache<T>,\n  mutationResult: FetchResult<T>\n) => void;\n\nexport type MutationUpdaterFunction<\n  TData,\n  TVariables,\n  TContext,\n  TCache extends ApolloCache<any>,\n> = (\n  cache: TCache,\n  result: Omit<FetchResult<Unmasked<TData>>, \"context\">,\n  options: {\n    context?: TContext;\n    variables?: TVariables;\n  }\n) => void;\nexport interface Resolvers {\n  [key: string]: {\n    [field: string]: Resolver;\n  };\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { DocumentNode, GraphQLFormattedError } from \"graphql\";\n\nimport type { ApolloCache } from \"../cache/index.js\";\nimport type { FetchResult, IncrementalPayload } from \"../link/core/index.js\";\nimport type { ApolloError } from \"../errors/index.js\";\nimport type { NetworkStatus } from \"./networkStatus.js\";\nimport type { Resolver } from \"./LocalState.js\";\nimport type { ObservableQuery } from \"./ObservableQuery.js\";\nimport type { QueryOptions } from \"./watchQueryOptions.js\";\nimport type { Cache } from \"../cache/index.js\";\nimport type { IsStrictlyAny } from \"../utilities/index.js\";\nimport type { Unmasked } from \"../masking/index.js\";\n\nexport type { TypedDocumentNode } from \"@graphql-typed-document-node/core\";\n\nexport type MethodKeys<T> = {\n  [P in keyof T]: T[P] extends Function ? P : never;\n}[keyof T];\n\nexport interface DefaultContext extends Record<string, any> {}\n\nexport type OnQueryUpdated<TResult> = (\n  observableQuery: ObservableQuery<any>,\n  diff: Cache.DiffResult<any>,\n  lastDiff: Cache.DiffResult<any> | undefined\n) => boolean | TResult;\n\nexport type RefetchQueryDescriptor = string | DocumentNode;\nexport type InternalRefetchQueryDescriptor =\n  | RefetchQueryDescriptor\n  | QueryOptions;\n\ntype RefetchQueriesIncludeShorthand = \"all\" | \"active\";\n\nexport type RefetchQueriesInclude =\n  | RefetchQueryDescriptor[]\n  | RefetchQueriesIncludeShorthand;\n\nexport type InternalRefetchQueriesInclude =\n  | InternalRefetchQueryDescriptor[]\n  | RefetchQueriesIncludeShorthand;\n\n// Used by ApolloClient[\"refetchQueries\"]\n// TODO Improve documentation comments for this public type.\nexport interface RefetchQueriesOptions<\n  TCache extends ApolloCache<any>,\n  TResult,\n> {\n  updateCache?: (cache: TCache) => void;\n  // The client.refetchQueries method discourages passing QueryOptions, by\n  // restricting the public type of options.include to exclude QueryOptions as\n  // an available array element type (see InternalRefetchQueriesInclude for a\n  // version of RefetchQueriesInclude that allows legacy QueryOptions objects).\n  include?: RefetchQueriesInclude;\n  optimistic?: boolean;\n  // If no onQueryUpdated function is provided, any queries affected by the\n  // updateCache function or included in the options.include array will be\n  // refetched by default. Passing null instead of undefined disables this\n  // default refetching behavior for affected queries, though included queries\n  // will still be refetched.\n  onQueryUpdated?: OnQueryUpdated<TResult> | null;\n}\n\n// The client.refetchQueries method returns a thenable (PromiseLike) object\n// whose result is an array of Promise.resolve'd TResult values, where TResult\n// is whatever type the (optional) onQueryUpdated function returns. When no\n// onQueryUpdated function is given, TResult defaults to ApolloQueryResult<any>\n// (thanks to default type parameters for client.refetchQueries).\nexport type RefetchQueriesPromiseResults<TResult> =\n  // If onQueryUpdated returns any, all bets are off, so the results array must\n  // be a generic any[] array, which is much less confusing than the union type\n  // we get if we don't check for any. I hoped `any extends TResult` would do\n  // the trick here, instead of IsStrictlyAny, but you can see for yourself what\n  // fails in the refetchQueries tests if you try making that simplification.\n  IsStrictlyAny<TResult> extends true ? any[]\n  : // If the onQueryUpdated function passed to client.refetchQueries returns true\n  // or false, that means either to refetch the query (true) or to skip the\n  // query (false). Since refetching produces an ApolloQueryResult<any>, and\n  // skipping produces nothing, the fully-resolved array of all results produced\n  // will be an ApolloQueryResult<any>[], when TResult extends boolean.\n  TResult extends boolean ? InteropApolloQueryResult<any>[]\n  : // If onQueryUpdated returns a PromiseLike<U>, that thenable will be passed as\n  // an array element to Promise.all, so we infer/unwrap the array type U here.\n  TResult extends PromiseLike<infer U> ? U[]\n  : // All other onQueryUpdated results end up in the final Promise.all array as\n    // themselves, with their original TResult type. Note that TResult will\n    // default to ApolloQueryResult<any> if no onQueryUpdated function is passed\n    // to client.refetchQueries.\n    TResult[];\n\n// The result of client.refetchQueries is thenable/awaitable, if you just want\n// an array of fully resolved results, but you can also access the raw results\n// immediately by examining the additional { queries, results } properties of\n// the RefetchQueriesResult<TResult> object.\nexport interface RefetchQueriesResult<TResult>\n  extends Promise<RefetchQueriesPromiseResults<TResult>> {\n  // An array of ObservableQuery objects corresponding 1:1 to TResult values\n  // in the results arrays (both the TResult[] array below, and the results\n  // array resolved by the Promise above).\n  queries: ObservableQuery<any>[];\n  // These are the raw TResult values returned by any onQueryUpdated functions\n  // that were invoked by client.refetchQueries.\n  results: InternalRefetchQueriesResult<TResult>[];\n}\n\n// Used by QueryManager[\"refetchQueries\"]\nexport interface InternalRefetchQueriesOptions<\n  TCache extends ApolloCache<any>,\n  TResult,\n> extends Omit<RefetchQueriesOptions<TCache, TResult>, \"include\"> {\n  // Just like the refetchQueries option for a mutation, an array of strings,\n  // DocumentNode objects, and/or QueryOptions objects, or one of the shorthand\n  // strings \"all\" or \"active\", to select every (active) query.\n  include?: InternalRefetchQueriesInclude;\n  // This part of the API is a (useful) implementation detail, but need not be\n  // exposed in the public client.refetchQueries API (above).\n  removeOptimistic?: string;\n}\n\nexport type InternalRefetchQueriesResult<TResult> =\n  // If onQueryUpdated returns a boolean, that's equivalent to refetching the\n  // query when the boolean is true and skipping the query when false, so the\n  // internal type of refetched results is Promise<ApolloQueryResult<any>>.\n  TResult extends boolean ? Promise<InteropApolloQueryResult<any>>\n  : // Otherwise, onQueryUpdated returns whatever it returns. If onQueryUpdated is\n    // not provided, TResult defaults to Promise<ApolloQueryResult<any>> (see the\n    // generic type parameters of client.refetchQueries).\n    TResult;\n\nexport type InternalRefetchQueriesMap<TResult> = Map<\n  ObservableQuery<any>,\n  InternalRefetchQueriesResult<TResult>\n>;\n\n// TODO Remove this unnecessary type in Apollo Client 4.\nexport type { QueryOptions as PureQueryOptions };\n\nexport type OperationVariables = Record<string, any>;\n\nexport interface ApolloQueryResult<T> {\n  /** {@inheritDoc @apollo/client!QueryResultDocumentation#data:member} */\n  data: T;\n  /**\n   * A list of any errors that occurred during server-side execution of a GraphQL operation.\n   * See https://www.apollographql.com/docs/react/data/error-handling/ for more information.\n   */\n  errors?: ReadonlyArray<GraphQLFormattedError>;\n  /**\n   * The single Error object that is passed to onError and useQuery hooks, and is often thrown during manual `client.query` calls.\n   * This will contain both a NetworkError field and any GraphQLErrors.\n   * See https://www.apollographql.com/docs/react/data/error-handling/ for more information.\n   */\n  error?: ApolloError;\n  loading: boolean;\n  networkStatus: NetworkStatus;\n  // If result.data was read from the cache with missing fields,\n  // result.partial will be true. Otherwise, result.partial will be falsy\n  // (usually because the property is absent from the result object).\n  partial?: boolean;\n}\n\n/**\n * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a\n * bridge between versions for deprecations.\n */\nexport interface InteropApolloQueryResult<T> {\n  /** {@inheritDoc @apollo/client!QueryResultDocumentation#data:member} */\n  data: T;\n  /**\n   * @deprecated `errors` will no longer available on the result in Apollo Client 4.0.\n   * This value is safe to use in Apollo Client 3.x.\n   *\n   * **Recommended now**\n   *\n   * No action needed\n   *\n   * **When upgrading**\n   *\n   * `errors` has been consolidated to the `error` property. You will need to\n   * read any errors on the `error` property on the resolved value instead.\n   */\n  errors?: ReadonlyArray<GraphQLFormattedError>;\n  /**\n   * The single Error object that is passed to onError and useQuery hooks, and is often thrown during manual `client.query` calls.\n   * This will contain both a NetworkError field and any GraphQLErrors.\n   * See https://www.apollographql.com/docs/react/data/error-handling/ for more information.\n   */\n  error?: ApolloError;\n  /**\n   * @deprecated `loading` will no longer available on the result in Apollo Client 4.0.\n   * This value is always true when the resolved and can safely ignored.\n   */\n  loading: boolean;\n  /**\n   * @deprecated `loading` will no longer available on the result in Apollo Client 4.0.\n   * This value is always `NetworkStatus.ready` or `NetworkStatus.error`. To\n   * determine if the result contains an error, read from the `error` or `errors`\n   * property instead.\n   */\n  networkStatus: NetworkStatus;\n  /**\n   * @deprecated `partial` will no longer available on the result in Apollo Client 4.0.\n   * This value is always `false` if there is a data value since the result\n   * never contains partial cache data.\n   */\n  partial?: boolean;\n}\n\n/**\n * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a\n * bridge between versions for deprecations.\n */\ninterface InteropSingleExecutionResult<\n  TData = Record<string, any>,\n  TContext = DefaultContext,\n  TExtensions = Record<string, any>,\n> {\n  data?: TData | null;\n  /**\n   * @deprecated `context` will no longer available on the result in Apollo Client 4.0.\n   */\n  context?: TContext;\n  /**\n   * @deprecated `errors` is no longer available on the result in Apollo Client 4.0.\n   * This value is safe to use in Apollo Client 3.x.\n   *\n   * **Recommended now**\n   *\n   * No action needed\n   *\n   * **When upgrading**\n   *\n   * `errors` has been consolidated to the `error` property. You will need to\n   * read any errors on the `error` property on the resolved value instead.\n   */\n  errors?: ReadonlyArray<GraphQLFormattedError>;\n  extensions?: TExtensions;\n}\n\n/**\n * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a\n * bridge between versions for deprecations.\n */\nexport interface InteropMutationExecutionPatchInitialResult<\n  TData = Record<string, any>,\n  TExtensions = Record<string, any>,\n> {\n  /**\n   * @deprecated `hasNext` will no longer available on the result in Apollo Client 4.0.\n   */\n  hasNext?: boolean;\n  // if data is present, incremental is not\n  data: TData | null | undefined;\n  /**\n   * @deprecated `incremental` will no longer available on the result in Apollo Client 4.0.\n   */\n  incremental?: never;\n  /**\n   * @deprecated `errors` is no longer available on the result in Apollo Client 4.0.\n   * This value is safe to use in Apollo Client 3.x.\n   *\n   * **Recommended now**\n   *\n   * No action needed\n   *\n   * **When upgrading**\n   *\n   * `errors` has been consolidated to the `error` property. You will need to\n   * read any errors on the `error` property on the resolved value instead.\n   */\n  errors?: ReadonlyArray<GraphQLFormattedError>;\n  extensions?: TExtensions;\n}\n\n/**\n * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a\n * bridge between versions for deprecations.\n */\nexport interface InteropMutationExecutionPatchIncrementalResult<\n  TData = Record<string, any>,\n  TExtensions = Record<string, any>,\n> {\n  /**\n   * @deprecated `hasNext` will no longer available on the result in Apollo Client 4.0.\n   * This value is safe to use in Apollo Client 3.x.\n   *\n   * **Recommended now**\n   *\n   * No action needed\n   *\n   * **When upgrading**\n   *\n   * `errors` has been consolidated to the `error` property. You will need to\n   * read any errors on the `error` property on the resolved value instead.\n   */\n  hasNext?: boolean;\n  /**\n   * @deprecated `incremental` will no longer available on the result in Apollo Client 4.0.\n   */\n  incremental?: IncrementalPayload<TData, TExtensions>[];\n  data?: never;\n  /**\n   * @deprecated `errors` is no longer available on the result in Apollo Client 4.0.\n   * This value is safe to use in Apollo Client 3.x.\n   *\n   * **Recommended now**\n   *\n   * No action needed\n   *\n   * **When upgrading**\n   *\n   * `errors` has been consolidated to the `error` property. You will need to\n   * read any errors on the `error` property on the resolved value instead.\n   */\n  errors?: never;\n  extensions?: never;\n}\n\n/**\n * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a\n * bridge between versions for deprecations.\n */\nexport type InteropExecutionPatchResult<\n  TData = Record<string, any>,\n  TExtensions = Record<string, any>,\n> =\n  | InteropMutationExecutionPatchInitialResult<TData, TExtensions>\n  | InteropMutationExecutionPatchIncrementalResult<TData, TExtensions>;\n\n/**\n * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a\n * bridge between versions for deprecations.\n */\nexport type InteropMutateResult<\n  TData = Record<string, any>,\n  TContext = DefaultContext,\n  TExtensions = Record<string, any>,\n> =\n  | InteropSingleExecutionResult<TData, TContext, TExtensions>\n  | InteropExecutionPatchResult<TData, TExtensions>;\n\n/**\n * @deprecated This type does not exist in Apollo Client 4.0 and is meant as a\n * bridge between versions for deprecations.\n */\nexport type InteropSubscribeResult<\n  TData = Record<string, any>,\n  TContext = DefaultContext,\n  TExtensions = Record<string, any>,\n> =\n  | InteropSingleExecutionResult<TData, TContext, TExtensions>\n  | InteropExecutionPatchResult<TData, TExtensions>;\n\n// This is part of the public API, people write these functions in `updateQueries`.\nexport type MutationQueryReducer<T> = (\n  previousResult: Record<string, any>,\n  options: {\n    mutationResult: FetchResult<Unmasked<T>>;\n    queryName: string | undefined;\n    queryVariables: Record<string, any>;\n  }\n) => Record<string, any>;\n\nexport type MutationQueryReducersMap<T = { [key: string]: any }> = {\n  [queryName: string]: MutationQueryReducer<T>;\n};\n\n/**\n * @deprecated Use `MutationUpdaterFunction` instead.\n */\nexport type MutationUpdaterFn<T = { [key: string]: any }> = (\n  // The MutationUpdaterFn type is broken because it mistakenly uses the same\n  // type parameter T for both the cache and the mutationResult. Do not use this\n  // type unless you absolutely need it for backwards compatibility.\n  cache: ApolloCache<T>,\n  mutationResult: FetchResult<T>\n) => void;\n\nexport type MutationUpdaterFunction<\n  TData,\n  TVariables,\n  TContext,\n  TCache extends ApolloCache<any>,\n> = (\n  cache: TCache,\n  result: Omit<FetchResult<Unmasked<TData>>, \"context\">,\n  options: {\n    context?: TContext;\n    variables?: TVariables;\n  }\n) => void;\nexport interface Resolvers {\n  [key: string]: {\n    [field: string]: Resolver;\n  };\n}\n"]}

package/core/watchQueryOptions.d.ts

@@ -118,7 +118,7 @@ export interface QueryOptions<TVariables = OperationVariables, TData = any> {
      * 
      * @deprecated
      * 
-     * Setting this option is unnecessary in Apollo Client 3, thanks to a more consistent application of fetch policies. It might be removed in a future release.
+     * Setting this option is unnecessary in Apollo Client 3, thanks to a more consistent application of fetch policies. It will be removed in Apollo Client 4.0.
      */
     partialRefetch?: boolean;
     /**
@@ -247,7 +247,7 @@ export interface SharedWatchQueryOptions<TVariables extends OperationVariables,
      * 
      * @deprecated
      * 
-     * Setting this option is unnecessary in Apollo Client 3, thanks to a more consistent application of fetch policies. It might be removed in a future release.
+     * Setting this option is unnecessary in Apollo Client 3, thanks to a more consistent application of fetch policies. It will be removed in Apollo Client 4.0.
      */
     partialRefetch?: boolean;
     /**
@@ -481,6 +481,14 @@ export interface MutationOptions<TData = any, TVariables = OperationVariables, T
      */
     mutation: DocumentNode | TypedDocumentNode<TData, TVariables>;
 }
+/**
+ * @deprecated `MutationSharedOptions` will be removed in Apollo Client 4.0. Types
+ * have been flattened in 4.0 and no longer extend this base type.
+ *
+ * **Recommended now**
+ *
+ * Copy all properties from this type into your type.
+ */
 export interface MutationSharedOptions<TData = any, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> extends MutationBaseOptions<TData, TVariables, TContext, TCache> {
     /**
      * Provide `no-cache` if the mutation's result should _not_ be written to the Apollo Client cache.