@apollo/client 3.10.0-alpha.1 → 3.10.0-rc.1

package/.changeset/chatty-llamas-switch.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Adds `createMockFetch` utility for integration testing that includes the link chain

package/.changeset/cold-dancers-call.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+`createTestSchema` now uses graphql-tools `mergeResolvers` to merge resolvers instead of a shallow merge.

package/.changeset/green-garlics-protect.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Rename `createProxiedSchema` to `createTestSchema` and `createMockFetch` to `createSchemaFetch`.

package/.changeset/hungry-bobcats-battle.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Adjust `useReadQuery` wrapper logic to work with transported objects.

package/.changeset/kind-foxes-float.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Wrap `useQueryRefHandlers` in `wrapHook`.

package/.changeset/old-onions-sleep.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Export `WatchFragmentOptions` and `WatchFragmentResult` from main entrypoint and fix bug where `this` wasn't bound to the `watchFragment` method on `ApolloClient`.

package/.changeset/pre.json

@@ -1,11 +1,22 @@
 {
   "mode": "pre",
-  "tag": "alpha",
+  "tag": "rc",
   "initialVersions": {
     "@apollo/client": "3.9.7"
   },
   "changesets": [
-    "flat-singers-kiss",
-    "tasty-pillows-ring"
+    "chatty-llamas-switch",
+    "cold-dancers-call",
+    "green-garlics-protect",
+    "hungry-bobcats-battle",
+    "kind-foxes-float",
+    "old-onions-sleep",
+    "spotty-garlics-knock",
+    "strong-paws-kneel",
+    "stupid-bears-cheat",
+    "tasty-pillows-ring",
+    "tiny-bugs-tap",
+    "twelve-apples-vanish",
+    "wet-plants-admire"
   ]
 }

package/.changeset/spotty-garlics-knock.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Call `createMockSchema` inside `createTestSchema`.

package/.changeset/strong-paws-kneel.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Add ability to set min and max delay in `createSchemaFetch`

package/.changeset/stupid-bears-cheat.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Adds proxiedSchema and createMockSchema testing utilities

package/.changeset/tiny-bugs-tap.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Remove alpha designation for `queryRef.toPromise()` to stabilize the API.

package/.changeset/twelve-apples-vanish.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Remove alpha designation for `createQueryPreloader` to stabilize the API.

package/.changeset/wet-plants-admire.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Moves new testing utilities to their own entrypoint, `testing/experimental`

package/CHANGELOG.md

@@ -1,10 +1,38 @@
 # @apollo/client
 
-## 3.10.0-alpha.1
+## 3.10.0-rc.1
+
+### Minor Changes
+
+- [#11760](https://github.com/apollographql/apollo-client/pull/11760) [`acd1982`](https://github.com/apollographql/apollo-client/commit/acd1982a59ed66fc44fa9e70b08a31c69dac35a6) Thanks [@alessbell](https://github.com/alessbell)! - `createTestSchema` now uses graphql-tools `mergeResolvers` to merge resolvers instead of a shallow merge.
+
+- [#11764](https://github.com/apollographql/apollo-client/pull/11764) [`f046aa9`](https://github.com/apollographql/apollo-client/commit/f046aa9fc24ac197a797045d280811a3bbe05806) Thanks [@alessbell](https://github.com/alessbell)! - Rename `createProxiedSchema` to `createTestSchema` and `createMockFetch` to `createSchemaFetch`.
+
+- [#11777](https://github.com/apollographql/apollo-client/pull/11777) [`5dfc79f`](https://github.com/apollographql/apollo-client/commit/5dfc79fa6d974362f38361f7dffbe984a9546377) Thanks [@alessbell](https://github.com/alessbell)! - Call `createMockSchema` inside `createTestSchema`.
+
+- [#11774](https://github.com/apollographql/apollo-client/pull/11774) [`2583488`](https://github.com/apollographql/apollo-client/commit/2583488677912cb4500e5fb9e3f91b5c113c4cdb) Thanks [@alessbell](https://github.com/alessbell)! - Add ability to set min and max delay in `createSchemaFetch`
+
+- [#11783](https://github.com/apollographql/apollo-client/pull/11783) [`440563a`](https://github.com/apollographql/apollo-client/commit/440563ab2c47efcb9c7d08f52531ade33d753037) Thanks [@alessbell](https://github.com/alessbell)! - Moves new testing utilities to their own entrypoint, `testing/experimental`
 
 ### Patch Changes
 
-- [#11689](https://github.com/apollographql/apollo-client/pull/11689) [`cb8ffe5`](https://github.com/apollographql/apollo-client/commit/cb8ffe50e903397f741b62a44624bfe69b5f7b75) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix issue where passing a new `from` option to `useFragment` would first render with the previous value before rerendering with the correct value.
+- [#11757](https://github.com/apollographql/apollo-client/pull/11757) [`9825295`](https://github.com/apollographql/apollo-client/commit/982529530893f66a1d236f0fff53862e513fc9a8) Thanks [@phryneas](https://github.com/phryneas)! - Adjust `useReadQuery` wrapper logic to work with transported objects.
+
+- [#11771](https://github.com/apollographql/apollo-client/pull/11771) [`e72cbba`](https://github.com/apollographql/apollo-client/commit/e72cbba07e5caa6d75b44ca8c766846e855a6c93) Thanks [@phryneas](https://github.com/phryneas)! - Wrap `useQueryRefHandlers` in `wrapHook`.
+
+- [#11754](https://github.com/apollographql/apollo-client/pull/11754) [`80d2ba5`](https://github.com/apollographql/apollo-client/commit/80d2ba579fe6d2a2d102d1fe79d7d503f31cd931) Thanks [@alessbell](https://github.com/alessbell)! - Export `WatchFragmentOptions` and `WatchFragmentResult` from main entrypoint and fix bug where `this` wasn't bound to the `watchFragment` method on `ApolloClient`.
+
+## 3.10.0-rc.0
+
+### Minor Changes
+
+- [#11605](https://github.com/apollographql/apollo-client/pull/11605) [`e2dd4c9`](https://github.com/apollographql/apollo-client/commit/e2dd4c95290cea604b548cc446826d89aafe8e11) Thanks [@alessbell](https://github.com/alessbell)! - Adds `createMockFetch` utility for integration testing that includes the link chain
+
+- [#11605](https://github.com/apollographql/apollo-client/pull/11605) [`e2dd4c9`](https://github.com/apollographql/apollo-client/commit/e2dd4c95290cea604b548cc446826d89aafe8e11) Thanks [@alessbell](https://github.com/alessbell)! - Adds proxiedSchema and createMockSchema testing utilities
+
+- [#11743](https://github.com/apollographql/apollo-client/pull/11743) [`78891f9`](https://github.com/apollographql/apollo-client/commit/78891f9ec81c0b7a7e010f5550a91965fa33a958) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Remove alpha designation for `queryRef.toPromise()` to stabilize the API.
+
+- [#11743](https://github.com/apollographql/apollo-client/pull/11743) [`78891f9`](https://github.com/apollographql/apollo-client/commit/78891f9ec81c0b7a7e010f5550a91965fa33a958) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Remove alpha designation for `createQueryPreloader` to stabilize the API.
 
 ## 3.10.0-alpha.0
 
@@ -12,6 +40,40 @@
 
 - [#11465](https://github.com/apollographql/apollo-client/pull/11465) [`7623da7`](https://github.com/apollographql/apollo-client/commit/7623da7720855b0c19e13ff9124679f426a39725) Thanks [@alessbell](https://github.com/alessbell)! - Add `watchFragment` method to the cache and expose it on ApolloClient, refactor `useFragment` using `watchFragment`.
 
+## 3.9.11
+
+### Patch Changes
+
+- [#11769](https://github.com/apollographql/apollo-client/pull/11769) [`04132af`](https://github.com/apollographql/apollo-client/commit/04132af121c9b48d6e03eb733b9b91f825defbac) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix an issue where using `skipToken` or the `skip` option with `useSuspenseQuery` in React's strict mode would perform a network request.
+
+## 3.9.10
+
+### Patch Changes
+
+- [#11738](https://github.com/apollographql/apollo-client/pull/11738) [`b1a5eb8`](https://github.com/apollographql/apollo-client/commit/b1a5eb80cae8bdf2e9d8627f1eab65e088c43438) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix an issue where rerendering `useBackgroundQuery` after the `queryRef` had been disposed, either via the auto dispose timeout or by unmounting `useReadQuery`, would cause the `queryRef` to be recreated potentially resulting in another network request.
+
+- [#11738](https://github.com/apollographql/apollo-client/pull/11738) [`b1a5eb8`](https://github.com/apollographql/apollo-client/commit/b1a5eb80cae8bdf2e9d8627f1eab65e088c43438) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Allow queryRefs to be disposed of synchronously when a suspense hook unmounts. This prevents some situations where using a suspense hook with the same query/variables as the disposed queryRef accidentally used the disposed queryRef rather than creating a new instance.
+
+- [#11670](https://github.com/apollographql/apollo-client/pull/11670) [`cc5c03b`](https://github.com/apollographql/apollo-client/commit/cc5c03b2690f452483d83eecb68611a23055d99e) Thanks [@phryneas](https://github.com/phryneas)! - Bail out of `executeSubSelectedArray` calls if the array has 0 elements.
+
+## 3.9.9
+
+### Patch Changes
+
+- [#11696](https://github.com/apollographql/apollo-client/pull/11696) [`466ef82`](https://github.com/apollographql/apollo-client/commit/466ef82198486fc696da64d17d82b46140760ac4) Thanks [@PiR1](https://github.com/PiR1)! - Immediately dispose of the `queryRef` if `useBackgroundQuery` unmounts before the auto dispose timeout kicks in.
+
+## 3.9.8
+
+### Patch Changes
+
+- [#11706](https://github.com/apollographql/apollo-client/pull/11706) [`8619bc7`](https://github.com/apollographql/apollo-client/commit/8619bc7e569c1c732afa6faf605c83a6ce0cdf0c) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix issue in all suspense hooks where returning an empty array after calling `fetchMore` would rerender the component with an empty list.
+
+- [#11694](https://github.com/apollographql/apollo-client/pull/11694) [`835d5f3`](https://github.com/apollographql/apollo-client/commit/835d5f30c532c432e2434561580e6f1ec44cc908) Thanks [@phryneas](https://github.com/phryneas)! - Expose `setErrorMessageHandler` from `@apollo/client/dev` entrypoint.
+
+- [#11689](https://github.com/apollographql/apollo-client/pull/11689) [`cb8ffe5`](https://github.com/apollographql/apollo-client/commit/cb8ffe50e903397f741b62a44624bfe69b5f7b75) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix issue where passing a new `from` option to `useFragment` would first render with the previous value before rerendering with the correct value.
+
+- [#11713](https://github.com/apollographql/apollo-client/pull/11713) [`642092c`](https://github.com/apollographql/apollo-client/commit/642092c713199093aede45f105a1ee3f637614cd) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fix issue where setting a default `watchQuery` option in the `ApolloClient` constructor could break `startTransition` when used with suspense hooks.
+
 ## 3.9.7
 
 ### Patch Changes

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.10.0-alpha.1";
+var version = "3.10.0-rc.1";
 
 function maybe(thunk) {
     try {
@@ -3345,12 +3345,14 @@ var StoreReader =  (function () {
                     }
                 }
                 else if (isArray(fieldValue)) {
-                    fieldValue = handleMissing(_this.executeSubSelectedArray({
-                        field: selection,
-                        array: fieldValue,
-                        enclosingRef: enclosingRef,
-                        context: context,
-                    }), resultName);
+                    if (fieldValue.length > 0) {
+                        fieldValue = handleMissing(_this.executeSubSelectedArray({
+                            field: selection,
+                            array: fieldValue,
+                            enclosingRef: enclosingRef,
+                            context: context,
+                        }), resultName);
+                    }
                 }
                 else if (!selection.selectionSet) {
                     if (context.canonizeResults) {
@@ -6966,6 +6968,7 @@ var ApolloClient =  (function () {
         this.watchQuery = this.watchQuery.bind(this);
         this.query = this.query.bind(this);
         this.mutate = this.mutate.bind(this);
+        this.watchFragment = this.watchFragment.bind(this);
         this.resetStore = this.resetStore.bind(this);
         this.reFetchObservableQueries = this.reFetchObservableQueries.bind(this);
         this.version = version;
@@ -8151,6 +8154,7 @@ var InternalQueryReference =  (function () {
         this.key = {};
         this.listeners = new Set();
         this.references = 0;
+        this.softReferences = 0;
         this.handleNext = this.handleNext.bind(this);
         this.handleError = this.handleError.bind(this);
         this.dispose = this.dispose.bind(this);
@@ -8185,16 +8189,17 @@ var InternalQueryReference =  (function () {
     InternalQueryReference.prototype.reinitialize = function () {
         var observable = this.observable;
         var originalFetchPolicy = this.watchQueryOptions.fetchPolicy;
+        var avoidNetworkRequests = originalFetchPolicy === "no-cache" || originalFetchPolicy === "standby";
         try {
-            if (originalFetchPolicy !== "no-cache") {
-                observable.resetLastResults();
-                observable.silentSetOptions({ fetchPolicy: "cache-first" });
+            if (avoidNetworkRequests) {
+                observable.silentSetOptions({ fetchPolicy: "standby" });
             }
             else {
-                observable.silentSetOptions({ fetchPolicy: "standby" });
+                observable.resetLastResults();
+                observable.silentSetOptions({ fetchPolicy: "cache-first" });
             }
             this.subscribeToQuery();
-            if (originalFetchPolicy === "no-cache") {
+            if (avoidNetworkRequests) {
                 return;
             }
             observable.resetDiff();
@@ -8215,8 +8220,23 @@ var InternalQueryReference =  (function () {
             }
             disposed = true;
             _this.references--;
+            if (!_this.references) {
+                _this.dispose();
+            }
+        };
+    };
+    InternalQueryReference.prototype.softRetain = function () {
+        var _this = this;
+        this.softReferences++;
+        var disposed = false;
+        return function () {
+            if (disposed) {
+                return;
+            }
+            disposed = true;
+            _this.softReferences--;
             setTimeout(function () {
-                if (!_this.references) {
+                if (!_this.softReferences && !_this.references) {
                     _this.dispose();
                 }
             });
@@ -8225,7 +8245,8 @@ var InternalQueryReference =  (function () {
     InternalQueryReference.prototype.didChangeOptions = function (watchQueryOptions) {
         var _this = this;
         return OBSERVED_CHANGED_OPTIONS.some(function (option) {
-            return !equal.equal(_this.watchQueryOptions[option], watchQueryOptions[option]);
+            return option in watchQueryOptions &&
+                !equal.equal(_this.watchQueryOptions[option], watchQueryOptions[option]);
         });
     };
     InternalQueryReference.prototype.applyOptions = function (watchQueryOptions) {
@@ -8311,12 +8332,12 @@ var InternalQueryReference =  (function () {
         this.promise = this.createPendingPromise();
         this.promise.catch(function () { });
         returnedPromise
-            .then(function (result) {
+            .then(function () {
             setTimeout(function () {
                 var _a;
                 if (_this.promise.status === "pending") {
-                    _this.result = result;
-                    (_a = _this.resolve) === null || _a === void 0 ? void 0 : _a.call(_this, result);
+                    _this.result = _this.observable.getCurrentResult();
+                    (_a = _this.resolve) === null || _a === void 0 ? void 0 : _a.call(_this, _this.result);
                 }
             });
         })
@@ -8369,6 +8390,10 @@ var SuspenseCache =  (function () {
         }
         return ref.current;
     };
+    SuspenseCache.prototype.add = function (cacheKey, queryRef) {
+        var ref = this.queryRefs.lookupArray(cacheKey);
+        ref.current = queryRef;
+    };
     return SuspenseCache;
 }());
 
@@ -8423,6 +8448,12 @@ function _useSuspenseQuery(query, options) {
             dispose();
         };
     }, [queryRef]);
+    React__namespace.useEffect(function () {
+        if (queryRef.disposed) {
+            suspenseCache.add(cacheKey, queryRef);
+            queryRef.reinitialize();
+        }
+    });
     var skipResult = React__namespace.useMemo(function () {
         var error = toApolloError(queryRef.result);
         return {
@@ -8530,6 +8561,11 @@ function _useBackgroundQuery(query, options) {
         var promise = queryRef.applyOptions(watchQueryOptions);
         updateWrappedQueryRef(wrappedQueryRef, promise);
     }
+    React__namespace.useEffect(function () {
+        if (queryRef.disposed) {
+            suspenseCache.add(cacheKey, queryRef);
+        }
+    });
     var fetchMore = React__namespace.useCallback(function (options) {
         var promise = queryRef.fetchMore(options);
         setWrappedQueryRef(wrapQueryRef(queryRef));
@@ -8540,6 +8576,7 @@ function _useBackgroundQuery(query, options) {
         setWrappedQueryRef(wrapQueryRef(queryRef));
         return promise;
     }, [queryRef]);
+    React__namespace.useEffect(function () { return queryRef.softRetain(); }, [queryRef]);
     return [
         didFetchResult.current ? wrappedQueryRef : void 0,
         { fetchMore: fetchMore, refetch: refetch },
@@ -8598,6 +8635,12 @@ function useLoadableQuery(query, options) {
 }
 
 function useQueryRefHandlers(queryRef) {
+    var unwrapped = unwrapQueryRef(queryRef);
+    return wrapHook("useQueryRefHandlers", _useQueryRefHandlers, unwrapped ?
+        unwrapped["observable"]
+        : useApolloClient())(queryRef);
+}
+function _useQueryRefHandlers(queryRef) {
     var _a = React__namespace.useState(queryRef), previousQueryRef = _a[0], setPreviousQueryRef = _a[1];
     var _b = React__namespace.useState(queryRef), wrappedQueryRef = _b[0], setWrappedQueryRef = _b[1];
     var internalQueryRef = unwrapQueryRef(queryRef);
@@ -8622,7 +8665,10 @@ function useQueryRefHandlers(queryRef) {
 }
 
 function useReadQuery(queryRef) {
-    return wrapHook("useReadQuery", _useReadQuery, unwrapQueryRef(queryRef)["observable"])(queryRef);
+    var unwrapped = unwrapQueryRef(queryRef);
+    return wrapHook("useReadQuery", _useReadQuery, unwrapped ?
+        unwrapped["observable"]
+        : useApolloClient())(queryRef);
 }
 function _useReadQuery(queryRef) {
     var internalQueryRef = React__namespace.useMemo(function () { return unwrapQueryRef(queryRef); }, [queryRef]);
@@ -8631,7 +8677,12 @@ function _useReadQuery(queryRef) {
         internalQueryRef.reinitialize();
         updateWrappedQueryRef(queryRef, internalQueryRef.promise);
     }
-    React__namespace.useEffect(function () { return internalQueryRef.retain(); }, [internalQueryRef]);
+    React__namespace.useEffect(function () {
+        if (internalQueryRef.disposed) {
+            internalQueryRef.reinitialize();
+        }
+        return internalQueryRef.retain();
+    }, [internalQueryRef]);
     var promise = useSyncExternalStore(React__namespace.useCallback(function (forceUpdate) {
         return internalQueryRef.listen(function (promise) {
             updateWrappedQueryRef(queryRef, promise);