fss-link 1.0.49 → 1.0.51

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

@@ -0,0 +1,114 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Database } from 'sql.js';
+/**
+ * Backup metadata interface
+ */
+export interface BackupMetadata {
+    id: string;
+    filename: string;
+    timestamp: string;
+    schemaVersion: number;
+    checksum: string;
+    size: number;
+    description?: string;
+    auto: boolean;
+}
+/**
+ * Backup verification result
+ */
+export interface BackupVerification {
+    valid: boolean;
+    checksumMatch: boolean;
+    readable: boolean;
+    schemaVersion?: number;
+    error?: string;
+}
+/**
+ * Database Backup and Recovery Manager
+ * Handles automated backups, manual backups, and recovery operations
+ */
+export declare class DatabaseBackupManager {
+    private backupDir;
+    private maxAutoBackups;
+    private maxManualBackups;
+    constructor();
+    /**
+     * Ensure backup directory exists
+     */
+    private ensureBackupDirectory;
+    /**
+     * Create a backup of the database
+     */
+    createBackup(db: Database, description?: string, auto?: boolean): Promise<BackupMetadata>;
+    /**
+     * Create an automatic backup (triggered by system events)
+     */
+    createAutoBackup(db: Database): Promise<BackupMetadata>;
+    /**
+     * Create a manual backup with description
+     */
+    createManualBackup(db: Database, description: string): Promise<BackupMetadata>;
+    /**
+     * List all available backups
+     */
+    listBackups(): Promise<BackupMetadata[]>;
+    /**
+     * Get backup by ID
+     */
+    getBackup(backupId: string): Promise<BackupMetadata | null>;
+    /**
+     * Verify backup integrity
+     */
+    verifyBackup(backupId: string): Promise<BackupVerification>;
+    /**
+     * Restore database from backup
+     */
+    restoreFromBackup(backupId: string, targetPath: string): Promise<void>;
+    /**
+     * Delete a backup
+     */
+    deleteBackup(backupId: string): Promise<void>;
+    /**
+     * Get backup statistics
+     */
+    getBackupStats(): Promise<{
+        totalBackups: number;
+        autoBackups: number;
+        manualBackups: number;
+        totalSize: number;
+        oldestBackup?: string;
+        newestBackup?: string;
+    }>;
+    /**
+     * Clean up old automatic backups
+     */
+    private cleanupAutoBackups;
+    /**
+     * Clean up old manual backups (more conservative)
+     */
+    private cleanupManualBackups;
+    /**
+     * Save backup metadata to file
+     */
+    private saveBackupMetadata;
+    /**
+     * Save all backup metadata to file
+     */
+    private saveAllBackupMetadata;
+    /**
+     * Get schema version from database
+     */
+    private getSchemaVersionFromDb;
+    /**
+     * Set backup retention limits
+     */
+    setRetentionLimits(maxAutoBackups: number, maxManualBackups: number): void;
+    /**
+     * Get backup directory path
+     */
+    getBackupDirectory(): string;
+}

package/dist/src/config/databaseBackup.js

@@ -0,0 +1,334 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { USER_SETTINGS_DIR } from './settings.js';
+/**
+ * Database Backup and Recovery Manager
+ * Handles automated backups, manual backups, and recovery operations
+ */
+export class DatabaseBackupManager {
+    backupDir;
+    maxAutoBackups = 10;
+    maxManualBackups = 50;
+    constructor() {
+        this.backupDir = path.join(USER_SETTINGS_DIR, 'backups');
+        this.ensureBackupDirectory();
+    }
+    /**
+     * Ensure backup directory exists
+     */
+    ensureBackupDirectory() {
+        if (!fs.existsSync(this.backupDir)) {
+            fs.mkdirSync(this.backupDir, { recursive: true });
+        }
+    }
+    /**
+     * Create a backup of the database
+     */
+    async createBackup(db, description, auto = false) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const backupId = crypto.randomBytes(8).toString('hex');
+        const filename = auto
+            ? `auto-backup-${timestamp}-${backupId}.db`
+            : `manual-backup-${timestamp}-${backupId}.db`;
+        const backupPath = path.join(this.backupDir, filename);
+        try {
+            // Export database to binary data
+            const data = db.export();
+            const buffer = Buffer.from(data);
+            // Calculate checksum
+            const checksum = crypto.createHash('sha256').update(buffer).digest('hex');
+            // Write backup file
+            fs.writeFileSync(backupPath, buffer);
+            // Get schema version from database
+            const schemaVersion = this.getSchemaVersionFromDb(db);
+            // Create metadata
+            const metadata = {
+                id: backupId,
+                filename,
+                timestamp: new Date().toISOString(),
+                schemaVersion,
+                checksum,
+                size: buffer.length,
+                description,
+                auto
+            };
+            // Save metadata
+            await this.saveBackupMetadata(metadata);
+            // Cleanup old backups if necessary
+            if (auto) {
+                await this.cleanupAutoBackups();
+            }
+            else {
+                await this.cleanupManualBackups();
+            }
+            return metadata;
+        }
+        catch (error) {
+            // Clean up failed backup file if it exists
+            if (fs.existsSync(backupPath)) {
+                fs.unlinkSync(backupPath);
+            }
+            throw new Error(`Failed to create backup: ${error}`);
+        }
+    }
+    /**
+     * Create an automatic backup (triggered by system events)
+     */
+    async createAutoBackup(db) {
+        return this.createBackup(db, 'Automatic backup', true);
+    }
+    /**
+     * Create a manual backup with description
+     */
+    async createManualBackup(db, description) {
+        return this.createBackup(db, description, false);
+    }
+    /**
+     * List all available backups
+     */
+    async listBackups() {
+        const metadataFile = path.join(this.backupDir, 'backup-metadata.json');
+        if (!fs.existsSync(metadataFile)) {
+            return [];
+        }
+        try {
+            const content = fs.readFileSync(metadataFile, 'utf-8');
+            const metadata = JSON.parse(content);
+            // Sort by timestamp (newest first)
+            return metadata.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        }
+        catch (error) {
+            console.warn('Failed to load backup metadata:', error);
+            return [];
+        }
+    }
+    /**
+     * Get backup by ID
+     */
+    async getBackup(backupId) {
+        const backups = await this.listBackups();
+        return backups.find(b => b.id === backupId) || null;
+    }
+    /**
+     * Verify backup integrity
+     */
+    async verifyBackup(backupId) {
+        const backup = await this.getBackup(backupId);
+        if (!backup) {
+            return {
+                valid: false,
+                checksumMatch: false,
+                readable: false,
+                error: 'Backup not found'
+            };
+        }
+        const backupPath = path.join(this.backupDir, backup.filename);
+        if (!fs.existsSync(backupPath)) {
+            return {
+                valid: false,
+                checksumMatch: false,
+                readable: false,
+                error: 'Backup file missing'
+            };
+        }
+        try {
+            // Read backup file
+            const buffer = fs.readFileSync(backupPath);
+            // Verify checksum
+            const checksum = crypto.createHash('sha256').update(buffer).digest('hex');
+            const checksumMatch = checksum === backup.checksum;
+            // Try to read as SQLite database
+            let readable = false;
+            let schemaVersion;
+            try {
+                const initSqlJs = (await import('sql.js')).default;
+                const SQL = await initSqlJs();
+                const db = new SQL.Database(buffer);
+                // Try to query schema version
+                schemaVersion = this.getSchemaVersionFromDb(db);
+                readable = true;
+                db.close();
+            }
+            catch {
+                readable = false;
+            }
+            return {
+                valid: checksumMatch && readable,
+                checksumMatch,
+                readable,
+                schemaVersion
+            };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                checksumMatch: false,
+                readable: false,
+                error: `Verification failed: ${error}`
+            };
+        }
+    }
+    /**
+     * Restore database from backup
+     */
+    async restoreFromBackup(backupId, targetPath) {
+        const backup = await this.getBackup(backupId);
+        if (!backup) {
+            throw new Error('Backup not found');
+        }
+        const backupPath = path.join(this.backupDir, backup.filename);
+        if (!fs.existsSync(backupPath)) {
+            throw new Error('Backup file missing');
+        }
+        // Verify backup before restore
+        const verification = await this.verifyBackup(backupId);
+        if (!verification.valid) {
+            throw new Error(`Backup verification failed: ${verification.error}`);
+        }
+        try {
+            // Create backup of current database if it exists
+            if (fs.existsSync(targetPath)) {
+                const backupCurrentPath = `${targetPath}.pre-restore-${Date.now()}.backup`;
+                fs.copyFileSync(targetPath, backupCurrentPath);
+                console.log(`Current database backed up to: ${backupCurrentPath}`);
+            }
+            // Copy backup to target location
+            fs.copyFileSync(backupPath, targetPath);
+            console.log(`Database restored from backup: ${backup.description || backup.filename}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to restore from backup: ${error}`);
+        }
+    }
+    /**
+     * Delete a backup
+     */
+    async deleteBackup(backupId) {
+        const backup = await this.getBackup(backupId);
+        if (!backup) {
+            throw new Error('Backup not found');
+        }
+        const backupPath = path.join(this.backupDir, backup.filename);
+        // Remove backup file
+        if (fs.existsSync(backupPath)) {
+            fs.unlinkSync(backupPath);
+        }
+        // Remove from metadata
+        const backups = await this.listBackups();
+        const updatedBackups = backups.filter(b => b.id !== backupId);
+        await this.saveAllBackupMetadata(updatedBackups);
+    }
+    /**
+     * Get backup statistics
+     */
+    async getBackupStats() {
+        const backups = await this.listBackups();
+        const autoBackups = backups.filter(b => b.auto).length;
+        const manualBackups = backups.filter(b => !b.auto).length;
+        const totalSize = backups.reduce((sum, b) => sum + b.size, 0);
+        const sortedByDate = backups.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+        return {
+            totalBackups: backups.length,
+            autoBackups,
+            manualBackups,
+            totalSize,
+            oldestBackup: sortedByDate[0]?.timestamp,
+            newestBackup: sortedByDate[sortedByDate.length - 1]?.timestamp
+        };
+    }
+    /**
+     * Clean up old automatic backups
+     */
+    async cleanupAutoBackups() {
+        const backups = await this.listBackups();
+        const autoBackups = backups
+            .filter(b => b.auto)
+            .sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        if (autoBackups.length > this.maxAutoBackups) {
+            const toDelete = autoBackups.slice(this.maxAutoBackups);
+            for (const backup of toDelete) {
+                try {
+                    await this.deleteBackup(backup.id);
+                    console.log(`Cleaned up old auto backup: ${backup.filename}`);
+                }
+                catch (error) {
+                    console.warn(`Failed to cleanup backup ${backup.id}:`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Clean up old manual backups (more conservative)
+     */
+    async cleanupManualBackups() {
+        const backups = await this.listBackups();
+        const manualBackups = backups
+            .filter(b => !b.auto)
+            .sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        if (manualBackups.length > this.maxManualBackups) {
+            const toDelete = manualBackups.slice(this.maxManualBackups);
+            for (const backup of toDelete) {
+                try {
+                    await this.deleteBackup(backup.id);
+                    console.log(`Cleaned up old manual backup: ${backup.filename}`);
+                }
+                catch (error) {
+                    console.warn(`Failed to cleanup backup ${backup.id}:`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Save backup metadata to file
+     */
+    async saveBackupMetadata(metadata) {
+        const backups = await this.listBackups();
+        backups.push(metadata);
+        await this.saveAllBackupMetadata(backups);
+    }
+    /**
+     * Save all backup metadata to file
+     */
+    async saveAllBackupMetadata(backups) {
+        const metadataFile = path.join(this.backupDir, 'backup-metadata.json');
+        const content = JSON.stringify(backups, null, 2);
+        fs.writeFileSync(metadataFile, content);
+    }
+    /**
+     * Get schema version from database
+     */
+    getSchemaVersionFromDb(db) {
+        try {
+            const result = db.exec(`
+        SELECT value FROM schema_info WHERE key = 'schema_version'
+      `);
+            if (result.length > 0 && result[0].values.length > 0) {
+                return parseInt(result[0].values[0][0], 10);
+            }
+            return 1; // Default version
+        }
+        catch {
+            return 1; // Default version if schema_info doesn't exist
+        }
+    }
+    /**
+     * Set backup retention limits
+     */
+    setRetentionLimits(maxAutoBackups, maxManualBackups) {
+        this.maxAutoBackups = maxAutoBackups;
+        this.maxManualBackups = maxManualBackups;
+    }
+    /**
+     * Get backup directory path
+     */
+    getBackupDirectory() {
+        return this.backupDir;
+    }
+}
+//# sourceMappingURL=databaseBackup.js.map

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

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

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

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Database } from 'sql.js';
+/**
+ * Database Migration Interface
+ */
+export interface Migration {
+    version: number;
+    name: string;
+    up: (db: Database) => void;
+    down: (db: Database) => void;
+}
+/**
+ * Migration Manager for FSS Link Database
+ * Handles schema versioning and safe upgrades
+ */
+export declare class MigrationManager {
+    private migrations;
+    constructor();
+    /**
+     * Register all available migrations
+     */
+    private registerMigrations;
+    /**
+     * Get current schema version from database
+     */
+    getCurrentVersion(db: Database): number;
+    /**
+     * Get latest migration version
+     */
+    getLatestVersion(): number;
+    /**
+     * Check if migrations are needed
+     */
+    needsMigration(db: Database): boolean;
+    /**
+     * Run all pending migrations
+     */
+    migrate(db: Database): Promise<void>;
+    /**
+     * Rollback to a specific version
+     */
+    rollback(db: Database, targetVersion: number): Promise<void>;
+    /**
+     * Update schema version in database
+     */
+    private updateSchemaVersion;
+    /**
+     * Get migration history
+     */
+    getMigrationHistory(db: Database): Array<{
+        version: number;
+        name: string;
+        date: string;
+    }>;
+    /**
+     * Validate database schema integrity
+     */
+    validateSchema(db: Database): boolean;
+}