@adpal/shared-lib 1.0.0

package/README.md

@@ -0,0 +1,83 @@
+# @adpal/shared-lib
+
+Общие утилиты для проектов AdPal / Shared utilities for AdPal projects.
+
+## Установка / Installation
+
+```bash
+npm install @adpal/shared-lib
+```
+
+Для доступа к GitHub Packages:
+```bash
+npm login --registry=https://npm.pkg.github.com --scope=@adpal
+```
+
+## Модули / Modules
+
+### Errors (Ошибки)
+
+```typescript
+import { AppError, VoyageApiError, isAppError, wrapError } from '@adpal/shared-lib';
+
+// Кастомная ошибка
+throw new VoyageApiError('Rate limited', 429, { tokens: 1500 });
+
+// Проверка типа
+if (isAppError(error) && error.retryable) {
+  // Можно повторить
+}
+```
+
+### Logger (Логирование)
+
+```typescript
+import { Logger, createTimer } from '@adpal/shared-lib';
+
+const log = new Logger('my-module');
+const timer = createTimer();
+
+log.info('Операция начата');
+await doSomething();
+log.info('Операция завершена', { durationMs: timer() });
+```
+
+### Retry
+
+```typescript
+import { withRetry, retryApiCall } from '@adpal/shared-lib';
+
+// С полным контролем
+const result = await withRetry(
+  () => fetch('https://api.example.com'),
+  { maxAttempts: 3, baseDelayMs: 1000 }
+);
+
+// Для API вызовов
+const data = await retryApiCall(() => fetchFromVoyage());
+```
+
+### Schemas (Zod валидация)
+
+```typescript
+import {
+  VoyageEmbeddingResponseSchema,
+  safeParse
+} from '@adpal/shared-lib';
+
+const data = await response.json();
+const parsed = safeParse(VoyageEmbeddingResponseSchema, data);
+if (!parsed) throw new Error('Invalid response');
+```
+
+## Разработка / Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Безопасность / Security
+
+Этот пакет **не содержит секретов**. Все API ключи передаются через `process.env` в runtime.