@apollo/client 3.13.8 → 3.14.0-alpha.0

package/apollo-client.cjs

@@ -31,7 +31,7 @@ function _interopNamespace(e) {
 var equal__default = /*#__PURE__*/_interopDefaultLegacy(equal);
 var React__namespace = /*#__PURE__*/_interopNamespace(React);
 
-var version = "3.13.8";
+var version = "3.14.0-alpha.0";
 
 function maybe(thunk) {
     try {
@@ -145,7 +145,7 @@ function shouldInclude(_a, variables) {
         if (ifArgument.value.kind === "Variable") {
             evaledValue =
                 variables && variables[ifArgument.value.name.value];
-            invariant(evaledValue !== void 0, 78, directive.name.value);
+            invariant(evaledValue !== void 0, 93, directive.name.value);
         }
         else {
             evaledValue = ifArgument.value.value;
@@ -180,12 +180,12 @@ function getInclusionDirectives(directives) {
                 return;
             var directiveArguments = directive.arguments;
             var directiveName = directive.name.value;
-            invariant(directiveArguments && directiveArguments.length === 1, 79, directiveName);
+            invariant(directiveArguments && directiveArguments.length === 1, 94, directiveName);
             var ifArgument = directiveArguments[0];
-            invariant(ifArgument.name && ifArgument.name.value === "if", 80, directiveName);
+            invariant(ifArgument.name && ifArgument.name.value === "if", 95, directiveName);
             var ifValue = ifArgument.value;
             invariant(ifValue &&
-                (ifValue.kind === "Variable" || ifValue.kind === "BooleanValue"), 81, directiveName);
+                (ifValue.kind === "Variable" || ifValue.kind === "BooleanValue"), 96, directiveName);
             result.push({ directive: directive, ifArgument: ifArgument });
         });
     }
@@ -207,13 +207,13 @@ function getFragmentMaskMode(fragment) {
     if (globalThis.__DEV__ !== false) {
         if (modeArg) {
             if (modeArg.value.kind === graphql.Kind.VARIABLE) {
-                globalThis.__DEV__ !== false && invariant.warn(82);
+                globalThis.__DEV__ !== false && invariant.warn(97);
             }
             else if (modeArg.value.kind !== graphql.Kind.STRING) {
-                globalThis.__DEV__ !== false && invariant.warn(83);
+                globalThis.__DEV__ !== false && invariant.warn(98);
             }
             else if (modeArg.value.value !== "migrate") {
-                globalThis.__DEV__ !== false && invariant.warn(84, modeArg.value.value);
+                globalThis.__DEV__ !== false && invariant.warn(99, modeArg.value.value);
             }
         }
     }
@@ -246,7 +246,7 @@ function getFragmentQueryDocument(document, fragmentName) {
     document.definitions.forEach(function (definition) {
         if (definition.kind === "OperationDefinition") {
             throw newInvariantError(
-                85,
+                100,
                 definition.operation,
                 definition.name ? " named '".concat(definition.name.value, "'") : ""
             );
@@ -256,7 +256,7 @@ function getFragmentQueryDocument(document, fragmentName) {
         }
     });
     if (typeof actualFragmentName === "undefined") {
-        invariant(fragments.length === 1, 86, fragments.length);
+        invariant(fragments.length === 1, 101, fragments.length);
         actualFragmentName = fragments[0].name.value;
     }
     var query = tslib.__assign(tslib.__assign({}, document), { definitions: tslib.__spreadArray([
@@ -297,7 +297,7 @@ function getFragmentFromSelection(selection, fragmentMap) {
                 return fragmentMap(fragmentName);
             }
             var fragment = fragmentMap && fragmentMap[fragmentName];
-            invariant(fragment, 87, fragmentName);
+            invariant(fragment, 102, fragmentName);
             return fragment || null;
         }
         default:
@@ -562,7 +562,7 @@ function valueToObjectRepresentation(argObj, name, value, variables) {
         argObj[name.value] = null;
     }
     else {
-        throw newInvariantError(96, name.value, value.kind);
+        throw newInvariantError(111, name.value, value.kind);
     }
 }
 function storeKeyNameFromField(field, variables) {
@@ -696,16 +696,16 @@ function isInlineFragment(selection) {
 }
 
 function checkDocument(doc) {
-    invariant(doc && doc.kind === "Document", 88);
+    invariant(doc && doc.kind === "Document", 103);
     var operations = doc.definitions
         .filter(function (d) { return d.kind !== "FragmentDefinition"; })
         .map(function (definition) {
         if (definition.kind !== "OperationDefinition") {
-            throw newInvariantError(89, definition.kind);
+            throw newInvariantError(104, definition.kind);
         }
         return definition;
     });
-    invariant(operations.length <= 1, 90, operations.length);
+    invariant(operations.length <= 1, 105, operations.length);
     return doc;
 }
 function getOperationDefinition(doc) {
@@ -728,14 +728,14 @@ function getFragmentDefinitions(doc) {
 }
 function getQueryDefinition(doc) {
     var queryDef = getOperationDefinition(doc);
-    invariant(queryDef && queryDef.operation === "query", 91);
+    invariant(queryDef && queryDef.operation === "query", 106);
     return queryDef;
 }
 function getFragmentDefinition(doc) {
-    invariant(doc.kind === "Document", 92);
-    invariant(doc.definitions.length <= 1, 93);
+    invariant(doc.kind === "Document", 107);
+    invariant(doc.definitions.length <= 1, 108);
     var fragmentDef = doc.definitions[0];
-    invariant(fragmentDef.kind === "FragmentDefinition", 94);
+    invariant(fragmentDef.kind === "FragmentDefinition", 109);
     return fragmentDef;
 }
 function getMainDefinition(queryDoc) {
@@ -758,7 +758,7 @@ function getMainDefinition(queryDoc) {
     if (fragmentDefinition) {
         return fragmentDefinition;
     }
-    throw newInvariantError(95);
+    throw newInvariantError(110);
 }
 function getDefaultValues(definition) {
     var defaultValues = Object.create(null);
@@ -809,7 +809,7 @@ var DocumentTransform =  (function () {
                 makeCacheKey: function (document) {
                     var cacheKeys = _this.getCacheKey(document);
                     if (cacheKeys) {
-                        invariant(Array.isArray(cacheKeys), 77);
+                        invariant(Array.isArray(cacheKeys), 92);
                         return stableCacheKeys_1.lookupArray(cacheKeys);
                     }
                 },
@@ -939,7 +939,7 @@ function removeDirectivesFromDocument(directives, doc) {
                 return getInUseByFragmentName(ancestor.name.value);
             }
         }
-        globalThis.__DEV__ !== false && invariant.error(97);
+        globalThis.__DEV__ !== false && invariant.error(112);
         return null;
     };
     var operationCount = 0;
@@ -1615,7 +1615,7 @@ function toPromise(observable) {
         observable.subscribe({
             next: function (data) {
                 if (completed) {
-                    globalThis.__DEV__ !== false && invariant.warn(45);
+                    globalThis.__DEV__ !== false && invariant.warn(46);
                 }
                 else {
                     completed = true;
@@ -1658,7 +1658,7 @@ function validateOperation(operation) {
     for (var _i = 0, _a = Object.keys(operation); _i < _a.length; _i++) {
         var key = _a[_i];
         if (OPERATION_FIELDS.indexOf(key) < 0) {
-            throw newInvariantError(46, key);
+            throw newInvariantError(47, key);
         }
     }
     return operation;
@@ -1767,7 +1767,7 @@ var ApolloLink =  (function () {
     ApolloLink.concat = function (first, second) {
         var firstLink = toLink(first);
         if (isTerminating(firstLink)) {
-            globalThis.__DEV__ !== false && invariant.warn(38, firstLink);
+            globalThis.__DEV__ !== false && invariant.warn(39, firstLink);
             return firstLink;
         }
         var nextLink = toLink(second);
@@ -1793,7 +1793,7 @@ var ApolloLink =  (function () {
         return ApolloLink.concat(this, next);
     };
     ApolloLink.prototype.request = function (operation, forward) {
-        throw newInvariantError(39);
+        throw newInvariantError(40);
     };
     ApolloLink.prototype.onError = function (error, observer) {
         if (observer && observer.error) {
@@ -2175,7 +2175,7 @@ var serializeFetchParameter = function (p, label) {
         serialized = JSON.stringify(p);
     }
     catch (e) {
-        var parseError = newInvariantError(42, label, e.message);
+        var parseError = newInvariantError(43, label, e.message);
         parseError.parseError = e;
         throw parseError;
     }
@@ -2261,7 +2261,7 @@ function removeDuplicateHeaders(headers, preserveHeaderCase) {
 
 var checkFetcher = function (fetcher) {
     if (!fetcher && typeof fetch === "undefined") {
-        throw newInvariantError(40);
+        throw newInvariantError(41);
     }
 };
 
@@ -2395,7 +2395,7 @@ var createHttpLink = function (linkOptions) {
             options.headers = options.headers || {};
             var acceptHeader = "multipart/mixed;";
             if (isSubscription && hasDefer) {
-                globalThis.__DEV__ !== false && invariant.warn(41);
+                globalThis.__DEV__ !== false && invariant.warn(42);
             }
             if (isSubscription) {
                 acceptHeader +=
@@ -2536,7 +2536,7 @@ var issuedWarning = false;
 function warnOnImproperCacheImplementation() {
     if (!issuedWarning) {
         issuedWarning = true;
-        globalThis.__DEV__ !== false && invariant.warn(52);
+        globalThis.__DEV__ !== false && invariant.warn(53);
     }
 }
 
@@ -2620,7 +2620,7 @@ function maskSelectionSet(data, selectionSet, context, migration, path) {
             var fragment = context.fragmentMap[fragmentName] ||
                 (context.fragmentMap[fragmentName] =
                     context.cache.lookupFragment(fragmentName));
-            invariant(fragment, 47, fragmentName);
+            invariant(fragment, 48, fragmentName);
             var mode = getFragmentMaskMode(selection);
             if (mode !== "mask") {
                 value = maskSelectionSet(data, fragment.selectionSet, context, mode === "migrate", path);
@@ -2643,7 +2643,7 @@ function getAccessorWarningDescriptor(fieldName, value, path, operationName, ope
         if (disableWarningsSlot.getValue()) {
             return value;
         }
-        globalThis.__DEV__ !== false && invariant.warn(48, operationName ?
+        globalThis.__DEV__ !== false && invariant.warn(49, operationName ?
             "".concat(operationType, " '").concat(operationName, "'")
             : "anonymous ".concat(operationType), "".concat(path, ".").concat(fieldName).replace(/^\./, ""));
         getValue = function () { return value; };
@@ -2672,11 +2672,11 @@ function maskFragment(data, document, cache, fragmentName) {
         return node.kind === graphql.Kind.FRAGMENT_DEFINITION;
     });
     if (typeof fragmentName === "undefined") {
-        invariant(fragments.length === 1, 49, fragments.length);
+        invariant(fragments.length === 1, 50, fragments.length);
         fragmentName = fragments[0].name.value;
     }
     var fragment = fragments.find(function (fragment) { return fragment.name.value === fragmentName; });
-    invariant(!!fragment, 50, fragmentName);
+    invariant(!!fragment, 51, fragmentName);
     if (data == null) {
         return data;
     }
@@ -2702,7 +2702,7 @@ function maskOperation(data, document, cache) {
         return data;
     }
     var definition = getOperationDefinition(document);
-    invariant(definition, 51);
+    invariant(definition, 52);
     if (data == null) {
         return data;
     }
@@ -2716,6 +2716,31 @@ function maskOperation(data, document, cache) {
     });
 }
 
+var slot = new optimism.Slot();
+function isMuted(name) {
+    return (slot.getValue() || []).includes(name);
+}
+function muteDeprecations(name) {
+    var args = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args[_i - 1] = arguments[_i];
+    }
+    return slot.withValue.apply(slot, tslib.__spreadArray([Array.isArray(name) ? name : [name]], args, false));
+}
+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 && invariant.warn(91, callSite, name, recommendation);
+        }
+    });
+}
+function warnDeprecated(name, cb) {
+    if (!isMuted(name)) {
+        cb();
+    }
+}
+
 var ApolloCache =  (function () {
     function ApolloCache() {
         this.assumeImmutableResults = false;
@@ -2756,8 +2781,14 @@ var ApolloCache =  (function () {
         return false;
     };
     ApolloCache.prototype.readQuery = function (options, optimistic) {
+        var _this = this;
         if (optimistic === void 0) { optimistic = !!options.optimistic; }
-        return this.read(tslib.__assign(tslib.__assign({}, options), { rootId: options.id || "ROOT_QUERY", optimistic: optimistic }));
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(options, "canonizeResults", "cache.readQuery");
+        }
+        return muteDeprecations("canonizeResults", function () {
+            return _this.read(tslib.__assign(tslib.__assign({}, options), { rootId: options.id || "ROOT_QUERY", optimistic: optimistic }));
+        });
     };
     ApolloCache.prototype.watchFragment = function (options) {
         var _this = this;
@@ -2799,8 +2830,14 @@ var ApolloCache =  (function () {
         });
     };
     ApolloCache.prototype.readFragment = function (options, optimistic) {
+        var _this = this;
         if (optimistic === void 0) { optimistic = !!options.optimistic; }
-        return this.read(tslib.__assign(tslib.__assign({}, options), { query: this.getFragmentDoc(options.fragment, options.fragmentName), rootId: options.id, optimistic: optimistic }));
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(options, "canonizeResults", "cache.readFragment");
+        }
+        return muteDeprecations("canonizeResults", function () {
+            return _this.read(tslib.__assign(tslib.__assign({}, options), { query: _this.getFragmentDoc(options.fragment, options.fragmentName), rootId: options.id, optimistic: optimistic }));
+        });
     };
     ApolloCache.prototype.writeQuery = function (_a) {
         var id = _a.id, data = _a.data, options = tslib.__rest(_a, ["id", "data"]);
@@ -2818,9 +2855,14 @@ var ApolloCache =  (function () {
         }));
     };
     ApolloCache.prototype.updateQuery = function (options, update) {
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(options, "canonizeResults", "cache.updateQuery");
+        }
         return this.batch({
             update: function (cache) {
-                var value = cache.readQuery(options);
+                var value = muteDeprecations("canonizeResults", function () {
+                    return cache.readQuery(options);
+                });
                 var data = update(value);
                 if (data === void 0 || data === null)
                     return value;
@@ -2830,9 +2872,14 @@ var ApolloCache =  (function () {
         });
     };
     ApolloCache.prototype.updateFragment = function (options, update) {
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(options, "canonizeResults", "cache.updateFragment");
+        }
         return this.batch({
             update: function (cache) {
-                var value = cache.readFragment(options);
+                var value = muteDeprecations("canonizeResults", function () {
+                    return cache.readFragment(options);
+                });
                 var data = update(value);
                 if (data === void 0 || data === null)
                     return value;
@@ -4096,8 +4143,7 @@ var Policies =  (function () {
             }
         });
     };
-    Policies.prototype.updateTypePolicy = function (typename, incoming) {
-        var _this = this;
+    Policies.prototype.updateTypePolicy = function (typename, incoming, existingFieldPolicies) {
         var existing = this.getTypePolicy(typename);
         var keyFields = incoming.keyFields, fields = incoming.fields;
         function setMerge(existing, merge) {
@@ -4115,7 +4161,10 @@ var Policies =  (function () {
                         : existing.keyFn;
         if (fields) {
             Object.keys(fields).forEach(function (fieldName) {
-                var existing = _this.getFieldPolicy(typename, fieldName, true);
+                var existing = existingFieldPolicies[fieldName];
+                if (!existing || (existing === null || existing === void 0 ? void 0 : existing.typename) !== typename) {
+                    existing = existingFieldPolicies[fieldName] = { typename: typename };
+                }
                 var incoming = fields[fieldName];
                 if (typeof incoming === "function") {
                     existing.read = incoming;
@@ -4194,16 +4243,14 @@ var Policies =  (function () {
         var inbox = this.toBeAdded[typename];
         if (inbox && inbox.length) {
             inbox.splice(0).forEach(function (policy) {
-                _this.updateTypePolicy(typename, policy);
+                _this.updateTypePolicy(typename, policy, _this.typePolicies[typename].fields);
             });
         }
         return this.typePolicies[typename];
     };
-    Policies.prototype.getFieldPolicy = function (typename, fieldName, createIfMissing) {
+    Policies.prototype.getFieldPolicy = function (typename, fieldName) {
         if (typename) {
-            var fieldPolicies = this.getTypePolicy(typename).fields;
-            return (fieldPolicies[fieldName] ||
-                (createIfMissing && (fieldPolicies[fieldName] = Object.create(null))));
+            return this.getTypePolicy(typename).fields[fieldName];
         }
     };
     Policies.prototype.getSupertypeSet = function (subtype, createIfMissing) {
@@ -4264,12 +4311,12 @@ var Policies =  (function () {
         return false;
     };
     Policies.prototype.hasKeyArgs = function (typename, fieldName) {
-        var policy = this.getFieldPolicy(typename, fieldName, false);
+        var policy = this.getFieldPolicy(typename, fieldName);
         return !!(policy && policy.keyFn);
     };
     Policies.prototype.getStoreFieldName = function (fieldSpec) {
         var typename = fieldSpec.typename, fieldName = fieldSpec.fieldName;
-        var policy = this.getFieldPolicy(typename, fieldName, false);
+        var policy = this.getFieldPolicy(typename, fieldName);
         var storeFieldName;
         var keyFn = policy && policy.keyFn;
         if (keyFn && typename) {
@@ -4318,7 +4365,7 @@ var Policies =  (function () {
         var storeFieldName = this.getStoreFieldName(options);
         var fieldName = fieldNameFromStoreName(storeFieldName);
         var existing = context.store.getFieldValue(objectOrReference, storeFieldName);
-        var policy = this.getFieldPolicy(options.typename, fieldName, false);
+        var policy = this.getFieldPolicy(options.typename, fieldName);
         var read = policy && policy.read;
         if (read) {
             var readOptions = makeFieldFunctionOptions(this, objectOrReference, options, context, context.store.getStorage(isReference(objectOrReference) ?
@@ -4332,11 +4379,11 @@ var Policies =  (function () {
         return existing;
     };
     Policies.prototype.getReadFunction = function (typename, fieldName) {
-        var policy = this.getFieldPolicy(typename, fieldName, false);
+        var policy = this.getFieldPolicy(typename, fieldName);
         return policy && policy.read;
     };
     Policies.prototype.getMergeFunction = function (parentTypename, fieldName, childTypename) {
-        var policy = this.getFieldPolicy(parentTypename, fieldName, false);
+        var policy = this.getFieldPolicy(parentTypename, fieldName);
         var merge = policy && policy.merge;
         if (!merge && childTypename) {
             policy = this.getTypePolicy(childTypename);
@@ -4845,6 +4892,10 @@ var InMemoryCache =  (function (_super) {
         _this.assumeImmutableResults = true;
         _this.makeVar = makeVar;
         _this.txCount = 0;
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(config, "addTypename", "InMemoryCache", "Please remove the `addTypename` option when initializing `InMemoryCache`.");
+            warnRemovedOption(config, "canonizeResults", "InMemoryCache", "Please remove the `canonizeResults` option when initializing `InMemoryCache`.");
+        }
         _this.config = normalizeConfig(config);
         _this.addTypename = !!_this.config.addTypename;
         _this.policies = new Policies({
@@ -4868,6 +4919,8 @@ var InMemoryCache =  (function (_super) {
         var _this = this;
         var previousReader = this.storeReader;
         var fragments = this.config.fragments;
+        this.addTypenameTransform.resetCache();
+        fragments === null || fragments === void 0 ? void 0 : fragments.resetCaches();
         this.storeWriter = new StoreWriter(this, (this.storeReader = new StoreReader({
             cache: this,
             addTypename: this.addTypename,
@@ -4906,6 +4959,9 @@ var InMemoryCache =  (function (_super) {
         return (optimistic ? this.optimisticData : this.data).extract();
     };
     InMemoryCache.prototype.read = function (options) {
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(options, "canonizeResults", "cache.read");
+        }
         var
         _a = options.returnPartialData,
         returnPartialData = _a === void 0 ? false : _a;
@@ -4949,6 +5005,9 @@ var InMemoryCache =  (function (_super) {
         }
     };
     InMemoryCache.prototype.diff = function (options) {
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(options, "canonizeResults", "cache.diff");
+        }
         return this.storeReader.diffQueryAgainstStore(tslib.__assign(tslib.__assign({}, options), { store: options.optimistic ? this.optimisticData : this.data, rootId: options.id || "ROOT_QUERY", config: this.config }));
     };
     InMemoryCache.prototype.watch = function (watch) {
@@ -4968,11 +5027,8 @@ var InMemoryCache =  (function (_super) {
         };
     };
     InMemoryCache.prototype.gc = function (options) {
-        var _a;
         canonicalStringify.reset();
         print.reset();
-        this.addTypenameTransform.resetCache();
-        (_a = this.config.fragments) === null || _a === void 0 ? void 0 : _a.resetCaches();
         var ids = this.optimisticData.gc();
         if (options && !this.txCount) {
             if (options.resetResultCache) {
@@ -5126,8 +5182,9 @@ var InMemoryCache =  (function (_super) {
         return document;
     };
     InMemoryCache.prototype.broadcastWatch = function (c, options) {
+        var _this = this;
         var lastDiff = c.lastDiff;
-        var diff = this.diff(c);
+        var diff = muteDeprecations("canonizeResults", function () { return _this.diff(c); });
         if (options) {
             if (c.optimistic && typeof options.optimistic === "string") {
                 diff.fromOptimisticTransaction = true;
@@ -5364,7 +5421,7 @@ var ObservableQuery =  (function (_super) {
             var vars = queryDef.variableDefinitions;
             if (!vars || !vars.some(function (v) { return v.variable.name.value === "variables"; })) {
                 globalThis.__DEV__ !== false && invariant.warn(
-                    21,
+                    22,
                     variables,
                     ((_a = queryDef.name) === null || _a === void 0 ? void 0 : _a.value) || queryDef
                 );
@@ -5396,7 +5453,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) {
-            invariant(updateQuery, 22);
+            invariant(updateQuery, 23);
         }
         return this.queryManager
             .fetchQuery(qid, combinedOptions, exports.NetworkStatus.fetchMore)
@@ -5473,7 +5530,7 @@ var ObservableQuery =  (function (_super) {
                     options.onError(err);
                     return;
                 }
-                globalThis.__DEV__ !== false && invariant.error(23, err);
+                globalThis.__DEV__ !== false && invariant.error(24, err);
             },
         });
         this.subscriptions.add(subscription);
@@ -5484,6 +5541,9 @@ var ObservableQuery =  (function (_super) {
         };
     };
     ObservableQuery.prototype.setOptions = function (newOptions) {
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(newOptions, "canonizeResults", "setOptions");
+        }
         return this.reobserve(newOptions);
     };
     ObservableQuery.prototype.silentSetOptions = function (newOptions) {
@@ -5576,7 +5636,7 @@ var ObservableQuery =  (function (_super) {
         if (pollingInfo && pollingInfo.interval === pollInterval) {
             return;
         }
-        invariant(pollInterval, 24);
+        invariant(pollInterval, 25);
         var info = pollingInfo || (this.pollingInfo = {});
         info.interval = pollInterval;
         var maybeFetch = function () {
@@ -5797,11 +5857,11 @@ var ObservableQuery =  (function (_super) {
 }(zenObservableTs.Observable));
 fixObservableSubclass(ObservableQuery);
 function defaultSubscriptionObserverErrorCallback(error) {
-    globalThis.__DEV__ !== false && invariant.error(25, error.message, error.stack);
+    globalThis.__DEV__ !== false && invariant.error(26, error.message, error.stack);
 }
 function logMissingFieldErrors(missing) {
     if (globalThis.__DEV__ !== false && missing) {
-        globalThis.__DEV__ !== false && invariant.debug(26, missing);
+        globalThis.__DEV__ !== false && invariant.debug(27, missing);
     }
 }
 function skipCacheDataFor(fetchPolicy ) {
@@ -5867,6 +5927,7 @@ var QueryInfo =  (function () {
         this.lastDiff = void 0;
     };
     QueryInfo.prototype.getDiff = function () {
+        var _this = this;
         var options = this.getDiffOptions();
         if (this.lastDiff && equal.equal(options, this.lastDiff.options)) {
             return this.lastDiff.diff;
@@ -5876,7 +5937,9 @@ var QueryInfo =  (function () {
         if (oq && oq.options.fetchPolicy === "no-cache") {
             return { complete: false };
         }
-        var diff = this.cache.diff(options);
+        var diff = muteDeprecations("canonizeResults", function () {
+            return _this.cache.diff(options);
+        });
         this.updateLastDiff(diff, options);
         return diff;
     };
@@ -5999,7 +6062,9 @@ var QueryInfo =  (function () {
                         }
                     }
                     var diffOptions = _this.getDiffOptions(options.variables);
-                    var diff = cache.diff(diffOptions);
+                    var diff = muteDeprecations("canonizeResults", function () {
+                        return cache.diff(diffOptions);
+                    });
                     if (!_this.stopped && equal.equal(_this.variables, options.variables)) {
                         _this.updateWatch(options.variables);
                     }
@@ -6086,7 +6151,7 @@ var QueryManager =  (function () {
         this.queries.forEach(function (_info, queryId) {
             _this.stopQueryNoBroadcast(queryId);
         });
-        this.cancelPendingFetches(newInvariantError(27));
+        this.cancelPendingFetches(newInvariantError(28));
     };
     QueryManager.prototype.cancelPendingFetches = function (error) {
         this.fetchCancelFns.forEach(function (cancel) { return cancel(error); });
@@ -6100,8 +6165,8 @@ var QueryManager =  (function () {
             return tslib.__generator(this, function (_j) {
                 switch (_j.label) {
                     case 0:
-                        invariant(mutation, 28);
-                        invariant(fetchPolicy === "network-only" || fetchPolicy === "no-cache", 29);
+                        invariant(mutation, 29);
+                        invariant(fetchPolicy === "network-only" || fetchPolicy === "no-cache", 30);
                         mutationId = this.generateMutationId();
                         mutation = this.cache.transformForLink(this.transform(mutation));
                         hasClientExports = this.getDocumentInfo(mutation).hasClientExports;
@@ -6431,10 +6496,10 @@ var QueryManager =  (function () {
     QueryManager.prototype.query = function (options, queryId) {
         var _this = this;
         if (queryId === void 0) { queryId = this.generateQueryId(); }
-        invariant(options.query, 30);
-        invariant(options.query.kind === "Document", 31);
-        invariant(!options.returnPartialData, 32);
-        invariant(!options.pollInterval, 33);
+        invariant(options.query, 31);
+        invariant(options.query.kind === "Document", 32);
+        invariant(!options.returnPartialData, 33);
+        invariant(!options.pollInterval, 34);
         var query = this.transform(options.query);
         return this.fetchQuery(queryId, tslib.__assign(tslib.__assign({}, options), { query: query }))
             .then(function (result) {
@@ -6469,7 +6534,7 @@ var QueryManager =  (function () {
         if (options === void 0) { options = {
             discardWatches: true,
         }; }
-        this.cancelPendingFetches(newInvariantError(34));
+        this.cancelPendingFetches(newInvariantError(35));
         this.queries.forEach(function (queryInfo) {
             if (queryInfo.observableQuery) {
                 queryInfo.networkStatus = exports.NetworkStatus.loading;
@@ -6551,10 +6616,10 @@ var QueryManager =  (function () {
                 if (!included) {
                     var queryName = queryNames.get(nameOrQueryString);
                     if (queryName) {
-                        globalThis.__DEV__ !== false && invariant.warn(35, queryName);
+                        globalThis.__DEV__ !== false && invariant.warn(36, queryName);
                     }
                     else {
-                        globalThis.__DEV__ !== false && invariant.warn(36);
+                        globalThis.__DEV__ !== false && invariant.warn(37);
                     }
                 }
             });
@@ -6845,7 +6910,9 @@ var QueryManager =  (function () {
                 var result;
                 if (onQueryUpdated) {
                     if (!diff) {
-                        diff = _this.cache.diff(oq["queryInfo"]["getDiffOptions"]());
+                        diff = muteDeprecations("canonizeResults", function () {
+                            return _this.cache.diff(oq["queryInfo"]["getDiffOptions"]());
+                        });
                     }
                     result = onQueryUpdated(oq, diff, lastDiff);
                 }
@@ -6878,7 +6945,7 @@ var QueryManager =  (function () {
                 !this.noCacheWarningsByQueryId.has(operationId)) {
                 this.noCacheWarningsByQueryId.add(operationId);
                 globalThis.__DEV__ !== false && invariant.warn(
-                    37,
+                    38,
                     (_c = getOperationName(document)) !== null && _c !== void 0 ? _c : "Unnamed ".concat(operationType !== null && operationType !== void 0 ? operationType : "operation")
                 );
             }
@@ -7193,7 +7260,7 @@ var LocalState =  (function () {
                         }
                         else {
                             fragment = fragmentMap[selection.name.value];
-                            invariant(fragment, 19, selection.name.value);
+                            invariant(fragment, 20, selection.name.value);
                         }
                         if (fragment && fragment.typeCondition) {
                             typeCondition = fragment.typeCondition.name.value;
@@ -7307,7 +7374,7 @@ var LocalState =  (function () {
                     },
                     FragmentSpread: function (spread, _, __, ___, ancestors) {
                         var fragment = fragmentMap[spread.name.value];
-                        invariant(fragment, 20, spread.name.value);
+                        invariant(fragment, 21, spread.name.value);
                         var fragmentSelections = collectByDefinition(fragment);
                         if (fragmentSelections.size > 0) {
                             ancestors.forEach(function (node) {
@@ -7334,14 +7401,26 @@ var hasSuggestedDevtools = false;
 var ApolloClient =  (function () {
     function ApolloClient(options) {
         var _this = this;
-        var _a;
+        var _a, _b, _c;
         this.resetStoreCallbacks = [];
         this.clearStoreCallbacks = [];
         if (!options.cache) {
             throw newInvariantError(16);
         }
-        var uri = options.uri, credentials = options.credentials, headers = options.headers, cache = options.cache, documentTransform = options.documentTransform, _b = options.ssrMode, ssrMode = _b === void 0 ? false : _b, _c = options.ssrForceFetchDelay, ssrForceFetchDelay = _c === void 0 ? 0 : _c,
-        connectToDevTools = options.connectToDevTools, _d = options.queryDeduplication, queryDeduplication = _d === void 0 ? true : _d, defaultOptions = options.defaultOptions, defaultContext = options.defaultContext, _e = options.assumeImmutableResults, assumeImmutableResults = _e === void 0 ? cache.assumeImmutableResults : _e, resolvers = options.resolvers, typeDefs = options.typeDefs, fragmentMatcher = options.fragmentMatcher, clientAwarenessName = options.name, clientAwarenessVersion = options.version, devtools = options.devtools, dataMasking = options.dataMasking;
+        var uri = options.uri, credentials = options.credentials, headers = options.headers, cache = options.cache, documentTransform = options.documentTransform, _d = options.ssrMode, ssrMode = _d === void 0 ? false : _d, _e = options.ssrForceFetchDelay, ssrForceFetchDelay = _e === void 0 ? 0 : _e,
+        connectToDevTools = options.connectToDevTools, _f = options.queryDeduplication, queryDeduplication = _f === void 0 ? true : _f, defaultOptions = options.defaultOptions, defaultContext = options.defaultContext, _g = options.assumeImmutableResults, assumeImmutableResults = _g === void 0 ? cache.assumeImmutableResults : _g, resolvers = options.resolvers, typeDefs = options.typeDefs, fragmentMatcher = options.fragmentMatcher, clientAwareness = options.clientAwareness, clientAwarenessName = options.name, clientAwarenessVersion = options.version, devtools = options.devtools, dataMasking = options.dataMasking;
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(options, "connectToDevTools", "ApolloClient", "Please use `devtools.enabled` instead.");
+            warnRemovedOption(options, "uri", "ApolloClient", "Please initialize an instance of `HttpLink` with `uri` instead.");
+            warnRemovedOption(options, "credentials", "ApolloClient", "Please initialize an instance of `HttpLink` with `credentials` instead.");
+            warnRemovedOption(options, "headers", "ApolloClient", "Please initialize an instance of `HttpLink` with `headers` instead.");
+            warnRemovedOption(options, "name", "ApolloClient", "Please use the `clientAwareness.name` option instead.");
+            warnRemovedOption(options, "version", "ApolloClient", "Please use the `clientAwareness.version` option instead.");
+            warnRemovedOption(options, "typeDefs", "ApolloClient");
+            if (!options.link) {
+                globalThis.__DEV__ !== false && invariant.warn(17);
+            }
+        }
         var link = options.link;
         if (!link) {
             link =
@@ -7383,8 +7462,8 @@ var ApolloClient =  (function () {
             ssrMode: ssrMode,
             dataMasking: !!dataMasking,
             clientAwareness: {
-                name: clientAwarenessName,
-                version: clientAwarenessVersion,
+                name: (_b = clientAwareness === null || clientAwareness === void 0 ? void 0 : clientAwareness.name) !== null && _b !== void 0 ? _b : clientAwarenessName,
+                version: (_c = clientAwareness === null || clientAwareness === void 0 ? void 0 : clientAwareness.version) !== null && _c !== void 0 ? _c : clientAwarenessVersion,
             },
             localState: this.localState,
             assumeImmutableResults: assumeImmutableResults,
@@ -7406,6 +7485,16 @@ var ApolloClient =  (function () {
         if (this.devtoolsConfig.enabled)
             this.connectToDevTools();
     }
+    Object.defineProperty(ApolloClient.prototype, "prioritizeCacheValues", {
+        get: function () {
+            return this.disableNetworkFetches;
+        },
+        set: function (value) {
+            this.disableNetworkFetches = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
     ApolloClient.prototype.connectToDevTools = function () {
         if (typeof window === "undefined") {
             return;
@@ -7464,16 +7553,22 @@ var ApolloClient =  (function () {
                 options.fetchPolicy === "cache-and-network")) {
             options = tslib.__assign(tslib.__assign({}, options), { fetchPolicy: "cache-first" });
         }
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(options, "canonizeResults", "client.watchQuery");
+        }
         return this.queryManager.watchQuery(options);
     };
     ApolloClient.prototype.query = function (options) {
         if (this.defaultOptions.query) {
             options = mergeOptions(this.defaultOptions.query, options);
         }
-        invariant(options.fetchPolicy !== "cache-and-network", 17);
+        invariant(options.fetchPolicy !== "cache-and-network", 18);
         if (this.disableNetworkFetches && options.fetchPolicy === "network-only") {
             options = tslib.__assign(tslib.__assign({}, options), { fetchPolicy: "cache-first" });
         }
+        if (globalThis.__DEV__ !== false) {
+            warnRemovedOption(options, "canonizeResults", "client.query");
+        }
         return this.queryManager.query(options);
     };
     ApolloClient.prototype.mutate = function (options) {
@@ -7576,7 +7671,7 @@ var ApolloClient =  (function () {
         result.queries = queries;
         result.results = results;
         result.catch(function (error) {
-            globalThis.__DEV__ !== false && invariant.debug(18, error);
+            globalThis.__DEV__ !== false && invariant.debug(19, error);
         });
         return result;
     };
@@ -7620,7 +7715,7 @@ if (globalThis.__DEV__ !== false) {
 
 var contextKey = canUseSymbol ? Symbol.for("__APOLLO_CONTEXT__") : "__APOLLO_CONTEXT__";
 function getApolloContext() {
-    invariant("createContext" in React__namespace, 54);
+    invariant("createContext" in React__namespace, 58);
     var context = React__namespace.createContext[contextKey];
     if (!context) {
         Object.defineProperty(React__namespace.createContext, contextKey, {
@@ -7633,12 +7728,17 @@ function getApolloContext() {
     }
     return context;
 }
-var resetApolloContext = getApolloContext;
+var resetApolloContext = function () {
+    if (globalThis.__DEV__ !== false) {
+        globalThis.__DEV__ !== false && invariant.warn(59);
+    }
+    return getApolloContext();
+};
 
 var ApolloConsumer = function (props) {
     var ApolloContext = getApolloContext();
     return (React__namespace.createElement(ApolloContext.Consumer, null, function (context) {
-        invariant(context && context.client, 53);
+        invariant(context && context.client, 57);
         return props.children(context.client);
     }));
 };
@@ -7650,14 +7750,14 @@ var ApolloProvider = function (_a) {
     var context = React__namespace.useMemo(function () {
         return tslib.__assign(tslib.__assign({}, parentContext), { client: client || parentContext.client });
     }, [parentContext, client]);
-    invariant(context.client, 55);
+    invariant(context.client, 60);
     return (React__namespace.createElement(ApolloContext.Provider, { value: context }, children));
 };
 
 function useApolloClient(override) {
     var context = React__namespace.useContext(getApolloContext());
     var client = override || context.client;
-    invariant(!!client, 58);
+    invariant(!!client, 68);
     return client;
 }
 
@@ -7672,7 +7772,7 @@ var useSyncExternalStore = realHook$1 ||
             !didWarnUncachedGetSnapshot &&
             value !== getSnapshot()) {
             didWarnUncachedGetSnapshot = true;
-            globalThis.__DEV__ !== false && invariant.error(68);
+            globalThis.__DEV__ !== false && invariant.error(81);
         }
         var _a = React__namespace.useState({
             inst: { value: value, getSnapshot: getSnapshot },
@@ -7733,6 +7833,9 @@ function operationName(type) {
     return name;
 }
 function parser(document) {
+    warnDeprecated("parser", function () {
+        globalThis.__DEV__ !== false && invariant.warn(83);
+    });
     if (!cache) {
         cache = new AutoCleanedWeakCache(cacheSizes.parser || 1000 );
     }
@@ -7740,7 +7843,7 @@ function parser(document) {
     if (cached)
         return cached;
     var variables, type, name;
-    invariant(!!document && !!document.kind, 70, document);
+    invariant(!!document && !!document.kind, 84, document);
     var fragments = [];
     var queries = [];
     var mutations = [];
@@ -7768,10 +7871,10 @@ function parser(document) {
     invariant(!fragments.length ||
         queries.length ||
         mutations.length ||
-        subscriptions.length, 71);
+        subscriptions.length, 85);
     invariant(
         queries.length + mutations.length + subscriptions.length <= 1,
-        72,
+        86,
         document,
         queries.length,
         subscriptions.length,
@@ -7783,7 +7886,7 @@ function parser(document) {
     var definitions = queries.length ? queries
         : mutations.length ? mutations
             : subscriptions;
-    invariant(definitions.length === 1, 73, document, definitions.length);
+    invariant(definitions.length === 1, 87, document, definitions.length);
     var definition = definitions[0];
     variables = definition.variableDefinitions || [];
     if (definition.name && definition.name.kind === "Name") {
@@ -7803,12 +7906,12 @@ if (globalThis.__DEV__ !== false) {
     registerGlobalCache("parser", function () { return (cache ? cache.size : 0); });
 }
 function verifyDocumentType(document, type) {
-    var operation = parser(document);
+    var operation = muteDeprecations("parser", parser, [document]);
     var requiredOperationName = operationName(type);
     var usedOperationName = operationName(operation.type);
     invariant(
         operation.type === type,
-        74,
+        88,
         requiredOperationName,
         requiredOperationName,
         usedOperationName
@@ -7848,6 +7951,16 @@ function useRenderGuard() {
     }, []);
 }
 
+function useWarnRemovedOption(options, name, callSite, recommendation) {
+    "use no memo";
+    if (recommendation === void 0) { recommendation = "Please remove this option."; }
+    var didWarn = React__namespace.useRef(false);
+    if (name in options && !didWarn.current) {
+        globalThis.__DEV__ !== false && invariant.warn(67, callSite, name, recommendation);
+        didWarn.current = true;
+    }
+}
+
 var useKey = "use";
 var realHook = React__namespace[useKey];
 var __use = realHook ||
@@ -7876,10 +7989,16 @@ function noop() { }
 var lastWatchOptions = Symbol();
 function useQuery(query, options) {
     if (options === void 0) { options = Object.create(null); }
-    return wrapHook("useQuery",
-    useQuery_, useApolloClient(options && options.client))(query, options);
+    return wrapHook("useQuery", useQuery_, useApolloClient(options && options.client))(query, options);
 }
 function useQuery_(query, options) {
+    if (globalThis.__DEV__ !== false) {
+        useWarnRemovedOption(options, "canonizeResults", "useQuery");
+        useWarnRemovedOption(options, "partialRefetch", "useQuery");
+        useWarnRemovedOption(options, "defaultOptions", "useQuery", "Pass the options directly to the hook instead.");
+        useWarnRemovedOption(options, "onCompleted", "useQuery", "If your `onCompleted` callback sets local state, switch to use derived state using `data` returned from the hook instead. Use `useEffect` to perform side-effects as a result of updates to `data`.");
+        useWarnRemovedOption(options, "onError", "useQuery", "If your `onError` callback sets local state, switch to use derived state using `data`, `error` or `errors` returned from the hook instead. Use `useEffect` if you need to perform side-effects as a result of updates to `data`, `error` or `errors`.");
+    }
     var _a = useQueryInternals(query, options), result = _a.result, obsQueryFields = _a.obsQueryFields;
     return React__namespace.useMemo(function () { return (tslib.__assign(tslib.__assign({}, result), obsQueryFields)); }, [result, obsQueryFields]);
 }
@@ -7894,7 +8013,9 @@ function useInternalState(client, query, options, renderPromises, makeWatchQuery
             (renderPromises &&
                 renderPromises.getSSRObservable(makeWatchQueryOptions())) ||
                 ObservableQuery["inactiveOnCreation"].withValue(!renderPromises, function () {
-                    return client.watchQuery(getObsQueryOptions(void 0, client, options, makeWatchQueryOptions()));
+                    return muteDeprecations("canonizeResults", function () {
+                        return client.watchQuery(getObsQueryOptions(void 0, client, options, makeWatchQueryOptions()));
+                    });
                 }),
             resultData: {
                 previousData: (_a = previous === null || previous === void 0 ? void 0 : previous.resultData.current) === null || _a === void 0 ? void 0 : _a.data,
@@ -8161,7 +8282,16 @@ var skipStandbyResult = maybeDeepFreeze({
 function bindObservableMethods(observable) {
     return {
         refetch: observable.refetch.bind(observable),
-        reobserve: observable.reobserve.bind(observable),
+        reobserve: function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            if (globalThis.__DEV__ !== false) {
+                globalThis.__DEV__ !== false && invariant.warn(73);
+            }
+            return observable.reobserve.apply(observable, args);
+        },
         fetchMore: observable.fetchMore.bind(observable),
         updateQuery: observable.updateQuery.bind(observable),
         startPolling: observable.startPolling.bind(observable),
@@ -8179,8 +8309,40 @@ var EAGER_METHODS = [
     "stopPolling",
     "subscribeToMore",
 ];
+var REMOVED_EXECUTE_OPTIONS = [
+    "initialFetchPolicy",
+    "onCompleted",
+    "onError",
+    "defaultOptions",
+    "partialRefetch",
+    "canonizeResults",
+];
+var DEPRECATED_EXECUTE_OPTIONS = [
+    "query",
+    "ssr",
+    "client",
+    "fetchPolicy",
+    "nextFetchPolicy",
+    "refetchWritePolicy",
+    "errorPolicy",
+    "pollInterval",
+    "notifyOnNetworkStatusChange",
+    "returnPartialData",
+    "skipPollAttempt",
+];
 function useLazyQuery(query, options) {
     var _a;
+    if (globalThis.__DEV__ !== false) {
+        var warnOpts = options || {};
+        useWarnRemovedOption(warnOpts, "canonizeResults", "useLazyQuery");
+        useWarnRemovedOption(warnOpts, "variables", "useLazyQuery", "Pass all `variables` to the returned `execute` function instead.");
+        useWarnRemovedOption(warnOpts, "context", "useLazyQuery", "Pass `context` to the returned `execute` function instead.");
+        useWarnRemovedOption(warnOpts, "onCompleted", "useLazyQuery", "If your `onCompleted` callback sets local state, switch to use derived state using `data` returned from the hook instead. Use `useEffect` to perform side-effects as a result of updates to `data`.");
+        useWarnRemovedOption(warnOpts, "onError", "useLazyQuery", "If your `onError` callback sets local state, switch to use derived state using `data`, `error` or `errors` returned from the hook instead. Use `useEffect` if you need to perform side-effects as a result of updates to `data`, `error` or `errors`.");
+        useWarnRemovedOption(warnOpts, "defaultOptions", "useLazyQuery", "Pass the options directly to the hook instead.");
+        useWarnRemovedOption(warnOpts, "initialFetchPolicy", "useLazyQuery", "Use the `fetchPolicy` option instead.");
+        useWarnRemovedOption(warnOpts, "partialRefetch", "useLazyQuery");
+    }
     var execOptionsRef = React__namespace.useRef(void 0);
     var optionsRef = React__namespace.useRef(void 0);
     var queryRef = React__namespace.useRef(void 0);
@@ -8198,6 +8360,11 @@ function useLazyQuery(query, options) {
         var _loop_1 = function (key) {
             var method = obsQueryFields[key];
             eagerMethods[key] = function () {
+                if (globalThis.__DEV__ !== false) {
+                    if (key === "reobserve") {
+                        globalThis.__DEV__ !== false && invariant.warn(69);
+                    }
+                }
                 if (!execOptionsRef.current) {
                     execOptionsRef.current = Object.create(null);
                     forceUpdateState();
@@ -8213,7 +8380,28 @@ function useLazyQuery(query, options) {
     }, [forceUpdateState, obsQueryFields]);
     var called = !!execOptionsRef.current;
     var result = React__namespace.useMemo(function () { return (tslib.__assign(tslib.__assign(tslib.__assign({}, useQueryResult), eagerMethods), { called: called })); }, [useQueryResult, eagerMethods, called]);
+    var calledDuringRender = useRenderGuard();
+    var warnRef = React__namespace.useRef(new Set());
     var execute = React__namespace.useCallback(function (executeOptions) {
+        if (globalThis.__DEV__ !== false) {
+            if (calledDuringRender()) {
+                globalThis.__DEV__ !== false && invariant.warn(70);
+            }
+            for (var _i = 0, REMOVED_EXECUTE_OPTIONS_1 = REMOVED_EXECUTE_OPTIONS; _i < REMOVED_EXECUTE_OPTIONS_1.length; _i++) {
+                var name_1 = REMOVED_EXECUTE_OPTIONS_1[_i];
+                if (!warnRef.current.has(name_1)) {
+                    warnRemovedOption(executeOptions || {}, name_1, "useLazyQuery.execute");
+                    warnRef.current.add(name_1);
+                }
+            }
+            for (var _a = 0, DEPRECATED_EXECUTE_OPTIONS_1 = DEPRECATED_EXECUTE_OPTIONS; _a < DEPRECATED_EXECUTE_OPTIONS_1.length; _a++) {
+                var name_2 = DEPRECATED_EXECUTE_OPTIONS_1[_a];
+                if (!warnRef.current.has(name_2)) {
+                    warnRemovedOption(executeOptions || {}, name_2, "useLazyQuery.execute", "Please pass the option to the `useLazyQuery` hook instead.");
+                    warnRef.current.add(name_2);
+                }
+            }
+        }
         execOptionsRef.current =
             executeOptions ? tslib.__assign(tslib.__assign({}, executeOptions), { fetchPolicy: executeOptions.fetchPolicy || initialFetchPolicy }) : {
                 fetchPolicy: initialFetchPolicy,
@@ -8223,6 +8411,7 @@ function useLazyQuery(query, options) {
         promise.catch(function () { });
         return promise;
     }, [
+        calledDuringRender,
         client,
         document,
         eagerMethods,
@@ -8266,6 +8455,9 @@ function executeQuery(resultData, observable, client, currentQuery, options, onQ
 }
 
 function useMutation(mutation, options) {
+    if (globalThis.__DEV__ !== false) {
+        useWarnRemovedOption(options || {}, "ignoreResults", "useMutation", "If you don't want to synchronize component state with the mutation, please use the `useApolloClient` hook to get the client instance and call `client.mutate` directly.");
+    }
     var client = useApolloClient(options === null || options === void 0 ? void 0 : options.client);
     verifyDocumentType(mutation, exports.DocumentType.Mutation);
     var _a = React__namespace.useState({
@@ -8384,10 +8576,10 @@ function useSubscription(subscription, options) {
     if (!hasIssuedDeprecationWarningRef.current) {
         hasIssuedDeprecationWarningRef.current = true;
         if (options.onSubscriptionData) {
-            globalThis.__DEV__ !== false && invariant.warn(options.onData ? 61 : 62);
+            globalThis.__DEV__ !== false && invariant.warn(options.onData ? 74 : 75);
         }
         if (options.onSubscriptionComplete) {
-            globalThis.__DEV__ !== false && invariant.warn(options.onComplete ? 63 : 64);
+            globalThis.__DEV__ !== false && invariant.warn(options.onComplete ? 76 : 77);
         }
     }
     var skip = options.skip, fetchPolicy = options.fetchPolicy, errorPolicy = options.errorPolicy, shouldResubscribe = options.shouldResubscribe, context = options.context, extensions = options.extensions, ignoreResults = options.ignoreResults;
@@ -8508,7 +8700,7 @@ function useSubscription(subscription, options) {
             : fallbackResult;
     }, function () { return fallbackResult; });
     var restart = React__namespace.useCallback(function () {
-        invariant(!optionsRef.current.skip, 65);
+        invariant(!optionsRef.current.skip, 78);
         setObservable(recreateRef.current());
     }, [optionsRef, recreateRef]);
     return React__namespace.useMemo(function () { return (tslib.__assign(tslib.__assign({}, ret), { restart: restart })); }, [ret, restart]);
@@ -8556,6 +8748,9 @@ function useFragment(options) {
     useFragment_, useApolloClient(options.client))(options);
 }
 function useFragment_(options) {
+    if (globalThis.__DEV__ !== false) {
+        useWarnRemovedOption(options, "canonizeResults", "useFragment");
+    }
     var client = useApolloClient(options.client);
     var cache = client.cache;
     var from = options.from, rest = tslib.__rest(options, ["from"]);
@@ -8576,7 +8771,9 @@ function useFragment_(options) {
             };
         }
         var cache = client.cache;
-        var diff = cache.diff(tslib.__assign(tslib.__assign({}, stableOptions), { returnPartialData: true, id: from, query: cache["getFragmentDoc"](fragment, fragmentName), optimistic: optimistic }));
+        var diff = muteDeprecations("canonizeResults", function () {
+            return cache.diff(tslib.__assign(tslib.__assign({}, stableOptions), { returnPartialData: true, id: from, query: cache["getFragmentDoc"](fragment, fragmentName), optimistic: optimistic }));
+        });
         return {
             result: diffToResult(tslib.__assign(tslib.__assign({}, diff), { result: client["queryManager"].maskFragment({
                     fragment: fragment,
@@ -8588,17 +8785,19 @@ function useFragment_(options) {
     var getSnapshot = React__namespace.useCallback(function () { return diff.result; }, [diff]);
     return useSyncExternalStore(React__namespace.useCallback(function (forceUpdate) {
         var lastTimeout = 0;
-        var subscription = stableOptions.from === null ?
-            null
-            : client.watchFragment(stableOptions).subscribe({
-                next: function (result) {
-                    if (equal__default(result, diff.result))
-                        return;
-                    diff.result = result;
-                    clearTimeout(lastTimeout);
-                    lastTimeout = setTimeout(forceUpdate);
-                },
-            });
+        var subscription = muteDeprecations("canonizeResults", function () {
+            return stableOptions.from === null ?
+                null
+                : client.watchFragment(stableOptions).subscribe({
+                    next: function (result) {
+                        if (equal__default(result, diff.result))
+                            return;
+                        diff.result = result;
+                        clearTimeout(lastTimeout);
+                        lastTimeout = setTimeout(forceUpdate);
+                    },
+                });
+        });
         return function () {
             subscription === null || subscription === void 0 ? void 0 : subscription.unsubscribe();
             clearTimeout(lastTimeout);
@@ -8631,7 +8830,7 @@ function wrapQueryRef(internalQueryRef) {
     return ref;
 }
 function assertWrappedQueryRef(queryRef) {
-    invariant(!queryRef || QUERY_REFERENCE_SYMBOL in queryRef, 69);
+    invariant(!queryRef || QUERY_REFERENCE_SYMBOL in queryRef, 82);
 }
 function getWrappedPromise(queryRef) {
     var internalQueryRef = unwrapQueryRef(queryRef);
@@ -9044,6 +9243,9 @@ function useSuspenseQuery(query, options) {
     useSuspenseQuery_, useApolloClient(typeof options === "object" ? options.client : undefined))(query, options);
 }
 function useSuspenseQuery_(query, options) {
+    if (globalThis.__DEV__ !== false) {
+        useWarnRemovedOption(typeof options === "symbol" ? {} : options, "canonizeResults", "useSuspenseQuery");
+    }
     var client = useApolloClient(options.client);
     var suspenseCache = getSuspenseCache(client);
     var watchQueryOptions = useWatchQueryOptions({
@@ -9057,8 +9259,10 @@ function useSuspenseQuery_(query, options) {
         query,
         canonicalStringify(variables)
     ], [].concat(queryKey), true);
-    var queryRef = suspenseCache.getQueryRef(cacheKey, function () {
-        return client.watchQuery(watchQueryOptions);
+    var queryRef = muteDeprecations("canonizeResults", function () {
+        return suspenseCache.getQueryRef(cacheKey, function () {
+            return client.watchQuery(watchQueryOptions);
+        });
     });
     var _b = React__namespace.useState([queryRef.key, queryRef.promise]), current = _b[0], setPromise = _b[1];
     if (current[0] !== queryRef.key) {
@@ -9127,11 +9331,11 @@ function validateFetchPolicy(fetchPolicy) {
         "no-cache",
         "cache-and-network",
     ];
-    invariant(supportedFetchPolicies.includes(fetchPolicy), 66, fetchPolicy);
+    invariant(supportedFetchPolicies.includes(fetchPolicy), 79, fetchPolicy);
 }
 function validatePartialDataReturn(fetchPolicy, returnPartialData) {
     if (fetchPolicy === "no-cache" && returnPartialData) {
-        globalThis.__DEV__ !== false && invariant.warn(67);
+        globalThis.__DEV__ !== false && invariant.warn(80);
     }
 }
 function toApolloError(result) {
@@ -9166,6 +9370,9 @@ function useBackgroundQuery(query, options) {
     useBackgroundQuery_, useApolloClient(typeof options === "object" ? options.client : undefined))(query, options);
 }
 function useBackgroundQuery_(query, options) {
+    if (globalThis.__DEV__ !== false) {
+        useWarnRemovedOption(typeof options === "symbol" ? {} : options, "canonizeResults", "useBackgroundQuery");
+    }
     var client = useApolloClient(options.client);
     var suspenseCache = getSuspenseCache(client);
     var watchQueryOptions = useWatchQueryOptions({ client: client, query: query, options: options });
@@ -9177,8 +9384,10 @@ function useBackgroundQuery_(query, options) {
         query,
         canonicalStringify(variables)
     ], [].concat(queryKey), true);
-    var queryRef = suspenseCache.getQueryRef(cacheKey, function () {
-        return client.watchQuery(watchQueryOptions);
+    var queryRef = muteDeprecations("canonizeResults", function () {
+        return suspenseCache.getQueryRef(cacheKey, function () {
+            return client.watchQuery(watchQueryOptions);
+        });
     });
     var _b = React__namespace.useState(wrapQueryRef(queryRef)), wrappedQueryRef = _b[0], setWrappedQueryRef = _b[1];
     if (unwrapQueryRef(wrappedQueryRef) !== queryRef) {
@@ -9260,6 +9469,9 @@ function useSuspenseFragment_(options) {
 
 function useLoadableQuery(query, options) {
     if (options === void 0) { options = Object.create(null); }
+    if (globalThis.__DEV__ !== false) {
+        useWarnRemovedOption(options, "canonizeResults", "useLoadableQuery");
+    }
     var client = useApolloClient(options.client);
     var suspenseCache = getSuspenseCache(client);
     var watchQueryOptions = useWatchQueryOptions({ client: client, query: query, options: options });
@@ -9293,14 +9505,16 @@ function useLoadableQuery(query, options) {
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        invariant(!calledDuringRender(), 59);
+        invariant(!calledDuringRender(), 71);
         var variables = args[0];
         var cacheKey = tslib.__spreadArray([
             query,
             canonicalStringify(variables)
         ], [].concat(queryKey), true);
-        var queryRef = suspenseCache.getQueryRef(cacheKey, function () {
-            return client.watchQuery(tslib.__assign(tslib.__assign({}, watchQueryOptions), { variables: variables }));
+        var queryRef = muteDeprecations("canonizeResults", function () {
+            return suspenseCache.getQueryRef(cacheKey, function () {
+                return client.watchQuery(tslib.__assign(tslib.__assign({}, watchQueryOptions), { variables: variables }));
+            });
         });
         setQueryRef(wrapQueryRef(queryRef));
     }, [
@@ -9312,7 +9526,7 @@ function useLoadableQuery(query, options) {
         client,
     ]);
     var subscribeToMore = React__namespace.useCallback(function (options) {
-        invariant(internalQueryRef, 60);
+        invariant(internalQueryRef, 72);
         return internalQueryRef.observable.subscribeToMore(
         options);
     }, [internalQueryRef]);
@@ -9397,14 +9611,22 @@ function createQueryPreloader(client) {
     return wrapHook("createQueryPreloader", _createQueryPreloader, client)(client);
 }
 var _createQueryPreloader = function (client) {
-    return function preloadQuery(query, options) {
-        var _a, _b;
+    function preloadQuery(query, options) {
         if (options === void 0) { options = Object.create(null); }
-        var queryRef = new InternalQueryReference(client.watchQuery(tslib.__assign(tslib.__assign({}, options), { query: query })), {
-            autoDisposeTimeoutMs: (_b = (_a = client.defaultOptions.react) === null || _a === void 0 ? void 0 : _a.suspense) === null || _b === void 0 ? void 0 : _b.autoDisposeTimeoutMs,
+        warnRemovedOption(options, "canonizeResults", "preloadQuery");
+        var queryRef = muteDeprecations("canonizeResults", function () {
+            var _a, _b;
+            return new InternalQueryReference(client.watchQuery(tslib.__assign(tslib.__assign({}, options), { query: query })), {
+                autoDisposeTimeoutMs: (_b = (_a = client.defaultOptions.react) === null || _a === void 0 ? void 0 : _a.suspense) === null || _b === void 0 ? void 0 : _b.autoDisposeTimeoutMs,
+            });
         });
         return wrapQueryRef(queryRef);
-    };
+    }
+    return Object.assign(preloadQuery, {
+        toPromise: function (queryRef) {
+            return queryRef.toPromise();
+        },
+    });
 };
 
 exports.setLogVerbosity = tsInvariant.setVerbosity;