@apollo/client 4.2.0-alpha.2 → 4.2.0-alpha.4

package/__cjs/cache/inmemory/key-extractor.cjs

@@ -41,7 +41,7 @@ function keyFieldsFnFromSpecifier(specifier) {
                     // context.readField for this extraction.
                     extracted = extractKeyPath(object, schemaKeyPath, extractKey);
                 }
-                (0, invariant_1.invariant)(extracted !== void 0, 102, schemaKeyPath.join("."), object);
+                (0, invariant_1.invariant)(extracted !== void 0, 107, schemaKeyPath.join("."), object);
                 return extracted;
             }));
             return `${context.typename}:${JSON.stringify(keyObject)}`;

package/__cjs/cache/inmemory/policies.cjs

@@ -229,7 +229,7 @@ class Policies {
         const rootId = "ROOT_" + which.toUpperCase();
         const old = this.rootTypenamesById[rootId];
         if (typename !== old) {
-            (0, invariant_1.invariant)(!old || old === which, 103, which);
+            (0, invariant_1.invariant)(!old || old === which, 108, which);
             // First, delete any old __typename associated with this rootId from
             // rootIdsByTypename.
             if (old)
@@ -372,7 +372,7 @@ class Policies {
                 if (supertypeSet.has(supertype)) {
                     if (!typenameSupertypeSet.has(supertype)) {
                         if (checkingFuzzySubtypes) {
-                            __DEV__ && invariant_1.invariant.warn(104, typename, supertype);
+                            __DEV__ && invariant_1.invariant.warn(109, typename, supertype);
                         }
                         // Record positive results for faster future lookup.
                         // Unfortunately, we cannot safely cache negative results,
@@ -625,7 +625,7 @@ function normalizeReadFieldOptions(readFieldArgs, objectOrReference, variables)
         }
     }
     if (environment_1.__DEV__ && options.from === void 0) {
-        __DEV__ && invariant_1.invariant.warn(105, (0, internal_2.stringifyForDisplay)(Array.from(readFieldArgs)));
+        __DEV__ && invariant_1.invariant.warn(110, (0, internal_2.stringifyForDisplay)(Array.from(readFieldArgs)));
     }
     if (void 0 === options.variables) {
         options.variables = variables;
@@ -635,7 +635,7 @@ function normalizeReadFieldOptions(readFieldArgs, objectOrReference, variables)
 function makeMergeObjectsFunction(store) {
     return function mergeObjects(existing, incoming) {
         if ((0, internal_2.isArray)(existing) || (0, internal_2.isArray)(incoming)) {
-            throw (0, invariant_1.newInvariantError)(106);
+            throw (0, invariant_1.newInvariantError)(111);
         }
         // These dynamic checks are necessary because the parameters of a
         // custom merge function can easily have the any type, so the type

package/__cjs/cache/inmemory/readFromStore.cjs

@@ -197,7 +197,7 @@ class StoreReader {
             else {
                 const fragment = (0, internal_1.getFragmentFromSelection)(selection, context.lookupFragment);
                 if (!fragment && selection.kind === graphql_1.Kind.FRAGMENT_SPREAD) {
-                    throw (0, invariant_1.newInvariantError)(107, selection.name.value);
+                    throw (0, invariant_1.newInvariantError)(112, selection.name.value);
                 }
                 if (fragment && policies.fragmentMatches(fragment, typename)) {
                     fragment.selectionSet.selections.forEach(workSet.add, workSet);
@@ -281,7 +281,7 @@ function assertSelectionSetForIdValue(store, field, fieldValue) {
             if ((0, internal_1.isNonNullObject)(value)) {
                 (0, invariant_1.invariant)(
                     !(0, utilities_1.isReference)(value),
-                    108,
+                    113,
                     (0, helpers_js_1.getTypenameFromStoreObject)(store, value),
                     field.name.value
                 );

package/__cjs/cache/inmemory/writeToStore.cjs

@@ -75,7 +75,7 @@ class StoreWriter {
             path: [],
         });
         if (!(0, utilities_1.isReference)(ref)) {
-            throw (0, invariant_1.newInvariantError)(109, result);
+            throw (0, invariant_1.newInvariantError)(114, result);
         }
         // So far, the store has not been modified, so now it's time to process
         // context.incomingById and merge those incoming fields into context.store.
@@ -237,7 +237,7 @@ class StoreWriter {
                 // provide a default value, so its absence from the written data should
                 // not be cause for alarm.
                 !policies.getReadFunction(typename, field.name.value)) {
-                invariant_1.invariant.error(110, (0, internal_1.resultKeyNameFromField)(field), result);
+                invariant_1.invariant.error(115, (0, internal_1.resultKeyNameFromField)(field), result);
             }
         });
         // Identify the result object, even if dataId was already provided,
@@ -385,7 +385,7 @@ class StoreWriter {
                 else {
                     const fragment = (0, internal_1.getFragmentFromSelection)(selection, context.lookupFragment);
                     if (!fragment && selection.kind === graphql_1.Kind.FRAGMENT_SPREAD) {
-                        throw (0, invariant_1.newInvariantError)(111, selection.name.value);
+                        throw (0, invariant_1.newInvariantError)(116, selection.name.value);
                     }
                     if (fragment &&
                         policies.fragmentMatches(fragment, typename, result, context.variables)) {
@@ -558,7 +558,7 @@ function warnAboutDataLoss(existingRef, incomingObj, storeFieldName, store) {
             }
         });
     }
-    __DEV__ && invariant_1.invariant.warn(112, fieldName, parentType, childTypenames.length ?
+    __DEV__ && invariant_1.invariant.warn(117, fieldName, parentType, childTypenames.length ?
         "either ensure all objects of type " +
             childTypenames.join(" and ") +
             " have an ID or a custom merge function, or "

package/__cjs/core/ApolloClient.cjs

@@ -46,6 +46,7 @@ class ApolloClient {
     queryDeduplication;
     defaultOptions;
     devtoolsConfig;
+    refetchEventManager;
     queryManager;
     devToolsHookCb;
     resetStoreCallbacks = [];
@@ -80,7 +81,7 @@ class ApolloClient {
             (0, invariant_1.invariant)(options.cache, 68);
             (0, invariant_1.invariant)(options.link, 69);
         }
-        const { cache, documentTransform, ssrMode = false, ssrForceFetchDelay = 0, queryDeduplication = true, defaultOptions, defaultContext, assumeImmutableResults = cache.assumeImmutableResults, localState, devtools, dataMasking, link, incrementalHandler = new incremental_1.NotImplementedHandler(), experiments = [], } = options;
+        const { cache, documentTransform, ssrMode = false, ssrForceFetchDelay = 0, queryDeduplication = true, defaultOptions, defaultContext, assumeImmutableResults = cache.assumeImmutableResults, localState, devtools, dataMasking, link, incrementalHandler = new incremental_1.NotImplementedHandler(), experiments = [], refetchEventManager, } = options;
         this.link = link;
         this.cache = cache;
         this.queryDeduplication = queryDeduplication;
@@ -130,6 +131,8 @@ class ApolloClient {
         if (this.devtoolsConfig.enabled)
             this.connectToDevTools();
         experiments.forEach((experiment) => experiment.call(this, options));
+        this.refetchEventManager = refetchEventManager;
+        this.refetchEventManager?.connect(this);
     }
     connectToDevTools() {
         if (typeof window === "undefined") {
@@ -200,9 +203,11 @@ class ApolloClient {
      * - Unsubscribes all active `ObservableQuery` instances by emitting a `completed` event
      * - Rejects all currently running queries with "QueryManager stopped while query was in flight"
      * - Removes all queryRefs from the suspense cache
+     * - Disconnects the `RefetchEventManager` if configured.
      */
     stop() {
         this.queryManager.stop();
+        this.refetchEventManager?.disconnect(this);
     }
     /**
      * This watches the cache store of the query according to the options specified and
@@ -225,7 +230,34 @@ class ApolloClient {
      */
     watchQuery(options) {
         if (this.defaultOptions.watchQuery) {
+            const defaultRefetchOn = this.defaultOptions.watchQuery.refetchOn;
+            const mergedRefetchOn = (options.refetchOn &&
+                typeof options.refetchOn === "object" &&
+                defaultRefetchOn &&
+                typeof defaultRefetchOn === "object") ?
+                { ...defaultRefetchOn, ...options.refetchOn }
+                : undefined;
             options = (0, internal_1.mergeOptions)(this.defaultOptions.watchQuery, options);
+            if (mergedRefetchOn) {
+                options.refetchOn = mergedRefetchOn;
+            }
+        }
+        if (environment_1.__DEV__) {
+            const { refetchOn, query } = options;
+            const { refetchEventManager } = this;
+            if (refetchOn) {
+                const operationName = (0, internal_1.getOperationName)(query, "(anonymous)");
+                if (!refetchEventManager) {
+                    __DEV__ && invariant_1.invariant.warn(70, operationName);
+                }
+                else if (typeof refetchOn === "object") {
+                    Object.keys(refetchOn).forEach((source) => {
+                        if (!refetchEventManager.hasSource(source)) {
+                            __DEV__ && invariant_1.invariant.warn(71, source, operationName);
+                        }
+                    });
+                }
+            }
         }
         return this.queryManager.watchQuery(options);
     }
@@ -243,37 +275,37 @@ class ApolloClient {
             options = (0, internal_1.mergeOptions)(this.defaultOptions.query, options);
         }
         if (environment_1.__DEV__) {
-            (0, invariant_1.invariant)(options.fetchPolicy !== "cache-and-network", 70);
-            (0, invariant_1.invariant)(options.fetchPolicy !== "standby", 71);
-            (0, invariant_1.invariant)(options.query, 72);
-            (0, invariant_1.invariant)(options.query.kind === "Document", 73);
-            (0, invariant_1.invariant)(!options.returnPartialData, 74);
-            (0, invariant_1.invariant)(!options.pollInterval, 75);
-            (0, invariant_1.invariant)(!options.notifyOnNetworkStatusChange, 76);
+            (0, invariant_1.invariant)(options.fetchPolicy !== "cache-and-network", 72);
+            (0, invariant_1.invariant)(options.fetchPolicy !== "standby", 73);
+            (0, invariant_1.invariant)(options.query, 74);
+            (0, invariant_1.invariant)(options.query.kind === "Document", 75);
+            (0, invariant_1.invariant)(!options.returnPartialData, 76);
+            (0, invariant_1.invariant)(!options.pollInterval, 77);
+            (0, invariant_1.invariant)(!options.notifyOnNetworkStatusChange, 78);
         }
         return this.queryManager.query(options);
     };
     /**
-     * This resolves a single mutation according to the options specified and returns a
-     * Promise which is either resolved with the resulting data or rejected with an
-     * error. In some cases both `data` and `errors` might be undefined, for example
-     * when `errorPolicy` is set to `'ignore'`.
-     *
-     * It takes options as an object with the following keys and values:
-     */
-    mutate(options) {
+    * This resolves a single mutation according to the options specified and returns a
+    * Promise which is either resolved with the resulting data or rejected with an
+    * error. In some cases both `data` and `errors` might be undefined, for example
+    * when `errorPolicy` is set to `'ignore'`.
+    * 
+    * It takes options as an object with the following keys and values:
+    */
+    mutate = (options) => {
         const optionsWithDefaults = (0, internal_1.mergeOptions)((0, internal_1.compact)({
             fetchPolicy: "network-only",
             errorPolicy: "none",
         }, this.defaultOptions.mutate), options);
         if (environment_1.__DEV__) {
-            (0, invariant_1.invariant)(optionsWithDefaults.mutation, 77);
+            (0, invariant_1.invariant)(optionsWithDefaults.mutation, 79);
             (0, invariant_1.invariant)(optionsWithDefaults.fetchPolicy === "network-only" ||
-                optionsWithDefaults.fetchPolicy === "no-cache", 78);
+                optionsWithDefaults.fetchPolicy === "no-cache", 80);
         }
         (0, internal_1.checkDocument)(optionsWithDefaults.mutation, graphql_1.OperationTypeNode.MUTATION);
         return this.queryManager.mutate(optionsWithDefaults);
-    }
+    };
     /**
      * This subscribes to a graphql subscription according to the options specified and returns an
      * `Observable` which either emits received data or an error.
@@ -475,7 +507,7 @@ class ApolloClient {
         // result.queries and result.results instead, you shouldn't have to worry
         // about preventing uncaught rejections for the Promise.all result.
         result.catch((error) => {
-            __DEV__ && invariant_1.invariant.debug(79, error);
+            __DEV__ && invariant_1.invariant.debug(81, error);
         });
         return result;
     }