@vue/apollo-composable
Version:
Apollo GraphQL for Vue Composition API
72 lines (71 loc) • 5.07 kB
TypeScript
import type { ApolloClient, ApolloError, ApolloQueryResult, FetchMoreQueryOptions, MaybeMasked, ObservableQuery, OperationVariables, SubscribeToMoreOptions, TypedDocumentNode, Unmasked, UpdateQueryMapFn, WatchQueryOptions } from '@apollo/client/core/index.js';
import type { DocumentNode } from 'graphql';
import type { Ref } from 'vue-demi';
import type { ReactiveFunction } from './util/ReactiveFunction';
export interface UseQueryOptions<TResult = any, TVariables extends OperationVariables = OperationVariables> extends Omit<WatchQueryOptions<TVariables>, 'query' | 'variables'> {
clientId?: string;
enabled?: boolean | Ref<boolean>;
throttle?: number;
debounce?: number;
prefetch?: boolean;
keepPreviousResult?: boolean;
}
export type DocumentParameter<TResult, TVariables> = DocumentNode | Ref<DocumentNode | null | undefined> | ReactiveFunction<DocumentNode | null | undefined> | TypedDocumentNode<TResult, TVariables> | Ref<TypedDocumentNode<TResult, TVariables> | null | undefined> | ReactiveFunction<TypedDocumentNode<TResult, TVariables> | null | undefined>;
export type VariablesParameter<TVariables> = TVariables | Ref<TVariables> | ReactiveFunction<TVariables>;
export type OptionsParameter<TResult, TVariables extends OperationVariables> = UseQueryOptions<TResult, TVariables> | Ref<UseQueryOptions<TResult, TVariables>> | ReactiveFunction<UseQueryOptions<TResult, TVariables>>;
export interface OnResultContext {
client: ApolloClient<any>;
}
export interface OnErrorContext {
client: ApolloClient<any>;
}
export interface UseQueryReturn<TResult, TVariables extends OperationVariables> {
result: Ref<TResult | undefined>;
loading: Ref<boolean>;
networkStatus: Ref<number | undefined>;
error: Ref<ApolloError | null>;
start: () => void;
stop: () => void;
restart: () => void;
forceDisabled: Ref<boolean>;
document: Ref<DocumentNode | null | undefined>;
variables: Ref<TVariables | undefined>;
options: UseQueryOptions<TResult, TVariables> | Ref<UseQueryOptions<TResult, TVariables>>;
query: Ref<ObservableQuery<TResult, TVariables> | null | undefined>;
refetch: (variables?: TVariables) => Promise<ApolloQueryResult<TResult>> | undefined;
fetchMore: <TFetchData = TResult, TFetchVars extends OperationVariables = TVariables>(options: FetchMoreQueryOptions<TFetchVars, TFetchData> & {
updateQuery?: (previousQueryResult: Unmasked<TResult>, options: {
fetchMoreResult: Unmasked<TFetchData>;
variables: TFetchVars;
}) => Unmasked<TResult>;
}) => Promise<ApolloQueryResult<MaybeMasked<TFetchData>>> | undefined;
updateQuery: (mapFn: UpdateQueryMapFn<TResult, TVariables>) => void;
subscribeToMore: <TSubscriptionVariables extends OperationVariables = OperationVariables, TSubscriptionData = TResult>(options: SubscribeToMoreOptions<TResult, TSubscriptionVariables, TSubscriptionData> | Ref<SubscribeToMoreOptions<TResult, TSubscriptionVariables, TSubscriptionData>> | ReactiveFunction<SubscribeToMoreOptions<TResult, TSubscriptionVariables, TSubscriptionData>>) => void;
onResult: (fn: (param: ApolloQueryResult<TResult>, context: OnResultContext) => void) => {
off: () => void;
};
onError: (fn: (param: ApolloError, context: OnErrorContext) => void) => {
off: () => void;
};
}
/**
* Use a query that does not require variables or options.
*/
export declare function useQuery<TResult = any>(document: DocumentParameter<TResult, undefined>): UseQueryReturn<TResult, Record<string, never>>;
/**
* Use a query that has optional variables but not options
*/
export declare function useQuery<TResult = any, TVariables extends OperationVariables = OperationVariables>(document: DocumentParameter<TResult, TVariables>): UseQueryReturn<TResult, TVariables>;
/**
* Use a query that has required variables but not options
*/
export declare function useQuery<TResult = any, TVariables extends OperationVariables = OperationVariables>(document: DocumentParameter<TResult, TVariables>, variables: VariablesParameter<TVariables>): UseQueryReturn<TResult, TVariables>;
/**
* Use a query that requires options but not variables.
*/
export declare function useQuery<TResult = any>(document: DocumentParameter<TResult, undefined>, variables: undefined | null, options: OptionsParameter<TResult, Record<string, never>>): UseQueryReturn<TResult, Record<string, never>>;
/**
* Use a query that requires variables and options.
*/
export declare function useQuery<TResult = any, TVariables extends OperationVariables = OperationVariables>(document: DocumentParameter<TResult, TVariables>, variables: VariablesParameter<TVariables>, options: OptionsParameter<TResult, TVariables>): UseQueryReturn<TResult, TVariables>;
export declare function useQueryImpl<TResult, TVariables extends OperationVariables>(document: DocumentParameter<TResult, TVariables>, variables?: VariablesParameter<TVariables>, options?: OptionsParameter<TResult, TVariables>, lazy?: boolean): UseQueryReturn<TResult, TVariables>;