@apollo/client 4.0.0-alpha.4 → 4.0.0-alpha.5

package/core/types.d.ts

@@ -117,4 +117,36 @@ export interface Resolvers {
         [field: string]: Resolver;
     };
 }
+export interface MutateResult<TData = unknown> {
+    /**
+    * The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.
+    */
+    data: TData | undefined;
+    /**
+    * If the mutation produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.
+    * 
+    * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
+    */
+    error?: ErrorLike;
+    /**
+    * Custom extensions returned from the GraphQL server
+    */
+    extensions?: Record<string, unknown>;
+}
+export interface SubscribeResult<TData = unknown> {
+    /**
+    * The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.
+    */
+    data: TData | undefined;
+    /**
+    * If the mutation produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.
+    * 
+    * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
+    */
+    error?: ErrorLike;
+    /**
+    * Custom extensions returned from the GraphQL server
+    */
+    extensions?: Record<string, unknown>;
+}
 //# sourceMappingURL=types.d.ts.map

package/invariantErrorCodes.js

@@ -202,19 +202,19 @@ string in a "gql" tag? http://docs.apollostack.com/apollo-client/core.html#gql`
     message: "The query has not been loaded. Please load the query."
   },
 
-  40: {
+  36: {
     file: "@apollo/client/react/hooks/useSubscription.js",
     condition: "!optionsRef.current.skip",
     message: "A subscription that is skipped cannot be restarted."
   },
 
-  41: {
+  37: {
     file: "@apollo/client/react/hooks/useSuspenseQuery.js",
     condition: "supportedFetchPolicies.includes(fetchPolicy)",
     message: `The fetch policy \`%s\` is not supported with suspense.`
   },
 
-  44: {
+  40: {
     file: "@apollo/client/react/context/ApolloConsumer.js",
     condition: "context && context.client",
 
@@ -222,7 +222,7 @@ string in a "gql" tag? http://docs.apollostack.com/apollo-client/core.html#gql`
         "Wrap the root component in an <ApolloProvider>."
   },
 
-  45: {
+  41: {
     file: "@apollo/client/react/context/ApolloContext.js",
     condition: "\"createContext\" in React",
 
@@ -233,7 +233,7 @@ string in a "gql" tag? http://docs.apollostack.com/apollo-client/core.html#gql`
         "For more information, see https://nextjs.org/docs/getting-started/react-essentials#client-components"
   },
 
-  46: {
+  42: {
     file: "@apollo/client/react/context/ApolloProvider.js",
     condition: "context.client",
 
@@ -241,36 +241,36 @@ string in a "gql" tag? http://docs.apollostack.com/apollo-client/core.html#gql`
         'sure you pass in your client via the "client" prop.'
   },
 
-  47: {
+  43: {
     file: "@apollo/client/masking/maskDefinition.js",
     condition: "fragment",
     message: "Could not find fragment with name '%s'."
   },
 
-  49: {
+  45: {
     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.`
   },
 
-  50: {
+  46: {
     file: "@apollo/client/masking/maskFragment.js",
     condition: "!!fragment",
     message: `Could not find fragment with name "%s".`
   },
 
-  51: {
+  47: {
     file: "@apollo/client/masking/maskOperation.js",
     condition: "definition",
     message: "Expected a parsed GraphQL document with a query, mutation, or subscription."
   },
 
-  53: {
+  49: {
     file: "@apollo/client/link/utils/validateOperation.js",
     message: `illegal argument: %s`
   },
 
-  54: {
+  50: {
     file: "@apollo/client/link/persisted-queries/index.js",
     condition: "options &&\n    (typeof options.sha256 === \"function\" ||\n        typeof options.generateHash === \"function\")",
 
@@ -279,13 +279,13 @@ string in a "gql" tag? http://docs.apollostack.com/apollo-client/core.html#gql`
         "parameter."
   },
 
-  55: {
+  51: {
     file: "@apollo/client/link/persisted-queries/index.js",
     condition: "forward",
     message: "PersistedQueryLink cannot be the last link in the chain."
   },
 
-  56: {
+  52: {
     file: "@apollo/client/link/http/checkFetcher.js",
     condition: "fetcher || typeof fetch !== \"undefined\"",
 
@@ -303,23 +303,23 @@ const client = new ApolloClient({
     `
   },
 
-  58: {
+  54: {
     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`."
   },
 
-  59: {
+  55: {
     file: "@apollo/client/link/http/serializeFetchParameter.js",
     message: `Network request failed. %s is not serializable: %s`
   },
 
-  61: {
+  57: {
     file: "@apollo/client/link/core/ApolloLink.js",
     message: "request is not implemented"
   },
 
-  62: {
+  58: {
     file: "@apollo/client/core/ApolloClient.js",
 
     message: "To initialize Apollo Client, you must specify a 'cache' property " +
@@ -327,7 +327,7 @@ const client = new ApolloClient({
         "For more information, please visit: https://go.apollo.dev/c/docs"
   },
 
-  63: {
+  59: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.fetchPolicy !== \"cache-and-network\"",
 
@@ -337,48 +337,48 @@ const client = new ApolloClient({
         "using a different fetchPolicy, such as cache-first or network-only."
   },
 
-  65: {
+  61: {
     file: "@apollo/client/core/LocalState.js",
     condition: "fragment",
     message: `No fragment named %s`
   },
 
-  66: {
+  62: {
     file: "@apollo/client/core/LocalState.js",
     condition: "fragment",
     message: `No fragment named %s`
   },
 
-  68: {
+  64: {
     file: "@apollo/client/core/ObservableQuery.js",
     condition: "updateQuery",
     message: "You must provide an `updateQuery` function when using `fetchMore` with a `no-cache` fetch policy."
   },
 
-  70: {
+  66: {
     file: "@apollo/client/core/ObservableQuery.js",
     condition: "pollInterval",
     message: "Attempted to start a polling query without a polling interval."
   },
 
-  72: {
+  68: {
     file: "@apollo/client/core/QueryManager.js",
     message: "QueryManager stopped while query was in flight"
   },
 
-  73: {
+  69: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "mutation",
     message: "mutation option is required. You must specify your GraphQL document in the mutation option."
   },
 
-  74: {
+  70: {
     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."
   },
 
-  75: {
+  71: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "options.query",
 
@@ -386,81 +386,81 @@ const client = new ApolloClient({
         "in the query option."
   },
 
-  76: {
+  72: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "options.query.kind === \"Document\"",
     message: 'You must wrap the query string in a "gql" tag.'
   },
 
-  77: {
+  73: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "!options.returnPartialData",
     message: "returnPartialData option only supported on watchQuery."
   },
 
-  78: {
+  74: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "!options.pollInterval",
     message: "pollInterval option only supported on watchQuery."
   },
 
-  79: {
+  75: {
     file: "@apollo/client/core/QueryManager.js",
     message: "Store reset while query was in flight (not completed in link chain)"
   },
 
-  83: {
+  79: {
     file: "@apollo/client/cache/inmemory/entityStore.js",
     condition: "typeof dataId === \"string\"",
     message: "store.merge expects a string ID"
   },
 
-  86: {
+  82: {
     file: "@apollo/client/cache/inmemory/key-extractor.js",
     condition: "extracted !== void 0",
     message: `Missing field '%s' while extracting keyFields from %s`
   },
 
-  87: {
+  83: {
     file: "@apollo/client/cache/inmemory/policies.js",
     condition: "!old || old === which",
     message: `Cannot change root %s __typename more than once`
   },
 
-  90: {
+  86: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: "Cannot automatically merge arrays"
   },
 
-  91: {
+  87: {
     file: "@apollo/client/cache/inmemory/readFromStore.js",
     message: `No fragment named %s`
   },
 
-  92: {
+  88: {
     file: "@apollo/client/cache/inmemory/readFromStore.js",
     condition: "!isReference(value)",
     message: `Missing selection set for object of type %s returned for query field %s`
   },
 
-  93: {
+  89: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Could not identify object %s`
   },
 
-  95: {
+  91: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `No fragment named %s`
   }
 };
 
 export const devDebug = {
-  64: {
+  60: {
     file: "@apollo/client/core/ApolloClient.js",
     message: `In client.refetchQueries, Promise.all promise rejected with error %o`
   },
 
-  71: {
+  67: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: `Missing cache result fields: %o`
   }
@@ -491,74 +491,54 @@ export const devWarn = {
         "You may want to use the key parameter to specify a store key."
   },
 
-  36: {
-    file: "@apollo/client/react/hooks/useSubscription.js",
-    message: "'useSubscription' supports only the 'onSubscriptionData' or 'onData' option, but not both. Only the 'onData' option will be used."
-  },
-
-  37: {
-    file: "@apollo/client/react/hooks/useSubscription.js",
-    message: "'onSubscriptionData' is deprecated and will be removed in a future major version. Please use the 'onData' option instead."
-  },
-
   38: {
-    file: "@apollo/client/react/hooks/useSubscription.js",
-    message: "'useSubscription' supports only the 'onSubscriptionComplete' or 'onComplete' option, but not both. Only the 'onComplete' option will be used."
-  },
-
-  39: {
-    file: "@apollo/client/react/hooks/useSubscription.js",
-    message: "'onSubscriptionComplete' is deprecated and will be removed in a future major version. Please use the 'onComplete' option instead."
-  },
-
-  42: {
     file: "@apollo/client/react/hooks/useSuspenseQuery.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."
   },
 
-  48: {
+  44: {
     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."
   },
 
-  52: {
+  48: {
     file: "@apollo/client/masking/utils.js",
     message: "The configured cache does not support data masking which effectively disables it. Please use a cache that supports data masking or disable data masking to silence this warning."
   },
 
-  57: {
+  53: {
     file: "@apollo/client/link/http/createHttpLink.js",
     message: "Multipart-subscriptions do not support @defer"
   },
 
-  60: {
+  56: {
     file: "@apollo/client/link/core/ApolloLink.js",
     message: `You are calling concat on a terminating link, which will have no effect %o`
   },
 
-  67: {
+  63: {
     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 })?`
   },
 
-  80: {
+  76: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown query named "%s" requested in refetchQueries options.include array`
   },
 
-  81: {
+  77: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown anonymous query requested in refetchQueries options.include array`
   },
 
-  82: {
+  78: {
     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.'
   },
 
-  84: {
+  80: {
     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" +
@@ -566,24 +546,24 @@ Did you mean to call refetch(variables) instead of refetch({ variables })?`
         "`toReference(object, true)`"
   },
 
-  85: {
+  81: {
     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)`."
   },
 
-  88: {
+  84: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Inferring subtype %s of supertype %s`
   },
 
-  89: {
+  85: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Undefined 'from' passed to readField with arguments %s`
   },
 
-  96: {
+  92: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
 
     message: `Cache data may be lost when replacing the %s field of a %s object.
@@ -602,7 +582,7 @@ For more information about these options, please refer to the documentation:
 `
   },
 
-  97: {
+  93: {
     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."
   }
@@ -614,17 +594,17 @@ export const devError = {
     message: `Could not find operation or fragment`
   },
 
-  43: {
+  39: {
     file: "@apollo/client/react/hooks/useSyncExternalStore.js",
     message: "The result of getSnapshot should be cached to avoid an infinite loop"
   },
 
-  69: {
+  65: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: "Unhandled GraphQL subscription error"
   },
 
-  94: {
+  90: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Missing field '%s' while writing result %o`
   }

package/link/core/ApolloLink.js

@@ -46,7 +46,7 @@ export class ApolloLink {
     static concat(first, second) {
         const firstLink = toLink(first);
         if (isTerminating(firstLink)) {
-            __DEV__ && invariant.warn(60, firstLink);
+            __DEV__ && invariant.warn(56, firstLink);
             return firstLink;
         }
         const nextLink = toLink(second);
@@ -75,7 +75,7 @@ export class ApolloLink {
         return ApolloLink.concat(this, next);
     }
     request(operation, forward) {
-        throw newInvariantError(61);
+        throw newInvariantError(57);
     }
     onError(error, observer) {
         if (observer && observer.error) {

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", 56);
+    invariant(fetcher || typeof fetch !== "undefined", 52);
 };
 //# sourceMappingURL=checkFetcher.js.map

package/link/http/createHttpLink.js

@@ -90,7 +90,7 @@ export const createHttpLink = (linkOptions = {}) => {
             // Omit defer-specific headers if the user attempts to defer a selection
             // set on a subscription and log a warning.
             if (isSubscription && hasDefer) {
-                __DEV__ && invariant.warn(57);
+                __DEV__ && invariant.warn(53);
             }
             if (isSubscription) {
                 acceptHeader +=

package/link/http/parseAndCheckHttpResponse.js

@@ -22,7 +22,7 @@ export async function readMultipartBody(response, nextValue) {
         : "-";
     const boundary = `\r\n--${boundaryVal}`;
     let buffer = "";
-    invariant(response.body && typeof response.body.getReader === "function", 58);
+    invariant(response.body && typeof response.body.getReader === "function", 54);
     const iterator = response.body.getReader();
     let running = true;
     while (running) {

package/link/http/serializeFetchParameter.js

@@ -5,7 +5,7 @@ export const serializeFetchParameter = (p, label) => {
         serialized = JSON.stringify(p);
     }
     catch (e) {
-        const parseError = newInvariantError(59, label, e.message);
+        const parseError = newInvariantError(55, label, e.message);
         parseError.parseError = e;
         throw parseError;
     }

package/link/persisted-queries/index.js

@@ -43,7 +43,7 @@ export const createPersistedQueryLink = (options) => {
     // hashing with something other than SHA-256.
     invariant(options &&
         (typeof options.sha256 === "function" ||
-            typeof options.generateHash === "function"), 54);
+            typeof options.generateHash === "function"), 50);
     const { sha256, 
     // If both a `sha256` and `generateHash` option are provided, the
     // `sha256` option will be ignored. Developers can configure and
@@ -69,7 +69,7 @@ export const createPersistedQueryLink = (options) => {
         return hash;
     }
     return Object.assign(new ApolloLink((operation, forward) => {
-        invariant(forward, 55);
+        invariant(forward, 51);
         const { query } = operation;
         return new Observable((observer) => {
             let subscription;

package/link/utils/validateOperation.js

@@ -9,7 +9,7 @@ export function validateOperation(operation) {
     ];
     for (let key of Object.keys(operation)) {
         if (OPERATION_FIELDS.indexOf(key) < 0) {
-            throw newInvariantError(53, key);
+            throw newInvariantError(49, key);
         }
     }
     return operation;

package/masking/maskDefinition.js

@@ -86,7 +86,7 @@ function maskSelectionSet(data, selectionSet, context, migration, path) {
             const fragment = context.fragmentMap[fragmentName] ||
                 (context.fragmentMap[fragmentName] =
                     context.cache.lookupFragment(fragmentName));
-            invariant(fragment, 47, fragmentName);
+            invariant(fragment, 43, fragmentName);
             const mode = getFragmentMaskMode(selection);
             if (mode !== "mask") {
                 value = maskSelectionSet(data, fragment.selectionSet, context, mode === "migrate", path);
@@ -112,7 +112,7 @@ function getAccessorWarningDescriptor(fieldName, value, path, operationName, ope
         if (disableWarningsSlot.getValue()) {
             return value;
         }
-        __DEV__ && invariant.warn(48, operationName ?
+        __DEV__ && invariant.warn(44, operationName ?
             `${operationType} '${operationName}'`
             : `anonymous ${operationType}`, `${path}.${fieldName}`.replace(/^\./, ""));
         getValue = () => value;

package/masking/maskFragment.js

@@ -15,11 +15,11 @@ export function maskFragment(data, document, cache, fragmentName) {
     }
     const fragments = document.definitions.filter((node) => node.kind === Kind.FRAGMENT_DEFINITION);
     if (typeof fragmentName === "undefined") {
-        invariant(fragments.length === 1, 49, fragments.length);
+        invariant(fragments.length === 1, 45, fragments.length);
         fragmentName = fragments[0].name.value;
     }
     const fragment = fragments.find((fragment) => fragment.name.value === fragmentName);
-    invariant(!!fragment, 50, fragmentName);
+    invariant(!!fragment, 46, fragmentName);
     if (data == null) {
         // Maintain the original `null` or `undefined` value
         return data;

package/masking/maskOperation.js

@@ -12,7 +12,7 @@ export function maskOperation(data, document, cache) {
         return data;
     }
     const definition = getOperationDefinition(document);
-    invariant(definition, 51);
+    invariant(definition, 47);
     if (data == null) {
         // Maintain the original `null` or `undefined` value
         return data;

package/masking/utils.js

@@ -9,7 +9,7 @@ let issuedWarning = false;
 export function warnOnImproperCacheImplementation() {
     if (!issuedWarning) {
         issuedWarning = true;
-        __DEV__ && invariant.warn(52);
+        __DEV__ && invariant.warn(48);
     }
 }
 //# sourceMappingURL=utils.js.map

package/package.json

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

package/react/context/ApolloConsumer.js

@@ -4,7 +4,7 @@ import { getApolloContext } from "./ApolloContext.js";
 export const ApolloConsumer = (props) => {
     const ApolloContext = getApolloContext();
     return (React.createElement(ApolloContext.Consumer, null, (context) => {
-        invariant(context && context.client, 44);
+        invariant(context && context.client, 40);
         return props.children(context.client);
     }));
 };

package/react/context/ApolloContext.d.ts

@@ -1,9 +1,9 @@
 import type * as ReactTypes from "react";
 import type { ApolloClient } from "@apollo/client/core";
-import type { RenderPromises } from "@apollo/client/react/ssr";
+import type { HookWrappers, wrapperSymbol } from "@apollo/client/react/internal";
 export interface ApolloContextValue {
     client?: ApolloClient;
-    renderPromises?: RenderPromises;
+    [wrapperSymbol]?: HookWrappers;
 }
 export declare function getApolloContext(): ReactTypes.Context<ApolloContextValue>;
 //# sourceMappingURL=ApolloContext.d.ts.map

package/react/context/ApolloContext.js

@@ -6,7 +6,7 @@ import { invariant } from "@apollo/client/utilities/invariant";
 // context), a single Apollo context is created and tracked in global state.
 const contextKey = Symbol.for("__APOLLO_CONTEXT__");
 export function getApolloContext() {
-    invariant("createContext" in React, 45);
+    invariant("createContext" in React, 41);
     let context = React.createContext[contextKey];
     if (!context) {
         Object.defineProperty(React.createContext, contextKey, {