import { Entity, User } from "@rebasepro/types";
import { AdminCollection } from "@rebasepro/cms-types";
/**
 * @group Hooks and utilities
 */
export interface FetchProps<M extends Record<string, any>, USER extends User = User> {
    path: string;
    entityId?: string | number;
    databaseId?: string;
    collection: AdminCollection<M, USER>;
    useCache?: boolean;
}
/**
 * @group Hooks and utilities
 */
export interface FetchResult<M extends Record<string, any>> {
    entity?: Entity<M>;
    dataLoading: boolean;
    dataLoadingError?: Error;
}
/**
 * Pre-populate the entity fetch cache with entities loaded from a collection.
 * This allows entity detail views to render instantly using cached data,
 * while the background fetch/listener brings in fresh data.
 * @param path - The collection path (e.g. "products")
 * @param entities - Array of entities to cache
 */
export declare function populateFetchCache<M extends Record<string, any>>(path: string, entities: Entity<M>[]): void;
/**
 * Clear the entity fetch cache. Call this on auth state changes (e.g. logout)
 * to prevent stale data from a previous session leaking into the next.
 */
export declare function clearFetchCache(): void;
/**
 * This hook is used to fetch a entity.
 * It gives real time updates if the driver supports it.
 * @param path
 * @param collection
 * @param entityId
 * @param useCache
 * @group Hooks and utilities
 */
export declare function useFetch<M extends Record<string, any>, USER extends User = User>({ path, entityId, collection, databaseId, useCache }: FetchProps<M, USER>): FetchResult<M>;