@apollo/client 3.13.4 → 4.0.0-alpha.0

package/__cjs/core/types.d.cts

@@ -0,0 +1,120 @@
+import type { DocumentNode } from "graphql";
+import type { ApolloCache } from "@apollo/client/cache";
+import type { Cache } from "@apollo/client/cache";
+import type { FetchResult } from "@apollo/client/link/core";
+import type { Unmasked } from "@apollo/client/masking";
+import type { IsStrictlyAny } from "@apollo/client/utilities";
+import type { Resolver } from "./LocalState.cjs";
+import type { NetworkStatus } from "./networkStatus.cjs";
+import type { ObservableQuery } from "./ObservableQuery.cjs";
+import type { QueryInfo } from "./QueryInfo.cjs";
+import type { QueryOptions } from "./watchQueryOptions.cjs";
+export type { TypedDocumentNode } from "@graphql-typed-document-node/core";
+export type MethodKeys<T> = {
+    [P in keyof T]: T[P] extends Function ? P : never;
+}[keyof T];
+export interface DefaultContext extends Record<string, any> {
+}
+export type QueryListener = (queryInfo: QueryInfo) => void;
+/**
+ * Represents an `Error` type, but used throughout Apollo Client to represent
+ * errors that may otherwise fail `instanceof` checks if they are cross-realm
+ * Error instances (see the [`Error.isError` proposal](https://github.com/tc39/proposal-is-error) for more details).
+ *
+ * Apollo Client uses several types of errors throughout the client which can be
+ * narrowed using `instanceof`:
+ * - `CombinedGraphQLErrors` - `errors` returned from a GraphQL result
+ * - `CombinedProtocolErrors` - Transport-level errors from multipart subscriptions.
+ * - `ServerParseError` - A JSON-parse error when parsing the server response.
+ * - `ServerError` - A non-200 server response.
+ *
+ * @example
+ * ```ts
+ * import { CombinedGraphQLErrors } from "@apollo/client";
+ *
+ * try {
+ *   await client.query({ query });
+ * } catch (error) {
+ *   // Use `instanceof` to check for more specific types of errors.
+ *   if (error instanceof CombinedGraphQLErrors) {
+ *     error.errors.map(graphQLError => console.log(graphQLError.message));
+ *   } else {
+ *     console.error(errors);
+ *   }
+ * }
+ * ```
+ */
+export interface ErrorLike {
+    message: string;
+    name: string;
+    stack?: string;
+}
+export type OnQueryUpdated<TResult> = (observableQuery: ObservableQuery<any>, diff: Cache.DiffResult<any>, lastDiff: Cache.DiffResult<any> | undefined) => boolean | TResult;
+export type RefetchQueryDescriptor = string | DocumentNode;
+export type InternalRefetchQueryDescriptor = RefetchQueryDescriptor | QueryOptions;
+type RefetchQueriesIncludeShorthand = "all" | "active";
+export type RefetchQueriesInclude = RefetchQueryDescriptor[] | RefetchQueriesIncludeShorthand;
+export type InternalRefetchQueriesInclude = InternalRefetchQueryDescriptor[] | RefetchQueriesIncludeShorthand;
+export interface RefetchQueriesOptions<TCache extends ApolloCache<any>, TResult> {
+    updateCache?: (cache: TCache) => void;
+    include?: RefetchQueriesInclude;
+    optimistic?: boolean;
+    onQueryUpdated?: OnQueryUpdated<TResult> | null;
+}
+export type RefetchQueriesPromiseResults<TResult> = IsStrictlyAny<TResult> extends true ? any[] : TResult extends boolean ? ApolloQueryResult<any>[] : TResult extends PromiseLike<infer U> ? U[] : TResult[];
+export interface RefetchQueriesResult<TResult> extends Promise<RefetchQueriesPromiseResults<TResult>> {
+    queries: ObservableQuery<any>[];
+    results: InternalRefetchQueriesResult<TResult>[];
+}
+export interface InternalRefetchQueriesOptions<TCache extends ApolloCache<any>, TResult> extends Omit<RefetchQueriesOptions<TCache, TResult>, "include"> {
+    include?: InternalRefetchQueriesInclude;
+    removeOptimistic?: string;
+}
+export type InternalRefetchQueriesResult<TResult> = TResult extends boolean ? Promise<ApolloQueryResult<any>> : TResult;
+export type InternalRefetchQueriesMap<TResult> = Map<ObservableQuery<any>, InternalRefetchQueriesResult<TResult>>;
+export type { QueryOptions as PureQueryOptions };
+export type OperationVariables = Record<string, any>;
+export interface ApolloQueryResult<T> {
+    data: T | undefined;
+    /**
+     * The single Error object that is passed to onError and useQuery hooks, and is often thrown during manual `client.query` calls.
+     * This will contain both a NetworkError field and any GraphQLErrors.
+     * See https://www.apollographql.com/docs/react/data/error-handling/ for more information.
+     */
+    error?: ErrorLike;
+    loading: boolean;
+    networkStatus: NetworkStatus;
+    /**
+     * Describes whether `data` is a complete or partial result. This flag is only
+     * set when `returnPartialData` is `true` in query options.
+     *
+     * @deprecated This field will be removed in a future version of Apollo Client.
+     */
+    partial: boolean;
+}
+export type MutationQueryReducer<T> = (previousResult: Record<string, any>, options: {
+    mutationResult: FetchResult<Unmasked<T>>;
+    queryName: string | undefined;
+    queryVariables: Record<string, any>;
+}) => Record<string, any>;
+export type MutationQueryReducersMap<T = {
+    [key: string]: any;
+}> = {
+    [queryName: string]: MutationQueryReducer<T>;
+};
+/**
+ * @deprecated Use `MutationUpdaterFunction` instead.
+ */
+export type MutationUpdaterFn<T = {
+    [key: string]: any;
+}> = (cache: ApolloCache<T>, mutationResult: FetchResult<T>) => void;
+export type MutationUpdaterFunction<TData, TVariables, TContext, TCache extends ApolloCache<any>> = (cache: TCache, result: Omit<FetchResult<Unmasked<TData>>, "context">, options: {
+    context?: TContext;
+    variables?: TVariables;
+}) => void;
+export interface Resolvers {
+    [key: string]: {
+        [field: string]: Resolver;
+    };
+}
+//# sourceMappingURL=types.d.cts.map

package/__cjs/core/watchQueryOptions.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=watchQueryOptions.cjs.map

package/__cjs/core/watchQueryOptions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchQueryOptions.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/__cjs/core/watchQueryOptions.d.cts

@@ -0,0 +1,472 @@
+import type { TypedDocumentNode } from "@graphql-typed-document-node/core";
+import type { DocumentNode } from "graphql";
+import type { ApolloCache } from "@apollo/client/cache";
+import type { FetchResult } from "@apollo/client/link/core";
+import type { Unmasked } from "@apollo/client/masking";
+import type { DeepPartial, NoInfer } from "@apollo/client/utilities";
+import type { IgnoreModifier } from "../cache/core/types/common.cjs";
+import type { ObservableQuery } from "./ObservableQuery.cjs";
+import type { DefaultContext, InternalRefetchQueriesInclude, MutationQueryReducersMap, MutationUpdaterFunction, OnQueryUpdated, OperationVariables } from "./types.cjs";
+/**
+ * fetchPolicy determines where the client may return a result from. The options are:
+ * - cache-first (default): return result from cache. Only fetch from network if cached result is not available.
+ * - cache-and-network: return result from cache first (if it exists), then return network result once it's available.
+ * - cache-only: return result from cache if available, fail otherwise.
+ * - no-cache: return result from network, fail if network call doesn't succeed, don't save to cache
+ * - network-only: return result from network, fail if network call doesn't succeed, save to cache
+ * - standby: only for queries that aren't actively watched, but should be available for refetch and updateQueries.
+ */
+export type FetchPolicy = "cache-first" | "network-only" | "cache-only" | "no-cache" | "standby";
+export type WatchQueryFetchPolicy = FetchPolicy | "cache-and-network";
+export type MutationFetchPolicy = Extract<FetchPolicy, "network-only" | "no-cache">;
+export type RefetchWritePolicy = "merge" | "overwrite";
+/**
+ * errorPolicy determines the level of events for errors in the execution result. The options are:
+ * - none (default): any errors from the request are treated like runtime errors and the observable is stopped
+ * - ignore: errors from the request do not stop the observable, but also don't call `next`
+ * - all: errors are treated like data and will notify observables
+ */
+export type ErrorPolicy = "none" | "ignore" | "all";
+/**
+ * Query options.
+ */
+export interface QueryOptions<TVariables = OperationVariables, TData = any> {
+    /**
+    * A GraphQL query string parsed into an AST with the gql template literal.
+    * 
+    * @docGroup
+    * 
+    * 1. Operation options
+    */
+    query: DocumentNode | TypedDocumentNode<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;
+    /**
+    * 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?: ErrorPolicy;
+    /**
+    * 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?: DefaultContext;
+    /**
+    * 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?: FetchPolicy;
+    /**
+    * 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?: number;
+    /**
+    * 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?: boolean;
+    /**
+    * 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?: boolean;
+    /**
+    * 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?: boolean;
+}
+/**
+ * Watched query options.
+ */
+export interface WatchQueryOptions<TVariables extends OperationVariables = OperationVariables, TData = any> extends SharedWatchQueryOptions<TVariables, TData> {
+    /**
+    * A GraphQL query string parsed into an AST with the gql template literal.
+    * 
+    * @docGroup
+    * 
+    * 1. Operation options
+    */
+    query: DocumentNode | TypedDocumentNode<TData, TVariables>;
+}
+export interface SharedWatchQueryOptions<TVariables extends OperationVariables, TData> {
+    /**
+    * 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?: WatchQueryFetchPolicy;
+    /**
+    * Specifies the `FetchPolicy` to be used after this query has completed.
+    * 
+    * @docGroup
+    * 
+    * 3. Caching options
+    */
+    nextFetchPolicy?: WatchQueryFetchPolicy | ((this: WatchQueryOptions<TVariables, TData>, currentFetchPolicy: WatchQueryFetchPolicy, context: NextFetchPolicyContext<TData, TVariables>) => WatchQueryFetchPolicy);
+    /**
+    * 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?: WatchQueryFetchPolicy;
+    /**
+    * 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?: RefetchWritePolicy;
+    /**
+    * 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;
+    /**
+    * 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?: ErrorPolicy;
+    /**
+    * 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?: DefaultContext;
+    /**
+    * 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?: number;
+    /**
+    * 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?: boolean;
+    /**
+    * 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?: boolean;
+    /**
+    * 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?: boolean;
+    /**
+    * 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?: () => boolean;
+}
+export interface NextFetchPolicyContext<TData, TVariables extends OperationVariables> {
+    reason: "after-fetch" | "variables-changed";
+    observable: ObservableQuery<TData, TVariables>;
+    options: WatchQueryOptions<TVariables, TData>;
+    initialFetchPolicy: WatchQueryFetchPolicy;
+}
+export interface FetchMoreQueryOptions<TVariables, TData = any> {
+    /**
+    * A GraphQL query string parsed into an AST with the gql template literal.
+    * 
+    * @docGroup
+    * 
+    * 1. Operation options
+    */
+    query?: DocumentNode | TypedDocumentNode<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?: Partial<TVariables>;
+    context?: DefaultContext;
+}
+export type UpdateQueryOptions<TData, TVariables> = {
+    variables?: TVariables;
+} & ({
+    /**
+     * Indicate if the previous query result has been found fully in the cache.
+     */
+    complete: true;
+    previousData: Unmasked<TData>;
+} | {
+    /**
+     * Indicate if the previous query result has not been found fully in the cache.
+     * Might have partial or missing data.
+     */
+    complete: false;
+    previousData: DeepPartial<Unmasked<TData>> | undefined;
+});
+export interface UpdateQueryMapFn<TData = any, TVariables = OperationVariables> {
+    (
+    /**
+     * @deprecated This value is not type-safe and may contain partial data. This
+     * argument will be removed in the next major version of Apollo Client. Use
+     * `options.previousData` instead for a more type-safe value.
+     */
+    unsafePreviousData: Unmasked<TData>, options: UpdateQueryOptions<TData, TVariables>): Unmasked<TData> | void;
+}
+export type SubscribeToMoreUpdateQueryFn<TData = any, TVariables extends OperationVariables = OperationVariables, TSubscriptionData = TData> = {
+    (
+    /**
+     * @deprecated This value is not type-safe and may contain partial data. This
+     * argument will be removed in the next major version of Apollo Client. Use
+     * `options.previousData` instead for a more type-safe value.
+     */
+    unsafePreviousData: Unmasked<TData>, options: UpdateQueryOptions<TData, TVariables> & {
+        subscriptionData: {
+            data: Unmasked<TSubscriptionData>;
+        };
+    }): Unmasked<TData> | void;
+};
+export interface SubscribeToMoreOptions<TData = any, TSubscriptionVariables extends OperationVariables = OperationVariables, TSubscriptionData = TData, TVariables extends OperationVariables = TSubscriptionVariables> {
+    document: DocumentNode | TypedDocumentNode<TSubscriptionData, TSubscriptionVariables>;
+    variables?: TSubscriptionVariables;
+    updateQuery?: SubscribeToMoreUpdateQueryFn<TData, TVariables, TSubscriptionData>;
+    onError?: (error: Error) => void;
+    context?: DefaultContext;
+}
+export interface SubscribeToMoreFunction<TData, TVariables extends OperationVariables = OperationVariables> {
+    <TSubscriptionData = TData, TSubscriptionVariables extends OperationVariables = TVariables>(options: SubscribeToMoreOptions<TData, TSubscriptionVariables, TSubscriptionData, TVariables>): () => void;
+}
+export interface SubscriptionOptions<TVariables = OperationVariables, TData = any> {
+    /**
+    * A GraphQL document, often created with `gql` from the `graphql-tag` package, that contains a single subscription inside of it.
+    */
+    query: DocumentNode | TypedDocumentNode<TData, TVariables>;
+    /**
+    * An object containing all of the variables your subscription needs to execute
+    */
+    variables?: TVariables;
+    /**
+    * 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?: FetchPolicy;
+    /**
+    * Specifies the `ErrorPolicy` to be used for this operation
+    */
+    errorPolicy?: ErrorPolicy;
+    /**
+    * Shared context between your component and your network interface (Apollo Link).
+    */
+    context?: DefaultContext;
+    /**
+    * Shared context between your component and your network interface (Apollo Link).
+    */
+    extensions?: Record<string, any>;
+}
+interface MutationBaseOptions<TData = any, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> {
+    /**
+    * 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?: Unmasked<NoInfer<TData>> | ((vars: TVariables, { IGNORE }: {
+        IGNORE: IgnoreModifier;
+    }) => Unmasked<NoInfer<TData>> | IgnoreModifier);
+    /**
+    * A `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?: MutationQueryReducersMap<TData>;
+    /**
+    * 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?: ((result: FetchResult<Unmasked<TData>>) => InternalRefetchQueriesInclude) | InternalRefetchQueriesInclude;
+    /**
+    * 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?: boolean;
+    /**
+    * 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?: MutationUpdaterFunction<TData, TVariables, TContext, TCache>;
+    /**
+    * 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?: OnQueryUpdated<any>;
+    /**
+    * 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?: ErrorPolicy;
+    /**
+    * 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?: TVariables;
+    /**
+    * 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?: TContext;
+}
+export interface MutationOptions<TData = any, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> extends MutationSharedOptions<TData, TVariables, TContext, TCache> {
+    /**
+    * 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: DocumentNode | TypedDocumentNode<TData, TVariables>;
+}
+export interface MutationSharedOptions<TData = any, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> extends MutationBaseOptions<TData, TVariables, TContext, TCache> {
+    /**
+    * 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?: MutationFetchPolicy;
+    /**
+    * 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?: boolean;
+}
+export {};
+//# sourceMappingURL=watchQueryOptions.d.cts.map

package/__cjs/dev/index.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setErrorMessageHandler = exports.loadErrorMessages = exports.loadErrorMessageHandler = exports.loadDevMessages = void 0;
+var loadDevMessages_js_1 = require("./loadDevMessages.cjs");
+Object.defineProperty(exports, "loadDevMessages", { enumerable: true, get: function () { return loadDevMessages_js_1.loadDevMessages; } });
+var loadErrorMessageHandler_js_1 = require("./loadErrorMessageHandler.cjs");
+Object.defineProperty(exports, "loadErrorMessageHandler", { enumerable: true, get: function () { return loadErrorMessageHandler_js_1.loadErrorMessageHandler; } });
+var loadErrorMessages_js_1 = require("./loadErrorMessages.cjs");
+Object.defineProperty(exports, "loadErrorMessages", { enumerable: true, get: function () { return loadErrorMessages_js_1.loadErrorMessages; } });
+var setErrorMessageHandler_js_1 = require("./setErrorMessageHandler.cjs");
+Object.defineProperty(exports, "setErrorMessageHandler", { enumerable: true, get: function () { return setErrorMessageHandler_js_1.setErrorMessageHandler; } });
+//# sourceMappingURL=index.cjs.map

package/__cjs/dev/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/dev/index.ts"],"sourcesContent":["export { loadDevMessages } from \"./loadDevMessages.js\";\nexport { loadErrorMessageHandler } from \"./loadErrorMessageHandler.js\";\nexport { loadErrorMessages } from \"./loadErrorMessages.js\";\nexport { setErrorMessageHandler } from \"./setErrorMessageHandler.js\";\nexport type { ErrorMessageHandler } from \"./setErrorMessageHandler.js\";\n"],"names":[],"mappings":";;;AAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAwB,EAAxB,EAAA,CAAA,CAAA;AACA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAgC,EAAhC,EAAA,CAAA,CAAA;AACA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA0B,EAA1B,EAAA,CAAA,CAAA;AACA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA+B,EAA/B,EAAA,CAAA,CAAA;"}

package/__cjs/dev/index.d.cts

@@ -0,0 +1,6 @@
+export { loadDevMessages } from "./loadDevMessages.cjs";
+export { loadErrorMessageHandler } from "./loadErrorMessageHandler.cjs";
+export { loadErrorMessages } from "./loadErrorMessages.cjs";
+export { setErrorMessageHandler } from "./setErrorMessageHandler.cjs";
+export type { ErrorMessageHandler } from "./setErrorMessageHandler.cjs";
+//# sourceMappingURL=index.d.cts.map

package/__cjs/dev/loadDevMessages.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDevMessages = loadDevMessages;
+const invariantErrorCodes_js_1 = require("../invariantErrorCodes.cjs");
+const loadErrorMessageHandler_js_1 = require("./loadErrorMessageHandler.cjs");
+function loadDevMessages() {
+    (0, loadErrorMessageHandler_js_1.loadErrorMessageHandler)(invariantErrorCodes_js_1.devDebug, invariantErrorCodes_js_1.devError, invariantErrorCodes_js_1.devLog, invariantErrorCodes_js_1.devWarn);
+}
+//# sourceMappingURL=loadDevMessages.cjs.map

package/__cjs/dev/loadDevMessages.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadDevMessages.cjs","sources":["../../../src/dev/loadDevMessages.ts"],"sourcesContent":["import { devDebug, devError, devLog, devWarn } from \"../invariantErrorCodes.js\";\n\nimport { loadErrorMessageHandler } from \"./loadErrorMessageHandler.js\";\n\nexport function loadDevMessages() {\n  loadErrorMessageHandler(devDebug, devError, devLog, devWarn);\n}\n"],"names":[],"mappings":"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"}

package/__cjs/dev/loadDevMessages.d.cts

@@ -0,0 +1,2 @@
+export declare function loadDevMessages(): void;
+//# sourceMappingURL=loadDevMessages.d.cts.map