fss-link 1.0.49 → 1.0.51

package/dist/src/config/databaseMigrations.js

@@ -0,0 +1,379 @@
+/**
+ * @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)
+          )
+        `);
+                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
+          )
+        `);
+            },
+            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');
+            }
+        });
+    }
+    /**
+     * 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, assume version 1
+                    return 1;
+                }
+                // 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,70 @@
+/**
+ * @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 pendingRequests;
+    constructor(dbPath: string, maxConnections?: number);
+    /**
+     * Initialize the connection pool
+     */
+    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>;

package/dist/src/config/databasePool.js

@@ -0,0 +1,193 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import initSqlJs from 'sql.js';
+import * as fs from 'fs';
+/**
+ * Database Connection Pool for SQLite
+ * Manages multiple database connections for better concurrency
+ */
+export class DatabaseConnectionPool {
+    connections = [];
+    availableConnections = [];
+    maxConnections;
+    dbPath;
+    SQL;
+    initialized = false;
+    pendingRequests = [];
+    constructor(dbPath, maxConnections = 5) {
+        this.dbPath = dbPath;
+        this.maxConnections = maxConnections;
+    }
+    /**
+     * Initialize the connection pool
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        this.SQL = await initSqlJs();
+        // Create initial connection pool
+        for (let i = 0; i < Math.min(2, this.maxConnections); i++) {
+            const connection = await this.createConnection();
+            this.connections.push(connection);
+            this.availableConnections.push(connection);
+        }
+        this.initialized = true;
+    }
+    /**
+     * Create a new database connection
+     */
+    async createConnection() {
+        let db;
+        if (fs.existsSync(this.dbPath)) {
+            const data = fs.readFileSync(this.dbPath);
+            db = new this.SQL.Database(data);
+        }
+        else {
+            db = new this.SQL.Database();
+        }
+        // Enable WAL mode for better concurrency
+        db.exec('PRAGMA journal_mode=WAL;');
+        // Set reasonable timeout for busy connections
+        db.exec('PRAGMA busy_timeout=5000;');
+        // Enable foreign key constraints
+        db.exec('PRAGMA foreign_keys=ON;');
+        return db;
+    }
+    /**
+     * Get a connection from the pool
+     */
+    async getConnection() {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        // If we have available connections, return one immediately
+        if (this.availableConnections.length > 0) {
+            return this.availableConnections.pop();
+        }
+        // If we can create more connections, create one
+        if (this.connections.length < this.maxConnections) {
+            const connection = await this.createConnection();
+            this.connections.push(connection);
+            return connection;
+        }
+        // Otherwise, wait for a connection to become available
+        return new Promise((resolve) => {
+            this.pendingRequests.push(resolve);
+        });
+    }
+    /**
+     * Release a connection back to the pool
+     */
+    releaseConnection(connection) {
+        // If there are pending requests, satisfy them first
+        if (this.pendingRequests.length > 0) {
+            const request = this.pendingRequests.shift();
+            request(connection);
+            return;
+        }
+        // Otherwise, return to available pool
+        if (!this.availableConnections.includes(connection)) {
+            this.availableConnections.push(connection);
+        }
+    }
+    /**
+     * Execute a function with a pooled connection
+     */
+    async withConnection(fn) {
+        const connection = await this.getConnection();
+        try {
+            return await fn(connection);
+        }
+        finally {
+            this.releaseConnection(connection);
+        }
+    }
+    /**
+     * Execute a function within a transaction
+     */
+    async withTransaction(fn) {
+        return this.withConnection(async (db) => {
+            db.exec('BEGIN TRANSACTION;');
+            try {
+                const result = await fn(db);
+                db.exec('COMMIT;');
+                return result;
+            }
+            catch (error) {
+                db.exec('ROLLBACK;');
+                throw error;
+            }
+        });
+    }
+    /**
+     * Sync all connections to disk
+     */
+    async syncToDisk() {
+        if (!this.initialized || this.connections.length === 0)
+            return;
+        // Use the first connection to save to disk
+        const connection = await this.getConnection();
+        try {
+            const data = connection.export();
+            fs.writeFileSync(this.dbPath, Buffer.from(data));
+        }
+        finally {
+            this.releaseConnection(connection);
+        }
+    }
+    /**
+     * Close all connections
+     */
+    async close() {
+        // Sync to disk before closing
+        await this.syncToDisk();
+        // Close all connections
+        for (const connection of this.connections) {
+            connection.close();
+        }
+        this.connections = [];
+        this.availableConnections = [];
+        this.initialized = false;
+    }
+    /**
+     * Get pool statistics
+     */
+    getStats() {
+        return {
+            totalConnections: this.connections.length,
+            availableConnections: this.availableConnections.length,
+            activeConnections: this.connections.length - this.availableConnections.length,
+            pendingRequests: this.pendingRequests.length,
+            maxConnections: this.maxConnections
+        };
+    }
+}
+/**
+ * Singleton connection pool instance
+ */
+let globalPool = null;
+/**
+ * Get the global database connection pool
+ */
+export function getDatabasePool(dbPath) {
+    if (!globalPool && dbPath) {
+        globalPool = new DatabaseConnectionPool(dbPath);
+    }
+    if (!globalPool) {
+        throw new Error('Database pool not initialized. Call with dbPath first.');
+    }
+    return globalPool;
+}
+/**
+ * Close the global database pool
+ */
+export async function closeDatabasePool() {
+    if (globalPool) {
+        await globalPool.close();
+        globalPool = null;
+    }
+}
+//# sourceMappingURL=databasePool.js.map

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

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