bx-rest 1.5.0 → 1.6.0

package/functions/errors.d.ts

@@ -69,3 +69,12 @@ export declare function parseBXRestErrorBody(body: unknown): {
  * Bitrix error body, so the caller can keep its own handling for them.
  */
 export declare function bxRestApiErrorFromHttp(err: unknown, method: string): BXRestApiError | undefined;
+/**
+ * HTTP-ответ из ошибки транспорта: `response: { status, data }`. Так устроен
+ * `AxiosError`, и так же должны отклоняться свои транспорты (middleware).
+ * Для сетевых ошибок, отмены и прочих ошибок — `undefined`.
+ */
+export declare function httpErrorResponse(error: unknown): {
+    status: number;
+    data: unknown;
+} | undefined;

package/functions/uniqueElementCode.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Символьный код нового элемента списка: `bx_rest_` и 128 случайных бит в hex.
+ * Только латиница, цифры и `_`: допустимые символы документация Bitrix24 не
+ * описывает.
+ *
+ * Случайные байты дают `crypto.getRandomValues` (в отличие от
+ * `crypto.randomUUID`, он есть и на страницах по http). Глобального `crypto`
+ * нет только в Node 18: там байты берутся из `Math.random`. Это не
+ * криптостойко, но код нужен лишь уникальный, а совпадение с уже занятым кодом
+ * ловит повтор в вызывающем методе.
+ */
+export declare function uniqueElementCode(): string;

package/map/disk.d.ts

@@ -0,0 +1,10 @@
+import { BXRestMapDiskFolder } from './disk/folder';
+import { BXRestMapDiskAttachedObject } from './disk/attachedObject';
+import { BXRestMapDiskFile } from './disk/file';
+import { BXRestMapDiskStorage } from './disk/storage';
+export declare class BXRestMapDisk {
+    readonly folder: BXRestMapDiskFolder;
+    readonly attachedObject: BXRestMapDiskAttachedObject;
+    readonly file: BXRestMapDiskFile;
+    readonly storage: BXRestMapDiskStorage;
+}

package/map/task.d.ts

@@ -2,7 +2,7 @@ import { BXRestMapTaskCommentItem } from './task/commentitem';
 import { BXRestMapTaskElapsedItem } from './task/elapseditem';
 import { BXRestMapTaskStage } from './task/stages';
 export declare class BXRestMapTask {
-    readonly commentItem: BXRestMapTaskCommentItem;
-    readonly elapsedItem: BXRestMapTaskElapsedItem;
-    readonly stages: BXRestMapTaskStage;
+    static get commentItem(): typeof BXRestMapTaskCommentItem;
+    static get elapsedItem(): typeof BXRestMapTaskElapsedItem;
+    static get stages(): typeof BXRestMapTaskStage;
 }

package/map/tasks/task.d.ts

@@ -5,7 +5,7 @@ import { BXRestMapTasksTaskResult } from './task/result';
 import { iBXRestHttpTask, iBXRestTask } from '../../typification/rest/tasks/task';
 import { iBXRestTaskFieldsName } from '../../typification/rest/tasks/base/fields-name';
 export declare class BXRestMapTasksTask {
-    readonly result: typeof BXRestMapTasksTaskResult;
+    static get result(): typeof BXRestMapTasksTaskResult;
     static getAccess(v: iBXRestTaskGetAccess | undefined): Record<number, import("../../typification/rest/task/access/getaccess").iBXRestTaskGetAccessItem> | undefined;
     static add(item: {
         task: iBXRestTasksTaskGetHttpDefault;

package/map/tasks.d.ts

@@ -1,4 +1,4 @@
 import { BXRestMapTasksTask } from './tasks/task';
 export declare class BXRestMapTasks {
-    readonly task: BXRestMapTasksTask;
+    static get task(): typeof BXRestMapTasksTask;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bx-rest",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Bitrix24 REST API client and TypeScript SDK for Angular, Vue and browser apps",
   "keywords": [
     "bitrix",
@@ -32,7 +32,7 @@
     "url": "git+https://github.com/Aricatofuka/bx-rest.git"
   },
   "dependencies": {
-    "axios": "^1.19.0",
+    "axios": "^1.21.0",
     "countries-and-timezones": "^3.7.2",
     "just-camel-case": "^6.2.0",
     "just-clone": "^6.2.0",
@@ -68,6 +68,9 @@
     "./typification/app": {
       "types": "./typification/rest/app.d.ts"
     },
+    "./typification/batch": {
+      "types": "./typification/rest/batch.d.ts"
+    },
     "./typification/bizproc": {
       "types": "./typification/rest/bizproc.d.ts"
     },

package/public-api.d.ts

@@ -10,11 +10,15 @@ export { HttpBXServices as BXRestRequest } from './services/http/HttpBX';
 export { SessionKeyServices, SessionKeyError } from './services/http/sessionKey';
 export { instanceOfiBXRestAnswerSuccess as isBXRestAnswerSuccess } from './functions/mapResult';
 export { BXRestApiError, getAuthRefreshError } from './functions/errors';
+export type { BXRestApiErrorDetails } from './functions/errors';
 export { isBXRestAuthError } from './services/http/authRefresh';
 export { BXRestFrame } from './services/frame/frame';
-export { BXRestFrameError, BXRestFrameErrorCode } from './services/frame/transport';
+export { BXRestFrameError } from './services/frame/transport';
+export type { 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 type { BXRestResOptions } from './services/navvy/extends/navvy-pag-base';
+export type { iBXRestSettings } from './typification/settings';
 export * as partNameMethods from './consts/part-name-methods';
 export * as BXBaseServices from './services/base';
+export type { BXRestRequestConfig, BXRestSend, BXRestMiddleware } from './services/http/transport';
+export { BXRestTimeoutError } from './services/http/middleware';

package/request-navvy/pull/config.d.ts

@@ -1,5 +1,4 @@
 import { iBXRestPullConfigGet, iBXRestPullConfigGetHttp } from '../../typification/rest/pull';
-import { BXRestMapPullChannelPublic } from '../../map/channel/public';
 export declare class BXRestNavvyPullConfig {
     url: {
         /**
@@ -8,7 +7,6 @@ export declare class BXRestNavvyPullConfig {
         get: string[];
     };
     private Navvy;
-    static public: BXRestMapPullChannelPublic;
     /**
      * @experimental
      * Этот метод находится в процессе тестирования и может измениться.

package/rest/map.d.ts

@@ -2,7 +2,7 @@ import { BXRestMapLists } from '../map/lists';
 import { BXRestMapUser } from '../map/user';
 import { BXRestMapSonetGroup } from '../map/sonet_group';
 import { BXRestMapServer } from '../map/server';
-import { BXRestDisk } from '../request/disk';
+import { BXRestMapDisk } from '../map/disk';
 import { BXRestMapCalendar } from '../map/calendar';
 import { BXRestMapLog } from '../map/log';
 import { BXRestMapTask } from '../map/task';
@@ -12,7 +12,7 @@ export declare class BXRestMap {
     get sonet_group(): typeof BXRestMapSonetGroup;
     get server(): typeof BXRestMapServer;
     get lists(): typeof BXRestMapLists;
-    get disk(): typeof BXRestDisk;
+    get disk(): typeof BXRestMapDisk;
     get calendar(): typeof BXRestMapCalendar;
     get log(): typeof BXRestMapLog;
     get task(): typeof BXRestMapTask;

package/rest/navvy.d.ts

@@ -45,6 +45,7 @@ import { BXRestNavvyEventLog } from '../request-navvy/eventlog/index';
 import { BXRestNavvyPlacement } from '../request-navvy/placement';
 import { BXRestNavvyUserFieldType } from '../request-navvy/userfieldtype';
 import { iBXRestParamScope } from '../typification/rest/common';
+import { iBXRestSettings } from '../typification/settings';
 export declare class BXRestNavvy {
     readonly ai: BXRestNavvyAi;
     readonly mailService: BXRestNavvyMailService;
@@ -95,6 +96,14 @@ export declare class BXRestNavvy {
     /** Проверка доступности возможностей портала. */
     readonly feature: BXRestNavvyFeature;
     readonly Navvy: Navvy;
+    /**
+     * @param settings Свои настройки клиента: адрес портала, способ авторизации,
+     *   заголовки. Все запросы этого клиента идут с ними, даже если глобальные
+     *   `BXRestSettings` позже изменятся. Так в одном процессе можно работать
+     *   с несколькими порталами. Без аргумента клиент работает с глобальными
+     *   `BXRestSettings`, как раньше.
+     */
+    constructor(settings?: iBXRestSettings);
     /**
      * Возвращает базовую информацию о текущем пользователе без scope `user`.
      *

package/services/context.d.ts

@@ -0,0 +1,43 @@
+import { iBXRestSettings } from '../typification/settings';
+import type { AxiosInstance } from 'axios';
+/**
+ * Контекст клиента: его настройки, экземпляр axios и общее состояние
+ * продления авторизации и очереди `throttle`.
+ *
+ * Объекты библиотеки запоминают контекст в момент создания
+ * (`currentContext()`), поэтому все запросы клиента `new BXRestNavvy(settings)`
+ * идут с его настройками, а не с глобальными. Внутренняя деталь библиотеки.
+ */
+export declare class BXRestContext {
+    private readonly own?;
+    /** Идущее сейчас продление авторизации, его ждут все упавшие запросы клиента. */
+    pendingRefresh: Promise<void> | undefined;
+    /** Сколько продлений уже завершилось успешно. */
+    refreshCount: number;
+    /** Экземпляр axios клиента: один на контекст, создаётся при первом запросе. */
+    axios: AxiosInstance | undefined;
+    /** Очередь `throttle`: когда можно отправить следующий запрос клиента (мс, Date.now()). */
+    throttleNextSlot: number;
+    constructor(own?: iBXRestSettings | undefined);
+    /**
+     * Свои настройки клиента, а без них — глобальные `BXRestSettings.value`,
+     * прочитанные в момент обращения: `BXRestSettings.update()` заменяет объект.
+     */
+    get settings(): iBXRestSettings;
+}
+/**
+ * Контекст глобальных настроек. С ним работают `new BXRestNavvy()` без
+ * аргумента и объекты, созданные приложением напрямую (`new Navvy()`,
+ * `new BXRestRequest()`).
+ */
+export declare const globalContext: BXRestContext;
+export declare function currentContext(): BXRestContext;
+/**
+ * Делает `ctx` текущим и возвращает прежний контекст. Вызывающий обязан
+ * вернуть его через `restoreContext()` в `finally`: иначе после исключения
+ * чужие настройки достанутся объектам, созданным позже.
+ */
+export declare function enterContext(ctx: BXRestContext): BXRestContext;
+export declare function restoreContext(previous: BXRestContext): void;
+/** Создаёт объекты в контексте `ctx` и возвращает прежний контекст, даже при исключении. */
+export declare function runInContext<T>(ctx: BXRestContext, build: () => T): T;

package/services/http/HttpBX.d.ts

@@ -32,6 +32,16 @@ export declare class HttpBXServices extends HttpServices {
     get<T>(name: string[], params?: any, headers?: Record<string, string>): Observable<iBXRestAnswer<T> | undefined>;
     httpPost<T>(url: string, params?: any, settings?: iHttpParamSettings, headers?: Record<string, string>): Observable<T | undefined>;
     httpGet<T>(url: string, params?: any, settings?: iHttpParamSettings, headers?: Record<string, string>): Observable<T | undefined>;
+    /**
+     * Отправка через шаги из настроек: `retryOnQueryLimit`, `throttle`,
+     * `timeout`, затем `middleware`; последним идёт axios клиента. Настройки
+     * читаются при подписке. Отписка отменяет HTTP-запрос (AbortSignal).
+     * Ошибка транспорта уходит дальше как есть: у axios в ней весь запрос,
+     * вместе с токеном и секретом вебхука (см. README, «Обработка ошибок»).
+     */
+    private send;
+    /** Транспорт по умолчанию: axios клиента, как и раньше через post()/get(). */
+    private axiosSend;
     /**
      * Заголовки запроса: `BXRestSettings.headers`, поверх них — заголовки
      * конкретного запроса, поверх всего — `required`. В `required` идёт

package/services/http/authRefresh.d.ts

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

package/services/http/http.d.ts

@@ -1,12 +1,15 @@
-import { Observable } from 'rxjs';
 import { AxiosInstance } from 'axios';
-import { SessionKeyServices } from '../../services/http/sessionKey';
-import { iHttpParamSettings } from '../../typification/rest/settings';
-import { BaseHttp } from './base/base';
-export declare class HttpServices extends BaseHttp {
-    protected readonly axiosInstance: AxiosInstance;
+import { SessionKeyServices } from './sessionKey';
+/**
+ * Общая часть HTTP-клиента: экземпляр axios и источник токена и адреса.
+ * Сами запросы отправляет `HttpBXServices` (`BXRestRequest`).
+ */
+export declare class HttpServices {
     readonly session: SessionKeyServices;
-    constructor();
-    httpPost<T>(url: string, params?: any, settings?: iHttpParamSettings): Observable<T | undefined>;
-    httpGet<T>(url: string, params?: any): Observable<T | undefined>;
+    /**
+     * Экземпляр axios клиента. Один на контекст (клиента со своими настройками
+     * или глобальные настройки) и создаётся при первом запросе — раньше каждый
+     * объект запроса создавал свой.
+     */
+    protected get axiosInstance(): AxiosInstance;
 }

package/services/http/middleware.d.ts

@@ -0,0 +1,31 @@
+import { BXRestMiddleware } from './transport';
+import { iBXRestSettings } from '../../typification/settings';
+/** `retryOnQueryLimit: true`: всего 3 попытки, пауза перед второй — 1000 мс, дальше вдвое больше. */
+export declare const DEFAULT_RETRY_ON_QUERY_LIMIT: {
+    attempts: number;
+    delay: number;
+};
+/** `timeout: true`: 60 000 мс на один HTTP-запрос. */
+export declare const DEFAULT_TIMEOUT = 60000;
+/** `throttle: true`: 2 запроса в секунду — лимит Bitrix24 на обычных тарифах. */
+export declare const DEFAULT_THROTTLE: {
+    perSecond: number;
+};
+/**
+ * Запрос не завершился за время из `timeout` в настройках. В `.resVanilla()`
+ * приходит сама эта ошибка, в `.res()` — в `cause`.
+ */
+export declare class BXRestTimeoutError extends Error {
+    readonly timeout: number;
+    constructor(timeout: number);
+}
+/** Где клиент хранит очередь `throttle` — в своём контексте. */
+export interface ThrottleState {
+    throttleNextSlot: number;
+}
+/**
+ * Встроенные шаги из настроек, в этом порядке: повтор, очередь, таймаут.
+ * Повтор — снаружи: каждая попытка заново встаёт в очередь и получает свой
+ * таймаут. Таймаут — внутри очереди: ожидание своей очереди его не тратит.
+ */
+export declare function builtInMiddleware(settings: iBXRestSettings, state: ThrottleState): BXRestMiddleware[];

package/services/http/sessionKey.d.ts

@@ -1,10 +1,18 @@
 import { Observable, Subscription } from 'rxjs';
 import { iBXRestAuth } from '../../typification/auth/save';
+import { BXRestContext } from '../context';
+import type { BXRestMiddleware } from './transport';
 type IKeyAuth = 'sessid' | 'auth' | string;
 export declare class SessionKeyError extends Error {
     constructor(message: string);
 }
 export declare class SessionKeyServices {
+    /**
+     * Контекст клиента, в котором создан объект: внутри `new BXRestNavvy(settings)`
+     * — контекст этого клиента, в остальных случаях — глобальные настройки.
+     * Объявлен первым: конструктор ниже уже читает настройки.
+     */
+    readonly ctx: BXRestContext;
     authHave: boolean;
     authData: iBXRestAuth | undefined;
     subscribe: {
@@ -26,6 +34,8 @@ export declare class SessionKeyServices {
      * результата не меняла сами настройки.
      */
     getHeaders(): Record<string, string>;
+    /** Свои middleware из настроек (`middleware`), читаются при каждом запросе — как и остальные настройки. */
+    getMiddleware(): readonly BXRestMiddleware[];
     getSessid(): string;
     getAuthParams(): string | undefined;
     getCheckAuthParamsIsOn(): boolean;

package/services/http/transport.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Запрос, который HTTP-слой bx-rest передаёт middleware и транспорту.
+ */
+export interface BXRestRequestConfig {
+    method: 'GET' | 'POST';
+    /** Полный адрес; у GET — вместе со строкой параметров. */
+    url: string;
+    /** Тело POST: объект (уходит JSON) или строка x-www-form-urlencoded. */
+    data?: unknown;
+    headers: Record<string, string>;
+    /** Прикладывать ли cookie браузера (`credentials: 'include'` у fetch). */
+    withCredentials: boolean;
+    /** Отмена запроса. */
+    signal?: AbortSignal;
+}
+/**
+ * Отправляет запрос и возвращает тело ответа. На ответ не 2xx отклоняется
+ * ошибкой с полем `response: { status, data }` — как `AxiosError`: по нему
+ * библиотека узнаёт ошибки Bitrix и ошибки авторизации.
+ */
+export type BXRestSend = (config: BXRestRequestConfig) => Promise<unknown>;
+/**
+ * Шаг перед отправкой. Может поменять запрос, повторить его, подождать или
+ * вовсе не звать `next` — тогда middleware сам становится транспортом.
+ */
+export type BXRestMiddleware = (config: BXRestRequestConfig, next: BXRestSend) => Promise<unknown>;
+/** Первый middleware в списке — внешний: он первым видит запрос и последним — ответ. */
+export declare function composeMiddleware(middleware: readonly BXRestMiddleware[], terminal: BXRestSend): BXRestSend;

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

@@ -1,7 +1,8 @@
 import { Observable } from 'rxjs';
-import { iBXRestAnswer } from '../../../typification/rest/base/answer';
+import { iBXRestAnswer, iBXRestAnswerSuccess } from '../../../typification/rest/base/answer';
 import { HttpBXServices } from '../../http/HttpBX';
 import { ReturnTypeNavvy } from '../navvy-support';
+import { iBXRestPagination } from '../../../typification/rest/base/api-pagination-bx';
 export interface BXRestResOptions {
     /**
      * When `true`, a Bitrix-level API error that comes in the body of a 2xx
@@ -16,6 +17,11 @@ export interface BXRestResOptions {
      */
     throwOnApiError?: boolean;
 }
+/**
+ * Параметры остальных страниц для методов с постраничной навигацией через `start`.
+ * Отсчёт идёт от `start` самого запроса: первая страница уже получена именно с него.
+ */
+export declare function offsetPageParams<P extends iBXRestPagination>(param: P, total: number | undefined, pageSize: number): P[];
 export declare abstract class NavvyPagBase<T, R, P> {
     protected url: string[];
     protected param: P;
@@ -43,6 +49,14 @@ export declare abstract class NavvyPagBase<T, R, P> {
      * Первая страница для `.resAll()`. Ошибка Bitrix в теле ответа 2xx становится `BXRestApiError`:
      * страниц в таком ответе нет, и без этого `.resAll()` завершился бы безликим `EmptyError`.
      */
-    protected resFirstPage(): Observable<iBXRestAnswer<T> | undefined>;
+    protected resFirstPage(): Observable<iBXRestAnswerSuccess<T>>;
+    /**
+     * Остальные страницы для `.resAll()`, в порядке `params`. Команды уходят через `batch`,
+     * пакеты — по очереди. Ошибка любой страницы завершает весь запрос: неполный список
+     * выглядел бы для вызывающего кода как полный.
+     */
+    protected resPages<Page>(params: P[]): Observable<Page[]>;
+    private batchPages;
+    private notRestAnswerError;
     private apiErrorFromBody;
 }

package/services/navvy/navvy-alternative-pagination-navigation.d.ts

@@ -9,6 +9,9 @@ import { NavvyPagBase } from './extends/navvy-pag-base';
  */
 export declare class NavvyAlterPagNav<T, R, P extends iBXRestAlternativePagination> extends NavvyPagBase<T[], R[], P> {
     resAll(): import("rxjs").Observable<ReturnTypeNavvy<T, R>[]>;
-    private resultAllEnd;
-    private mapResultForGetAll;
+    /**
+     * Параметры остальных страниц. Размер страницы берётся из запроса: портал ограничивает
+     * его 50 записями, но вызывающий код может попросить и меньше.
+     */
+    private pageParams;
 }

package/services/navvy/navvy-pag-nav-result-key-object.d.ts

@@ -6,7 +6,5 @@ export declare class NavvyPagNavResultKeyObject<T, R, P extends iBXRestPaginatio
     private readonly key;
     constructor(url: string[], param: P, key: K, mapResult?: (param: KeyedObjectResult<K, T> | undefined) => R[] | undefined);
     resAll(): import("rxjs").Observable<R[] | undefined>;
-    private resultAllEnd;
-    private mapResult;
 }
 export {};

package/services/navvy/navvy-pag-nav-result-key.d.ts

@@ -4,10 +4,7 @@ import { NavvyPagBase } from './extends/navvy-pag-base';
 type KeyedResult<K extends string, T> = Record<K, T[] | undefined>;
 export declare class NavvyPagNavResultKey<T, R, P extends iBXRestPagination, K extends string> extends NavvyPagBase<KeyedResult<K, T>, R[], P> {
     private readonly key;
-    save: ReturnTypeNavvy<T, R>[];
-    constructor(url: string[], param: P, key: K, map?: (param: KeyedResult<K, T> | undefined) => R[] | undefined);
+    constructor(url: string[], param: P, key: K, map?: (param: KeyedResult<K, T> | undefined) => R[] | undefined, restApi?: boolean);
     resAll(): import("rxjs").Observable<ReturnTypeNavvy<T, R>[]>;
-    private resultAllEnd;
-    private mapResForGetAll;
 }
 export {};

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

@@ -1,14 +1,7 @@
 import { iBXRestPagination } from '../../typification/rest/base/api-pagination-bx';
-import { ReturnTypeNavvy } from './navvy-support';
-import { NavvyPagBase } from './extends/navvy-pag-base';
-export declare class NavvyPagNavTasks<T, R, P extends iBXRestPagination> extends NavvyPagBase<{
-    tasks: T[] | undefined;
-}, R[], P> {
-    save: ReturnTypeNavvy<T, R>[];
+import { NavvyPagNavResultKey } from './navvy-pag-nav-result-key';
+export declare class NavvyPagNavTasks<T, R, P extends iBXRestPagination> extends NavvyPagNavResultKey<T, R, P, 'tasks'> {
     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;
 }

package/services/navvy/navvy-pag-nav-with-useless-key.d.ts

@@ -1,7 +1,5 @@
 import { iBXRestPagination } from '../../typification/rest/base/api-pagination-bx';
 import { NavvyPagBase } from './extends/navvy-pag-base';
-import { ReturnTypeNavvy } from './navvy-support';
 export declare class NavvyPagNavWithUselessKey<T, R, P extends iBXRestPagination> extends NavvyPagBase<Record<string, T>, R[], P> {
-    save: ReturnTypeNavvy<Record<string, T>, R[]>;
     resAll(): import("rxjs").Observable<R[] | undefined>;
 }

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

@@ -2,7 +2,5 @@ import { iBXRestPagination } from '../../typification/rest/base/api-pagination-b
 import { ReturnTypeNavvy } from './navvy-support';
 import { NavvyPagBase } from './extends/navvy-pag-base';
 export declare class NavvyPag<T, R, P extends iBXRestPagination> extends NavvyPagBase<T[], R[], P> {
-    save: ReturnTypeNavvy<T, R>[];
     resAll(): import("rxjs").Observable<ReturnTypeNavvy<T, R>[]>;
-    private mapResForGetAll;
 }

package/services/navvy/navvy-support.d.ts

@@ -1,11 +1 @@
-import { Observable } from 'rxjs';
-import { iBXRestAnswer } from '../../typification/rest/base/answer';
 export type ReturnTypeNavvy<T, R> = T extends R ? T : R;
-export declare abstract class NavvySupport<C, T, R> {
-    requestClass: C;
-    pageSize: number;
-    protected constructor(requestClass: C);
-    mapAndError<T>(request: Observable<iBXRestAnswer<T> | undefined>): Observable<T | undefined>;
-    abstract resVanilla(): Observable<iBXRestAnswer<T> | undefined>;
-    abstract res(): ReturnTypeNavvy<Observable<T | undefined>, Observable<R | undefined>>;
-}

package/services/navvy.d.ts

@@ -15,6 +15,7 @@ export * from './navvy/navvy-pag';
 export * from './navvy/navvy-pag-nav-result-key-object';
 export * from './navvy/navvy-support';
 export declare class Navvy {
+    private readonly ctx;
     simple<T, R = T, A = undefined>(url: string[], arg?: A, map?: (param: T | undefined) => R | undefined): NavvySimple<T, R, (A & ({} | null)) | undefined>;
     simpleV3<T, R = T, A = undefined>(url: string[], arg?: A, map?: (param: T | undefined) => R | undefined): NavvySimple<T, R, (A & ({} | null)) | undefined>;
     /**

package/typification/rest/calendar/event/get.d.ts

@@ -1,4 +1,4 @@
-import { CountryCode, TimezoneName } from 'countries-and-timezones';
+import type { CountryCode, TimezoneName } from 'countries-and-timezones' with { 'resolution-mode': 'import' };
 import { iBXRestCalendarTypeEvent } from '../base/type';
 import { iBXRestYesNo } from '../../base/yes-no';
 export interface iBXRestCalendarEventGetAnswer extends iBXRestCalendarEventGetAnswerBase {

package/typification/rest/settings.d.ts

@@ -1,3 +1,4 @@
+export type { iBXRestSettings } from '../settings';
 export interface iHttpParamSettings {
     timeZone: {
         calc: boolean;

package/typification/rest/user/user.d.ts

@@ -2,8 +2,8 @@ import { iBXRestYesNo } from '../base/yes-no';
 export interface iBXRestUser extends iBXRestUserBase {
     ID: number;
     IS_ONLINE: boolean;
-    DATE_REGISTER: Date;
-    PERSONAL_BIRTHDAY: Date;
+    DATE_REGISTER?: Date;
+    PERSONAL_BIRTHDAY?: Date;
     LAST_LOGIN?: Date;
 }
 export interface iBXRestUserHttp extends iBXRestUserBase {
@@ -22,7 +22,7 @@ interface iBXRestUserBase {
     PERSONAL_GENDER?: iAllBXGender;
     PERSONAL_PROFESSION?: string;
     PERSONAL_WWW?: string;
-    PERSONAL_BIRTHDAY: string | Date;
+    PERSONAL_BIRTHDAY?: string | Date;
     PERSONAL_PHOTO: string | null;
     PERSONAL_ICQ: string | null;
     PERSONAL_PHONE: string | null;

package/typification/settings.d.ts

@@ -1,3 +1,4 @@
+import type { BXRestMiddleware } from '../services/http/transport';
 export interface iBXRestSettings {
     auth: {
         source: 'cookies' | 'localStorage' | 'off' | (() => string);
@@ -41,4 +42,37 @@ export interface iBXRestSettings {
      * библиотека всегда выставляет сама — от него зависит формат тела запроса.
      */
     headers?: Record<string, string>;
+    /**
+     * Повтор запроса, когда портал отвечает `QUERY_LIMIT_EXCEEDED` (превышен
+     * лимит частоты запросов, HTTP 503). `attempts` — сколько всего попыток
+     * вместе с первой, `delay` — пауза перед второй попыткой в мс, дальше она
+     * растёт вдвое. `true` — значения по умолчанию: `{ attempts: 3, delay: 1000 }`.
+     * Если не задано — запрос не повторяется.
+     */
+    retryOnQueryLimit?: boolean | {
+        attempts?: number;
+        delay?: number;
+    };
+    /**
+     * Предельное время одного HTTP-запроса, мс: дольше — запрос отменяется
+     * с ошибкой `BXRestTimeoutError`. Ожидание очереди `throttle` и паузы
+     * `retryOnQueryLimit` сюда не входят, у каждой попытки повтора своё время.
+     * `true` — 60 000 мс. Если не задано — время не ограничено.
+     */
+    timeout?: boolean | number;
+    /**
+     * Не больше `perSecond` запросов в секунду: лишние ждут своей очереди.
+     * Очередь своя у каждого клиента `new BXRestNavvy(settings)` и общая у
+     * всех, кто работает с глобальными `BXRestSettings`. `true` — 2 запроса
+     * в секунду, лимит Bitrix24 на обычных тарифах. Если не задано — без очереди.
+     */
+    throttle?: boolean | {
+        perSecond?: number;
+    };
+    /**
+     * Свои шаги перед отправкой каждого запроса: логирование, подмена
+     * заголовков, свой транспорт вместо axios. Первый в списке — внешний.
+     * Идут после `retryOnQueryLimit`, `throttle` и `timeout`, перед axios.
+     */
+    middleware?: BXRestMiddleware[];
 }

package/esm2022/functions/errorHandler.mjs

@@ -1,34 +0,0 @@
-export function CatchError(options) {
-    return function (target, propertyKey, descriptor) {
-        const original = descriptor.value;
-        descriptor.value = function (...args) {
-            try {
-                return original.apply(this, args);
-            }
-            catch (err) {
-                const errorInfo = {
-                    message: `❌ Error in ${target.constructor.name}.${propertyKey}`,
-                    args,
-                    error: err instanceof Error ? err.message : String(err),
-                    stack: err instanceof Error ? err.stack : new Error().stack,
-                };
-                console.error(formatError(errorInfo));
-                if (options?.rethrow)
-                    throw err;
-                return options?.defaultValue;
-            }
-        };
-        return descriptor;
-    };
-}
-// Общая функция форматирования
-export function formatError(info) {
-    const stackLines = info.stack?.split('\n').slice(2).join('\n');
-    return [
-        info.message,
-        info.args ? `   • args: ${JSON.stringify(info.args)}` : '',
-        info.error ? `   • error: ${info.error}` : '',
-        `   • stack trace:\n${stackLines}`,
-    ].join('\n');
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JIYW5kbGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcHJvamVjdHMvYngtcmVzdC9zcmMvZnVuY3Rpb25zL2Vycm9ySGFuZGxlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxNQUFNLFVBQVUsVUFBVSxDQUFDLE9BQW1EO0lBQzVFLE9BQU8sVUFDTCxNQUFXLEVBQ1gsV0FBbUIsRUFDbkIsVUFBOEI7UUFFOUIsTUFBTSxRQUFRLEdBQUcsVUFBVSxDQUFDLEtBQUssQ0FBQTtRQUVqQyxVQUFVLENBQUMsS0FBSyxHQUFHLFVBQVUsR0FBRyxJQUFXO1lBQ3pDLElBQUksQ0FBQztnQkFDSCxPQUFPLFFBQVEsQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxDQUFBO1lBQ25DLENBQUM7WUFBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO2dCQUNiLE1BQU0sU0FBUyxHQUFHO29CQUNoQixPQUFPLEVBQUUsY0FBYyxNQUFNLENBQUMsV0FBVyxDQUFDLElBQUksSUFBSSxXQUFXLEVBQUU7b0JBQy9ELElBQUk7b0JBQ0osS0FBSyxFQUFFLEdBQUcsWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUM7b0JBQ3ZELEtBQUssRUFBRSxHQUFHLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssRUFBRSxDQUFDLEtBQUs7aUJBQzVELENBQUE7Z0JBRUQsT0FBTyxDQUFDLEtBQUssQ0FBQyxXQUFXLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQTtnQkFFckMsSUFBSSxPQUFPLEVBQUUsT0FBTztvQkFBRSxNQUFNLEdBQUcsQ0FBQTtnQkFDL0IsT0FBTyxPQUFPLEVBQUUsWUFBWSxDQUFBO1lBQzlCLENBQUM7UUFDSCxDQUFDLENBQUE7UUFFRCxPQUFPLFVBQVUsQ0FBQTtJQUNuQixDQUFDLENBQUE7QUFDSCxDQUFDO0FBRUQsK0JBQStCO0FBQy9CLE1BQU0sVUFBVSxXQUFXLENBQUMsSUFBdUU7SUFDakcsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUM5RCxPQUFPO1FBQ0wsSUFBSSxDQUFDLE9BQU87UUFDWixJQUFJLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxjQUFjLElBQUksQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUU7UUFDMUQsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsZUFBZSxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUU7UUFDN0Msc0JBQXNCLFVBQVUsRUFBRTtLQUNuQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQTtBQUNkLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgZnVuY3Rpb24gQ2F0Y2hFcnJvcihvcHRpb25zPzogeyByZXRocm93PzogYm9vbGVhbjsgZGVmYXVsdFZhbHVlPzogYW55IH0pIHtcclxuICByZXR1cm4gZnVuY3Rpb24gKFxyXG4gICAgdGFyZ2V0OiBhbnksXHJcbiAgICBwcm9wZXJ0eUtleTogc3RyaW5nLFxyXG4gICAgZGVzY3JpcHRvcjogUHJvcGVydHlEZXNjcmlwdG9yXHJcbiAgKSB7XHJcbiAgICBjb25zdCBvcmlnaW5hbCA9IGRlc2NyaXB0b3IudmFsdWVcclxuXHJcbiAgICBkZXNjcmlwdG9yLnZhbHVlID0gZnVuY3Rpb24gKC4uLmFyZ3M6IGFueVtdKSB7XHJcbiAgICAgIHRyeSB7XHJcbiAgICAgICAgcmV0dXJuIG9yaWdpbmFsLmFwcGx5KHRoaXMsIGFyZ3MpXHJcbiAgICAgIH0gY2F0Y2ggKGVycikge1xyXG4gICAgICAgIGNvbnN0IGVycm9ySW5mbyA9IHtcclxuICAgICAgICAgIG1lc3NhZ2U6IGDinYwgRXJyb3IgaW4gJHt0YXJnZXQuY29uc3RydWN0b3IubmFtZX0uJHtwcm9wZXJ0eUtleX1gLFxyXG4gICAgICAgICAgYXJncyxcclxuICAgICAgICAgIGVycm9yOiBlcnIgaW5zdGFuY2VvZiBFcnJvciA/IGVyci5tZXNzYWdlIDogU3RyaW5nKGVyciksXHJcbiAgICAgICAgICBzdGFjazogZXJyIGluc3RhbmNlb2YgRXJyb3IgPyBlcnIuc3RhY2sgOiBuZXcgRXJyb3IoKS5zdGFjayxcclxuICAgICAgICB9XHJcblxyXG4gICAgICAgIGNvbnNvbGUuZXJyb3IoZm9ybWF0RXJyb3IoZXJyb3JJbmZvKSlcclxuXHJcbiAgICAgICAgaWYgKG9wdGlvbnM/LnJldGhyb3cpIHRocm93IGVyclxyXG4gICAgICAgIHJldHVybiBvcHRpb25zPy5kZWZhdWx0VmFsdWVcclxuICAgICAgfVxyXG4gICAgfVxyXG5cclxuICAgIHJldHVybiBkZXNjcmlwdG9yXHJcbiAgfVxyXG59XHJcblxyXG4vLyDQntCx0YnQsNGPINGE0YPQvdC60YbQuNGPINGE0L7RgNC80LDRgtC40YDQvtCy0LDQvdC40Y9cclxuZXhwb3J0IGZ1bmN0aW9uIGZvcm1hdEVycm9yKGluZm86IHsgbWVzc2FnZTogc3RyaW5nOyBhcmdzPzogYW55W107IGVycm9yPzogc3RyaW5nOyBzdGFjaz86IHN0cmluZyB9KTogc3RyaW5nIHtcclxuICBjb25zdCBzdGFja0xpbmVzID0gaW5mby5zdGFjaz8uc3BsaXQoJ1xcbicpLnNsaWNlKDIpLmpvaW4oJ1xcbicpXHJcbiAgcmV0dXJuIFtcclxuICAgIGluZm8ubWVzc2FnZSxcclxuICAgIGluZm8uYXJncyA/IGAgICDigKIgYXJnczogJHtKU09OLnN0cmluZ2lmeShpbmZvLmFyZ3MpfWAgOiAnJyxcclxuICAgIGluZm8uZXJyb3IgPyBgICAg4oCiIGVycm9yOiAke2luZm8uZXJyb3J9YCA6ICcnLFxyXG4gICAgYCAgIOKAoiBzdGFjayB0cmFjZTpcXG4ke3N0YWNrTGluZXN9YCxcclxuICBdLmpvaW4oJ1xcbicpXHJcbn1cclxuIl19