bx-rest 1.3.0 → 1.5.0

package/functions/errors.d.ts

@@ -11,7 +11,22 @@ export interface BXRestApiErrorDetails {
      * the full response body (including REST v3 `validation`).
      */
     cause?: unknown;
+    /**
+     * Why `BXRestSettings.auth.refresh` failed, when the request failed with
+     * an authorization error and the refresh could not fix it.
+     */
+    authRefreshError?: unknown;
 }
+/**
+ * Why `BXRestSettings.auth.refresh` failed. When a request fails with an
+ * authorization error and the refresh fails too, the library rethrows the
+ * original request error and puts the refresh failure into its
+ * `authRefreshError` field — on the `AxiosError` of `.resVanilla()` and the
+ * like, and on the `BXRestApiError` / `Error` of `.res()`.
+ *
+ * Returns `undefined` when there was no refresh or it succeeded.
+ */
+export declare function getAuthRefreshError(error: unknown): unknown;
 /**
  * A Bitrix-level API error, e.g. `INSUFFICIENT_SCOPE` or `expired_token`.
  *
@@ -20,12 +35,15 @@ export interface BXRestApiErrorDetails {
  * the error comes in the body of a 2xx response, `.res()` resolves as
  * `undefined` by default and fails with it only with
  * `{ throwOnApiError: true }` — see the "Error handling" section of the README.
+ * `.resAll()` always fails with it on an error in the body of a 2xx response.
  */
 export declare class BXRestApiError extends Error {
     error: string | undefined;
     error_description: string | undefined;
     readonly status: number | undefined;
     readonly method: string | undefined;
+    /** See `getAuthRefreshError()`. */
+    readonly authRefreshError: unknown;
     constructor(error: string | undefined, error_description: string | undefined, details?: BXRestApiErrorDetails);
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bx-rest",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Bitrix24 REST API client and TypeScript SDK for Angular, Vue and browser apps",
   "keywords": [
     "bitrix",
@@ -77,6 +77,9 @@
     "./typification/common": {
       "types": "./typification/rest/common.d.ts"
     },
+    "./typification/crm": {
+      "types": "./typification/rest/crm/index.d.ts"
+    },
     "./typification/department": {
       "types": "./typification/rest/department.d.ts"
     },

package/public-api.d.ts

@@ -9,7 +9,11 @@ export { Navvy } from './services/navvy';
 export { HttpBXServices as BXRestRequest } from './services/http/HttpBX';
 export { SessionKeyServices, SessionKeyError } from './services/http/sessionKey';
 export { instanceOfiBXRestAnswerSuccess as isBXRestAnswerSuccess } from './functions/mapResult';
-export { BXRestApiError } from './functions/errors';
+export { BXRestApiError, getAuthRefreshError } from './functions/errors';
+export { isBXRestAuthError } from './services/http/authRefresh';
+export { BXRestFrame } from './services/frame/frame';
+export { BXRestFrameError, BXRestFrameErrorCode } from './services/frame/transport';
+export * from './services/frame/types';
 export { BXRestResOptions } from './services/navvy/extends/navvy-pag-base';
 export { HttpNavvyServices } from './services/http/httpNavvy';
 export * as partNameMethods from './consts/part-name-methods';

package/request-navvy/crm/item.d.ts

@@ -1,4 +1,4 @@
-import { iBXRestCrmObject, iBXRestParamCrmEntityType, iBXRestParamCrmItemBatchImport, iBXRestParamCrmItemFields, iBXRestParamCrmItemId, iBXRestParamCrmItemImport, iBXRestParamCrmItemList, iBXRestParamCrmItemUpdate } from '../../typification/rest/crm';
+import { iBXRestCrmItem, iBXRestCrmItemFieldsResult, iBXRestCrmItemResult, iBXRestCrmObject, iBXRestParamCrmEntityType, iBXRestParamCrmItemBatchImport, iBXRestParamCrmItemFields, iBXRestParamCrmItemId, iBXRestParamCrmItemImport, iBXRestParamCrmItemList, iBXRestParamCrmItemUpdate } from '../../typification/rest/crm';
 import { BXRestNavvyCrmItemDelivery } from './item/delivery';
 import { BXRestNavvyCrmItemDetails } from './item/details';
 import { BXRestNavvyCrmItemPayment } from './item/payment';
@@ -24,7 +24,7 @@ export declare class BXRestNavvyCrmItem {
     /**
      * Создаёт элемент CRM.
      */
-    add(param: iBXRestParamCrmItemFields): import("../../services/navvy").NavvySimple<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmItemFields | undefined>;
+    add(param: iBXRestParamCrmItemFields): import("../../services/navvy").NavvySimple<iBXRestCrmItemResult, iBXRestCrmItemResult, iBXRestParamCrmItemFields | undefined>;
     /**
      * Пакетно импортирует элементы CRM.
      */
@@ -36,11 +36,11 @@ export declare class BXRestNavvyCrmItem {
     /**
      * Возвращает описание полей элемента CRM.
      */
-    fields(param: iBXRestParamCrmEntityType): import("../../services/navvy").NavvySimple<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmEntityType | undefined>;
+    fields(param: iBXRestParamCrmEntityType): import("../../services/navvy").NavvySimple<iBXRestCrmItemFieldsResult, iBXRestCrmItemFieldsResult, iBXRestParamCrmEntityType | undefined>;
     /**
      * Возвращает данные элемента CRM по идентификатору.
      */
-    get(param: iBXRestParamCrmItemId): import("../../services/navvy").NavvySimple<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmItemId | undefined>;
+    get(param: iBXRestParamCrmItemId): import("../../services/navvy").NavvySimple<iBXRestCrmItemResult, iBXRestCrmItemResult, iBXRestParamCrmItemId | undefined>;
     /**
      * Импортирует элемент CRM.
      */
@@ -48,9 +48,9 @@ export declare class BXRestNavvyCrmItem {
     /**
      * Возвращает список элементов CRM.
      */
-    list(param: iBXRestParamCrmItemList): import("../../services/navvy").NavvyPagNavResultKey<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmItemList, "items">;
+    list(param: iBXRestParamCrmItemList): import("../../services/navvy").NavvyPagNavResultKey<iBXRestCrmItem, iBXRestCrmItem, iBXRestParamCrmItemList, "items">;
     /**
      * Изменяет поля элемента CRM.
      */
-    update(param: iBXRestParamCrmItemUpdate): import("../../services/navvy").NavvySimple<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmItemUpdate | undefined>;
+    update(param: iBXRestParamCrmItemUpdate): import("../../services/navvy").NavvySimple<iBXRestCrmItemResult, iBXRestCrmItemResult, iBXRestParamCrmItemUpdate | undefined>;
 }

package/request-navvy/crm/type.d.ts

@@ -1,10 +1,10 @@
-import { iBXRestCrmObject, iBXRestParamCrmEntityType, iBXRestParamCrmTypeAdd, iBXRestParamCrmTypeId, iBXRestParamCrmTypeList, iBXRestParamCrmTypeUpdate } from '../../typification/rest/crm';
+import { iBXRestCrmObject, iBXRestCrmType, iBXRestCrmTypeResult, iBXRestParamCrmEntityType, iBXRestParamCrmTypeAdd, iBXRestParamCrmTypeId, iBXRestParamCrmTypeList, iBXRestParamCrmTypeUpdate } from '../../typification/rest/crm';
 export declare class BXRestNavvyCrmType {
     private readonly Navvy;
     /**
      * Создаёт новый смарт-процесс.
      */
-    add(param: iBXRestParamCrmTypeAdd): import("../../services/navvy").NavvySimple<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmTypeAdd | undefined>;
+    add(param: iBXRestParamCrmTypeAdd): import("../../services/navvy").NavvySimple<iBXRestCrmTypeResult, iBXRestCrmTypeResult, iBXRestParamCrmTypeAdd | undefined>;
     /**
      * Удаляет смарт-процесс.
      */
@@ -16,17 +16,17 @@ export declare class BXRestNavvyCrmType {
     /**
      * Возвращает смарт-процесс по идентификатору.
      */
-    get(param: iBXRestParamCrmTypeId): import("../../services/navvy").NavvySimple<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmTypeId | undefined>;
+    get(param: iBXRestParamCrmTypeId): import("../../services/navvy").NavvySimple<iBXRestCrmTypeResult, iBXRestCrmTypeResult, iBXRestParamCrmTypeId | undefined>;
     /**
      * Возвращает смарт-процесс по entityTypeId.
      */
-    getByEntityTypeId(param: iBXRestParamCrmEntityType): import("../../services/navvy").NavvySimple<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmEntityType | undefined>;
+    getByEntityTypeId(param: iBXRestParamCrmEntityType): import("../../services/navvy").NavvySimple<iBXRestCrmTypeResult, iBXRestCrmTypeResult, iBXRestParamCrmEntityType | undefined>;
     /**
      * Возвращает список смарт-процессов.
      */
-    list(param?: iBXRestParamCrmTypeList): import("../../services/navvy").NavvyPagNavResultKey<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmTypeList, "types">;
+    list(param?: iBXRestParamCrmTypeList): import("../../services/navvy").NavvyPagNavResultKey<iBXRestCrmType, iBXRestCrmType, iBXRestParamCrmTypeList, "types">;
     /**
      * Обновляет смарт-процесс.
      */
-    update(param: iBXRestParamCrmTypeUpdate): import("../../services/navvy").NavvySimple<iBXRestCrmObject, iBXRestCrmObject, iBXRestParamCrmTypeUpdate | undefined>;
+    update(param: iBXRestParamCrmTypeUpdate): import("../../services/navvy").NavvySimple<iBXRestCrmTypeResult, iBXRestCrmTypeResult, iBXRestParamCrmTypeUpdate | undefined>;
 }

package/services/frame/frame.d.ts

@@ -0,0 +1,191 @@
+import { BXRestFrameOptions, iBXRestFrameAccess, iBXRestFrameAuth, iBXRestFrameCrmSelection, iBXRestFrameCrmSelectOptions, iBXRestFrameInit, iBXRestFrameOpenPathResult, iBXRestFramePlacementInfo, iBXRestFramePlacementInterface, iBXRestFrameSize, iBXRestFrameUser } from './types';
+/**
+ * Команды порталу Bitrix24 из iframe приложения — без подключения BX24.js.
+ * Те же команды и те же имена, что у BX24.js, но вместо колбэков —
+ * промисы. Протокол внутренний и недокументированный, см. `transport.ts`.
+ *
+ * Создавайте один экземпляр на страницу и при старте приложения: параметры
+ * портала читаются в конструкторе (до того, как роутер перепишет адрес), а
+ * `firstRun` портал сообщает только в первом ответе на `getInitData`.
+ *
+ * Токены класс не логирует и никуда не сохраняет: `getAuth()` и
+ * `refreshAuth()` каждый раз спрашивают портал, а в `init()` токенов нет.
+ *
+ * @example
+ * const frame = new BXRestFrame()
+ * const { lang, placement } = await frame.init()
+ * await frame.fitWindow()
+ * const user = await frame.selectUser()
+ */
+export declare class BXRestFrame {
+    private readonly transport;
+    private readonly timeout;
+    private initValue?;
+    private initRequest?;
+    private readonly dialogs;
+    /** Мессенджер — как `BX24.im`. Портал на эти команды не отвечает. */
+    readonly im: {
+        /** Позвонить сотруднику — `BX24.im.callTo()`. */
+        callTo: (userId: number | string, video?: boolean) => Promise<void>;
+        /** Позвонить на телефон — `BX24.im.phoneTo()`. */
+        phoneTo: (phone: string) => Promise<void>;
+        /** Открыть чат — `BX24.im.openMessenger()`. */
+        openMessenger: (dialogId?: number | string) => Promise<void>;
+        /** Открыть историю чата — `BX24.im.openHistory()`. */
+        openHistory: (dialogId: number | string) => Promise<void>;
+    };
+    /** Встраивание — как `BX24.placement`. */
+    readonly placement: {
+        /** Код и параметры встраивания — `BX24.placement.info()`. */
+        info: () => Promise<iBXRestFramePlacementInfo>;
+        /** Команды и события текущего встраивания — `BX24.placement.getInterface()`. */
+        getInterface: () => Promise<iBXRestFramePlacementInterface>;
+        /**
+         * Команда встраивания — `BX24.placement.call()`. Набор команд зависит от
+         * встраивания (см. `getInterface()`). Не на все команды портал отвечает:
+         * без ответа за `timeout` промис завершается с `undefined`.
+         */
+        call: (command: string, params?: unknown, options?: {
+            timeout?: number | false;
+        }) => Promise<unknown>;
+        /**
+         * Подписка на событие встраивания — `BX24.placement.bindEvent()`.
+         * `handler` вызывается при каждом событии. Возвращает функцию отписки:
+         * она только перестаёт вызывать `handler` — отменить подписку на
+         * стороне портала протокол не позволяет. Вне iframe бросает
+         * `BXRestFrameError` с кодом `NOT_IN_FRAME`.
+         */
+        bindEvent: (event: string, handler: (data: unknown) => void) => () => void;
+    };
+    /** Настройки приложения для текущего пользователя — как `BX24.userOption`. */
+    readonly userOption: {
+        get: (name: string) => Promise<unknown>;
+        set: (name: string, value: unknown) => Promise<void>;
+    };
+    /** Настройки приложения для всего портала — как `BX24.appOption`. */
+    readonly appOption: {
+        get: (name: string) => Promise<unknown>;
+        /**
+         * Менять их может только администратор портала: остальным — ошибка
+         * `ACCESS_DENIED` (BX24.js в этом случае молча ничего не делает).
+         * Возвращает настройки приложения после сохранения.
+         */
+        set: (name: string, value: unknown) => Promise<Record<string, unknown>>;
+    };
+    constructor(options?: BXRestFrameOptions);
+    /**
+     * Данные запуска приложения — аналог `BX24.init()`: язык, домен, права,
+     * встраивание, настройки, признаки установки. Запрашиваются у портала
+     * один раз, дальше берутся из памяти. Токенов здесь нет — см. `getAuth()`.
+     */
+    init(): Promise<iBXRestFrameInit>;
+    /**
+     * Текущая авторизация приложения — аналог `BX24.getAuth()`. Каждый вызов —
+     * новый запрос `getInitData` к порталу.
+     *
+     * `expires_in` портал считает от срока жизни токена в момент выдачи, а не
+     * от остатка: если страница открыта давно, значение будет завышено (так
+     * же и у BX24.js). Для свежего токена используйте `refreshAuth()`.
+     */
+    getAuth(): Promise<iBXRestFrameAuth>;
+    /**
+     * Новая авторизация приложения — аналог `BX24.refreshAuth()`: портал
+     * выпускает новую пару `access_token`/`refresh_token`. Если портал не может
+     * выдать токен, он показывает `alert` «Unable to get new token!» и не
+     * отвечает — тогда ошибка `TIMEOUT`.
+     */
+    refreshAuth(): Promise<iBXRestFrameAuth>;
+    /**
+     * Завершить установку — аналог `BX24.installFinish()`: портал отмечает
+     * приложение установленным и перезагружает страницу. Делает что-то только
+     * на странице установщика (`init().install`), иначе — ничего, как и BX24.js.
+     */
+    installFinish(): Promise<void>;
+    /**
+     * Отметить, что первый запуск у этого пользователя пройден, — то, что
+     * BX24.js делает после последнего обработчика `BX24.install()`. Без этого
+     * `init().firstRun` останется `true` и при следующих запусках. Делает
+     * что-то только при первом запуске.
+     */
+    firstRunFinish(): Promise<void>;
+    /** Задать размер фрейма — `BX24.resizeWindow()`. Возвращает размер, который выставил портал. */
+    resizeWindow(width: number | string, height: number | string): Promise<iBXRestFrameSize | undefined>;
+    /** Подогнать высоту фрейма под содержимое — `BX24.fitWindow()`. */
+    fitWindow(): Promise<iBXRestFrameSize | undefined>;
+    /**
+     * Перезагрузить страницу портала с приложением — `BX24.reloadWindow()`.
+     * Портал на эту команду не отвечает.
+     */
+    reloadWindow(): Promise<void>;
+    /** Заголовок страницы портала — `BX24.setTitle()`. */
+    setTitle(title: string): Promise<{
+        title: string;
+    } | undefined>;
+    /** Прокрутить страницу портала — `BX24.scrollParentWindow()`. */
+    scrollParentWindow(scroll: number | string): Promise<{
+        scroll: number;
+    } | undefined>;
+    /**
+     * Диалог выбора одного сотрудника — `BX24.selectUser()`. Ждёт выбора без
+     * ограничения по времени: если пользователь закрыл диалог, портал не
+     * отвечает вовсе. Отменить ожидание — `signal` или новый вызов
+     * `selectUser()`/`selectUsers()` (ошибка `CANCELLED`).
+     */
+    selectUser(options?: {
+        title?: string;
+        signal?: AbortSignal;
+    }): Promise<iBXRestFrameUser>;
+    /** Диалог выбора нескольких сотрудников — `BX24.selectUsers()`. Ожидание — как у `selectUser()`. */
+    selectUsers(options?: {
+        title?: string;
+        signal?: AbortSignal;
+    }): Promise<iBXRestFrameUser[]>;
+    /**
+     * Диалог выбора прав доступа — `BX24.selectAccess()`. `value` — коды,
+     * которые нельзя выбрать. Ожидание — как у `selectUser()`.
+     */
+    selectAccess(options?: {
+        value?: string[];
+        signal?: AbortSignal;
+    }): Promise<iBXRestFrameAccess[]>;
+    /** Диалог выбора объектов CRM — `BX24.selectCRM()`. Ожидание — как у `selectUser()`. */
+    selectCRM(options?: iBXRestFrameCrmSelectOptions): Promise<iBXRestFrameCrmSelection>;
+    /**
+     * Открыть приложение в слайдере — `BX24.openApplication()`. Промис
+     * завершается, когда слайдер закрыли. `settings` — настройки слайдера
+     * (уходят как `bx24_<ключ>`, как в BX24.js).
+     */
+    openApplication(params?: Record<string, unknown>, settings?: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Открыть страницу портала в слайдере — `BX24.openPath()`. Промис
+     * завершается, когда слайдер закрыли (`{ result: 'close' }`), или сразу,
+     * если путь не открылся (`{ result: 'error', errorCode }`).
+     */
+    openPath(path: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<iBXRestFrameOpenPathResult>;
+    /**
+     * Закрыть слайдер с приложением — `BX24.closeApplication()`. Если
+     * приложение открыто не в слайдере, ничего не происходит. Узнать о
+     * закрытии может открывший слайдер — через `openApplication()`.
+     */
+    closeApplication(): Promise<void>;
+    /**
+     * Команда, на которую портал отвечает подтверждением. В некоторых
+     * встраиваниях портал на такие команды не отвечает (так считает и
+     * b24jssdk) — тогда промис завершается с `undefined`, а не ошибкой.
+     */
+    private ack;
+    /**
+     * Диалоги ждут пользователя без таймаута. Портал держит один обработчик
+     * на диалог (у выбора сотрудников он общий для `selectUser` и
+     * `selectUsers`) и на прошлый вызов уже не ответит — поэтому новый вызов
+     * отменяет ожидание прошлого.
+     */
+    private dialog;
+    private getInitData;
+    private toInit;
+    private toAuth;
+}

package/services/frame/transport.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Обмен сообщениями между iframe приложения и порталом Bitrix24 — тот
+ * транспорт, на котором построены команды BX24.js: страница приложения шлёт
+ * команду родительскому окну портала через postMessage, портал отвечает
+ * сообщением с тем же callbackId.
+ *
+ * ВНИМАНИЕ: протокол внутренний и недокументированный — Bitrix24 может
+ * изменить его без предупреждения. Транспорт повторяет BX24.js
+ * (https://api.bitrix24.com/api/v1/, скачан 2026-10-29, Last-Modified
+ * 2022-03-17, sha256 945ad491df8ffb7490b89f4914a439b5a3f575c950c3480562815716a3e07f23)
+ * и сверен с ответной стороной портала — `/bitrix/js/rest/applayout.js`
+ * (Last-Modified 2024-05-15, sha256 3efd6ab57a4778493a26d10ae0987a82e19fc012ed9935f5c6afa78c4052fcb5).
+ * Всё знание о протоколе — только в этом модуле (`services/frame`).
+ */
+export type BXRestFrameErrorCode = 'NOT_IN_FRAME' | 'TIMEOUT' | 'NO_AUTH' | 'BAD_RESPONSE' | 'CANCELLED' | 'ACCESS_DENIED';
+/**
+ * Ошибка обращения к порталу из iframe. `code`:
+ * - `NOT_IN_FRAME` — страница открыта не в iframe приложения Bitrix24;
+ * - `TIMEOUT` — портал не ответил за отведённое время;
+ * - `NO_AUTH` — портал ответил без токена;
+ * - `BAD_RESPONSE` — ответ портала не удалось разобрать;
+ * - `CANCELLED` — ожидание отменено через `signal` или новым вызовом того же диалога;
+ * - `ACCESS_DENIED` — команда доступна только администратору портала.
+ */
+export declare class BXRestFrameError extends Error {
+    readonly code: BXRestFrameErrorCode;
+    constructor(code: BXRestFrameErrorCode, message: string);
+}
+export interface FrameRequestOptions {
+    /** Сколько ждать ответа, мс; `false` — без ограничения (диалоги, слайдеры). */
+    timeout: number | false;
+    /**
+     * Что делать, если портал не ответил за `timeout`: `'reject'` — ошибка
+     * `TIMEOUT` (по умолчанию), `'resolve'` — завершиться с `undefined`.
+     */
+    onTimeout?: 'reject' | 'resolve';
+    signal?: AbortSignal;
+}
+/**
+ * Параметры портала (DOMAIN, PROTOCOL, APP_SID) читаются в конструкторе —
+ * так же, как это делает BX24.js, из `window.name`: портал задаёт имя
+ * iframe приложения в виде `DOMAIN|PROTOCOL|APP_SID`. Если там их нет —
+ * из query страницы (`?DOMAIN=…&PROTOCOL=…&APP_SID=…`), с которым портал
+ * открывает обработчик приложения. Конструктор не бросает исключений:
+ * вне iframe ошибку вернут сами команды.
+ */
+export declare class FrameTransport {
+    private readonly frame;
+    constructor();
+    /** Домен портала из параметров фрейма — как `BX24.getDomain()`. */
+    get domain(): string;
+    /**
+     * Команда, на которую портал не отвечает (`reloadWindow`, `imCallTo`, ...).
+     * Вне iframe бросает `BXRestFrameError` с кодом `NOT_IN_FRAME`.
+     */
+    post(command: string, params: unknown): void;
+    /** Команда с одним ответом портала. */
+    request(command: string, params: unknown, options: FrameRequestOptions): Promise<unknown>;
+    /**
+     * Команда, на которую портал отвечает многократно (`placementBindEvent`):
+     * `handler` вызывается на каждый ответ. Возвращает функцию отписки —
+     * она только перестаёт слушать: отменить подписку на стороне портала
+     * протокол не позволяет. Вне iframe бросает `BXRestFrameError`.
+     */
+    subscribe(command: string, params: unknown, handler: (data: unknown) => void): () => void;
+    private requireFrame;
+    /**
+     * Формат — как у BX24.js. Обычно строка `команда:параметры:callbackId:APP_SID`
+     * (портал разбирает её с конца, поэтому параметры и callbackId могут быть
+     * пустыми); для команд с `:` в имени — объект.
+     */
+    private send;
+    /** Ответ портала — строка `callbackId:JSON` (или `callbackId:`, если ответ пустой). */
+    private listen;
+}

package/services/frame/types.d.ts

@@ -0,0 +1,123 @@
+export interface BXRestFrameOptions {
+    /**
+     * Сколько ждать ответа портала на команду, мс. По умолчанию 10000. Вне
+     * iframe портала ответа не будет никогда. Диалоги и слайдеры ждут
+     * пользователя без ограничения.
+     */
+    timeout?: number;
+}
+/**
+ * Авторизация приложения — в том же виде, что у `BX24.getAuth()`.
+ */
+export interface iBXRestFrameAuth {
+    access_token: string;
+    refresh_token: string;
+    /**
+     * Момент истечения `access_token` — миллисекунды с 1 января 1970 года,
+     * как у `BX24.getAuth()`. Не срок жизни в секундах, как в ответе
+     * OAuth-сервера! Сравнивайте с `Date.now()`.
+     */
+    expires_in: number;
+    /** Адрес портала без протокола, например `mycompany.bitrix24.ru`. */
+    domain: string;
+    /** Постоянный идентификатор портала. */
+    member_id: string;
+}
+/**
+ * Данные, которые портал передаёт приложению при запуске (`getInitData`), —
+ * без токенов: их отдаёт `getAuth()`.
+ */
+export interface iBXRestFrameInit {
+    /** Адрес портала без протокола — как `BX24.getDomain()`. */
+    domain: string;
+    /** Язык интерфейса — как `BX24.getLang()`. */
+    lang: string;
+    /** Путь к REST на портале, например `/rest`. */
+    path: string;
+    /** Портал открыт по https. */
+    https: boolean;
+    memberId: string;
+    /** Пользователь — администратор портала, как `BX24.isAdmin()`. */
+    isAdmin: boolean;
+    /**
+     * Страница открыта как установщик приложения: установку завершает
+     * `installFinish()`.
+     */
+    install: boolean;
+    /**
+     * Первый запуск приложения этим пользователем (этой версии). Портал
+     * сообщает его только в первом ответе на `getInitData` за загрузку страницы.
+     */
+    firstRun: boolean;
+    /** Код встраивания, например `DEFAULT` или `CRM_DEAL_DETAIL_TAB`. */
+    placement: string;
+    placementOptions: unknown;
+    userOptions: Record<string, unknown>;
+    appOptions: Record<string, unknown>;
+}
+/** Размер фрейма, который выставил портал. */
+export interface iBXRestFrameSize {
+    width: number;
+    height: number;
+}
+/** Сотрудник из диалога `selectUser()`/`selectUsers()`. */
+export interface iBXRestFrameUser {
+    /** Приходит строкой. */
+    id: string;
+    name: string;
+    /** Работает в подразделении, подчинённом текущему пользователю. */
+    sub: boolean;
+    /** Руководит подразделением текущего пользователя или вышестоящим. */
+    sup: boolean;
+    position: string | null;
+    /** Путь к аватару относительно адреса портала. */
+    photo: string;
+    url: string;
+}
+/** Право доступа из диалога `selectAccess()`. */
+export interface iBXRestFrameAccess {
+    /** Источник кода: `intranet`, `socnetgroup`, `group`, ... */
+    provider: string;
+    /** Код доступа, например `IU1`, `D5`, `SG4_K`. */
+    id: string;
+    name: string;
+}
+export type BXRestFrameCrmType = 'lead' | 'contact' | 'company' | 'deal' | 'quote';
+export interface iBXRestFrameCrmSelectOptions {
+    /** Какие типы объектов показывать. */
+    entityType?: BXRestFrameCrmType[];
+    /** Можно выбрать несколько объектов. */
+    multiple?: boolean;
+    /** Объекты, отмеченные при открытии: идентификаторы по типам. */
+    value?: Partial<Record<BXRestFrameCrmType, number[]>>;
+    signal?: AbortSignal;
+}
+/** Объект CRM из диалога `selectCRM()`. */
+export interface iBXRestFrameCrmEntity {
+    /** С префиксом типа: `L_`, `C_`, `CO_`, `D_`, `Q_`. */
+    id: string;
+    type: BXRestFrameCrmType;
+    place: string;
+    title: string;
+    desc: string;
+    url?: string;
+    image?: string;
+}
+/** Результат `selectCRM()`: объекты по типам, внутри — под ключами `0`, `1`, ... */
+export type iBXRestFrameCrmSelection = Partial<Record<BXRestFrameCrmType, Record<string, iBXRestFrameCrmEntity>>>;
+/** Результат `openPath()`. */
+export interface iBXRestFrameOpenPathResult {
+    /** `close` — пользователь закрыл слайдер; `error` — путь не открылся. */
+    result: 'close' | 'error';
+    /** `PATH_NOT_AVAILABLE` или `METHOD_NOT_SUPPORTED_ON_DEVICE`. */
+    errorCode?: string;
+}
+/** Команды и события текущего встраивания. */
+export interface iBXRestFramePlacementInterface {
+    command: string[];
+    event: string[];
+}
+export interface iBXRestFramePlacementInfo {
+    placement: string;
+    options: unknown;
+}

package/services/http/authRefresh.d.ts

@@ -0,0 +1,19 @@
+import { Observable } from 'rxjs';
+/**
+ * Условие продления по умолчанию (`BXRestSettings.auth.isAuthError`):
+ * - ответ с ошибкой Bitrix `expired_token` или `invalid_token` — при любом статусе;
+ * - ответ 401 без тела ошибки Bitrix — например, пустой ответ своего
+ *   бэкенд-прокси, у которого нет действующего токена.
+ *
+ * Ответ 401 с другим кодом Bitrix ошибкой авторизации не считается.
+ */
+export declare function isBXRestAuthError(error: unknown): boolean;
+/**
+ * Повтор запроса после продления авторизации (`BXRestSettings.auth.refresh`).
+ *
+ * `request$` должен быть "холодным" и читать настройки при подписке (как
+ * `defer()` в HttpBXServices): повтор — это повторная подписка, поэтому
+ * токен, адрес и заголовки берутся уже новые. На второй попытке ошибка не
+ * перехватывается — запрос повторяется не больше одного раза.
+ */
+export declare function withAuthRefresh<T>(request$: Observable<T>): Observable<T>;

package/services/navvy/extends/navvy-pag-base.d.ts

@@ -39,4 +39,10 @@ export declare abstract class NavvyPagBase<T, R, P> {
     mapForVanilla(): Observable<iBXRestAnswer<ReturnTypeNavvy<T, R>> | undefined>;
     res(options?: BXRestResOptions): Observable<ReturnTypeNavvy<T, R> | undefined>;
     mapAndError<T>(request: Observable<iBXRestAnswer<T> | undefined>, options?: BXRestResOptions): Observable<T | undefined>;
+    /**
+     * Первая страница для `.resAll()`. Ошибка Bitrix в теле ответа 2xx становится `BXRestApiError`:
+     * страниц в таком ответе нет, и без этого `.resAll()` завершился бы безликим `EmptyError`.
+     */
+    protected resFirstPage(): Observable<iBXRestAnswer<T> | undefined>;
+    private apiErrorFromBody;
 }

package/services/navvy/navvy-pag-nav-tasks.d.ts

@@ -5,6 +5,9 @@ export declare class NavvyPagNavTasks<T, R, P extends iBXRestPagination> extends
     tasks: T[] | undefined;
 }, R[], P> {
     save: ReturnTypeNavvy<T, R>[];
+    constructor(url: string[], param: P, map?: (param: {
+        tasks: T[] | undefined;
+    } | undefined) => R[] | undefined, restApi?: boolean);
     resAll(): import("rxjs").Observable<ReturnTypeNavvy<T, R>[]>;
     private resultAllEnd;
     private mapResForGetAll;