import type { TableFixture } from '../types';
/** Supported connection reuse strategies exposed by the provider. */
export type ConnectionStrategy = 'shared' | 'perTest';
/** Minimum subset of a connection required by the provider. */
export type TestkitConnection = {
    query(sql: string, values?: unknown[]): Promise<unknown>;
};
/** Custom hook invoked after a shared scenario to reset session state. */
export type ConnectionResetHook<TConnection extends TestkitConnection> = (connection: TConnection) => Promise<void> | void;
/**
 * Options that determine how the shared connection is cleaned up between scenarios.
 */
export type ConnectionResetOption<TConnection extends TestkitConnection> = 'transaction' | 'none' | ConnectionResetHook<TConnection>;
/**
 * Configuration required to construct a `TestkitProvider`.
 */
export interface CreateTestkitProviderOptions<TConnection extends TestkitConnection, TResource> {
    connectionFactory: () => Promise<TConnection>;
    resourceFactory: (connection: TConnection, fixtures: TableFixture[]) => Promise<TResource> | TResource;
    strategy?: ConnectionStrategy;
    reset?: ConnectionResetOption<TConnection>;
    releaseResource?: (resource: TResource) => Promise<void> | void;
    disposeConnection?: (connection: TConnection) => Promise<void> | void;
}
type PerTestAccessor<TResource> = {
    withRepositoryFixture<Result>(fixtures: TableFixture[], callback: (resource: TResource) => Promise<Result> | Result): Promise<Result>;
};
/**
 * Manages connection recycling for ZTD repositories by wiring fixtures into
 * shared or per-test sessions.
 */
export declare class TestkitProvider<TConnection extends TestkitConnection, TResource> {
    private readonly options;
    private sharedConnectionPromise?;
    private sharedConnection?;
    private closed;
    private sharedQueue;
    private readonly releaseResource;
    private readonly disposeConnection;
    constructor(options: CreateTestkitProviderOptions<TConnection, TResource>);
    withRepositoryFixture<Result>(fixtures: TableFixture[], callback: (resource: TResource) => Promise<Result> | Result, overrides?: {
        strategy?: ConnectionStrategy;
    }): Promise<Result>;
    perTest(): PerTestAccessor<TResource>;
    close(): Promise<void>;
    private runWithSharedConnection;
    private runWithPerTestConnection;
    private beginTransactionIfNeeded;
    private executeReset;
    private ensureSharedConnection;
    private ensureNotClosed;
}
/**
 * Instantiates a `TestkitProvider` with the given configuration.
 */
export declare function createTestkitProvider<TConnection extends TestkitConnection, TResource>(options: CreateTestkitProviderOptions<TConnection, TResource>): Promise<TestkitProvider<TConnection, TResource>>;
export {};