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

package/react/hooks-compiled/useLoadableQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLoadableQuery.js","sources":["../../../src/react/hooks/useLoadableQuery.ts"],"sourcesContent":["import * as React from \"react\";\n\nimport type {\n  ApolloClient,\n  DataState,\n  DefaultContext,\n  DocumentNode,\n  ErrorPolicy,\n  ObservableQuery,\n  OperationVariables,\n  RefetchOn,\n  RefetchWritePolicy,\n  TypedDocumentNode,\n  WatchQueryFetchPolicy,\n} from \"@apollo/client\";\nimport type { SubscribeToMoreFunction } from \"@apollo/client\";\nimport { canonicalStringify } from \"@apollo/client/cache\";\nimport type { QueryRef } from \"@apollo/client/react\";\nimport type {\n  CacheKey,\n  FetchMoreFunction,\n  RefetchFunction,\n} from \"@apollo/client/react/internal\";\nimport {\n  assertWrappedQueryRef,\n  getSuspenseCache,\n  unwrapQueryRef,\n  updateWrappedQueryRef,\n  wrapQueryRef,\n} from \"@apollo/client/react/internal\";\nimport { __DEV__ } from \"@apollo/client/utilities/environment\";\nimport type {\n  OptionWithFallback,\n  SignatureStyle,\n} from \"@apollo/client/utilities/internal\";\nimport { invariant } from \"@apollo/client/utilities/invariant\";\n\nimport { __use, useDeepMemo, useRenderGuard } from \"./internal/index.js\";\nimport { validateSuspenseHookOptions } from \"./internal/validateSuspenseHookOptions.js\";\nimport { useApolloClient } from \"./useApolloClient.js\";\n\ntype ResetFunction = () => void;\n\nexport declare namespace useLoadableQuery {\n  export type LoadQueryFunction<TVariables extends OperationVariables> = (\n    // Use variadic args to handle cases where TVariables is type `never`, in\n    // which case we don't want to allow a variables argument. In other\n    // words, we don't want to allow variables to be passed as an argument to this\n    // function if the query does not expect variables in the document.\n    ...args: {} extends TVariables ? [variables?: TVariables]\n    : [variables: TVariables]\n  ) => void;\n\n  export type Result<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n    TStates extends\n      DataState<TData>[\"dataState\"] = DataState<TData>[\"dataState\"],\n  > = [\n    loadQuery: LoadQueryFunction<TVariables>,\n    queryRef: QueryRef<TData, TVariables, TStates> | null,\n    handlers: Handlers<TData, TVariables>,\n  ];\n  export interface Handlers<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  > {\n    /** {@inheritDoc @apollo/client!QueryResultDocumentation#fetchMore:member} */\n    fetchMore: FetchMoreFunction<TData, TVariables>;\n    /** {@inheritDoc @apollo/client!QueryResultDocumentation#refetch:member} */\n    refetch: RefetchFunction<TData, TVariables>;\n    /** {@inheritDoc @apollo/client!ObservableQuery#subscribeToMore:member(1)} */\n    subscribeToMore: SubscribeToMoreFunction<TData, TVariables>;\n    /**\n     * A function that resets the `queryRef` back to `null`.\n     */\n    reset: ResetFunction;\n  }\n\n  export type FetchPolicy = Extract<\n    WatchQueryFetchPolicy,\n    \"cache-first\" | \"network-only\" | \"no-cache\" | \"cache-and-network\"\n  >;\n\n  export interface Options {\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#client:member} */\n    client?: ApolloClient;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#context:member} */\n    context?: DefaultContext;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#errorPolicy:member} */\n    errorPolicy?: ErrorPolicy;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#fetchPolicy:member} */\n    fetchPolicy?: FetchPolicy;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#queryKey:member} */\n    queryKey?: string | number | any[];\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#refetchWritePolicy:member} */\n    refetchWritePolicy?: RefetchWritePolicy;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#returnPartialData:member} */\n    returnPartialData?: boolean;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#refetchOn:member} */\n    refetchOn?: RefetchOn.Option;\n  }\n\n  export interface DefaultOptions\n    extends ApolloClient.DefaultOptions.WatchQuery.Calculated {}\n\n  export type ResultForOptions<\n    TData,\n    TVariables extends OperationVariables,\n    TOptions extends Record<string, never> | Options,\n  > = Result<\n    TData,\n    TVariables,\n    | \"complete\"\n    | \"streaming\"\n    | (OptionWithFallback<TOptions, DefaultOptions, \"errorPolicy\"> extends (\n        \"none\"\n      ) ?\n        never\n      : \"empty\")\n    | (OptionWithFallback<\n        TOptions,\n        DefaultOptions,\n        \"returnPartialData\"\n      > extends false ?\n        never\n      : \"partial\")\n  >;\n\n  export namespace DocumentationTypes {\n    export interface useLoadableQuery {\n      /**\n       * A hook for imperatively loading a query, such as responding to a user\n       * interaction.\n       *\n       * > Refer to the [Suspense - Fetching in response to user interaction](https://www.apollographql.com/docs/react/data/suspense#fetching-in-response-to-user-interaction) section for a more in-depth overview of `useLoadableQuery`.\n       *\n       * @example\n       *\n       * ```jsx\n       * import { gql, useLoadableQuery } from \"@apollo/client\";\n       *\n       * const GET_GREETING = gql`\n       *   query GetGreeting($language: String!) {\n       *     greeting(language: $language) {\n       *       message\n       *     }\n       *   }\n       * `;\n       *\n       * function App() {\n       *   const [loadGreeting, queryRef] = useLoadableQuery(GET_GREETING);\n       *\n       *   return (\n       *     <>\n       *       <button onClick={() => loadGreeting({ language: \"english\" })}>\n       *         Load greeting\n       *       </button>\n       *       <Suspense fallback={<div>Loading...</div>}>\n       *         {queryRef && <Hello queryRef={queryRef} />}\n       *       </Suspense>\n       *     </>\n       *   );\n       * }\n       *\n       * function Hello({ queryRef }) {\n       *   const { data } = useReadQuery(queryRef);\n       *\n       *   return <div>{data.greeting.message}</div>;\n       * }\n       * ```\n       *\n       * @param query - A GraphQL query document parsed into an AST by `gql`.\n       * @param options - Options to control how the query is executed.\n       * @returns A tuple in the form of `[loadQuery, queryRef, handlers]`\n       */\n      <\n        TData = unknown,\n        TVariables extends OperationVariables = OperationVariables,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options\n      ): useLoadableQuery.Result<TData, TVariables>;\n    }\n\n    export interface useLoadableQuery_Deprecated {\n      /**\n       * @deprecated Avoid manually specifying generics on `useLoadableQuery`.\n       * Instead, rely on TypeScript's type inference along with a correctly typed `TypedDocumentNode` to get accurate types for your query results.\n       *\n       * {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)}\n       */\n      <\n        TData = unknown,\n        TVariables extends OperationVariables = OperationVariables,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options\n      ): useLoadableQuery.Result<TData, TVariables>;\n    }\n  }\n\n  export namespace Signatures {\n    /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n    export interface Classic {\n      // _INFERENCE_ONLY_DO_NOT_SPECIFY is used to distinguish between inferred\n      // generics arguments and explicit generic arguments so that we can\n      // provide a `@deprecated` signature for explicit generic arguments. As\n      // soon as a user provides a generic arg (e.g. useLoadableQuery<TData>(query))`,\n      // the overload falls through to the overloads without\n      // _INFERENCE_ONLY_DO_NOT_SPECIFY.\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          returnPartialData: true;\n          errorPolicy: \"ignore\" | \"all\";\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"partial\" | \"empty\"\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          errorPolicy: \"ignore\" | \"all\";\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"empty\"\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          returnPartialData: true;\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"partial\"\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: useLoadableQuery.Options\n      ): useLoadableQuery.Result<TData, TVariables, \"complete\" | \"streaming\">;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery_Deprecated:call(1)} */\n      <TData, TVariables extends OperationVariables = OperationVariables>(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          returnPartialData: true;\n          errorPolicy: \"ignore\" | \"all\";\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"partial\" | \"empty\"\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery_Deprecated:call(1)} */\n      <TData, TVariables extends OperationVariables = OperationVariables>(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          errorPolicy: \"ignore\" | \"all\";\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"empty\"\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery_Deprecated:call(1)} */\n      <TData, TVariables extends OperationVariables = OperationVariables>(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          returnPartialData: true;\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"partial\"\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery_Deprecated:call(1)} */\n      <TData, TVariables extends OperationVariables = OperationVariables>(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: useLoadableQuery.Options\n      ): useLoadableQuery.Result<TData, TVariables, \"complete\" | \"streaming\">;\n    }\n\n    /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n    export interface Modern {\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        // this overload should never be manually defined, it should always be inferred\n        TOptions extends never,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>\n      ): useLoadableQuery.ResultForOptions<\n        TData,\n        TVariables,\n        Record<string, never>\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        // this overload should never be manually defined, it should always be inferred\n        TOptions extends useLoadableQuery.Options,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: TOptions\n      ): useLoadableQuery.ResultForOptions<TData, TVariables, TOptions>;\n    }\n\n    export type Evaluated = SignatureStyle extends \"classic\" ? Classic : Modern;\n  }\n\n  /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n  export interface Signature extends Signatures.Evaluated {}\n}\n\nexport const useLoadableQuery: useLoadableQuery.Signature =\n  function useLoadableQuery<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  >(\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n    options: useLoadableQuery.Options = {}\n  ): useLoadableQuery.Result<TData, TVariables> {\n    const client = useApolloClient(options.client);\n    const suspenseCache = getSuspenseCache(client);\n    const watchQueryOptions = useWatchQueryOptions({ client, query, options });\n    const { queryKey = [] } = options;\n\n    const [queryRef, setQueryRef] = React.useState<QueryRef<\n      TData,\n      TVariables,\n      DataState<TData>[\"dataState\"]\n    > | null>(null);\n\n    assertWrappedQueryRef(queryRef);\n\n    const internalQueryRef = queryRef && unwrapQueryRef(queryRef);\n\n    if (queryRef && internalQueryRef?.didChangeOptions(watchQueryOptions)) {\n      const promise = internalQueryRef.applyOptions(watchQueryOptions);\n      updateWrappedQueryRef(queryRef, promise);\n    }\n\n    const calledDuringRender = useRenderGuard();\n\n    const fetchMore: FetchMoreFunction<TData, TVariables> = React.useCallback(\n      (options) => {\n        if (!internalQueryRef) {\n          throw new Error(\n            \"The query has not been loaded. Please load the query.\"\n          );\n        }\n\n        const promise = internalQueryRef.fetchMore(options);\n\n        setQueryRef(wrapQueryRef(internalQueryRef));\n\n        return promise;\n      },\n      [internalQueryRef]\n    );\n\n    const refetch: RefetchFunction<TData, TVariables> = React.useCallback(\n      (options) => {\n        if (!internalQueryRef) {\n          throw new Error(\n            \"The query has not been loaded. Please load the query.\"\n          );\n        }\n\n        const promise = internalQueryRef.refetch(options);\n\n        setQueryRef(wrapQueryRef(internalQueryRef));\n\n        return promise;\n      },\n      [internalQueryRef]\n    );\n\n    const loadQuery: useLoadableQuery.LoadQueryFunction<TVariables> =\n      React.useCallback(\n        (...args) => {\n          invariant(\n            !calledDuringRender(),\n            \"useLoadableQuery: 'loadQuery' should not be called during render. To start a query during render, use the 'useBackgroundQuery' hook.\"\n          );\n\n          const [variables] = args;\n\n          const cacheKey: CacheKey = [\n            query,\n            canonicalStringify(variables),\n            ...([] as any[]).concat(queryKey),\n          ];\n\n          const queryRef = suspenseCache.getQueryRef(cacheKey, () =>\n            client.watchQuery({\n              ...watchQueryOptions,\n              variables,\n            } as ApolloClient.WatchQueryOptions<any, any>)\n          );\n\n          setQueryRef(wrapQueryRef(queryRef));\n        },\n        [\n          query,\n          queryKey,\n          suspenseCache,\n          watchQueryOptions,\n          calledDuringRender,\n          client,\n        ]\n      );\n\n    const subscribeToMore: SubscribeToMoreFunction<TData, TVariables> =\n      React.useCallback(\n        (options) => {\n          invariant(\n            internalQueryRef,\n            \"The query has not been loaded. Please load the query.\"\n          );\n\n          return internalQueryRef.observable.subscribeToMore(\n            // TODO: The internalQueryRef doesn't have TVariables' type information so we have to cast it here\n            options as any as ObservableQuery.SubscribeToMoreOptions<\n              TData,\n              OperationVariables\n            >\n          );\n        },\n        [internalQueryRef]\n      );\n\n    const reset: ResetFunction = React.useCallback(() => {\n      setQueryRef(null);\n    }, []);\n\n    return [\n      loadQuery,\n      queryRef,\n      { fetchMore, refetch, reset, subscribeToMore },\n    ];\n  } as any;\n\nfunction useWatchQueryOptions<TData, TVariables extends OperationVariables>({\n  client,\n  query,\n  options,\n}: {\n  client: ApolloClient;\n  query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n  options: useLoadableQuery.Options;\n}): ApolloClient.WatchQueryOptions<TData, TVariables> {\n  return useDeepMemo<ApolloClient.WatchQueryOptions<TData, TVariables>>(() => {\n    const fetchPolicy =\n      options.fetchPolicy ||\n      client.defaultOptions.watchQuery?.fetchPolicy ||\n      \"cache-first\";\n\n    const watchQueryOptions = {\n      ...options,\n      fetchPolicy,\n      query,\n      notifyOnNetworkStatusChange: false,\n      nextFetchPolicy: void 0,\n    };\n\n    if (__DEV__) {\n      validateSuspenseHookOptions(watchQueryOptions as any);\n    }\n\n    return watchQueryOptions as ApolloClient.WatchQueryOptions<\n      TData,\n      TVariables\n    >;\n  }, [client, options, query]);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"useLoadableQuery.js","sources":["../../../src/react/hooks/useLoadableQuery.ts"],"sourcesContent":["import * as React from \"react\";\n\nimport type {\n  ApolloClient,\n  DataState,\n  DefaultContext,\n  DocumentNode,\n  ErrorPolicy,\n  ObservableQuery,\n  OperationVariables,\n  RefetchOn,\n  RefetchWritePolicy,\n  TypedDocumentNode,\n  WatchQueryFetchPolicy,\n} from \"@apollo/client\";\nimport type { SubscribeToMoreFunction } from \"@apollo/client\";\nimport { canonicalStringify } from \"@apollo/client/cache\";\nimport type { QueryRef } from \"@apollo/client/react\";\nimport type {\n  CacheKey,\n  FetchMoreFunction,\n  RefetchFunction,\n} from \"@apollo/client/react/internal\";\nimport {\n  assertWrappedQueryRef,\n  getSuspenseCache,\n  unwrapQueryRef,\n  updateWrappedQueryRef,\n  wrapQueryRef,\n} from \"@apollo/client/react/internal\";\nimport { __DEV__ } from \"@apollo/client/utilities/environment\";\nimport type {\n  OptionWithFallback,\n  SignatureStyle,\n} from \"@apollo/client/utilities/internal\";\nimport { invariant } from \"@apollo/client/utilities/invariant\";\n\nimport { __use, useDeepMemo, useRenderGuard } from \"./internal/index.js\";\nimport { validateSuspenseHookOptions } from \"./internal/validateSuspenseHookOptions.js\";\nimport { useApolloClient } from \"./useApolloClient.js\";\n\ntype ResetFunction = () => void;\n\nexport declare namespace useLoadableQuery {\n  export type LoadQueryFunction<TVariables extends OperationVariables> = (\n    // Use variadic args to handle cases where TVariables is type `never`, in\n    // which case we don't want to allow a variables argument. In other\n    // words, we don't want to allow variables to be passed as an argument to this\n    // function if the query does not expect variables in the document.\n    ...args: {} extends TVariables ? [variables?: TVariables]\n    : [variables: TVariables]\n  ) => void;\n\n  export type Result<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n    TStates extends\n      DataState<TData>[\"dataState\"] = DataState<TData>[\"dataState\"],\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > = [\n    loadQuery: LoadQueryFunction<TVariables>,\n    queryRef: QueryRef<TData, TVariables, TStates> | null,\n    handlers: Handlers<TData, TVariables, TErrorPolicy>,\n  ];\n  export interface Handlers<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > {\n    /** {@inheritDoc @apollo/client!QueryResultDocumentation#fetchMore:member} */\n    fetchMore: FetchMoreFunction<TData, TVariables>;\n    /** {@inheritDoc @apollo/client!QueryResultDocumentation#refetch:member} */\n    refetch: RefetchFunction<TData, TVariables, TErrorPolicy>;\n    /** {@inheritDoc @apollo/client!ObservableQuery#subscribeToMore:member(1)} */\n    subscribeToMore: SubscribeToMoreFunction<TData, TVariables>;\n    /**\n     * A function that resets the `queryRef` back to `null`.\n     */\n    reset: ResetFunction;\n  }\n\n  export type FetchPolicy = Extract<\n    WatchQueryFetchPolicy,\n    \"cache-first\" | \"network-only\" | \"no-cache\" | \"cache-and-network\"\n  >;\n\n  export interface Options {\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#client:member} */\n    client?: ApolloClient;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#context:member} */\n    context?: DefaultContext;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#errorPolicy:member} */\n    errorPolicy?: ErrorPolicy;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#fetchPolicy:member} */\n    fetchPolicy?: FetchPolicy;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#queryKey:member} */\n    queryKey?: string | number | any[];\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#refetchWritePolicy:member} */\n    refetchWritePolicy?: RefetchWritePolicy;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#returnPartialData:member} */\n    returnPartialData?: boolean;\n\n    /** {@inheritDoc @apollo/client!QueryOptionsDocumentation#refetchOn:member} */\n    refetchOn?: RefetchOn.Option;\n  }\n\n  export interface DefaultOptions\n    extends ApolloClient.DefaultOptions.WatchQuery.Calculated {}\n\n  export type OptionsFor<TOptions> =\n    Exclude<keyof TOptions, keyof useLoadableQuery.Options> extends (\n      infer InvalidOptionNames extends string\n    ) ?\n      [InvalidOptionNames] extends [never] ?\n        unknown\n      : { [K in InvalidOptionNames]: never }\n    : never;\n\n  export type ResultForOptions<\n    TData,\n    TVariables extends OperationVariables,\n    TOptions extends Record<string, never> | Options,\n  > = Result<\n    TData,\n    TVariables,\n    | \"complete\"\n    | \"streaming\"\n    | (OptionWithFallback<TOptions, DefaultOptions, \"errorPolicy\"> extends (\n        \"none\"\n      ) ?\n        never\n      : \"empty\")\n    | (OptionWithFallback<\n        TOptions,\n        DefaultOptions,\n        \"returnPartialData\"\n      > extends false ?\n        never\n      : \"partial\"),\n    OptionWithFallback<TOptions, DefaultOptions, \"errorPolicy\"> & ErrorPolicy\n  >;\n\n  export namespace DocumentationTypes {\n    export interface useLoadableQuery {\n      /**\n       * A hook for imperatively loading a query, such as responding to a user\n       * interaction.\n       *\n       * > Refer to the [Suspense - Fetching in response to user interaction](https://www.apollographql.com/docs/react/data/suspense#fetching-in-response-to-user-interaction) section for a more in-depth overview of `useLoadableQuery`.\n       *\n       * @example\n       *\n       * ```jsx\n       * import { gql, useLoadableQuery } from \"@apollo/client\";\n       *\n       * const GET_GREETING = gql`\n       *   query GetGreeting($language: String!) {\n       *     greeting(language: $language) {\n       *       message\n       *     }\n       *   }\n       * `;\n       *\n       * function App() {\n       *   const [loadGreeting, queryRef] = useLoadableQuery(GET_GREETING);\n       *\n       *   return (\n       *     <>\n       *       <button onClick={() => loadGreeting({ language: \"english\" })}>\n       *         Load greeting\n       *       </button>\n       *       <Suspense fallback={<div>Loading...</div>}>\n       *         {queryRef && <Hello queryRef={queryRef} />}\n       *       </Suspense>\n       *     </>\n       *   );\n       * }\n       *\n       * function Hello({ queryRef }) {\n       *   const { data } = useReadQuery(queryRef);\n       *\n       *   return <div>{data.greeting.message}</div>;\n       * }\n       * ```\n       *\n       * @param query - A GraphQL query document parsed into an AST by `gql`.\n       * @param options - Options to control how the query is executed.\n       * @returns A tuple in the form of `[loadQuery, queryRef, handlers]`\n       */\n      <\n        TData = unknown,\n        TVariables extends OperationVariables = OperationVariables,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options\n      ): useLoadableQuery.Result<TData, TVariables>;\n    }\n\n    export interface useLoadableQuery_Deprecated {\n      /**\n       * @deprecated Avoid manually specifying generics on `useLoadableQuery`.\n       * Instead, rely on TypeScript's type inference along with a correctly typed `TypedDocumentNode` to get accurate types for your query results.\n       *\n       * {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)}\n       */\n      <\n        TData = unknown,\n        TVariables extends OperationVariables = OperationVariables,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options\n      ): useLoadableQuery.Result<TData, TVariables>;\n    }\n  }\n\n  export namespace Signatures {\n    /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n    export interface Classic {\n      // _INFERENCE_ONLY_DO_NOT_SPECIFY is used to distinguish between inferred\n      // generics arguments and explicit generic arguments so that we can\n      // provide a `@deprecated` signature for explicit generic arguments. As\n      // soon as a user provides a generic arg (e.g. useLoadableQuery<TData>(query))`,\n      // the overload falls through to the overloads without\n      // _INFERENCE_ONLY_DO_NOT_SPECIFY.\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          returnPartialData: true;\n          errorPolicy: TErrorPolicy & (\"ignore\" | \"all\");\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"partial\" | \"empty\",\n        TErrorPolicy\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          errorPolicy: TErrorPolicy & (\"ignore\" | \"all\");\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"empty\",\n        TErrorPolicy\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          returnPartialData: true;\n          errorPolicy?: TErrorPolicy;\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"partial\",\n        TErrorPolicy\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: useLoadableQuery.Options & { errorPolicy?: TErrorPolicy }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\",\n        TErrorPolicy\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery_Deprecated:call(1)} */\n      <TData, TVariables extends OperationVariables = OperationVariables>(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          returnPartialData: true;\n          errorPolicy: \"ignore\" | \"all\";\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"partial\" | \"empty\"\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery_Deprecated:call(1)} */\n      <TData, TVariables extends OperationVariables = OperationVariables>(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          errorPolicy: \"ignore\" | \"all\";\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"empty\"\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery_Deprecated:call(1)} */\n      <TData, TVariables extends OperationVariables = OperationVariables>(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: useLoadableQuery.Options & {\n          returnPartialData: true;\n        }\n      ): useLoadableQuery.Result<\n        TData,\n        TVariables,\n        \"complete\" | \"streaming\" | \"partial\"\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery_Deprecated:call(1)} */\n      <TData, TVariables extends OperationVariables = OperationVariables>(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: useLoadableQuery.Options\n      ): useLoadableQuery.Result<TData, TVariables, \"complete\" | \"streaming\">;\n    }\n\n    /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n    export interface Modern {\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        // this overload should never be manually defined, it should always be inferred\n        TOptions extends never,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>\n      ): useLoadableQuery.ResultForOptions<\n        TData,\n        TVariables,\n        Record<string, never>\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        // this overload should never be manually defined, it should always be inferred\n        TOptions extends useLoadableQuery.Options,\n      >(\n        query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options: TOptions & useLoadableQuery.OptionsFor<TOptions>\n      ): useLoadableQuery.ResultForOptions<TData, TVariables, TOptions>;\n    }\n\n    export type Evaluated = SignatureStyle extends \"classic\" ? Classic : Modern;\n  }\n\n  /** {@inheritDoc @apollo/client/react!useLoadableQuery.DocumentationTypes.useLoadableQuery:call(1)} */\n  export interface Signature extends Signatures.Evaluated {}\n}\n\nexport const useLoadableQuery: useLoadableQuery.Signature =\n  function useLoadableQuery<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  >(\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>,\n    options: useLoadableQuery.Options = {}\n  ): useLoadableQuery.Result<TData, TVariables> {\n    const client = useApolloClient(options.client);\n    const suspenseCache = getSuspenseCache(client);\n    const watchQueryOptions = useWatchQueryOptions({ client, query, options });\n    const { queryKey = [] } = options;\n\n    const [queryRef, setQueryRef] = React.useState<QueryRef<\n      TData,\n      TVariables,\n      DataState<TData>[\"dataState\"]\n    > | null>(null);\n\n    assertWrappedQueryRef(queryRef);\n\n    const internalQueryRef = queryRef && unwrapQueryRef(queryRef);\n\n    if (queryRef && internalQueryRef?.didChangeOptions(watchQueryOptions)) {\n      const promise = internalQueryRef.applyOptions(watchQueryOptions);\n      updateWrappedQueryRef(queryRef, promise);\n    }\n\n    const calledDuringRender = useRenderGuard();\n\n    const fetchMore = React.useCallback(\n      (\n        options: ObservableQuery.FetchMoreOptions<TData, TVariables, any, any>\n      ) => {\n        if (!internalQueryRef) {\n          throw new Error(\n            \"The query has not been loaded. Please load the query.\"\n          );\n        }\n\n        const promise = internalQueryRef.fetchMore(options);\n\n        setQueryRef(wrapQueryRef(internalQueryRef));\n\n        return promise;\n      },\n      [internalQueryRef]\n    ) as FetchMoreFunction<TData, TVariables>;\n\n    const refetch: RefetchFunction<TData, TVariables> = React.useCallback(\n      (options) => {\n        if (!internalQueryRef) {\n          throw new Error(\n            \"The query has not been loaded. Please load the query.\"\n          );\n        }\n\n        const promise = internalQueryRef.refetch(options);\n\n        setQueryRef(wrapQueryRef(internalQueryRef));\n\n        return promise;\n      },\n      [internalQueryRef]\n    );\n\n    const loadQuery: useLoadableQuery.LoadQueryFunction<TVariables> =\n      React.useCallback(\n        (...args) => {\n          invariant(\n            !calledDuringRender(),\n            \"useLoadableQuery: 'loadQuery' should not be called during render. To start a query during render, use the 'useBackgroundQuery' hook.\"\n          );\n\n          const [variables] = args;\n\n          const cacheKey: CacheKey = [\n            query,\n            canonicalStringify(variables),\n            ...([] as any[]).concat(queryKey),\n          ];\n\n          const queryRef = suspenseCache.getQueryRef(cacheKey, () =>\n            client.watchQuery({\n              ...watchQueryOptions,\n              variables,\n            } as ApolloClient.WatchQueryOptions<any, any>)\n          );\n\n          setQueryRef(wrapQueryRef(queryRef));\n        },\n        [\n          query,\n          queryKey,\n          suspenseCache,\n          watchQueryOptions,\n          calledDuringRender,\n          client,\n        ]\n      );\n\n    const subscribeToMore: SubscribeToMoreFunction<TData, TVariables> =\n      React.useCallback(\n        (options) => {\n          invariant(\n            internalQueryRef,\n            \"The query has not been loaded. Please load the query.\"\n          );\n\n          return internalQueryRef.observable.subscribeToMore(\n            // TODO: The internalQueryRef doesn't have TVariables' type information so we have to cast it here\n            options as any as ObservableQuery.SubscribeToMoreOptions<\n              TData,\n              OperationVariables\n            >\n          );\n        },\n        [internalQueryRef]\n      );\n\n    const reset: ResetFunction = React.useCallback(() => {\n      setQueryRef(null);\n    }, []);\n\n    return [\n      loadQuery,\n      queryRef,\n      { fetchMore, refetch, reset, subscribeToMore },\n    ];\n  } as any;\n\nfunction useWatchQueryOptions<TData, TVariables extends OperationVariables>({\n  client,\n  query,\n  options,\n}: {\n  client: ApolloClient;\n  query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n  options: useLoadableQuery.Options;\n}): ApolloClient.WatchQueryOptions<TData, TVariables> {\n  return useDeepMemo<ApolloClient.WatchQueryOptions<TData, TVariables>>(() => {\n    const fetchPolicy =\n      options.fetchPolicy ||\n      client.defaultOptions.watchQuery?.fetchPolicy ||\n      \"cache-first\";\n\n    const watchQueryOptions = {\n      ...options,\n      fetchPolicy,\n      query,\n      notifyOnNetworkStatusChange: false,\n      nextFetchPolicy: void 0,\n    };\n\n    if (__DEV__) {\n      validateSuspenseHookOptions(watchQueryOptions as any);\n    }\n\n    return watchQueryOptions as ApolloClient.WatchQueryOptions<\n      TData,\n      TVariables\n    >;\n  }, [client, options, query]);\n}\n"],"names":[],"mappings":"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"}

package/react/hooks-compiled/useMutation.d.ts

@@ -1,7 +1,7 @@
 import type { TypedDocumentNode } from "@graphql-typed-document-node/core";
 import type { ApolloClient, DefaultContext, DocumentNode, ErrorLike, ErrorPolicy, InternalRefetchQueriesInclude, MaybeMasked, MutationFetchPolicy, MutationQueryReducersMap, MutationUpdaterFunction, NormalizedExecutionResult, OnQueryUpdated, OperationVariables, Unmasked } from "@apollo/client";
 import type { Cache, IgnoreModifier } from "@apollo/client/cache";
-import type { LazyType, NoInfer, Prettify, SignatureStyle } from "@apollo/client/utilities/internal";
+import type { LazyType, NoInfer, OptionWithFallback, Prettify, SignatureStyle } from "@apollo/client/utilities/internal";
 type MakeRequiredVariablesOptional<TVariables extends OperationVariables, TConfiguredVariables extends Partial<TVariables>> = Prettify<{
     [K in keyof TVariables as K extends keyof TConfiguredVariables ? K : never]?: TVariables[K];
 } & Omit<TVariables, keyof TConfiguredVariables>>;
@@ -295,11 +295,14 @@ export declare namespace useMutation {
     };
     interface DefaultOptions extends ApolloClient.DefaultOptions.Mutate.Calculated {
     }
-    type ResultForOptions<TData, TVariables extends OperationVariables, TCache extends Cache.Implementation, TOptions extends Record<string, never> | Options<TData, TVariables, TCache>, TErrorPolicy extends ErrorPolicy | undefined = undefined> = LazyType<ResultTuple<TData, MakeRequiredVariablesOptional<TVariables, ExtractConfiguredVariables<TOptions, TVariables>>, TCache, [
-        TErrorPolicy
-    ] extends [undefined] ? DefaultOptions extends {
-        errorPolicy: infer D;
-    } ? D : undefined : TErrorPolicy>>;
+    type OptionsFor<TOptions> = Exclude<keyof TOptions, keyof useMutation.Options<any, any, any, any>> extends infer InvalidOptionNames extends string ? [
+        InvalidOptionNames
+    ] extends [never] ? unknown : {
+        [K in InvalidOptionNames]: never;
+    } : never;
+    type ResultForOptions<TData, TVariables extends OperationVariables, TCache extends Cache.Implementation, TOptions extends Record<string, never> | Options<TData, TVariables, TCache>, TErrorPolicy extends ErrorPolicy | undefined = undefined> = LazyType<ResultTuple<TData, MakeRequiredVariablesOptional<TVariables, ExtractConfiguredVariables<TOptions, TVariables>>, TCache, OptionWithFallback<{
+        errorPolicy: TErrorPolicy;
+    }, DefaultOptions, "errorPolicy"> & ErrorPolicy>>;
     namespace DocumentationTypes {
         /**
          * > Refer to the [Mutations](https://www.apollographql.com/docs/react/data/mutations/) section for a more in-depth overview of `useMutation`.
@@ -407,7 +410,7 @@ export declare namespace useMutation {
                 variables?: {
                     [K in Exclude<keyof TOptions["variables"], keyof TVariables>]?: never;
                 };
-            }, TErrorPolicy extends ErrorPolicy | undefined = undefined>(mutation: DocumentNode | TypedDocumentNode<TData, TVariables>, options?: TOptions & {
+            }, TErrorPolicy extends ErrorPolicy | undefined = undefined>(mutation: DocumentNode | TypedDocumentNode<TData, TVariables>, options?: TOptions & useMutation.OptionsFor<TOptions> & {
                 /**
                 * Specifies how the mutation handles a response that returns both GraphQL errors and partial results.
                 * 

package/react/hooks-compiled/useMutation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMutation.js","sources":["../../../src/react/hooks/useMutation.ts"],"sourcesContent":["import type { TypedDocumentNode } from \"@graphql-typed-document-node/core\";\nimport { equal } from \"@wry/equality\";\nimport * as React from \"react\";\n\nimport type {\n  ApolloClient,\n  DefaultContext,\n  DocumentNode,\n  ErrorLike,\n  ErrorPolicy,\n  InternalRefetchQueriesInclude,\n  MaybeMasked,\n  MutationFetchPolicy,\n  MutationQueryReducersMap,\n  MutationUpdaterFunction,\n  NormalizedExecutionResult,\n  OnQueryUpdated,\n  OperationVariables,\n  Unmasked,\n} from \"@apollo/client\";\nimport type { Cache, IgnoreModifier } from \"@apollo/client/cache\";\nimport type {\n  LazyType,\n  NoInfer,\n  Prettify,\n  SignatureStyle,\n} from \"@apollo/client/utilities/internal\";\nimport {\n  mergeOptions,\n  preventUnhandledRejection,\n} from \"@apollo/client/utilities/internal\";\n\nimport { useIsomorphicLayoutEffect } from \"./internal/useIsomorphicLayoutEffect.js\";\nimport { useApolloClient } from \"./useApolloClient.js\";\n\ntype MakeRequiredVariablesOptional<\n  TVariables extends OperationVariables,\n  TConfiguredVariables extends Partial<TVariables>,\n> = Prettify<\n  {\n    [K in keyof TVariables as K extends keyof TConfiguredVariables ? K\n    : never]?: TVariables[K];\n  } & Omit<TVariables, keyof TConfiguredVariables>\n>;\n\n// Extract the `variables` value from an inferred `TOptions`. We use a keyof\n// guard (rather than `TOptions extends { variables: infer V }`) because\n// `variables` in the modern signature's constraint is declared optional, so\n// the `extends { variables: infer V }` form fails to match when the user\n// passes a complex options object that gets widened to include the optional\n// modifier. `TOptions[\"variables\"]` works for both required and optional\n// `variables` entries.\ntype ExtractConfiguredVariables<\n  TOptions,\n  TVariables extends OperationVariables,\n> = \"variables\" extends keyof TOptions ?\n  Exclude<TOptions[\"variables\"], undefined> extends infer V ?\n    [V] extends [never] ? {}\n    : V extends Partial<TVariables> ? V\n    : {}\n  : {}\n: {};\n\nexport declare namespace useMutation {\n  export interface Options<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n    TCache extends Cache.Implementation = Cache.Implementation,\n    TConfiguredVariables extends Partial<TVariables> = Partial<TVariables>,\n  > {\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#optimisticResponse:member} */\n    optimisticResponse?:\n      | Unmasked<NoInfer<TData>>\n      | ((\n          vars: TVariables,\n          { IGNORE }: { IGNORE: IgnoreModifier }\n        ) => Unmasked<NoInfer<TData>> | IgnoreModifier);\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#updateQueries:member} */\n    updateQueries?: MutationQueryReducersMap<TData>;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#refetchQueries:member} */\n    refetchQueries?:\n      | ((\n          result: NormalizedExecutionResult<Unmasked<TData>>\n        ) => InternalRefetchQueriesInclude)\n      | InternalRefetchQueriesInclude;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#awaitRefetchQueries:member} */\n    awaitRefetchQueries?: boolean;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#update:member} */\n    update?: MutationUpdaterFunction<TData, TVariables, TCache>;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#onQueryUpdated:member} */\n    onQueryUpdated?: OnQueryUpdated<any>;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#errorPolicy:member} */\n    errorPolicy?: ErrorPolicy;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#variables:member} */\n    variables?: Partial<TVariables> & TConfiguredVariables;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#context:member} */\n    context?: DefaultContext;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#fetchPolicy:member} */\n    fetchPolicy?: MutationFetchPolicy;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#keepRootFields:member} */\n    keepRootFields?: boolean;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#client:member} */\n    client?: ApolloClient;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#notifyOnNetworkStatusChange:member} */\n    notifyOnNetworkStatusChange?: boolean;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#onCompleted:member} */\n    onCompleted?: (\n      data: MaybeMasked<TData>,\n      clientOptions?: Options<TData, TVariables, TCache>\n    ) => void;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#onError:member} */\n    onError?: (\n      error: ErrorLike,\n      clientOptions?: Options<TData, TVariables, TCache>\n    ) => void;\n  }\n\n  export namespace Base {\n    export interface Result {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#loading:member} */\n      loading: boolean;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#called:member} */\n      called: boolean;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#client:member} */\n      client: ApolloClient;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#reset:member} */\n      reset: () => void;\n    }\n  }\n\n  /**\n   * Maps `errorPolicy` to the shape of `data` and `error` as observable from\n   * the hook result state.\n   *\n   * The hook has additional states (before call, during loading) where `data`\n   * and `error` are `undefined`, so `data` remains nullable even on error\n   * policies that would otherwise guarantee it. Only `error` is narrowed away\n   * for `\"ignore\"`, since the underlying `client.mutate` promise never rejects\n   * and never resolves with an error for that policy.\n   */\n  export type ResultStateMap<TData = unknown> = {\n    none: {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n      data: MaybeMasked<TData> | null | undefined;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n      error: ErrorLike | undefined;\n    };\n    all: {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n      data: MaybeMasked<TData> | null | undefined;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n      error: ErrorLike | undefined;\n    };\n    ignore: {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n      data: MaybeMasked<TData> | null | undefined;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n      error: undefined;\n    };\n    undefined: {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n      data: MaybeMasked<TData> | null | undefined;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n      error: ErrorLike | undefined;\n    };\n  };\n\n  export type Result<\n    TData = unknown,\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > = Base.Result & ResultStateMap<TData>[`${TErrorPolicy}`];\n\n  export namespace DocumentationTypes {\n    namespace useMutation {\n      export interface Result<TData = unknown> extends Base.Result {\n        /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n        data: MaybeMasked<TData> | null | undefined;\n\n        /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n        error: ErrorLike | undefined;\n      }\n    }\n  }\n\n  export type ResultTuple<\n    TData,\n    TVariables extends OperationVariables,\n    TCache extends Cache.Implementation = Cache.Implementation,\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > = [\n    mutate: MutationFunction<TData, TVariables, TCache, TErrorPolicy>,\n    result: Result<TData, TErrorPolicy>,\n  ];\n\n  export type MutationFunction<\n    TData,\n    TVariables extends OperationVariables,\n    TCache extends Cache.Implementation = Cache.Implementation,\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > = (\n    ...[options]: {} extends TVariables ?\n      [\n        options?: MutationFunctionOptions<TData, TVariables, TCache> & {\n          /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#variables:member} */\n          variables?: TVariables;\n        },\n      ]\n    : [\n        options: MutationFunctionOptions<TData, TVariables, TCache> & {\n          /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#variables:member} */\n          variables: TVariables;\n        },\n      ]\n  ) => Promise<ApolloClient.MutateResult<MaybeMasked<TData>, TErrorPolicy>>;\n\n  export type MutationFunctionOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n    TCache extends Cache.Implementation = Cache.Implementation,\n  > = Options<TData, TVariables, TCache> & {\n    /**\n     * {@inheritDoc @apollo/client!MutationOptionsDocumentation#context:member}\n     *\n     * @remarks\n     * When provided as a callback function, the function is called with the\n     * value of `context` provided to the `useMutation` hook.\n     */\n    context?:\n      | DefaultContext\n      | ((hookContext: DefaultContext | undefined) => DefaultContext);\n  };\n\n  export interface DefaultOptions\n    extends ApolloClient.DefaultOptions.Mutate.Calculated {}\n\n  export type ResultForOptions<\n    TData,\n    TVariables extends OperationVariables,\n    TCache extends Cache.Implementation,\n    TOptions extends Record<string, never> | Options<TData, TVariables, TCache>,\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > = LazyType<\n    ResultTuple<\n      TData,\n      MakeRequiredVariablesOptional<\n        TVariables,\n        ExtractConfiguredVariables<TOptions, TVariables>\n      >,\n      TCache,\n      [TErrorPolicy] extends [undefined] ?\n        DefaultOptions extends { errorPolicy: infer D } ?\n          D\n        : undefined\n      : TErrorPolicy\n    >\n  >;\n\n  export namespace DocumentationTypes {\n    /**\n     * > Refer to the [Mutations](https://www.apollographql.com/docs/react/data/mutations/) section for a more in-depth overview of `useMutation`.\n     *\n     * @example\n     *\n     * ```jsx\n     * import { gql, useMutation } from \"@apollo/client\";\n     *\n     * const ADD_TODO = gql`\n     *   mutation AddTodo($type: String!) {\n     *     addTodo(type: $type) {\n     *       id\n     *       type\n     *     }\n     *   }\n     * `;\n     *\n     * function AddTodo() {\n     *   let input;\n     *   const [addTodo, { data }] = useMutation(ADD_TODO);\n     *\n     *   return (\n     *     <div>\n     *       <form\n     *         onSubmit={(e) => {\n     *           e.preventDefault();\n     *           addTodo({ variables: { type: input.value } });\n     *           input.value = \"\";\n     *         }}\n     *       >\n     *         <input\n     *           ref={(node) => {\n     *             input = node;\n     *           }}\n     *         />\n     *         <button type=\"submit\">Add Todo</button>\n     *       </form>\n     *     </div>\n     *   );\n     * }\n     * ```\n     *\n     * @param mutation - A GraphQL mutation document parsed into an AST by `gql`.\n     * @param options - Options to control how the mutation is executed.\n     * @returns A tuple in the form of `[mutate, result]`\n     */\n    export interface useMutation {\n      <\n        TData = unknown,\n        TVariables extends OperationVariables = OperationVariables,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: Options<TData, TVariables>\n      ): ResultTuple<TData, TVariables>;\n    }\n  }\n\n  export namespace Signatures {\n    /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n    export interface Classic {\n      // _INFERENCE_ONLY_DO_NOT_SPECIFY is used to distinguish between inferred\n      // generics arguments and explicit generic arguments so that we can\n      // provide a `@deprecated` signature for explicit generic arguments. As\n      // soon as a user provides a generic arg (e.g. useMutation<TData>(mutation))`,\n      // the overload falls through to the overloads without\n      // _INFERENCE_ONLY_DO_NOT_SPECIFY.\n\n      /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n        TConfiguredVariables extends Partial<TVariables> = {},\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: useMutation.Options<\n          NoInfer<TData>,\n          NoInfer<TVariables>,\n          Cache.Implementation,\n          {\n            [K in keyof TConfiguredVariables]: K extends keyof TVariables ?\n              TConfiguredVariables[K]\n            : never;\n          }\n        > & {\n          /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#errorPolicy:member} */\n          errorPolicy?: TErrorPolicy;\n        }\n      ): useMutation.ResultTuple<\n        TData,\n        MakeRequiredVariablesOptional<TVariables, TConfiguredVariables>,\n        Cache.Implementation,\n        TErrorPolicy\n      >;\n\n      /**\n       * @deprecated Avoid manually specifying generics on `useMutation`.\n       * Instead, rely on TypeScript's type inference along with a correctly typed `TypedDocumentNode` to get accurate types for your mutation results.\n       *\n       * {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)}\n       */\n      <\n        TData,\n        TVariables extends OperationVariables = OperationVariables,\n        TCache extends Cache.Implementation = Cache.Implementation,\n        TConfiguredVariables extends Partial<TVariables> = {},\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: useMutation.Options<\n          NoInfer<TData>,\n          NoInfer<TVariables>,\n          TCache,\n          {\n            [K in keyof TConfiguredVariables]: K extends keyof TVariables ?\n              TConfiguredVariables[K]\n            : never;\n          }\n        > &\n          (TErrorPolicy extends undefined ? {}\n          : {\n              /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#errorPolicy:member} */\n              errorPolicy: TErrorPolicy;\n            })\n      ): useMutation.ResultTuple<\n        TData,\n        MakeRequiredVariablesOptional<TVariables, TConfiguredVariables>,\n        TCache,\n        TErrorPolicy\n      >;\n    }\n\n    /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n    export interface Modern {\n      /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        // this overload should never be manually defined, it should always be inferred\n        TOptions extends never,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>\n      ): useMutation.ResultForOptions<\n        TData,\n        TVariables,\n        Cache.Implementation,\n        Record<string, never>\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        // this overload should never be manually defined, it should always be inferred\n        TOptions extends useMutation.Options<\n          NoInfer<TData>,\n          NoInfer<TVariables>,\n          Cache.Implementation\n        > & {\n          variables?: {\n            [K in Exclude<\n              keyof TOptions[\"variables\"],\n              keyof TVariables\n            >]?: never;\n          };\n        },\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: TOptions & {\n          /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#errorPolicy:member} */\n          errorPolicy?: TErrorPolicy;\n        }\n      ): useMutation.ResultForOptions<\n        TData,\n        TVariables,\n        Cache.Implementation,\n        TOptions,\n        TErrorPolicy\n      >;\n    }\n\n    export type Evaluated = SignatureStyle extends \"classic\" ? Classic : Modern;\n  }\n\n  /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n  export interface Signature extends Signatures.Evaluated {}\n}\n\n/** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\nexport const useMutation: useMutation.Signature = function useMutation<\n  TData = unknown,\n  TVariables extends OperationVariables = OperationVariables,\n  TCache extends Cache.Implementation = Cache.Implementation,\n  TConfiguredVariables extends Partial<TVariables> = {},\n>(\n  mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n  options?: useMutation.Options<\n    NoInfer<TData>,\n    NoInfer<TVariables>,\n    TCache,\n    {\n      [K in keyof TConfiguredVariables]: K extends keyof TVariables ?\n        TConfiguredVariables[K]\n      : never;\n    }\n  >\n): useMutation.ResultTuple<\n  TData,\n  MakeRequiredVariablesOptional<TVariables, TConfiguredVariables>,\n  TCache\n> {\n  const client = useApolloClient(options?.client);\n  const [result, setResult] = React.useState<\n    Omit<useMutation.Result<TData>, \"reset\">\n  >(() => createInitialResult(client));\n\n  const ref = React.useRef({\n    result,\n    mutationId: 0,\n    isMounted: true,\n    client,\n    mutation,\n    options,\n  });\n\n  useIsomorphicLayoutEffect(() => {\n    Object.assign(ref.current, { client, options, mutation });\n  });\n\n  const execute = React.useCallback(\n    (\n      executeOptions: useMutation.MutationFunctionOptions<\n        TData,\n        TVariables,\n        TCache\n      > = {} as useMutation.MutationFunctionOptions<TData, TVariables, TCache>\n    ) => {\n      const { options, mutation } = ref.current;\n      const baseOptions = { ...options, mutation };\n      const client = executeOptions.client || ref.current.client;\n      const context =\n        typeof executeOptions.context === \"function\" ?\n          executeOptions.context(options?.context)\n        : executeOptions.context;\n\n      if (!ref.current.result.loading && ref.current.isMounted) {\n        setResult(\n          (ref.current.result = {\n            loading: true,\n            error: undefined,\n            data: undefined,\n            called: true,\n            client,\n          })\n        );\n      }\n\n      const mutationId = ++ref.current.mutationId;\n      const clientOptions = mergeOptions(baseOptions, {\n        ...executeOptions,\n        context,\n      } as any);\n\n      return preventUnhandledRejection(\n        client\n          .mutate(\n            clientOptions as ApolloClient.MutateOptions<\n              TData,\n              OperationVariables\n            >\n          )\n          .then(\n            (response) => {\n              const { data, error } = response;\n\n              const onError =\n                executeOptions.onError || ref.current.options?.onError;\n\n              if (error && onError) {\n                onError(error, clientOptions);\n              }\n\n              if (mutationId === ref.current.mutationId) {\n                const result = {\n                  called: true,\n                  loading: false,\n                  data,\n                  error,\n                  client,\n                };\n\n                if (\n                  ref.current.isMounted &&\n                  !equal(ref.current.result, result)\n                ) {\n                  setResult((ref.current.result = result));\n                }\n              }\n\n              const onCompleted =\n                executeOptions.onCompleted || ref.current.options?.onCompleted;\n\n              if (!error) {\n                onCompleted?.(response.data!, clientOptions);\n              }\n\n              return response;\n            },\n            (error) => {\n              if (\n                mutationId === ref.current.mutationId &&\n                ref.current.isMounted\n              ) {\n                const result = {\n                  loading: false,\n                  error,\n                  data: void 0,\n                  called: true,\n                  client,\n                };\n\n                if (!equal(ref.current.result, result)) {\n                  setResult((ref.current.result = result));\n                }\n              }\n\n              const onError =\n                executeOptions.onError || ref.current.options?.onError;\n\n              if (onError) {\n                onError(error, clientOptions);\n              }\n\n              throw error;\n            }\n          )\n      );\n    },\n    []\n  );\n\n  const reset = React.useCallback(() => {\n    if (ref.current.isMounted) {\n      const result = createInitialResult(ref.current.client);\n      Object.assign(ref.current, { mutationId: 0, result });\n      setResult(result);\n    }\n  }, []);\n\n  React.useEffect(() => {\n    const current = ref.current;\n    current.isMounted = true;\n\n    return () => {\n      current.isMounted = false;\n    };\n  }, []);\n\n  return [execute as any, { reset, ...result }];\n} as any;\n\nfunction createInitialResult(client: ApolloClient) {\n  return {\n    data: undefined,\n    error: undefined,\n    called: false,\n    loading: false,\n    client,\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"useMutation.js","sources":["../../../src/react/hooks/useMutation.ts"],"sourcesContent":["import type { TypedDocumentNode } from \"@graphql-typed-document-node/core\";\nimport { equal } from \"@wry/equality\";\nimport * as React from \"react\";\n\nimport type {\n  ApolloClient,\n  DefaultContext,\n  DocumentNode,\n  ErrorLike,\n  ErrorPolicy,\n  InternalRefetchQueriesInclude,\n  MaybeMasked,\n  MutationFetchPolicy,\n  MutationQueryReducersMap,\n  MutationUpdaterFunction,\n  NormalizedExecutionResult,\n  OnQueryUpdated,\n  OperationVariables,\n  Unmasked,\n} from \"@apollo/client\";\nimport type { Cache, IgnoreModifier } from \"@apollo/client/cache\";\nimport type {\n  LazyType,\n  NoInfer,\n  OptionWithFallback,\n  Prettify,\n  SignatureStyle,\n} from \"@apollo/client/utilities/internal\";\nimport {\n  mergeOptions,\n  preventUnhandledRejection,\n} from \"@apollo/client/utilities/internal\";\n\nimport { useIsomorphicLayoutEffect } from \"./internal/useIsomorphicLayoutEffect.js\";\nimport { useApolloClient } from \"./useApolloClient.js\";\n\ntype MakeRequiredVariablesOptional<\n  TVariables extends OperationVariables,\n  TConfiguredVariables extends Partial<TVariables>,\n> = Prettify<\n  {\n    [K in keyof TVariables as K extends keyof TConfiguredVariables ? K\n    : never]?: TVariables[K];\n  } & Omit<TVariables, keyof TConfiguredVariables>\n>;\n\n// Extract the `variables` value from an inferred `TOptions`. We use a keyof\n// guard (rather than `TOptions extends { variables: infer V }`) because\n// `variables` in the modern signature's constraint is declared optional, so\n// the `extends { variables: infer V }` form fails to match when the user\n// passes a complex options object that gets widened to include the optional\n// modifier. `TOptions[\"variables\"]` works for both required and optional\n// `variables` entries.\ntype ExtractConfiguredVariables<\n  TOptions,\n  TVariables extends OperationVariables,\n> = \"variables\" extends keyof TOptions ?\n  Exclude<TOptions[\"variables\"], undefined> extends infer V ?\n    [V] extends [never] ? {}\n    : V extends Partial<TVariables> ? V\n    : {}\n  : {}\n: {};\n\nexport declare namespace useMutation {\n  export interface Options<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n    TCache extends Cache.Implementation = Cache.Implementation,\n    TConfiguredVariables extends Partial<TVariables> = Partial<TVariables>,\n  > {\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#optimisticResponse:member} */\n    optimisticResponse?:\n      | Unmasked<NoInfer<TData>>\n      | ((\n          vars: TVariables,\n          { IGNORE }: { IGNORE: IgnoreModifier }\n        ) => Unmasked<NoInfer<TData>> | IgnoreModifier);\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#updateQueries:member} */\n    updateQueries?: MutationQueryReducersMap<TData>;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#refetchQueries:member} */\n    refetchQueries?:\n      | ((\n          result: NormalizedExecutionResult<Unmasked<TData>>\n        ) => InternalRefetchQueriesInclude)\n      | InternalRefetchQueriesInclude;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#awaitRefetchQueries:member} */\n    awaitRefetchQueries?: boolean;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#update:member} */\n    update?: MutationUpdaterFunction<TData, TVariables, TCache>;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#onQueryUpdated:member} */\n    onQueryUpdated?: OnQueryUpdated<any>;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#errorPolicy:member} */\n    errorPolicy?: ErrorPolicy;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#variables:member} */\n    variables?: Partial<TVariables> & TConfiguredVariables;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#context:member} */\n    context?: DefaultContext;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#fetchPolicy:member} */\n    fetchPolicy?: MutationFetchPolicy;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#keepRootFields:member} */\n    keepRootFields?: boolean;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#client:member} */\n    client?: ApolloClient;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#notifyOnNetworkStatusChange:member} */\n    notifyOnNetworkStatusChange?: boolean;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#onCompleted:member} */\n    onCompleted?: (\n      data: MaybeMasked<TData>,\n      clientOptions?: Options<TData, TVariables, TCache>\n    ) => void;\n\n    /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#onError:member} */\n    onError?: (\n      error: ErrorLike,\n      clientOptions?: Options<TData, TVariables, TCache>\n    ) => void;\n  }\n\n  export namespace Base {\n    export interface Result {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#loading:member} */\n      loading: boolean;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#called:member} */\n      called: boolean;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#client:member} */\n      client: ApolloClient;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#reset:member} */\n      reset: () => void;\n    }\n  }\n\n  /**\n   * Maps `errorPolicy` to the shape of `data` and `error` as observable from\n   * the hook result state.\n   *\n   * The hook has additional states (before call, during loading) where `data`\n   * and `error` are `undefined`, so `data` remains nullable even on error\n   * policies that would otherwise guarantee it. Only `error` is narrowed away\n   * for `\"ignore\"`, since the underlying `client.mutate` promise never rejects\n   * and never resolves with an error for that policy.\n   */\n  export type ResultStateMap<TData = unknown> = {\n    none: {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n      data: MaybeMasked<TData> | null | undefined;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n      error: ErrorLike | undefined;\n    };\n    all: {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n      data: MaybeMasked<TData> | null | undefined;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n      error: ErrorLike | undefined;\n    };\n    ignore: {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n      data: MaybeMasked<TData> | null | undefined;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n      error: undefined;\n    };\n    undefined: {\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n      data: MaybeMasked<TData> | null | undefined;\n\n      /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n      error: ErrorLike | undefined;\n    };\n  };\n\n  export type Result<\n    TData = unknown,\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > = Base.Result & ResultStateMap<TData>[`${TErrorPolicy}`];\n\n  export namespace DocumentationTypes {\n    namespace useMutation {\n      export interface Result<TData = unknown> extends Base.Result {\n        /** {@inheritDoc @apollo/client!MutationResultDocumentation#data:member} */\n        data: MaybeMasked<TData> | null | undefined;\n\n        /** {@inheritDoc @apollo/client!MutationResultDocumentation#error:member} */\n        error: ErrorLike | undefined;\n      }\n    }\n  }\n\n  export type ResultTuple<\n    TData,\n    TVariables extends OperationVariables,\n    TCache extends Cache.Implementation = Cache.Implementation,\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > = [\n    mutate: MutationFunction<TData, TVariables, TCache, TErrorPolicy>,\n    result: Result<TData, TErrorPolicy>,\n  ];\n\n  export type MutationFunction<\n    TData,\n    TVariables extends OperationVariables,\n    TCache extends Cache.Implementation = Cache.Implementation,\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > = (\n    ...[options]: {} extends TVariables ?\n      [\n        options?: MutationFunctionOptions<TData, TVariables, TCache> & {\n          /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#variables:member} */\n          variables?: TVariables;\n        },\n      ]\n    : [\n        options: MutationFunctionOptions<TData, TVariables, TCache> & {\n          /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#variables:member} */\n          variables: TVariables;\n        },\n      ]\n  ) => Promise<ApolloClient.MutateResult<MaybeMasked<TData>, TErrorPolicy>>;\n\n  export type MutationFunctionOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n    TCache extends Cache.Implementation = Cache.Implementation,\n  > = Options<TData, TVariables, TCache> & {\n    /**\n     * {@inheritDoc @apollo/client!MutationOptionsDocumentation#context:member}\n     *\n     * @remarks\n     * When provided as a callback function, the function is called with the\n     * value of `context` provided to the `useMutation` hook.\n     */\n    context?:\n      | DefaultContext\n      | ((hookContext: DefaultContext | undefined) => DefaultContext);\n  };\n\n  export interface DefaultOptions\n    extends ApolloClient.DefaultOptions.Mutate.Calculated {}\n\n  export type OptionsFor<TOptions> =\n    Exclude<\n      keyof TOptions,\n      keyof useMutation.Options<any, any, any, any>\n    > extends infer InvalidOptionNames extends string ?\n      [InvalidOptionNames] extends [never] ?\n        unknown\n      : { [K in InvalidOptionNames]: never }\n    : never;\n\n  export type ResultForOptions<\n    TData,\n    TVariables extends OperationVariables,\n    TCache extends Cache.Implementation,\n    TOptions extends Record<string, never> | Options<TData, TVariables, TCache>,\n    TErrorPolicy extends ErrorPolicy | undefined = undefined,\n  > = LazyType<\n    ResultTuple<\n      TData,\n      MakeRequiredVariablesOptional<\n        TVariables,\n        ExtractConfiguredVariables<TOptions, TVariables>\n      >,\n      TCache,\n      OptionWithFallback<\n        { errorPolicy: TErrorPolicy },\n        DefaultOptions,\n        \"errorPolicy\"\n      > &\n        ErrorPolicy\n    >\n  >;\n\n  export namespace DocumentationTypes {\n    /**\n     * > Refer to the [Mutations](https://www.apollographql.com/docs/react/data/mutations/) section for a more in-depth overview of `useMutation`.\n     *\n     * @example\n     *\n     * ```jsx\n     * import { gql, useMutation } from \"@apollo/client\";\n     *\n     * const ADD_TODO = gql`\n     *   mutation AddTodo($type: String!) {\n     *     addTodo(type: $type) {\n     *       id\n     *       type\n     *     }\n     *   }\n     * `;\n     *\n     * function AddTodo() {\n     *   let input;\n     *   const [addTodo, { data }] = useMutation(ADD_TODO);\n     *\n     *   return (\n     *     <div>\n     *       <form\n     *         onSubmit={(e) => {\n     *           e.preventDefault();\n     *           addTodo({ variables: { type: input.value } });\n     *           input.value = \"\";\n     *         }}\n     *       >\n     *         <input\n     *           ref={(node) => {\n     *             input = node;\n     *           }}\n     *         />\n     *         <button type=\"submit\">Add Todo</button>\n     *       </form>\n     *     </div>\n     *   );\n     * }\n     * ```\n     *\n     * @param mutation - A GraphQL mutation document parsed into an AST by `gql`.\n     * @param options - Options to control how the mutation is executed.\n     * @returns A tuple in the form of `[mutate, result]`\n     */\n    export interface useMutation {\n      <\n        TData = unknown,\n        TVariables extends OperationVariables = OperationVariables,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: Options<TData, TVariables>\n      ): ResultTuple<TData, TVariables>;\n    }\n  }\n\n  export namespace Signatures {\n    /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n    export interface Classic {\n      // _INFERENCE_ONLY_DO_NOT_SPECIFY is used to distinguish between inferred\n      // generics arguments and explicit generic arguments so that we can\n      // provide a `@deprecated` signature for explicit generic arguments. As\n      // soon as a user provides a generic arg (e.g. useMutation<TData>(mutation))`,\n      // the overload falls through to the overloads without\n      // _INFERENCE_ONLY_DO_NOT_SPECIFY.\n\n      /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        _INFERENCE_ONLY_DO_NOT_SPECIFY extends \"inferred\",\n        TConfiguredVariables extends Partial<TVariables> = {},\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: useMutation.Options<\n          NoInfer<TData>,\n          NoInfer<TVariables>,\n          Cache.Implementation,\n          {\n            [K in keyof TConfiguredVariables]: K extends keyof TVariables ?\n              TConfiguredVariables[K]\n            : never;\n          }\n        > & {\n          /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#errorPolicy:member} */\n          errorPolicy?: TErrorPolicy;\n        }\n      ): useMutation.ResultTuple<\n        TData,\n        MakeRequiredVariablesOptional<TVariables, TConfiguredVariables>,\n        Cache.Implementation,\n        TErrorPolicy\n      >;\n\n      /**\n       * @deprecated Avoid manually specifying generics on `useMutation`.\n       * Instead, rely on TypeScript's type inference along with a correctly typed `TypedDocumentNode` to get accurate types for your mutation results.\n       *\n       * {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)}\n       */\n      <\n        TData,\n        TVariables extends OperationVariables = OperationVariables,\n        TCache extends Cache.Implementation = Cache.Implementation,\n        TConfiguredVariables extends Partial<TVariables> = {},\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: useMutation.Options<\n          NoInfer<TData>,\n          NoInfer<TVariables>,\n          TCache,\n          {\n            [K in keyof TConfiguredVariables]: K extends keyof TVariables ?\n              TConfiguredVariables[K]\n            : never;\n          }\n        > &\n          (TErrorPolicy extends undefined ? {}\n          : {\n              /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#errorPolicy:member} */\n              errorPolicy: TErrorPolicy;\n            })\n      ): useMutation.ResultTuple<\n        TData,\n        MakeRequiredVariablesOptional<TVariables, TConfiguredVariables>,\n        TCache,\n        TErrorPolicy\n      >;\n    }\n\n    /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n    export interface Modern {\n      /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        // this overload should never be manually defined, it should always be inferred\n        TOptions extends never,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>\n      ): useMutation.ResultForOptions<\n        TData,\n        TVariables,\n        Cache.Implementation,\n        Record<string, never>\n      >;\n\n      /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n      <\n        TData,\n        TVariables extends OperationVariables,\n        // this overload should never be manually defined, it should always be inferred\n        TOptions extends useMutation.Options<\n          NoInfer<TData>,\n          NoInfer<TVariables>,\n          Cache.Implementation\n        > & {\n          variables?: {\n            [K in Exclude<\n              keyof TOptions[\"variables\"],\n              keyof TVariables\n            >]?: never;\n          };\n        },\n        TErrorPolicy extends ErrorPolicy | undefined = undefined,\n      >(\n        mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n        options?: TOptions &\n          useMutation.OptionsFor<TOptions> & {\n            /** {@inheritDoc @apollo/client!MutationOptionsDocumentation#errorPolicy:member} */\n            errorPolicy?: TErrorPolicy;\n          }\n      ): useMutation.ResultForOptions<\n        TData,\n        TVariables,\n        Cache.Implementation,\n        TOptions,\n        TErrorPolicy\n      >;\n    }\n\n    export type Evaluated = SignatureStyle extends \"classic\" ? Classic : Modern;\n  }\n\n  /** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\n  export interface Signature extends Signatures.Evaluated {}\n}\n\n/** {@inheritDoc @apollo/client/react!useMutation.DocumentationTypes.useMutation:call(1)} */\nexport const useMutation: useMutation.Signature = function useMutation<\n  TData = unknown,\n  TVariables extends OperationVariables = OperationVariables,\n  TCache extends Cache.Implementation = Cache.Implementation,\n  TConfiguredVariables extends Partial<TVariables> = {},\n>(\n  mutation: DocumentNode | TypedDocumentNode<TData, TVariables>,\n  options?: useMutation.Options<\n    NoInfer<TData>,\n    NoInfer<TVariables>,\n    TCache,\n    {\n      [K in keyof TConfiguredVariables]: K extends keyof TVariables ?\n        TConfiguredVariables[K]\n      : never;\n    }\n  >\n): useMutation.ResultTuple<\n  TData,\n  MakeRequiredVariablesOptional<TVariables, TConfiguredVariables>,\n  TCache\n> {\n  const client = useApolloClient(options?.client);\n  const [result, setResult] = React.useState<\n    Omit<useMutation.Result<TData>, \"reset\">\n  >(() => createInitialResult(client));\n\n  const ref = React.useRef({\n    result,\n    mutationId: 0,\n    isMounted: true,\n    client,\n    mutation,\n    options,\n  });\n\n  useIsomorphicLayoutEffect(() => {\n    Object.assign(ref.current, { client, options, mutation });\n  });\n\n  const execute = React.useCallback(\n    (\n      executeOptions: useMutation.MutationFunctionOptions<\n        TData,\n        TVariables,\n        TCache\n      > = {} as useMutation.MutationFunctionOptions<TData, TVariables, TCache>\n    ) => {\n      const { options, mutation } = ref.current;\n      const baseOptions = { ...options, mutation };\n      const client = executeOptions.client || ref.current.client;\n      const context =\n        typeof executeOptions.context === \"function\" ?\n          executeOptions.context(options?.context)\n        : executeOptions.context;\n\n      if (!ref.current.result.loading && ref.current.isMounted) {\n        setResult(\n          (ref.current.result = {\n            loading: true,\n            error: undefined,\n            data: undefined,\n            called: true,\n            client,\n          })\n        );\n      }\n\n      const mutationId = ++ref.current.mutationId;\n      const clientOptions = mergeOptions(baseOptions, {\n        ...executeOptions,\n        context,\n      } as any);\n\n      return preventUnhandledRejection(\n        client\n          .mutate(\n            clientOptions as ApolloClient.MutateOptions<\n              TData,\n              OperationVariables\n            >\n          )\n          .then(\n            (response) => {\n              const { data, error } = response;\n\n              const onError =\n                executeOptions.onError || ref.current.options?.onError;\n\n              if (error && onError) {\n                onError(error, clientOptions);\n              }\n\n              if (mutationId === ref.current.mutationId) {\n                const result = {\n                  called: true,\n                  loading: false,\n                  data,\n                  error,\n                  client,\n                };\n\n                if (\n                  ref.current.isMounted &&\n                  !equal(ref.current.result, result)\n                ) {\n                  setResult((ref.current.result = result));\n                }\n              }\n\n              const onCompleted =\n                executeOptions.onCompleted || ref.current.options?.onCompleted;\n\n              if (!error) {\n                onCompleted?.(response.data!, clientOptions);\n              }\n\n              return response;\n            },\n            (error) => {\n              if (\n                mutationId === ref.current.mutationId &&\n                ref.current.isMounted\n              ) {\n                const result = {\n                  loading: false,\n                  error,\n                  data: void 0,\n                  called: true,\n                  client,\n                };\n\n                if (!equal(ref.current.result, result)) {\n                  setResult((ref.current.result = result));\n                }\n              }\n\n              const onError =\n                executeOptions.onError || ref.current.options?.onError;\n\n              if (onError) {\n                onError(error, clientOptions);\n              }\n\n              throw error;\n            }\n          )\n      );\n    },\n    []\n  );\n\n  const reset = React.useCallback(() => {\n    if (ref.current.isMounted) {\n      const result = createInitialResult(ref.current.client);\n      Object.assign(ref.current, { mutationId: 0, result });\n      setResult(result);\n    }\n  }, []);\n\n  React.useEffect(() => {\n    const current = ref.current;\n    current.isMounted = true;\n\n    return () => {\n      current.isMounted = false;\n    };\n  }, []);\n\n  return [execute as any, { reset, ...result }];\n} as any;\n\nfunction createInitialResult(client: ApolloClient) {\n  return {\n    data: undefined,\n    error: undefined,\n    called: false,\n    loading: false,\n    client,\n  };\n}\n"],"names":[],"mappings":"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"}

package/react/hooks-compiled/useQuery.d.ts

@@ -2,7 +2,8 @@ import type { DataState, DefaultContext, DocumentNode, ErrorLike, ErrorPolicy, G
 import type { ApolloClient } from "@apollo/client";
 import { NetworkStatus } from "@apollo/client";
 import type { MaybeMasked } from "@apollo/client/masking";
-import type { DocumentationTypes as UtilityDocumentationTypes, LazyType, NoInfer, OptionWithFallback, SignatureStyle, VariablesOption } from "@apollo/client/utilities/internal";
+import type { FetchMoreFunction, RefetchFunction } from "@apollo/client/react/internal";
+import type { DocumentationTypes as UtilityDocumentationTypes, LazyType, NoInfer, OptionWithFallback, Prettify, SignatureStyle, VariablesOption } from "@apollo/client/utilities/internal";
 import type { SkipToken } from "./constants.js";
 export declare namespace useQuery {
     namespace Base {
@@ -130,17 +131,33 @@ export declare namespace useQuery {
             * @docGroup 1. Operation options
             */
             refetchOn?: RefetchOn.Option;
+            /**
+            * 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<TData = unknown, TVariables extends OperationVariables = OperationVariables> = Base.Options<TData, TVariables> & VariablesOption<TVariables>;
     namespace DocumentationTypes {
         namespace useQuery {
-            interface Options<TData = unknown, TVariables extends OperationVariables = OperationVariables> extends Base.Options<TData, TVariables>, UtilityDocumentationTypes.VariableOptions<TVariables> {
+            interface Options<TData = unknown, TVariables extends OperationVariables = OperationVariables> extends Base.Options<TData, TVariables> {
+                /**
+                * 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;
             }
         }
     }
     namespace Base {
-        interface Result<TData = unknown, TVariables extends OperationVariables = OperationVariables, TReturnVariables extends OperationVariables = TVariables> {
+        interface Result<TData = unknown, TVariables extends OperationVariables = OperationVariables, TReturnVariables extends OperationVariables = TVariables, TErrorPolicy extends ErrorPolicy | undefined = undefined> {
             /**
             * The instance of Apollo Client that executed the query.
             * Can be useful for manually executing followup queries or writing data to the cache.
@@ -228,7 +245,7 @@ export declare namespace useQuery {
             * 
             * @docGroup 3. Helper functions
             */
-            refetch: (variables?: Partial<TVariables>) => Promise<ApolloClient.QueryResult<MaybeMasked<TData>>>;
+            refetch: RefetchFunction<TData, TVariables, TErrorPolicy>;
             /**
             * An object containing the variables that were provided for the query.
             * 
@@ -241,14 +258,25 @@ export declare namespace useQuery {
             * 
             * @docGroup 3. Helper functions
             */
-            fetchMore: <TFetchData = TData, TFetchVars extends OperationVariables = TVariables>(fetchMoreOptions: ObservableQuery.FetchMoreOptions<TData, TVariables, TFetchData, TFetchVars>) => Promise<ApolloClient.QueryResult<MaybeMasked<TFetchData>>>;
+            fetchMore: FetchMoreFunction<TData, TVariables>;
         }
     }
-    type Result<TData = unknown, TVariables extends OperationVariables = OperationVariables, TStates extends DataState<TData>["dataState"] = DataState<TData>["dataState"], TReturnVariables extends OperationVariables = TVariables> = Base.Result<TData, TVariables, TReturnVariables> & GetDataState<MaybeMasked<TData>, TStates>;
+    type Result<TData = unknown, TVariables extends OperationVariables = OperationVariables, TStates extends DataState<TData>["dataState"] = DataState<TData>["dataState"], TReturnVariables extends OperationVariables = TVariables, TErrorPolicy extends ErrorPolicy | undefined = undefined> = Base.Result<TData, TVariables, TReturnVariables, TErrorPolicy> & GetDataState<MaybeMasked<TData>, TStates>;
     interface DefaultOptions extends ApolloClient.DefaultOptions.WatchQuery.Calculated {
         skip: false;
     }
-    type ResultForOptions<TData, TVariables extends OperationVariables, TOptions extends Record<string, never> | Options<TData, TVariables> | SkipToken> = LazyType<Result<TData, TVariables, "complete" | "streaming" | "empty" | (TOptions extends any ? TOptions extends SkipToken ? never : OptionWithFallback<TOptions, DefaultOptions, "returnPartialData"> extends false ? never : "partial" : never)>>;
+    type OptionsFor<TData, TVariables extends OperationVariables, TOptions extends {
+        variables?: unknown;
+    }> = useQuery.Options<TData, NoInfer<TVariables>> & {
+        variables?: Prettify<TVariables & {
+            [K in keyof TOptions["variables"]]: K extends keyof TVariables ? TVariables[K] : never;
+        }>;
+    } & (Exclude<keyof Exclude<TOptions, SkipToken>, keyof useQuery.Options<TData, TVariables>> 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<TData, TVariables> | SkipToken> = LazyType<Result<TData, TVariables, "complete" | "streaming" | "empty" | (TOptions extends any ? TOptions extends SkipToken ? never : OptionWithFallback<TOptions, DefaultOptions, "returnPartialData"> extends false ? never : "partial" : never), TVariables, OptionWithFallback<TOptions, DefaultOptions, "errorPolicy"> & ErrorPolicy>>;
     namespace DocumentationTypes {
         namespace useQuery {
             interface Result<TData = unknown, TVariables extends OperationVariables = OperationVariables> extends Base.Result<TData, TVariables>, UtilityDocumentationTypes.DataState<TData> {
@@ -413,9 +441,10 @@ export declare namespace useQuery {
             * @param options - Options to control how the query is executed.
             * @returns Query result object
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
                 returnPartialData: true;
-            }): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming" | "partial">;
+                errorPolicy?: TErrorPolicy;
+            }): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming" | "partial", TVariables, TErrorPolicy>;
             /**
             * A hook for executing queries in an Apollo application.
             * 
@@ -489,9 +518,10 @@ export declare namespace useQuery {
             * @param options - Options to control how the query is executed.
             * @returns Query result object
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | (useQuery.Options<NoInfer<TData>, 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 | (useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
                 returnPartialData: true;
-            })): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming" | "partial", Partial<TVariables>>;
+                errorPolicy?: TErrorPolicy;
+            })): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming" | "partial", Partial<TVariables>, TErrorPolicy>;
             /**
             * A hook for executing queries in an Apollo application.
             * 
@@ -528,9 +558,10 @@ export declare namespace useQuery {
             * @param options - Options to control how the query is executed.
             * @returns Query result object
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
+            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred", TErrorPolicy extends ErrorPolicy | undefined = undefined>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
                 returnPartialData: boolean;
-            }): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming" | "partial">;
+                errorPolicy?: TErrorPolicy;
+            }): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming" | "partial", TVariables, TErrorPolicy>;
             /**
             * A hook for executing queries in an Apollo application.
             * 
@@ -567,9 +598,10 @@ export declare namespace useQuery {
             * @param options - Options to control how the query is executed.
             * @returns Query result object
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | (useQuery.Options<NoInfer<TData>, 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 | (useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
                 returnPartialData: boolean;
-            })): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming" | "partial", Partial<TVariables>>;
+                errorPolicy?: TErrorPolicy;
+            })): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming" | "partial", Partial<TVariables>, TErrorPolicy>;
             /**
             * A hook for executing queries in an Apollo application.
             * 
@@ -606,9 +638,15 @@ export declare namespace useQuery {
             * @param options - Options to control how the query is executed.
             * @returns Query result object
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
-                options?: useQuery.Options<NoInfer<TData>, NoInfer<TVariables>>
-            ] : [options: useQuery.Options<NoInfer<TData>, NoInfer<TVariables>>]): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming">;
+            <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?: useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
+                    errorPolicy?: TErrorPolicy;
+                }
+            ] : [
+                options: useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
+                    errorPolicy?: TErrorPolicy;
+                }
+            ]): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming", TVariables, TErrorPolicy>;
             /**
             * A hook for executing queries in an Apollo application.
             * 
@@ -645,11 +683,15 @@ export declare namespace useQuery {
             * @param options - Options to control how the query is executed.
             * @returns Query result object
             */
-            <TData, TVariables extends OperationVariables, _INFERENCE_ONLY_DO_NOT_SPECIFY extends "inferred">(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
-                options?: SkipToken | useQuery.Options<NoInfer<TData>, 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 | (useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
+                    errorPolicy?: TErrorPolicy;
+                })
             ] : [
-                options: SkipToken | useQuery.Options<NoInfer<TData>, NoInfer<TVariables>>
-            ]): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming", Partial<TVariables>>;
+                options: SkipToken | (useQuery.Options<NoInfer<TData>, NoInfer<TVariables>> & {
+                    errorPolicy?: TErrorPolicy;
+                })
+            ]): useQuery.Result<TData, TVariables, "empty" | "complete" | "streaming", Partial<TVariables>, TErrorPolicy>;
             /**
             * @deprecated Avoid manually specifying generics on `useQuery`.
             * Instead, rely on TypeScript's type inference along with a correctly typed `TypedDocumentNode` to get accurate types for your query results.
@@ -1063,12 +1105,12 @@ export declare namespace useQuery {
             * @param options - Options to control how the query is executed.
             * @returns Query result object
             */
-            <TData, TVariables extends OperationVariables, TOptions extends useQuery.Options<TData, NoInfer<TVariables>> & VariablesOption<TVariables & {
-                [K in Exclude<keyof TOptions["variables"], keyof TVariables>]?: never;
-            }>>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: [
+            <TData, TVariables extends OperationVariables, TOptions extends Base.Options<TData, NoInfer<TVariables>>>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: [
                 TVariables
-            ] extends [never] ? [options: never] : {} extends TVariables ? [options?: TOptions] : [
-                options: TOptions
+            ] extends [never] ? [options: never] : {} extends TVariables ? [
+                options?: TOptions & useQuery.OptionsFor<TData, TVariables, TOptions>
+            ] : [
+                options: TOptions & useQuery.OptionsFor<TData, TVariables, TOptions>
             ]): useQuery.ResultForOptions<TData, TVariables, TOptions>;
             /**
             * A hook for executing queries in an Apollo application.
@@ -1143,12 +1185,12 @@ export declare namespace useQuery {
             * @param options - Options to control how the query is executed.
             * @returns Query result object
             */
-            <TData, TVariables extends OperationVariables, TOptions extends useQuery.Options<TData, NoInfer<TVariables>> & VariablesOption<TVariables & {
-                [K in Exclude<keyof TOptions["variables"], keyof TVariables>]?: never;
-            }>>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: [
+            <TData, TVariables extends OperationVariables, TOptions extends Base.Options<TData, NoInfer<TVariables>>>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: [
                 TVariables
-            ] extends [never] ? [options: never] : {} extends TVariables ? [options?: TOptions | SkipToken] : [
-                options: TOptions | SkipToken
+            ] extends [never] ? [options: never] : {} extends TVariables ? [
+                options?: (TOptions & useQuery.OptionsFor<TData, TVariables, TOptions>) | SkipToken
+            ] : [
+                options: (TOptions & useQuery.OptionsFor<TData, TVariables, TOptions>) | SkipToken
             ]): useQuery.ResultForOptions<TData, TVariables, TOptions | SkipToken>;
             ssrDisabledResult: ObservableQuery.Result<any>;
         }