fss-link 1.2.4 → 1.2.6

package/dist/src/config/databasePool.js

@@ -0,0 +1,226 @@
+/**
+ * @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;
+    initializationPromise = null;
+    pendingRequests = [];
+    constructor(dbPath, maxConnections = 5) {
+        this.dbPath = dbPath;
+        this.maxConnections = maxConnections;
+    }
+    /**
+     * Initialize the connection pool
+     * Thread-safe initialization - prevents concurrent initialization
+     */
+    async initialize() {
+        // Return existing promise if initialization is in progress
+        if (this.initializationPromise) {
+            return await this.initializationPromise;
+        }
+        // Return immediately if already initialized
+        if (this.initialized)
+            return;
+        // Start initialization and cache the promise
+        this.initializationPromise = (async () => {
+            try {
+                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;
+            }
+            catch (error) {
+                console.warn('Database pool initialization failed:', error);
+                // Clear the promise on failure so initialization can be retried
+                this.initializationPromise = null;
+                throw error;
+            }
+            finally {
+                // Clear promise cache on completion (success or failure)
+                this.initializationPromise = null;
+            }
+        })();
+        return await this.initializationPromise;
+    }
+    /**
+     * Create a new database connection
+     */
+    async createConnection() {
+        let db;
+        try {
+            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;
+        }
+        catch (error) {
+            console.warn('Database connection creation failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * 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();
+            // 🎯 ATOMIC WRITE: Write to temp file first, then move to prevent corruption
+            const tempPath = `${this.dbPath}.tmp`;
+            fs.writeFileSync(tempPath, Buffer.from(data));
+            // Atomic move (on most filesystems)
+            fs.renameSync(tempPath, this.dbPath);
+        }
+        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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"}

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

@@ -0,0 +1,114 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Database } from 'sql.js';
+/**
+ * Schema validation result
+ */
+export interface SchemaValidationResult {
+    isValid: boolean;
+    errors: SchemaValidationError[];
+    warnings: SchemaValidationWarning[];
+    summary: {
+        totalTables: number;
+        totalIndexes: number;
+        missingTables: number;
+        missingIndexes: number;
+        extraTables: number;
+        extraIndexes: number;
+        schemaVersion: number;
+        expectedVersion: number;
+    };
+}
+/**
+ * Schema validation error
+ */
+export interface SchemaValidationError {
+    type: 'missing_table' | 'missing_column' | 'missing_index' | 'wrong_type' | 'constraint_violation' | 'version_mismatch';
+    table?: string;
+    column?: string;
+    index?: string;
+    expected: string;
+    actual: string;
+    severity: 'error' | 'warning';
+    message: string;
+    recommendation?: string;
+}
+/**
+ * Schema validation warning
+ */
+export interface SchemaValidationWarning {
+    type: 'extra_table' | 'extra_column' | 'extra_index' | 'deprecated_feature' | 'performance_issue';
+    table?: string;
+    column?: string;
+    index?: string;
+    message: string;
+    recommendation?: string;
+}
+/**
+ * Database Schema Validator
+ * Validates database schema against expected structure
+ */
+export declare class DatabaseSchemaValidator {
+    private expectedSchemas;
+    private expectedVersion;
+    constructor();
+    /**
+     * Initialize expected database schemas
+     */
+    private initializeExpectedSchemas;
+    /**
+     * Validate complete database schema
+     */
+    validateSchema(db: Database): Promise<SchemaValidationResult>;
+    /**
+     * Validate a specific table
+     */
+    private validateTable;
+    /**
+     * Get current schema version
+     */
+    private getCurrentSchemaVersion;
+    /**
+     * Get actual tables in database
+     */
+    private getActualTables;
+    /**
+     * Get actual indexes in database
+     */
+    private getActualIndexes;
+    /**
+     * Get table column information
+     */
+    private getTableInfo;
+    /**
+     * Check if column types are compatible
+     */
+    private isTypeCompatible;
+    /**
+     * Validate specific table by name
+     */
+    validateTableSchema(db: Database, tableName: string): Promise<{
+        isValid: boolean;
+        errors: SchemaValidationError[];
+        warnings: SchemaValidationWarning[];
+    }>;
+    /**
+     * Get schema validation report as formatted text
+     */
+    formatValidationReport(result: SchemaValidationResult): string;
+    /**
+     * Check if database needs migration
+     */
+    needsMigration(db: Database): Promise<boolean>;
+    /**
+     * Get missing tables
+     */
+    getMissingTables(db: Database): Promise<string[]>;
+    /**
+     * Get missing indexes
+     */
+    getMissingIndexes(db: Database): Promise<string[]>;
+}