import Database from 'better-sqlite3';
export interface ConnectionOptions {
    /** Enable WAL mode (default: true) */
    walMode?: boolean;
    /** Busy timeout in ms (default: 5000) */
    busyTimeout?: number;
    /** Foreign keys enabled (default: true) */
    foreignKeys?: boolean;
    /** Journal mode (overrides walMode if set) */
    journalMode?: string;
    /** Synchronous mode (default: 'NORMAL') */
    synchronous?: string;
}
/**
 * Open a SQLite database connection with proper configuration.
 * Creates parent directories if they don't exist (for file-based databases).
 *
 * @param dbPath - Path to the database file, or ':memory:' for in-memory
 * @param options - Connection configuration options
 * @returns Configured better-sqlite3 Database instance
 * @throws ERR-DB-001 through ERR-DB-004, ERR-CONN-001, ERR-CONN-002
 */
export declare function openConnection(dbPath: string, options?: ConnectionOptions): Database.Database;
/**
 * Verify that a database connection is properly configured.
 * Returns an object with the current pragma settings.
 */
export declare function verifyConnection(db: Database.Database): {
    journalMode: string;
    busyTimeout: number;
    foreignKeys: number;
    synchronous: number;
};
//# sourceMappingURL=connection.d.ts.map