fss-link 1.2.0 → 1.2.1

package/dist/src/config/archive-repository-pattern/model-repository.d.ts

@@ -0,0 +1,274 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Database } from 'sql.js';
+import type { FSSLinkDatabase } from './database.js';
+import { ModelConfig } from 'fss-link-core';
+import { BaseRepository, BaseEntity } from './base-repository.js';
+import { QueryParameters } from './repository-types.js';
+/**
+ * ======================================================================================
+ * MODEL REPOSITORY - PHASE 2 REPOSITORY PATTERN IMPLEMENTATION
+ * ======================================================================================
+ *
+ * Thread-safe model configuration repository with async locking protection.
+ * Replaces direct model config database calls to eliminate "Statement closed"
+ * errors and race conditions in the auth system.
+ *
+ * @author Emma - Technical Implementation Specialist
+ * @task Task 6: ModelRepository Implementation
+ * @dependencies Task 5 (BaseRepository)
+ */
+/**
+ * Extended ModelConfig interface for database operations
+ */
+export interface ModelConfigEntity extends BaseEntity {
+    id?: number;
+    auth_type: string;
+    model_name: string;
+    endpoint_url?: string;
+    api_key?: string;
+    display_name?: string;
+    is_favorite: boolean;
+    is_active: boolean;
+    last_used?: string;
+    created_at?: string;
+    source?: string;
+}
+/**
+ * Model statistics interface
+ */
+export interface ModelStatistics {
+    totalModels: number;
+    activeModels: number;
+    favoriteModels: number;
+    modelsByAuthType: Record<string, number>;
+    recentlyUsed: Array<ModelConfigEntity>;
+}
+/**
+ * Model Repository providing thread-safe model configuration management.
+ *
+ * This repository ELIMINATES "Statement closed" errors by using async locking
+ * for all database operations. Critical for auth system reliability.
+ */
+export declare class ModelRepository extends BaseRepository<ModelConfigEntity> {
+    constructor(db: Database | FSSLinkDatabase);
+    /**
+     * Get table name for this repository
+     */
+    protected getTableName(): string;
+    /**
+     * ======================================================================================
+     * CORE CRUD OPERATIONS - THREAD SAFE
+     * ======================================================================================
+     */
+    /**
+     * Create a new model configuration
+     *
+     * @param model - Partial model configuration
+     * @returns Promise<number> ID of created model
+     */
+    create(model: Partial<ModelConfigEntity>): Promise<number>;
+    /**
+     * Find model by ID
+     *
+     * @param id - Model ID
+     * @returns Promise<ModelConfigEntity | null>
+     */
+    findById(id: number): Promise<ModelConfigEntity | null>;
+    /**
+     * Update model by ID
+     *
+     * @param id - Model ID to update
+     * @param updates - Partial model data with updates
+     * @returns Promise<boolean> true if updated
+     */
+    update(id: number, updates: Partial<ModelConfigEntity>): Promise<boolean>;
+    /**
+     * Delete model by ID
+     *
+     * @param id - Model ID to delete
+     * @returns Promise<boolean> true if deleted
+     */
+    delete(id: number): Promise<boolean>;
+    /**
+     * Find all models with optional filtering
+     *
+     * @param whereClause - Optional WHERE clause
+     * @param params - Parameters for WHERE clause
+     * @param orderBy - Optional ORDER BY clause
+     * @param limit - Optional LIMIT
+     * @returns Promise<Array<ModelConfigEntity>>
+     */
+    findAll(whereClause?: string, params?: QueryParameters, orderBy?: string, limit?: number): Promise<Array<ModelConfigEntity>>;
+    /**
+     * Find first model matching criteria
+     *
+     * @param whereClause - WHERE clause
+     * @param params - Parameters for WHERE clause
+     * @returns Promise<ModelConfigEntity | null>
+     */
+    findFirst(whereClause: string, params: QueryParameters): Promise<ModelConfigEntity | null>;
+    /**
+     * ======================================================================================
+     * MODEL-SPECIFIC OPERATIONS - AUTH SYSTEM CRITICAL
+     * ======================================================================================
+     */
+    /**
+     * Get the currently active model (CRITICAL for auth system)
+     *
+     * @returns Promise<ModelConfigEntity | null>
+     */
+    getActiveModel(): Promise<ModelConfigEntity | null>;
+    /**
+     * Set model as active (deactivates all others) - ATOMIC OPERATION
+     *
+     * @param modelId - ID of model to activate
+     * @returns Promise<boolean> true if successful
+     */
+    setActiveModel(modelId: number): Promise<boolean>;
+    /**
+     * Switch to model by auth type and model name
+     *
+     * @param authType - Auth type
+     * @param modelName - Model name
+     * @returns Promise<boolean> true if switched
+     */
+    switchToModel(authType: string, modelName: string): Promise<boolean>;
+    /**
+     * Upsert model configuration (insert or update)
+     *
+     * @param model - Model configuration
+     * @returns Promise<number> model ID
+     */
+    upsertModel(model: Partial<ModelConfigEntity>): Promise<number>;
+    /**
+     * ======================================================================================
+     * QUERY OPERATIONS - OPTIMIZED
+     * ======================================================================================
+     */
+    /**
+     * Find models by auth type
+     *
+     * @param authType - Auth type to filter by
+     * @returns Promise<Array<ModelConfigEntity>>
+     */
+    findByAuthType(authType: string): Promise<Array<ModelConfigEntity>>;
+    /**
+     * Find favorite models
+     *
+     * @returns Promise<Array<ModelConfigEntity>>
+     */
+    findFavorites(): Promise<Array<ModelConfigEntity>>;
+    /**
+     * Find recently used models
+     *
+     * @param limit - Number of recent models to return
+     * @returns Promise<Array<ModelConfigEntity>>
+     */
+    findRecentlyUsed(limit?: number): Promise<Array<ModelConfigEntity>>;
+    /**
+     * Check if any models exist for auth type
+     *
+     * @param authType - Auth type to check
+     * @returns Promise<boolean>
+     */
+    hasModelsForAuthType(authType: string): Promise<boolean>;
+    /**
+     * Check if active model exists
+     *
+     * @returns Promise<boolean>
+     */
+    hasActiveModel(): Promise<boolean>;
+    /**
+     * ======================================================================================
+     * STATISTICS AND DIAGNOSTICS
+     * ======================================================================================
+     */
+    /**
+     * Get comprehensive model statistics
+     *
+     * @returns Promise<ModelStatistics>
+     */
+    getModelStatistics(): Promise<ModelStatistics>;
+    /**
+     * Cleanup inactive models older than specified date
+     *
+     * @param cutoffDate - Date before which to delete inactive models
+     * @returns Promise<number> number of deleted models
+     */
+    cleanupOldModels(cutoffDate: Date): Promise<number>;
+    /**
+     * ======================================================================================
+     * UTILITY METHODS
+     * ======================================================================================
+     */
+    /**
+     * Map database result to proper ModelConfigEntity with type conversion
+     *
+     * @param result - Raw database result
+     * @returns ModelConfigEntity with proper types
+     */
+    private mapDatabaseResult;
+    /**
+     * Convert ModelConfig (from core) to ModelConfigEntity
+     *
+     * @param config - ModelConfig from fss-link-core
+     * @returns ModelConfigEntity for database operations
+     */
+    static fromModelConfig(config: ModelConfig): Partial<ModelConfigEntity>;
+    /**
+     * Convert ModelConfigEntity to ModelConfig (for core)
+     *
+     * @param entity - ModelConfigEntity from database
+     * @returns ModelConfig for fss-link-core
+     */
+    static toModelConfig(entity: ModelConfigEntity): ModelConfig;
+    /**
+     * Execute operations within a transaction (PUBLIC API for tests)
+     *
+     * @param operations - Async function containing database operations
+     * @returns Promise<T> result of operations
+     */
+    executeTransaction<U>(operations: (db: Database) => Promise<U>): Promise<U>;
+}
+/**
+ * ======================================================================================
+ * MIGRATION GUIDE: REPLACING DIRECT DATABASE CALLS
+ * ======================================================================================
+ *
+ * OLD (race condition prone):
+ * const db = await getFSSLinkDatabase();
+ * const models = safeQuery(db, 'SELECT * FROM model_configs WHERE auth_type = ?', [authType]);
+ * const result = safeExec(db, 'UPDATE model_configs SET is_active = 1 WHERE id = ?', [modelId]);
+ *
+ * NEW (thread-safe with async locking):
+ * const modelRepo = new ModelRepository(db);
+ * const models = await modelRepo.findByAuthType(authType);
+ * const success = await modelRepo.setActiveModel(modelId);
+ *
+ * EXAMPLES:
+ *
+ * // Get active model (critical for auth system)
+ * const activeModel = await modelRepo.getActiveModel();
+ *
+ * // Switch models atomically
+ * const switched = await modelRepo.switchToModel('ollama', 'qwen3:4b');
+ *
+ * // Upsert model configuration
+ * const modelId = await modelRepo.upsertModel({
+ *   auth_type: 'ollama',
+ *   model_name: 'qwen3:4b',
+ *   is_favorite: true,
+ *   is_active: false
+ * });
+ *
+ * // Get statistics
+ * const stats = await modelRepo.getModelStatistics();
+ * console.log(`Total: ${stats.totalModels}, Active: ${stats.activeModels}`);
+ *
+ * // Cleanup old models
+ * const deleted = await modelRepo.cleanupOldModels(new Date(Date.now() - 30 * 24 * 60 * 60 * 1000));
+ */