solver-sdk 6.0.0 → 6.0.1

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

@@ -1,578 +1,134 @@
-/**
- * Константы для API путей
- */
-export var ApiEndpoints;
-(function (ApiEndpoints) {
-    ApiEndpoints["PROJECTS"] = "/api/v1/projects";
-    ApiEndpoints["PROJECT"] = "/api/v1/projects/:id";
-    ApiEndpoints["PROJECT_INDEXING_STATUS"] = "/api/v1/projects/:id/indexing_status";
-    ApiEndpoints["PROJECT_CANCEL_INDEXING"] = "/api/v1/projects/:id/cancel_indexing";
-    ApiEndpoints["PROJECT_CLEAR_ERROR"] = "/api/v1/projects/:id/clear_error";
-})(ApiEndpoints || (ApiEndpoints = {}));
-/**
- * Замещает параметры в пути API
- * @param endpoint Шаблон пути API
- * @param params Параметры для замещения
- * @returns Путь API с замещенными параметрами
- */
-function formatEndpoint(endpoint, params) {
-    let result = endpoint;
-    for (const [key, value] of Object.entries(params)) {
-        result = result.replace(`:${key}`, value);
-    }
-    return result;
-}
 /**
  * API для работы с проектами
  */
 export class ProjectsApi {
-    /**
-     * Создает новый экземпляр API для работы с проектами
-     * @param {HttpClient} httpClient HTTP клиент
-     */
     constructor(httpClient) {
         this.httpClient = httpClient;
     }
+    // ===== ОСНОВНЫЕ МЕТОДЫ УПРАВЛЕНИЯ ПРОЕКТАМИ =====
     /**
-     * Проверяет валидность идентификатора проекта
-     * @param {string} projectId ID проекта
-     * @throws {Error} Если ID проекта не валиден
-     */
-    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() === '') {
-            throw new Error('Project ID cannot be empty');
-        }
-    }
-    /**
-     * Получает список всех проектов с полной информацией
-     *
-     * @returns {Promise<Project[]>} Массив проектов с богатой информацией:
-     *   - Базовые поля: id, name, path, description
-     *   - Статус индексации: indexStatus, indexingProgress, ready
-     *   - Статистика: fileCount, languageStats
-     *   - Ошибки: indexingErrors, indexingWarnings, lastError
-     *   - Автореиндексация: needsReindexing, changeInfo, autoReindexing
-     *
-     * @example
-     * ```typescript
-     * const projects = await sdk.getAllProjects();
-     * projects.forEach(project => {
-     *   console.log(`${project.name}: ${project.ready ? 'Ready' : 'Indexing...'}`);
-     *   if (project.ready) {
-     *     console.log(`Files: ${project.fileCount}, Languages:`, project.languageStats);
-     *   }
-     * });
-     * ```
-     *
-     * @throws {Error} Если не удалось получить проекты или сервер вернул ошибку
+     * Получает все проекты пользователя
      */
     async getAllProjects() {
-        // HttpClient уже извлекает data из axios response, возвращая прямой массив Project[]
         const projects = await this.httpClient.get('/api/v1/projects');
         return projects;
     }
     /**
-     * Псевдоним для getAllProjects() для совместимости с тестами
-     *
-     * @returns {Promise<Project[]>} Массив проектов пользователя
+     * Альтернативное имя для getAllProjects() для совместимости
      */
     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;
+    async findOrCreateProject(projectPath, projectName) {
+        if (!projectPath?.trim() || !projectName?.trim()) {
+            throw new Error('Project path and name are required');
         }
-        // Если не найден, создаем новый
-        return this.createProject(projectName, projectPath, { description: description || `Проект из ${projectPath}` });
+        const response = await this.httpClient.post('/api/v1/projects/find-or-create', {
+            path: projectPath.replace(/\\/g, '/').replace(/\/$/, ''),
+            name: projectName
+        });
+        return response;
     }
     /**
-     * Получает список готовых к работе проектов
-     * @returns {Promise<Project[]>} Список готовых проектов
+     * Получает проекты, готовые к использованию
      */
     async getReadyProjects() {
-        // HttpClient уже извлекает data из axios response, возвращая прямой массив Project[]
-        const projects = await this.httpClient.get('/api/v1/projects/ready');
-        return projects;
+        const allProjects = await this.getAllProjects();
+        return allProjects.filter(project => project.indexStatus === 'indexed');
     }
     /**
-     * Получает детальную информацию о проекте по его ID
-     *
-     * @param {string} projectId Уникальный идентификатор проекта
-     * @returns {Promise<Project>} Полная информация о проекте включая:
-     *   - Статус готовности (ready) - можно ли работать с проектом
-     *   - Прогресс индексации (indexingProgress) - процент завершения
-     *   - Информацию об ошибках (indexingErrors, lastError)
-     *   - Статистику файлов (fileCount, languageStats)
-     *
-     * @example
-     * ```typescript
-     * const project = await sdk.getProject("proj_123");
-     *
-     * if (project.ready) {
-     *   console.log(`Проект ${project.name} готов к работе`);
-     *   console.log(`Файлов: ${project.fileCount}`);
-     * } else if (project.indexingProgress) {
-     *   console.log(`Индексация: ${project.indexingProgress}%`);
-     * }
-     *
-     * if (project.indexingErrors?.length > 0) {
-     *   console.warn('Есть ошибки индексации:', project.indexingErrors);
-     * }
-     * ```
-     *
-     * @throws {Error} Если проект не найден или произошла ошибка сервера
+     * Получает проект по ID
      */
     async getProject(projectId) {
-        // HttpClient уже извлекает data из axios response, возвращая прямой объект Project
+        this.validateProjectId(projectId);
         const project = await this.httpClient.get(`/api/v1/projects/${projectId}`);
         return project;
     }
     /**
-     * Создает новый проект или возвращает существующий (автоматическая дедупликация)
-     *
-     * @param {string} name Название проекта (отображаемое имя)
-     * @param {string} path Абсолютный путь к проекту в файловой системе
-     * @param {any} data Дополнительные параметры:
-     *   - description?: string - Описание проекта
-     *   - любые другие поля, которые будут переданы в backend
-     *
-     * @returns {Promise<Project>} Созданный или найденный проект с полной информацией.
-     *   После создания проект будет в статусе "pending" и начнет индексироваться автоматически.
-     *
-     * @example
-     * ```typescript
-     * // Простое создание
-     * const project = await sdk.createProject(
-     *   "My React App",
-     *   "/Users/developer/my-react-app"
-     * );
-     *
-     * // С описанием
-     * const project = await sdk.createProject(
-     *   "Backend API",
-     *   "/path/to/backend",
-     *   { description: "Node.js REST API with TypeScript" }
-     * );
-     *
-     * console.log(`Проект создан: ${project.name}`);
-     * console.log(`Статус: ${project.indexStatus}`);
-     *
-     * // Мониторинг индексации
-     * if (project.indexStatus === 'pending') {
-     *   console.log('Индексация начнется автоматически...');
-     * }
-     * ```
-     *
-     * @throws {Error} Если путь недоступен, проект не может быть создан, или ошибка сервера
+     * Создает новый проект
      */
-    async createProject(name, path, data = {}) {
-        // 🚀 УЛУЧШЕНО: Используем новые типы для создания проекта
-        const projectData = {
-            name,
-            path,
-            description: data.description,
-            ...data
+    async createProject(name, data, options) {
+        if (!name?.trim()) {
+            throw new Error('Project name is required');
+        }
+        const requestData = {
+            name: name.trim(),
+            ...data,
+            ...options
         };
-        // HttpClient уже извлекает data из axios response, возвращая прямой объект Project
-        const project = await this.httpClient.post('/api/v1/projects', projectData);
+        const project = await this.httpClient.post('/api/v1/projects', requestData);
         return project;
     }
+    /**
+     * Удаляет проект
+     */
+    async deleteProject(projectId) {
+        this.validateProjectId(projectId);
+        await this.httpClient.delete(`/api/v1/projects/${projectId}`);
+    }
+    // ===== ИНДЕКСАЦИЯ И СТАТУС =====
     /**
      * Получает статус проекта
-     * @param {string} projectId ID проекта
-     * @returns {Promise<any>} Статус проекта
      */
     async getProjectStatus(projectId) {
-        return this.httpClient.get(`/api/v1/projects/${projectId}/status`);
+        this.validateProjectId(projectId);
+        return await this.httpClient.get(`/api/v1/projects/${projectId}/status`);
     }
     /**
      * Запускает индексацию проекта
-     * @param {string} projectId ID проекта
-     * @param {any} options Опции индексации
-     * @returns {Promise<any>} Результат запуска индексации
      */
     async startIndexing(projectId, options = {}) {
-        return this.httpClient.post(`/api/v1/projects/${projectId}/index`, options);
-    }
-    /**
-     * Удаляет проект
-     * @param projectId - ID проекта
-     * @returns Promise<{ success: boolean }>
-     * @throws Error если метод не поддерживается
-     */
-    /**
-     * 🗑️ Удалить проект полностью (ВНИМАНИЕ: Удаляет ВСЕ данные!)
-     *
-     * Удаляет проект и все связанные данные из системы:
-     * - Все чанки и векторы из Qdrant
-     * - Все записи из PostgreSQL
-     * - Метаданные проекта
-     * - Сессии синхронизации
-     *
-     * @param projectId ID проекта для удаления
-     * @returns Результат удаления
-     *
-     * @example
-     * ```typescript
-     * // ВНИМАНИЕ: Это действие необратимо!
-     * const result = await sdk.projects.deleteProject(projectId);
-     *
-     * if (result.success) {
-     *   console.log('✅ Проект полностью удален');
-     * }
-     * ```
-     */
-    async deleteProject(projectId) {
         this.validateProjectId(projectId);
-        try {
-            const response = await this.httpClient.delete(`/api/v1/projects/${projectId}`);
-            return {
-                success: response.success || false,
-                message: response.message || 'Project deleted successfully'
-            };
-        }
-        catch (error) {
-            console.error('Failed to delete project:', error);
-            return {
-                success: false,
-                message: `Failed to delete project: ${error instanceof Error ? error.message : String(error)}`
-            };
-        }
+        const payload = options.force
+            ? { action: 'force_restart' }
+            : {};
+        return await this.httpClient.post(`/api/v1/projects/${projectId}/index`, payload);
     }
     /**
-     * Получает текущий статус индексации проекта (единичный запрос)
-     *
-     * ⚠️ ВАЖНО: Для 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>} Текущий статус индексации (snapshot)
+     * Получает статус индексации проекта
      */
     async getIndexingStatus(projectId) {
         this.validateProjectId(projectId);
-        return this.httpClient.get(`/api/v1/projects/${projectId}/indexing-status`);
+        return await this.httpClient.get(`/api/v1/projects/${projectId}/indexing-status`);
     }
     /**
      * Отменяет индексацию проекта
-     * @param {string} projectId Идентификатор проекта
-     * @returns {Promise<boolean>} Результат отмены индексации
      */
     async cancelIndexing(projectId) {
-        if (!projectId) {
-            throw new Error('Project ID is required');
-        }
-        return this.httpClient.post(formatEndpoint(ApiEndpoints.PROJECT_CANCEL_INDEXING, { id: projectId }))
-            .then(response => {
-            return true;
-        })
-            .catch(error => {
-            throw new Error(`Failed to cancel indexing: ${error.message}`);
-        });
-    }
-    /**
-     * Останавливает индексацию проекта (алиас для cancelIndexing)
-     * @param {string} projectId Идентификатор проекта
-     * @returns {Promise<boolean>} Результат остановки индексации
-     */
-    async stopIndexing(projectId) {
-        return this.cancelIndexing(projectId);
-    }
-    /**
-     * Очищает ошибку индексации проекта
-     * @param {string} projectId Идентификатор проекта
-     * @returns {Promise<boolean>} Результат очистки ошибки
-     */
-    async clearIndexingError(projectId) {
-        this.validateProjectId(projectId);
-        return this.httpClient.post(formatEndpoint(ApiEndpoints.PROJECT_CLEAR_ERROR, { id: projectId }))
-            .then(() => true)
-            .catch(error => {
-            throw new Error(`Failed to clear indexing error: ${error.message}`);
-        });
-    }
-    /**
-     * Обновляет индекс конкретного файла в проекте
-     * @param {string} projectId ID проекта
-     * @param {string} filePath Путь к файлу (относительно корня проекта)
-     * @param {Object} options Опции обновления индекса
-     * @param {string} [options.content] Содержимое файла (если не указано, будет прочитано с диска)
-     * @param {boolean} [options.force=false] Принудительная переиндексация, даже если файл не изменился
-     * @param {string} [options.language] Язык файла (если не указан, будет определен автоматически)
-     * @param {boolean} [options.updateDependencies=false] Обновлять зависимости после индексации файла
-     * @returns {Promise<FileIndexResponse>} Информация об обновленном индексе файла
-     */
-    async updateFileIndex(projectId, filePath, options = {}) {
         this.validateProjectId(projectId);
-        if (!filePath) {
-            throw new Error('Путь к файлу не может быть пустым');
-        }
-        // Кодируем путь для URL, чтобы избежать проблем со специальными символами
-        const encodedFilePath = encodeURIComponent(filePath);
-        return this.httpClient.post('/api/v1/projects/' + projectId + '/files/' + encodedFilePath + '/index', options);
-    }
-    /**
-     * Кэширует соответствие пути и ID проекта
-     * @param path Путь к проекту
-     * @param projectId ID проекта
-     * @private
-     */
-    cacheProjectId(path, projectId) {
-        const normalizedPath = path.replace(/\\/g, '/').replace(/\/$/, '');
-        if (typeof localStorage !== 'undefined') {
-            // Браузерное окружение
-            const cachedProjects = JSON.parse(localStorage.getItem('solverSdkProjectCache') || '{}');
-            cachedProjects[normalizedPath] = projectId;
-            localStorage.setItem('solverSdkProjectCache', JSON.stringify(cachedProjects));
-        }
-        else if (typeof process !== 'undefined') {
-            // Node.js окружение (для VS Code/Cursor)
-            if (!global.solverSdkProjectCache) {
-                global.solverSdkProjectCache = {};
-            }
-            global.solverSdkProjectCache[normalizedPath] = projectId;
-        }
-        else {
-            throw new Error('Неподдерживаемая среда выполнения - нет localStorage и process');
-        }
-    }
-    /**
-     * Получает ID проекта из кэша
-     * @param path Путь к проекту
-     * @returns ID проекта или null, если не найдено
-     * @private
-     */
-    getCachedProjectId(path) {
-        const normalizedPath = path.replace(/\\/g, '/').replace(/\/$/, '');
-        if (typeof localStorage !== 'undefined') {
-            // Браузерное окружение
-            const cachedProjects = JSON.parse(localStorage.getItem('solverSdkProjectCache') || '{}');
-            return cachedProjects[normalizedPath] || null;
-        }
-        else if (typeof process !== 'undefined' && global.solverSdkProjectCache) {
-            // Node.js окружение
-            return global.solverSdkProjectCache[normalizedPath] || null;
-        }
-        return null;
-    }
-    /**
-     * Получает или создает проект по пути
-     * @param path Путь к проекту
-     * @param name Имя проекта (опционально, если не указано - будет сгенерировано из пути)
-     * @returns Данные проекта
-     */
-    async getOrCreateProject(path, name) {
-        if (!path) {
-            throw new Error('Путь к проекту не может быть пустым');
-        }
-        const normalizedPath = path.replace(/\\/g, '/').replace(/\/$/, '');
-        // Сначала проверяем кэш
-        const cachedProjectId = this.getCachedProjectId(normalizedPath);
-        if (cachedProjectId) {
-            // Если в кэше есть ID - пытаемся получить проект, при ошибке бросаем исключение
-            const project = await this.getProject(cachedProjectId);
-            return project;
-        }
-        // Вызываем API для получения/создания проекта
-        const project = await this.httpClient.post('/api/v1/projects', {
-            path: normalizedPath,
-            name: name || normalizedPath.split('/').pop() || 'Unnamed Project'
-        });
-        // Кэшируем результат
-        this.cacheProjectId(normalizedPath, project.id);
-        return project;
-    }
-    /**
-     * Индексирует проект по указанному пути
-     * @param path Путь к проекту
-     * @param options Опции индексации
-     * @returns Результат операции индексации
-     */
-    async indexProjectByPath(path, options = {}) {
-        if (!path) {
-            throw new Error('Путь к проекту не может быть пустым');
-        }
-        const normalizedPath = path.replace(/\\/g, '/').replace(/\/$/, '');
-        const projectName = options.name || normalizedPath.split('/').pop() || 'Unnamed Project';
-        try {
-            // ✅ ЧИСТЫЙ ПОДХОД: Используем стандартный endpoint с автоматической дедупликацией
-            const project = await this.httpClient.post('/api/v1/projects', {
-                path: normalizedPath,
-                name: projectName
-            });
-            if (!project || !project.id) {
-                throw new Error('Не удалось создать проект - отсутствует ID');
-            }
-            // ✅ СОВРЕМЕННЫЙ API: 2. Запускаем индексацию
-            const indexingResult = await this.httpClient.post(`/api/v1/projects/${project.id}/index`, {
-                forceFull: options.forceFull,
-                excludePatterns: options.excludePatterns
-            });
-            return {
-                success: true,
-                status: 'indexing',
-                projectId: project.id
-            };
-        }
-        catch (error) {
-            // Улучшаем сообщение об ошибке
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new Error(`Не удалось выполнить индексацию проекта по пути: ${errorMessage}`);
-        }
-    }
-    /**
-     * Создание и индексация проекта в одной операции
-     * @param path Путь к проекту
-     * @param options Опции создания и индексации
-     * @param {string} [options.name] Имя проекта (если не указано, будет получено из пути)
-     * @param {boolean} [options.forceFull=false] Принудительная полная индексация
-     * @param {string} [options.indexingMode] Режим индексации: 'full', 'incremental', 'auto'
-     * @param {string[]} [options.includePatterns] Паттерны для включения файлов
-     * @param {string[]} [options.excludePatterns] Паттерны для исключения файлов
-     * @returns Информация о созданном проекте и начатой индексации
-     */
-    async createAndIndexProject(path, options = {}) {
-        try {
-            // Преобразуем indexingMode в forceFull для совместимости с бэкендом
-            let requestOptions = {
-                name: options.name,
-                excludePatterns: options.excludePatterns
-            };
-            if (options.indexingMode === 'full' || options.forceFull) {
-                requestOptions.forceFull = true;
-            }
-            if (options.includePatterns) {
-                requestOptions.includePatterns = options.includePatterns;
-            }
-            // Используем API для индексации по пути, который также создает проект если его нет
-            const result = await this.indexProjectByPath(path, requestOptions);
-            // Проверяем, что результат содержит нужные поля
-            if (!result || !result.projectId) {
-                throw new Error('Сервер вернул некорректный ответ без идентификатора проекта');
-            }
-            return {
-                projectId: result.projectId,
-                indexingStatus: result.status || 'indexing'
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new Error(`Не удалось создать и проиндексировать проект: ${errorMessage}`);
-        }
-    }
-    /**
-     * Проверяет существование проекта и создает резервную копию при необходимости
-     * @param projectId ID проекта для проверки
-     * @param options Опции для создания резервной копии
-     * @returns Существующий проект или созданную резервную копию
-     */
-    async ensureProjectExists(projectId, options = {}) {
         try {
-            this.validateProjectId(projectId);
-            // Пытаемся получить проект по ID
-            try {
-                const project = await this.getProject(projectId);
-                return project;
-            }
-            catch (error) {
-                // Проверяем, нужно ли создавать резервную копию
-                if (!options.createBackup) {
-                    // Если резервная копия не требуется, пробрасываем ошибку
-                    const errorMessage = error instanceof Error ? error.message : String(error);
-                    throw new Error(`Проект с ID ${projectId} не найден: ${errorMessage}`);
-                }
-                // Проверяем наличие пути для резервной копии
-                if (!options.backupPath) {
-                    throw new Error('Для создания резервной копии необходимо указать путь (backupPath)');
-                }
-                const backupName = options.backupName || `Резервная копия для ${projectId}`;
-                // Создаем новый проект как резервную копию
-                console.log(`[ProjectsApi] Создание резервной копии проекта ${projectId} с именем "${backupName}" по пути ${options.backupPath}`);
-                return await this.createProject(backupName, options.backupPath);
-            }
+            await this.httpClient.post(`/api/v1/projects/${projectId}/cancel-indexing`);
+            return true;
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new Error(`Ошибка при проверке/создании проекта ${projectId}: ${errorMessage}`);
+            console.error('Failed to cancel indexing:', error);
+            return false;
         }
     }
     /**
-     * Получает или создает проект по пути с расширенными опциями
-     * @param path Путь к проекту
-     * @param options Дополнительные опции
-     * @returns Найденный или созданный проект
+     * Очищает ошибку индексации
      */
-    async getOrCreateProjectByPath(path, options = {}) {
-        if (!path) {
-            throw new Error('Путь к проекту не может быть пустым');
-        }
-        const normalizedPath = path.replace(/\\/g, '/').replace(/\/$/, '');
+    async clearIndexingError(projectId) {
+        this.validateProjectId(projectId);
         try {
-            // Сначала проверяем кэш
-            const cachedProjectId = this.getCachedProjectId(normalizedPath);
-            if (cachedProjectId && options.preferExisting !== false) {
-                try {
-                    const project = await this.getProject(cachedProjectId);
-                    return project;
-                }
-                catch (error) {
-                    // Если ошибка - продолжаем с API запросом
-                    console.warn(`[ProjectsApi] Не удалось получить проект из кэша: ${error instanceof Error ? error.message : String(error)}`);
-                }
-            }
-            // Если проект не найден в кэше или не смогли его получить, создаем новый через стандартный API
-            const project = await this.httpClient.post('/api/v1/projects', {
-                path: normalizedPath,
-                name: options.name || normalizedPath.split('/').pop() || 'Unnamed Project'
-            });
-            // Кэшируем полученный проект
-            if (project && project.id) {
-                this.cacheProjectId(normalizedPath, project.id);
-            }
-            return project;
+            await this.httpClient.post(`/api/v1/projects/${projectId}/clear-error`);
+            return true;
         }
         catch (error) {
-            throw new Error(`Не удалось получить или создать проект: ${error.message}`);
+            console.error('Failed to clear indexing error:', error);
+            return false;
         }
     }
     // ===== DELTA CHUNKING МЕТОДЫ =====
     /**
      * Инициализация синхронизации проекта для Delta Chunking
-     * @param projectId ID проекта
-     * @param request Данные для инициализации синхронизации
-     * @returns Результат инициализации с needsSync и опциональным sessionId
      */
     async sendInitialSync(projectId, request) {
         this.validateProjectId(projectId);
         const response = await this.httpClient.post(`/api/v1/projects/${projectId}/sync-init`, request);
-        // ✅ ИСПРАВЛЕНО: Проверяем sessionId только если needsSync = true
         if (response.needsSync && !response.sessionId) {
             throw new Error('Server did not return sessionId when sync is needed');
         }
@@ -580,9 +136,6 @@ export class ProjectsApi {
     }
     /**
      * Отправка батча зашифрованных чанков для Delta Chunking
-     * @param projectId ID проекта
-     * @param batchRequest Батч зашифрованных чанков
-     * @returns Результат обработки батча
      */
     async sendDeltaSync(projectId, batchRequest) {
         this.validateProjectId(projectId);
@@ -591,8 +144,6 @@ export class ProjectsApi {
     }
     /**
      * Получение статуса синхронизации Delta Chunking
-     * @param projectId ID проекта
-     * @returns Текущий статус синхронизации
      */
     async getDeltaSyncStatus(projectId) {
         this.validateProjectId(projectId);
@@ -613,13 +164,10 @@ export class ProjectsApi {
     }
     /**
      * Завершение синхронизации Delta Chunking
-     * @param projectId ID проекта
-     * @returns Результат завершения синхронизации
      */
     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,
@@ -633,88 +181,39 @@ export class ProjectsApi {
     }
     /**
      * Отмена синхронизации Delta Chunking
-     * @param projectId ID проекта
-     * @returns Результат отмены
      */
     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,
+            success: response.success !== false,
             message: response.message
         };
     }
+    // ===== PROJECT STATE И SMART SYNC =====
     /**
-     * 🔍 Получить состояние проекта без инициализации синхронизации
-     *
-     * Проверяет текущее состояние проекта на сервере. Если передан clientRootHash,
-     * дополнительно проверяет нужна ли синхронизация.
-     *
-     * @param projectId ID проекта
-     * @param clientRootHash (опционально) Merkle root hash клиента для проверки sync
-     * @returns Состояние проекта
-     *
-     * @example
-     * ```typescript
-     * // Проверка только состояния проекта
-     * const state = await sdk.projects.getProjectState(projectId);
-     * console.log(`Проект "${state.projectName}" содержит ${state.totalChunks} чанков`);
-     *
-     * // Проверка нужна ли синхронизация
-     * const clientHash = await computeMerkleRootHash(workspacePath);
-     * const stateWithSync = await sdk.projects.getProjectState(projectId, clientHash);
-     *
-     * if (stateWithSync.syncRequired) {
-     *   console.log("Требуется синхронизация");
-     *   await sdk.projects.initializeDeltaSync(projectId, clientHash);
-     * } else {
-     *   console.log("Проект актуален, синхронизация не нужна");
-     * }
-     * ```
+     * Получение состояния проекта с проверкой синхронизации
      */
     async getProjectState(projectId, clientRootHash) {
         this.validateProjectId(projectId);
-        const params = clientRootHash ? { clientRootHash } : {};
-        const response = await this.httpClient.get(`/api/v1/projects/${projectId}/state`, params);
-        // Конвертируем даты из строк в Date объекты
+        const url = clientRootHash
+            ? `/api/v1/projects/${projectId}/state?clientRootHash=${encodeURIComponent(clientRootHash)}`
+            : `/api/v1/projects/${projectId}/state`;
+        const response = await this.httpClient.get(url);
         return {
-            projectId: response.projectId,
-            projectName: response.projectName,
-            merkleRootHash: response.merkleRootHash,
+            projectId: response.projectId || projectId,
+            projectName: response.projectName || 'Unknown',
+            merkleRootHash: response.merkleRootHash || null,
             lastIndexedAt: response.lastIndexedAt ? new Date(response.lastIndexedAt) : null,
             totalChunks: response.totalChunks || 0,
-            indexingStatus: response.indexingStatus,
+            indexingStatus: response.indexingStatus || 'unknown',
             syncRequired: response.syncRequired,
             lastSyncSessionId: response.lastSyncSessionId
         };
     }
+    // ===== SESSION RECOVERY =====
     /**
-     * 🔄 Проверить есть ли прерванные сессии синхронизации для проекта
-     *
-     * Используется при открытии проекта для показа пользователю опции
-     * "Continue indexing" если есть незавершенная синхронизация.
-     *
-     * @param projectId ID проекта
-     * @returns Статус восстановления с информацией о прерванной сессии
-     *
-     * @example
-     * ```typescript
-     * // Проверка при открытии проекта
-     * const recoveryStatus = await sdk.projects.getRecoveryStatus(projectId);
-     *
-     * if (recoveryStatus.hasInterruptedSession) {
-     *   // Показать UI: "Continue indexing" button
-     *   const info = recoveryStatus.recoveryInfo!;
-     *   console.log(`Прерванная синхронизация: ${info.progress.percentage}% завершено`);
-     *
-     *   // Пользователь нажал "Continue"
-     *   const resumed = await sdk.projects.resumeSync(projectId);
-     * } else {
-     *   // Обычная синхронизация
-     *   await sdk.projects.initializeDeltaSync(projectId, merkleHash);
-     * }
-     * ```
+     * Получение статуса восстановления сессии
      */
     async getRecoveryStatus(projectId) {
         this.validateProjectId(projectId);
@@ -723,228 +222,117 @@ export class ProjectsApi {
             hasInterruptedSession: response.hasInterruptedSession || false,
             recoveryInfo: response.recoveryInfo ? {
                 sessionId: response.recoveryInfo.sessionId,
-                projectId: response.recoveryInfo.projectId,
-                projectName: response.recoveryInfo.projectName,
-                status: response.recoveryInfo.status,
-                progress: response.recoveryInfo.progress,
-                interruptedAt: response.recoveryInfo.interruptedAt ?
-                    new Date(response.recoveryInfo.interruptedAt) : null,
-                canResume: response.recoveryInfo.canResume,
-                resumeReason: response.recoveryInfo.resumeReason,
-                estimatedTimeRemaining: response.recoveryInfo.estimatedTimeRemaining,
-            } : undefined,
+                projectId: response.recoveryInfo.projectId || projectId,
+                projectName: response.recoveryInfo.projectName || 'Unknown',
+                status: response.recoveryInfo.status || 'interrupted',
+                progress: {
+                    received: response.recoveryInfo.progress?.totalChunks || 0,
+                    processed: response.recoveryInfo.progress?.processedChunks || 0,
+                    total: response.recoveryInfo.progress?.totalChunks || 0,
+                    percentage: response.recoveryInfo.progress?.percentage || 0
+                },
+                interruptedAt: response.recoveryInfo.lastActivity ? new Date(response.recoveryInfo.lastActivity) : new Date(),
+                resumeReason: response.recoveryInfo.resumeReason || 'session_recovery',
+                canResume: response.recoveryInfo.canResume !== false
+            } : undefined
         };
     }
     /**
-     * 🔄 Возобновить прерванную сессию синхронизации
-     *
-     * Подготавливает прерванную сессию к возобновлению. После успешного
-     * вызова клиент может продолжить отправку чанков через обычный endpoint.
-     *
-     * @param projectId ID проекта
-     * @param options Опции возобновления (форсировать, пропустить дубликаты, etc.)
-     * @returns Результат возобновления с информацией для продолжения
-     *
-     * @example
-     * ```typescript
-     * // Возобновить с настройками по умолчанию
-     * const resumed = await sdk.projects.resumeSync(projectId);
-     *
-     * if (resumed.success) {
-     *   console.log(`Сессия ${resumed.sessionId} готова к возобновлению`);
-     *
-     *   // Продолжить отправку чанков с определенного батча
-     *   if (resumed.continueFromBatch) {
-     *     console.log(`Начать с батча ${resumed.continueFromBatch}`);
-     *   }
-     *
-     *   // Использовать обычный endpoint для отправки
-     *   await sdk.deltaChunking.sendBatch(projectId, chunks);
-     * }
-     *
-     * // Возобновить с принудительными настройками
-     * const forced = await sdk.projects.resumeSync(projectId, {
-     *   forceResume: true,
-     *   skipDuplicates: true,
-     *   continueFromLastBatch: true
-     * });
-     * ```
+     * Восстановление прерванной синхронизации
      */
     async resumeSync(projectId, options = {}) {
         this.validateProjectId(projectId);
-        const response = await this.httpClient.post(`/api/v1/projects/${projectId}/resume-sync`, options);
+        const response = await this.httpClient.post(`/api/v1/projects/${projectId}/resume-sync`, {
+            skipDuplicates: options.skipDuplicates !== false,
+            continueFromLastBatch: options.continueFromLastBatch !== false
+        });
         return {
-            success: response.success || false,
-            message: response.message || '',
-            sessionId: response.sessionId,
+            success: response.success !== false,
+            message: response.message,
             continueFromBatch: response.continueFromBatch,
-            resumeEndpoint: response.resumeEndpoint,
+            sessionId: response.sessionId
         };
     }
     /**
-     * 🗑️ Отменить прерванную сессию восстановления
-     *
-     * Отменяет прерванную сессию если пользователь решил не восстанавливать
-     * синхронизацию. После этого будет выполнена обычная полная синхронизация.
-     *
-     * @param projectId ID проекта
-     * @returns Результат отмены
-     *
-     * @example
-     * ```typescript
-     * // Пользователь нажал "Start fresh" вместо "Continue"
-     * const cancelled = await sdk.projects.cancelRecovery(projectId);
-     *
-     * if (cancelled.success) {
-     *   console.log('Прерванная сессия отменена, начинаем полную синхронизацию');
-     *   await sdk.projects.initializeDeltaSync(projectId, newMerkleHash);
-     * }
-     * ```
+     * Отмена восстановления сессии
      */
     async cancelRecovery(projectId) {
         this.validateProjectId(projectId);
-        const response = await this.httpClient.delete(`/api/v1/projects/${projectId}/cancel-recovery`);
+        const response = await this.httpClient.delete(`/api/v1/projects/${projectId}/recovery`);
         return {
-            success: response.success || false,
-            message: response.message || '',
+            success: response.success !== false,
+            message: response.message
         };
     }
     /**
-     * 🚀 Инициализировать Delta-Chunking синхронизацию
-     *
-     * Начинает новую сессию синхронизации с использованием delta-chunking.
-     * Алиас для удобства - делегирует к DeltaChunkingManager.
-     *
-     * @param projectId ID проекта
-     * @param clientRootHash Merkle root hash клиента
-     * @returns Результат инициализации
-     *
-     * @example
-     * ```typescript
-     * const merkleHash = await computeMerkleRootHash(workspacePath);
-     * const result = await sdk.projects.initializeDeltaSync(projectId, merkleHash);
-     *
-     * if (result.needsSync) {
-     *   console.log(`Started sync session: ${result.sessionId}`);
-     *   // Продолжить отправку чанков...
-     * } else {
-     *   console.log('Project is up to date');
-     * }
-     * ```
+     * Инициализация Delta Sync
      */
     async initializeDeltaSync(projectId, clientRootHash) {
         this.validateProjectId(projectId);
-        // Делегируем к DeltaChunkingApi
-        const deltaApi = new (await import('./delta-chunking-api.js')).DeltaChunkingApi(this.httpClient);
-        return await deltaApi.initSync(projectId, { clientRootHash });
+        if (!clientRootHash?.trim()) {
+            throw new Error('Client root hash is required');
+        }
+        const response = await this.httpClient.post(`/api/v1/projects/${projectId}/initialize-delta-sync`, {
+            clientRootHash: clientRootHash.trim()
+        });
+        return {
+            needsSync: response.needsSync !== false,
+            sessionId: response.sessionId,
+            lastSyncHash: response.lastSyncHash
+        };
     }
     /**
-     * 🔄 Сбросить индексацию проекта (очистить данные, сохранить проект)
-     *
-     * Очищает все проиндексированные данные, но сохраняет сам проект:
-     * - Удаляет все векторы из Qdrant
-     * - Удаляет все chunks из PostgreSQL
-     * - Удаляет сессии синхронизации
-     * - Сбрасывает статус индексации
-     *
-     * @param projectId ID проекта
-     * @returns Результат сброса с статистикой
-     *
-     * @example
-     * ```typescript
-     * // Сброс индексации (проект остается)
-     * const result = await sdk.projects.resetIndexing(projectId);
-     *
-     * console.log(`Cleared: ${result.clearedData.vectorsDeleted} vectors, ${result.clearedData.chunksDeleted} chunks`);
-     *
-     * // После сброса можно начать новую индексацию
-     * const merkleHash = await computeMerkleRootHash(workspacePath);
-     * await sdk.projects.initializeDeltaSync(projectId, merkleHash);
-     * ```
+     * Сброс индексации проекта
      */
     async resetIndexing(projectId) {
         this.validateProjectId(projectId);
         const response = await this.httpClient.post(`/api/v1/projects/${projectId}/reset-indexing`);
         return {
-            success: response.success || false,
-            message: response.message || '',
-            clearedData: response.clearedData || {
-                vectorsDeleted: 0,
-                chunksDeleted: 0,
-                sessionsDeleted: 0
-            }
+            success: response.success !== false,
+            message: response.message || 'Reset completed',
+            clearedChunks: response.clearedChunks,
+            clearedFiles: response.clearedFiles
         };
     }
     /**
-     * 🔄 Перезапустить индексацию проекта (сброс + подготовка к новой)
-     *
-     * Выполняет полный перезапуск индексации:
-     * 1. Очищает все существующие данные
-     * 2. Сбрасывает статус проекта
-     * 3. Подготавливает к новой синхронизации
-     *
-     * @param projectId ID проекта
-     * @returns Результат перезапуска
-     *
-     * @example
-     * ```typescript
-     * // Перезапуск индексации
-     * const result = await sdk.projects.restartIndexing(projectId);
-     *
-     * if (result.readyForNewSync) {
-     *   console.log('Project ready for new indexing');
-     *
-     *   // Начать новую синхронизацию
-     *   const merkleHash = await computeMerkleRootHash(workspacePath);
-     *   await sdk.projects.initializeDeltaSync(projectId, merkleHash);
-     * }
-     * ```
+     * Перезапуск индексации проекта
      */
     async restartIndexing(projectId) {
         this.validateProjectId(projectId);
         const response = await this.httpClient.post(`/api/v1/projects/${projectId}/restart-indexing`);
         return {
-            success: response.success || false,
-            message: response.message || '',
-            resetData: response.resetData || {
-                vectorsDeleted: 0,
-                chunksDeleted: 0,
-                sessionsDeleted: 0
-            },
-            readyForNewSync: response.readyForNewSync || false
+            success: response.success !== false,
+            message: response.message || 'Restart initiated',
+            newSessionId: response.newSessionId
         };
     }
     /**
-     * 🔍 Получить соответствие обфусцированных путей файлов
-     *
-     * Возвращает список obfuscatedPath для всех файлов проекта.
-     * Используется для точной очистки удаленных файлов.
-     *
-     * @param projectId ID проекта
-     * @returns Mapping обфусцированных путей
-     *
-     * @example
-     * ```typescript
-     * const mapping = await sdk.projects.getFilePathMapping(projectId);
-     * console.log(`Найдено ${mapping.files.length} файлов в проекте`);
-     *
-     * mapping.files.forEach(file => {
-     *   console.log(`${file.obfuscatedPath}: ${file.chunkCount} чанков`);
-     * });
-     * ```
+     * Получение маппинга файловых путей
      */
     async getFilePathMapping(projectId) {
         this.validateProjectId(projectId);
         const response = await this.httpClient.get(`/api/v1/projects/${projectId}/file-path-mapping`);
-        // Конвертируем даты из строк в Date объекты
         return {
-            success: response.success,
-            files: response.files.map((file) => ({
-                obfuscatedPath: file.obfuscatedPath,
-                chunkCount: file.chunkCount,
-                lastUpdated: new Date(file.lastUpdated)
-            }))
+            success: response.success !== false,
+            mapping: response.mapping || [],
+            totalFiles: response.totalFiles || 0
         };
     }
+    // ===== УТИЛИТЫ =====
+    /**
+     * Валидация 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=projects-api.js.map