fss-link 1.2.0 → 1.2.1

package/dist/src/config/unified-database.d.ts

@@ -0,0 +1,383 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Database } from 'sql.js';
+import { CoreDatabase } from './core-database.js';
+export type { ExtendedModelConfig, DatabaseModelRecord, DatabaseProviderRecord, ModelSearchCriteria, ModelQueryOptions } from './model-database.js';
+export type { DatabaseProviderSettingRecord, DatabaseCustomEndpointRecord } from './provider-database.js';
+export type { UserPreference, DatabaseUserPreferenceValueRecord, DatabaseUserPreferenceRecord, DatabaseUserPreferenceFullRecord } from './preferences-database.js';
+/**
+ * Unified Database Manager - Integration Layer
+ *
+ * Combines all extracted database classes into a single interface while maintaining
+ * the architectural separation. This class serves as the primary database interface
+ * for the rest of the application.
+ *
+ * ARCHITECTURAL IMPROVEMENT:
+ * - Provides unified access to all database operations
+ * - Maintains separation of concerns through delegation
+ * - Handles initialization and lifecycle management
+ * - Ensures all database managers work with the same connection
+ */
+export declare class UnifiedDatabase {
+    private coreDb;
+    private modelDb;
+    private providerDb;
+    private preferencesDb;
+    constructor(coreDatabase?: CoreDatabase);
+    /**
+     * Initialize the unified database system
+     */
+    initialize(): Promise<void>;
+    /**
+     * Ensure database is initialized before operations
+     */
+    ensureInitialized(): Promise<void>;
+    /**
+     * Close the unified database system
+     */
+    close(): Promise<void>;
+    /**
+     * Get the raw database connection (for legacy compatibility)
+     */
+    getDatabase(): Database | null;
+    /**
+     * Check if database is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get database path
+     */
+    getDatabasePath(): string;
+    /**
+     * Force immediate save
+     */
+    forceSave(): Promise<void>;
+    /**
+     * Get current database schema version
+     */
+    getSchemaVersion(): Promise<number>;
+    /**
+     * Get migration history
+     */
+    getMigrationHistory(): Promise<Array<{
+        version: number;
+        name: string;
+        date: string;
+    }>>;
+    /**
+     * Run database optimization
+     */
+    optimizeDatabase(): Promise<void>;
+    /**
+     * Get active model configuration
+     */
+    getActiveModel(): Promise<import("./model-database.js").ExtendedModelConfig | null>;
+    /**
+     * Set active model
+     */
+    setActiveModel(configId: number): Promise<void>;
+    /**
+     * Get model configuration by ID
+     */
+    getModelConfig(id: number): Promise<import("./model-database.js").ExtendedModelConfig | null>;
+    /**
+     * Upsert model configuration
+     */
+    upsertModelConfig(config: any): Promise<number>;
+    /**
+     * Delete model configuration
+     */
+    deleteModelConfig(id: number): Promise<void>;
+    /**
+     * Get all model configurations
+     */
+    getAllModelConfigs(): Promise<import("./model-database.js").ExtendedModelConfig[]>;
+    /**
+     * Search model configurations
+     */
+    searchModelConfigs(criteria: any, options?: any): Promise<import("./model-database.js").ExtendedModelConfig[]>;
+    /**
+     * Get favorite models
+     */
+    getFavoriteModels(): Promise<import("./model-database.js").ExtendedModelConfig[]>;
+    /**
+     * Toggle model favorite status
+     */
+    toggleModelFavorite(id: number): Promise<boolean>;
+    /**
+     * Update model last used timestamp
+     */
+    updateModelLastUsed(id: number): Promise<void>;
+    /**
+     * Get recently used models
+     */
+    getRecentlyUsedModels(limit?: number): Promise<import("./model-database.js").ExtendedModelConfig[]>;
+    /**
+     * Get models by auth type
+     */
+    getModelsByAuthType(authType: string): Promise<import("./model-database.js").ExtendedModelConfig[]>;
+    /**
+     * Get model usage statistics
+     */
+    getModelUsageStats(): Promise<any>;
+    /**
+     * Bulk update model configurations
+     */
+    bulkUpdateModelConfigs(updates: any[]): Promise<void>;
+    /**
+     * Check if model configuration exists
+     */
+    modelConfigExists(authType: string, modelName: string): Promise<boolean>;
+    /**
+     * Get provider settings
+     */
+    getProviderSettings(providerId: number): Promise<Record<string, string>>;
+    /**
+     * Save provider setting
+     */
+    saveProviderSetting(providerId: number, key: string, value: string | number): Promise<void>;
+    /**
+     * Save multiple provider settings
+     */
+    saveProviderSettings(providerId: number, settings: Record<string, string | number>): Promise<void>;
+    /**
+     * Delete provider setting
+     */
+    deleteProviderSetting(providerId: number, key: string): Promise<void>;
+    /**
+     * Delete all provider settings
+     */
+    deleteAllProviderSettings(providerId: number): Promise<void>;
+    /**
+     * Save custom endpoint
+     */
+    saveCustomEndpoint(providerId: number | null, name: string, url: string, description?: string, isDefault?: boolean): Promise<number>;
+    /**
+     * Get custom endpoints
+     */
+    getCustomEndpoints(providerId: number): Promise<import("./provider-database.js").DatabaseCustomEndpointRecord[]>;
+    /**
+     * Get default endpoint
+     */
+    getDefaultEndpoint(providerId: number): Promise<import("./provider-database.js").DatabaseCustomEndpointRecord | null>;
+    /**
+     * Update custom endpoint
+     */
+    updateCustomEndpoint(id: number, name: string, url: string, description?: string, isDefault?: boolean): Promise<void>;
+    /**
+     * Delete custom endpoint
+     */
+    deleteCustomEndpoint(id: number): Promise<void>;
+    /**
+     * Delete all custom endpoints
+     */
+    deleteAllCustomEndpoints(providerId: number): Promise<void>;
+    /**
+     * Get provider configuration
+     */
+    getProviderConfiguration(providerId: number): Promise<{
+        settings: Record<string, string>;
+        endpoints: import("./provider-database.js").DatabaseCustomEndpointRecord[];
+        defaultEndpoint: import("./provider-database.js").DatabaseCustomEndpointRecord | null;
+    }>;
+    /**
+     * Get all custom endpoints (no provider filter)
+     */
+    getAllCustomEndpoints(): Promise<import("./provider-database.js").DatabaseCustomEndpointRecord[]>;
+    /**
+     * Link model to custom endpoint
+     */
+    linkModelToEndpoint(modelId: number, endpointId: number): Promise<void>;
+    /**
+     * Get custom endpoint for a model
+     */
+    getEndpointForModel(modelId: number): Promise<import("./provider-database.js").DatabaseCustomEndpointRecord | null>;
+    /**
+     * Get or create custom endpoint by URL
+     */
+    getOrCreateEndpointByUrl(url: string, name?: string, description?: string): Promise<number>;
+    /**
+     * Set user preference
+     */
+    setUserPreference(key: string, value: string): Promise<void>;
+    /**
+     * Get user preference
+     */
+    getUserPreference(key: string): Promise<string | null>;
+    /**
+     * Get user preference with default
+     */
+    getUserPreferenceWithDefault(key: string, defaultValue: string): Promise<string>;
+    /**
+     * Get all user preferences
+     */
+    getAllUserPreferences(): Promise<Record<string, string>>;
+    /**
+     * Get all user preferences with metadata
+     */
+    getAllUserPreferencesWithMetadata(): Promise<import("./preferences-database.js").DatabaseUserPreferenceFullRecord[]>;
+    /**
+     * Set multiple user preferences
+     */
+    setUserPreferences(preferences: Record<string, string>): Promise<void>;
+    /**
+     * Delete user preference
+     */
+    deleteUserPreference(key: string): Promise<void>;
+    /**
+     * Delete multiple user preferences
+     */
+    deleteUserPreferences(keys: string[]): Promise<void>;
+    /**
+     * Clear all user preferences
+     */
+    clearAllUserPreferences(): Promise<void>;
+    /**
+     * Check if user preference exists
+     */
+    hasUserPreference(key: string): Promise<boolean>;
+    /**
+     * Get user preferences by pattern
+     */
+    getUserPreferencesByPattern(pattern: string): Promise<Record<string, string>>;
+    /**
+     * Get preference count
+     */
+    getPreferenceCount(): Promise<number>;
+    /**
+     * Get typed preference
+     */
+    getTypedPreference<T>(key: string, parser: (value: string) => T, defaultValue: T): Promise<T>;
+    /**
+     * Get boolean preference
+     */
+    getBooleanPreference(key: string, defaultValue?: boolean): Promise<boolean>;
+    /**
+     * Get number preference
+     */
+    getNumberPreference(key: string, defaultValue?: number): Promise<number>;
+    /**
+     * Get array preference
+     */
+    getArrayPreference(key: string, defaultValue?: string[]): Promise<string[]>;
+    /**
+     * Set boolean preference
+     */
+    setBooleanPreference(key: string, value: boolean): Promise<void>;
+    /**
+     * Set number preference
+     */
+    setNumberPreference(key: string, value: number): Promise<void>;
+    /**
+     * Set array preference
+     */
+    setArrayPreference(key: string, value: string[]): Promise<void>;
+    /**
+     * Create backup
+     */
+    createBackup(description: string): Promise<any>;
+    /**
+     * Create auto backup
+     */
+    createAutoBackup(): Promise<any>;
+    /**
+     * List backups
+     */
+    listBackups(): Promise<any>;
+    /**
+     * Verify backup
+     */
+    verifyBackup(backupId: string): Promise<{
+        valid: boolean;
+        error?: string;
+    }>;
+    /**
+     * Restore from backup
+     */
+    restoreFromBackup(backupId: string): Promise<void>;
+    /**
+     * Cleanup old backups
+     */
+    cleanupOldBackups(daysToKeep?: number): Promise<number>;
+    /**
+     * Get backup storage size
+     */
+    getBackupStorageSize(): Promise<{
+        totalSize: number;
+        backupCount: number;
+    }>;
+    /**
+     * Collect metrics
+     */
+    collectMetrics(): Promise<any>;
+    /**
+     * Get historical metrics
+     */
+    getHistoricalMetrics(hours?: number): Promise<any>;
+    /**
+     * Get performance trends
+     */
+    getPerformanceTrends(hours?: number): Promise<any>;
+    /**
+     * Record metric
+     */
+    recordMetric(name: string, value: number, timestamp?: Date): Promise<void>;
+    /**
+     * Get metric history
+     */
+    getMetricHistory(name: string, hours?: number): Promise<Array<{
+        timestamp: Date;
+        value: number;
+    }>>;
+    /**
+     * Perform health check
+     */
+    performHealthCheck(): Promise<any>;
+    /**
+     * Get maintenance recommendations
+     */
+    getMaintenanceRecommendations(): Promise<string[]>;
+    /**
+     * Check if optimization needed
+     */
+    needsOptimization(): Promise<{
+        needed: boolean;
+        reasons: string[];
+    }>;
+    /**
+     * Generate health report
+     */
+    generateHealthReport(): Promise<any>;
+    /**
+     * Validate schema
+     */
+    validateSchema(): Promise<any>;
+    /**
+     * Get schema validation report
+     */
+    getSchemaValidationReport(): Promise<string>;
+    /**
+     * Fix schema issues
+     */
+    fixSchemaIssues(): Promise<{
+        fixed: string[];
+        stillBroken: string[];
+    }>;
+    /**
+     * Perform integrity check
+     */
+    performIntegrityCheck(): Promise<any>;
+    /**
+     * Perform maintenance
+     */
+    performMaintenance(): Promise<any>;
+    /**
+     * Get health summary
+     */
+    getHealthSummary(): Promise<any>;
+}
+export declare function getUnifiedDatabase(): UnifiedDatabase;
+export declare function closeUnifiedDatabase(): void;