/** Base class for all sql-client errors. */
export declare class SqlException extends Error {
    constructor(message: string);
}
/** Thrown when a query/execute fails. Carries the offending SQL, params, and driver cause. */
export declare class QueryFailedException extends SqlException {
    readonly sql: string;
    readonly params: unknown[];
    constructor(message: string, sql: string, params: unknown[], cause?: unknown);
}
/** Build a QueryFailedException with a rich multi-line message (engine, sql, params, placeholder hint). */
export declare function wrapQueryError(engine: string, sql: string, params: unknown[], cause: unknown): QueryFailedException;
/** True only when a lazy require() failed because `moduleName` itself is missing — not when the
 *  module exists but failed to load (native ABI mismatch, Instant Client, transitive errors). */
export declare function isModuleNotFound(err: unknown, moduleName: string): boolean;
/** Thrown when an engine is unknown or its native driver isn't installed. */
export declare class UnsupportedEngineException extends SqlException {
    constructor(message: string);
}
/** Thrown when a result-set cardinality expectation is violated (e.g. one() on 0 or >1 rows). */
export declare class ResultError extends SqlException {
    constructor(message: string);
}