@andrey4emk/npm-app-back-b24 4.0.1 → 5.0.0

package/README.md

@@ -17,6 +17,7 @@
     -   [Логирование](#логирование)
     -   [fetchRetry и таймауты](#fetchretry-и-таймауты)
 -   [Переменные окружения](#переменные-окружения)
+-   [Миграция на 5.0.0](#миграция-на-500)
 -   [Миграция на 4.0.0](#миграция-на-400)
 -   [Скрипты](#скрипты)
 -   [Лицензия](#лицензия)
@@ -27,6 +28,8 @@
 npm install @andrey4emk/npm-app-back-b24
 ```
 
+Нужен Node.js 22 или новее (с 5.0.0 — его требует `@bitrix24/b24jssdk` 3.0.0).
+
 `nodemailer` — **опциональная peer-зависимость**: её ставит потребитель, и только если пользуется классом `Email`. Всем остальным она не нужна и не приезжает.
 
 ```bash
@@ -207,7 +210,7 @@ const sent = await fetchWithTimeout("https://api.example.com/send", { method: "P
 
     **Методы `callMethod`, `callListMethod`, `fetchListMethod`, `callBatch`, `callBatchByChunk` — фасад пакета.**
 
-    SDK 2.x помечает эти пять методов к удалению в следующем major и на каждый вызов пишет предупреждение об устаревании. Пакет реализует их сам поверх `actions.v2.*`, поэтому вызовы у потребителей не меняются, а зависимости от удаляемого API у пакета больше нет. Сигнатуры и типы возврата прежние — правок в проектах не требуется.
+    В SDK 3.0.0 этих пяти методов нет. Пакет реализует их сам поверх `actions.v2.*`, поэтому вызовы у потребителей не меняются, а зависимости от удалённого API у пакета нет. Сигнатуры и типы возврата прежние — правок в проектах не требуется.
 
     Поведение прежнее у четырёх методов из пяти. **`callListMethod` отличается в двух местах:** он бросает внятную ошибку с именем метода там, где SDK падал `TypeError` из своих недр (портал вернул «мягкую» ошибку, ответ не список, конверт нечитаем, `next` не растёт), и у него есть потолок в 1000 страниц — при упоре в него вызов тоже бросает, а не отдаёт молча обрезанный список. Если у вас есть `try`/`catch` вокруг постраничных выборок, текст ошибки изменится; если его нет — падение станет заметнее, но не появится там, где раньше всё работало.
 
@@ -252,9 +255,9 @@ const sent = await fetchWithTimeout("https://api.example.com/send", { method: "P
 
     **Провал обмена refresh-токена повторов не получает.** Когда обмен падает внутри вызова, попытка ровно одна, а в лог идёт строка уровня `error` с исходным кодом и статусом ответа oauth-хоста: `обновление токена не удалось (invalid_grant/400), повтор небезопасен: сервер мог провести ротацию`. Под правило попадает **любой** отказ обмена, кроме доказанного pre-connection, — и мёртвый токен после ротации, и транзиентные 429/503 от oauth-хоста: различить их по ответу нельзя. Если ротация прошла, локальный `refresh_token` мёртв независимо от повтора и нужна переавторизация приложения на портале. DNS-сбой на oauth-хосте под это правило не попадает: соединение не состоялось, значит повторяем.
 
-    Команды `callBatch` разбираются в обеих формах — кортеж `["crm.deal.add", {...}]` (основная в SDK 2.x) и объект `{ method, params }`. Если форму команды разобрать не удалось, вызов считается создающим и не повторяется: для защиты от дубликатов безопаснее ошибиться в сторону осторожности.
+    Команды `callBatch` разбираются в обеих формах — кортеж `["crm.deal.add", {...}]` (основная в SDK 2.x и 3.0) и объект `{ method, params }`. Если форму команды разобрать не удалось, вызов считается создающим и не повторяется: для защиты от дубликатов безопаснее ошибиться в сторону осторожности.
 
-    Важно: **транспортные сбои SDK не повторяет вообще** — пакет задаёт параметры ограничителя при создании клиента. Иначе гейт был бы дырявым: SDK не различает идемпотентные и создающие вызовы и повторил бы оборванный `crm.deal.add` до трёх раз внутри себя, куда наша защита не дотягивается. Измерено: без этих параметров обрыв соединения, 502 и 504 дают по три выполнения на портале, с ними — по одному.
+    Важно: **транспортные сбои SDK не повторяет вообще** — пакет задаёт параметры ограничителя при создании клиента. Иначе гейт был бы дырявым: SDK не различает идемпотентные и создающие вызовы и повторил бы оборванный `crm.deal.add` до трёх раз внутри себя, куда наша защита не дотягивается. Измерено: без этих параметров обрыв соединения, 502 и 504 дают по три выполнения на портале, с ними — по одному. На SDK 3.0.0 замер повторён и закреплён тестом `tests/sdk-executions.test.ts`: создающий вызов выполняется ровно один раз во всех сценариях сбоя.
 
     Повторы SDK при 429 и 503 сохранены: портал отвечает отказом, не выполнив запрос.
 
@@ -274,7 +277,9 @@ const sent = await fetchWithTimeout("https://api.example.com/send", { method: "P
 
     **«Мягкие» ошибки Bitrix24:**
 
-    Часть ошибок (`ERROR_ENTITY_NOT_FOUND`, `BITRIX_REST_V3_EXCEPTION_*`) SDK не бросает исключением, а возвращает как `AjaxResult` с ошибкой: `isSuccess === false`, и тогда `response.getData()` вернёт `undefined`. Отдельный случай — успешный ответ, у которого сам `result` пустой (`null`/`undefined`). Чтобы не падать на `undefined`, разбирайте ответы через `getResultData()` — он покрывает обе ситуации и бросает понятную ошибку с именем метода.
+    Часть ошибок (`ERROR_ENTITY_NOT_FOUND`, `BITRIX_REST_V3_EXCEPTION_*`) SDK не бросает исключением, а возвращает как `AjaxResult` с ошибкой: `isSuccess === false`, и тогда `response.getData()` вернёт `undefined`. У REST v3 (`$b24.actions.v3.*`) с SDK 3.0.0 «мягкой» стала ошибка 4xx, кроме 401, 408 и 429. Так ведут себя только ответы, пришедшие в конверте v3, с кодом вне жёсткого списка SDK (нехватка scope, `ACCESS_DENIED`, `NOT_FOUND`, `INVALID_ARG_VALUE`) и вне `hardErrorCodes` пакета; коды из этих списков по-прежнему бросаются, как и плоский ответ v2 от шлюза. Поэтому нужны и `catch`, и проверка `isSuccess`. Отдельный случай — успешный ответ, у которого сам `result` пустой (`null`/`undefined`). Чтобы не падать на `undefined`, разбирайте ответы через `getResultData()` — он покрывает обе ситуации и бросает понятную ошибку с именем метода.
+
+    **Ответ портала без JSON-конверта.** Если портал или прокси перед ним отдал со статусом 200 HTML-страницу, пустое тело или JSON без `result` и `error` (`{}`, `{ time }`), вызов бросает `JSSDK_UNKNOWN_ERROR` с понятным текстом: `портал вернул не JSON: HTTP 200, text/html, «<!DOCTYPE html>…»` или `портал вернул JSON без result и error: HTTP 200, …`. Без этой проверки SDK 3.0.0 принял бы такой ответ за успех — `crm.deal.add` вернул бы `{}` вместо ID сделки. Чтение повторяется с паузами 1-2-4-8 с, создающие вызовы не повторяются. Без конверта законно отвечают `rest.documentation.openapi` (через `$b24` не вызвать) и бинарные загрузки с `responseType`, отличным от `json` (`deferredBatch.download`), — их перехватчик пропускает.
 
     **Проактивное обновление токена:**
 
@@ -382,7 +387,18 @@ const sent = await fetchWithTimeout("https://api.example.com/send", { method: "P
 
     Без обёртки вызов `$b24.actions.*` идёт мимо защиты: ни повторов при сетевых сбоях, ни блокировки повтора для создающих методов.
 
--   **`B24Client`** — экспортируемый тип: `B24OAuth` плюс пять методов, которые пакет реализует сам. Объявлен как `interface B24Client extends B24OAuth`, поэтому `$b24` по-прежнему принимается везде, где ожидается `B24OAuth` — например в `new Smsgold(auth, $b24)`. Все пять сигнатур объявлены в интерфейсе явно, а не взяты по наследству: в SDK 3.x этих методов у базового класса не будет, и без явных объявлений тип потерял бы весь фасад. Держит их тест `tests/client-type.test.ts`: он читает текст `types.ts` (пропажу объявления система типов не видит — метод пока наследуется) и сверяет кортежи параметров строгим равенством типов, поэтому потеря необязательного аргумента или расширение параметра до `any` роняют `npx tsc --noEmit`.
+    **REST v3: проверяйте `isSuccess`.** С SDK 3.0.0 ошибки 4xx у `actions.v3.*` (кроме 401/408/429) не бросаются, а приходят в `AjaxResult` с `isSuccess === false`. `catch` вокруг `callProtected` их не поймает. Так ведут себя только ответы, пришедшие в конверте v3, с кодом вне жёсткого списка SDK (нехватка scope, `ACCESS_DENIED`, `NOT_FOUND`, `INVALID_ARG_VALUE`) и вне `hardErrorCodes` пакета; коды из этих списков по-прежнему бросаются, как и плоский ответ v2 от шлюза. Поэтому нужны и `catch`, и проверка `isSuccess`:
+
+    ```ts
+    const response = await callProtected(() => $b24!.actions.v3.call.make({ method: "tasks.task.get", params }), "tasks.task.get");
+    if (!response.isSuccess) {
+        throw new Error(`tasks.task.get: ${response.getErrorMessages().join("; ")}`);
+    }
+    ```
+
+    Или разбирайте через `getResultData(response, method)` — он бросит понятную ошибку сам. `callProtected` такой результат не повторяет: это не бросок, и 4xx от повтора не исправится. `actions.v3.callList.make` при ошибке отдаёт прочитанные строки **вместе** с ошибкой — тоже проверяйте `isSuccess`. Генераторы `fetchList`/`fetchTail` в `callProtected` не оборачиваются. `idempotencyKey` у `actions.v3.call.make` пакет пока не учитывает: блокировка повтора решается по имени метода.
+
+-   **`B24Client`** — экспортируемый тип: `B24OAuth` плюс пять методов, которые пакет реализует сам. Объявлен как `interface B24Client extends B24OAuth`, поэтому `$b24` по-прежнему принимается везде, где ожидается `B24OAuth` — например в `new Smsgold(auth, $b24)`. Все пять сигнатур объявлены в интерфейсе явно: в SDK 3.0.0 у базового класса этих методов нет, и пропажу объявления ловит тайпчек. Результаты `callListMethod`, `callBatch` и `callBatchByChunk` — `Promise<Result<any>>`, как и на 4.x: у самого SDK дефолт `Result<T>` теперь `unknown`. Тест `tests/client-type.test.ts` сверяет кортежи параметров и типы результата строгим равенством типов, поэтому потеря необязательного аргумента, расширение параметра до `any` или откат результата на голый `Result` роняют `npx tsc --noEmit`.
 
     ```ts
     import type { B24Client } from "@andrey4emk/npm-app-back-b24";
@@ -477,7 +493,7 @@ const sent = await fetchWithTimeout("https://api.example.com/send", { method: "P
     }
     ```
 
--   **`Event`** — класс для работы с офлайн-событиями Bitrix24. Можно создать свой экземпляр, передав `B24OAuth`.
+-   **`Event`** — класс для работы с офлайн-событиями Bitrix24. Можно создать свой экземпляр, передав `$b24` (голый `B24OAuth` с 5.0.0 не подходит — в нём нет `callMethod`).
 
     ```js
     import { Event } from "@andrey4emk/npm-app-back-b24";
@@ -681,7 +697,7 @@ const sent = await fetchWithTimeout("https://api.example.com/send", { method: "P
 
     const smsClient = new Smsgold(
         { user: "smsgold_login", pass: "smsgold_password" },
-        b24Instance, // опционально — экземпляр B24OAuth для загрузки файлов на диск
+        b24Instance, // опционально — $b24 для загрузки файлов на диск (голый B24OAuth с 5.0.0 не подходит)
         123456 // опционально — ID папки на диске B24 для вложений, по умолчанию 2792881
     );
     ```
@@ -1030,6 +1046,19 @@ CHATAPP_PASS=your-password
 CHATAPP_APP_ID=your-app-id
 ```
 
+## Миграция на 5.0.0
+
+Выпуск ломающий: пакет переехал на `@bitrix24/b24jssdk` 3.0.0. Вызовы методов фасада (`callMethod`, `callListMethod`, `fetchListMethod`, `callBatch`, `callBatchByChunk`) не меняются.
+
+1. **Node.js 22 или новее** — этого требует SDK 3.0.0.
+2. **Свою копию SDK поднять одновременно с пакетом.** Проектам, которые держат `@bitrix24/b24jssdk` своей зависимостью ради типов (`b24_rnp`, `b24_money`, `b24_analytics`), — до 3.0.0. Иначе в дереве будут две копии SDK с несовместимыми типами `B24OAuth`, и разбор ошибок через `instanceof` промахнётся.
+3. **Свои вызовы `$b24.actions.v3.*` проверять на `isSuccess`**, в том числе внутри `callProtected`: ошибки 4xx, кроме 401/408/429, больше не бросаются (см. «REST v3: проверяйте `isSuccess`»). Так ведут себя только ответы, пришедшие в конверте v3, с кодом вне жёсткого списка SDK (нехватка scope, `ACCESS_DENIED`, `NOT_FOUND`, `INVALID_ARG_VALUE`) и вне `hardErrorCodes` пакета; коды из этих списков по-прежнему бросаются, как и плоский ответ v2 от шлюза. Поэтому нужны и `catch`, и проверка `isSuccess`.
+4. **Удалённое API SDK мимо `$b24`** — `callMethod` у собственного `B24OAuth`, `LoggerBrowser`, `AbstractB24.batchSize` — перевести на `actions.v2.*`, `LoggerFactory` и литерал `50` соответственно.
+5. **В `new Event(...)` и `new Smsgold(..., b24)` передавать `$b24`**, а не голый `B24OAuth`: в нём больше нет `callMethod`.
+6. **Тип `$b24` в своих обёртках (`getB24`/`ensureB24`/`b24`) — `B24Client` из пакета, а не `B24OAuth` из SDK.** После подъёма своей копии SDK до 3.0.0 у `B24OAuth` нет `callMethod`/`callListMethod`/`callBatch`, и обёртка с таким типом перестанет компилироваться.
+7. **`Result` самого SDK по умолчанию `unknown`.** У методов фасада `any` сохранён, правок не нужно; у своего кода поверх `actions.*` указывайте параметр типа (`Result<Deal[]>`).
+8. **Ответ портала «200 без `result`» — всегда ошибка с понятным текстом** («портал вернул JSON без result и error» или «портал вернул не JSON»). На 4.x это была та же ошибка с текстом про `'operating'` либо «Bitrix24 вернул пустой ответ». Если вы разбирали эти тексты — замените разбор. Без конверта законно отвечают `rest.documentation.openapi` (через `$b24` не вызвать) и бинарные загрузки с `responseType`, отличным от `json` (`deferredBatch.download`), — их перехватчик пропускает.
+
 ## Миграция на 4.0.0
 
 Выпуск ломающий. Правок у потребителя четыре, все механические.
@@ -1105,7 +1134,7 @@ CHATAPP_APP_ID=your-app-id
 
 ## Скрипты
 
--   `npm run test` — прогон юнит-тестов из `tests/` через встроенный `node --test`. Дополнительных зависимостей не нужно: `.ts` запускаются на нативном стирании типов Node, поэтому прогону нужен Node 22.6+ (`engines: ">=20.3.0"` — это требование к потребителю пакета, а не к разработке). Сети тесты не касаются, в тарбол папка не попадает.
+-   `npm run test` — прогон юнит-тестов из `tests/` через встроенный `node --test`. Дополнительных зависимостей не нужно: `.ts` запускаются на нативном стирании типов Node, поэтому прогону нужен Node 22.6+ (`engines: ">=22.0.0"` — требование к потребителю пакета, его диктует SDK 3.0.0). Сети тесты не касаются, в тарбол папка не попадает.
 -   `npm run pack:dry` — предпросмотр содержимого пакета перед публикацией.
 
 ## Лицензия

package/bitrix24/b24/facade.ts

@@ -1,5 +1,5 @@
 import { Result } from "@bitrix24/b24jssdk";
-import type { AjaxResult, TypeCallParams, B24OAuth } from "@bitrix24/b24jssdk";
+import type { AjaxResult, TypeCallParamsV2, B24OAuth } from "@bitrix24/b24jssdk";
 import { logs } from "../../logs/logs.ts";
 import { getRetryBlockReason, runWithRetry } from "./retry.ts";
 import type { FacadeMethods, BatchCalls, V2Envelope } from "./types.ts";
@@ -62,7 +62,8 @@ export function getResultData<T = any>(response: AjaxResult, methodName: string)
  * конверта restApi:v2, но числового смещения среди них так и нет: `isMore()` отвечает
  * только «есть ли ещё», а `getNext(http)` сам делает следующий запрос, мимо нашего
  * прогресса и retry. Поэтому конверт читаем напрямую: `_data` объявлен `protected`,
- * а не приватным полем класса, поэтому в рантайме доступен.
+ * а не приватным полем класса, поэтому в рантайме доступен. В 3.0.0 всё это на месте:
+ * `_data` тот же, `getData()` по-прежнему режет конверт до `{ result, time }`.
  *
  * Это единственная точка связи с внутренностями SDK. Если она перестанет работать,
  * она обязана упасть громко: тихо оборванная на первой странице выборка — потеря данных.
@@ -80,7 +81,7 @@ export function readV2Envelope(response: AjaxResult, method: string): V2Envelope
 // ==================== Фасад поверх actions.v2.* ====================
 
 /**
- * Собственные реализации пяти методов, которые SDK 2.x помечает к удалению.
+ * Собственные реализации пяти методов, удалённых в SDK 3.0.0.
  * Повторяют `AbstractB24` дословно, включая дефолты и порядок аргументов.
  *
  * Позиционные сигнатуры сохранены один в один: на этом держится то, что гейт
@@ -95,6 +96,10 @@ export function readV2Envelope(response: AjaxResult, method: string): V2Envelope
  * (`for await (const chunk of $b24.fetchListMethod(...)) chunk.forEach((x) => x.ID)`).
  * `unknown` в дефолте уронил бы каждое такое место, не дав взамен ничего — узкий тип
  * задаётся параметром типа на месте вызова (`callMethod<Deal>(...)`).
+ *
+ * По той же причине `Promise<Result<any>>` у `callListMethod`, `callBatch` и `callBatchByChunk`:
+ * с SDK 3 дефолт `Result<T>` — `unknown`, и голый `Result` уронил бы код потребителей вида
+ * `(await $b24.callListMethod(...)).getData().forEach(...)`.
  */
 export function createFacade(target: B24OAuth): FacadeMethods {
     // Геттер actions при каждом обращении проверяет инициализацию экземпляра —
@@ -102,7 +107,7 @@ export function createFacade(target: B24OAuth): FacadeMethods {
     const v2 = () => target.actions.v2;
 
     const callMethod = async <T = any>(method: string, params?: object, start?: number): Promise<AjaxResult<T>> => {
-        const merged: TypeCallParams = { ...params };
+        const merged: TypeCallParamsV2 = { ...params };
 
         // Явный params.start приоритетнее аргумента start — как в AbstractB24.callMethod.
         // typeof, а не только Number.isInteger: последний ничего не сужает, и при
@@ -127,7 +132,7 @@ export function createFacade(target: B24OAuth): FacadeMethods {
         params?: object,
         progress?: null | ((progress: number) => void),
         customKeyForResult?: string | null
-    ): Promise<Result> => {
+    ): Promise<Result<any>> => {
         const result = new Result();
         const onProgress = typeof progress === "function" ? progress : null;
 
@@ -211,16 +216,17 @@ export function createFacade(target: B24OAuth): FacadeMethods {
      * поэтому отданные страницы не теряются и не дублируются.
      *
      * Форма запроса взята из `fetch-list.mjs`: `start: -1`, навязанный
-     * `order: { <курсор>: "ASC" }`, фильтр `>курсор`. Отступления от SDK — пять,
+     * `order: { <курсор>: "ASC" }`, фильтр `>курсор`. Отступления от SDK — три,
      * все намеренные:
      *   1. остановка только на пустой странице, а не на короткой: страница, укороченная
      *      правами доступа, у портала штатна, и правило SDK молча обрезало бы выборку;
      *   2. нечитаемый курсор — бросок, а не предупреждение и тихая остановка:
      *      после пункта 1 он означает гарантированно неполную выборку;
-     *   3. потолок страниц (`FETCH_LIST_MAX_PAGES`) — у SDK цикл ничем не ограничен;
-     *   4. проверка роста курсора — портал, отбросивший неизвестный ключ фильтра,
-     *      иначе отдавал бы одну и ту же страницу вечно;
-     *   5. пустая строка в `customKeyForResult` трактуется как «ключ не передан».
+     *   3. пустая строка в `customKeyForResult` трактуется как «ключ не передан».
+     *
+     * Потолок страниц (`FETCH_LIST_MAX_PAGES`) и проверка роста курсора (портал,
+     * отбросивший неизвестный ключ фильтра, иначе отдавал бы одну и ту же страницу
+     * вечно) есть и у SDK 3.0.0, у нас свои пороги и свой текст ошибки.
      *
      * Плюс диагностика: ошибки называют метод B24 вместо `TypeError` из недр SDK
      * и `SdkError` с кодом SDK.
@@ -232,7 +238,7 @@ export function createFacade(target: B24OAuth): FacadeMethods {
      */
     async function* fetchListMethod(method: string, params?: any, idKey?: string, customKeyForResult?: string | null): AsyncGenerator<any[]> {
         // Отдельного cursorIdKey, как в опциях SDK, у нас нет и не будет: позиционная
-        // сигнатура deprecated-метода его не содержала, а добавление пятого аргумента —
+        // сигнатура удалённого метода SDK его не содержала, а добавление пятого аргумента —
         // расширение публичного API. У SDK он по умолчанию тоже равен idKey
         const cursorKey = idKey ?? "ID";
         const moreKey = `>${cursorKey}`;
@@ -279,7 +285,7 @@ export function createFacade(target: B24OAuth): FacadeMethods {
             // курсор в нём двигается только после успешной страницы — поэтому повтор
             // попадает ровно в ту же страницу, а не в следующую
             const response = await runWithRetry(
-                () => v2().call.make<any>({ method, params: requestParams as TypeCallParams }),
+                () => v2().call.make<any>({ method, params: requestParams as TypeCallParamsV2 }),
                 "$b24.fetchListMethod",
                 blockReason
             );
@@ -348,7 +354,7 @@ export function createFacade(target: B24OAuth): FacadeMethods {
         }
     }
 
-    const callBatch = async (calls: Array<any> | object, isHaltOnError?: boolean, returnAjaxResult?: boolean): Promise<Result> => {
+    const callBatch = async (calls: Array<any> | object, isHaltOnError?: boolean, returnAjaxResult?: boolean): Promise<Result<any>> => {
         // Дефолты подставляем мы: batch.make своих не имеет, он просто
         // расширяет переданный объект опций версией API
         return v2().batch.make({
@@ -360,7 +366,7 @@ export function createFacade(target: B24OAuth): FacadeMethods {
         });
     };
 
-    const callBatchByChunk = async (calls: Array<any>, isHaltOnError: boolean): Promise<Result> => {
+    const callBatchByChunk = async (calls: Array<any>, isHaltOnError: boolean): Promise<Result<any>> => {
         // isHaltOnError передаём как есть, без ?? true — дословно по AbstractB24.
         // returnAjaxResult не передаём: batchByChunk.make жёстко ставит false сам,
         // а его тип опций этот ключ не принимает

package/bitrix24/b24/instance.ts

@@ -1,6 +1,7 @@
-import { B24OAuth, Logger, LogLevel } from "@bitrix24/b24jssdk";
+import { ApiVersion, B24OAuth, Logger, LogLevel } from "@bitrix24/b24jssdk";
 import type { B24OAuthParams, B24OAuthSecret, AuthData, Handler, LogRecord, Formatter, RestrictionParams } from "@bitrix24/b24jssdk";
 import { logs } from "../../logs/logs.ts";
+import { installJsonGuard } from "./nonJsonResponse.ts";
 import { APP_ENV, CLIENT_ID, CLIENT_SECRET, confAuthB24, cleanDomain } from "./config.ts";
 
 // ==================== Константы ====================
@@ -182,5 +183,13 @@ export function createB24Instance(): B24OAuth | null {
     // прямо в console.warn, но после перехода на фасад этот путь у нас недостижим.
     b24.setLogger(Logger.create("npm-app-back-b24").pushHandler(new B24SdkLogHandler()));
 
+    // Ответ без JSON-конверта (HTML-страница прокси, пустое тело, JSON без result и error)
+    // превращаем в понятную ошибку со статусом и началом тела: SDK 3 принял бы такой
+    // ответ за успех (T-65, #469). Перехватчик обязателен. Ставим на оба клиента:
+    // v3 ходит через свой axios. Обмен refresh-токена идёт отдельным экземпляром
+    // axios и проверку не получает
+    installJsonGuard(b24.getHttpClient(ApiVersion.v2).ajaxClient);
+    installJsonGuard(b24.getHttpClient(ApiVersion.v3).ajaxClient);
+
     return b24;
 }

package/bitrix24/b24/nonJsonResponse.ts

@@ -0,0 +1,161 @@
+import { SdkError } from "@bitrix24/b24jssdk";
+
+/**
+ * Распознавание ответа портала, который не является JSON-конвертом REST.
+ *
+ * Сценарий из логов 29.09.2026 (T-65): портал или прокси на его пути несколько секунд
+ * отдавал HTML-страницу со статусом 200. axios с настройками по умолчанию нечитаемый
+ * JSON не бросает, а молча отдаёт строку. SDK 2.x падал на ней в лимитере с безликим
+ * «Cannot destructure property 'operating'». SDK 3.0.0 не падает вовсе: любое тело без
+ * ключа `result` он заворачивает в `result` и отдаёт как успех (#469). HTML-страница
+ * прокси приходит потребителю строкой в `getData().result`, а ответ `{}` или `{ time }`
+ * превращает `crm.deal.add` в «успешный» вызов без ID сделки.
+ *
+ * Поэтому проверка стоит раньше SDK — перехватчиком ответа на axios-клиенте самого SDK
+ * (официальная точка доступа `getHttpClient(version).ajaxClient`). Она единственное, что
+ * отделяет страницу прокси от «успешного» ответа. Пропускается только объект с ключом
+ * `result` или `error` — успех (`{ result, time }`) или ошибка (`{ error, error_description }`
+ * у v2, `{ error: { code, message } }` у v3). Всё остальное — строка, пустое тело, массив,
+ * объект без конверта — превращается в B24NonJsonResponseError со статусом, типом содержимого
+ * и началом тела. SDK заворачивает её в `JSSDK_UNKNOWN_ERROR` (он в его жёстком списке — сам
+ * SDK не повторяет) и кладёт целиком в `originalError`, а retry-слой пакета по ней узнаёт
+ * временный сбой портала и повторяет с нарастающей паузой.
+ *
+ * Без конверта законно отвечают `rest.documentation.openapi` (через `$b24` не вызвать) и
+ * бинарные загрузки с `responseType`, отличным от `json` (`deferredBatch.download`), — их
+ * перехватчик пропускает. Сами запросы REST у SDK `responseType` не задают.
+ */
+
+/** Сколько символов тела попадает в сообщение об ошибке */
+export const NON_JSON_BODY_PREVIEW = 200;
+
+/**
+ * Вид сбоя: `not-json` — тело не объект (HTML, пустое, обрезанное),
+ * `no-envelope` — разобранный JSON без ключей `result` и `error`
+ */
+export type NonJsonResponseKind = "not-json" | "no-envelope";
+
+/** Ответ портала без JSON-конверта REST: HTML-страница прокси, пустое тело, JSON без result и error */
+export class B24NonJsonResponseError extends Error {
+    /** HTTP-статус ответа */
+    readonly status: number;
+    /** Заголовок Content-Type, если пришёл */
+    readonly contentType: string;
+    /** Начало тела без лишних пробелов, не длиннее NON_JSON_BODY_PREVIEW */
+    readonly bodyPreview: string;
+    /** Вид сбоя */
+    readonly kind: NonJsonResponseKind;
+
+    constructor(status: number, contentType: string, bodyPreview: string, kind: NonJsonResponseKind = "not-json") {
+        const type = contentType || "тип не указан";
+        const body = bodyPreview ? `«${bodyPreview}»` : "пустое тело";
+        const what = kind === "no-envelope" ? "JSON без result и error" : "не JSON";
+        super(`портал вернул ${what}: HTTP ${status}, ${type}, ${body}`);
+        this.name = "B24NonJsonResponseError";
+        this.status = status;
+        this.contentType = contentType;
+        this.bodyPreview = bodyPreview;
+        this.kind = kind;
+    }
+}
+
+/** Минимальная форма ответа axios, которую читает перехватчик */
+export interface AxiosLikeResponse {
+    status: number;
+    data: unknown;
+    headers?: unknown;
+    /** Настройки запроса: `responseType` говорит, какое тело ждёт вызывающий */
+    config?: { responseType?: string };
+}
+
+/**
+ * Минимальная форма axios-клиента: только регистрация перехватчика ответа.
+ * Параметр типа — конкретный тип ответа клиента (у axios — AxiosResponse): перехватчик
+ * обязан вернуть ровно его, а не урезанную структурную форму.
+ */
+export interface AxiosLikeClient<R extends AxiosLikeResponse> {
+    interceptors: {
+        response: {
+            use: (onFulfilled: (response: R) => R) => unknown;
+        };
+    };
+}
+
+/** Читает Content-Type и из AxiosHeaders (метод get), и из обычного объекта */
+function readContentType(headers: unknown): string {
+    if (!headers || typeof headers !== "object") return "";
+
+    const getter = (headers as { get?: unknown }).get;
+    const value = typeof getter === "function" ? getter.call(headers, "content-type") : (headers as Record<string, unknown>)["content-type"];
+
+    return typeof value === "string" ? value : "";
+}
+
+/** Тело как текст: разобранный JSON без конверта показываем как JSON, а не «[object Object]» */
+function bodyToText(data: unknown): string {
+    if (typeof data === "string") return data;
+    if (typeof data !== "object") return String(data);
+
+    try {
+        return JSON.stringify(data) ?? String(data);
+    } catch {
+        return String(data);
+    }
+}
+
+/** Начало тела одной строкой: переводы строк и повторные пробелы схлопываются */
+function previewBody(data: unknown): string {
+    if (data === undefined || data === null) return "";
+
+    const flat = bodyToText(data).replace(/\s+/g, " ").trim();
+
+    return flat.length > NON_JSON_BODY_PREVIEW ? `${flat.slice(0, NON_JSON_BODY_PREVIEW)}…` : flat;
+}
+
+/**
+ * Пропускает ответ дальше, если в теле объект с ключом `result` или `error`,
+ * иначе бросает B24NonJsonResponseError.
+ *
+ * Объект с конвертом — единственная законная форма тела REST: и успех (`{result, time}`),
+ * и ошибка (`{error, error_description}` или `{error: {code, message}}`). Строка означает,
+ * что axios не смог разобрать JSON, пустое тело — что ответа по сути нет. Объект без обоих
+ * ключей (`{}`, `{ time }`) и массив SDK 3 принял бы за успех с мусором в `result`.
+ *
+ * Исключение — запрос, который сам попросил не JSON (`responseType` задан и не `json`):
+ * так SDK скачивает файл в `deferredBatch.download` (`arraybuffer`). Такой ответ
+ * пропускается без проверки.
+ */
+export function assertJsonResponse<R extends AxiosLikeResponse>(response: R): R {
+    const responseType = response.config?.responseType;
+    if (responseType && responseType !== "json") return response;
+
+    const { data } = response;
+    const status = response.status;
+    const contentType = readContentType(response.headers);
+
+    if (data === null || typeof data !== "object") {
+        throw new B24NonJsonResponseError(status, contentType, previewBody(data), "not-json");
+    }
+
+    if (!Array.isArray(data) && ("result" in data || "error" in data)) return response;
+
+    throw new B24NonJsonResponseError(status, contentType, previewBody(data), "no-envelope");
+}
+
+/** Ставит проверку тела на axios-клиент SDK */
+export function installJsonGuard<R extends AxiosLikeResponse>(client: AxiosLikeClient<R>): void {
+    client.interceptors.response.use((response) => assertJsonResponse(response));
+}
+
+/**
+ * Пришла ли ошибка от ответа портала без JSON-конверта.
+ *
+ * Смотрит и на саму ошибку, и на `originalError` — SDK кладёт нашу ошибку туда,
+ * заворачивая её в `JSSDK_UNKNOWN_ERROR`.
+ */
+export function isNonJsonResponseError(error: unknown): boolean {
+    if (error instanceof B24NonJsonResponseError) return true;
+    if (!(error instanceof SdkError)) return false;
+
+    return error.originalError instanceof B24NonJsonResponseError;
+}

package/bitrix24/b24/proxy.ts

@@ -16,8 +16,8 @@ const RETRYABLE_METHOD_NAMES = ["callMethod", "callListMethod", "callBatch"] as
  * Имена, которые Proxy резолвит в собственную реализацию пакета поверх `actions.v2.*`.
  *
  * Шире, чем RETRYABLE_METHOD_NAMES: `fetchListMethod` и `callBatchByChunk` мы реализуем,
- * но не ретраим. `callBatchByChunk` в наборе обязателен — пока хоть один deprecated-метод
- * SDK достижим через `$b24`, он будет писать предупреждение об устаревании.
+ * но не ретраим. `callBatchByChunk` в наборе обязателен: в SDK 3.0.0 метода на цели нет,
+ * и без него `Reflect.get` вернул бы `undefined`.
  *
  * `satisfies` ловит опечатку и переименование: имя, которого нет среди методов фасада,
  * уронит тайпчек здесь, а не молча уедет мимо Proxy в SDK.
@@ -78,8 +78,8 @@ export function wrapB24WithRetry(b24: B24OAuth): B24Client {
 
     return new Proxy(b24, {
         get(target, prop) {
-            // Имена фасада проверяем до Reflect.get: пока SDK ещё объявляет свои
-            // deprecated-методы, иначе мы отдавали бы их, а не свои
+            // Имена фасада проверяем до Reflect.get. SDK 3.0.0 их не объявляет, проверка
+            // остаётся на случай, если имя вернётся в SDK: отдавать надо своё, а не его
             if (typeof prop === "string" && isFacadeMethod(prop)) {
                 if (!methodCache.has(prop)) {
                     // Индексируем внутри ветки: после сужения prop до RetryableMethodName
@@ -109,8 +109,8 @@ export function wrapB24WithRetry(b24: B24OAuth): B24Client {
             return methodCache.get(prop);
         },
 
-        // Страховка на будущее: когда SDK уберёт методы из прототипа,
-        // "callMethod" in $b24 обязано остаться истинным (eventB24.ts проверяет
+        // Нужна: в SDK 3.0.0 методов фасада на цели нет, а
+        // "callMethod" in $b24 обязано быть истинным (eventB24.ts проверяет
         // наличие метода перед работой). Цель расширяема, лишние true законны
         has(target, prop) {
             if (typeof prop === "string" && FACADE_METHODS.has(prop)) return true;

package/bitrix24/b24/retry.ts

@@ -1,6 +1,7 @@
 import { AjaxError, RefreshTokenError, SdkError } from "@bitrix24/b24jssdk";
 import { logs } from "../../logs/logs.ts";
 import { isNetworkError, isPreConnectionError } from "../../utils/fetchRetry.ts";
+import { isNonJsonResponseError } from "./nonJsonResponse.ts";
 
 // ==================== Типы ====================
 
@@ -20,6 +21,15 @@ export type AsyncFn = (...args: never[]) => Promise<unknown>;
 export const RETRY_COUNT = 5;
 /** Задержка между попытками (мс) */
 export const RETRY_DELAY_MS = 500;
+/**
+ * Первая пауза при ответе портала без JSON (HTML-страница прокси, пустое тело), мс.
+ * Дальше пауза удваивается: 1, 2, 4, 8 с — пять попыток растягиваются на 15 секунд.
+ *
+ * Ровная пауза в 500 мс укладывала все пять попыток в 2 секунды, а сбой 29.09.2026
+ * длился около трёх (T-65): повторы закончились раньше, чем портал пришёл в себя.
+ * Транспортные сбои по-прежнему идут с ровной паузой — растягивать их причины нет.
+ */
+export const NON_JSON_RETRY_BASE_DELAY_MS = 1000;
 
 /**
  * Коды транспортного сбоя. Один набор и для SdkError (AjaxError, RefreshTokenError),
@@ -113,6 +123,16 @@ function normalizeMethodName(raw: string): string {
     return head.replace(/\.json$/, "");
 }
 
+/**
+ * Пауза перед следующей попыткой: нарастающая для ответа без JSON, ровная для остального.
+ *
+ * @param error — ошибка упавшей попытки
+ * @param attempt — номер упавшей попытки, с единицы
+ */
+export function retryDelayFor(error: unknown, attempt: number): number {
+    return isNonJsonResponseError(error) ? NON_JSON_RETRY_BASE_DELAY_MS * 2 ** (attempt - 1) : RETRY_DELAY_MS;
+}
+
 /** Фраза для лога: повтор отменён, потому что вызов создаёт сущности */
 const creatingReason = (what: string): string => `вызов создаёт сущности (${what})`;
 
@@ -146,11 +166,16 @@ const reservingReason = (what: string): string => `вызов резервиру
  */
 export function isB24NetworkError(error: unknown): boolean {
     if (error instanceof AjaxError) {
-        // Практически недостижимо (SDK бросает реальную ошибку раньше),
+        // Практически недостижимо в SDK 2.x и 3.0 (SDK бросает реальную ошибку раньше),
         // но если код всё же пришёл — SDK уже исчерпал свои попытки
         if (error.code === "JSSDK_CALL_ALL_ATTEMPTS_EXHAUSTED") return false;
     }
 
+    // Портал (или прокси перед ним) отдал не JSON — временный сбой на его стороне,
+    // повтор осмыслен. Сегодня такая ошибка прошла бы и веткой status 0, но держаться
+    // за случайность формы обёртки SDK не хочется: признак проверяется явно
+    if (isNonJsonResponseError(error)) return true;
+
     if (error instanceof SdkError) {
         const { code, originalError, status } = error;
         const originalCode = (originalError as { code?: string } | undefined)?.code;
@@ -254,7 +279,7 @@ export function refreshFailureCode(error: unknown): string {
  * Возвращает null, если форма команды не распознана.
  */
 export function extractBatchCommandMethod(cmd: unknown): string | null {
-    // Кортеж ["crm.deal.add", { ... }] — основная форма в SDK 2.x
+    // Кортеж ["crm.deal.add", { ... }] — основная форма в SDK 2.x и 3.0
     if (Array.isArray(cmd)) {
         return typeof cmd[0] === "string" ? cmd[0] : null;
     }
@@ -265,7 +290,7 @@ export function extractBatchCommandMethod(cmd: unknown): string | null {
         return typeof method === "string" ? method : null;
     }
 
-    // Строка "crm.deal.add?ID=1" — в SDK 2.x эта форма уже не поддерживается
+    // Строка "crm.deal.add?ID=1" — в SDK 2.x и 3.0 эта форма не поддерживается
     // (ParseRow бросает JSSDK_INTERACTION_BATCH_ROW_FAIL), разбираем на случай,
     // если потребитель остался на ней со старой версии
     if (typeof cmd === "string") {
@@ -429,12 +454,13 @@ export async function runWithRetry<T>(fn: () => Promise<T>, label: string, block
 
             // Начало строки менять нельзя: по «попытка N/5 не удалась» грепают в логах
             const lifted = blockReason ? ` — соединение не состоялось, ограничение (${blockReason}) снято` : "";
+            const pause = retryDelayFor(error, attempt);
 
             // Промежуточные попытки — warn: в чат B24 уходит только уровень error,
             // иначе один упавший вызов дал бы пять сообщений
-            logs.add(`${label}${code}: попытка ${attempt}/${RETRY_COUNT} не удалась (${msg}), повтор через ${RETRY_DELAY_MS}мс${lifted}`, "warn");
+            logs.add(`${label}${code}: попытка ${attempt}/${RETRY_COUNT} не удалась (${msg}), повтор через ${pause}мс${lifted}`, "warn");
 
-            await delay(RETRY_DELAY_MS);
+            await delay(pause);
         }
     }
 

package/bitrix24/b24/types.ts

@@ -31,19 +31,20 @@ export interface AuthSaveResponse {
 /**
  * `B24OAuth` плюс пять методов, которые пакет реализует сам поверх `actions.v2.*`.
  *
- * SDK 2.x помечает `callMethod`/`callListMethod`/`fetchListMethod`/`callBatch`/`callBatchByChunk`
- * к удалению в следующем major. Пакет предоставляет их сам, поэтому сигнатуры для потребителя
- * не меняются, а зависимости от удаляемого API у нас больше нет.
+ * В SDK 3.0.0 `callMethod`/`callListMethod`/`fetchListMethod`/`callBatch`/`callBatchByChunk`
+ * из `AbstractB24` удалены. Пакет предоставляет их сам, поэтому сигнатуры для потребителя
+ * не меняются, а зависимости от удалённого API у нас нет.
  *
  * Тип расширяет `B24OAuth`, поэтому `$b24` по-прежнему передаётся туда, где ждут `B24OAuth`
  * (`new Smsgold(auth, $b24)`, `new Event($b24)`).
  *
- * Пять сигнатур ниже объявлены НАМЕРЕННО и сегодня дублируют то, что и так приходит
- * по наследству от `B24OAuth`. Удалять их нельзя: в SDK 3.x этих методов в `AbstractB24`
- * не будет, и вместе с ними из типа пропадёт вся поверхность фасада — а тайпчек на
- * SDK 2.2.0 останется зелёным, то есть пропажа обнаружится только у потребителя.
- * Страховка от «уборки дублей» — `tests/client-type.test.ts`: он читает текст этого
- * файла и падает, если хоть одно объявление отсюда исчезло.
+ * Пять сигнатур ниже — единственный источник поверхности фасада: по наследству от `B24OAuth`
+ * они больше не приходят. Пропажу любого объявления ловит тайпчек самого пакета —
+ * `FacadeMethods` ниже и эталон в `tests/client-type.test.ts` берут их через `Pick`.
+ *
+ * `Promise<Result<any>>`, а не голый `Result`: с SDK 3 дефолт `Result<T>` — `unknown`,
+ * и код потребителей `(await $b24.callListMethod(...)).getData().forEach(...)` перестал бы
+ * компилироваться. Обоснование то же, что у остальных `any` ниже.
  *
  * `any` в сигнатурах оставлен НАМЕРЕННО и снятию по T-53 не подлежит: это дефолты
  * дженериков публичной поверхности, дословно повторяющие `AbstractB24`. На них стоит
@@ -54,28 +55,28 @@ export interface AuthSaveResponse {
  */
 export interface B24Client extends B24OAuth {
     callMethod<T = any>(method: string, params?: object, start?: number): Promise<AjaxResult<T>>;
-    callListMethod(method: string, params?: object, progress?: null | ((progress: number) => void), customKeyForResult?: string | null): Promise<Result>;
+    callListMethod(method: string, params?: object, progress?: null | ((progress: number) => void), customKeyForResult?: string | null): Promise<Result<any>>;
     fetchListMethod(method: string, params?: any, idKey?: string, customKeyForResult?: string | null): AsyncGenerator<any[]>;
-    callBatch(calls: Array<any> | object, isHaltOnError?: boolean, returnAjaxResult?: boolean): Promise<Result>;
-    callBatchByChunk(calls: Array<any>, isHaltOnError: boolean): Promise<Result>;
+    callBatch(calls: Array<any> | object, isHaltOnError?: boolean, returnAjaxResult?: boolean): Promise<Result<any>>;
+    callBatchByChunk(calls: Array<any>, isHaltOnError: boolean): Promise<Result<any>>;
 }
 
 /**
  * Минимальный контракт «умеет вызывать REST-методы B24».
  *
  * Нужен внутренним классам (`Event`, `Smsgold`), которые принимают экземпляр извне.
- * Объявляет `callMethod` сам, поэтому переживёт удаление метода из `B24OAuth`.
+ * Объявляет `callMethod` сам: в `B24OAuth` этого метода нет с SDK 3.0.0.
  *
  * Объединение `B24OAuth | B24Client` эту задачу не решает: `B24Client` расширяет
  * `B24OAuth`, union схлопывается в супертип, а вызов метода на union требует его
- * наличия в обеих ветках — то есть после удаления из SDK тайпчек сломается всё равно.
+ * наличия в обеих ветках.
  *
- * Структурный тип шире `B24OAuth`, поэтому публичные сигнатуры конструкторов
- * не сужаются: и `B24OAuth`, и `$b24`, и любой свой объект с `callMethod` подходят.
+ * Голый `B24OAuth` под этот тип с SDK 3.0.0 не подходит — передавать нужно `$b24`
+ * (или любой свой объект с `callMethod`).
  */
 export interface B24MethodCaller {
-    // Дженерика здесь быть не должно: у SDK метод не generic, и `B24OAuth`
-    // потребителя перестал бы подходить под этот тип. Проверено тайпчеком
+    // Дженерика нет, чтобы не расширять публичный тип без нужды: внутренние
+    // классы читают ответ через getResultData(), параметр типа им не нужен
     callMethod(method: string, params?: object, start?: number): Promise<AjaxResult>;
 }
 

package/bitrix24/eventB24.ts

@@ -232,8 +232,8 @@ function classifyEntityEvent(raw: unknown, requestedEventName: string): EntityVe
  * Класс для работы с офлайн-событиями Bitrix24
  */
 export class Event {
-    // Структурный тип, а не B24OAuth: объявляет callMethod сам, поэтому переживёт
-    // удаление метода из SDK. Сигнатуру конструктора не сужает — она стала шире
+    // Структурный тип, а не B24OAuth: объявляет callMethod сам — метода в B24OAuth
+    // нет с SDK 3.0.0, поэтому передавать нужно $b24, а не голый B24OAuth
     private b24: B24MethodCaller;
 
     /** Расширения видео-файлов */

package/logs/logs.ts

@@ -39,6 +39,17 @@ const B24_TEXT_LIMIT = 4000;
  */
 const B24_CHAT_TIMEOUT_MS = 5_000;
 
+/** Сколько символов тела неуспешного ответа чата показывать в `console.error` */
+const B24_CHAT_BODY_PREVIEW = 300;
+
+/**
+ * Ошибка — обрыв по бюджету `AbortSignal.timeout`. Проверка локальная, без импорта
+ * `isTimeoutError` из `utils/fetchRetry.ts` — тот модуль импортирует `logs`, был бы цикл
+ */
+function isTimeout(error: unknown): boolean {
+    return (error as { name?: unknown } | null)?.name === "TimeoutError";
+}
+
 // ==================== Настройки ====================
 
 const configDir: string = process.env.CONFIG_DIR || "../config";
@@ -198,31 +209,70 @@ class LogsAPI {
             text = this.stripBbCodes(text);
         }
 
-        fetch(url, {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({
-                BOT_ID: B24_BOT_ID,
-                CLIENT_ID: B24_CLIENT_ID,
-                DIALOG_ID: this.b24ChatId,
-                MESSAGE: text,
-            }),
-            signal: AbortSignal.timeout(B24_CHAT_TIMEOUT_MS),
-        })
-            .then((response) => {
-                if (!response.ok) {
-                    console.error(`Logs B24 Chat: HTTP ${response.status}`);
-                }
-            })
-            .catch((error: unknown) => {
-                // Проверка локальная, без импорта isTimeoutError — тот модуль импортирует logs
-                if ((error as { name?: unknown })?.name === "TimeoutError") {
-                    console.error(`Logs B24 Chat: не ответил за ${B24_CHAT_TIMEOUT_MS / 1000}с, сообщение не доставлено`);
-                    return;
-                }
-                const errMsg = error instanceof Error ? error.message : String(error);
-                console.error(`Logs B24 Chat: ошибка отправки — ${errMsg}`);
+        void this.postToB24Chat(url, text);
+    }
+
+    /**
+     * Сам запрос в чат и разбор ответа. Никогда не бросает: все ошибки — в `console.error`,
+     * не через `logs`, иначе отказ канала порождал бы новый error и зацикливался.
+     *
+     * Сигнал `AbortSignal.timeout` отдан в `fetch`, а он действует и на чтение тела
+     * ответа: зависшее тело обрывается тем же бюджетом с `TimeoutError`. До общего `catch`
+     * такая ошибка не доходит — у каждого чтения тела свой `.catch`, поэтому таймаут
+     * разбирается прямо там: при `!ok` к статусу дописывается пометка «тело не дочитано»,
+     * при 200 пишется отдельная строка «доставка не подтверждена».
+     */
+    private async postToB24Chat(url: string, text: string): Promise<void> {
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    BOT_ID: B24_BOT_ID,
+                    CLIENT_ID: B24_CLIENT_ID,
+                    DIALOG_ID: this.b24ChatId,
+                    MESSAGE: text,
+                }),
+                signal: AbortSignal.timeout(B24_CHAT_TIMEOUT_MS),
+            });
+
+            if (!response.ok) {
+                // Тело — подсказка к причине отказа, его чтение отправку уронить не должно
+                const body = await response.text().catch((error: unknown) =>
+                    isTimeout(error) ? `[тело не дочитано за ${B24_CHAT_TIMEOUT_MS / 1000}с]` : "",
+                );
+                const bodyPart = body ? ` — ${body.slice(0, B24_CHAT_BODY_PREVIEW)}` : "";
+                console.error(`Logs B24 Chat: HTTP ${response.status}, сообщение не доставлено${bodyPart}`);
+                return;
+            }
+
+            // B24 умеет отвечать 200 с телом {error, error_description} — сообщения при этом нет.
+            // Нечитаемый JSON — молча null (портал ответил 200, ошибки в теле не видно),
+            // а вот зависшее тело — отказ канала: доставку подтвердить нечем, молчать нельзя
+            let bodyTimedOut = false;
+            const data: unknown = await response.json().catch((error: unknown) => {
+                bodyTimedOut = isTimeout(error);
+                return null;
             });
+            if (bodyTimedOut) {
+                console.error(
+                    `Logs B24 Chat: HTTP ${response.status}, но ответ не дочитан за ${B24_CHAT_TIMEOUT_MS / 1000}с — доставка не подтверждена`,
+                );
+                return;
+            }
+            if (data && typeof data === "object" && "error" in data) {
+                const { error, error_description: description } = data as { error?: unknown; error_description?: unknown };
+                const reason = description ? String(description) : String(error);
+                console.error(`Logs B24 Chat: портал отклонил сообщение — ${reason}`);
+            }
+        } catch (error: unknown) {
+            if (isTimeout(error)) {
+                console.error(`Logs B24 Chat: не ответил за ${B24_CHAT_TIMEOUT_MS / 1000}с, сообщение не доставлено`);
+                return;
+            }
+            const errMsg = error instanceof Error ? error.message : String(error);
+            console.error(`Logs B24 Chat: ошибка отправки — ${errMsg}`);
+        }
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@andrey4emk/npm-app-back-b24",
-    "version": "4.0.1",
+    "version": "5.0.0",
     "description": "Bitrix24 OAuth helpers for Node.js projects",
     "main": "index.ts",
     "type": "module",
@@ -20,7 +20,7 @@
     },
     "keywords": [],
     "engines": {
-        "node": ">=20.3.0"
+        "node": ">=22.0.0"
     },
     "author": "andrey4emk",
     "license": "MIT",
@@ -35,6 +35,7 @@
         "bitrix24/b24/config.ts",
         "bitrix24/b24/state.ts",
         "bitrix24/b24/retry.ts",
+        "bitrix24/b24/nonJsonResponse.ts",
         "bitrix24/b24/facade.ts",
         "bitrix24/b24/proxy.ts",
         "bitrix24/b24/instance.ts",
@@ -49,14 +50,14 @@
         "utils/fetchRetry.ts"
     ],
     "dependencies": {
-        "@bitrix24/b24jssdk": "2.2.0",
+        "@bitrix24/b24jssdk": "3.0.0",
         "conf": "15.1.0",
         "dotenv": "17.4.2",
         "luxon": "3.7.2"
     },
     "devDependencies": {
         "@types/express": "5.0.6",
-        "@types/luxon": "3.7.4",
+        "@types/luxon": "3.7.6",
         "@types/node": "25.9.5",
         "@types/nodemailer": "8.0.1",
         "nodemailer": "9.0.5"

package/sendMessage/smsgold.ts

@@ -59,8 +59,8 @@ interface SmsResult {
 export class Smsgold {
     private user: string;
     private pass: string;
-    // Структурный тип, а не B24OAuth: объявляет callMethod сам, поэтому переживёт
-    // удаление метода из SDK. Сигнатуру конструктора не сужает — она стала шире
+    // Структурный тип, а не B24OAuth: объявляет callMethod сам — метода в B24OAuth
+    // нет с SDK 3.0.0, поэтому передавать нужно $b24, а не голый B24OAuth
     private b24: B24MethodCaller | null;
     // ID папки на диске B24 для вложений SMS — параметр, а не константа модуля
     private uploadFolderId: number;