solver-sdk 5.1.4 → 5.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -32
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -91,9 +91,6 @@ getProject(projectId: string): Promise<Project | null>
|
|
|
91
91
|
// Поиск или создание проекта
|
|
92
92
|
findOrCreateProject(projectPath: string, projectName: string, description?: string): Promise<Project>
|
|
93
93
|
|
|
94
|
-
// Удаление проекта
|
|
95
|
-
deleteProject(projectId: string): Promise<void>
|
|
96
|
-
|
|
97
94
|
// Получение статуса индексации проекта
|
|
98
95
|
getIndexingStatus(projectId: string): Promise<any>
|
|
99
96
|
```
|
|
@@ -128,7 +125,7 @@ const project = await sdk.projects.findOrCreateProject(
|
|
|
128
125
|
// Создание проекта и запуск индексации
|
|
129
126
|
indexProject(projectPath: string, projectName: string, description?: string): Promise<IndexProjectResult>
|
|
130
127
|
|
|
131
|
-
// Получение статуса индексации
|
|
128
|
+
// Получение статуса индексации
|
|
132
129
|
getStatus(projectId: string): Promise<IndexingStatus>
|
|
133
130
|
|
|
134
131
|
// Ожидание завершения индексации (DEPRECATED - используйте WebSocket)
|
|
@@ -401,11 +398,8 @@ sdk.projectSync.on('sync-progress', (progress) => {
|
|
|
401
398
|
// Отправка сообщения
|
|
402
399
|
sendMessage(messages: Message[], options?: ChatOptions): Promise<ChatResponse>
|
|
403
400
|
|
|
404
|
-
// Потоковый чат
|
|
401
|
+
// Потоковый чат
|
|
405
402
|
streamChat(messages: Message[], options?: StreamChatOptions): AsyncGenerator<ChatChunk>
|
|
406
|
-
|
|
407
|
-
// Чат с контекстом проекта
|
|
408
|
-
chatWithContext(projectId: string, message: string, options?: ChatOptions): Promise<ChatResponse>
|
|
409
403
|
```
|
|
410
404
|
|
|
411
405
|
#### Примеры использования
|
|
@@ -426,36 +420,27 @@ const stream = sdk.chat.streamChat([
|
|
|
426
420
|
for await (const chunk of stream) {
|
|
427
421
|
process.stdout.write(chunk.choices[0]?.delta?.content || '');
|
|
428
422
|
}
|
|
429
|
-
|
|
430
|
-
// Чат с контекстом проекта
|
|
431
|
-
const contextResponse = await sdk.chat.chatWithContext(
|
|
432
|
-
'project-id',
|
|
433
|
-
'Найди баги в моем коде'
|
|
434
|
-
);
|
|
435
423
|
```
|
|
436
424
|
|
|
437
|
-
##
|
|
438
|
-
|
|
439
|
-
SDK автоматически обрабатывает rate limiting и кэширование:
|
|
425
|
+
## 💡 Рекомендации по использованию
|
|
440
426
|
|
|
441
|
-
###
|
|
442
|
-
|
|
443
|
-
- **Projects**: 30 запросов/минуту
|
|
444
|
-
- **Global**: 10/сек, 100/мин, 1000/час
|
|
427
|
+
### Real-time уведомления
|
|
428
|
+
Для получения актуальных данных в реальном времени используйте WebSocket:
|
|
445
429
|
|
|
446
|
-
### Кэширование
|
|
447
|
-
- **Indexing Status**: 10 секунд TTL
|
|
448
|
-
- **Projects**: 30 секунд TTL
|
|
449
|
-
|
|
450
|
-
### Рекомендации
|
|
451
430
|
```javascript
|
|
452
431
|
// ✅ Правильно: WebSocket для real-time статуса
|
|
453
|
-
sdk.
|
|
432
|
+
await sdk.connectWebSocket();
|
|
433
|
+
sdk.projectSync.on('sync-status-update', (status) => {
|
|
434
|
+
console.log(`Статус: ${status.status}, прогресс: ${status.progress}%`);
|
|
435
|
+
});
|
|
454
436
|
|
|
455
|
-
// ❌
|
|
437
|
+
// ❌ Избегайте частых REST запросов
|
|
456
438
|
// setInterval(() => sdk.indexing.getStatus(id), 2000);
|
|
457
439
|
```
|
|
458
440
|
|
|
441
|
+
### Обработка лимитов
|
|
442
|
+
SDK автоматически обрабатывает ограничения сервера. При превышении лимитов возвращается ошибка 429.
|
|
443
|
+
|
|
459
444
|
## 🔧 Обработка ошибок
|
|
460
445
|
|
|
461
446
|
```javascript
|
|
@@ -465,7 +450,7 @@ try {
|
|
|
465
450
|
if (error.status === 401) {
|
|
466
451
|
console.error('Неверный API ключ');
|
|
467
452
|
} else if (error.status === 429) {
|
|
468
|
-
console.error('
|
|
453
|
+
console.error('Слишком много запросов, попробуйте позже');
|
|
469
454
|
} else {
|
|
470
455
|
console.error('Ошибка API:', error.message);
|
|
471
456
|
}
|
|
@@ -573,7 +558,13 @@ sdk.projectSync.on('sync-status-update', (status) => {
|
|
|
573
558
|
|
|
574
559
|
## 📝 Changelog
|
|
575
560
|
|
|
576
|
-
### v5.1.
|
|
561
|
+
### v5.1.5 (Latest)
|
|
562
|
+
- ✅ Исправлена документация - убраны детали внутренней реализации
|
|
563
|
+
- ✅ Удалены несуществующие методы из документации
|
|
564
|
+
- ✅ Сосредоточено только на пользовательском API
|
|
565
|
+
|
|
566
|
+
### v5.1.4
|
|
567
|
+
- ✅ Полная документация всех API методов
|
|
577
568
|
- ✅ Добавлен `IndexingApi` для управления индексацией
|
|
578
569
|
- ✅ Добавлен `ProjectSyncClient` для WebSocket уведомлений
|
|
579
570
|
- ✅ Исправлена генерация URL в `SearchApi`
|
|
@@ -586,7 +577,7 @@ sdk.projectSync.on('sync-status-update', (status) => {
|
|
|
586
577
|
- 🚀 Полная переработка архитектуры
|
|
587
578
|
- 🔌 WebSocket поддержка для real-time уведомлений
|
|
588
579
|
- 🔄 Delta-chunking для эффективной синхронизации
|
|
589
|
-
- 🛡️
|
|
580
|
+
- 🛡️ Автоматическая обработка лимитов сервера
|
|
590
581
|
|
|
591
582
|
## 📞 Поддержка
|
|
592
583
|
|
|
@@ -600,4 +591,4 @@ MIT License - см. [LICENSE](LICENSE) файл.
|
|
|
600
591
|
|
|
601
592
|
---
|
|
602
593
|
|
|
603
|
-
**🚀 Code Solver SDK v5.1.
|
|
594
|
+
**🚀 Code Solver SDK v5.1.5** - Создано с ❤️ для разработчиков
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "solver-sdk",
|
|
3
|
-
"version": "5.1.
|
|
3
|
+
"version": "5.1.5",
|
|
4
4
|
"description": "🚀 Официальный JavaScript/TypeScript SDK для Code Solver API - современная платформа для анализа кода с WebSocket поддержкой и delta-chunking синхронизацией",
|
|
5
5
|
"main": "dist/cjs/index.js",
|
|
6
6
|
"module": "dist/esm/index.js",
|