solver-sdk 5.1.1 → 5.1.4

package/dist/cjs/utils/project-sync-client.js

@@ -0,0 +1,284 @@
+"use strict";
+/**
+ * 🔌 Project Sync WebSocket Client
+ *
+ * Клиент для работы с real-time уведомлениями о статусе синхронизации проектов.
+ * Интегрируется с backend ProjectSyncGateway через Socket.io.
+ *
+ * @features
+ * - Real-time push notifications о статусе индексации
+ * - Auto-reconnection при разрыве соединения
+ * - Graceful fallback к REST polling
+ * - TypeScript поддержка для всех событий
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectSyncClient = void 0;
+const socket_io_client_1 = require("socket.io-client");
+/**
+ * 🔌 WebSocket клиент для project sync уведомлений
+ */
+class ProjectSyncClient {
+    constructor(options) {
+        this.socket = null;
+        this.connected = false;
+        this.retryCount = 0;
+        this.reconnectTimer = null;
+        this.subscribedProjects = new Set();
+        // Event handlers
+        this.eventHandlers = new Map();
+        this.baseURL = options.baseURL;
+        this.options = {
+            connectionTimeout: 10000,
+            maxRetries: 5,
+            retryDelay: 2000,
+            debug: false,
+            ...options
+        };
+        // Инициализируем logger
+        this.logger = {
+            log: (msg) => this.options.debug && console.log(`[ProjectSyncClient] ${msg}`),
+            warn: (msg) => this.options.debug && console.warn(`[ProjectSyncClient] ${msg}`),
+            error: (msg) => console.error(`[ProjectSyncClient] ${msg}`),
+            debug: (msg) => this.options.debug && console.debug(`[ProjectSyncClient] ${msg}`)
+        };
+        // Инициализируем event handlers map
+        const eventTypes = ['sync-status-update', 'sync-progress', 'sync-completed', 'error', 'connected', 'disconnected'];
+        eventTypes.forEach(type => {
+            this.eventHandlers.set(type, new Set());
+        });
+    }
+    /**
+     * 🔌 Подключение к WebSocket
+     */
+    async connect() {
+        return new Promise((resolve, reject) => {
+            try {
+                this.logger.debug(`Подключение к ${this.baseURL}/project-sync`);
+                // Создаем Socket.io соединение
+                this.socket = (0, socket_io_client_1.io)(`${this.baseURL}/project-sync`, {
+                    transports: ['websocket', 'polling'],
+                    timeout: this.options.connectionTimeout,
+                    reconnectionAttempts: 0, // Отключаем автоматический reconnect Socket.io
+                    extraHeaders: this.options.headers || {},
+                });
+                // Обработчик успешного подключения
+                this.socket.on('connect', () => {
+                    this.connected = true;
+                    this.retryCount = 0;
+                    this.logger.log('✅ WebSocket подключение установлено');
+                    this.emit('connected', {});
+                    resolve();
+                });
+                // Обработчик отключения
+                this.socket.on('disconnect', (reason) => {
+                    this.connected = false;
+                    this.logger.warn(`🔌 WebSocket отключен: ${reason}`);
+                    this.emit('disconnected', { reason });
+                    // Автоматический переподключение если отключение не намеренное
+                    if (reason === 'io server disconnect') {
+                        this.scheduleReconnect();
+                    }
+                });
+                // Обработчик ошибок подключения
+                this.socket.on('connect_error', (error) => {
+                    this.logger.error(`❌ Ошибка подключения: ${error.message}`);
+                    reject(new Error(`WebSocket connection failed: ${error.message}`));
+                });
+                // 📊 Обработчики project sync событий
+                this.setupEventHandlers();
+                // Таймаут подключения
+                setTimeout(() => {
+                    if (!this.connected) {
+                        reject(new Error('WebSocket connection timeout'));
+                    }
+                }, this.options.connectionTimeout);
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * ❌ Отключение от WebSocket
+     */
+    disconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.socket) {
+            this.socket.disconnect();
+            this.socket = null;
+        }
+        this.connected = false;
+        this.subscribedProjects.clear();
+        this.logger.log('🔌 WebSocket отключен вручную');
+    }
+    /**
+     * 📡 Подписка на проект для получения уведомлений
+     */
+    subscribeToProject(projectId, userId) {
+        if (!this.connected || !this.socket) {
+            this.logger.warn(`⚠️ Попытка подписки на проект ${projectId} без соединения`);
+            return;
+        }
+        const joinData = {
+            projectId,
+            userId
+        };
+        this.socket.emit('join-project-sync', joinData);
+        this.subscribedProjects.add(projectId);
+        this.logger.debug(`📡 Подписка на проект: ${projectId}`);
+    }
+    /**
+     * 📡 Отписка от проекта
+     */
+    unsubscribeFromProject(projectId) {
+        if (!this.connected || !this.socket) {
+            return;
+        }
+        this.socket.emit('leave-project-sync', { projectId });
+        this.subscribedProjects.delete(projectId);
+        this.logger.debug(`📡 Отписка от проекта: ${projectId}`);
+    }
+    /**
+     * 👂 Подписка на события
+     */
+    on(event, handler) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.add(handler);
+        }
+    }
+    /**
+     * 👂 Отписка от событий
+     */
+    off(event, handler) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+        }
+    }
+    /**
+     * 📢 Эмиссия событий
+     */
+    emit(event, data) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.forEach(handler => {
+                try {
+                    handler(data);
+                }
+                catch (error) {
+                    this.logger.error(`Error in event handler for ${event}: ${error}`);
+                }
+            });
+        }
+    }
+    /**
+     * 🔧 Настройка обработчиков событий от backend
+     */
+    setupEventHandlers() {
+        if (!this.socket)
+            return;
+        // 📊 Обновление статуса синхронизации
+        this.socket.on('sync-status-update', (data) => {
+            const safeData = {
+                projectId: data?.projectId || 'unknown',
+                sessionId: data?.sessionId || 'unknown',
+                status: data?.status || 'unknown',
+                progress: data?.progress || 0,
+                message: data?.message || '',
+                timestamp: data?.timestamp || new Date(),
+                chunksProcessed: data?.chunksProcessed || 0,
+                totalChunks: data?.totalChunks || 0,
+                embeddingsCreated: data?.embeddingsCreated || 0
+            };
+            this.logger.debug(`📊 Статус обновлен: ${safeData.status} для проекта ${safeData.projectId}`);
+            this.emit('sync-status-update', safeData);
+        });
+        // 📈 Прогресс синхронизации
+        this.socket.on('sync-progress', (data) => {
+            const safeData = {
+                projectId: data?.projectId || 'unknown',
+                sessionId: data?.sessionId || 'unknown',
+                stage: data?.stage || 'unknown',
+                progress: data?.progress || 0,
+                currentChunk: data?.currentChunk || 0,
+                totalChunks: data?.totalChunks || 0,
+                estimatedTimeRemaining: data?.estimatedTimeRemaining || 0,
+                details: data?.details || ''
+            };
+            this.logger.debug(`📈 Прогресс: ${safeData.progress}% (${safeData.stage}) для проекта ${safeData.projectId}`);
+            this.emit('sync-progress', safeData);
+        });
+        // ✅ Синхронизация завершена
+        this.socket.on('sync-completed', (data) => {
+            const safeData = {
+                projectId: data?.projectId || 'unknown',
+                sessionId: data?.sessionId || 'unknown',
+                success: data?.success !== false, // По умолчанию true
+                message: data?.message || '',
+                totalProcessed: data?.totalProcessed || 0,
+                duration: data?.duration || 0,
+                error: data?.error || ''
+            };
+            this.logger.log(`✅ Синхронизация завершена: ${safeData.success ? 'SUCCESS' : 'FAILED'} для проекта ${safeData.projectId}`);
+            this.emit('sync-completed', safeData);
+        });
+        // ❌ Ошибки
+        this.socket.on('error', (data) => {
+            // Безопасная обработка undefined/неполных данных
+            const safeData = {
+                projectId: data?.projectId || 'unknown',
+                sessionId: data?.sessionId || 'unknown',
+                error: data?.error || String(data) || 'Unknown error',
+                code: data?.code || 'UNKNOWN_ERROR',
+                timestamp: data?.timestamp || new Date(),
+                recoverable: data?.recoverable !== false // По умолчанию true
+            };
+            this.logger.error(`❌ Ошибка для проекта ${safeData.projectId}: ${safeData.error}`);
+            this.emit('error', safeData);
+        });
+    }
+    /**
+     * 🔄 Планирование переподключения
+     */
+    scheduleReconnect() {
+        if (this.retryCount >= this.options.maxRetries) {
+            this.logger.error(`❌ Превышено максимальное количество попыток переподключения (${this.options.maxRetries})`);
+            return;
+        }
+        const delay = Math.min(this.options.retryDelay * Math.pow(2, this.retryCount), 30000);
+        this.retryCount++;
+        this.logger.warn(`🔄 Переподключение через ${delay}ms (попытка ${this.retryCount}/${this.options.maxRetries})`);
+        this.reconnectTimer = setTimeout(async () => {
+            try {
+                await this.connect();
+                // Восстанавливаем подписки на проекты
+                this.subscribedProjects.forEach(projectId => {
+                    this.subscribeToProject(projectId);
+                });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                this.logger.error(`❌ Ошибка переподключения: ${errorMessage}`);
+                this.scheduleReconnect(); // Планируем следующую попытку
+            }
+        }, delay);
+    }
+    /**
+     * 🔍 Проверка статуса подключения
+     */
+    get isConnected() {
+        return this.connected;
+    }
+    /**
+     * 📋 Список подписанных проектов
+     */
+    get subscribedProjectIds() {
+        return Array.from(this.subscribedProjects);
+    }
+}
+exports.ProjectSyncClient = ProjectSyncClient;
+//# sourceMappingURL=project-sync-client.js.map

package/dist/cjs/utils/project-sync-client.js.map

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

package/dist/esm/api/indexing-api.js

@@ -0,0 +1,178 @@
+/**
+ * 🚀 Indexing API - управление индексацией проектов
+ *
+ * Предоставляет методы для запуска, остановки и мониторинга
+ * индексации проектов, а также получения статуса.
+ */
+/**
+ * API для управления индексацией проектов
+ *
+ * @example
+ * ```javascript
+ * // Создание и индексация проекта
+ * const result = await sdk.indexing.indexProject('/path/to/project', 'My Project');
+ * console.log('Project ID:', result.projectId);
+ *
+ * // Получение статуса индексации
+ * const status = await sdk.indexing.getStatus(result.projectId);
+ * console.log('Progress:', status.progress);
+ *
+ * // Ожидание завершения индексации
+ * const finalStatus = await sdk.indexing.waitForCompletion(result.projectId);
+ * console.log('Final status:', finalStatus.status);
+ *
+ * // Отмена индексации
+ * await sdk.indexing.cancelIndexing(result.projectId);
+ * ```
+ */
+export class IndexingApi {
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Создает проект и запускает его индексацию
+     *
+     * @param {string} projectPath Путь к проекту (для совместимости с тестами)
+     * @param {string} projectName Имя проекта
+     * @param {string} [description] Описание проекта
+     * @returns {Promise<IndexProjectResult>} Результат создания проекта
+     */
+    async indexProject(projectPath, projectName, description) {
+        // Создаем проект
+        const createRequest = {
+            name: projectName,
+            description: description || `Проект из ${projectPath}`
+        };
+        const project = await this.httpClient.post('/api/v1/projects', createRequest);
+        // Запускаем индексацию
+        const indexingResult = await this.httpClient.post(`/api/v1/projects/${project.id}/index`);
+        return {
+            projectId: project.id,
+            name: project.name,
+            status: indexingResult.status || 'started',
+            message: indexingResult.message || 'Индексация запущена'
+        };
+    }
+    /**
+     * Получает текущий статус индексации проекта
+     *
+     * ⚠️ ВАЖНО: Для real-time уведомлений используйте WebSocket:
+     * ```typescript
+     * // Правильно (real-time):
+     * await sdk.connectWebSocket();
+     * sdk.projectSync.on('sync-status-update', (status) => {
+     *   console.log('Статус обновлен:', status);
+     * });
+     *
+     * // Неправильно (не делайте polling):
+     * // setInterval(() => sdk.indexing.getStatus(id), 2000); // ❌
+     * ```
+     *
+     * @param {string} projectId ID проекта
+     * @returns {Promise<IndexingStatus>} Текущий статус индексации
+     */
+    async getStatus(projectId) {
+        this.validateProjectId(projectId);
+        const status = await this.httpClient.get(`/api/v1/projects/${projectId}/indexing-status`);
+        return {
+            status: status.status || 'unknown',
+            progress: status.progress || 0,
+            totalFiles: status.totalFiles,
+            processedFiles: status.processedFiles,
+            currentFile: status.currentFile,
+            error: status.error,
+            updatedAt: new Date().toISOString()
+        };
+    }
+    /**
+     * Ожидает завершения индексации проекта
+     *
+     * ⚠️ DEPRECATED: Используйте WebSocket для real-time уведомлений
+     *
+     * @param {string} projectId ID проекта
+     * @param {number} [timeout=300000] Таймаут в миллисекундах (по умолчанию 5 минут)
+     * @returns {Promise<IndexingStatus>} Финальный статус индексации
+     */
+    async waitForCompletion(projectId, timeout = 300000) {
+        this.validateProjectId(projectId);
+        const startTime = Date.now();
+        const pollInterval = 2000; // 2 секунды
+        return new Promise((resolve, reject) => {
+            const checkStatus = async () => {
+                try {
+                    const status = await this.getStatus(projectId);
+                    // Проверяем завершение
+                    if (status.status === 'completed' || status.status === 'complete') {
+                        resolve(status);
+                        return;
+                    }
+                    // Проверяем ошибку
+                    if (status.status === 'failed' || status.status === 'error') {
+                        resolve(status);
+                        return;
+                    }
+                    // Проверяем таймаут
+                    if (Date.now() - startTime > timeout) {
+                        reject(new Error(`Таймаут ожидания завершения индексации (${timeout}ms)`));
+                        return;
+                    }
+                    // Продолжаем ожидание
+                    setTimeout(checkStatus, pollInterval);
+                }
+                catch (error) {
+                    reject(error);
+                }
+            };
+            checkStatus();
+        });
+    }
+    /**
+     * Отменяет текущую индексацию проекта
+     *
+     * @param {string} projectId ID проекта
+     * @returns {Promise<void>}
+     */
+    async cancelIndexing(projectId) {
+        this.validateProjectId(projectId);
+        await this.httpClient.post(`/api/v1/projects/${projectId}/cancel-indexing`);
+    }
+    /**
+     * Перезапускает индексацию проекта
+     *
+     * @param {string} projectId ID проекта
+     * @returns {Promise<IndexingStatus>} Статус после перезапуска
+     */
+    async restartIndexing(projectId) {
+        this.validateProjectId(projectId);
+        // Сначала отменяем текущую индексацию
+        try {
+            await this.cancelIndexing(projectId);
+        }
+        catch (error) {
+            // Игнорируем ошибки отмены - возможно индексация уже завершена
+        }
+        // Запускаем новую индексацию
+        const result = await this.httpClient.post(`/api/v1/projects/${projectId}/index`);
+        return {
+            status: result.status || 'started',
+            progress: 0,
+            updatedAt: new Date().toISOString()
+        };
+    }
+    /**
+     * Валидация ID проекта
+     * @private
+     */
+    validateProjectId(projectId) {
+        if (projectId === undefined || projectId === null) {
+            throw new Error('Project ID is required');
+        }
+        if (typeof projectId !== 'string') {
+            throw new Error('Project ID must be a string');
+        }
+        if (projectId.trim().length === 0) {
+            throw new Error('Project ID cannot be empty');
+        }
+    }
+}
+//# sourceMappingURL=indexing-api.js.map

package/dist/esm/api/indexing-api.js.map

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

package/dist/esm/api/projects-api.js

@@ -73,26 +73,45 @@ export class ProjectsApi {
      * @throws {Error} Если не удалось получить проекты или сервер вернул ошибку
      */
     async getAllProjects() {
-        // 🚀 УЛУЧШЕНО: Используем новые типы ApiResponse для лучшей обработки
-        const response = await this.httpClient.get('/api/v1/projects');
-        if (!response.success || !response.data) {
-            const error = response.error;
-            throw new Error(error?.message || 'Не удалось получить проекты');
+        // HttpClient уже извлекает data из axios response, возвращая прямой массив Project[]
+        const projects = await this.httpClient.get('/api/v1/projects');
+        return projects;
+    }
+    /**
+     * Псевдоним для getAllProjects() для совместимости с тестами
+     *
+     * @returns {Promise<Project[]>} Массив проектов пользователя
+     */
+    async getProjects() {
+        return this.getAllProjects();
+    }
+    /**
+     * Находит существующий проект или создает новый
+     * Для совместимости с интеграционными тестами
+     *
+     * @param {string} projectPath Путь к проекту (для совместимости)
+     * @param {string} projectName Имя проекта
+     * @param {string} [description] Описание проекта
+     * @returns {Promise<Project>} Найденный или созданный проект
+     */
+    async findOrCreateProject(projectPath, projectName, description) {
+        // Сначала пытаемся найти существующий проект по имени
+        const projects = await this.getAllProjects();
+        const existingProject = projects.find(p => p.name === projectName);
+        if (existingProject) {
+            return existingProject;
         }
-        return response.data;
+        // Если не найден, создаем новый
+        return this.createProject(projectName, projectPath, { description: description || `Проект из ${projectPath}` });
     }
     /**
      * Получает список готовых к работе проектов
      * @returns {Promise<Project[]>} Список готовых проектов
      */
     async getReadyProjects() {
-        // 🚀 УЛУЧШЕНО: Используем новые типы ApiResponse
-        const response = await this.httpClient.get('/api/v1/projects/ready');
-        if (!response.success || !response.data) {
-            const error = response.error;
-            throw new Error(error?.message || 'Не удалось получить готовые проекты');
-        }
-        return response.data;
+        // HttpClient уже извлекает data из axios response, возвращая прямой массив Project[]
+        const projects = await this.httpClient.get('/api/v1/projects/ready');
+        return projects;
     }
     /**
      * Получает детальную информацию о проекте по его ID
@@ -123,13 +142,9 @@ export class ProjectsApi {
      * @throws {Error} Если проект не найден или произошла ошибка сервера
      */
     async getProject(projectId) {
-        // 🚀 УЛУЧШЕНО: Используем новые типы ApiResponse
-        const response = await this.httpClient.get(`/api/v1/projects/${projectId}`);
-        if (!response.success || !response.data) {
-            const error = response.error;
-            throw new Error(error?.message || `Не удалось найти проект ${projectId}`);
-        }
-        return response.data;
+        // HttpClient уже извлекает data из axios response, возвращая прямой объект Project
+        const project = await this.httpClient.get(`/api/v1/projects/${projectId}`);
+        return project;
     }
     /**
      * Создает новый проект или возвращает существующий (автоматическая дедупликация)
@@ -177,12 +192,9 @@ export class ProjectsApi {
             description: data.description,
             ...data
         };
-        const response = await this.httpClient.post('/api/v1/projects', projectData);
-        if (!response.success || !response.data) {
-            const error = response.error;
-            throw new Error(error?.message || `Не удалось создать проект "${name}"`);
-        }
-        return response.data;
+        // HttpClient уже извлекает data из axios response, возвращая прямой объект Project
+        const project = await this.httpClient.post('/api/v1/projects', projectData);
+        return project;
     }
     /**
      * Получает статус проекта
@@ -211,13 +223,25 @@ export class ProjectsApi {
         throw new Error('Метод deleteProject не поддерживается текущей версией бэкенда');
     }
     /**
-     * Получает статус индексации проекта
+     * Получает текущий статус индексации проекта (единичный запрос)
+     *
+     * ⚠️ ВАЖНО: Для real-time уведомлений используйте WebSocket:
+     * ```typescript
+     * // Правильно (real-time):
+     * await sdk.connectWebSocket();
+     * sdk.projectSync.on('sync-status-update', (status) => {
+     *   console.log('Статус обновлен:', status);
+     * });
+     *
+     * // Неправильно (не делайте polling):
+     * // setInterval(() => sdk.projects.getIndexingStatus(id), 2000); // ❌
+     * ```
+     *
      * @param {string} projectId Идентификатор проекта
-     * @returns {Promise<any>} Статус индексации проекта
+     * @returns {Promise<any>} Текущий статус индексации (snapshot)
      */
     async getIndexingStatus(projectId) {
         this.validateProjectId(projectId);
-        // ✅ ИСПРАВЛЕНИЕ: Используем новый эндпоинт с real-time статусом и безопасной сериализацией
         return this.httpClient.get(`/api/v1/projects/${projectId}/indexing-status`);
     }
     /**
@@ -558,6 +582,7 @@ export class ProjectsApi {
     async finalizeDeltaSync(projectId) {
         this.validateProjectId(projectId);
         const response = await this.httpClient.post(`/api/v1/projects/${projectId}/sync-finalize`, {});
+        // HttpClient уже извлекает data из axios response, response - это прямой объект от backend
         return {
             success: response.success || false,
             projectId,
@@ -577,6 +602,7 @@ export class ProjectsApi {
     async cancelDeltaSync(projectId) {
         this.validateProjectId(projectId);
         const response = await this.httpClient.delete(`/api/v1/projects/${projectId}/sync-cancel`);
+        // HttpClient уже извлекает data из axios response, response - это прямой объект от backend
         return {
             success: response.success || false,
             message: response.message