fss-link 1.2.5 → 1.2.6

package/dist/src/config/databaseMigrations.js

@@ -0,0 +1,405 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * DATABASE MIGRATIONS
+ *
+ * Migration 1: Complete database schema - all tables, indexes, and health tracking
+ *
+ * CONSOLIDATED from original migrations:
+ * - Original Migration 1: Core tables (model_configs, user_preferences, custom_endpoints, provider_settings, provider_usage_stats)
+ * - Original Migration 3: Performance indexes (favorite, recent, provider settings, usage stats)
+ * - Original Migration 4: Health monitoring (schema_info table + metadata)
+ * - Original Migration 2: EXCLUDED (broken unique constraint)
+ * - Original Migration 5: EXCLUDED (redundant source column)
+ * - Original Migration 6: EXCLUDED (SQLite.js-incompatible COALESCE)
+ *
+ * Migration Manager for FSS Link Database
+ * Handles schema versioning and safe upgrades
+ */
+export class MigrationManager {
+    migrations = [];
+    constructor() {
+        this.registerMigrations();
+    }
+    /**
+     * Register all available migrations
+     */
+    registerMigrations() {
+        // Migration 1: Complete database schema - tables, indexes, and health tracking
+        this.migrations.push({
+            version: 1,
+            name: 'complete_schema',
+            up: (db) => {
+                // === CORE TABLES ===
+                // Model configurations table
+                db.exec(`
+          CREATE TABLE IF NOT EXISTS model_configs (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            auth_type TEXT NOT NULL,
+            model_name TEXT NOT NULL,
+            endpoint_url TEXT,
+            api_key TEXT,
+            display_name TEXT,
+            is_favorite BOOLEAN DEFAULT 0,
+            is_active BOOLEAN DEFAULT 0,
+            last_used DATETIME,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            source TEXT DEFAULT 'db',
+            endpoint_id INTEGER,
+            UNIQUE(auth_type, model_name, endpoint_url)
+          )
+        `);
+                // User preferences table
+                db.exec(`
+          CREATE TABLE IF NOT EXISTS user_preferences (
+            key TEXT PRIMARY KEY,
+            value TEXT NOT NULL,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+          )
+        `);
+                // Custom endpoints table
+                db.exec(`
+          CREATE TABLE IF NOT EXISTS custom_endpoints (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            provider_id INTEGER,
+            name TEXT NOT NULL,
+            url TEXT NOT NULL,
+            description TEXT,
+            is_default BOOLEAN DEFAULT 0,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+          )
+        `);
+                // Provider settings table
+                db.exec(`
+          CREATE TABLE IF NOT EXISTS provider_settings (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            provider_id INTEGER NOT NULL,
+            setting_key TEXT NOT NULL,
+            setting_value TEXT NOT NULL,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            UNIQUE(provider_id, setting_key)
+          )
+        `);
+                // Provider usage statistics table
+                console.log('Creating provider_usage_stats table...');
+                db.exec(`
+          CREATE TABLE IF NOT EXISTS provider_usage_stats (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            provider_id INTEGER NOT NULL,
+            tokens_used INTEGER DEFAULT 0,
+            session_duration_seconds INTEGER DEFAULT 0,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+          )
+        `);
+                console.log('provider_usage_stats table created successfully');
+                // Schema information table for health monitoring
+                db.exec(`
+          CREATE TABLE IF NOT EXISTS schema_info (
+            key TEXT PRIMARY KEY,
+            value TEXT NOT NULL,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+          )
+        `);
+                // === PERFORMANCE INDEXES ===
+                // Index for favorite models lookup
+                db.exec(`
+          CREATE INDEX IF NOT EXISTS idx_model_configs_favorite 
+          ON model_configs(is_favorite, last_used DESC) 
+          WHERE is_favorite = 1
+        `);
+                // Index for recent models lookup
+                db.exec(`
+          CREATE INDEX IF NOT EXISTS idx_model_configs_recent 
+          ON model_configs(last_used DESC) 
+          WHERE last_used IS NOT NULL
+        `);
+                // Index for provider settings lookup
+                db.exec(`
+          CREATE INDEX IF NOT EXISTS idx_provider_settings_lookup 
+          ON provider_settings(provider_id, setting_key)
+        `);
+                // Index for usage stats aggregation
+                db.exec(`
+          CREATE INDEX IF NOT EXISTS idx_provider_usage_stats_aggregation
+          ON provider_usage_stats(provider_id, created_at DESC)
+        `);
+                // Index for model endpoint lookups
+                db.exec(`
+          CREATE INDEX IF NOT EXISTS idx_model_configs_endpoint
+          ON model_configs(endpoint_id)
+          WHERE endpoint_id IS NOT NULL
+        `);
+                // Index for custom endpoint URL lookups
+                db.exec(`
+          CREATE INDEX IF NOT EXISTS idx_custom_endpoints_url
+          ON custom_endpoints(url)
+        `);
+                // === HEALTH TRACKING INITIALIZATION ===
+                // Store initial health metrics
+                const now = new Date().toISOString();
+                db.exec(`
+          INSERT OR REPLACE INTO schema_info (key, value, updated_at) 
+          VALUES 
+            ('schema_version', '1', '${now}'),
+            ('last_migration', 'complete_schema', '${now}'),
+            ('total_migrations', '1', '${now}')
+        `);
+                console.log('Complete database schema created successfully');
+            },
+            down: (db) => {
+                // Drop indexes first
+                db.exec('DROP INDEX IF EXISTS idx_provider_usage_stats_aggregation');
+                db.exec('DROP INDEX IF EXISTS idx_provider_settings_lookup');
+                db.exec('DROP INDEX IF EXISTS idx_model_configs_recent');
+                db.exec('DROP INDEX IF EXISTS idx_model_configs_favorite');
+                // Normalize existing endpoint URLs (bug fix for UNIQUE constraint)
+                // Convert empty string and whitespace-only endpoints to NULL
+                // This ensures UNIQUE(auth_type, model_name, endpoint_url) works correctly
+                db.exec(`
+          UPDATE model_configs
+          SET endpoint_url = NULL
+          WHERE endpoint_url = '' OR TRIM(endpoint_url) = ''
+        `);
+                // Drop tables
+                db.exec('DROP TABLE IF EXISTS schema_info');
+                db.exec('DROP TABLE IF EXISTS provider_usage_stats');
+                db.exec('DROP TABLE IF EXISTS provider_settings');
+                db.exec('DROP TABLE IF EXISTS custom_endpoints');
+                db.exec('DROP TABLE IF EXISTS user_preferences');
+                db.exec('DROP TABLE IF EXISTS model_configs');
+            }
+        });
+    }
+    /**
+     * Get current schema version from database
+     */
+    getCurrentVersion(db) {
+        try {
+            // Check if schema_info table exists
+            const result = db.exec(`
+        SELECT name FROM sqlite_master 
+        WHERE type='table' AND name='schema_info'
+      `);
+            if (result.length === 0) {
+                // No schema_info table means we need to check for legacy tables
+                const modelConfigsResult = db.exec(`
+          SELECT name FROM sqlite_master 
+          WHERE type='table' AND name='model_configs'
+        `);
+                if (modelConfigsResult.length > 0) {
+                    // Legacy database exists, but we need to check if it has migration 1 tables
+                    const providerUsageStatsResult = db.exec(`
+            SELECT name FROM sqlite_master 
+            WHERE type='table' AND name='provider_usage_stats'
+          `);
+                    if (providerUsageStatsResult.length > 0) {
+                        // Has migration 1 tables, assume version 1
+                        return 1;
+                    }
+                    else {
+                        // Legacy database without migration 1 tables, needs full migration
+                        return 0;
+                    }
+                }
+                // Fresh database
+                return 0;
+            }
+            // Get version from schema_info
+            const versionResult = db.exec(`
+        SELECT value FROM schema_info WHERE key = 'schema_version'
+      `);
+            if (versionResult.length > 0 && versionResult[0].values.length > 0) {
+                return parseInt(versionResult[0].values[0][0], 10);
+            }
+            return 1; // Default to version 1 if schema_info exists but no version
+        }
+        catch (error) {
+            console.warn('Failed to get schema version:', error);
+            return 0;
+        }
+    }
+    /**
+     * Get latest migration version
+     */
+    getLatestVersion() {
+        return Math.max(...this.migrations.map(m => m.version));
+    }
+    /**
+     * Check if migrations are needed
+     */
+    needsMigration(db) {
+        const currentVersion = this.getCurrentVersion(db);
+        const latestVersion = this.getLatestVersion();
+        return currentVersion < latestVersion;
+    }
+    /**
+     * Run all pending migrations
+     */
+    async migrate(db) {
+        const currentVersion = this.getCurrentVersion(db);
+        const latestVersion = this.getLatestVersion();
+        if (currentVersion >= latestVersion) {
+            if (process.env['FSS_DEBUG'] === 'true') {
+                console.log(`Database is up to date (version ${currentVersion})`);
+            }
+            return;
+        }
+        console.log(`Migrating database from version ${currentVersion} to ${latestVersion}`);
+        // Sort migrations by version
+        const sortedMigrations = this.migrations.sort((a, b) => a.version - b.version);
+        // Run pending migrations in transaction
+        db.exec('BEGIN TRANSACTION');
+        try {
+            for (const migration of sortedMigrations) {
+                if (migration.version > currentVersion) {
+                    console.log(`Running migration ${migration.version}: ${migration.name}`);
+                    migration.up(db);
+                    // Update schema version
+                    this.updateSchemaVersion(db, migration.version, migration.name);
+                }
+            }
+            db.exec('COMMIT');
+            console.log(`Database migration completed successfully`);
+        }
+        catch (error) {
+            db.exec('ROLLBACK');
+            console.error('Database migration failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * Rollback to a specific version
+     */
+    async rollback(db, targetVersion) {
+        const currentVersion = this.getCurrentVersion(db);
+        if (targetVersion >= currentVersion) {
+            console.log(`Already at or below target version ${targetVersion}`);
+            return;
+        }
+        console.log(`Rolling back database from version ${currentVersion} to ${targetVersion}`);
+        // Sort migrations by version (descending for rollback)
+        const sortedMigrations = this.migrations.sort((a, b) => b.version - a.version);
+        // Run rollback migrations in transaction
+        db.exec('BEGIN TRANSACTION');
+        try {
+            for (const migration of sortedMigrations) {
+                if (migration.version > targetVersion && migration.version <= currentVersion) {
+                    console.log(`Rolling back migration ${migration.version}: ${migration.name}`);
+                    migration.down(db);
+                }
+            }
+            // Update schema version
+            this.updateSchemaVersion(db, targetVersion, 'rollback');
+            db.exec('COMMIT');
+            console.log(`Database rollback completed successfully`);
+        }
+        catch (error) {
+            db.exec('ROLLBACK');
+            console.error('Database rollback failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * Update schema version in database
+     */
+    updateSchemaVersion(db, version, migrationName) {
+        const now = new Date().toISOString();
+        // Ensure schema_info table exists
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS schema_info (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      )
+    `);
+        // Update version info
+        db.exec(`
+      INSERT OR REPLACE INTO schema_info (key, value, updated_at) 
+      VALUES 
+        ('schema_version', '${version}', '${now}'),
+        ('last_migration', '${migrationName}', '${now}')
+    `);
+    }
+    /**
+     * Get migration history
+     */
+    getMigrationHistory(db) {
+        try {
+            const result = db.exec(`
+        SELECT key, value, updated_at FROM schema_info 
+        WHERE key IN ('schema_version', 'last_migration')
+        ORDER BY updated_at DESC
+      `);
+            if (result.length === 0)
+                return [];
+            const history = [];
+            // This is a simplified version - in a real system you'd track each migration
+            const currentVersion = this.getCurrentVersion(db);
+            const appliedMigrations = this.migrations
+                .filter(m => m.version <= currentVersion)
+                .sort((a, b) => a.version - b.version);
+            for (const migration of appliedMigrations) {
+                history.push({
+                    version: migration.version,
+                    name: migration.name,
+                    date: new Date().toISOString() // Placeholder - real system would track actual dates
+                });
+            }
+            return history;
+        }
+        catch (error) {
+            console.warn('Failed to get migration history:', error);
+            return [];
+        }
+    }
+    /**
+     * Validate database schema integrity
+     */
+    validateSchema(db) {
+        try {
+            // Check that all expected tables exist
+            const requiredTables = [
+                'model_configs',
+                'user_preferences',
+                'custom_endpoints',
+                'provider_settings',
+                'provider_usage_stats',
+                'schema_info'
+            ];
+            for (const table of requiredTables) {
+                const result = db.exec(`
+          SELECT name FROM sqlite_master 
+          WHERE type='table' AND name='${table}'
+        `);
+                if (result.length === 0) {
+                    console.error(`Required table '${table}' is missing`);
+                    return false;
+                }
+            }
+            // Check critical indexes
+            const requiredIndexes = [
+                'idx_model_configs_active_unique',
+                'idx_model_configs_favorite',
+                'idx_model_configs_recent'
+            ];
+            for (const index of requiredIndexes) {
+                const result = db.exec(`
+          SELECT name FROM sqlite_master 
+          WHERE type='index' AND name='${index}'
+        `);
+                if (result.length === 0) {
+                    console.warn(`Recommended index '${index}' is missing`);
+                }
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('Schema validation failed:', error);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=databaseMigrations.js.map

package/dist/src/config/databaseMigrations.js.map

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

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

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Database } from 'sql.js';
+/**
+ * Database Connection Pool for SQLite
+ * Manages multiple database connections for better concurrency
+ */
+export declare class DatabaseConnectionPool {
+    private connections;
+    private availableConnections;
+    private readonly maxConnections;
+    private readonly dbPath;
+    private SQL;
+    private initialized;
+    private initializationPromise;
+    private pendingRequests;
+    constructor(dbPath: string, maxConnections?: number);
+    /**
+     * Initialize the connection pool
+     * Thread-safe initialization - prevents concurrent initialization
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create a new database connection
+     */
+    private createConnection;
+    /**
+     * Get a connection from the pool
+     */
+    getConnection(): Promise<Database>;
+    /**
+     * Release a connection back to the pool
+     */
+    releaseConnection(connection: Database): void;
+    /**
+     * Execute a function with a pooled connection
+     */
+    withConnection<T>(fn: (db: Database) => Promise<T> | T): Promise<T>;
+    /**
+     * Execute a function within a transaction
+     */
+    withTransaction<T>(fn: (db: Database) => Promise<T> | T): Promise<T>;
+    /**
+     * Sync all connections to disk
+     */
+    syncToDisk(): Promise<void>;
+    /**
+     * Close all connections
+     */
+    close(): Promise<void>;
+    /**
+     * Get pool statistics
+     */
+    getStats(): {
+        totalConnections: number;
+        availableConnections: number;
+        activeConnections: number;
+        pendingRequests: number;
+        maxConnections: number;
+    };
+}
+/**
+ * Get the global database connection pool
+ */
+export declare function getDatabasePool(dbPath?: string): DatabaseConnectionPool;
+/**
+ * Close the global database pool
+ */
+export declare function closeDatabasePool(): Promise<void>;