@apollo/client 4.0.6 → 4.1.0-alpha.1

package/invariantErrorCodes.js

@@ -272,24 +272,24 @@ you have an infinite render loop in your application.`
     message: "No fragment named %s"
   },
 
-  53: {
+  55: {
     file: "@apollo/client/local-state/LocalState.js",
     message: "Could not resolve __typename on object %o returned from resolver '%s'. '__typename' needs to be returned to properly resolve child fields."
   },
 
-  54: {
+  56: {
     file: "@apollo/client/local-state/LocalState.js",
     condition: "fragment",
     message: `No fragment named %s`
   },
 
-  55: {
+  57: {
     file: "@apollo/client/local-state/LocalState.js",
     condition: "cache.fragmentMatches",
     message: "The configured cache does not support fragment matching which will lead to incorrect results when executing local resolvers. Please use a cache that implements `fragmetMatches`."
   },
 
-  57: {
+  59: {
     file: "@apollo/client/link/persisted-queries/index.js",
     condition: "options &&\n    (typeof options.sha256 === \"function\" ||\n        typeof options.generateHash === \"function\")",
 
@@ -298,13 +298,13 @@ you have an infinite render loop in your application.`
         "parameter."
   },
 
-  58: {
+  60: {
     file: "@apollo/client/link/persisted-queries/index.js",
     condition: "forward",
     message: "PersistedQueryLink cannot be the last link in the chain."
   },
 
-  59: {
+  61: {
     file: "@apollo/client/link/http/checkFetcher.js",
     condition: "fetcher || typeof fetch !== \"undefined\"",
 
@@ -322,24 +322,30 @@ const client = new ApolloClient({
     `
   },
 
-  60: {
+  62: {
     file: "@apollo/client/link/http/parseAndCheckHttpResponse.js",
     condition: "response.body && typeof response.body.getReader === \"function\"",
     message: "Unknown type for `response.body`. Please use a `fetch` implementation that is WhatWG-compliant and that uses WhatWG ReadableStreams for `body`."
   },
 
-  63: {
+  65: {
     file: "@apollo/client/link/core/ApolloLink.js",
     message: "request is not implemented"
   },
 
-  64: {
+  66: {
+    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."
+  },
+
+  67: {
     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: {
+  68: {
     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: {
+  69: {
     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: {
+  70: {
     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: {
+  71: {
     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: {
+  72: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.query",
 
@@ -384,158 +390,158 @@ const client = new ApolloClient({
         "in the query option."
   },
 
-  70: {
+  73: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.query.kind === \"Document\"",
     message: 'You must wrap the query string in a "gql" tag.'
   },
 
-  71: {
+  74: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.returnPartialData",
     message: "returnPartialData option only supported on watchQuery."
   },
 
-  72: {
+  75: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.pollInterval",
     message: "pollInterval option only supported on watchQuery."
   },
 
-  73: {
+  76: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.notifyOnNetworkStatusChange",
     message: "notifyOnNetworkStatusChange option only supported on watchQuery."
   },
 
-  74: {
+  77: {
     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: {
+  78: {
     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: {
+  81: {
     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: {
+  82: {
     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: {
+  86: {
     file: "@apollo/client/core/QueryManager.js",
     message: "QueryManager stopped while query was in flight"
   },
 
-  84: {
+  87: {
     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: {
+  88: {
     file: "@apollo/client/core/QueryManager.js",
     message: "Store reset while query was in flight (not completed in link chain)"
   },
 
-  88: {
+  91: {
     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: {
+  92: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "%s '%s' contains `@client` fields but local state has not been configured."
   },
 
-  90: {
+  93: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "!hasIncrementalDirective",
     message: "%s '%s' contains `@client` and `@defer` directives. These cannot be used together."
   },
 
-  91: {
+  94: {
     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: {
+  96: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "Query '%s' contains `@client` fields but local state has not been configured."
   },
 
-  94: {
+  97: {
     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: {
+  98: {
     file: "@apollo/client/cache/inmemory/entityStore.js",
     condition: "typeof dataId === \"string\"",
     message: "store.merge expects a string ID"
   },
 
-  98: {
+  101: {
     file: "@apollo/client/cache/inmemory/key-extractor.js",
     condition: "extracted !== void 0",
     message: `Missing field '%s' while extracting keyFields from %s`
   },
 
-  99: {
+  102: {
     file: "@apollo/client/cache/inmemory/policies.js",
     condition: "!old || old === which",
     message: `Cannot change root %s __typename more than once`
   },
 
-  102: {
+  105: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: "Cannot automatically merge arrays"
   },
 
-  103: {
+  106: {
     file: "@apollo/client/cache/inmemory/readFromStore.js",
     message: `No fragment named %s`
   },
 
-  104: {
+  107: {
     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: {
+  108: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Could not identify object %s`
   },
 
-  107: {
+  110: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `No fragment named %s`
   }
 };
 
 export const devDebug = {
-  76: {
+  79: {
     file: "@apollo/client/core/ApolloClient.js",
     message: `In client.refetchQueries, Promise.all promise rejected with error %o`
   },
 
-  82: {
+  85: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: `Missing cache result fields: %o`
   }
@@ -571,30 +577,40 @@ export const devWarn = {
 
   50: {
     file: "@apollo/client/local-state/LocalState.js",
-    message: "The '%s' resolver returned `undefined` instead of a value. This is likely a bug in the resolver. If you didn't mean to return a value, return `null` instead."
+    message: "The '%s' field resolves the value from the cache, for example from a 'read' function, but a 'no-cache' fetch policy was used. The field value has been set to `null`. Either define a local resolver or use a fetch policy that uses the cache to ensure the field is resolved correctly."
   },
 
   51: {
     file: "@apollo/client/local-state/LocalState.js",
-    message: "The '%s' field had no cached value and only forced resolvers were run. The value was set to `null`."
+    message: "Could not find a resolver for the '%s' field nor does the cache resolve the field. The field value has been set to `null`. Either define a resolver for the field or ensure the cache can resolve the value, for example, by adding a 'read' function to a field policy in 'InMemoryCache'."
   },
 
   52: {
+    file: "@apollo/client/local-state/LocalState.js",
+    message: "The '%s' resolver returned `undefined` instead of a value. This is likely a bug in the resolver. If you didn't mean to return a value, return `null` instead."
+  },
+
+  53: {
+    file: "@apollo/client/local-state/LocalState.js",
+    message: "The '%s' field had no cached value and only forced resolvers were run. The value was set to `null`."
+  },
+
+  54: {
     file: "@apollo/client/local-state/LocalState.js",
     message: "The '%s' field on object %o returned `undefined` instead of a value. The parent resolver did not include the property in the returned value and there was no resolver defined for the field."
   },
 
-  56: {
+  58: {
     file: "@apollo/client/link/ws/index.js",
     message: "`WebSocketLink` uses the deprecated and unmaintained `subscriptions-transport-ws` library. This link is no longer maintained and will be removed in a future major version of Apollo Client. We recommend switching to `GraphQLWsLink` which uses the `graphql-ws` library to send GraphQL operations through WebSocket connections (https://the-guild.dev/graphql/ws)."
   },
 
-  61: {
+  63: {
     file: "@apollo/client/link/core/ApolloLink.js",
     message: "[ApolloLink.split]: The test function returned a non-boolean value which could result in subtle bugs (e.g. such as using an `async` function which always returns a truthy value). Got `%o`."
   },
 
-  62: {
+  64: {
     file: "@apollo/client/link/core/ApolloLink.js",
 
     message: "The terminating link provided to `ApolloLink.execute` called `forward` instead of handling the request. " +
@@ -603,34 +619,34 @@ export const devWarn = {
         "If you are using a split link, ensure each branch contains a terminating link that handles the request."
   },
 
-  77: {
+  80: {
     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: {
+  84: {
     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: {
+  89: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown query named "%s" requested in refetchQueries options.include array`
   },
 
-  87: {
+  90: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown anonymous query requested in refetchQueries options.include array`
   },
 
-  92: {
+  95: {
     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: {
+  99: {
     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 +654,24 @@ Did you mean to call refetch(variables) instead of refetch({ variables })?`
         "`toReference(object, true)`"
   },
 
-  97: {
+  100: {
     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: {
+  103: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Inferring subtype %s of supertype %s`
   },
 
-  101: {
+  104: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Undefined 'from' passed to readField with arguments %s`
   },
 
-  108: {
+  111: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
 
     message: `Cache data may be lost when replacing the %s field of a %s object.
@@ -674,7 +690,7 @@ For more information about these options, please refer to the documentation:
 `
   },
 
-  109: {
+  112: {
     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 +707,12 @@ export const devError = {
     message: "The result of getSnapshot should be cached to avoid an infinite loop"
   },
 
-  80: {
+  83: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: "Unhandled GraphQL subscription error"
   },
 
-  106: {
+  109: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Missing field '%s' while writing result %o`
   }

package/link/core/ApolloLink.js

@@ -100,7 +100,7 @@ export class ApolloLink {
             const result = test(operation);
             if (__DEV__) {
                 if (typeof result !== "boolean") {
-                    __DEV__ && invariant.warn(61, result);
+                    __DEV__ && invariant.warn(63, result);
                 }
             }
             return result ?
@@ -142,7 +142,7 @@ export class ApolloLink {
     static execute(link, request, context) {
         return link.request(createOperation(request, context), () => {
             if (__DEV__) {
-                __DEV__ && invariant.warn(62);
+                __DEV__ && invariant.warn(64);
             }
             return EMPTY;
         });
@@ -246,7 +246,7 @@ export class ApolloLink {
      * > request instead.
      */
     request(operation, forward) {
-        throw newInvariantError(63);
+        throw newInvariantError(65);
     }
     /**
     * @internal

package/link/http/checkFetcher.js

@@ -1,5 +1,5 @@
 import { invariant } from "@apollo/client/utilities/invariant";
 export const checkFetcher = (fetcher) => {
-    invariant(fetcher || typeof fetch !== "undefined", 59);
+    invariant(fetcher || typeof fetch !== "undefined", 61);
 };
 //# sourceMappingURL=checkFetcher.js.map

package/link/http/parseAndCheckHttpResponse.js

@@ -33,7 +33,7 @@ async function* consumeMultipartBody(response) {
     /;\s*boundary=(?:'([^']+)'|"([^"]+)"|([^"'].+?))\s*(?:;|$)/i);
     const boundary = "\r\n--" + (match?.findLast((val) => !!val) || "-");
     let buffer = "";
-    invariant(response.body && typeof response.body.getReader === "function", 60);
+    invariant(response.body && typeof response.body.getReader === "function", 62);
     const stream = response.body;
     const reader = stream.getReader();
     let done = false;

package/link/persisted-queries/index.js

@@ -66,7 +66,7 @@ export class PersistedQueryLink extends ApolloLink {
         // hashing with something other than SHA-256.
         invariant(options &&
             (typeof options.sha256 === "function" ||
-                typeof options.generateHash === "function"), 57);
+                typeof options.generateHash === "function"), 59);
         const { sha256, 
         // If both a `sha256` and `generateHash` option are provided, the
         // `sha256` option will be ignored. Developers can configure and
@@ -92,7 +92,7 @@ export class PersistedQueryLink extends ApolloLink {
             return hash;
         }
         super((operation, forward) => {
-            invariant(forward, 58);
+            invariant(forward, 60);
             const { query } = operation;
             return new Observable((observer) => {
                 let subscription;

package/link/ws/index.js

@@ -32,7 +32,7 @@ export class WebSocketLink extends ApolloLink {
     constructor(paramsOrClient) {
         super();
         if (__DEV__) {
-            __DEV__ && invariant.warn(56);
+            __DEV__ && invariant.warn(58);
         }
         if (paramsOrClient instanceof SubscriptionClient) {
             this.subscriptionClient = paramsOrClient;

package/local-state/LocalState.d.ts

@@ -1,5 +1,5 @@
 import type { DocumentNode, FieldNode, FormattedExecutionResult } from "graphql";
-import type { ApolloClient, DefaultContext, OperationVariables, TypedDocumentNode } from "@apollo/client";
+import type { ApolloClient, DefaultContext, OperationVariables, TypedDocumentNode, WatchQueryFetchPolicy } from "@apollo/client";
 import type { FragmentMap, NoInfer, RemoveIndexSignature } from "@apollo/client/utilities/internal";
 type InferContextValueFromResolvers<TResolvers> = TResolvers extends {
     [typename: string]: infer TFieldResolvers;
@@ -155,7 +155,7 @@ export declare class LocalState<TResolvers extends LocalState.Resolvers = LocalS
      * ```
      */
     addResolvers(resolvers: TResolvers): void;
-    execute<TData = unknown, TVariables extends OperationVariables = OperationVariables>({ document, client, context, remoteResult, variables, onlyRunForcedResolvers, returnPartialData, }: {
+    execute<TData = unknown, TVariables extends OperationVariables = OperationVariables>({ document, client, context, remoteResult, variables, onlyRunForcedResolvers, returnPartialData, fetchPolicy, }: {
         document: DocumentNode | TypedDocumentNode<TData, TVariables>;
         client: ApolloClient;
         context: DefaultContext | undefined;
@@ -163,6 +163,7 @@ export declare class LocalState<TResolvers extends LocalState.Resolvers = LocalS
         variables: TVariables | undefined;
         onlyRunForcedResolvers?: boolean;
         returnPartialData?: boolean;
+        fetchPolicy: WatchQueryFetchPolicy;
     }): Promise<FormattedExecutionResult<TData>>;
     getExportedVariables<TVariables extends OperationVariables = OperationVariables>({ document, client, context, variables, }: {
         document: DocumentNode | TypedDocumentNode<any, TVariables>;

package/local-state/LocalState.js

@@ -64,7 +64,7 @@ export class LocalState {
     addResolvers(resolvers) {
         this.resolvers = mergeDeep(this.resolvers, resolvers);
     }
-    async execute({ document, client, context, remoteResult, variables = {}, onlyRunForcedResolvers = false, returnPartialData = false, }) {
+    async execute({ document, client, context, remoteResult, variables = {}, onlyRunForcedResolvers = false, returnPartialData = false, fetchPolicy, }) {
         if (__DEV__) {
             invariant(hasDirectives(["client"], document), 47);
             validateCacheImplementation(client.cache);
@@ -78,12 +78,14 @@ export class LocalState {
         }
         const { selectionsToResolve, exportedVariableDefs, operationDefinition, fragmentMap, } = this.collectQueryDetail(document);
         const rootValue = remoteResult ? remoteResult.data : {};
-        const diff = client.cache.diff({
-            query: toQueryOperation(document),
-            variables,
-            returnPartialData: true,
-            optimistic: false,
-        });
+        const diff = fetchPolicy === "no-cache" ?
+            { result: null, complete: false }
+            : client.cache.diff({
+                query: toQueryOperation(document),
+                variables,
+                returnPartialData: true,
+                optimistic: false,
+            });
         const requestContext = { ...client.defaultContext, ...context };
         const execContext = {
             client,
@@ -105,6 +107,7 @@ export class LocalState {
             exportedVariableDefs,
             diff,
             returnPartialData,
+            fetchPolicy,
         };
         const localResult = await this.resolveSelectionSet(operationDefinition.selectionSet, false, rootValue, execContext, []);
         const errors = (remoteResult?.errors ?? []).concat(execContext.errors);
@@ -241,7 +244,8 @@ export class LocalState {
         return this.resolveSelectionSet(field.selectionSet, false, result, execContext, path);
     }
     async resolveClientField(field, isClientFieldDescendant, rootValue, execContext, parentSelectionSet, path) {
-        const { client, diff, variables, operationDefinition, phase, returnPartialData, onlyRunForcedResolvers, } = execContext;
+        const { client, diff, variables, operationDefinition, phase, onlyRunForcedResolvers, fetchPolicy, } = execContext;
+        let { returnPartialData } = execContext;
         const isRootField = parentSelectionSet === operationDefinition.selectionSet;
         const fieldName = field.name.value;
         const typename = isRootField ?
@@ -263,7 +267,17 @@ export class LocalState {
                 if (fieldFromCache !== undefined) {
                     return fieldFromCache;
                 }
+                if (client.cache.resolvesClientField?.(typename, fieldName)) {
+                    if (fetchPolicy === "no-cache") {
+                        __DEV__ && invariant.warn(50, resolverName);
+                        return null;
+                    }
+                    // assume the cache will handle returning the correct value
+                    returnPartialData = true;
+                    return;
+                }
                 if (!returnPartialData) {
+                    __DEV__ && invariant.warn(51, resolverName);
                     return null;
                 }
             });
@@ -329,13 +343,13 @@ export class LocalState {
         if (result === undefined && !returnPartialData) {
             if (__DEV__ && phase === "resolve") {
                 if (resolver && !onlyRunForcedResolvers) {
-                    __DEV__ && invariant.warn(50, resolverName);
+                    __DEV__ && invariant.warn(52, resolverName);
                 }
                 else if (onlyRunForcedResolvers) {
-                    __DEV__ && invariant.warn(51, resolverName);
+                    __DEV__ && invariant.warn(53, resolverName);
                 }
                 else {
-                    __DEV__ && invariant.warn(52, fieldName, rootValue);
+                    __DEV__ && invariant.warn(54, fieldName, rootValue);
                 }
             }
             result = null;
@@ -347,7 +361,7 @@ export class LocalState {
             return this.resolveSubSelectedArray(field, true, result, execContext, path);
         }
         if (phase === "resolve" && !result.__typename) {
-            this.addError(newInvariantError(53, result, resolverName), path, execContext, { resolver: resolverName });
+            this.addError(newInvariantError(55, result, resolverName), path, execContext, { resolver: resolverName });
             return null;
         }
         return this.resolveSelectionSet(field.selectionSet, true, result, execContext, path);
@@ -458,7 +472,7 @@ export class LocalState {
                 },
                 FragmentSpread(spread, _, __, ___, ancestors) {
                     const fragment = fragmentMap[spread.name.value];
-                    invariant(fragment, 54, spread.name.value);
+                    invariant(fragment, 56, spread.name.value);
                     const { selectionsToResolve: fragmentSelections } = traverse(fragment);
                     if (fragmentSelections.size > 0) {
                         // Fragment for this spread contains @client directive (either directly or transitively)
@@ -517,7 +531,7 @@ function getExportedVariableName(directive) {
     }
 }
 function validateCacheImplementation(cache) {
-    invariant(cache.fragmentMatches, 55);
+    invariant(cache.fragmentMatches, 57);
 }
 function getCacheResultAtPath(diff, path) {
     if (diff.result === null) {