/**
 * SQLite Connection Module
 *
 * Provides singleton database connection to ~/.shep/data
 * Configures pragmas for optimal performance and reliability.
 */
import Database from 'better-sqlite3';
/**
 * Gets or creates the SQLite database connection.
 * Singleton pattern ensures only one connection exists.
 *
 * On first call:
 * - Ensures ~/.shep/ directory exists
 * - Creates database file at ~/.shep/data
 * - Configures pragmas for performance and reliability
 *
 * @returns Database connection instance
 *
 * @example
 * ```typescript
 * const db = await getSQLiteConnection();
 * const settings = db.prepare('SELECT * FROM settings').get();
 * ```
 */
export declare function getSQLiteConnection(): Promise<Database.Database>;
/**
 * Closes the database connection.
 * Should be called when application exits.
 * Safe to call multiple times.
 */
export declare function closeSQLiteConnection(): void;
/**
 * Gets the current database instance without creating one.
 * Returns null if connection hasn't been established yet.
 *
 * @returns Database instance or null
 */
export declare function getExistingConnection(): Database.Database | null;
//# sourceMappingURL=connection.d.ts.map