@apollo/client 4.0.4 → 4.1.0-alpha.0

package/invariantErrorCodes.js

@@ -334,12 +334,18 @@ const client = new ApolloClient({
   },
 
   64: {
+    file: "@apollo/client/incremental/handlers/graphql17Alpha9.js",
+    condition: "pending",
+    message: "Could not find pending chunk for incremental value. Please file an issue for the Apollo Client team to investigate."
+  },
+
+  65: {
     file: "@apollo/client/incremental/handlers/notImplemented.js",
     condition: "!hasDirectives([\"defer\"], request.query)",
     message: "`@defer` is not supported without specifying an incremental handler. Please pass a handler as the `incrementalHandler` option to the `ApolloClient` constructor."
   },
 
-  65: {
+  66: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.cache",
 
@@ -348,7 +354,7 @@ const client = new ApolloClient({
         "For more information, please visit: https://go.apollo.dev/c/docs"
   },
 
-  66: {
+  67: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.link",
 
@@ -357,7 +363,7 @@ const client = new ApolloClient({
         "For more information, please visit: https://go.apollo.dev/c/docs"
   },
 
-  67: {
+  68: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.fetchPolicy !== \"cache-and-network\"",
 
@@ -367,7 +373,7 @@ const client = new ApolloClient({
         "using a different fetchPolicy, such as cache-first or network-only."
   },
 
-  68: {
+  69: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.fetchPolicy !== \"standby\"",
 
@@ -376,7 +382,7 @@ const client = new ApolloClient({
         "as cache-first or network-only."
   },
 
-  69: {
+  70: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.query",
 
@@ -384,158 +390,158 @@ const client = new ApolloClient({
         "in the query option."
   },
 
-  70: {
+  71: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.query.kind === \"Document\"",
     message: 'You must wrap the query string in a "gql" tag.'
   },
 
-  71: {
+  72: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.returnPartialData",
     message: "returnPartialData option only supported on watchQuery."
   },
 
-  72: {
+  73: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.pollInterval",
     message: "pollInterval option only supported on watchQuery."
   },
 
-  73: {
+  74: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.notifyOnNetworkStatusChange",
     message: "notifyOnNetworkStatusChange option only supported on watchQuery."
   },
 
-  74: {
+  75: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "optionsWithDefaults.mutation",
     message: "The `mutation` option is required. Please provide a GraphQL document in the `mutation` option."
   },
 
-  75: {
+  76: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "optionsWithDefaults.fetchPolicy === \"network-only\" ||\n    optionsWithDefaults.fetchPolicy === \"no-cache\"",
     message: "Mutations only support 'network-only' or 'no-cache' fetch policies. The default 'network-only' behavior automatically writes mutation results to the cache. Passing 'no-cache' skips the cache write."
   },
 
-  78: {
+  79: {
     file: "@apollo/client/core/ObservableQuery.js",
     condition: "this.options.fetchPolicy !== \"cache-only\"",
     message: "Cannot execute `fetchMore` for 'cache-only' query '%s'. Please use a different fetch policy."
   },
 
-  79: {
+  80: {
     file: "@apollo/client/core/ObservableQuery.js",
     condition: "updateQuery",
     message: "You must provide an `updateQuery` function when using `fetchMore` with a `no-cache` fetch policy."
   },
 
-  83: {
+  84: {
     file: "@apollo/client/core/QueryManager.js",
     message: "QueryManager stopped while query was in flight"
   },
 
-  84: {
+  85: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "Mutation '%s' contains `@client` fields with variables provided by `@export` but local state has not been configured."
   },
 
-  85: {
+  86: {
     file: "@apollo/client/core/QueryManager.js",
     message: "Store reset while query was in flight (not completed in link chain)"
   },
 
-  88: {
+  89: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "!this.getDocumentInfo(query).hasClientExports || this.localState",
     message: "Subscription '%s' contains `@client` fields with variables provided by `@export` but local state has not been configured."
   },
 
-  89: {
+  90: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "%s '%s' contains `@client` fields but local state has not been configured."
   },
 
-  90: {
+  91: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "!hasIncrementalDirective",
     message: "%s '%s' contains `@client` and `@defer` directives. These cannot be used together."
   },
 
-  91: {
+  92: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "Query '%s' contains `@client` fields with variables provided by `@export` but local state has not been configured."
   },
 
-  93: {
+  94: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "Query '%s' contains `@client` fields but local state has not been configured."
   },
 
-  94: {
+  95: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "didEmitValue",
     message: "The link chain completed without emitting a value. This is likely unintentional and should be updated to emit a value before completing."
   },
 
-  95: {
+  96: {
     file: "@apollo/client/cache/inmemory/entityStore.js",
     condition: "typeof dataId === \"string\"",
     message: "store.merge expects a string ID"
   },
 
-  98: {
+  99: {
     file: "@apollo/client/cache/inmemory/key-extractor.js",
     condition: "extracted !== void 0",
     message: `Missing field '%s' while extracting keyFields from %s`
   },
 
-  99: {
+  100: {
     file: "@apollo/client/cache/inmemory/policies.js",
     condition: "!old || old === which",
     message: `Cannot change root %s __typename more than once`
   },
 
-  102: {
+  103: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: "Cannot automatically merge arrays"
   },
 
-  103: {
+  104: {
     file: "@apollo/client/cache/inmemory/readFromStore.js",
     message: `No fragment named %s`
   },
 
-  104: {
+  105: {
     file: "@apollo/client/cache/inmemory/readFromStore.js",
     condition: "!isReference(value)",
     message: `Missing selection set for object of type %s returned for query field %s`
   },
 
-  105: {
+  106: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Could not identify object %s`
   },
 
-  107: {
+  108: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `No fragment named %s`
   }
 };
 
 export const devDebug = {
-  76: {
+  77: {
     file: "@apollo/client/core/ApolloClient.js",
     message: `In client.refetchQueries, Promise.all promise rejected with error %o`
   },
 
-  82: {
+  83: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: `Missing cache result fields: %o`
   }
@@ -603,34 +609,34 @@ export const devWarn = {
         "If you are using a split link, ensure each branch contains a terminating link that handles the request."
   },
 
-  77: {
+  78: {
     file: "@apollo/client/core/ObservableQuery.js",
 
     message: `Called refetch(%o) for query %o, which does not declare a $variables variable.
 Did you mean to call refetch(variables) instead of refetch({ variables })?`
   },
 
-  81: {
+  82: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: "Cannot poll on 'cache-only' query '%s' and as such, polling is disabled. Please use a different fetch policy."
   },
 
-  86: {
+  87: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown query named "%s" requested in refetchQueries options.include array`
   },
 
-  87: {
+  88: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown anonymous query requested in refetchQueries options.include array`
   },
 
-  92: {
+  93: {
     file: "@apollo/client/core/QueryManager.js",
     message: '[%s]: Fragments masked by data masking are inaccessible when using fetch policy "no-cache". Please add `@unmask` to each fragment spread to access the data.'
   },
 
-  96: {
+  97: {
     file: "@apollo/client/cache/inmemory/entityStore.js",
 
     message: "cache.modify: You are trying to write a Reference that is not part of the store: %o\n" +
@@ -638,24 +644,24 @@ Did you mean to call refetch(variables) instead of refetch({ variables })?`
         "`toReference(object, true)`"
   },
 
-  97: {
+  98: {
     file: "@apollo/client/cache/inmemory/entityStore.js",
 
     message: "cache.modify: Writing an array with a mix of both References and Objects will not result in the Objects being normalized correctly.\n" +
         "Please convert the object instance %o to a Reference before writing it to the cache by calling `toReference(object, true)`."
   },
 
-  100: {
+  101: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Inferring subtype %s of supertype %s`
   },
 
-  101: {
+  102: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Undefined 'from' passed to readField with arguments %s`
   },
 
-  108: {
+  109: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
 
     message: `Cache data may be lost when replacing the %s field of a %s object.
@@ -674,7 +680,7 @@ For more information about these options, please refer to the documentation:
 `
   },
 
-  109: {
+  110: {
     file: "@apollo/client/cache/core/cache.js",
     message: "Could not identify object passed to `from` for '%s' fragment, either because the object is non-normalized or the key fields are missing. If you are masking this object, please ensure the key fields are requested by the parent object."
   }
@@ -691,12 +697,12 @@ export const devError = {
     message: "The result of getSnapshot should be cached to avoid an infinite loop"
   },
 
-  80: {
+  81: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: "Unhandled GraphQL subscription error"
   },
 
-  106: {
+  107: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Missing field '%s' while writing result %o`
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apollo/client",
-  "version": "4.0.4",
+  "version": "4.1.0-alpha.0",
   "description": "A fully-featured caching GraphQL client.",
   "private": false,
   "keywords": [

package/react/internal/cache/QueryReference.d.ts

@@ -75,6 +75,7 @@ export declare class InternalQueryReference<TData = unknown, TStates extends Dat
     readonly key: QueryKey;
     readonly observable: ObservableQuery<TData>;
     promise: QueryRefPromise<TData, TStates>;
+    private queue;
     private subscription;
     private listeners;
     private autoDisposeTimeoutId?;

package/react/internal/cache/QueryReference.js

@@ -37,6 +37,7 @@ export class InternalQueryReference {
     key = {};
     observable;
     promise;
+    queue;
     subscription;
     listeners = new Set();
     autoDisposeTimeoutId;
@@ -149,6 +150,10 @@ export class InternalQueryReference {
     }
     listen(listener) {
         this.listeners.add(listener);
+        if (this.queue) {
+            this.deliver(this.queue);
+            this.queue = undefined;
+        }
         return () => {
             this.listeners.delete(listener);
         };
@@ -214,6 +219,17 @@ export class InternalQueryReference {
         }
     }
     deliver(promise) {
+        // Maintain a queue of the last item we tried to deliver so that we can
+        // deliver it as soon as we get the first listener. This helps in cases such
+        // as `@stream` where React may render a component and incremental results
+        // are loaded in between when the component renders and effects are run. If
+        // effects are run after the incremntal chunks are delivered, we'll have
+        // rendered a stale value. The queue ensures we can deliver the most
+        // up-to-date value as soon as the component is ready to listen for new
+        // values.
+        if (this.listeners.size === 0) {
+            this.queue = promise;
+        }
         this.listeners.forEach((listener) => listener(promise));
     }
     initiateFetch(returnedPromise) {