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

package/bitrix24/b24.ts

@@ -8,7 +8,7 @@ import type { Request, Response } from "express";
 import dotEnv from "dotenv";
 dotEnv.config();
 
-// ==================== Интерфейсы ====================
+// --- Интерфейсы ---
 
 /** Результат операций с токенами */
 interface SaveResult {
@@ -16,43 +16,45 @@ interface SaveResult {
     message: string;
 }
 
-// ==================== Настройки ====================
+// --- Настройки ---
 
-const configDir: string = process.env.CONFIG_DIR || "../config";
-const appEnv: string = process.env.APP_ENV || "PROD";
-const clientId: string | undefined = appEnv === "DEV" ? process.env.APP_B24_CLIENT_ID_DEV : process.env.APP_B24_CLIENT_ID;
-const clientSecret: string | undefined = appEnv === "DEV" ? process.env.APP_B24_CLIENT_SECRET_DEV : process.env.APP_B24_CLIENT_SECRET;
+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;
+
+/** Интервал проактивного обновления токена (мс). 25 минут при TTL токена 30 минут */
+const PROACTIVE_REFRESH_INTERVAL_MS = 25 * 60 * 1000;
 
-// Инициализация Conf для работы с authB24.json
 const confAuthB24 = new Conf({
-    cwd: path.resolve(configDir),
+    cwd: path.resolve(CONFIG_DIR),
     configName: "authB24",
 });
 
-// ==================== Функции ====================
+// --- Утилиты ---
+
+/** Убирает протокол из домена (https://example.bitrix24.ru → example.bitrix24.ru) */
+function cleanDomain(domain: string): string {
+    return domain.replace(/^https?:\/\//, "");
+}
+
+// --- Создание экземпляра B24OAuth ---
 
-/**
- * Создаёт экземпляр B24OAuth или возвращает null при ошибке
- */
 function createB24Instance(): B24OAuth | null {
-    // Получаем данные авторизации из конфига
     const store = confAuthB24.store as Record<string, AuthData>;
-    const authConfig = store[appEnv];
+    const authConfig = store[APP_ENV];
 
-    // Проверяем данные авторизации
     if (!authConfig?.domain || !authConfig?.access_token || !authConfig?.refresh_token) {
         logs.add("В конфиге authB24 не хватает данных для авторизации. Сохрани токены через клиент и перезагрузи докер", "error");
         return null;
     }
 
-    // Проверяем секреты приложения
-    if (!clientId || !clientSecret) {
+    if (!CLIENT_ID || !CLIENT_SECRET) {
         logs.add("Не заданы APP_B24_CLIENT_ID или APP_B24_CLIENT_SECRET в .env", "error");
         return null;
     }
 
-    // Формируем параметры и создаём экземпляр
-    const domain = authConfig.domain.replace(/^https?:\/\//, "");
+    const domain = cleanDomain(authConfig.domain);
 
     const authParams: B24OAuthParams = {
         applicationToken: "",
@@ -70,22 +72,17 @@ function createB24Instance(): B24OAuth | null {
         issuer: "store",
     };
 
-    const secret: B24OAuthSecret = { clientId, clientSecret };
+    const secret: B24OAuthSecret = { clientId: CLIENT_ID, clientSecret: CLIENT_SECRET };
 
     return new B24OAuth(authParams, secret);
 }
 
-/**
- * Сохраняет токены в authB24.json
- */
+// --- Работа с токенами ---
+
+/** Сохраняет токены в authB24.json, нормализуя домен без протокола */
 export function saveTokens(authData: AuthData): SaveResult {
     try {
-        const cleanData: AuthData = {
-            ...authData,
-            domain: authData.domain.replace(/^https?:\/\//, ""),
-        };
-
-        confAuthB24.set(appEnv, cleanData);
+        confAuthB24.set(APP_ENV, { ...authData, domain: cleanDomain(authData.domain) });
         logs.add("Токены Bitrix24 сохранены", "debug");
         return { error: false, message: "Токены сохранены." };
     } catch (error: any) {
@@ -94,9 +91,7 @@ export function saveTokens(authData: AuthData): SaveResult {
     }
 }
 
-/**
- * HTTP-обработчик для сохранения токенов с фронта
- */
+/** HTTP-обработчик для сохранения токенов с фронта */
 export function saveAuthB24Handler(req: Request, res: Response): void {
     const { access_token, refresh_token, domain, expires_in, member_id } = req.body;
 
@@ -121,8 +116,36 @@ export function saveAuthB24Handler(req: Request, res: Response): void {
     }
 }
 
+// --- Мьютекс для refresh токена ---
+
 /**
- * Обновляет токены из текущего экземпляра $b24 и сохраняет в файл
+ * Дедупликация refresh-запросов.
+ * Пока промис не завершён, все новые вызовы ждут его результат
+ * вместо параллельных запросов к oauth.bitrix.info.
+ */
+let refreshInProgress: Promise<AuthData> | null = null;
+
+async function refreshAuthWithMutex(): Promise<AuthData> {
+    if (refreshInProgress) {
+        logs.add("refreshAuth: ожидаем завершения текущего refresh", "debug");
+        return refreshInProgress;
+    }
+
+    refreshInProgress = (async () => {
+        try {
+            if (!$b24) throw new Error("$b24 не инициализирован");
+            return await $b24.auth.refreshAuth();
+        } finally {
+            refreshInProgress = null;
+        }
+    })();
+
+    return refreshInProgress;
+}
+
+/**
+ * Обновляет токены через мьютекс и сохраняет в файл.
+ * Используется проактивным таймером и может вызываться вручную.
  */
 export async function refreshAndSaveTokens(): Promise<SaveResult> {
     if (!$b24) {
@@ -130,10 +153,7 @@ export async function refreshAndSaveTokens(): Promise<SaveResult> {
     }
 
     try {
-        let authData = $b24.auth.getAuthData();
-        if (!authData) {
-            authData = await $b24.auth.refreshAuth();
-        }
+        const authData = await refreshAuthWithMutex();
         return saveTokens(authData);
     } catch (error: any) {
         logs.add(`Ошибка обновления токенов: ${error.message}`, "error");
@@ -141,15 +161,40 @@ export async function refreshAndSaveTokens(): Promise<SaveResult> {
     }
 }
 
-// ==================== Инициализация ====================
+// --- Проактивное обновление токена ---
+
+let proactiveRefreshTimer: ReturnType<typeof setInterval> | null = null;
+
+/** Запускает проактивное обновление токена с заданным интервалом */
+function startProactiveRefresh(): void {
+    if (proactiveRefreshTimer) clearInterval(proactiveRefreshTimer);
+
+    proactiveRefreshTimer = setInterval(async () => {
+        logs.add("Проактивное обновление токена Bitrix24", "debug");
+        const result = await refreshAndSaveTokens();
+        if (result.error) {
+            logs.add(`Ошибка проактивного обновления токена: ${result.message}`, "error");
+        }
+    }, PROACTIVE_REFRESH_INTERVAL_MS);
+
+    logs.add(`Проактивное обновление токена запущено (каждые ${PROACTIVE_REFRESH_INTERVAL_MS / 60000} мин)`, "debug");
+}
+
+/** Останавливает проактивное обновление токена */
+export function stopProactiveRefresh(): void {
+    if (!proactiveRefreshTimer) return;
+    clearInterval(proactiveRefreshTimer);
+    proactiveRefreshTimer = null;
+    logs.add("Проактивное обновление токена остановлено", "debug");
+}
+
+// --- Инициализация ---
 
-// Создаем экземпляр Битрикс24
 export const $b24 = createB24Instance();
 
-// ==================== Подписываемся на событие обновления токенов ====================
 if ($b24) {
-    $b24.setCallbackRefreshAuth(async ({ authData, b24OAuthParams }) => {
-        // Сохраняем новые токены в файл
+    // Сохраняем токены в файл при каждом refresh (реактивном или проактивном)
+    $b24.setCallbackRefreshAuth(async ({ authData }) => {
         const result = saveTokens(authData);
         if (result.error) {
             logs.add(`Ошибка при автосохранении токенов: ${result.message}`, "error");
@@ -157,4 +202,9 @@ if ($b24) {
             logs.add("Токены автоматически обновлены и сохранены в authB24.json", "debug");
         }
     });
+
+    // Обновляем токен при старте, затем запускаем проактивный таймер
+    refreshAndSaveTokens().then(() => {
+        startProactiveRefresh();
+    });
 }

package/package.json

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