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

package/__cjs/core/ApolloClient.cjs

@@ -4,17 +4,14 @@ const {
 } = require("@apollo/client/utilities/environment");
 
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApolloClient = exports.mergeOptions = void 0;
+exports.ApolloClient = void 0;
+const graphql_1 = require("graphql");
 const rxjs_1 = require("rxjs");
-const core_1 = require("@apollo/client/link/core");
-const http_1 = require("@apollo/client/link/http");
-const utilities_1 = require("@apollo/client/utilities");
-Object.defineProperty(exports, "mergeOptions", { enumerable: true, get: function () { return utilities_1.mergeOptions; } });
+const link_1 = require("@apollo/client/link");
 const environment_1 = require("@apollo/client/utilities/environment");
 const internal_1 = require("@apollo/client/utilities/internal");
 const invariant_1 = require("@apollo/client/utilities/invariant");
 const version_js_1 = require("../version.cjs");
-const LocalState_js_1 = require("./LocalState.cjs");
 const QueryManager_js_1 = require("./QueryManager.cjs");
 let hasSuggestedDevtools = false;
 /**
@@ -26,17 +23,31 @@ let hasSuggestedDevtools = false;
 class ApolloClient {
     link;
     cache;
+    /**
+     * @deprecated `disableNetworkFetches` has been renamed to `prioritizeCacheValues`.
+     */
     disableNetworkFetches;
+    set prioritizeCacheValues(value) {
+        this.queryManager.prioritizeCacheValues = value;
+    }
+    /**
+     * Whether to prioritize cache values over network results when `query` or `watchQuery` is called.
+     * This will essentially turn a `"network-only"` or `"cache-and-network"` fetchPolicy into a `"cache-first"` fetchPolicy,
+     * but without influencing the `fetchPolicy` of the created `ObservableQuery` long-term.
+     *
+     * This can e.g. be used to prioritize the cache during the first render after SSR.
+     */
+    get prioritizeCacheValues() {
+        return this.queryManager.prioritizeCacheValues;
+    }
     version;
     queryDeduplication;
     defaultOptions;
-    typeDefs;
     devtoolsConfig;
     queryManager;
     devToolsHookCb;
     resetStoreCallbacks = [];
     clearStoreCallbacks = [];
-    localState;
     /**
      * Constructs an instance of `ApolloClient`.
      *
@@ -64,25 +75,19 @@ class ApolloClient {
      * ```
      */
     constructor(options) {
-        if (!options.cache) {
-            throw (0, invariant_1.newInvariantError)(62);
+        if (environment_1.__DEV__) {
+            (0, invariant_1.invariant)(options.cache, 67);
+            (0, invariant_1.invariant)(options.link, 68);
         }
-        const { uri, credentials, headers, cache, documentTransform, ssrMode = false, ssrForceFetchDelay = 0, 
+        const { cache, documentTransform, ssrMode = false, ssrForceFetchDelay = 0, 
         // Expose the client instance as window.__APOLLO_CLIENT__ and call
         // onBroadcast in queryManager.broadcastQueries to enable browser
         // devtools, but disable them by default in production.
-        connectToDevTools, queryDeduplication = true, defaultOptions, defaultContext, assumeImmutableResults = cache.assumeImmutableResults, resolvers, typeDefs, fragmentMatcher, name: clientAwarenessName, version: clientAwarenessVersion, devtools, dataMasking, } = options;
-        let { link } = options;
-        if (!link) {
-            link =
-                uri ? new http_1.HttpLink({ uri, credentials, headers }) : core_1.ApolloLink.empty();
-        }
+        connectToDevTools, queryDeduplication = true, defaultOptions, defaultContext, assumeImmutableResults = cache.assumeImmutableResults, localState, name: clientAwarenessName, version: clientAwarenessVersion, devtools, dataMasking, link, } = options;
         this.link = link;
         this.cache = cache;
-        this.disableNetworkFetches = ssrMode || ssrForceFetchDelay > 0;
         this.queryDeduplication = queryDeduplication;
         this.defaultOptions = defaultOptions || {};
-        this.typeDefs = typeDefs;
         this.devtoolsConfig = {
             ...devtools,
             enabled: devtools?.enabled ?? connectToDevTools,
@@ -90,9 +95,6 @@ class ApolloClient {
         if (this.devtoolsConfig.enabled === undefined) {
             this.devtoolsConfig.enabled = environment_1.__DEV__;
         }
-        if (ssrForceFetchDelay) {
-            setTimeout(() => (this.disableNetworkFetches = false), ssrForceFetchDelay);
-        }
         this.watchQuery = this.watchQuery.bind(this);
         this.query = this.query.bind(this);
         this.mutate = this.mutate.bind(this);
@@ -100,15 +102,8 @@ class ApolloClient {
         this.resetStore = this.resetStore.bind(this);
         this.reFetchObservableQueries = this.reFetchObservableQueries.bind(this);
         this.version = version_js_1.version;
-        this.localState = new LocalState_js_1.LocalState({
-            cache,
-            client: this,
-            resolvers,
-            fragmentMatcher,
-        });
         this.queryManager = new QueryManager_js_1.QueryManager({
-            cache: this.cache,
-            link: this.link,
+            client: this,
             defaultOptions: this.defaultOptions,
             defaultContext,
             documentTransform,
@@ -119,7 +114,6 @@ class ApolloClient {
                 name: clientAwarenessName,
                 version: clientAwarenessVersion,
             },
-            localState: this.localState,
             assumeImmutableResults,
             onBroadcast: this.devtoolsConfig.enabled ?
                 () => {
@@ -128,7 +122,14 @@ class ApolloClient {
                     }
                 }
                 : void 0,
+            localState,
         });
+        this.prioritizeCacheValues = ssrMode || ssrForceFetchDelay > 0;
+        if (ssrForceFetchDelay) {
+            setTimeout(() => {
+                this.prioritizeCacheValues = false;
+            }, ssrForceFetchDelay);
+        }
         if (this.devtoolsConfig.enabled)
             this.connectToDevTools();
     }
@@ -182,6 +183,16 @@ class ApolloClient {
     get documentTransform() {
         return this.queryManager.documentTransform;
     }
+    /**
+     * The configured `LocalState` instance used to enable the use of `@client`
+     * fields.
+     */
+    get localState() {
+        return this.queryManager.localState;
+    }
+    set localState(localState) {
+        this.queryManager.localState = localState;
+    }
     /**
      * Call this method to terminate any active client processes, making it safe
      * to dispose of this `ApolloClient` instance.
@@ -210,13 +221,7 @@ class ApolloClient {
      */
     watchQuery(options) {
         if (this.defaultOptions.watchQuery) {
-            options = (0, utilities_1.mergeOptions)(this.defaultOptions.watchQuery, options);
-        }
-        // XXX Overwriting options is probably not the best way to do this long term...
-        if (this.disableNetworkFetches &&
-            (options.fetchPolicy === "network-only" ||
-                options.fetchPolicy === "cache-and-network")) {
-            options = { ...options, fetchPolicy: "cache-first" };
+            options = (0, internal_1.mergeOptions)(this.defaultOptions.watchQuery, options);
         }
         return this.queryManager.watchQuery(options);
     }
@@ -231,11 +236,17 @@ class ApolloClient {
      */
     query(options) {
         if (this.defaultOptions.query) {
-            options = (0, utilities_1.mergeOptions)(this.defaultOptions.query, options);
+            options = (0, internal_1.mergeOptions)(this.defaultOptions.query, options);
         }
-        (0, invariant_1.invariant)(options.fetchPolicy !== "cache-and-network", 63);
-        if (this.disableNetworkFetches && options.fetchPolicy === "network-only") {
-            options = { ...options, fetchPolicy: "cache-first" };
+        if (environment_1.__DEV__) {
+            (0, invariant_1.invariant)(options.fetchPolicy !== "cache-and-network", 69);
+            (0, invariant_1.invariant)(options.fetchPolicy !== "standby", 70);
+            (0, invariant_1.invariant)(options.query, 71);
+            (0, invariant_1.invariant)(options.query.kind === "Document", 72);
+            (0, invariant_1.invariant)(!options.returnPartialData, 73);
+            (0, invariant_1.invariant)(!options.pollInterval, 74);
+            (0, invariant_1.invariant)(!options.notifyOnNetworkStatusChange, 75);
+            (0, internal_1.checkDocument)(options.query, graphql_1.OperationTypeNode.QUERY);
         }
         return this.queryManager.query(options);
     }
@@ -249,7 +260,7 @@ class ApolloClient {
      */
     mutate(options) {
         if (this.defaultOptions.mutate) {
-            options = (0, utilities_1.mergeOptions)(this.defaultOptions.mutate, options);
+            options = (0, internal_1.mergeOptions)(this.defaultOptions.mutate, options);
         }
         return this.queryManager.mutate(options);
     }
@@ -258,16 +269,18 @@ class ApolloClient {
      * `Observable` which either emits received data or an error.
      */
     subscribe(options) {
-        const id = this.queryManager.generateQueryId();
-        return this.queryManager.startGraphQLSubscription(options).pipe((0, rxjs_1.map)((result) => ({
+        const cause = {};
+        const observable = this.queryManager.startGraphQLSubscription(options);
+        const mapped = observable.pipe((0, rxjs_1.map)((result) => ({
             ...result,
             data: this.queryManager.maskOperation({
                 document: options.query,
                 data: result.data,
                 fetchPolicy: options.fetchPolicy,
-                id,
+                cause,
             }),
         })));
+        return Object.assign(mapped, { restart: observable.restart });
     }
     /**
      * Tries to read some data from the store in the shape of the provided
@@ -354,7 +367,7 @@ class ApolloClient {
         this.devToolsHookCb = cb;
     }
     __requestRaw(payload) {
-        return (0, core_1.execute)(this.link, payload);
+        return (0, link_1.execute)(this.link, payload, { client: this });
     }
     /**
      * Resets your entire store by clearing out your cache and then re-executing
@@ -426,7 +439,7 @@ class ApolloClient {
      * Takes optional parameter `includeStandby` which will include queries in standby-mode when refetching.
      */
     reFetchObservableQueries(includeStandby) {
-        return this.queryManager.reFetchObservableQueries(includeStandby);
+        return this.queryManager.refetchObservableQueries(includeStandby);
     }
     /**
      * Refetches specified active queries. Similar to "reFetchObservableQueries()" but with a specific list of queries.
@@ -456,7 +469,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(64, error);
+            __DEV__ && invariant_1.invariant.debug(76, error);
         });
         return result;
     }
@@ -490,35 +503,11 @@ class ApolloClient {
     restore(serializedState) {
         return this.cache.restore(serializedState);
     }
-    /**
-     * Add additional local resolvers.
-     */
-    addResolvers(resolvers) {
-        this.localState.addResolvers(resolvers);
-    }
-    /**
-     * Set (override existing) local resolvers.
-     */
-    setResolvers(resolvers) {
-        this.localState.setResolvers(resolvers);
-    }
-    /**
-     * Get all registered local resolvers.
-     */
-    getResolvers() {
-        return this.localState.getResolvers();
-    }
-    /**
-     * Set a custom local state fragment matcher.
-     */
-    setLocalStateFragmentMatcher(fragmentMatcher) {
-        this.localState.setFragmentMatcher(fragmentMatcher);
-    }
     /**
      * Define a new ApolloLink (or link chain) that Apollo Client will use.
      */
     setLink(newLink) {
-        this.link = this.queryManager.link = newLink;
+        this.link = newLink;
     }
     get defaultContext() {
         return this.queryManager.defaultContext;
@@ -539,7 +528,6 @@ class ApolloClient {
      * ```json
      *{
      *  limits:     {
-     *    parser: 1000,
      *    canonicalStringify: 1000,
      *    print: 2000,
      *    'documentTransform.cache': 2000,
@@ -555,7 +543,6 @@ class ApolloClient {
      *    'inMemoryCache.executeSubSelectedArray': 5000
      *  },
      *  sizes: {
-     *    parser: 26,
      *    canonicalStringify: 4,
      *    print: 14,
      *    addTypenameDocumentTransform: [