import type { Awaitable, Stop } from './types.js';
export type ResourceStatus = 'idle' | 'loading' | 'success' | 'error';
export interface ResourceSnapshot<Data> {
    readonly status: ResourceStatus;
    readonly data?: Data;
    readonly error?: unknown;
    readonly updatedAt: number;
    readonly stale: boolean;
    readonly fetching: boolean;
}
export interface ResourceContext {
    readonly signal: AbortSignal;
    readonly requestId: string;
}
export interface ResourceEndpoint<Argument, Data> {
    readonly load: (context: ResourceContext, argument: Argument) => Awaitable<Data>;
    readonly tags?: (data: Data, argument: Argument) => readonly string[];
    readonly staleMs?: number;
    readonly retainMs?: number;
    readonly retry?: number;
    readonly retryDelayMs?: (attempt: number) => number;
    readonly stream?: (context: ResourceContext, argument: Argument, update: (recipe: (data: Data) => Data) => void) => Awaitable<Stop | void>;
}
export type ResourceCatalog = Record<string, ResourceEndpoint<any, any>>;
export type ArgumentOf<Endpoint> = Endpoint extends ResourceEndpoint<infer Argument, any> ? Argument : never;
export type DataOf<Endpoint> = Endpoint extends ResourceEndpoint<any, infer Data> ? Data : never;
export interface ResourceFetchOptions {
    readonly force?: boolean;
    readonly signal?: AbortSignal;
}
export interface ResourceHub<Endpoints extends ResourceCatalog> {
    read<Name extends keyof Endpoints & string>(name: Name, argument: ArgumentOf<Endpoints[Name]>): ResourceSnapshot<DataOf<Endpoints[Name]>>;
    fetch<Name extends keyof Endpoints & string>(name: Name, argument: ArgumentOf<Endpoints[Name]>, options?: ResourceFetchOptions): Promise<DataOf<Endpoints[Name]>>;
    prefetch<Name extends keyof Endpoints & string>(name: Name, argument: ArgumentOf<Endpoints[Name]>): Promise<void>;
    watch<Name extends keyof Endpoints & string>(name: Name, argument: ArgumentOf<Endpoints[Name]>, listener: () => void): Stop;
    invalidate(tags: readonly string[]): Promise<void>;
    optimistic<Name extends keyof Endpoints & string>(name: Name, argument: ArgumentOf<Endpoints[Name]>, recipe: (data: DataOf<Endpoints[Name]>) => DataOf<Endpoints[Name]>): Stop;
    startStream<Name extends keyof Endpoints & string>(name: Name, argument: ArgumentOf<Endpoints[Name]>): Promise<Stop>;
    inject<Name extends string, Argument, Data>(name: Name, endpoint: ResourceEndpoint<Argument, Data>): Stop;
    dehydrate(): unknown;
    hydrate(payload: unknown): void;
    clear(): void;
}
export declare function forgeResourceHub<Endpoints extends ResourceCatalog>(initial: Endpoints): ResourceHub<Endpoints>;
export declare function bindBrowserResourceRefresh<Endpoints extends ResourceCatalog>(hub: ResourceHub<Endpoints>, targets: () => Array<{
    name: keyof Endpoints & string;
    argument: unknown;
}>): Stop;
export declare function pollResource<Endpoints extends ResourceCatalog, Name extends keyof Endpoints & string>(hub: ResourceHub<Endpoints>, name: Name, argument: ArgumentOf<Endpoints[Name]>, intervalMs: number, options?: {
    readonly skipWhenHidden?: boolean;
    readonly onFault?: (error: unknown) => void;
}): Stop;
//# sourceMappingURL=resources.d.ts.map