flutter_query_client library

Classes

CachedQueryData<T>

InfiniteQueryBuilder<B extends StateStreamable<QueryState<List<T>>>, T>

InfiniteQueryConsumer<B extends BlocBase<QueryState<List<T>>>, T>

Combines InfiniteQueryBuilder and InfiniteQueryListener in a single widget — the List wrapper is baked in so you only specify the item type.

InfiniteQueryController<T, PageParam, P>

Controller for cursor-based infinite pagination queries.

InfiniteQueryListener<B extends StateStreamable<QueryState<List<T>>>, T>

A BlocListener scoped to InfiniteQueryController state.

InfiniteQueryProvider<T extends InfiniteQueryController>

InfiniteQuerySelector<B extends StateStreamable<QueryState<List<T>>>, T, S>

A BlocSelector scoped to InfiniteQueryController state.

InternetCheckOption

Options for checking the internet connectivity to an address.

MultiQueryListener

MultiQueryProvider

Nests multiple QueryProvider and InfiniteQueryProvider widgets without deep indentation.

MutationController<T, P>

Base class for user-triggered mutations with typed params.

NetworkConnectivityObserver

Observes network connectivity using internet_connection_checker_plus for true L7 internet verification (HTTP HEAD requests to reliable endpoints), with connectivity_plus wired as a trigger stream for faster detection.

QueryBuilder<B extends StateStreamable<QueryState<T>>, T>

QueryClient

QueryClientProvider

Provides a QueryClient to the widget tree and configures global defaults.

QueryConsumer<B extends BlocBase<QueryState<T>>, T>

Combines QueryBuilder and QueryListener in a single widget.

QueryController<T, P>

Base class for reactive data fetching with typed params.

QueryDefaults

Global default configuration for all queries and mutations.

QueryListener<B extends StateStreamable<QueryState<T>>, T>

QueryLogger

Internal logger for flutter_query.

QueryObserver

A BlocObserver specialised for query and mutation controllers.

QueryProvider<C extends Cubit<QueryState<T>>, T>

QueryProviderWidget

Base class for provider widgets that can be composed inside MultiQueryProvider.

QuerySelector<B extends StateStreamable<QueryState<T>>, T, S>

A BlocSelector scoped to QueryController / MutationController state.

QueryState<V>

Enums

FetchStatus

The background fetch status of a query.

NetworkMode

Controls whether a query requires network connectivity to execute.

QueryStatus

The overall status of a query or mutation.

RefetchOnMount

Controls whether a query refetches when its widget mounts with cached data.

RefetchOnReconnect

Controls whether active queries refetch when network connectivity is restored.

Extensions

QueryContextExtension on BuildContext

QueryStatePatterns on QueryState<V>

Adds pattern-matching-related methods to QueryState.

Typedefs

ErrorTransformer = Object Function(Object error)

Signature for error transformation callbacks.

ReconnectCallback = void Function({required bool isStale})

Callback invoked when the device reconnects to the network.

Exceptions / Errors

QueryException

Exception thrown by the flutter_query package when an operation fails due to internal machinery (e.g., retry exhaustion).