@apollo/client 3.9.0-rc.0 → 3.9.0

package/react/types/types.documentation.d.ts

@@ -0,0 +1,559 @@
+export interface QueryOptionsDocumentation {
+    /**
+     * A GraphQL query string parsed into an AST with the gql template literal.
+     *
+     * @docGroup 1. Operation options
+     */
+    query: unknown;
+    /**
+     * 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;
+    /**
+     * Specifies how the query handles a response that returns both GraphQL errors and partial results.
+     *
+     * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
+     *
+     * The default value is `none`, meaning that the query result includes error details but not partial results.
+     *
+     * @docGroup 1. Operation options
+     */
+    errorPolicy: unknown;
+    /**
+     * If you're using [Apollo Link](https://www.apollographql.com/docs/react/api/link/introduction/), this object is the initial value of the `context` object that's passed along your link chain.
+     *
+     * @docGroup 2. Networking options
+     */
+    context: unknown;
+    /**
+     * Specifies how the query interacts with the Apollo Client cache during execution (for example, whether it checks the cache for results before sending a request to the server).
+     *
+     * For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).
+     *
+     * The default value is `cache-first`.
+     *
+     * @docGroup 3. Caching options
+     */
+    fetchPolicy: unknown;
+    /**
+     * Specifies the {@link FetchPolicy} to be used after this query has completed.
+     *
+     * @docGroup 3. Caching options
+     */
+    nextFetchPolicy: unknown;
+    /**
+     * Defaults to the initial value of options.fetchPolicy, but can be explicitly
+     * configured to specify the WatchQueryFetchPolicy to revert back to whenever
+     * variables change (unless nextFetchPolicy intervenes).
+     *
+     * @docGroup 3. Caching options
+     */
+    initialFetchPolicy: unknown;
+    /**
+     * Specifies the interval (in milliseconds) at which the query polls for updated results.
+     *
+     * The default value is `0` (no polling).
+     *
+     * @docGroup 2. Networking options
+     */
+    pollInterval: unknown;
+    /**
+     * If `true`, the in-progress query's associated component re-renders whenever the network status changes or a network error occurs.
+     *
+     * The default value is `false`.
+     *
+     * @docGroup 2. Networking options
+     */
+    notifyOnNetworkStatusChange: unknown;
+    /**
+     * If `true`, the query can return partial results from the cache if the cache doesn't contain results for all queried fields.
+     *
+     * The default value is `false`.
+     *
+     * @docGroup 3. Caching options
+     */
+    returnPartialData: unknown;
+    /**
+     * Specifies whether a `NetworkStatus.refetch` operation should merge
+     * incoming field data with existing data, or overwrite the existing data.
+     * Overwriting is probably preferable, but merging is currently the default
+     * behavior, for backwards compatibility with Apollo Client 3.x.
+     *
+     * @docGroup 3. Caching options
+     */
+    refetchWritePolicy: unknown;
+    /**
+     * Watched queries must opt into overwriting existing data on refetch, by passing refetchWritePolicy: "overwrite" in their WatchQueryOptions.
+     *
+     * The default value is "overwrite".
+     *
+     * @docGroup 3. Caching options
+     */
+    refetchWritePolicy_suspense: unknown;
+    /**
+     * If `true`, causes a query refetch if the query result is detected as partial.
+     *
+     * The default value is `false`.
+     *
+     * @deprecated
+     * Setting this option is unnecessary in Apollo Client 3, thanks to a more consistent application of fetch policies. It might be removed in a future release.
+     */
+    partialRefetch: unknown;
+    /**
+     * Whether to canonize cache results before returning them. Canonization
+     * takes some extra time, but it speeds up future deep equality comparisons.
+     * Defaults to false.
+     *
+     * @deprecated
+     * Using `canonizeResults` can result in memory leaks so we generally do not
+     * recommend using this option anymore.
+     * A future version of Apollo Client will contain a similar feature without
+     * the risk of memory leaks.
+     */
+    canonizeResults: unknown;
+    /**
+     * If true, the query is not executed.
+     *
+     * The default value is `false`.
+     *
+     * @docGroup 1. Operation options
+     */
+    skip: unknown;
+    /**
+     * If `true`, the query is not executed. The default value is `false`.
+     *
+     * @deprecated We recommend using `skipToken` in place of the `skip` option as
+     * it is more type-safe.
+     *
+     * This option is deprecated and only supported to ease the migration from useQuery. It will be removed in a future release.
+     *
+     * @docGroup 1. Operation options
+     */
+    skip_deprecated: unknown;
+    /**
+     * A callback function that's called when your query successfully completes with zero errors (or if `errorPolicy` is `ignore` and partial data is returned).
+     *
+     * This function is passed the query's result `data`.
+     *
+     * @docGroup 1. Operation options
+     */
+    onCompleted: unknown;
+    /**
+     * A callback function that's called when the query encounters one or more errors (unless `errorPolicy` is `ignore`).
+     *
+     * This function is passed an `ApolloError` object that contains either a `networkError` object or a `graphQLErrors` array, depending on the error(s) that occurred.
+     *
+     * @docGroup 1. Operation options
+     */
+    onError: unknown;
+    /**
+     * The instance of {@link ApolloClient} to use to execute the query.
+     *
+     * By default, the instance that's passed down via context is used, but you
+     * can provide a different instance here.
+     *
+     * @docGroup 1. Operation options
+     */
+    client: unknown;
+    /**
+     * A unique identifier for the query. Each item in the array must be a stable
+     * identifier to prevent infinite fetches.
+     *
+     * This is useful when using the same query and variables combination in more
+     * than one component, otherwise the components may clobber each other. This
+     * can also be used to force the query to re-evaluate fresh.
+     *
+     * @docGroup 1. Operation options
+     */
+    queryKey: unknown;
+    /**
+     * Pass `false` to skip executing the query during [server-side rendering](https://www.apollographql.com/docs/react/performance/server-side-rendering/).
+     *
+     * @docGroup 2. Networking options
+     */
+    ssr: unknown;
+    /**
+     * A callback function that's called whenever a refetch attempt occurs
+     * while polling. If the function returns `true`, the refetch is
+     * skipped and not reattempted until the next poll interval.
+     *
+     * @docGroup 2. Networking options
+     */
+    skipPollAttempt: unknown;
+}
+export interface QueryResultDocumentation {
+    /**
+     * The instance of Apollo Client that executed the query.
+     * Can be useful for manually executing followup queries or writing data to the cache.
+     *
+     * @docGroup 2. Network info
+     */
+    client: unknown;
+    /**
+     * A reference to the internal `ObservableQuery` used by the hook.
+     */
+    observable: unknown;
+    /**
+     * An object containing the result of your GraphQL query after it completes.
+     *
+     * This value might be `undefined` if a query results in one or more errors (depending on the query's `errorPolicy`).
+     *
+     * @docGroup 1. Operation data
+     */
+    data: unknown;
+    /**
+     * An object containing the result from the most recent _previous_ execution of this query.
+     *
+     * This value is `undefined` if this is the query's first execution.
+     *
+     * @docGroup 1. Operation data
+     */
+    previousData: unknown;
+    /**
+     * If the query produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.
+     *
+     * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
+     *
+     * @docGroup 1. Operation data
+     */
+    error: unknown;
+    /**
+     * If `true`, the query is still in flight and results have not yet been returned.
+     *
+     * @docGroup 2. Network info
+     */
+    loading: unknown;
+    /**
+     * A number indicating the current network state of the query's associated request. [See possible values.](https://github.com/apollographql/apollo-client/blob/d96f4578f89b933c281bb775a39503f6cdb59ee8/src/core/networkStatus.ts#L4)
+     *
+     * Used in conjunction with the [`notifyOnNetworkStatusChange`](#notifyonnetworkstatuschange) option.
+     *
+     * @docGroup 2. Network info
+     */
+    networkStatus: unknown;
+    /**
+     * If `true`, the associated lazy query has been executed.
+     *
+     * This field is only present on the result object returned by [`useLazyQuery`](/react/data/queries/#executing-queries-manually).
+     *
+     * @docGroup 2. Network info
+     */
+    called: unknown;
+    /**
+     * An object containing the variables that were provided for the query.
+     *
+     * @docGroup 1. Operation data
+     */
+    variables: unknown;
+    /**
+     * A function that enables you to re-execute the query, optionally passing in new `variables`.
+     *
+     * To guarantee that the refetch performs a network request, its `fetchPolicy` is set to `network-only` (unless the original query's `fetchPolicy` is `no-cache` or `cache-and-network`, which also guarantee a network request).
+     *
+     * See also [Refetching](https://www.apollographql.com/docs/react/data/queries/#refetching).
+     *
+     *   @docGroup 3. Helper functions
+     */
+    refetch: unknown;
+    /**
+     * A function that helps you fetch the next set of results for a [paginated list field](https://www.apollographql.com/docs/react/pagination/core-api/).
+     * 
+     * 
+     * @docGroup 3. Helper functions
+     */
+    fetchMore: unknown;
+    /**
+     * A function that instructs the query to begin re-executing at a specified interval (in milliseconds).
+     * 
+     * 
+     * @docGroup 3. Helper functions
+     */
+    startPolling: unknown;
+    /**
+     * A function that instructs the query to stop polling after a previous call to `startPolling`.
+     * 
+     * 
+     * @docGroup 3. Helper functions
+     */
+    stopPolling: unknown;
+    /**
+     * A function that enables you to execute a [subscription](https://www.apollographql.com/docs/react/data/subscriptions/), usually to subscribe to specific fields that were included in the query.
+     * 
+     * This function returns _another_ function that you can call to terminate the subscription.
+     * 
+     * 
+     * @docGroup 3. Helper functions
+     */
+    subscribeToMore: unknown;
+    /**
+     * A function that enables you to update the query's cached result without executing a followup GraphQL operation.
+     * 
+     * See [using updateQuery and updateFragment](https://www.apollographql.com/docs/react/caching/cache-interaction/#using-updatequery-and-updatefragment) for additional information.
+     * 
+     * 
+     * @docGroup 3. Helper functions
+     */
+    updateQuery: unknown;
+}
+export interface MutationOptionsDocumentation {
+    /**
+     * A GraphQL document, often created with `gql` from the `graphql-tag`
+     * package, that contains a single mutation inside of it.
+     *
+     * @docGroup 1. Operation options
+     */
+    mutation: unknown;
+    /**
+     * Provide `no-cache` if the mutation's result should _not_ be written to the Apollo Client cache.
+     *
+     * The default value is `network-only` (which means the result _is_ written to the cache).
+     *
+     * Unlike queries, mutations _do not_ support [fetch policies](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy) besides `network-only` and `no-cache`.
+     *
+     * @docGroup 3. Caching options
+     */
+    fetchPolicy: unknown;
+    /**
+     * To avoid retaining sensitive information from mutation root field
+     * arguments, Apollo Client v3.4+ automatically clears any `ROOT_MUTATION`
+     * fields from the cache after each mutation finishes. If you need this
+     * information to remain in the cache, you can prevent the removal by passing
+     * `keepRootFields: true` to the mutation. `ROOT_MUTATION` result data are
+     * also passed to the mutation `update` function, so we recommend obtaining
+     * the results that way, rather than using this option, if possible.
+     */
+    keepRootFields: unknown;
+    /**
+     * By providing either an object or a callback function that, when invoked after
+     * a mutation, allows you to return optimistic data and optionally skip updates
+     * via the `IGNORE` sentinel object, Apollo Client caches this temporary
+     * (and potentially incorrect) response until the mutation completes, enabling
+     * more responsive UI updates.
+     *
+     * For more information, see [Optimistic mutation results](https://www.apollographql.com/docs/react/performance/optimistic-ui/).
+     *
+     * @docGroup 3. Caching options
+     */
+    optimisticResponse: unknown;
+    /**
+     * A {@link MutationQueryReducersMap}, which is map from query names to
+     * mutation query reducers. Briefly, this map defines how to incorporate the
+     * results of the mutation into the results of queries that are currently
+     * being watched by your application.
+     */
+    updateQueries: unknown;
+    /**
+     * An array (or a function that _returns_ an array) that specifies which queries you want to refetch after the mutation occurs.
+     *
+     * Each array value can be either:
+     *
+     * - An object containing the `query` to execute, along with any `variables`
+     *
+     * - A string indicating the operation name of the query to refetch
+     *
+     * @docGroup 1. Operation options
+     */
+    refetchQueries: unknown;
+    /**
+     * If `true`, makes sure all queries included in `refetchQueries` are completed before the mutation is considered complete.
+     *
+     * The default value is `false` (queries are refetched asynchronously).
+     *
+     * @docGroup 1. Operation options
+     */
+    awaitRefetchQueries: unknown;
+    /**
+     * A function used to update the Apollo Client cache after the mutation completes.
+     *
+     * For more information, see [Updating the cache after a mutation](https://www.apollographql.com/docs/react/data/mutations#updating-the-cache-after-a-mutation).
+     *
+     * @docGroup 3. Caching options
+     */
+    update: unknown;
+    /**
+     * Optional callback for intercepting queries whose cache data has been updated by the mutation, as well as any queries specified in the `refetchQueries: [...]` list passed to `client.mutate`.
+     *
+     * Returning a `Promise` from `onQueryUpdated` will cause the final mutation `Promise` to await the returned `Promise`. Returning `false` causes the query to be ignored.
+     *
+     * @docGroup 1. Operation options
+     */
+    onQueryUpdated: unknown;
+    /**
+     * Specifies how the mutation handles a response that returns both GraphQL errors and partial results.
+     *
+     * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
+     *
+     * The default value is `none`, meaning that the mutation result includes error details but _not_ partial results.
+     *
+     * @docGroup 1. Operation options
+     */
+    errorPolicy: unknown;
+    /**
+     * An object containing all of the GraphQL variables your mutation 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;
+    /**
+     * If you're using [Apollo Link](https://www.apollographql.com/docs/react/api/link/introduction/), this object is the initial value of the `context` object that's passed along your link chain.
+     *
+     * @docGroup 2. Networking options
+     */
+    context: unknown;
+    /**
+     * The instance of `ApolloClient` to use to execute the mutation.
+     *
+     * By default, the instance that's passed down via context is used, but you can provide a different instance here.
+     *
+     * @docGroup 2. Networking options
+     */
+    client: unknown;
+    /**
+     * If `true`, the in-progress mutation's associated component re-renders whenever the network status changes or a network error occurs.
+     *
+     * The default value is `false`.
+     *
+     * @docGroup 2. Networking options
+     */
+    notifyOnNetworkStatusChange: unknown;
+    /**
+     * A callback function that's called when your mutation successfully completes with zero errors (or if `errorPolicy` is `ignore` and partial data is returned).
+     *
+     * This function is passed the mutation's result `data` and any options passed to the mutation.
+     *
+     * @docGroup 1. Operation options
+     */
+    onCompleted: unknown;
+    /**
+     * A callback function that's called when the mutation encounters one or more errors (unless `errorPolicy` is `ignore`).
+     *
+     * This function is passed an [`ApolloError`](https://github.com/apollographql/apollo-client/blob/d96f4578f89b933c281bb775a39503f6cdb59ee8/src/errors/index.ts#L36-L39) object that contains either a `networkError` object or a `graphQLErrors` array, depending on the error(s) that occurred, as well as any options passed the mutation.
+     *
+     * @docGroup 1. Operation options
+     */
+    onError: unknown;
+    /**
+     * If `true`, the mutation's `data` property is not updated with the mutation's result.
+     *
+     * The default value is `false`.
+     *
+     * @docGroup 1. Operation options
+     */
+    ignoreResults: unknown;
+}
+export interface MutationResultDocumentation {
+    /**
+     * The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.
+     */
+    data: unknown;
+    /**
+     * If the mutation produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.
+     *
+     * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
+     */
+    error: unknown;
+    /**
+     * If `true`, the mutation is currently in flight.
+     */
+    loading: unknown;
+    /**
+     * If `true`, the mutation's mutate function has been called.
+     */
+    called: unknown;
+    /**
+     * The instance of Apollo Client that executed the mutation.
+     *
+     * Can be useful for manually executing followup operations or writing data to the cache.
+     */
+    client: unknown;
+    /**
+     * A function that you can call to reset the mutation's result to its initial, uncalled state.
+     */
+    reset: unknown;
+}
+export interface SubscriptionOptionsDocumentation {
+    /**
+     * A GraphQL document, often created with `gql` from the `graphql-tag`
+     * package, that contains a single subscription inside of it.
+     */
+    query: unknown;
+    /**
+     * An object containing all of the variables your subscription needs to execute
+     */
+    variables: unknown;
+    /**
+     * Specifies the {@link ErrorPolicy} to be used for this operation
+     */
+    errorPolicy: unknown;
+    /**
+     * How you want your component to interact with the Apollo cache. For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).
+     */
+    fetchPolicy: unknown;
+    /**
+     * Determines if your subscription should be unsubscribed and subscribed again when an input to the hook (such as `subscription` or `variables`) changes.
+     */
+    shouldResubscribe: unknown;
+    /**
+     * An `ApolloClient` instance. By default `useSubscription` / `Subscription` uses the client passed down via context, but a different client can be passed in.
+     */
+    client: unknown;
+    /**
+     * Determines if the current subscription should be skipped. Useful if, for example, variables depend on previous queries and are not ready yet.
+     */
+    skip: unknown;
+    /**
+     * Shared context between your component and your network interface (Apollo Link).
+     */
+    context: unknown;
+    /**
+     * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component completes the subscription.
+     *
+     * @since 3.7.0
+     */
+    onComplete: unknown;
+    /**
+     * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component receives data. The callback `options` object param consists of the current Apollo Client instance in `client`, and the received subscription data in `data`.
+     *
+     * @since 3.7.0
+     */
+    onData: unknown;
+    /**
+     * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component receives data. The callback `options` object param consists of the current Apollo Client instance in `client`, and the received subscription data in `subscriptionData`.
+     *
+     * @deprecated Use `onData` instead
+     */
+    onSubscriptionData: unknown;
+    /**
+     * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component receives an error.
+     *
+     * @since 3.7.0
+     */
+    onError: unknown;
+    /**
+     * Allows the registration of a callback function that will be triggered when the `useSubscription` Hook / `Subscription` component completes the subscription.
+     *
+     * @deprecated Use `onComplete` instead
+     */
+    onSubscriptionComplete: unknown;
+}
+export interface SubscriptionResultDocumentation {
+    /**
+     * A boolean that indicates whether any initial data has been returned
+     */
+    loading: unknown;
+    /**
+     * An object containing the result of your GraphQL subscription. Defaults to an empty object.
+     */
+    data: unknown;
+    /**
+     * A runtime error with `graphQLErrors` and `networkError` properties
+     */
+    error: unknown;
+}
+//# sourceMappingURL=types.documentation.d.ts.map

package/react/types/types.documentation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.documentation.js.map

package/react/types/types.documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.documentation.js","sourceRoot":"","sources":["../../../src/react/types/types.documentation.ts"],"names":[],"mappings":"","sourcesContent":["export interface QueryOptionsDocumentation {\n  /**\n   * A GraphQL query string parsed into an AST with the gql template literal.\n   *\n   * @docGroup 1. Operation options\n   */\n  query: unknown;\n\n  /**\n   * An object containing all of the GraphQL variables your query requires to execute.\n   *\n   * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.\n   *\n   * @docGroup 1. Operation options\n   */\n  variables: unknown;\n\n  /**\n   * Specifies how the query handles a response that returns both GraphQL errors and partial results.\n   *\n   * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).\n   *\n   * The default value is `none`, meaning that the query result includes error details but not partial results.\n   *\n   * @docGroup 1. Operation options\n   */\n  errorPolicy: unknown;\n\n  /**\n   * If you're using [Apollo Link](https://www.apollographql.com/docs/react/api/link/introduction/), this object is the initial value of the `context` object that's passed along your link chain.\n   *\n   * @docGroup 2. Networking options\n   */\n  context: unknown;\n\n  /**\n   * Specifies how the query interacts with the Apollo Client cache during execution (for example, whether it checks the cache for results before sending a request to the server).\n   *\n   * For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).\n   *\n   * The default value is `cache-first`.\n   *\n   * @docGroup 3. Caching options\n   */\n  fetchPolicy: unknown;\n\n  /**\n   * Specifies the {@link FetchPolicy} to be used after this query has completed.\n   *\n   * @docGroup 3. Caching options\n   */\n  nextFetchPolicy: unknown;\n\n  /**\n   * Defaults to the initial value of options.fetchPolicy, but can be explicitly\n   * configured to specify the WatchQueryFetchPolicy to revert back to whenever\n   * variables change (unless nextFetchPolicy intervenes).\n   *\n   * @docGroup 3. Caching options\n   */\n  initialFetchPolicy: unknown;\n\n  /**\n   * Specifies the interval (in milliseconds) at which the query polls for updated results.\n   *\n   * The default value is `0` (no polling).\n   *\n   * @docGroup 2. Networking options\n   */\n  pollInterval: unknown;\n\n  /**\n   * If `true`, the in-progress query's associated component re-renders whenever the network status changes or a network error occurs.\n   *\n   * The default value is `false`.\n   *\n   * @docGroup 2. Networking options\n   */\n  notifyOnNetworkStatusChange: unknown;\n\n  /**\n   * If `true`, the query can return partial results from the cache if the cache doesn't contain results for all queried fields.\n   *\n   * The default value is `false`.\n   *\n   * @docGroup 3. Caching options\n   */\n  returnPartialData: unknown;\n\n  /**\n   * Specifies whether a `NetworkStatus.refetch` operation should merge\n   * incoming field data with existing data, or overwrite the existing data.\n   * Overwriting is probably preferable, but merging is currently the default\n   * behavior, for backwards compatibility with Apollo Client 3.x.\n   *\n   * @docGroup 3. Caching options\n   */\n  refetchWritePolicy: unknown;\n\n  /**\n   * Watched queries must opt into overwriting existing data on refetch, by passing refetchWritePolicy: \"overwrite\" in their WatchQueryOptions.\n   *\n   * The default value is \"overwrite\".\n   *\n   * @docGroup 3. Caching options\n   */\n  refetchWritePolicy_suspense: unknown;\n\n  /**\n   * If `true`, causes a query refetch if the query result is detected as partial.\n   *\n   * The default value is `false`.\n   *\n   * @deprecated\n   * Setting this option is unnecessary in Apollo Client 3, thanks to a more consistent application of fetch policies. It might be removed in a future release.\n   */\n  partialRefetch: unknown;\n\n  /**\n   * Whether to canonize cache results before returning them. Canonization\n   * takes some extra time, but it speeds up future deep equality comparisons.\n   * Defaults to false.\n   *\n   * @deprecated\n   * Using `canonizeResults` can result in memory leaks so we generally do not\n   * recommend using this option anymore.\n   * A future version of Apollo Client will contain a similar feature without\n   * the risk of memory leaks.\n   */\n  canonizeResults: unknown;\n\n  /**\n   * If true, the query is not executed.\n   *\n   * The default value is `false`.\n   *\n   * @docGroup 1. Operation options\n   */\n  skip: unknown;\n\n  /**\n   * If `true`, the query is not executed. The default value is `false`.\n   *\n   * @deprecated We recommend using `skipToken` in place of the `skip` option as\n   * it is more type-safe.\n   *\n   * This option is deprecated and only supported to ease the migration from useQuery. It will be removed in a future release.\n   *\n   * @docGroup 1. Operation options\n   */\n  skip_deprecated: unknown;\n\n  /**\n   * A callback function that's called when your query successfully completes with zero errors (or if `errorPolicy` is `ignore` and partial data is returned).\n   *\n   * This function is passed the query's result `data`.\n   *\n   * @docGroup 1. Operation options\n   */\n  onCompleted: unknown;\n  /**\n   * A callback function that's called when the query encounters one or more errors (unless `errorPolicy` is `ignore`).\n   *\n   * This function is passed an `ApolloError` object that contains either a `networkError` object or a `graphQLErrors` array, depending on the error(s) that occurred.\n   *\n   * @docGroup 1. Operation options\n   */\n  onError: unknown;\n\n  /**\n   * The instance of {@link ApolloClient} to use to execute the query.\n   *\n   * By default, the instance that's passed down via context is used, but you\n   * can provide a different instance here.\n   *\n   * @docGroup 1. Operation options\n   */\n  client: unknown;\n\n  /**\n   * A unique identifier for the query. Each item in the array must be a stable\n   * identifier to prevent infinite fetches.\n   *\n   * This is useful when using the same query and variables combination in more\n   * than one component, otherwise the components may clobber each other. This\n   * can also be used to force the query to re-evaluate fresh.\n   *\n   * @docGroup 1. Operation options\n   */\n  queryKey: unknown;\n\n  /**\n   * Pass `false` to skip executing the query during [server-side rendering](https://www.apollographql.com/docs/react/performance/server-side-rendering/).\n   *\n   * @docGroup 2. Networking options\n   */\n  ssr: unknown;\n\n  /**\n   * A callback function that's called whenever a refetch attempt occurs\n   * while polling. If the function returns `true`, the refetch is\n   * skipped and not reattempted until the next poll interval.\n   *\n   * @docGroup 2. Networking options\n   */\n  skipPollAttempt: unknown;\n}\n\nexport interface QueryResultDocumentation {\n  /**\n   * The instance of Apollo Client that executed the query.\n   * Can be useful for manually executing followup queries or writing data to the cache.\n   *\n   * @docGroup 2. Network info\n   */\n  client: unknown;\n  /**\n   * A reference to the internal `ObservableQuery` used by the hook.\n   */\n  observable: unknown;\n  /**\n   * An object containing the result of your GraphQL query after it completes.\n   *\n   * This value might be `undefined` if a query results in one or more errors (depending on the query's `errorPolicy`).\n   *\n   * @docGroup 1. Operation data\n   */\n  data: unknown;\n  /**\n   * An object containing the result from the most recent _previous_ execution of this query.\n   *\n   * This value is `undefined` if this is the query's first execution.\n   *\n   * @docGroup 1. Operation data\n   */\n  previousData: unknown;\n  /**\n   * If the query produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.\n   *\n   * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).\n   *\n   * @docGroup 1. Operation data\n   */\n  error: unknown;\n  /**\n   * If `true`, the query is still in flight and results have not yet been returned.\n   *\n   * @docGroup 2. Network info\n   */\n  loading: unknown;\n  /**\n   * A number indicating the current network state of the query's associated request. [See possible values.](https://github.com/apollographql/apollo-client/blob/d96f4578f89b933c281bb775a39503f6cdb59ee8/src/core/networkStatus.ts#L4)\n   *\n   * Used in conjunction with the [`notifyOnNetworkStatusChange`](#notifyonnetworkstatuschange) option.\n   *\n   * @docGroup 2. Network info\n   */\n  networkStatus: unknown;\n  /**\n   * If `true`, the associated lazy query has been executed.\n   *\n   * This field is only present on the result object returned by [`useLazyQuery`](/react/data/queries/#executing-queries-manually).\n   *\n   * @docGroup 2. Network info\n   */\n  called: unknown;\n  /**\n   * An object containing the variables that were provided for the query.\n   *\n   * @docGroup 1. Operation data\n   */\n  variables: unknown;\n\n  /**\n   * A function that enables you to re-execute the query, optionally passing in new `variables`.\n   *\n   * To guarantee that the refetch performs a network request, its `fetchPolicy` is set to `network-only` (unless the original query's `fetchPolicy` is `no-cache` or `cache-and-network`, which also guarantee a network request).\n   *\n   * See also [Refetching](https://www.apollographql.com/docs/react/data/queries/#refetching).\n   *\n   *   @docGroup 3. Helper functions\n   */\n  refetch: unknown;\n  /**\n   * {@inheritDoc @apollo/client!ObservableQuery#fetchMore:member(1)}\n   *\n   * @docGroup 3. Helper functions\n   */\n  fetchMore: unknown;\n  /**\n   * {@inheritDoc @apollo/client!ObservableQuery#startPolling:member(1)}\n   *\n   * @docGroup 3. Helper functions\n   */\n  startPolling: unknown;\n  /**\n   * {@inheritDoc @apollo/client!ObservableQuery#stopPolling:member(1)}\n   *\n   * @docGroup 3. Helper functions\n   */\n  stopPolling: unknown;\n  /**\n   * {@inheritDoc @apollo/client!ObservableQuery#subscribeToMore:member(1)}\n   *\n   * @docGroup 3. Helper functions\n   */\n  subscribeToMore: unknown;\n  /**\n   * {@inheritDoc @apollo/client!ObservableQuery#updateQuery:member(1)}\n   *\n   * @docGroup 3. Helper functions\n   */\n  updateQuery: unknown;\n}\n\nexport interface MutationOptionsDocumentation {\n  /**\n   * A GraphQL document, often created with `gql` from the `graphql-tag`\n   * package, that contains a single mutation inside of it.\n   *\n   * @docGroup 1. Operation options\n   */\n  mutation: unknown;\n\n  /**\n   * Provide `no-cache` if the mutation's result should _not_ be written to the Apollo Client cache.\n   *\n   * The default value is `network-only` (which means the result _is_ written to the cache).\n   *\n   * Unlike queries, mutations _do not_ support [fetch policies](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy) besides `network-only` and `no-cache`.\n   *\n   * @docGroup 3. Caching options\n   */\n  fetchPolicy: unknown;\n\n  /**\n   * To avoid retaining sensitive information from mutation root field\n   * arguments, Apollo Client v3.4+ automatically clears any `ROOT_MUTATION`\n   * fields from the cache after each mutation finishes. If you need this\n   * information to remain in the cache, you can prevent the removal by passing\n   * `keepRootFields: true` to the mutation. `ROOT_MUTATION` result data are\n   * also passed to the mutation `update` function, so we recommend obtaining\n   * the results that way, rather than using this option, if possible.\n   */\n  keepRootFields: unknown;\n\n  /**\n   * By providing either an object or a callback function that, when invoked after\n   * a mutation, allows you to return optimistic data and optionally skip updates\n   * via the `IGNORE` sentinel object, Apollo Client caches this temporary\n   * (and potentially incorrect) response until the mutation completes, enabling\n   * more responsive UI updates.\n   *\n   * For more information, see [Optimistic mutation results](https://www.apollographql.com/docs/react/performance/optimistic-ui/).\n   *\n   * @docGroup 3. Caching options\n   */\n  optimisticResponse: unknown;\n\n  /**\n   * A {@link MutationQueryReducersMap}, which is map from query names to\n   * mutation query reducers. Briefly, this map defines how to incorporate the\n   * results of the mutation into the results of queries that are currently\n   * being watched by your application.\n   */\n  updateQueries: unknown;\n\n  /**\n   * An array (or a function that _returns_ an array) that specifies which queries you want to refetch after the mutation occurs.\n   *\n   * Each array value can be either:\n   *\n   * - An object containing the `query` to execute, along with any `variables`\n   *\n   * - A string indicating the operation name of the query to refetch\n   *\n   * @docGroup 1. Operation options\n   */\n  refetchQueries: unknown;\n\n  /**\n   * If `true`, makes sure all queries included in `refetchQueries` are completed before the mutation is considered complete.\n   *\n   * The default value is `false` (queries are refetched asynchronously).\n   *\n   * @docGroup 1. Operation options\n   */\n  awaitRefetchQueries: unknown;\n\n  /**\n   * A function used to update the Apollo Client cache after the mutation completes.\n   *\n   * For more information, see [Updating the cache after a mutation](https://www.apollographql.com/docs/react/data/mutations#updating-the-cache-after-a-mutation).\n   *\n   * @docGroup 3. Caching options\n   */\n  update: unknown;\n\n  /**\n   * Optional callback for intercepting queries whose cache data has been updated by the mutation, as well as any queries specified in the `refetchQueries: [...]` list passed to `client.mutate`.\n   *\n   * Returning a `Promise` from `onQueryUpdated` will cause the final mutation `Promise` to await the returned `Promise`. Returning `false` causes the query to be ignored.\n   *\n   * @docGroup 1. Operation options\n   */\n  onQueryUpdated: unknown;\n\n  /**\n   * Specifies how the mutation handles a response that returns both GraphQL errors and partial results.\n   *\n   * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).\n   *\n   * The default value is `none`, meaning that the mutation result includes error details but _not_ partial results.\n   *\n   * @docGroup 1. Operation options\n   */\n  errorPolicy: unknown;\n\n  /**\n   * An object containing all of the GraphQL variables your mutation requires to execute.\n   *\n   * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.\n   *\n   * @docGroup 1. Operation options\n   */\n  variables: unknown;\n\n  /**\n   * If you're using [Apollo Link](https://www.apollographql.com/docs/react/api/link/introduction/), this object is the initial value of the `context` object that's passed along your link chain.\n   *\n   * @docGroup 2. Networking options\n   */\n  context: unknown;\n\n  /**\n   * The instance of `ApolloClient` to use to execute the mutation.\n   *\n   * By default, the instance that's passed down via context is used, but you can provide a different instance here.\n   *\n   * @docGroup 2. Networking options\n   */\n  client: unknown;\n  /**\n   * If `true`, the in-progress mutation's associated component re-renders whenever the network status changes or a network error occurs.\n   *\n   * The default value is `false`.\n   *\n   * @docGroup 2. Networking options\n   */\n  notifyOnNetworkStatusChange: unknown;\n  /**\n   * A callback function that's called when your mutation successfully completes with zero errors (or if `errorPolicy` is `ignore` and partial data is returned).\n   *\n   * This function is passed the mutation's result `data` and any options passed to the mutation.\n   *\n   * @docGroup 1. Operation options\n   */\n  onCompleted: unknown;\n  /**\n   * A callback function that's called when the mutation encounters one or more errors (unless `errorPolicy` is `ignore`).\n   *\n   * This function is passed an [`ApolloError`](https://github.com/apollographql/apollo-client/blob/d96f4578f89b933c281bb775a39503f6cdb59ee8/src/errors/index.ts#L36-L39) object that contains either a `networkError` object or a `graphQLErrors` array, depending on the error(s) that occurred, as well as any options passed the mutation.\n   *\n   * @docGroup 1. Operation options\n   */\n  onError: unknown;\n  /**\n   * If `true`, the mutation's `data` property is not updated with the mutation's result.\n   *\n   * The default value is `false`.\n   *\n   * @docGroup 1. Operation options\n   */\n  ignoreResults: unknown;\n}\n\nexport interface MutationResultDocumentation {\n  /**\n   * The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.\n   */\n  data: unknown;\n  /**\n   * If the mutation produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.\n   *\n   * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).\n   */\n  error: unknown;\n  /**\n   * If `true`, the mutation is currently in flight.\n   */\n  loading: unknown;\n  /**\n   * If `true`, the mutation's mutate function has been called.\n   */\n  called: unknown;\n  /**\n   * The instance of Apollo Client that executed the mutation.\n   *\n   * Can be useful for manually executing followup operations or writing data to the cache.\n   */\n  client: unknown;\n  /**\n   * A function that you can call to reset the mutation's result to its initial, uncalled state.\n   */\n  reset: unknown;\n}\n\nexport interface SubscriptionOptionsDocumentation {\n  /**\n   * A GraphQL document, often created with `gql` from the `graphql-tag`\n   * package, that contains a single subscription inside of it.\n   */\n  query: unknown;\n  /**\n   * An object containing all of the variables your subscription needs to execute\n   */\n  variables: unknown;\n\n  /**\n   * Specifies the {@link ErrorPolicy} to be used for this operation\n   */\n  errorPolicy: unknown;\n\n  /**\n   * How you want your component to interact with the Apollo cache. For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).\n   */\n  fetchPolicy: unknown;\n\n  /**\n   * Determines if your subscription should be unsubscribed and subscribed again when an input to the hook (such as `subscription` or `variables`) changes.\n   */\n  shouldResubscribe: unknown;\n\n  /**\n   * An `ApolloClient` instance. By default `useSubscription` / `Subscription` uses the client passed down via context, but a different client can be passed in.\n   */\n  client: unknown;\n\n  /**\n   * Determines if the current subscription should be skipped. Useful if, for example, variables depend on previous queries and are not ready yet.\n   */\n  skip: unknown;\n\n  /**\n   * Shared context between your component and your network interface (Apollo Link).\n   */\n  context: unknown;\n\n  /**\n   * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component completes the subscription.\n   *\n   * @since 3.7.0\n   */\n  onComplete: unknown;\n\n  /**\n   * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component receives data. The callback `options` object param consists of the current Apollo Client instance in `client`, and the received subscription data in `data`.\n   *\n   * @since 3.7.0\n   */\n  onData: unknown;\n\n  /**\n   * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component receives data. The callback `options` object param consists of the current Apollo Client instance in `client`, and the received subscription data in `subscriptionData`.\n   *\n   * @deprecated Use `onData` instead\n   */\n  onSubscriptionData: unknown;\n\n  /**\n   * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component receives an error.\n   *\n   * @since 3.7.0\n   */\n  onError: unknown;\n\n  /**\n   * Allows the registration of a callback function that will be triggered when the `useSubscription` Hook / `Subscription` component completes the subscription.\n   *\n   * @deprecated Use `onComplete` instead\n   */\n  onSubscriptionComplete: unknown;\n}\n\nexport interface SubscriptionResultDocumentation {\n  /**\n   * A boolean that indicates whether any initial data has been returned\n   */\n  loading: unknown;\n  /**\n   * An object containing the result of your GraphQL subscription. Defaults to an empty object.\n   */\n  data: unknown;\n  /**\n   * A runtime error with `graphQLErrors` and `networkError` properties\n   */\n  error: unknown;\n}\n"]}