Add @defer support to useSuspenseQuery (#10324)

* Add support for @defer queries in useSuspenseQuery

* Add test to verify deferred queries work with lists

* Add more tests to ensure deferred queries work with various conditions

* Add tests to ensure cached data is properly returned with deferred queries

* Add tests to check error behavior returned by first chunk

* Add handling of errors returned in deferred chunks

* Add tests to validate errorPolicy behavior with deferred queries

* Slight change to verbiage in test

* Add test to verify partial data with returnPartialData

* Update bundlesize

* Rename function to better convey intent

* Enable skipped tests since fix is merged to `main`

* Add changeset

* Update comment for reobserveAsConcast

* Update bundlesize

* Update bundlesize

Co-authored-by: Alessia Bellisario <alessia@apollographql.com>

.changeset/sixty-trains-sniff.md

@@ -0,0 +1,5 @@
+---
+'@apollo/client': patch
+---
+
+Add `@defer` support to `useSuspenseQuery`.

config/bundlesize.ts

@@ -3,7 +3,7 @@ import { join } from "path";
 import { gzipSync } from "zlib";
 import bytes from "bytes";
 
-const gzipBundleByteLengthLimit = bytes("32.79KB");
+const gzipBundleByteLengthLimit = bytes("33.01KB");
 const minFile = join("dist", "apollo-client.min.cjs");
 const minPath = join(__dirname, "..", minFile);
 const gzipByteLen = gzipSync(readFileSync(minPath)).byteLength;

src/core/ObservableQuery.ts

@@ -784,10 +784,15 @@ Did you mean to call refetch(variables) instead of refetch({ variables })?`);
     return this.last;
   }
 
-  public reobserve(
+  // For cases like suspense with a deferred query where we need a custom
+  // promise wrapped around the concast, we need access to the raw concast
+  // created from `reobserve`. This function provides the original `reobserve`
+  // functionality, but returns a concast instead of a promise. Most consumers
+  // should prefer `reobserve` instead of this function.
+  public reobserveAsConcast(
     newOptions?: Partial<WatchQueryOptions<TVariables, TData>>,
-    newNetworkStatus?: NetworkStatus,
-  ): Promise<ApolloQueryResult<TData>> {
+    newNetworkStatus?: NetworkStatus
+  ): Concast<ApolloQueryResult<TData>> {
     this.isTornDown = false;
 
     const useDisposableConcast =
@@ -860,7 +865,17 @@ Did you mean to call refetch(variables) instead of refetch({ variables })?`);
 
     concast.addObserver(observer);
 
-    return concast.promise;
+    return concast;
+  }
+
+  public reobserve(
+    newOptions?: Partial<WatchQueryOptions<TVariables, TData>>,
+    newNetworkStatus?: NetworkStatus,
+  ): Promise<ApolloQueryResult<TData>> {
+    return this.reobserveAsConcast(
+      newOptions,
+      newNetworkStatus
+    ).promise
   }
 
   // (Re)deliver the current result to this.observers without applying fetch