type Subscriber<THandleId extends string> = (handleId: THandleId) => void;
type StageSubscriber<TStage extends string> = (stage: TStage) => void;
type LifecycleStage = "uninitialized" | "ready" | "invalidated";
type StageMap<TStage extends string> = {
    uninitialized: TStage;
    ready: TStage;
    invalidated: TStage;
};
/**
 * Serializes leaf command dispatches for a lazily resolved handle.
 * Command callbacks must not enqueue another command on the same client.
 */
export type LazyHandleClient<THandleId extends string, TSettlement, TStage extends string = LifecycleStage> = {
    runCommand<TPayload>(buildPayload: (handleId: THandleId | undefined) => TPayload, dispatchAndWait: (payload: TPayload) => Promise<TSettlement>): Promise<TSettlement>;
    runCommandWithRetry<TPayload>(buildPayload: (handleId: THandleId | undefined) => TPayload, dispatchAndWait: (payload: TPayload) => Promise<TSettlement>, options: {
        shouldRetry: (error: unknown) => boolean;
        onBeforeRetry?: (error: unknown) => void;
    }): Promise<TSettlement>;
    /** At its FIFO turn, dispatches with the current handle or no-ops if absent. */
    runResolvedHandleCommand<TPayload>(buildPayload: (handleId: THandleId) => TPayload, dispatchAndWait: (payload: TPayload) => Promise<void>): Promise<void>;
    getHandleId(): THandleId | undefined;
    /** Clears the resolved handle before retrying a stale-handle command. */
    clearHandleForRetry(): THandleId | undefined;
    /** Records an authoritative invalidation for the active command. */
    recordHandleInvalidation(handleId: string): THandleId | undefined;
    /**
     * Clears a matching resolved handle without cancelling active command
     * recovery.
     */
    clearHandleIfMatching(handleId: string): THandleId | undefined;
    hasPendingCommands(): boolean;
    subscribeHandle(subscriber: Subscriber<THandleId>): () => void;
    getStage(): TStage;
    setStage(stage: TStage): void;
    subscribeStage(subscriber: StageSubscriber<TStage>): () => void;
    reset(): void;
    invalidate(): void;
};
export type CreateLazyHandleClientOptions<THandleId extends string, TSettlement, TStage extends string = LifecycleStage> = {
    getHandleIdFromSettlement: (settlement: TSettlement) => THandleId | undefined;
    stages?: StageMap<TStage>;
    initialStage?: TStage;
};
type CreateLazyHandleClientDefaultOptions<THandleId extends string, TSettlement> = {
    getHandleIdFromSettlement: (settlement: TSettlement) => THandleId | undefined;
    initialStage?: LifecycleStage;
    stages?: undefined;
};
type CreateLazyHandleClientCustomOptions<THandleId extends string, TSettlement, TStage extends string> = {
    getHandleIdFromSettlement: (settlement: TSettlement) => THandleId | undefined;
    stages: StageMap<TStage>;
    initialStage?: TStage;
};
export declare function createLazyHandleClient<THandleId extends string, TSettlement>(options: CreateLazyHandleClientDefaultOptions<THandleId, TSettlement>): LazyHandleClient<THandleId, TSettlement, LifecycleStage>;
export declare function createLazyHandleClient<THandleId extends string, TSettlement, TStage extends string>(options: CreateLazyHandleClientCustomOptions<THandleId, TSettlement, TStage>): LazyHandleClient<THandleId, TSettlement, TStage>;
export {};
//# sourceMappingURL=lazy-handle-client.d.ts.map