@apollo/client 4.3.0-alpha.1 → 4.3.0-alpha.11

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, 39, fragmentName);
+            invariant(fragment, 40, 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(40, operationName ?
+        __DEV__ && invariant.warn(41, operationName ?
             `${operationType} '${operationName}'`
             : `anonymous ${operationType}`, `${path}.${fieldName}`.replace(/^\./, ""));
         getValue = () => value;

package/masking/maskFragment.js

@@ -11,11 +11,11 @@ import { maskDefinition } from "./maskDefinition.js";
 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, 41, fragments.length);
+        invariant(fragments.length === 1, 42, fragments.length);
         fragmentName = fragments[0].name.value;
     }
     const fragment = fragments.find((fragment) => fragment.name.value === fragmentName);
-    invariant(!!fragment, 42, fragmentName);
+    invariant(!!fragment, 43, fragmentName);
     if (data == null) {
         // Maintain the original `null` or `undefined` value
         return data;

package/masking/maskOperation.js

@@ -8,7 +8,7 @@ import { maskDefinition } from "./maskDefinition.js";
 */
 export function maskOperation(data, document, cache) {
     const definition = getOperationDefinition(document);
-    invariant(definition, 43);
+    invariant(definition, 44);
     if (data == null) {
         // Maintain the original `null` or `undefined` value
         return data;

package/masking/utils.js

@@ -19,13 +19,13 @@ export function getFragmentMaskMode(fragment) {
     if (__DEV__) {
         if (modeArg) {
             if (modeArg.value.kind === Kind.VARIABLE) {
-                __DEV__ && invariant.warn(44);
+                __DEV__ && invariant.warn(45);
             }
             else if (modeArg.value.kind !== Kind.STRING) {
-                __DEV__ && invariant.warn(45);
+                __DEV__ && invariant.warn(46);
             }
             else if (modeArg.value.value !== "migrate") {
-                __DEV__ && invariant.warn(46, modeArg.value.value);
+                __DEV__ && invariant.warn(47, modeArg.value.value);
             }
         }
     }

package/package.json

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

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, 37);
+    invariant("createContext" in React, 38);
     let context = React.createContext[contextKey];
     if (!context) {
         Object.defineProperty(React.createContext, contextKey, {

package/react/context/ApolloProvider.js

@@ -10,7 +10,7 @@ export const ApolloProvider = ({ client, children, }) => {
             client: client || parentContext.client,
         };
     }, [parentContext, client]);
-    invariant(context.client, 38);
+    invariant(context.client, 39);
     return (React.createElement(ApolloContext.Provider, { value: context }, children));
 };
 //# sourceMappingURL=ApolloProvider.js.map

package/react/hooks/internal/validateSuspenseHookOptions.js

@@ -12,11 +12,11 @@ function validateFetchPolicy(fetchPolicy = "cache-first") {
         "no-cache",
         "cache-and-network",
     ];
-    invariant(supportedFetchPolicies.includes(fetchPolicy), 35, fetchPolicy);
+    invariant(supportedFetchPolicies.includes(fetchPolicy), 36, fetchPolicy);
 }
 function validatePartialDataReturn(fetchPolicy, returnPartialData) {
     if (fetchPolicy === "no-cache" && returnPartialData) {
-        __DEV__ && invariant.warn(36);
+        __DEV__ && invariant.warn(37);
     }
 }
 //# sourceMappingURL=validateSuspenseHookOptions.js.map

package/react/hooks/useApolloClient.js

@@ -19,7 +19,7 @@ import { getApolloContext } from "../context/ApolloContext.js";
 export function useApolloClient(override) {
     const context = React.useContext(getApolloContext());
     const client = override || context.client;
-    invariant(!!client, 28);
+    invariant(!!client, 29);
     return client;
 }
 //# sourceMappingURL=useApolloClient.js.map

package/react/hooks/useBackgroundQuery.d.ts

@@ -2,7 +2,7 @@ import type { ApolloClient, DefaultContext, DocumentNode, ErrorPolicy, Operation
 import type { SubscribeToMoreFunction } from "@apollo/client";
 import type { QueryRef } from "@apollo/client/react";
 import type { FetchMoreFunction, RefetchFunction } from "@apollo/client/react/internal";
-import type { DocumentationTypes as UtilityDocumentationTypes, NoInfer, OptionWithFallback, SignatureStyle, VariablesOption } from "@apollo/client/utilities/internal";
+import type { OptionWithFallback, Prettify, SignatureStyle, VariablesOption } from "@apollo/client/utilities/internal";
 import type { SkipToken } from "./constants.js";
 export declare namespace useBackgroundQuery {
     import _self = useBackgroundQuery;
@@ -114,16 +114,32 @@ export declare namespace useBackgroundQuery {
             * ```
             */
             skip?: boolean;
+            /**
+            * An object containing all of the GraphQL variables your query requires to execute.
+            * 
+            * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
+            * 
+            * @docGroup 1. Operation options
+            */
+            variables?: unknown;
         }
     }
     type Options<TVariables extends OperationVariables = OperationVariables> = Base.Options & VariablesOption<TVariables>;
     namespace DocumentationTypes {
         namespace useBackgroundQuery {
-            interface Options<TVariables extends OperationVariables = OperationVariables> extends Base.Options, UtilityDocumentationTypes.VariableOptions<TVariables> {
+            interface Options<TVariables extends OperationVariables = OperationVariables> extends Base.Options {
+                /**
+                * An object containing all of the GraphQL variables your query requires to execute.
+                * 
+                * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
+                * 
+                * @docGroup 1. Operation options
+                */
+                variables?: TVariables;
             }
         }
     }
-    interface Result<TData = unknown, TVariables extends OperationVariables = OperationVariables> {
+    interface Result<TData = unknown, TVariables extends OperationVariables = OperationVariables, TErrorPolicy extends ErrorPolicy | undefined = undefined> {
         /**
         * A function that enables you to execute a [subscription](https://www.apollographql.com/docs/react/data/subscriptions/), usually to subscribe to specific fields that were included in the query.
         * 
@@ -155,7 +171,7 @@ export declare namespace useBackgroundQuery {
         * @remarks
         * Calling this function will cause the component to re-suspend, unless the call site is wrapped in [`startTransition`](https://react.dev/reference/react/startTransition).
         */
-        refetch: RefetchFunction<TData, TVariables>;
+        refetch: RefetchFunction<TData, TVariables, TErrorPolicy>;
     }
     namespace DocumentationTypes {
         namespace useBackgroundQuery {
@@ -166,9 +182,20 @@ export declare namespace useBackgroundQuery {
     interface DefaultOptions extends ApolloClient.DefaultOptions.WatchQuery.Calculated {
         skip: false;
     }
-    type ResultForOptions<TData, TVariables extends OperationVariables, TOptions extends Record<string, never> | Options<TVariables> | SkipToken> = [
+    type OptionsFor<TVariables extends OperationVariables, TOptions extends {
+        variables?: unknown;
+    }> = useBackgroundQuery.Options<NoInfer<TVariables>> & {
+        variables?: Prettify<TVariables & {
+            [K in keyof TOptions["variables"]]: K extends keyof TVariables ? TVariables[K] : never;
+        }>;
+    } & (Exclude<keyof Exclude<TOptions, SkipToken>, keyof useBackgroundQuery.Options<any>> extends infer InvalidOptionNames extends string ? [
+        InvalidOptionNames
+    ] extends [never] ? unknown : {
+        [K in InvalidOptionNames]: never;
+    } : never);
+    type ResultForOptions<TData, TVariables extends OperationVariables, TOptions extends Record<string, never> | Base.Options | SkipToken> = [
         queryRef: TOptions extends any ? TOptions extends SkipToken ? undefined : QueryRef<TData, TVariables, "complete" | "streaming" | ((OptionWithFallback<TOptions, DefaultOptions, "errorPolicy"> extends "none" ? never : "empty") | (OptionWithFallback<TOptions, DefaultOptions, "returnPartialData"> extends false ? never : "partial"))> | (OptionWithFallback<TOptions, DefaultOptions, "skip"> extends false ? never : undefined) : never,
-        result: useBackgroundQuery.Result<TData, TVariables>
+        result: useBackgroundQuery.Result<TData, TVariables, OptionWithFallback<TOptions, DefaultOptions, "errorPolicy"> & ErrorPolicy>
     ];
     namespace DocumentationTypes {
         interface useBackgroundQuery {
@@ -434,13 +461,14 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 /** @deprecated `returnPartialData` has no effect on `no-cache` queries */
                 returnPartialData: boolean;
                 fetchPolicy: "no-cache";
+                errorPolicy?: TErrorPolicy;
             }): [
                 QueryRef<TData, TVariables, "complete" | "streaming">,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -503,12 +531,12 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 returnPartialData: false;
-                errorPolicy: "ignore" | "all";
+                errorPolicy: TErrorPolicy & ("ignore" | "all");
             }): [
                 QueryRef<TData, TVariables, "complete" | "streaming" | "empty">,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -571,12 +599,12 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 returnPartialData: boolean;
-                errorPolicy: "ignore" | "all";
+                errorPolicy: TErrorPolicy & ("ignore" | "all");
             }): [
                 QueryRef<TData, TVariables, "complete" | "streaming" | "partial" | "empty">,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -639,11 +667,11 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
-                errorPolicy: "ignore" | "all";
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+                errorPolicy: TErrorPolicy & ("ignore" | "all");
             }): [
                 QueryRef<TData, TVariables, "complete" | "streaming" | "empty">,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -706,12 +734,13 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 skip: boolean;
                 returnPartialData: false;
+                errorPolicy?: TErrorPolicy;
             }): [
                 QueryRef<TData, TVariables, "complete" | "streaming"> | undefined,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -774,12 +803,13 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 skip: boolean;
                 returnPartialData: boolean;
+                errorPolicy?: TErrorPolicy;
             }): [
                 (QueryRef<TData, TVariables, "complete" | "streaming" | "partial"> | undefined),
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -842,11 +872,12 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 returnPartialData: false;
+                errorPolicy?: TErrorPolicy;
             }): [
                 QueryRef<TData, TVariables, "complete" | "streaming">,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -909,11 +940,12 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 returnPartialData: boolean;
+                errorPolicy?: TErrorPolicy;
             }): [
                 QueryRef<TData, TVariables, "complete" | "streaming" | "partial">,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -976,11 +1008,12 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 skip: boolean;
+                errorPolicy?: TErrorPolicy;
             }): [
                 QueryRef<TData, TVariables, "complete" | "streaming"> | undefined,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -1105,11 +1138,12 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | (useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | (useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 returnPartialData: false;
+                errorPolicy?: TErrorPolicy;
             })): [
                 QueryRef<TData, TVariables, "complete" | "streaming"> | undefined,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -1172,11 +1206,12 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | (useBackgroundQuery.Options<NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | (useBackgroundQuery.Options<NoInfer<TVariables>> & {
                 returnPartialData: boolean;
+                errorPolicy?: TErrorPolicy;
             })): [
                 (QueryRef<TData, TVariables, "complete" | "streaming" | "partial"> | undefined),
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -1239,11 +1274,17 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
-                options?: useBackgroundQuery.Options<NoInfer<TVariables>>
-            ] : [options: useBackgroundQuery.Options<NoInfer<TVariables>>]): [
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
+                options?: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+                    errorPolicy?: TErrorPolicy;
+                }
+            ] : [
+                options: useBackgroundQuery.Options<NoInfer<TVariables>> & {
+                    errorPolicy?: TErrorPolicy;
+                }
+            ]): [
                 QueryRef<TData, TVariables, "complete" | "streaming">,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -1306,11 +1347,17 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
-                options?: SkipToken | useBackgroundQuery.Options<NoInfer<TVariables>>
-            ] : [options: SkipToken | useBackgroundQuery.Options<NoInfer<TVariables>>]): [
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
+                options?: SkipToken | (useBackgroundQuery.Options<NoInfer<TVariables>> & {
+                    errorPolicy?: TErrorPolicy;
+                })
+            ] : [
+                options: SkipToken | (useBackgroundQuery.Options<NoInfer<TVariables>> & {
+                    errorPolicy?: TErrorPolicy;
+                })
+            ]): [
                 QueryRef<TData, TVariables, "complete" | "streaming"> | undefined,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
@@ -1373,9 +1420,11 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | useBackgroundQuery.Options<NoInfer<TVariables>>): [
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | (useBackgroundQuery.Options<NoInfer<TVariables>> & {
+                errorPolicy?: TErrorPolicy;
+            })): [
                 QueryRef<TData, TVariables, "complete" | "streaming"> | undefined,
-                useBackgroundQuery.Result<TData, TVariables>
+                useBackgroundQuery.Result<TData, TVariables, TErrorPolicy>
             ];
             /**
             * @deprecated Avoid manually specifying generics on `useBackgroundQuery`.
@@ -2627,9 +2676,11 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, TOptions extends useBackgroundQuery.Options<NoInfer<TVariables>> & VariablesOption<TVariables & {
-                [K in Exclude<keyof TOptions["variables"], keyof TVariables>]?: never;
-            }>>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [options?: TOptions] : [options: TOptions]): useBackgroundQuery.ResultForOptions<TData, TVariables, TOptions>;
+            <TData, TVariables extends OperationVariables, TOptions extends Base.Options>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
+                options?: TOptions & useBackgroundQuery.OptionsFor<TVariables, TOptions>
+            ] : [
+                options: TOptions & useBackgroundQuery.OptionsFor<TVariables, TOptions>
+            ]): useBackgroundQuery.ResultForOptions<TData, TVariables, TOptions>;
             /**
             * For a detailed explanation of useBackgroundQuery, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
             * 
@@ -2753,9 +2804,11 @@ export declare namespace useBackgroundQuery {
             * @param query - A GraphQL query document parsed into an AST by `gql`.
             * @param options - An optional object containing options for the query. Instead of passing a `useBackgroundQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useBackgroundQuery` hook from executing the query or suspending.
             */
-            <TData, TVariables extends OperationVariables, TOptions extends useBackgroundQuery.Options<NoInfer<TVariables>> & VariablesOption<TVariables & {
-                [K in Exclude<keyof TOptions["variables"], keyof TVariables>]?: never;
-            }>>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [options?: TOptions | SkipToken] : [options: TOptions | SkipToken]): useBackgroundQuery.ResultForOptions<TData, TVariables, TOptions | SkipToken>;
+            <TData, TVariables extends OperationVariables, TOptions extends Base.Options>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
+                options?: (TOptions & useBackgroundQuery.OptionsFor<TVariables, TOptions>) | SkipToken
+            ] : [
+                options: (TOptions & useBackgroundQuery.OptionsFor<TVariables, TOptions>) | SkipToken
+            ]): useBackgroundQuery.ResultForOptions<TData, TVariables, TOptions | SkipToken>;
         }
         type Evaluated = SignatureStyle extends "classic" ? Classic : Modern;
     }