fss-link 1.0.51 → 1.0.53

package/dist/src/config/database-utils.js

@@ -0,0 +1,295 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * TEMPORARY DATABASE UTILITIES
+ *
+ * These wrapper functions provide immediate relief from manual memory management
+ * while we transition to a proper ORM/repository pattern.
+ *
+ * @todo PHASE 2: Replace with Repository pattern (BaseRepository, ModelRepository, etc.)
+ * @todo PHASE 3: Consider migrating to Drizzle ORM or similar for full type safety
+ *
+ * Current problems these wrappers solve:
+ * - Manual .free() calls causing memory leaks
+ * - Inconsistent error handling patterns
+ * - No automatic cleanup on exceptions
+ * - Raw SQL scattered throughout business logic
+ */
+/**
+ * Safe query execution with automatic statement cleanup.
+ * Returns all matching rows as an array.
+ *
+ * @todo UPGRADE: Replace with repository.findMany() method
+ *
+ * @param db - SQLite database instance
+ * @param sql - SQL query string
+ * @param params - Query parameters (optional)
+ * @returns Array of query results
+ * @throws DatabaseError for SQL execution errors
+ */
+export function safeQuery(db, sql, params = []) {
+    let stmt = null;
+    try {
+        stmt = db.prepare(sql);
+        if (params.length > 0) {
+            stmt.bind(params);
+        }
+        const results = [];
+        while (stmt.step()) {
+            results.push(stmt.getAsObject());
+        }
+        return results;
+    }
+    catch (error) {
+        throw new DatabaseError(`Query failed: ${sql}`, error);
+    }
+    finally {
+        if (stmt) {
+            stmt.free();
+        }
+    }
+}
+/**
+ * Safe query execution returning first result or null.
+ * Automatically handles statement cleanup.
+ *
+ * @todo UPGRADE: Replace with repository.findFirst() method
+ *
+ * @param db - SQLite database instance
+ * @param sql - SQL query string
+ * @param params - Query parameters (optional)
+ * @returns First matching row or null
+ * @throws DatabaseError for SQL execution errors
+ */
+export function safeQueryFirst(db, sql, params = []) {
+    let stmt = null;
+    try {
+        stmt = db.prepare(sql);
+        if (params.length > 0) {
+            stmt.bind(params);
+        }
+        return stmt.step() ? stmt.getAsObject() : null;
+    }
+    catch (error) {
+        throw new DatabaseError(`Query failed: ${sql}`, error);
+    }
+    finally {
+        if (stmt) {
+            stmt.free();
+        }
+    }
+}
+/**
+ * Safe execution of INSERT/UPDATE/DELETE statements.
+ * Automatically handles statement cleanup.
+ *
+ * @todo UPGRADE: Replace with repository.create()/update()/delete() methods
+ *
+ * @param db - SQLite database instance
+ * @param sql - SQL statement string
+ * @param params - Statement parameters (optional)
+ * @returns Number of affected rows
+ * @throws DatabaseError for SQL execution errors
+ */
+export function safeExec(db, sql, params = []) {
+    let stmt = null;
+    try {
+        stmt = db.prepare(sql);
+        if (params.length > 0) {
+            stmt.bind(params);
+        }
+        stmt.step();
+        // Get affected rows count for INSERT/UPDATE/DELETE
+        const changes = db.exec('SELECT changes() as count')[0];
+        return changes?.values?.[0]?.[0] || 0;
+    }
+    catch (error) {
+        throw new DatabaseError(`Execution failed: ${sql}`, error);
+    }
+    finally {
+        if (stmt) {
+            stmt.free();
+        }
+    }
+}
+/**
+ * Safe transaction execution with automatic rollback on error.
+ * Ensures consistent database state even if operations fail.
+ *
+ * @todo UPGRADE: Replace with repository.withTransaction() method
+ *
+ * @param db - SQLite database instance
+ * @param operations - Function containing database operations
+ * @returns Result of operations function
+ * @throws DatabaseError for transaction failures
+ */
+export function safeTransaction(db, operations) {
+    try {
+        db.exec('BEGIN TRANSACTION');
+        const result = operations();
+        db.exec('COMMIT');
+        return result;
+    }
+    catch (error) {
+        try {
+            db.exec('ROLLBACK');
+        }
+        catch (rollbackError) {
+            // Log rollback failure but throw original error
+            console.error('Failed to rollback transaction:', rollbackError);
+        }
+        throw new DatabaseError('Transaction failed', error);
+    }
+}
+/**
+ * Get the last inserted row ID from an INSERT operation.
+ * Helper for operations that need the new record ID.
+ *
+ * @todo UPGRADE: Repository pattern will handle this automatically
+ *
+ * @param db - SQLite database instance
+ * @returns Last inserted row ID
+ */
+export function getLastInsertId(db) {
+    const result = safeQueryFirst(db, 'SELECT last_insert_rowid() as id');
+    return result?.id || 0;
+}
+/**
+ * Custom error class for database operations.
+ * Provides consistent error handling across all database functions.
+ *
+ * @todo UPGRADE: Repository pattern will have more specific error types
+ */
+export class DatabaseError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'DatabaseError';
+        // Include original error details if available
+        if (cause instanceof Error) {
+            this.message += ` (${cause.message})`;
+        }
+    }
+}
+/**
+ * MIGRATION HELPERS
+ *
+ * These functions help gradually replace manual prepare/free patterns
+ * throughout the existing codebase.
+ */
+/**
+ * Check if a table exists in the database.
+ * Common pattern used in migration logic.
+ *
+ * @param db - SQLite database instance
+ * @param tableName - Name of table to check
+ * @returns True if table exists
+ */
+export function tableExists(db, tableName) {
+    const result = safeQueryFirst(db, 'SELECT COUNT(*) as count FROM sqlite_master WHERE type="table" AND name=?', [tableName]);
+    return (result?.count || 0) > 0;
+}
+/**
+ * Check if a column exists in a table.
+ * Useful for schema validation and migrations.
+ *
+ * @param db - SQLite database instance
+ * @param tableName - Name of table
+ * @param columnName - Name of column to check
+ * @returns True if column exists
+ */
+export function columnExists(db, tableName, columnName) {
+    try {
+        const result = safeQuery(db, `PRAGMA table_info(${tableName})`);
+        return result.some((col) => col.name === columnName);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * COMMON UTILITY PATTERNS
+ *
+ * These higher-level helpers encapsulate frequent database patterns
+ */
+/**
+ * Check if any records exist matching the criteria
+ * @param db - SQLite database instance
+ * @param table - Table name
+ * @param whereClause - WHERE clause (without WHERE keyword)
+ * @param params - Parameters for WHERE clause
+ * @returns True if any records exist
+ */
+export function recordExists(db, table, whereClause, params = []) {
+    const result = safeQueryFirst(db, `SELECT COUNT(*) as count FROM ${table} WHERE ${whereClause}`, params);
+    return (result?.count || 0) > 0;
+}
+/**
+ * Count records matching criteria
+ * @param db - SQLite database instance
+ * @param table - Table name
+ * @param whereClause - WHERE clause (without WHERE keyword, optional)
+ * @param params - Parameters for WHERE clause
+ * @returns Number of matching records
+ */
+export function countRecords(db, table, whereClause, params = []) {
+    const sql = whereClause
+        ? `SELECT COUNT(*) as count FROM ${table} WHERE ${whereClause}`
+        : `SELECT COUNT(*) as count FROM ${table}`;
+    const result = safeQueryFirst(db, sql, params);
+    return result?.count || 0;
+}
+/**
+ * Delete records with safe execution
+ * @param db - SQLite database instance
+ * @param table - Table name
+ * @param whereClause - WHERE clause (without WHERE keyword)
+ * @param params - Parameters for WHERE clause
+ * @returns Number of deleted records
+ */
+export function deleteRecords(db, table, whereClause, params = []) {
+    return safeExec(db, `DELETE FROM ${table} WHERE ${whereClause}`, params);
+}
+/**
+ * Update records with safe execution
+ * @param db - SQLite database instance
+ * @param table - Table name
+ * @param setClause - SET clause (without SET keyword)
+ * @param whereClause - WHERE clause (without WHERE keyword)
+ * @param params - Parameters for SET and WHERE clauses
+ * @returns Number of updated records
+ */
+export function updateRecords(db, table, setClause, whereClause, params = []) {
+    return safeExec(db, `UPDATE ${table} SET ${setClause} WHERE ${whereClause}`, params);
+}
+/**
+ * EXAMPLE MIGRATION FROM OLD PATTERN TO NEW PATTERN:
+ *
+ * // OLD (manual memory management):
+ * const stmt = db.prepare('SELECT * FROM model_configs WHERE auth_type = ?');
+ * stmt.bind([authType]);
+ * const results = [];
+ * while (stmt.step()) {
+ *   results.push(stmt.getAsObject());
+ * }
+ * stmt.free(); // Easy to forget!
+ *
+ * // NEW (automatic cleanup):
+ * const results = safeQuery(db, 'SELECT * FROM model_configs WHERE auth_type = ?', [authType]);
+ *
+ * // UTILITY HELPERS:
+ * const hasActiveModels = recordExists(db, 'model_configs', 'is_active = 1');
+ * const modelCount = countRecords(db, 'model_configs', 'auth_type = ?', ['ollama']);
+ * const deletedCount = deleteRecords(db, 'model_configs', 'is_active = 0 AND last_used < ?', [cutoffDate]);
+ *
+ * // FUTURE (repository pattern):
+ * const results = await modelRepo.findByAuthType(authType);
+ * const hasActive = await modelRepo.hasActive();
+ * const count = await modelRepo.countByAuthType('ollama');
+ * const deleted = await modelRepo.deleteInactive(cutoffDate);
+ */ 
+//# sourceMappingURL=database-utils.js.map

package/dist/src/config/database-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-utils.js","sourceRoot":"","sources":["../../../src/config/database-utils.ts"],"names":[],"mappings":"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"}

package/dist/src/config/database.d.ts

@@ -5,6 +5,9 @@
  */
 import type { ModelConfig } from 'fss-link-core';
 import { type BackupMetadata } from './databaseBackup.js';
+import { type DatabaseMetrics, type HistoricalMetrics } from './databaseMetrics.js';
+import { type HealthCheckResult } from './databaseHealthMonitor.js';
+import { type SchemaValidationResult } from './databaseSchemaValidator.js';
 interface ExtendedModelConfig extends ModelConfig {
     source?: string;
 }
@@ -36,6 +39,9 @@ export declare class FSSLinkDatabase {
     private migrationManager;
     private backupManager;
     private queryOptimizer;
+    private metricsCollector;
+    private healthMonitor;
+    private schemaValidator;
     constructor();
     /**
      * Derive encryption key from machine-specific data
@@ -87,10 +93,12 @@ export declare class FSSLinkDatabase {
     private ensureDefaultConfigurations;
     /**
      * Get provider settings for a specific provider
+     * @todo UPGRADE: Move to ProviderSettingsRepository.findByProviderId()
      */
     getProviderSettings(providerId: number): Promise<Record<string, string>>;
     /**
      * Save a provider setting
+     * @todo UPGRADE: Move to ProviderSettingsRepository.upsert()
      */
     saveProviderSetting(providerId: number, key: string, value: string | number): Promise<void>;
     /**
@@ -103,6 +111,7 @@ export declare class FSSLinkDatabase {
     setActiveModel(id: number): Promise<void>;
     /**
      * Add or update a model configuration
+     * @todo UPGRADE: Move to ModelRepository.upsert()
      */
     upsertModelConfig(config: ExtendedModelConfig): Promise<number>;
     /**
@@ -115,6 +124,7 @@ export declare class FSSLinkDatabase {
     getFavoriteModels(): Promise<ExtendedModelConfig[]>;
     /**
      * Get recently used models
+     * @todo UPGRADE: Move to ModelRepository.findRecentlyUsed()
      */
     getRecentModels(limit?: number): Promise<ExtendedModelConfig[]>;
     /**
@@ -130,11 +140,13 @@ export declare class FSSLinkDatabase {
      */
     setUserPreference(key: string, value: string): Promise<void>;
     /**
-     * Get user preference
+     * Get user preference by key
+     * @todo UPGRADE: Move to PreferencesRepository.findByKey()
      */
     getUserPreference(key: string): Promise<string | null>;
     /**
      * Get all user preferences
+     * @todo UPGRADE: Move to PreferencesRepository.findAll()
      */
     getAllUserPreferences(): Promise<Record<string, string>>;
     /**
@@ -213,6 +225,7 @@ export declare class FSSLinkDatabase {
     saveCustomEndpoint(providerId: number, name: string, url: string, description?: string, isDefault?: boolean): Promise<number>;
     /**
      * Get custom endpoints for a provider
+     * @todo UPGRADE: Move to CustomEndpointsRepository.findByProviderId()
      */
     getCustomEndpoints(providerId: number): Promise<DatabaseCustomEndpointRecord[]>;
     /**
@@ -224,12 +237,195 @@ export declare class FSSLinkDatabase {
     } | null>;
     /**
      * Get smart default provider based on usage and preferences
+     * @todo UPGRADE: Move to ModelRepository.findSmartDefault()
      */
     getSmartDefaultProvider(): Promise<ModelConfig | null>;
     /**
      * Get a specific model configuration by ID
+     * @todo UPGRADE: Move to ModelRepository.findById()
      */
     getModelById(modelId: number): Promise<ModelConfig | null>;
+    /**
+     * Get query performance metrics from the optimizer
+     */
+    getQueryMetrics(): Promise<Array<{
+        query: string;
+        executionCount: number;
+        totalTime: number;
+        averageTime: number;
+        minTime: number;
+        maxTime: number;
+        lastExecuted: Date;
+    }>>;
+    /**
+     * Get slow queries (above threshold)
+     */
+    getSlowQueries(thresholdMs?: number): Promise<Array<{
+        query: string;
+        executionCount: number;
+        totalTime: number;
+        averageTime: number;
+        minTime: number;
+        maxTime: number;
+        lastExecuted: Date;
+    }>>;
+    /**
+     * Get most frequently executed queries
+     */
+    getFrequentQueries(limit?: number): Promise<Array<{
+        query: string;
+        executionCount: number;
+        totalTime: number;
+        averageTime: number;
+        minTime: number;
+        maxTime: number;
+        lastExecuted: Date;
+    }>>;
+    /**
+     * Get prepared statement cache statistics
+     */
+    getCacheStats(): Promise<{
+        size: number;
+        maxSize: number;
+        hitRate: number;
+        entries: Array<{
+            query: string;
+            usageCount: number;
+            lastUsed: Date;
+        }>;
+    }>;
+    /**
+     * Clear query performance metrics
+     */
+    clearQueryMetrics(): Promise<void>;
+    /**
+     * Optimize database by running ANALYZE
+     */
+    optimizeDatabase(): Promise<void>;
+    /**
+     * Get comprehensive database statistics
+     */
+    getDatabaseStats(): Promise<{
+        pageCount: number;
+        pageSize: number;
+        freelistCount: number;
+        schemaVersion: number;
+        userVersion: number;
+        tables: Array<{
+            name: string;
+            rowCount: number;
+        }>;
+    }>;
+    /**
+     * Run VACUUM to reclaim space and defragment
+     */
+    vacuumDatabase(): Promise<void>;
+    /**
+     * Collect comprehensive database metrics
+     */
+    collectMetrics(): Promise<DatabaseMetrics>;
+    /**
+     * Get historical metrics for trend analysis
+     */
+    getHistoricalMetrics(hours?: number): Promise<HistoricalMetrics[]>;
+    /**
+     * Get performance trends
+     */
+    getPerformanceTrends(hours?: number): Promise<{
+        queryTimeTraend: number;
+        cacheHitTrend: number;
+        overallHealthTrend: number;
+    }>;
+    /**
+     * Generate a comprehensive database health report
+     */
+    generateHealthReport(): Promise<{
+        metrics: DatabaseMetrics;
+        trends: {
+            queryTimeTraend: number;
+            cacheHitTrend: number;
+            overallHealthTrend: number;
+        };
+        recommendations: string[];
+    }>;
+    /**
+     * Set custom metrics thresholds
+     */
+    setMetricsThresholds(thresholds: {
+        slowQueryThreshold?: number;
+        cacheHitRateThreshold?: number;
+        connectionUtilizationThreshold?: number;
+        diskUsageWarning?: number;
+        backupAgeWarning?: number;
+    }): Promise<void>;
+    /**
+     * Clear metrics history (for testing or cleanup)
+     */
+    clearMetricsHistory(): Promise<void>;
+    /**
+     * Perform comprehensive health check
+     */
+    performHealthCheck(): Promise<HealthCheckResult[]>;
+    /**
+     * Get maintenance recommendations
+     */
+    getMaintenanceRecommendations(): Promise<string[]>;
+    /**
+     * Get recent health check history
+     */
+    getHealthHistory(hours?: number): Promise<HealthCheckResult[]>;
+    /**
+     * Update health monitoring thresholds
+     */
+    updateHealthThresholds(thresholds: {
+        queryTimeMs?: number;
+        cacheHitRate?: number;
+        connectionUtilization?: number;
+        healthScore?: number;
+        diskUsageMB?: number;
+        backupAgeHours?: number;
+    }): Promise<void>;
+    /**
+     * Clear health monitoring history
+     */
+    clearHealthHistory(): Promise<void>;
+    /**
+     * Validate database schema against expected structure
+     */
+    validateSchema(): Promise<SchemaValidationResult>;
+    /**
+     * Validate specific table schema
+     */
+    validateTableSchema(tableName: string): Promise<{
+        isValid: boolean;
+        errors: any[];
+        warnings: any[];
+    }>;
+    /**
+     * Check if database needs migration based on schema validation
+     */
+    needsSchemaMigration(): Promise<boolean>;
+    /**
+     * Get missing tables from schema
+     */
+    getMissingTables(): Promise<string[]>;
+    /**
+     * Get missing indexes from schema
+     */
+    getMissingIndexes(): Promise<string[]>;
+    /**
+     * Get formatted schema validation report
+     */
+    getSchemaValidationReport(): Promise<string>;
+    /**
+     * Perform comprehensive database integrity check
+     */
+    performIntegrityCheck(): Promise<{
+        schemaValidation: SchemaValidationResult;
+        healthCheck: HealthCheckResult[];
+        recommendations: string[];
+        overallStatus: 'healthy' | 'warning' | 'critical';
+    }>;
 }
 /**
  * Get the global FSS Link database instance