@braine/quantum-query 1.1.0 → 1.2.0

package/dist/index.d.cts

@@ -1,10 +1,25 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
 declare function subscribe(store: object, callback: (target: any, prop: any, value: any) => void): () => boolean;
 declare function createState<T extends object>(initialState: T): T;
 
+interface StorageAdapter {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+type PersistOptions<S> = {
+    key: string;
+    storage?: 'local' | 'session' | StorageAdapter;
+    paths?: (keyof S)[];
+    debug?: boolean;
+};
 type ModelDefinition<S, A, C> = {
     state: S;
     actions?: A & ThisType<S & A & C>;
     computed?: C & ThisType<S & A & C>;
+    persist?: PersistOptions<S>;
 };
 type ComputedValues<T> = {
     [K in keyof T]: T[K] extends (...args: any[]) => infer R ? R : never;
@@ -27,6 +42,11 @@ type RetryConfig = {
     maxDelay: number;
     shouldRetry?: (error: unknown, attempt: number) => boolean;
 };
+type CacheConfig = {
+    ttl: number;
+    force?: boolean;
+};
+type HttpClient$1 = any;
 type HttpClientConfig = {
     baseURL?: string;
     headers?: Record<string, string>;
@@ -34,7 +54,7 @@ type HttpClientConfig = {
     retry?: number | RetryConfig;
     auth?: {
         getToken: () => string | Promise<string | null>;
-        onTokenExpired: (client: HttpClient) => Promise<string | null>;
+        onTokenExpired: (client: HttpClient$1) => Promise<string | null>;
         onAuthFailed?: () => void;
     };
     interceptors?: {
@@ -47,10 +67,12 @@ type Validator<T> = {
     validateSync?: (data: unknown) => T;
 };
 type RequestConfig<T> = RequestInit & {
-    schema?: Validator<T>;
-    timeout?: number;
-    retry?: number | RetryConfig;
+    schema?: Validator<T> | undefined;
+    timeout?: number | undefined;
+    retry?: number | RetryConfig | undefined;
+    cache?: CacheConfig;
 };
+
 type HttpClient = {
     get: <T>(url: string, config?: RequestConfig<T>) => Promise<T>;
     post: <T>(url: string, data?: unknown, config?: RequestConfig<T>) => Promise<T>;
@@ -58,6 +80,7 @@ type HttpClient = {
     delete: <T>(url: string, config?: RequestConfig<T>) => Promise<T>;
     patch: <T>(url: string, data?: unknown, config?: RequestConfig<T>) => Promise<T>;
     request: <T>(url: string, config?: RequestConfig<T>) => Promise<T>;
+    config: HttpClientConfig;
 };
 declare function createHttpClient(config: HttpClientConfig): HttpClient;
 
@@ -70,4 +93,274 @@ declare function getPromiseState(promise: Promise<any>): {
     error: any;
 };
 
-export { computed, createHttpClient, createState, defineModel, enableDevTools, getPromiseState, handlePromise, isPromise, scheduleUpdate, subscribe, unwrapPromise, useStore };
+/**
+ * Generic Schema Interface
+ * Compatible with Zod, Valibot, ArkType, etc.
+ */
+interface Schema<T> {
+    parse: (data: unknown) => T;
+}
+interface QueryClientConfig {
+    defaultStaleTime?: number;
+    defaultCacheTime?: number;
+}
+/**
+ * Middleware Plugin Interface
+ */
+interface QueryPlugin {
+    name: string;
+    onFetchStart?: (queryKey: any[]) => void;
+    onFetchSuccess?: (queryKey: any[], data: any) => void;
+    onFetchError?: (queryKey: any[], error: Error) => void;
+    onInvalidate?: (queryKey: any[]) => void;
+    onQueryUpdated?: (queryKey: any[], data: any) => void;
+}
+
+/**
+ * Micro-Signals with Batching (Zero Dependency Reactivity)
+ *
+ * A minimal implementation of the Signals pattern with micro-batching for O(1) state updates.
+ * Uses queueMicrotask to coalesce multiple updates into a single notification cycle.
+ */
+interface Signal<T> {
+    get: () => T;
+    set: (value: T) => void;
+    subscribe: (fn: (value: T) => void) => () => void;
+}
+
+interface CacheEntry<T = any> {
+    data: T;
+    timestamp: number;
+    staleTime: number;
+    cacheTime: number;
+    key: any[];
+}
+interface QueryKey {
+    key: any[];
+    params?: Record<string, any>;
+}
+type QueryKeyInput = any[] | QueryKey;
+declare class QueryCache {
+    private signals;
+    private gcInterval;
+    private readonly defaultStaleTime;
+    private readonly defaultCacheTime;
+    constructor(config?: {
+        enableGC?: boolean;
+    });
+    /**
+     * Generate cache key from query key array
+     */
+    private generateKey;
+    /**
+     * Get data (wrapper around signal.get)
+     */
+    get<T>(queryKey: QueryKeyInput): T | undefined;
+    /**
+     * Get Signal for a key (Low level API for hooks)
+     * Automatically creates a signal if one doesn't exist
+     */
+    getSignal<T>(queryKey: QueryKeyInput): Signal<CacheEntry<T> | undefined>;
+    /**
+     * Check if data is stale
+     */
+    isStale(queryKey: QueryKeyInput): boolean;
+    /**
+     * Set cached data (updates signal)
+     */
+    set<T>(queryKey: QueryKeyInput, data: T, options?: {
+        staleTime?: number;
+        cacheTime?: number;
+    }): void;
+    private deduplicationCache;
+    private plugins;
+    /**
+     * Register a middleware plugin
+     */
+    use(plugin: QueryPlugin): this;
+    /**
+     * Fetch data with deduplication.
+     * If a request for the same key is already in flight, returns the existing promise.
+     */
+    fetch<T>(queryKey: QueryKeyInput, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Invalidate queries matching the key prefix
+     * Marks them as undefined to trigger refetches without breaking subscriptions
+     */
+    invalidate(queryKey: QueryKeyInput): void;
+    /**
+     * Remove all cache entries
+     */
+    clear(): void;
+    /**
+     * Prefetch data (same as set but explicit intent)
+     */
+    prefetch<T>(queryKey: QueryKeyInput, data: T, options?: {
+        staleTime?: number;
+        cacheTime?: number;
+    }): void;
+    /**
+     * Garbage collection - remove expired entries
+     */
+    private startGarbageCollection;
+    /**
+     * Stop garbage collection
+     */
+    destroy(): void;
+    /**
+     * Get cache stats (for debugging)
+     */
+    getStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Get all entries (wrapper for DevTools)
+     */
+    getAll(): Map<string, CacheEntry>;
+}
+declare const queryCache: QueryCache;
+
+/**
+ * Pagination Hook
+ * Provides offset-based and cursor-based pagination
+ */
+interface UsePaginatedQueryOptions<T> {
+    queryKey: string[];
+    queryFn: (page: number) => Promise<T>;
+    pageSize?: number;
+    staleTime?: number;
+    cacheTime?: number;
+    enabled?: boolean;
+}
+interface PaginatedQueryResult<T> {
+    data: T | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    page: number;
+    setPage: (page: number) => void;
+    nextPage: () => void;
+    previousPage: () => void;
+    hasNext: boolean;
+    hasPrevious: boolean;
+    refetch: () => Promise<void>;
+}
+declare function usePaginatedQuery<T>({ queryKey, queryFn, pageSize, staleTime, cacheTime, enabled }: UsePaginatedQueryOptions<T>): PaginatedQueryResult<T>;
+
+/**
+ * useQuery Hook
+ * Base query hook with stale-while-revalidate and background refetching
+ */
+
+interface UseQueryOptions<T> {
+    queryKey: any[];
+    queryFn: () => Promise<unknown>;
+    schema?: Schema<T>;
+    staleTime?: number;
+    cacheTime?: number;
+    enabled?: boolean;
+    refetchOnWindowFocus?: boolean;
+    refetchOnReconnect?: boolean;
+    refetchInterval?: number;
+}
+interface QueryResult<T> {
+    data: T | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    isFetching: boolean;
+    isStale: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+declare function useQuery<T>({ queryKey, queryFn, schema, staleTime, cacheTime, enabled, refetchOnWindowFocus, refetchOnReconnect, refetchInterval }: UseQueryOptions<T>): QueryResult<T>;
+
+/**
+ * useMutation Hook
+ * Handles mutations with optimistic updates and rollback
+ */
+interface UseMutationOptions<TData, TVariables, TContext = any> {
+    mutationFn: (variables: TVariables) => Promise<TData>;
+    onMutate?: (variables: TVariables) => Promise<TContext> | TContext;
+    onSuccess?: (data: TData, variables: TVariables, context: TContext | undefined) => void;
+    onError?: (error: Error, variables: TVariables, context: TContext | undefined) => void;
+    onSettled?: (data: TData | undefined, error: Error | null, variables: TVariables, context: TContext | undefined) => void;
+}
+interface MutationResult<TData, TVariables> {
+    mutate: (variables: TVariables) => Promise<void>;
+    mutateAsync: (variables: TVariables) => Promise<TData>;
+    data: TData | undefined;
+    error: Error | null;
+    isLoading: boolean;
+    isError: boolean;
+    isSuccess: boolean;
+    reset: () => void;
+}
+declare function useMutation<TData = unknown, TVariables = void, TContext = any>({ mutationFn, onMutate, onSuccess, onError, onSettled }: UseMutationOptions<TData, TVariables, TContext>): MutationResult<TData, TVariables>;
+declare const optimisticHelpers: {
+    /**
+     * Cancel ongoing queries for a key
+     */
+    cancelQueries(queryKey: any[]): Promise<void>;
+    /**
+     * Get current query data
+     */
+    getQueryData<T>(queryKey: any[]): T | undefined;
+    /**
+     * Set query data (for optimistic updates)
+     */
+    setQueryData<T>(queryKey: any[], updater: T | ((old: T | undefined) => T)): T | undefined;
+    /**
+     * Invalidate queries (trigger refetch)
+     */
+    invalidateQueries(queryKey: any[]): void;
+};
+
+type QueryClient = QueryCache;
+declare const QueryClientProvider: ({ client, children }: {
+    client: QueryClient;
+    children: ReactNode;
+}) => react_jsx_runtime.JSX.Element;
+declare const useQueryClient: () => QueryClient;
+
+/**
+ * Infinite Query Hook (Reactive)
+ * Provides infinite scroll with Signal-based reactivity
+ */
+interface UseInfiniteQueryOptions<T, TPageParam = any> {
+    queryKey: any[];
+    queryFn: (context: {
+        pageParam: TPageParam;
+    }) => Promise<T>;
+    getNextPageParam?: (lastPage: T, allPages: T[]) => TPageParam | undefined;
+    getPreviousPageParam?: (firstPage: T, allPages: T[]) => TPageParam | undefined;
+    initialPageParam?: TPageParam;
+    staleTime?: number;
+    cacheTime?: number;
+    enabled?: boolean;
+}
+interface InfiniteData<T> {
+    pages: T[];
+    pageParams: any[];
+}
+interface InfiniteQueryResult<T> {
+    data: InfiniteData<T> | undefined;
+    fetchNextPage: () => Promise<void>;
+    fetchPreviousPage: () => Promise<void>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetching: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+declare function useInfiniteQuery<T, TPageParam = any>({ queryKey, queryFn, getNextPageParam, getPreviousPageParam, initialPageParam, staleTime, cacheTime, enabled }: UseInfiniteQueryOptions<T, TPageParam>): InfiniteQueryResult<T>;
+
+declare function QuantumDevTools(): react_jsx_runtime.JSX.Element;
+
+declare function useQueryCache(): Map<string, CacheEntry<any>>;
+
+export { type CacheEntry, type HttpClient, type InfiniteData, type InfiniteQueryResult, type MutationResult, type PaginatedQueryResult, QuantumDevTools, QueryCache, type QueryClient, type QueryClientConfig, QueryClientProvider, type QueryKey, type QueryKeyInput, type QueryResult, type Schema, type UseInfiniteQueryOptions, type UseMutationOptions, type UsePaginatedQueryOptions, type UseQueryOptions, computed, createHttpClient, createState, defineModel, enableDevTools, getPromiseState, handlePromise, isPromise, optimisticHelpers, queryCache, scheduleUpdate, subscribe, unwrapPromise, useInfiniteQuery, useMutation, usePaginatedQuery, useQuery, useQueryCache, useQueryClient, useStore };

package/dist/index.d.ts

@@ -1,10 +1,25 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
 declare function subscribe(store: object, callback: (target: any, prop: any, value: any) => void): () => boolean;
 declare function createState<T extends object>(initialState: T): T;
 
+interface StorageAdapter {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+type PersistOptions<S> = {
+    key: string;
+    storage?: 'local' | 'session' | StorageAdapter;
+    paths?: (keyof S)[];
+    debug?: boolean;
+};
 type ModelDefinition<S, A, C> = {
     state: S;
     actions?: A & ThisType<S & A & C>;
     computed?: C & ThisType<S & A & C>;
+    persist?: PersistOptions<S>;
 };
 type ComputedValues<T> = {
     [K in keyof T]: T[K] extends (...args: any[]) => infer R ? R : never;
@@ -27,6 +42,11 @@ type RetryConfig = {
     maxDelay: number;
     shouldRetry?: (error: unknown, attempt: number) => boolean;
 };
+type CacheConfig = {
+    ttl: number;
+    force?: boolean;
+};
+type HttpClient$1 = any;
 type HttpClientConfig = {
     baseURL?: string;
     headers?: Record<string, string>;
@@ -34,7 +54,7 @@ type HttpClientConfig = {
     retry?: number | RetryConfig;
     auth?: {
         getToken: () => string | Promise<string | null>;
-        onTokenExpired: (client: HttpClient) => Promise<string | null>;
+        onTokenExpired: (client: HttpClient$1) => Promise<string | null>;
         onAuthFailed?: () => void;
     };
     interceptors?: {
@@ -47,10 +67,12 @@ type Validator<T> = {
     validateSync?: (data: unknown) => T;
 };
 type RequestConfig<T> = RequestInit & {
-    schema?: Validator<T>;
-    timeout?: number;
-    retry?: number | RetryConfig;
+    schema?: Validator<T> | undefined;
+    timeout?: number | undefined;
+    retry?: number | RetryConfig | undefined;
+    cache?: CacheConfig;
 };
+
 type HttpClient = {
     get: <T>(url: string, config?: RequestConfig<T>) => Promise<T>;
     post: <T>(url: string, data?: unknown, config?: RequestConfig<T>) => Promise<T>;
@@ -58,6 +80,7 @@ type HttpClient = {
     delete: <T>(url: string, config?: RequestConfig<T>) => Promise<T>;
     patch: <T>(url: string, data?: unknown, config?: RequestConfig<T>) => Promise<T>;
     request: <T>(url: string, config?: RequestConfig<T>) => Promise<T>;
+    config: HttpClientConfig;
 };
 declare function createHttpClient(config: HttpClientConfig): HttpClient;
 
@@ -70,4 +93,274 @@ declare function getPromiseState(promise: Promise<any>): {
     error: any;
 };
 
-export { computed, createHttpClient, createState, defineModel, enableDevTools, getPromiseState, handlePromise, isPromise, scheduleUpdate, subscribe, unwrapPromise, useStore };
+/**
+ * Generic Schema Interface
+ * Compatible with Zod, Valibot, ArkType, etc.
+ */
+interface Schema<T> {
+    parse: (data: unknown) => T;
+}
+interface QueryClientConfig {
+    defaultStaleTime?: number;
+    defaultCacheTime?: number;
+}
+/**
+ * Middleware Plugin Interface
+ */
+interface QueryPlugin {
+    name: string;
+    onFetchStart?: (queryKey: any[]) => void;
+    onFetchSuccess?: (queryKey: any[], data: any) => void;
+    onFetchError?: (queryKey: any[], error: Error) => void;
+    onInvalidate?: (queryKey: any[]) => void;
+    onQueryUpdated?: (queryKey: any[], data: any) => void;
+}
+
+/**
+ * Micro-Signals with Batching (Zero Dependency Reactivity)
+ *
+ * A minimal implementation of the Signals pattern with micro-batching for O(1) state updates.
+ * Uses queueMicrotask to coalesce multiple updates into a single notification cycle.
+ */
+interface Signal<T> {
+    get: () => T;
+    set: (value: T) => void;
+    subscribe: (fn: (value: T) => void) => () => void;
+}
+
+interface CacheEntry<T = any> {
+    data: T;
+    timestamp: number;
+    staleTime: number;
+    cacheTime: number;
+    key: any[];
+}
+interface QueryKey {
+    key: any[];
+    params?: Record<string, any>;
+}
+type QueryKeyInput = any[] | QueryKey;
+declare class QueryCache {
+    private signals;
+    private gcInterval;
+    private readonly defaultStaleTime;
+    private readonly defaultCacheTime;
+    constructor(config?: {
+        enableGC?: boolean;
+    });
+    /**
+     * Generate cache key from query key array
+     */
+    private generateKey;
+    /**
+     * Get data (wrapper around signal.get)
+     */
+    get<T>(queryKey: QueryKeyInput): T | undefined;
+    /**
+     * Get Signal for a key (Low level API for hooks)
+     * Automatically creates a signal if one doesn't exist
+     */
+    getSignal<T>(queryKey: QueryKeyInput): Signal<CacheEntry<T> | undefined>;
+    /**
+     * Check if data is stale
+     */
+    isStale(queryKey: QueryKeyInput): boolean;
+    /**
+     * Set cached data (updates signal)
+     */
+    set<T>(queryKey: QueryKeyInput, data: T, options?: {
+        staleTime?: number;
+        cacheTime?: number;
+    }): void;
+    private deduplicationCache;
+    private plugins;
+    /**
+     * Register a middleware plugin
+     */
+    use(plugin: QueryPlugin): this;
+    /**
+     * Fetch data with deduplication.
+     * If a request for the same key is already in flight, returns the existing promise.
+     */
+    fetch<T>(queryKey: QueryKeyInput, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Invalidate queries matching the key prefix
+     * Marks them as undefined to trigger refetches without breaking subscriptions
+     */
+    invalidate(queryKey: QueryKeyInput): void;
+    /**
+     * Remove all cache entries
+     */
+    clear(): void;
+    /**
+     * Prefetch data (same as set but explicit intent)
+     */
+    prefetch<T>(queryKey: QueryKeyInput, data: T, options?: {
+        staleTime?: number;
+        cacheTime?: number;
+    }): void;
+    /**
+     * Garbage collection - remove expired entries
+     */
+    private startGarbageCollection;
+    /**
+     * Stop garbage collection
+     */
+    destroy(): void;
+    /**
+     * Get cache stats (for debugging)
+     */
+    getStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Get all entries (wrapper for DevTools)
+     */
+    getAll(): Map<string, CacheEntry>;
+}
+declare const queryCache: QueryCache;
+
+/**
+ * Pagination Hook
+ * Provides offset-based and cursor-based pagination
+ */
+interface UsePaginatedQueryOptions<T> {
+    queryKey: string[];
+    queryFn: (page: number) => Promise<T>;
+    pageSize?: number;
+    staleTime?: number;
+    cacheTime?: number;
+    enabled?: boolean;
+}
+interface PaginatedQueryResult<T> {
+    data: T | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    page: number;
+    setPage: (page: number) => void;
+    nextPage: () => void;
+    previousPage: () => void;
+    hasNext: boolean;
+    hasPrevious: boolean;
+    refetch: () => Promise<void>;
+}
+declare function usePaginatedQuery<T>({ queryKey, queryFn, pageSize, staleTime, cacheTime, enabled }: UsePaginatedQueryOptions<T>): PaginatedQueryResult<T>;
+
+/**
+ * useQuery Hook
+ * Base query hook with stale-while-revalidate and background refetching
+ */
+
+interface UseQueryOptions<T> {
+    queryKey: any[];
+    queryFn: () => Promise<unknown>;
+    schema?: Schema<T>;
+    staleTime?: number;
+    cacheTime?: number;
+    enabled?: boolean;
+    refetchOnWindowFocus?: boolean;
+    refetchOnReconnect?: boolean;
+    refetchInterval?: number;
+}
+interface QueryResult<T> {
+    data: T | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    isFetching: boolean;
+    isStale: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+declare function useQuery<T>({ queryKey, queryFn, schema, staleTime, cacheTime, enabled, refetchOnWindowFocus, refetchOnReconnect, refetchInterval }: UseQueryOptions<T>): QueryResult<T>;
+
+/**
+ * useMutation Hook
+ * Handles mutations with optimistic updates and rollback
+ */
+interface UseMutationOptions<TData, TVariables, TContext = any> {
+    mutationFn: (variables: TVariables) => Promise<TData>;
+    onMutate?: (variables: TVariables) => Promise<TContext> | TContext;
+    onSuccess?: (data: TData, variables: TVariables, context: TContext | undefined) => void;
+    onError?: (error: Error, variables: TVariables, context: TContext | undefined) => void;
+    onSettled?: (data: TData | undefined, error: Error | null, variables: TVariables, context: TContext | undefined) => void;
+}
+interface MutationResult<TData, TVariables> {
+    mutate: (variables: TVariables) => Promise<void>;
+    mutateAsync: (variables: TVariables) => Promise<TData>;
+    data: TData | undefined;
+    error: Error | null;
+    isLoading: boolean;
+    isError: boolean;
+    isSuccess: boolean;
+    reset: () => void;
+}
+declare function useMutation<TData = unknown, TVariables = void, TContext = any>({ mutationFn, onMutate, onSuccess, onError, onSettled }: UseMutationOptions<TData, TVariables, TContext>): MutationResult<TData, TVariables>;
+declare const optimisticHelpers: {
+    /**
+     * Cancel ongoing queries for a key
+     */
+    cancelQueries(queryKey: any[]): Promise<void>;
+    /**
+     * Get current query data
+     */
+    getQueryData<T>(queryKey: any[]): T | undefined;
+    /**
+     * Set query data (for optimistic updates)
+     */
+    setQueryData<T>(queryKey: any[], updater: T | ((old: T | undefined) => T)): T | undefined;
+    /**
+     * Invalidate queries (trigger refetch)
+     */
+    invalidateQueries(queryKey: any[]): void;
+};
+
+type QueryClient = QueryCache;
+declare const QueryClientProvider: ({ client, children }: {
+    client: QueryClient;
+    children: ReactNode;
+}) => react_jsx_runtime.JSX.Element;
+declare const useQueryClient: () => QueryClient;
+
+/**
+ * Infinite Query Hook (Reactive)
+ * Provides infinite scroll with Signal-based reactivity
+ */
+interface UseInfiniteQueryOptions<T, TPageParam = any> {
+    queryKey: any[];
+    queryFn: (context: {
+        pageParam: TPageParam;
+    }) => Promise<T>;
+    getNextPageParam?: (lastPage: T, allPages: T[]) => TPageParam | undefined;
+    getPreviousPageParam?: (firstPage: T, allPages: T[]) => TPageParam | undefined;
+    initialPageParam?: TPageParam;
+    staleTime?: number;
+    cacheTime?: number;
+    enabled?: boolean;
+}
+interface InfiniteData<T> {
+    pages: T[];
+    pageParams: any[];
+}
+interface InfiniteQueryResult<T> {
+    data: InfiniteData<T> | undefined;
+    fetchNextPage: () => Promise<void>;
+    fetchPreviousPage: () => Promise<void>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetching: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+declare function useInfiniteQuery<T, TPageParam = any>({ queryKey, queryFn, getNextPageParam, getPreviousPageParam, initialPageParam, staleTime, cacheTime, enabled }: UseInfiniteQueryOptions<T, TPageParam>): InfiniteQueryResult<T>;
+
+declare function QuantumDevTools(): react_jsx_runtime.JSX.Element;
+
+declare function useQueryCache(): Map<string, CacheEntry<any>>;
+
+export { type CacheEntry, type HttpClient, type InfiniteData, type InfiniteQueryResult, type MutationResult, type PaginatedQueryResult, QuantumDevTools, QueryCache, type QueryClient, type QueryClientConfig, QueryClientProvider, type QueryKey, type QueryKeyInput, type QueryResult, type Schema, type UseInfiniteQueryOptions, type UseMutationOptions, type UsePaginatedQueryOptions, type UseQueryOptions, computed, createHttpClient, createState, defineModel, enableDevTools, getPromiseState, handlePromise, isPromise, optimisticHelpers, queryCache, scheduleUpdate, subscribe, unwrapPromise, useInfiniteQuery, useMutation, usePaginatedQuery, useQuery, useQueryCache, useQueryClient, useStore };