solver-sdk 6.0.0 → 6.0.2

package/dist/types/api/projects-api.d.ts

@@ -1,336 +1,64 @@
 import { HttpClient } from '../utils/http-client.js';
-import { Project, FileIndexResponse, ProjectState, RecoveryInfo, // 🔄 NEW
-ResumeOptions } from '../types/index.js';
+import { Project, ProjectOptions, ProjectState, RecoveryInfo, ResumeOptions } from '../types/index.js';
 import { SyncInitRequest, DeltaChunksBatchRequest, SyncStatus, SyncResult, FilePathMapping } from '../types/delta-chunking.js';
-declare global {
-    var solverSdkProjectCache: Record<string, string> | undefined;
-}
-/**
- * Константы для API путей
- */
-export declare enum ApiEndpoints {
-    PROJECTS = "/api/v1/projects",
-    PROJECT = "/api/v1/projects/:id",
-    PROJECT_INDEXING_STATUS = "/api/v1/projects/:id/indexing_status",
-    PROJECT_CANCEL_INDEXING = "/api/v1/projects/:id/cancel_indexing",
-    PROJECT_CLEAR_ERROR = "/api/v1/projects/:id/clear_error"
-}
 /**
  * API для работы с проектами
  */
 export declare class ProjectsApi {
-    /** HTTP клиент для выполнения запросов */
     private readonly httpClient;
-    /**
-     * Создает новый экземпляр API для работы с проектами
-     * @param {HttpClient} httpClient HTTP клиент
-     */
     constructor(httpClient: HttpClient);
     /**
-     * Проверяет валидность идентификатора проекта
-     * @param {string} projectId ID проекта
-     * @throws {Error} Если ID проекта не валиден
-     */
-    private validateProjectId;
-    /**
-     * Получает список всех проектов с полной информацией
-     *
-     * @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} Если не удалось получить проекты или сервер вернул ошибку
+     * Получает все проекты пользователя
      */
     getAllProjects(): Promise<Project[]>;
     /**
-     * Псевдоним для getAllProjects() для совместимости с тестами
-     *
-     * @returns {Promise<Project[]>} Массив проектов пользователя
+     * Альтернативное имя для getAllProjects() для совместимости
      */
     getProjects(): Promise<Project[]>;
     /**
-     * Находит существующий проект или создает новый
-     * Для совместимости с интеграционными тестами
-     *
-     * @param {string} projectPath Путь к проекту (для совместимости)
-     * @param {string} projectName Имя проекта
-     * @param {string} [description] Описание проекта
-     * @returns {Promise<Project>} Найденный или созданный проект
+     * Находит или создает проект по имени
      */
-    findOrCreateProject(projectPath: string, projectName: string, description?: string): Promise<Project>;
+    findOrCreateProject(projectName: string): Promise<Project>;
     /**
-     * Получает список готовых к работе проектов
-     * @returns {Promise<Project[]>} Список готовых проектов
+     * Получает проекты, готовые к использованию
      */
     getReadyProjects(): Promise<Project[]>;
     /**
-     * Получает детальную информацию о проекте по его 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
      */
     getProject(projectId: string): Promise<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} Если путь недоступен, проект не может быть создан, или ошибка сервера
+     * Создает новый проект
      */
-    createProject(name: string, path: string, data?: any): Promise<Project>;
+    createProject(name: string, data?: any, options?: ProjectOptions): Promise<Project>;
+    /**
+     * Удаляет проект
+     */
+    deleteProject(projectId: string): Promise<void>;
     /**
      * Получает статус проекта
-     * @param {string} projectId ID проекта
-     * @returns {Promise<any>} Статус проекта
      */
     getProjectStatus(projectId: string): Promise<any>;
     /**
      * Запускает индексацию проекта
-     * @param {string} projectId ID проекта
-     * @param {any} options Опции индексации
-     * @returns {Promise<any>} Результат запуска индексации
      */
     startIndexing(projectId: string, options?: {
         force?: boolean;
     }): Promise<any>;
     /**
-     * Удаляет проект
-     * @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('✅ Проект полностью удален');
-     * }
-     * ```
-     */
-    deleteProject(projectId: string): Promise<{
-        success: boolean;
-        message?: string;
-    }>;
-    /**
-     * Получает текущий статус индексации проекта (единичный запрос)
-     *
-     * ⚠️ ВАЖНО: Для 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)
+     * Получает статус индексации проекта
      */
     getIndexingStatus(projectId: string): Promise<any>;
     /**
      * Отменяет индексацию проекта
-     * @param {string} projectId Идентификатор проекта
-     * @returns {Promise<boolean>} Результат отмены индексации
      */
     cancelIndexing(projectId: string): Promise<boolean>;
     /**
-     * Останавливает индексацию проекта (алиас для cancelIndexing)
-     * @param {string} projectId Идентификатор проекта
-     * @returns {Promise<boolean>} Результат остановки индексации
-     */
-    stopIndexing(projectId: string): Promise<boolean>;
-    /**
-     * Очищает ошибку индексации проекта
-     * @param {string} projectId Идентификатор проекта
-     * @returns {Promise<boolean>} Результат очистки ошибки
+     * Очищает ошибку индексации
      */
     clearIndexingError(projectId: string): Promise<boolean>;
-    /**
-     * Обновляет индекс конкретного файла в проекте
-     * @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>} Информация об обновленном индексе файла
-     */
-    updateFileIndex(projectId: string, filePath: string, options?: {
-        content?: string;
-        force?: boolean;
-        language?: string;
-        updateDependencies?: boolean;
-    }): Promise<FileIndexResponse>;
-    /**
-     * Кэширует соответствие пути и ID проекта
-     * @param path Путь к проекту
-     * @param projectId ID проекта
-     * @private
-     */
-    private cacheProjectId;
-    /**
-     * Получает ID проекта из кэша
-     * @param path Путь к проекту
-     * @returns ID проекта или null, если не найдено
-     * @private
-     */
-    private getCachedProjectId;
-    /**
-     * Получает или создает проект по пути
-     * @param path Путь к проекту
-     * @param name Имя проекта (опционально, если не указано - будет сгенерировано из пути)
-     * @returns Данные проекта
-     */
-    getOrCreateProject(path: string, name?: string): Promise<Project>;
-    /**
-     * Индексирует проект по указанному пути
-     * @param path Путь к проекту
-     * @param options Опции индексации
-     * @returns Результат операции индексации
-     */
-    indexProjectByPath(path: string, options?: {
-        name?: string;
-        forceFull?: boolean;
-        excludePatterns?: string[];
-    }): Promise<{
-        success: boolean;
-        status: string;
-        projectId: string;
-    }>;
-    /**
-     * Создание и индексация проекта в одной операции
-     * @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 Информация о созданном проекте и начатой индексации
-     */
-    createAndIndexProject(path: string, options?: {
-        name?: string;
-        forceFull?: boolean;
-        indexingMode?: 'full' | 'incremental' | 'auto';
-        includePatterns?: string[];
-        excludePatterns?: string[];
-    }): Promise<{
-        projectId: string;
-        indexingStatus: string;
-    }>;
-    /**
-     * Проверяет существование проекта и создает резервную копию при необходимости
-     * @param projectId ID проекта для проверки
-     * @param options Опции для создания резервной копии
-     * @returns Существующий проект или созданную резервную копию
-     */
-    ensureProjectExists(projectId: string, options?: {
-        createBackup?: boolean;
-        backupPath?: string;
-        backupName?: string;
-    }): Promise<Project>;
-    /**
-     * Получает или создает проект по пути с расширенными опциями
-     * @param path Путь к проекту
-     * @param options Дополнительные опции
-     * @returns Найденный или созданный проект
-     */
-    getOrCreateProjectByPath(path: string, options?: {
-        name?: string;
-        preferExisting?: boolean;
-        indexingTimeout?: number;
-        maxFileSize?: number;
-    }): Promise<Project>;
     /**
      * Инициализация синхронизации проекта для Delta Chunking
-     * @param projectId ID проекта
-     * @param request Данные для инициализации синхронизации
-     * @returns Результат инициализации с needsSync и опциональным sessionId
      */
     sendInitialSync(projectId: string, request: SyncInitRequest): Promise<{
         needsSync: boolean;
@@ -339,9 +67,6 @@ export declare class ProjectsApi {
     }>;
     /**
      * Отправка батча зашифрованных чанков для Delta Chunking
-     * @param projectId ID проекта
-     * @param batchRequest Батч зашифрованных чанков
-     * @returns Результат обработки батча
      */
     sendDeltaSync(projectId: string, batchRequest: DeltaChunksBatchRequest): Promise<{
         processed: number;
@@ -350,173 +75,48 @@ export declare class ProjectsApi {
     }>;
     /**
      * Получение статуса синхронизации Delta Chunking
-     * @param projectId ID проекта
-     * @returns Текущий статус синхронизации
      */
     getDeltaSyncStatus(projectId: string): Promise<SyncStatus>;
     /**
      * Завершение синхронизации Delta Chunking
-     * @param projectId ID проекта
-     * @returns Результат завершения синхронизации
      */
     finalizeDeltaSync(projectId: string): Promise<SyncResult>;
     /**
      * Отмена синхронизации Delta Chunking
-     * @param projectId ID проекта
-     * @returns Результат отмены
      */
     cancelDeltaSync(projectId: string): Promise<{
         success: boolean;
         message?: string;
     }>;
     /**
-     * 🔍 Получить состояние проекта без инициализации синхронизации
-     *
-     * Проверяет текущее состояние проекта на сервере. Если передан 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("Проект актуален, синхронизация не нужна");
-     * }
-     * ```
+     * Получение состояния проекта с проверкой синхронизации
      */
     getProjectState(projectId: string, clientRootHash?: string): Promise<ProjectState>;
     /**
-     * 🔄 Проверить есть ли прерванные сессии синхронизации для проекта
-     *
-     * Используется при открытии проекта для показа пользователю опции
-     * "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);
-     * }
-     * ```
+     * Получение статуса восстановления сессии
      */
     getRecoveryStatus(projectId: string): Promise<{
         hasInterruptedSession: boolean;
         recoveryInfo?: RecoveryInfo;
     }>;
     /**
-     * 🔄 Возобновить прерванную сессию синхронизации
-     *
-     * Подготавливает прерванную сессию к возобновлению. После успешного
-     * вызова клиент может продолжить отправку чанков через обычный 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
-     * });
-     * ```
+     * Восстановление прерванной синхронизации
      */
     resumeSync(projectId: string, options?: ResumeOptions): Promise<{
         success: boolean;
-        message: string;
-        sessionId?: string;
+        message?: string;
         continueFromBatch?: number;
-        resumeEndpoint?: string;
+        sessionId?: string;
     }>;
     /**
-     * 🗑️ Отменить прерванную сессию восстановления
-     *
-     * Отменяет прерванную сессию если пользователь решил не восстанавливать
-     * синхронизацию. После этого будет выполнена обычная полная синхронизация.
-     *
-     * @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);
-     * }
-     * ```
+     * Отмена восстановления сессии
      */
     cancelRecovery(projectId: string): Promise<{
         success: boolean;
-        message: string;
+        message?: string;
     }>;
     /**
-     * 🚀 Инициализировать 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
      */
     initializeDeltaSync(projectId: string, clientRootHash: string): Promise<{
         needsSync: boolean;
@@ -524,95 +124,34 @@ export declare class ProjectsApi {
         lastSyncHash?: string;
     }>;
     /**
-     * 🔄 Сбросить индексацию проекта (очистить данные, сохранить проект)
-     *
-     * Очищает все проиндексированные данные, но сохраняет сам проект:
-     * - Удаляет все векторы из 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);
-     * ```
+     * Сброс индексации проекта
      */
     resetIndexing(projectId: string): Promise<{
         success: boolean;
         message: string;
-        clearedData: {
-            vectorsDeleted: number;
-            chunksDeleted: number;
-            sessionsDeleted: number;
-        };
+        clearedChunks?: number;
+        clearedFiles?: number;
     }>;
     /**
-     * 🔄 Перезапустить индексацию проекта (сброс + подготовка к новой)
-     *
-     * Выполняет полный перезапуск индексации:
-     * 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);
-     * }
-     * ```
+     * Перезапуск индексации проекта
      */
     restartIndexing(projectId: string): Promise<{
         success: boolean;
         message: string;
-        resetData: {
-            vectorsDeleted: number;
-            chunksDeleted: number;
-            sessionsDeleted: number;
-        };
-        readyForNewSync: boolean;
+        newSessionId?: string;
     }>;
     /**
-     * 🔍 Получить соответствие обфусцированных путей файлов
-     *
-     * Возвращает список 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} чанков`);
-     * });
-     * ```
+     * Получение маппинга файловых путей
      */
     getFilePathMapping(projectId: string): Promise<{
         success: boolean;
-        files: FilePathMapping[];
+        mapping: FilePathMapping[];
+        totalFiles: number;
     }>;
+    /**
+     * Валидация ID проекта
+     * @private
+     */
+    private validateProjectId;
 }
 //# sourceMappingURL=projects-api.d.ts.map