@andrey4emk/npm-app-back-b24 2.0.3 → 2.0.6

package/README.md

@@ -15,6 +15,7 @@
     -   [Email](#email)
     -   [Wappi](#wappi)
     -   [Логирование](#логирование)
+    -   [fetchRetry](#fetchretry)
 -   [Переменные окружения](#переменные-окружения)
 -   [Скрипты](#скрипты)
 -   [Лицензия](#лицензия)
@@ -40,6 +41,7 @@ import {
     Email,
     Wappi,
     logs,
+    fetchRetry,
 } from "@andrey4emk/npm-app-back-b24";
 
 // $b24 — готовый экземпляр B24OAuth (или null, если токены не настроены)
@@ -86,6 +88,9 @@ await wappi.sendMessageWappi("whatsApp", { phone: "+1234567890", message: "Пр
 
 // Логирование
 logs.add("Сообщение", "info");
+
+// fetch с повторными попытками при сетевых ошибках
+const response = await fetchRetry("https://api.example.com/data", { method: "GET" });
 ```
 
 ## API
@@ -561,6 +566,46 @@ logs.add("Сообщение", "info");
     -   Конфигурация хранится в файле `log.json` (через `conf`).
     -   Каждый уровень можно включить/выключить, изменить цвет.
 
+### fetchRetry
+
+-   **`fetchRetry(url, options?, retries?, delay?)`** — обёртка над `fetch` с повторными попытками при сетевых ошибках. HTTP-ошибки (4xx, 5xx) **не** вызывают повторных попыток — повторяются только сетевые сбои (TypeError, ECONNRESET, ETIMEDOUT и т.д.).
+
+    -   **Параметры:**
+
+        | Параметр  | Тип                          | По умолчанию  | Описание                          |
+        | --------- | ---------------------------- | ------------- | --------------------------------- |
+        | `url`     | string \| URL \| Request     | **обязательно** | Адрес запроса                   |
+        | `options` | RequestInit                  | `undefined`   | Параметры fetch (метод, заголовки, body и т.д.) |
+        | `retries` | number                       | `5`           | Количество попыток               |
+        | `delay`   | number                       | `500`         | Задержка между попытками (мс)    |
+
+    -   **Возвращает:** `Promise<Response>` — ответ от fetch.
+
+    -   **Обрабатываемые сетевые ошибки:**
+        `ECONNRESET`, `ECONNREFUSED`, `ETIMEDOUT`, `ENOTFOUND`, `ENETUNREACH`, `EAI_AGAIN`, `UND_ERR_CONNECT_TIMEOUT`, `UND_ERR_SOCKET`, `TypeError`, а также ошибки с сообщениями `fetch failed`, `network`, `socket`.
+
+    -   **Логирование:** при каждой неудачной попытке записывает сообщение через `logs.add()` с уровнем `error`.
+
+    ```js
+    import { fetchRetry } from "@andrey4emk/npm-app-back-b24";
+
+    // Простой GET-запрос с дефолтными параметрами (5 попыток, 500мс)
+    const response = await fetchRetry("https://api.example.com/data");
+    const json = await response.json();
+
+    // POST-запрос с кастомными параметрами
+    const res = await fetchRetry(
+        "https://api.example.com/webhook",
+        {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ key: "value" }),
+        },
+        3,   // 3 попытки
+        1000 // 1 секунда между попытками
+    );
+    ```
+
 ## Переменные окружения
 
 | Переменная                  | Назначение                                                    |

package/index.ts

@@ -13,3 +13,6 @@ export * from "./sendMessage/wappi.js";
 
 // Логирование
 export * from "./logs/logs.ts";
+
+// Утилиты
+export * from "./utils/fetchRetry.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@andrey4emk/npm-app-back-b24",
-    "version": "2.0.3",
+    "version": "2.0.6",
     "description": "Bitrix24 OAuth helpers for Node.js projects",
     "main": "index.ts",
     "type": "module",
@@ -31,7 +31,8 @@
         "sendMessage/smsgold.js",
         "sendMessage/email.js",
         "sendMessage/wappi.js",
-        "logs/logs.ts"
+        "logs/logs.ts",
+        "utils/fetchRetry.ts"
     ],
     "dependencies": {
         "@bitrix24/b24jssdk": "^0.5.1",

package/utils/fetchRetry.ts

@@ -0,0 +1,74 @@
+import { logs } from "../logs/logs.ts";
+
+/** Ошибки сети, при которых нужно повторять запрос */
+const NETWORK_ERROR_CODES = [
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+    "ENETUNREACH",
+    "EAI_AGAIN",
+    "UND_ERR_CONNECT_TIMEOUT",
+    "UND_ERR_SOCKET",
+];
+
+/**
+ * Проверяет, является ли ошибка сетевой (стоит повторить запрос)
+ */
+function isNetworkError(error: unknown): boolean {
+    if (error instanceof TypeError) return true;
+
+    if (error instanceof Error) {
+        const code = (error as NodeJS.ErrnoException).code;
+        if (code && NETWORK_ERROR_CODES.includes(code)) return true;
+
+        const msg = error.message.toLowerCase();
+        if (msg.includes("fetch failed") || msg.includes("network") || msg.includes("socket")) {
+            return true;
+        }
+    }
+
+    return false;
+}
+
+/**
+ * Обёртка над fetch с повторными попытками при сетевых ошибках.
+ * Повторяет запрос только при проблемах с сетью (TypeError, ECONNRESET и т.д.),
+ * HTTP-ошибки (4xx, 5xx) НЕ вызывают повторных попыток.
+ *
+ * @param url — адрес запроса
+ * @param options — параметры fetch (метод, заголовки, body и т.д.)
+ * @param retries — количество попыток (по умолчанию 5)
+ * @param delay — задержка между попытками в мс (по умолчанию 500)
+ * @returns Response от fetch
+ */
+export async function fetchRetry(
+    url: string | URL | Request,
+    options?: RequestInit,
+    retries: number = 5,
+    delay: number = 500
+): Promise<Response> {
+    let lastError: Error | null = null;
+
+    for (let attempt = 1; attempt <= retries; attempt++) {
+        try {
+            const response = await fetch(url, options);
+            return response;
+        } catch (error: unknown) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+
+            if (!isNetworkError(error) || attempt === retries) {
+                throw lastError;
+            }
+
+            logs.add(
+                `fetchRetry: попытка ${attempt}/${retries} не удалась (${lastError.message}), повтор через ${delay}мс — ${String(url)}`,
+                "error"
+            );
+
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+
+    throw lastError;
+}