@apollo/client 4.0.0-alpha.21 → 4.0.0-alpha.23

package/invariantErrorCodes.js

@@ -28,6 +28,11 @@ string in a "gql" tag? http://docs.apollostack.com/apollo-client/core.html#gql`
   },
 
   5: {
+    file: "@apollo/client/utilities/internal/checkDocument.js",
+    message: '`%s` is a forbidden field alias name in the selection set for field `%s` in %s "%s".'
+  },
+
+  6: {
     file: "@apollo/client/utilities/internal/getFragmentDefinition.js",
     condition: "doc.kind === \"Document\"",
 
@@ -35,73 +40,73 @@ string in a "gql" tag? http://docs.apollostack.com/apollo-client/core.html#gql`
 string in a "gql" tag? http://docs.apollostack.com/apollo-client/core.html#gql`
   },
 
-  6: {
+  7: {
     file: "@apollo/client/utilities/internal/getFragmentDefinition.js",
     condition: "doc.definitions.length <= 1",
     message: "Fragment must have exactly one definition."
   },
 
-  7: {
+  8: {
     file: "@apollo/client/utilities/internal/getFragmentDefinition.js",
     condition: "fragmentDef.kind === \"FragmentDefinition\"",
     message: "Must be a fragment definition."
   },
 
-  8: {
+  9: {
     file: "@apollo/client/utilities/internal/getFragmentFromSelection.js",
     condition: "fragment",
     message: `No fragment named %s`
   },
 
-  9: {
+  10: {
     file: "@apollo/client/utilities/internal/getFragmentQueryDocument.js",
 
     message: `Found a %s operation%s. ` +
         "No operations are allowed when using a fragment as a query. Only fragments are allowed."
   },
 
-  10: {
+  11: {
     file: "@apollo/client/utilities/internal/getFragmentQueryDocument.js",
     condition: "fragments.length === 1",
     message: `Found %s fragments. \`fragmentName\` must be provided when there is not exactly 1 fragment.`
   },
 
-  11: {
+  12: {
     file: "@apollo/client/utilities/internal/getMainDefinition.js",
     message: "Expected a parsed GraphQL query with a query, mutation, subscription, or a fragment."
   },
 
-  12: {
+  13: {
     file: "@apollo/client/utilities/internal/getQueryDefinition.js",
     condition: "queryDef && queryDef.operation === \"query\"",
     message: "Must contain a query definition."
   },
 
-  14: {
+  15: {
     file: "@apollo/client/utilities/internal/shouldInclude.js",
     condition: "evaledValue !== void 0",
     message: `Invalid variable referenced in @%s directive.`
   },
 
-  15: {
+  16: {
     file: "@apollo/client/utilities/internal/shouldInclude.js",
     condition: "directiveArguments && directiveArguments.length === 1",
     message: `Incorrect number of arguments for the @%s directive.`
   },
 
-  16: {
+  17: {
     file: "@apollo/client/utilities/internal/shouldInclude.js",
     condition: "ifArgument.name && ifArgument.name.value === \"if\"",
     message: `Invalid argument for the @%s directive.`
   },
 
-  17: {
+  18: {
     file: "@apollo/client/utilities/internal/shouldInclude.js",
     condition: "ifValue &&\n    (ifValue.kind === \"Variable\" || ifValue.kind === \"BooleanValue\")",
     message: `Argument for the @%s directive must be a variable or a boolean value.`
   },
 
-  18: {
+  19: {
     file: "@apollo/client/utilities/internal/valueToObjectRepresentation.js",
 
     message: `The inline argument "%s" of kind "%s"` +
@@ -109,37 +114,37 @@ string in a "gql" tag? http://docs.apollostack.com/apollo-client/core.html#gql`
         "overcome this limitation."
   },
 
-  19: {
+  20: {
     file: "@apollo/client/utilities/graphql/DocumentTransform.js",
     condition: "Array.isArray(cacheKeys)",
     message: "`getCacheKey` must return an array or undefined"
   },
 
-  20: {
+  21: {
     file: "@apollo/client/testing/core/mocking/mockLink.js",
     condition: "max > min",
     message: "realisticDelay: `min` must be less than `max`"
   },
 
-  21: {
+  22: {
     file: "@apollo/client/testing/core/mocking/mockLink.js",
     condition: "queryWithoutClientOnlyDirectives",
     message: "query is required"
   },
 
-  22: {
+  23: {
     file: "@apollo/client/testing/core/mocking/mockLink.js",
     condition: "serverQuery",
     message: "Cannot mock a client-only query. Mocked responses should contain at least one non-client field."
   },
 
-  23: {
+  24: {
     file: "@apollo/client/testing/core/mocking/mockLink.js",
     condition: "(mock.maxUsageCount ?? 1) > 0",
     message: "Mocked response `maxUsageCount` must be greater than 0. Given %s"
   },
 
-  24: {
+  25: {
     file: "@apollo/client/react/ssr/prerenderStatic.js",
     condition: "renderCount <= maxRerenders",
 
@@ -149,64 +154,61 @@ and need to increase the \`maxRerender\` option to \`prerenderStatic\`, or that
 you have an infinite render loop in your application.`
   },
 
-  25: {
+  26: {
     file: "@apollo/client/react/ssr/prerenderStatic.js",
     condition: "!signal?.aborted",
     message: "The operation was aborted before it could be attempted."
   },
 
-  26: {
+  27: {
     file: "@apollo/client/react/internal/cache/QueryReference.js",
     condition: "!queryRef || QUERY_REFERENCE_SYMBOL in queryRef",
     message: "Expected a QueryRef object, but got something else instead."
   },
 
-  27: {
+  28: {
     file: "@apollo/client/react/hooks/useApolloClient.js",
     condition: "!!client",
-
-    message: 'Could not find "client" in the context or passed in as an option. ' +
-        "Wrap the root component in an <ApolloProvider>, or pass an ApolloClient " +
-        "instance in via options."
+    message: "Could not find \"client\" in the context or passed in as an option. Wrap the root component in an <ApolloProvider>, or pass an ApolloClient instance in via options."
   },
 
-  28: {
+  29: {
     file: "@apollo/client/react/hooks/useLazyQuery.js",
     condition: "resultRef.current",
     message: "useLazyQuery: '%s' cannot be called before executing the query."
   },
 
-  29: {
+  30: {
     file: "@apollo/client/react/hooks/useLazyQuery.js",
     condition: "!calledDuringRender()",
     message: "useLazyQuery: 'execute' should not be called during render. To start a query during render, use the 'useQuery' hook."
   },
 
-  30: {
+  31: {
     file: "@apollo/client/react/hooks/useLoadableQuery.js",
     condition: "!calledDuringRender()",
     message: "useLoadableQuery: 'loadQuery' should not be called during render. To start a query during render, use the 'useBackgroundQuery' hook."
   },
 
-  31: {
+  32: {
     file: "@apollo/client/react/hooks/useLoadableQuery.js",
     condition: "internalQueryRef",
     message: "The query has not been loaded. Please load the query."
   },
 
-  32: {
+  33: {
     file: "@apollo/client/react/hooks/useSubscription.js",
     condition: "!optionsRef.current.skip",
     message: "A subscription that is skipped cannot be restarted."
   },
 
-  34: {
+  35: {
     file: "@apollo/client/react/hooks/internal/validateSuspenseHookOptions.js",
     condition: "supportedFetchPolicies.includes(fetchPolicy)",
     message: `The fetch policy \`%s\` is not supported with suspense.`
   },
 
-  36: {
+  37: {
     file: "@apollo/client/react/context/ApolloConsumer.js",
     condition: "context && context.client",
 
@@ -214,7 +216,7 @@ you have an infinite render loop in your application.`
         "Wrap the root component in an <ApolloProvider>."
   },
 
-  37: {
+  38: {
     file: "@apollo/client/react/context/ApolloContext.js",
     condition: "\"createContext\" in React",
 
@@ -225,7 +227,7 @@ you have an infinite render loop in your application.`
         "For more information, see https://nextjs.org/docs/getting-started/react-essentials#client-components"
   },
 
-  38: {
+  39: {
     file: "@apollo/client/react/context/ApolloProvider.js",
     condition: "context.client",
 
@@ -233,71 +235,71 @@ you have an infinite render loop in your application.`
         'sure you pass in your client via the "client" prop.'
   },
 
-  39: {
+  40: {
     file: "@apollo/client/masking/maskDefinition.js",
     condition: "fragment",
     message: "Could not find fragment with name '%s'."
   },
 
-  41: {
+  42: {
     file: "@apollo/client/masking/maskFragment.js",
     condition: "fragments.length === 1",
     message: `Found %s fragments. \`fragmentName\` must be provided when there is not exactly 1 fragment.`
   },
 
-  42: {
+  43: {
     file: "@apollo/client/masking/maskFragment.js",
     condition: "!!fragment",
     message: `Could not find fragment with name "%s".`
   },
 
-  43: {
+  44: {
     file: "@apollo/client/masking/maskOperation.js",
     condition: "definition",
     message: "Expected a parsed GraphQL document with a query, mutation, or subscription."
   },
 
-  47: {
+  48: {
     file: "@apollo/client/local-state/LocalState.js",
     condition: "hasDirectives([\"client\"], document)",
     message: "Expected document to contain `@client` fields."
   },
 
-  48: {
+  49: {
     file: "@apollo/client/local-state/LocalState.js",
     condition: "hasDirectives([\"client\"], document)",
     message: "Expected document to contain `@client` fields."
   },
 
-  49: {
+  50: {
     file: "@apollo/client/local-state/LocalState.js",
     condition: "fragment",
     message: "No fragment named %s"
   },
 
-  54: {
+  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."
   },
 
-  55: {
+  56: {
     file: "@apollo/client/local-state/LocalState.js",
     condition: "fragment",
     message: `No fragment named %s`
   },
 
-  56: {
+  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: {
+  58: {
     file: "@apollo/client/link/utils/validateOperation.js",
     message: `illegal argument: %s`
   },
 
-  58: {
+  59: {
     file: "@apollo/client/link/persisted-queries/index.js",
     condition: "options &&\n    (typeof options.sha256 === \"function\" ||\n        typeof options.generateHash === \"function\")",
 
@@ -306,13 +308,13 @@ you have an infinite render loop in your application.`
         "parameter."
   },
 
-  59: {
+  60: {
     file: "@apollo/client/link/persisted-queries/index.js",
     condition: "forward",
     message: "PersistedQueryLink cannot be the last link in the chain."
   },
 
-  60: {
+  61: {
     file: "@apollo/client/link/http/checkFetcher.js",
     condition: "fetcher || typeof fetch !== \"undefined\"",
 
@@ -347,6 +349,12 @@ const client = new ApolloClient({
   },
 
   66: {
+    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."
+  },
+
+  67: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.cache",
 
@@ -355,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.link",
 
@@ -364,7 +372,7 @@ const client = new ApolloClient({
         "For more information, please visit: https://go.apollo.dev/c/docs"
   },
 
-  68: {
+  69: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.fetchPolicy !== \"cache-and-network\"",
 
@@ -374,7 +382,7 @@ const client = new ApolloClient({
         "using a different fetchPolicy, such as cache-first or network-only."
   },
 
-  69: {
+  70: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.fetchPolicy !== \"standby\"",
 
@@ -383,7 +391,7 @@ const client = new ApolloClient({
         "as cache-first or network-only."
   },
 
-  70: {
+  71: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.query",
 
@@ -391,152 +399,158 @@ const client = new ApolloClient({
         "in the query option."
   },
 
-  71: {
+  72: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.query.kind === \"Document\"",
     message: 'You must wrap the query string in a "gql" tag.'
   },
 
-  72: {
+  73: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.returnPartialData",
     message: "returnPartialData option only supported on watchQuery."
   },
 
-  73: {
+  74: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.pollInterval",
     message: "pollInterval option only supported on watchQuery."
   },
 
-  74: {
+  75: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.notifyOnNetworkStatusChange",
     message: "notifyOnNetworkStatusChange option only supported on watchQuery."
   },
 
+  76: {
+    file: "@apollo/client/core/ApolloClient.js",
+    condition: "optionsWithDefaults.mutation",
+    message: "The `mutation` option is required. Please provide a GraphQL document in the `mutation` option."
+  },
+
   77: {
-    file: "@apollo/client/core/ObservableQuery.js",
-    condition: "updateQuery",
-    message: "You must provide an `updateQuery` function when using `fetchMore` with a `no-cache` fetch policy."
+    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."
   },
 
-  79: {
+  80: {
     file: "@apollo/client/core/ObservableQuery.js",
-    condition: "pollInterval",
-    message: "Attempted to start a polling query without a polling interval."
+    condition: "this.options.fetchPolicy !== \"cache-only\"",
+    message: "Cannot execute `fetchMore` for 'cache-only' query '%s'. Please use a different fetch policy."
   },
 
   81: {
-    file: "@apollo/client/core/QueryManager.js",
-    message: "QueryManager stopped while query was in flight"
-  },
-
-  82: {
-    file: "@apollo/client/core/QueryManager.js",
-    condition: "mutation",
-    message: "mutation option is required. You must specify your GraphQL document in the mutation option."
+    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: {
+  85: {
     file: "@apollo/client/core/QueryManager.js",
-    condition: "fetchPolicy === \"network-only\" || fetchPolicy === \"no-cache\"",
-    message: "Mutations support only 'network-only' or 'no-cache' fetchPolicy strings. The default `network-only` behavior automatically writes mutation results to the cache. Passing `no-cache` skips the cache write."
+    message: "QueryManager stopped while query was in flight"
   },
 
-  84: {
+  86: {
     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: {
+  87: {
     file: "@apollo/client/core/QueryManager.js",
     message: "Store reset while query was in flight (not completed in link chain)"
   },
 
-  88: {
+  90: {
     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: {
+  91: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "%s '%s' contains `@client` fields but local state has not been configured."
   },
 
-  90: {
+  92: {
+    file: "@apollo/client/core/QueryManager.js",
+    condition: "!hasIncrementalDirective",
+    message: "%s '%s' contains `@client` and `@defer` directives. These cannot be used together."
+  },
+
+  93: {
     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."
   },
 
-  92: {
+  95: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "Query '%s' contains `@client` fields but local state has not been configured."
   },
 
-  93: {
+  96: {
     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."
   },
 
-  94: {
+  97: {
     file: "@apollo/client/cache/inmemory/entityStore.js",
     condition: "typeof dataId === \"string\"",
     message: "store.merge expects a string ID"
   },
 
-  97: {
+  100: {
     file: "@apollo/client/cache/inmemory/key-extractor.js",
     condition: "extracted !== void 0",
     message: `Missing field '%s' while extracting keyFields from %s`
   },
 
-  98: {
+  101: {
     file: "@apollo/client/cache/inmemory/policies.js",
     condition: "!old || old === which",
     message: `Cannot change root %s __typename more than once`
   },
 
-  101: {
+  104: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: "Cannot automatically merge arrays"
   },
 
-  102: {
+  105: {
     file: "@apollo/client/cache/inmemory/readFromStore.js",
     message: `No fragment named %s`
   },
 
-  103: {
+  106: {
     file: "@apollo/client/cache/inmemory/readFromStore.js",
     condition: "!isReference(value)",
     message: `Missing selection set for object of type %s returned for query field %s`
   },
 
-  104: {
+  107: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Could not identify object %s`
   },
 
-  106: {
+  109: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `No fragment named %s`
   }
 };
 
 export const devDebug = {
-  75: {
+  78: {
     file: "@apollo/client/core/ApolloClient.js",
     message: `In client.refetchQueries, Promise.all promise rejected with error %o`
   },
 
-  80: {
+  84: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: `Missing cache result fields: %o`
   }
@@ -545,84 +559,84 @@ export const devDebug = {
 export const devLog = {};
 
 export const devWarn = {
-  35: {
+  36: {
     file: "@apollo/client/react/hooks/internal/validateSuspenseHookOptions.js",
     message: "Using `returnPartialData` with a `no-cache` fetch policy has no effect. To read partial data from the cache, consider using an alternate fetch policy."
   },
 
-  40: {
+  41: {
     file: "@apollo/client/masking/maskDefinition.js",
     message: "Accessing unmasked field on %s at path '%s'. This field will not be available when masking is enabled. Please read the field from the fragment instead."
   },
 
-  44: {
+  45: {
     file: "@apollo/client/masking/utils.js",
     message: "@unmask 'mode' argument does not support variables."
   },
 
-  45: {
+  46: {
     file: "@apollo/client/masking/utils.js",
     message: "@unmask 'mode' argument must be of type string."
   },
 
-  46: {
+  47: {
     file: "@apollo/client/masking/utils.js",
     message: "@unmask 'mode' argument does not recognize value '%s'."
   },
 
-  50: {
+  51: {
     file: "@apollo/client/local-state/LocalState.js",
     message: "Could not find a resolver for the '%s' field. The field value has been set to `null`."
   },
 
-  51: {
+  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."
   },
 
-  52: {
+  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`."
   },
 
-  53: {
+  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."
   },
 
-  61: {
-    file: "@apollo/client/link/http/createHttpLink.js",
-    message: "Multipart-subscriptions do not support @defer"
-  },
-
   64: {
     file: "@apollo/client/link/core/ApolloLink.js",
     message: `You are calling concat on a terminating link, which will have no effect %o`
   },
 
-  76: {
+  79: {
     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 })?`
   },
 
-  86: {
+  83: {
+    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."
+  },
+
+  88: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown query named "%s" requested in refetchQueries options.include array`
   },
 
-  87: {
+  89: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown anonymous query requested in refetchQueries options.include array`
   },
 
-  91: {
+  94: {
     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.'
   },
 
-  95: {
+  98: {
     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" +
@@ -630,24 +644,24 @@ Did you mean to call refetch(variables) instead of refetch({ variables })?`
         "`toReference(object, true)`"
   },
 
-  96: {
+  99: {
     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)`."
   },
 
-  99: {
+  102: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Inferring subtype %s of supertype %s`
   },
 
-  100: {
+  103: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Undefined 'from' passed to readField with arguments %s`
   },
 
-  107: {
+  110: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
 
     message: `Cache data may be lost when replacing the %s field of a %s object.
@@ -666,29 +680,29 @@ For more information about these options, please refer to the documentation:
 `
   },
 
-  108: {
+  111: {
     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."
   }
 };
 
 export const devError = {
-  13: {
+  14: {
     file: "@apollo/client/utilities/internal/removeDirectivesFromDocument.js",
     message: `Could not find operation or fragment`
   },
 
-  33: {
+  34: {
     file: "@apollo/client/react/hooks/useSyncExternalStore.js",
     message: "The result of getSnapshot should be cached to avoid an infinite loop"
   },
 
-  78: {
+  82: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: "Unhandled GraphQL subscription error"
   },
 
-  105: {
+  108: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Missing field '%s' while writing result %o`
   }