solver-sdk 3.1.2 → 3.1.3

package/README.md

@@ -1,4 +1,4 @@
-# Code Solver SDK v3.1.2
+# Code Solver SDK v3.1.3
 
 > **JavaScript/TypeScript SDK для VS Code Extensions**  
 > Подключение к AI бэкенду для индексации, поиска и работы с кодом
@@ -229,7 +229,7 @@ const sdk = await CodeSolverSDK.create({
 });
 ```
 
-## 📝 Changelog v3.1.2
+## 📝 Changelog v3.1.3
 
 ### ✅ Добавлено
 - Поиск функций через `/search/functions` API
@@ -244,6 +244,7 @@ const sdk = await CodeSolverSDK.create({
 - `simple-indexing-client.ts` - дублировал ProjectsApi
 - Все устаревшие методы и примеры
 - Ручной выбор модели и лимитов токенов клиентом
+- **Папка docs/** - удалена вся неактуальная документация
 
 ### 🔄 Изменено
 - Обновлены все примеры кода на актуальный синтаксис
@@ -252,6 +253,7 @@ const sdk = await CodeSolverSDK.create({
 - Улучшена обработка ошибок индексации
 - Chat API упрощен - модель выбирается автоматически
 - Полная синхронизация документации с реальным кодом
+- **Один README.md** содержит всю необходимую информацию
 
 ## 📄 Лицензия
 
@@ -383,7 +385,7 @@ export async function activate(context: vscode.ExtensionContext) {
       { "command": "extension.searchFunctions", "title": "🔍 Поиск функций" }
     ]
   },
-  "dependencies": { "solver-sdk": "^3.1.2" }
+  "dependencies": { "solver-sdk": "^3.1.3" }
 }
 ```
 

package/dist/cjs/code-solver-sdk.js

@@ -10,7 +10,7 @@ const code_modification_api_js_1 = require("./api/code-modification-api.js");
 const index_js_1 = require("./api/chat-api/index.js");
 const models_api_js_1 = require("./api/models-api.js");
 // Версия SDK
-const SDK_VERSION = '3.1.2';
+const SDK_VERSION = '3.1.3';
 /**
  * Определение типа среды выполнения
  * @returns 'browser' | 'node' | 'unknown'

package/dist/cjs/index.js

@@ -20,7 +20,7 @@ Object.defineProperty(exports, "CodeSolverSDK", { enumerable: true, get: functio
 const http_client_js_1 = require("./utils/http-client.js");
 Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_client_js_1.HttpClient; } });
 // Версия SDK
-exports.VERSION = '3.1.2';
+exports.VERSION = '3.1.3';
 // Экспортируем основные интерфейсы и типы
 __exportStar(require("./interfaces/sdk-options.js"), exports);
 // Экспортируем HTTP API клиенты

package/dist/esm/code-solver-sdk.js

@@ -7,7 +7,7 @@ import { CodeModificationApi } from './api/code-modification-api.js';
 import { ChatApi } from './api/chat-api/index.js';
 import { ModelsApi } from './api/models-api.js';
 // Версия SDK
-const SDK_VERSION = '3.1.2';
+const SDK_VERSION = '3.1.3';
 /**
  * Определение типа среды выполнения
  * @returns 'browser' | 'node' | 'unknown'

package/dist/esm/index.js

@@ -1,7 +1,7 @@
 import { CodeSolverSDK } from './code-solver-sdk.js';
 import { HttpClient } from './utils/http-client.js';
 // Версия SDK
-export const VERSION = '3.1.2';
+export const VERSION = '3.1.3';
 // Экспортируем основные классы и интерфейсы
 export { CodeSolverSDK };
 export { HttpClient };

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 import { CodeSolverSDK } from './code-solver-sdk.js';
 import { CodeSolverSDKOptions } from './interfaces/sdk-options.js';
 import { HttpClient } from './utils/http-client.js';
-export declare const VERSION = "3.1.2";
+export declare const VERSION = "3.1.3";
 export { CodeSolverSDK };
 export { CodeSolverSDKOptions };
 export { HttpClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solver-sdk",
-  "version": "3.1.2",
+  "version": "3.1.3",
   "description": "SDK для интеграции с Code Solver Backend API",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -24,8 +24,7 @@
   "files": [
     "dist/**/*",
     "README.md",
-    "LICENSE",
-    "docs/**/*"
+    "LICENSE"
   ],
   "scripts": {
     "clean": "rimraf dist",

package/docs/AUTHENTICATION.md

@@ -1,316 +0,0 @@
-# Аутентификация v2.5.0
-
-Документация по аутентификации в AI Solver SDK v2.5.0.
-
-## API ключи
-
-AI Solver использует API ключи для аутентификации. Ключи имеют специальные префиксы:
-
-### Форматы ключей
-
-```
-dev_sk_test_12345678    # Development key (для разработки)
-sk_prod_1234567890abcd  # Production key (для продакшна)
-sk_temp_abcdef123456    # Temporary key (временный)
-```
-
-## Получение API ключа
-
-### Development ключ
-
-Для локальной разработки используйте тестовый ключ:
-
-```
-dev_sk_test_12345678
-```
-
-### Production ключ
-
-1. Зарегистрируйтесь на платформе AI Solver
-2. Перейдите в настройки аккаунта
-3. Создайте новый Production API ключ
-4. Сохраните ключ в безопасном месте
-
-## Использование API ключа
-
-### Рекомендуемый способ (v2.5.0)
-
-```javascript
-import { CodeSolverSDK } from '@ai-solver/sdk';
-
-const sdk = CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000',
-  apiKey: 'dev_sk_test_12345678'
-});
-```
-
-### Через переменные окружения
-
-```bash
-# Development
-export AI_SOLVER_API_KEY=dev_sk_test_12345678
-
-# Production
-export AI_SOLVER_API_KEY=sk_prod_1234567890abcd
-```
-
-```javascript
-import { CodeSolverSDK } from '@ai-solver/sdk';
-
-const sdk = CodeSolverSDK.create({
-  baseURL: process.env.NODE_ENV === 'production' 
-    ? 'https://api.ai-solver.com'
-    : 'http://localhost:3000',
-  apiKey: process.env.AI_SOLVER_API_KEY
-});
-```
-
-### Динамическое обновление ключа
-
-```javascript
-// Обновление API ключа в runtime
-sdk.updateOptions({
-  apiKey: 'new_api_key_12345678'
-});
-```
-
-## Типы ключей
-
-| Тип | Префикс | Описание | Срок действия |
-|-----|---------|----------|---------------|
-| Development | `dev_sk_test_` | Для локальной разработки | Неограничен |
-| Production | `sk_prod_` | Для production использования | 1 год |
-| Temporary | `sk_temp_` | Временный доступ | 7-30 дней |
-
-## Области действия (Scopes)
-
-API ключи v2.5.0 поддерживают следующие области:
-
-### Базовые права
-
-- `projects:read` - Чтение проектов
-- `projects:write` - Создание и изменение проектов
-- `projects:index` - Запуск индексации
-
-### AI права
-
-- `chat:access` - Доступ к AI чату
-- `chat:stream` - Потоковый чат
-- `reasoning:access` - Доступ к reasoning API
-- `reasoning:manage` - Управление reasoning процессами
-
-### Поиск и данные
-
-- `search:access` - Семантический поиск
-- `context:access` - Доступ к контексту проекта
-- `websocket:connect` - WebSocket соединения
-
-### Development ключ
-
-Development ключ `dev_sk_test_12345678` имеет **все права** для удобства разработки.
-
-## Проверка аутентификации
-
-### Диагностика API
-
-```javascript
-// Полная диагностика включая аутентификацию
-const results = await sdk.diagnoseAPI();
-console.log('API diagnostics:', results);
-
-/* Пример ответа:
-{
-  '/api/v1/projects': { status: 200, authenticated: true },
-  '/api/v1/chat': { status: 200, authenticated: true },
-  '/api/v1/reasoning': { status: 401, authenticated: false, error: 'Invalid API key' }
-}
-*/
-```
-
-### Простая проверка
-
-```javascript
-try {
-  const projects = await sdk.projects.getAll();
-  console.log('✅ Authentication successful');
-} catch (error) {
-  if (error.status === 401) {
-    console.error('❌ Invalid API key');
-  } else if (error.status === 403) {
-    console.error('❌ Insufficient permissions');
-  }
-}
-```
-
-## Заголовки аутентификации
-
-SDK автоматически добавляет заголовки:
-
-```http
-Authorization: Bearer dev_sk_test_12345678
-Content-Type: application/json
-```
-
-### Дополнительные заголовки
-
-```javascript
-const sdk = CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000',
-  apiKey: 'dev_sk_test_12345678',
-  headers: {
-    'X-Client-Version': '2.5.0',
-    'X-User-Agent': 'My-App/1.0'
-  }
-});
-```
-
-## WebSocket аутентификация
-
-WebSocket соединения автоматически используют API ключ:
-
-```javascript
-// API ключ автоматически передается в WebSocket
-await sdk.projects.connectWebSocket();
-await sdk.reasoning.connectWebSocket();
-await sdk.chat.connectWebSocket();
-```
-
-## Ошибки аутентификации
-
-### 401 Unauthorized
-
-```json
-{
-  "error": "Unauthorized",
-  "message": "Invalid or missing API key",
-  "code": "AUTH_INVALID_KEY"
-}
-```
-
-**Решение:** Проверьте правильность API ключа.
-
-### 403 Forbidden
-
-```json
-{
-  "error": "Forbidden",
-  "message": "Insufficient permissions for this operation",
-  "code": "AUTH_INSUFFICIENT_SCOPE",
-  "required_scope": "projects:write"
-}
-```
-
-**Решение:** Используйте ключ с нужными правами.
-
-### 429 Rate Limited
-
-```json
-{
-  "error": "Too Many Requests",
-  "message": "Rate limit exceeded",
-  "retry_after": 60
-}
-```
-
-**Решение:** Подождите указанное время или используйте Production ключ.
-
-## Безопасность
-
-### ✅ Рекомендации
-
-- Используйте переменные окружения для хранения ключей
-- Никогда не коммитьте ключи в git
-- Регулярно ротируйте Production ключи
-- Используйте минимальные необходимые права
-- Мониторьте использование ключей
-
-### ❌ Не делайте
-
-```javascript
-// ❌ НЕ ДЕЛАЙТЕ ТАК
-const sdk = CodeSolverSDK.create({
-  apiKey: 'sk_prod_1234567890abcd' // Хардкод в коде
-});
-
-// ❌ НЕ ДЕЛАЙТЕ ТАК
-fetch('/api/client-side', {
-  headers: {
-    'Authorization': 'Bearer sk_prod_1234567890abcd' // В браузере
-  }
-});
-```
-
-### ✅ Правильно
-
-```javascript
-// ✅ ПРАВИЛЬНО
-const sdk = CodeSolverSDK.create({
-  apiKey: process.env.AI_SOLVER_API_KEY
-});
-
-// ✅ ПРАВИЛЬНО - для браузера используйте proxy
-fetch('/api/proxy/ai-solver', {
-  headers: {
-    'Authorization': 'Bearer ' + clientToken // Только client token
-  }
-});
-```
-
-## Environment Configuration
-
-### Development
-
-```bash
-# .env.local
-AI_SOLVER_API_KEY=dev_sk_test_12345678
-AI_SOLVER_BASE_URL=http://localhost:3000
-```
-
-### Production
-
-```bash
-# .env.production
-AI_SOLVER_API_KEY=sk_prod_1234567890abcd
-AI_SOLVER_BASE_URL=https://api.ai-solver.com
-```
-
-### Configuration helper
-
-```javascript
-function createSDK() {
-  const isDev = process.env.NODE_ENV === 'development';
-  
-  return CodeSolverSDK.create({
-    baseURL: isDev 
-      ? 'http://localhost:3000'
-      : 'https://api.ai-solver.com',
-    apiKey: process.env.AI_SOLVER_API_KEY,
-    autoConnect: false
-  });
-}
-```
-
-## Отзыв ключей
-
-При компрометации ключа:
-
-1. **Немедленно** удалите ключ из системы
-2. Обновите переменные окружения
-3. Перезапустите все сервисы
-4. Создайте новый ключ
-5. Проверьте логи на подозрительную активность
-
-```javascript
-// Проверка активности ключа
-const diagnostics = await sdk.diagnoseAPI();
-if (diagnostics.unauthorized) {
-  console.error('🚨 API key might be compromised or revoked');
-  // Логика восстановления
-}
-```
-
----
-
-**Документация аутентификации для SDK v2.5.0**  
-**Совместимость:** AI Solver Backend v1.0.0  
-**Обновлено:** 28 июня 2025