@andrey4emk/npm-app-back-b24 2.0.13 → 3.0.0

package/README.md

@@ -33,6 +33,8 @@ import {
     $b24,
     saveAuthB24Handler,
     refreshAndSaveTokens,
+    reinitializeB24,
+    stopProactiveRefresh,
     errorB24,
     event,
     Event,
@@ -116,16 +118,20 @@ const response = await fetchRetry("https://api.example.com/data", { method: "GET
 
     **Retry при сетевых ошибках:**
 
-    Экземпляр `$b24` обёрнут Proxy, который автоматически повторяет запросы при сетевых ошибках. Повторные попытки применяются к методам `callMethod`, `callListMethod`, `callBatch` и `fetchListMethod`.
+    Экземпляр `$b24` обёрнут Proxy, который автоматически повторяет запросы при сетевых ошибках. Повторные попытки применяются к методам `callMethod`, `callListMethod`, `callBatch` и `fetchListMethod`, а также к обновлению токена (`refreshAuth`).
 
-    | Параметр       | Значение |
-    | -------------- | -------- |
-    | Попыток        | 5        |
-    | Задержка       | 500 мс   |
+    | Параметр       | Значение                                  |
+    | -------------- | ----------------------------------------- |
+    | Попыток        | 5                                         |
+    | Задержка       | 500 мс (экспоненциально для refreshAuth)  |
 
     Retry срабатывает только при сетевых проблемах (`ECONNRESET`, `ETIMEDOUT`, `ERR_NETWORK` и т.д.). HTTP-ошибки (400, 500) и ошибки бизнес-логики Bitrix24 **не** вызывают повторных попыток. Каждая неудачная попытка логируется через `logs.add()` с уровнем `error`.
 
--   **`saveAuthB24Handler(req, res)`** — HTTP-обработчик для сохранения набора токенов из `req.body`.
+    **Проактивное обновление токена:**
+
+    Токен автоматически обновляется каждые 25 минут. Если обновление не удалось — повтор через 2 минуты (вместо ожидания следующих 25 минут), что предотвращает протухание токена.
+
+-   **`saveAuthB24Handler(req, res)`** — HTTP-обработчик для сохранения набора токенов из `req.body`. После сохранения автоматически переинициализирует `$b24` — перезапуск сервера не требуется.
 
     -   **Параметры:**
         -   `req` (Express Request) — объект запроса с полем `body`.
@@ -157,12 +163,36 @@ const response = await fetchRetry("https://api.example.com/data", { method: "GET
     }
     ```
 
--   **`saveTokens(authData)`** — низкоуровневая функция для прямого сохранения токенов в файл.
+-   **`saveTokens(authData)`** — низкоуровневая функция для прямого сохранения токенов в файл. Перед записью валидирует данные — если `access_token`, `refresh_token`, `domain` или `expires` пустые/отсутствуют, операция отклоняется.
 
     -   **Параметры:**
         -   `authData` (AuthData) — объект с полями `access_token`, `refresh_token`, `domain`, `expires_in`, `member_id`, `expires`.
     -   **Возвращает:** объект `{ error: boolean, message: string }`.
 
+-   **`reinitializeB24()`** — пересоздаёт экземпляр `$b24` из актуального `authB24.json` без перезапуска сервера. Останавливает текущий проактивный таймер, создаёт новый `B24OAuth`, настраивает колбэк автосохранения, обновляет токены и запускает таймер заново.
+
+    -   **Возвращает:** промис с объектом `{ error: boolean, message: string }`.
+
+    ```js
+    import { reinitializeB24 } from "@andrey4emk/npm-app-back-b24";
+
+    const result = await reinitializeB24();
+    if (!result.error) {
+        console.log("$b24 переинициализирован");
+    }
+    ```
+
+-   **`stopProactiveRefresh()`** — останавливает проактивный таймер обновления токена. Используется при graceful shutdown.
+
+    ```js
+    import { stopProactiveRefresh } from "@andrey4emk/npm-app-back-b24";
+
+    process.on("SIGTERM", () => {
+        stopProactiveRefresh();
+        process.exit(0);
+    });
+    ```
+
 ### Задачи ошибок
 
 -   **`errorB24(dataTask)`** — создаёт служебную задачу в Bitrix24 при ошибках/событиях. Использует глобальный `$b24`.

package/bitrix24/b24.ts

@@ -26,6 +26,8 @@ const CLIENT_SECRET = APP_ENV === "DEV" ? process.env.APP_B24_CLIENT_SECRET_DEV
 
 /** 25 минут при TTL токена 30 минут */
 const PROACTIVE_REFRESH_INTERVAL_MS = 25 * 60 * 1000;
+/** 2 минуты — ускоренный интервал при ошибке обновления */
+const PROACTIVE_RETRY_ON_ERROR_MS = 2 * 60 * 1000;
 
 /** Количество попыток при сетевых ошибках */
 const RETRY_COUNT = 5;
@@ -94,9 +96,26 @@ function createB24Instance(): B24OAuth | null {
 
 // ==================== Работа с токенами ====================
 
+/** Проверяет, что authData содержит все обязательные непустые поля */
+function isValidAuthData(data: AuthData): boolean {
+    return !!(
+        data &&
+        typeof data.access_token === "string" && data.access_token.length > 0 &&
+        typeof data.refresh_token === "string" && data.refresh_token.length > 0 &&
+        typeof data.domain === "string" && data.domain.length > 0 &&
+        data.expires
+    );
+}
+
 /** Сохраняет токены в authB24.json, нормализуя домен без протокола */
 export function saveTokens(authData: AuthData): SaveResult {
     try {
+        if (!isValidAuthData(authData)) {
+            const msg = "Попытка сохранить невалидные токены — операция отклонена";
+            logs.add(msg, "error");
+            return { error: true, message: msg };
+        }
+
         confAuthB24.set(APP_ENV, { ...authData, domain: cleanDomain(authData.domain) });
         logs.add("Токены Bitrix24 сохранены", "debug");
         return { error: false, message: "Токены сохранены." };
@@ -107,27 +126,38 @@ export function saveTokens(authData: AuthData): SaveResult {
 }
 
 /** HTTP-обработчик для сохранения токенов с фронта */
-export function saveAuthB24Handler(req: Request, res: Response): void {
-    const { access_token, refresh_token, domain, expires_in, member_id } = req.body;
+export async function saveAuthB24Handler(req: Request, res: Response): Promise<void> {
+    try {
+        const { access_token, refresh_token, domain, expires_in, member_id } = req.body;
 
-    if (!access_token || !refresh_token || !domain || !expires_in || !member_id) {
-        res.status(400).json({ status: "error", message: "Не заполнены обязательные поля." });
-        return;
-    }
+        if (!access_token || !refresh_token || !domain || !expires_in || !member_id) {
+            res.status(400).json({ status: "error", message: "Не заполнены обязательные поля." });
+            return;
+        }
 
-    const result = saveTokens({
-        access_token,
-        refresh_token,
-        domain,
-        expires_in,
-        member_id,
-        expires: Math.floor(Date.now() / 1000) + expires_in,
-    });
+        const result = saveTokens({
+            access_token,
+            refresh_token,
+            domain,
+            expires_in,
+            member_id,
+            expires: Math.floor(Date.now() / 1000) + expires_in,
+        });
 
-    if (result.error) {
-        res.status(500).json({ status: "error", message: result.message });
-    } else {
-        res.status(201).json({ status: "ok", message: "Токены сохранены. Перезапустите сервер." });
+        if (result.error) {
+            res.status(500).json({ status: "error", message: result.message });
+            return;
+        }
+
+        const reinitResult = await reinitializeB24();
+        if (reinitResult.error) {
+            res.status(201).json({ status: "ok", message: `Токены сохранены, но $b24 не переинициализирован: ${reinitResult.message}` });
+        } else {
+            res.status(201).json({ status: "ok", message: "Токены сохранены и применены." });
+        }
+    } catch (error: any) {
+        logs.add(`Ошибка в saveAuthB24Handler: ${error.message}`, "error");
+        res.status(500).json({ status: "error", message: error.message });
     }
 }
 
@@ -149,7 +179,21 @@ async function refreshAuthWithMutex(): Promise<AuthData> {
     refreshInProgress = (async () => {
         try {
             if (!$b24) throw new Error("$b24 не инициализирован");
-            return await $b24.auth.refreshAuth();
+
+            let lastError: unknown;
+            for (let attempt = 1; attempt <= RETRY_COUNT; attempt++) {
+                try {
+                    return await $b24.auth.refreshAuth();
+                } catch (error) {
+                    lastError = error;
+                    if (!isB24NetworkError(error) || attempt === RETRY_COUNT) throw error;
+                    const msg = error instanceof Error ? error.message : String(error);
+                    const delayMs = RETRY_DELAY_MS * attempt;
+                    logs.add(`refreshAuth: попытка ${attempt}/${RETRY_COUNT} не удалась (${msg}), повтор через ${delayMs}мс`, "error");
+                    await delay(delayMs);
+                }
+            }
+            throw lastError;
         } finally {
             refreshInProgress = null;
         }
@@ -178,27 +222,37 @@ export async function refreshAndSaveTokens(): Promise<SaveResult> {
 
 // ==================== Проактивное обновление токена ====================
 
-let proactiveRefreshTimer: ReturnType<typeof setInterval> | null = null;
+let proactiveRefreshTimer: ReturnType<typeof setTimeout> | null = null;
 
-/** Запускает проактивное обновление токена с заданным интервалом */
+/** Запускает проактивное обновление токена. При ошибке — повтор через 2 мин, при успехе — через 25 мин */
 function startProactiveRefresh(): void {
-    if (proactiveRefreshTimer) clearInterval(proactiveRefreshTimer);
+    if (proactiveRefreshTimer) {
+        clearTimeout(proactiveRefreshTimer);
+        proactiveRefreshTimer = null;
+    }
 
-    proactiveRefreshTimer = setInterval(async () => {
-        logs.add("Проактивное обновление токена Bitrix24", "debug");
-        const result = await refreshAndSaveTokens();
-        if (result.error) {
-            logs.add(`Ошибка проактивного обновления токена: ${result.message}`, "error");
-        }
-    }, PROACTIVE_REFRESH_INTERVAL_MS);
+    const scheduleNext = (delayMs: number) => {
+        proactiveRefreshTimer = setTimeout(async () => {
+            logs.add("Проактивное обновление токена Bitrix24", "debug");
+            const result = await refreshAndSaveTokens();
 
+            if (result.error) {
+                logs.add(`Ошибка проактивного обновления токена, повтор через ${PROACTIVE_RETRY_ON_ERROR_MS / 60000} мин`, "error");
+                scheduleNext(PROACTIVE_RETRY_ON_ERROR_MS);
+            } else {
+                scheduleNext(PROACTIVE_REFRESH_INTERVAL_MS);
+            }
+        }, delayMs);
+    };
+
+    scheduleNext(PROACTIVE_REFRESH_INTERVAL_MS);
     logs.add(`Проактивное обновление токена запущено (каждые ${PROACTIVE_REFRESH_INTERVAL_MS / 60000} мин)`, "debug");
 }
 
 /** Останавливает проактивное обновление токена */
 export function stopProactiveRefresh(): void {
     if (!proactiveRefreshTimer) return;
-    clearInterval(proactiveRefreshTimer);
+    clearTimeout(proactiveRefreshTimer);
     proactiveRefreshTimer = null;
     logs.add("Проактивное обновление токена остановлено", "debug");
 }
@@ -281,11 +335,12 @@ function wrapB24WithRetry(b24: B24OAuth): B24OAuth {
 
 // ==================== Инициализация ====================
 
-const _b24Raw = createB24Instance();
-export const $b24 = _b24Raw ? wrapB24WithRetry(_b24Raw) : null;
+let _b24Raw = createB24Instance();
+export let $b24 = _b24Raw ? wrapB24WithRetry(_b24Raw) : null;
 
-if (_b24Raw) {
-    _b24Raw.setCallbackRefreshAuth(async ({ authData }) => {
+/** Настраивает колбэк автосохранения токенов на экземпляре B24OAuth */
+function setupRefreshCallback(raw: B24OAuth): void {
+    raw.setCallbackRefreshAuth(async ({ authData }) => {
         const result = saveTokens(authData);
         if (result.error) {
             logs.add(`Ошибка при автосохранении токенов: ${result.message}`, "error");
@@ -293,6 +348,31 @@ if (_b24Raw) {
             logs.add("Токены автоматически обновлены и сохранены в authB24.json", "debug");
         }
     });
+}
+
+/** Пересоздаёт $b24 из актуального authB24.json без перезапуска сервера */
+export async function reinitializeB24(): Promise<SaveResult> {
+    stopProactiveRefresh();
 
+    _b24Raw = createB24Instance();
+    $b24 = _b24Raw ? wrapB24WithRetry(_b24Raw) : null;
+
+    if (!_b24Raw || !$b24) {
+        return { error: true, message: "Не удалось пересоздать $b24 — проверь authB24.json" };
+    }
+
+    setupRefreshCallback(_b24Raw);
+
+    const refreshResult = await refreshAndSaveTokens();
+    startProactiveRefresh();
+
+    logs.add("$b24 переинициализирован с новыми токенами", "debug");
+    return refreshResult;
+}
+
+// ==================== Начальная инициализация ====================
+
+if (_b24Raw) {
+    setupRefreshCallback(_b24Raw);
     refreshAndSaveTokens().then(() => startProactiveRefresh());
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@andrey4emk/npm-app-back-b24",
-    "version": "2.0.13",
+    "version": "3.0.0",
     "description": "Bitrix24 OAuth helpers for Node.js projects",
     "main": "index.ts",
     "type": "module",
@@ -35,7 +35,7 @@
         "utils/fetchRetry.ts"
     ],
     "dependencies": {
-        "@bitrix24/b24jssdk": "^0.5.1",
+        "@bitrix24/b24jssdk": "^1.0.4",
         "@types/express": "^5.0.6",
         "@types/luxon": "^3.7.1",
         "@types/node": "^25.0.10",