fss-link 1.0.82 → 1.0.83

package/dist/src/config/databaseMigrations.js

@@ -0,0 +1,417 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * 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: Initial schema (v1.0.0)
+        this.migrations.push({
+            version: 1,
+            name: 'initial_schema',
+            up: (db) => {
+                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',
+            UNIQUE(auth_type, model_name, endpoint_url)
+          )
+        `);
+                db.exec(`
+          CREATE TABLE IF NOT EXISTS user_preferences (
+            key TEXT PRIMARY KEY,
+            value TEXT NOT NULL,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+          )
+        `);
+                db.exec(`
+          CREATE TABLE IF NOT EXISTS custom_endpoints (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            provider_id INTEGER NOT NULL,
+            name TEXT NOT NULL,
+            url TEXT NOT NULL,
+            description TEXT,
+            is_default BOOLEAN DEFAULT 0,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+          )
+        `);
+                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)
+          )
+        `);
+                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');
+            },
+            down: (db) => {
+                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');
+            }
+        });
+        // Migration 2: Add unique active model constraint (v1.0.43)
+        this.migrations.push({
+            version: 2,
+            name: 'unique_active_constraint',
+            up: (db) => {
+                db.exec(`
+          CREATE UNIQUE INDEX IF NOT EXISTS idx_model_configs_active_unique 
+          ON model_configs(auth_type) 
+          WHERE is_active = 1
+        `);
+            },
+            down: (db) => {
+                db.exec('DROP INDEX IF EXISTS idx_model_configs_active_unique');
+            }
+        });
+        // Migration 3: Add performance indexes (current)
+        this.migrations.push({
+            version: 3,
+            name: 'performance_indexes',
+            up: (db) => {
+                // 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)
+        `);
+            },
+            down: (db) => {
+                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');
+            }
+        });
+        // Migration 4: Add database health monitoring
+        this.migrations.push({
+            version: 4,
+            name: 'health_monitoring',
+            up: (db) => {
+                db.exec(`
+          CREATE TABLE IF NOT EXISTS schema_info (
+            key TEXT PRIMARY KEY,
+            value TEXT NOT NULL,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+          )
+        `);
+                // Store initial health metrics
+                const now = new Date().toISOString();
+                db.exec(`
+          INSERT OR REPLACE INTO schema_info (key, value, updated_at) 
+          VALUES 
+            ('schema_version', '4', '${now}'),
+            ('last_migration', 'health_monitoring', '${now}'),
+            ('total_migrations', '4', '${now}')
+        `);
+            },
+            down: (db) => {
+                db.exec('DROP TABLE IF EXISTS schema_info');
+            }
+        });
+        // Migration 5: Add missing source column to model_configs
+        this.migrations.push({
+            version: 5,
+            name: 'add_source_column',
+            up: (db) => {
+                // Check if source column already exists
+                const tableInfo = db.exec(`PRAGMA table_info(model_configs)`);
+                const hasSourceColumn = tableInfo.some(result => result.values && result.values.some(row => row[1] === 'source'));
+                if (!hasSourceColumn) {
+                    console.log('Adding missing source column to model_configs table...');
+                    db.exec(`
+            ALTER TABLE model_configs 
+            ADD COLUMN source TEXT DEFAULT 'db'
+          `);
+                    console.log('Source column added successfully');
+                }
+                else {
+                    console.log('Source column already exists, skipping');
+                }
+            },
+            down: (db) => {
+                // SQLite doesn't support DROP COLUMN easily, so we leave it
+                console.log('Rollback: Source column left in place (SQLite limitation)');
+            }
+        });
+    }
+    /**
+     * 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) {
+            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>;