@andrey4emk/npm-app-back-b24 2.0.9 → 2.0.10

package/README.md

@@ -42,6 +42,7 @@ import {
     Wappi,
     logs,
     fetchRetry,
+    isNetworkError,
 } from "@andrey4emk/npm-app-back-b24";
 
 // $b24 — готовый экземпляр B24OAuth (или null, если токены не настроены)
@@ -113,6 +114,17 @@ const response = await fetchRetry("https://api.example.com/data", { method: "GET
     -   При обновлении токенов SDK автоматически сохраняет их в файл через callback `setCallbackRefreshAuth`.
     -   Окружение (`DEV`/`PROD`) определяется переменной `APP_ENV` — от неё зависят используемые `CLIENT_ID`/`CLIENT_SECRET`.
 
+    **Retry при сетевых ошибках:**
+
+    Экземпляр `$b24` обёрнут Proxy, который автоматически повторяет запросы при сетевых ошибках. Повторные попытки применяются к методам `callMethod`, `callListMethod`, `callBatch` и `fetchListMethod`.
+
+    | Параметр       | Значение |
+    | -------------- | -------- |
+    | Попыток        | 5        |
+    | Задержка       | 500 мс   |
+
+    Retry срабатывает только при сетевых проблемах (`ECONNRESET`, `ETIMEDOUT`, `ERR_NETWORK` и т.д.). HTTP-ошибки (400, 500) и ошибки бизнес-логики Bitrix24 **не** вызывают повторных попыток. Каждая неудачная попытка логируется через `logs.add()` с уровнем `error`.
+
 -   **`saveAuthB24Handler(req, res)`** — HTTP-обработчик для сохранения набора токенов из `req.body`.
 
     -   **Параметры:**
@@ -570,14 +582,28 @@ const response = await fetchRetry("https://api.example.com/data", { method: "GET
 
 -   **`fetchRetry(url, options?, retries?, delay?)`** — обёртка над `fetch` с повторными попытками при сетевых ошибках. HTTP-ошибки (4xx, 5xx) **не** вызывают повторных попыток — повторяются только сетевые сбои (TypeError, ECONNRESET, ETIMEDOUT и т.д.).
 
-    -   **Параметры:**
+-   **`isNetworkError(error)`** — проверяет, является ли ошибка сетевой (стоит повторить запрос). Используется внутри `fetchRetry` и retry-обёртки `$b24`. Можно использовать в своём коде для аналогичных проверок.
+
+    ```js
+    import { isNetworkError } from "@andrey4emk/npm-app-back-b24";
+
+    try {
+        await someRequest();
+    } catch (error) {
+        if (isNetworkError(error)) {
+            // сетевая ошибка — можно повторить
+        }
+    }
+    ```
+
+    **Параметры:**
 
-        | Параметр  | Тип                          | По умолчанию  | Описание                          |
-        | --------- | ---------------------------- | ------------- | --------------------------------- |
-        | `url`     | string \| URL \| Request     | **обязательно** | Адрес запроса                   |
-        | `options` | RequestInit                  | `undefined`   | Параметры fetch (метод, заголовки, body и т.д.) |
-        | `retries` | number                       | `5`           | Количество попыток               |
-        | `delay`   | number                       | `500`         | Задержка между попытками (мс)    |
+    | Параметр  | Тип                          | По умолчанию    | Описание                                        |
+    | --------- | ---------------------------- | --------------- | ----------------------------------------------- |
+    | `url`     | string \| URL \| Request     | **обязательно** | Адрес запроса                                   |
+    | `options` | RequestInit                  | `undefined`     | Параметры fetch (метод, заголовки, body и т.д.) |
+    | `retries` | number                       | `5`             | Количество попыток                              |
+    | `delay`   | number                       | `500`           | Задержка между попытками (мс)                   |
 
     -   **Возвращает:** `Promise<Response>` — ответ от fetch.
 

package/bitrix24/b24.ts

@@ -1,6 +1,7 @@
-import { B24OAuth } from "@bitrix24/b24jssdk";
+import { B24OAuth, AjaxError } from "@bitrix24/b24jssdk";
 import type { B24OAuthParams, B24OAuthSecret, AuthData } from "@bitrix24/b24jssdk";
 import { logs } from "../logs/logs.ts";
+import { isNetworkError } from "../utils/fetchRetry.ts";
 import Conf from "conf";
 import path from "path";
 import type { Request, Response } from "express";
@@ -8,7 +9,7 @@ import type { Request, Response } from "express";
 import dotEnv from "dotenv";
 dotEnv.config();
 
-// --- Интерфейсы ---
+// ==================== Типы ====================
 
 /** Результат операций с токенами */
 interface SaveResult {
@@ -16,29 +17,43 @@ interface SaveResult {
     message: string;
 }
 
-// --- Настройки ---
+// ==================== Константы ====================
 
-const CONFIG_DIR: string = process.env.CONFIG_DIR || "../config";
-const APP_ENV: string = process.env.APP_ENV || "PROD";
-const CLIENT_ID: string | undefined = APP_ENV === "DEV" ? process.env.APP_B24_CLIENT_ID_DEV : process.env.APP_B24_CLIENT_ID;
-const CLIENT_SECRET: string | undefined = APP_ENV === "DEV" ? process.env.APP_B24_CLIENT_SECRET_DEV : process.env.APP_B24_CLIENT_SECRET;
+const CONFIG_DIR = process.env.CONFIG_DIR || "../config";
+const APP_ENV = process.env.APP_ENV || "PROD";
+const CLIENT_ID = APP_ENV === "DEV" ? process.env.APP_B24_CLIENT_ID_DEV : process.env.APP_B24_CLIENT_ID;
+const CLIENT_SECRET = APP_ENV === "DEV" ? process.env.APP_B24_CLIENT_SECRET_DEV : process.env.APP_B24_CLIENT_SECRET;
 
-/** Интервал проактивного обновления токена (мс). 25 минут при TTL токена 30 минут */
+/** 25 минут при TTL токена 30 минут */
 const PROACTIVE_REFRESH_INTERVAL_MS = 25 * 60 * 1000;
 
+/** Количество попыток при сетевых ошибках */
+const RETRY_COUNT = 5;
+/** Задержка между попытками (мс) */
+const RETRY_DELAY_MS = 500;
+
+/** Методы B24OAuth, оборачиваемые retry-логикой */
+const RETRYABLE_METHODS = new Set(["callMethod", "callListMethod", "callBatch", "fetchListMethod"]);
+
+/** Коды AxiosError, означающие проблему с сетью */
+const AXIOS_NETWORK_CODES = new Set(["ERR_NETWORK", "ECONNABORTED"]);
+
 const confAuthB24 = new Conf({
     cwd: path.resolve(CONFIG_DIR),
     configName: "authB24",
 });
 
-// --- Утилиты ---
+// ==================== Утилиты ====================
 
 /** Убирает протокол из домена (https://example.bitrix24.ru → example.bitrix24.ru) */
 function cleanDomain(domain: string): string {
     return domain.replace(/^https?:\/\//, "");
 }
 
-// --- Создание экземпляра B24OAuth ---
+/** Задержка на указанное количество миллисекунд */
+const delay = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));
+
+// ==================== Создание экземпляра B24OAuth ====================
 
 function createB24Instance(): B24OAuth | null {
     const store = confAuthB24.store as Record<string, AuthData>;
@@ -77,7 +92,7 @@ function createB24Instance(): B24OAuth | null {
     return new B24OAuth(authParams, secret);
 }
 
-// --- Работа с токенами ---
+// ==================== Работа с токенами ====================
 
 /** Сохраняет токены в authB24.json, нормализуя домен без протокола */
 export function saveTokens(authData: AuthData): SaveResult {
@@ -116,7 +131,7 @@ export function saveAuthB24Handler(req: Request, res: Response): void {
     }
 }
 
-// --- Мьютекс для refresh токена ---
+// ==================== Мьютекс для refresh токена ====================
 
 /**
  * Дедупликация refresh-запросов.
@@ -161,7 +176,7 @@ export async function refreshAndSaveTokens(): Promise<SaveResult> {
     }
 }
 
-// --- Проактивное обновление токена ---
+// ==================== Проактивное обновление токена ====================
 
 let proactiveRefreshTimer: ReturnType<typeof setInterval> | null = null;
 
@@ -188,13 +203,82 @@ export function stopProactiveRefresh(): void {
     logs.add("Проактивное обновление токена остановлено", "debug");
 }
 
-// --- Инициализация ---
+// ==================== Retry-обёртка ====================
+
+/**
+ * Проверяет, является ли ошибка из SDK сетевой.
+ * AjaxError хранит AxiosError в поле originalError.
+ */
+function isB24NetworkError(error: unknown): boolean {
+    if (error instanceof AjaxError) {
+        const { originalError, status } = error;
+
+        if (originalError && isNetworkError(originalError)) return true;
+        if (AXIOS_NETWORK_CODES.has((originalError as any)?.code)) return true;
+        if (status === 0) return true;
+    }
+
+    return isNetworkError(error);
+}
+
+/** Оборачивает async-функцию retry-логикой при сетевых ошибках */
+function withRetry<T extends (...args: any[]) => Promise<any>>(fn: T, context: any, methodName: string): T {
+    return (async (...args: any[]) => {
+        let lastError: unknown;
+
+        for (let attempt = 1; attempt <= RETRY_COUNT; attempt++) {
+            try {
+                return await fn.apply(context, args);
+            } catch (error: unknown) {
+                lastError = error;
+
+                if (!isB24NetworkError(error) || attempt === RETRY_COUNT) {
+                    throw error;
+                }
+
+                const msg = error instanceof Error ? error.message : String(error);
+                logs.add(`$b24.${methodName}: попытка ${attempt}/${RETRY_COUNT} не удалась (${msg}), повтор через ${RETRY_DELAY_MS}мс`, "error");
+
+                await delay(RETRY_DELAY_MS);
+            }
+        }
+
+        // Недостижимо при RETRY_COUNT >= 1, нужно для TypeScript
+        throw lastError;
+    }) as T;
+}
+
+/**
+ * Proxy-обёртка вокруг B24OAuth: автоматически оборачивает
+ * callMethod, callListMethod, callBatch и fetchListMethod retry-логикой.
+ * Обёрнутые методы кешируются — обёртка создаётся один раз на метод.
+ */
+function wrapB24WithRetry(b24: B24OAuth): B24OAuth {
+    const methodCache = new Map<string, Function>();
+
+    return new Proxy(b24, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+
+            if (typeof prop === "string" && RETRYABLE_METHODS.has(prop) && typeof value === "function") {
+                if (!methodCache.has(prop)) {
+                    methodCache.set(prop, withRetry(value, target, prop));
+                }
+                return methodCache.get(prop);
+            }
+
+            return value;
+        },
+    });
+}
+
+// ==================== Инициализация ====================
 
-export const $b24 = createB24Instance();
+const _b24Raw = createB24Instance();
+export const $b24 = _b24Raw ? wrapB24WithRetry(_b24Raw) : null;
 
-if ($b24) {
-    // Сохраняем токены в файл при каждом refresh (реактивном или проактивном)
-    $b24.setCallbackRefreshAuth(async ({ authData }) => {
+if (_b24Raw) {
+    _b24Raw.setCallbackRefreshAuth(async ({ authData }) => {
         const result = saveTokens(authData);
         if (result.error) {
             logs.add(`Ошибка при автосохранении токенов: ${result.message}`, "error");
@@ -203,8 +287,5 @@ if ($b24) {
         }
     });
 
-    // Обновляем токен при старте, затем запускаем проактивный таймер
-    refreshAndSaveTokens().then(() => {
-        startProactiveRefresh();
-    });
+    refreshAndSaveTokens().then(() => startProactiveRefresh());
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@andrey4emk/npm-app-back-b24",
-    "version": "2.0.9",
+    "version": "2.0.10",
     "description": "Bitrix24 OAuth helpers for Node.js projects",
     "main": "index.ts",
     "type": "module",

package/utils/fetchRetry.ts

@@ -13,9 +13,10 @@ const NETWORK_ERROR_CODES = [
 ];
 
 /**
- * Проверяет, является ли ошибка сетевой (стоит повторить запрос)
+ * Проверяет, является ли ошибка сетевой (стоит повторить запрос).
+ * Экспортируется для использования в других retry-обёртках (например, для $b24).
  */
-function isNetworkError(error: unknown): boolean {
+export function isNetworkError(error: unknown): boolean {
     if (error instanceof TypeError) return true;
 
     if (error instanceof Error) {