/**
 * Helper functions for DatabaseService
 *
 * Contains utility functions for validation, path resolution,
 * and foreign key error handling.
 */
import Database from 'better-sqlite3';
/**
 * Default storage path for databases
 */
export declare const DEFAULT_STORAGE_PATH: string;
/**
 * Validate database name format
 */
export declare function validateName(name: string): void;
/**
 * Get full database path
 */
export declare function getDatabasePath(name: string, storagePath?: string): string;
/**
 * Query document, chunk, and embedding counts from an open database connection.
 */
export declare function queryDatabaseCounts(db: InstanceType<typeof Database>): {
    document_count: number;
    chunk_count: number;
    embedding_count: number;
};
/**
 * Helper function to run a statement with foreign key error handling.
 * Converts SQLite FK constraint errors to DatabaseError with proper code.
 *
 * @param stmt - Prepared statement to run
 * @param params - Parameters to bind
 * @param context - Error context message (e.g., "inserting document: provenance_id does not exist")
 */
export declare function runWithForeignKeyCheck(stmt: Database.Statement, params: unknown[], context: string): Database.RunResult;
//# sourceMappingURL=helpers.d.ts.map