bx-rest 1.5.1 → 1.7.0

package/request-navvy/sale/payment.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySalePayment {
     /**
      * Возвращает список оплат.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет оплату.
      */

package/request-navvy/sale/paymentitembasket.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySalePaymentItemBasket {
     /**
      * Возвращает список привязок элементов корзины к оплатам.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет привязку элемента корзины к оплате.
      */

package/request-navvy/sale/paymentitemshipment.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySalePaymentItemShipment {
     /**
      * Возвращает список привязок оплат к отгрузкам.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет привязку оплаты к отгрузке.
      */

package/request-navvy/sale/persontype.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySalePersonType {
     /**
      * Возвращает список типов плательщиков.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет тип плательщика.
      */

package/request-navvy/sale/property.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySaleProperty {
     /**
      * Возвращает список свойств заказа.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет свойство заказа.
      */

package/request-navvy/sale/propertyrelation.d.ts

@@ -16,5 +16,5 @@ export declare class BXRestNavvySalePropertyRelation {
     /**
      * Возвращает список привязок свойств заказа.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
 }

package/request-navvy/sale/propertyvalue.d.ts

@@ -16,7 +16,7 @@ export declare class BXRestNavvySalePropertyValue {
     /**
      * Возвращает список значений свойств заказа.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Устанавливает или изменяет значение свойства заказа.
      */

package/request-navvy/sale/propertyvariant.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySalePropertyVariant {
     /**
      * Возвращает список значений списочного свойства заказа.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет значение списочного свойства заказа.
      */

package/request-navvy/sale/shipment.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySaleShipment {
     /**
      * Возвращает список отгрузок.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет отгрузку.
      */

package/request-navvy/sale/shipmentitem.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySaleShipmentItem {
     /**
      * Возвращает список товарных позиций отгрузки.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет товарную позицию отгрузки.
      */

package/request-navvy/sale/shipmentproperty.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySaleShipmentProperty {
     /**
      * Возвращает список свойств отгрузки.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет свойство отгрузки.
      */

package/request-navvy/sale/shipmentpropertyvalue.d.ts

@@ -16,7 +16,7 @@ export declare class BXRestNavvySaleShipmentPropertyValue {
     /**
      * Возвращает список значений свойств отгрузки.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Устанавливает или изменяет значение свойства отгрузки.
      */

package/request-navvy/sale/status.d.ts

@@ -20,7 +20,7 @@ export declare class BXRestNavvySaleStatus {
     /**
      * Возвращает список статусов.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Обновляет статус.
      */

package/request-navvy/sale/statuslang.d.ts

@@ -20,5 +20,5 @@ export declare class BXRestNavvySaleStatusLang {
     /**
      * Возвращает список локализаций статусов.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
 }

package/request-navvy/sale/tradebinding.d.ts

@@ -8,5 +8,5 @@ export declare class BXRestNavvySaleTradeBinding {
     /**
      * Возвращает список привязок источников заказов.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
 }

package/request-navvy/sale/tradeplatform.d.ts

@@ -8,5 +8,5 @@ export declare class BXRestNavvySaleTradePlatform {
     /**
      * Возвращает список источников заказов.
      */
-    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../../services/navvy").NavvyPagNavKeyed<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
 }

package/request-navvy/task/operation/elapseditem.d.ts

@@ -1,4 +1,5 @@
 import { iBXRestParamElapseditemGet, iBXRestTaskElapsedItemHttp, iIsActionAllowedParam, iBXRestParamAddElapseditem, iBXRestParamUpdateElapseditem, iBXRestParamDelElapseditem } from '../../../typification/rest/task';
+import { Observable } from 'rxjs';
 import { iBXRestUser } from '../../../typification/rest/user';
 import { BXRestNavvyElapsedItem } from '../elapseditem';
 export declare class BXRestNavvyOperationElapsedItem {
@@ -13,13 +14,17 @@ export declare class BXRestNavvyOperationElapsedItem {
      */
     getByInterval(idsUsers: number[], dateStart: Date, dateEnd: Date): import("../../../services/navvy").NavvyAlterPagNav<iBXRestTaskElapsedItemHttp, import("../../../typification/rest/task").iBXRestTaskElapsedItem, iBXRestParamElapseditemGet>;
     /**
-     * Возвращает список записей о затраченном времени по задаче.
+     * Возвращает все записи о затраченном времени по задачам `ids`: сначала записи первой задачи,
+     * затем второй и так далее.
+     *
+     * Портал отдаёт не больше 50 записей на страницу. Первые страницы всех задач уходят одним
+     * batch, остальные страницы запрашиваются только у задач, где записей больше 50.
      */
-    getListByIDTask(ids: number[]): import("rxjs").Observable<import("../../../typification/rest/task").iBXRestTaskElapsedItem[] | undefined>;
+    getListByIDTask(ids: number[]): Observable<import("../../../typification/rest/task").iBXRestTaskElapsedItem[] | undefined>;
     /**
      * Проверяет право на добавление затраченного времени сразу по нескольким задачам.
      */
-    checkPermissionAddElapsedTimeToTaskArr(tasks: number[], userCurrent?: iBXRestUser | undefined): import("rxjs").Observable<{
+    checkPermissionAddElapsedTimeToTaskArr(tasks: number[], userCurrent?: iBXRestUser | undefined): Observable<{
         id: number;
         value: boolean;
     }[] | undefined>;
@@ -29,32 +34,32 @@ export declare class BXRestNavvyOperationElapsedItem {
      * @param idTask
      * @param userCurrent
      */
-    checkPermissionAddElapsedTimeToTask(idTask: number, userCurrent?: iBXRestUser | undefined): import("rxjs").Observable<boolean | undefined>;
+    checkPermissionAddElapsedTimeToTask(idTask: number, userCurrent?: iBXRestUser | undefined): Observable<boolean | undefined>;
     /**
      * Проверка на возможность прочтения такски
      *
      * @param idTask
      * @param userCurrent
      */
-    checkPermissionReadTask(idTask: number, userCurrent?: iBXRestUser | undefined): import("rxjs").Observable<boolean | undefined>;
+    checkPermissionReadTask(idTask: number, userCurrent?: iBXRestUser | undefined): Observable<boolean | undefined>;
     /**
      * Законченный метод добавления записи с предварительной проверкой прав
      *
      * TODO: добавить сохранение предварительно проверенных записей
      * @param param
      */
-    add(param: iBXRestParamAddElapseditem): import("rxjs").Observable<number | undefined>;
+    add(param: iBXRestParamAddElapseditem): Observable<number | undefined>;
     /**
      * Законченный метод обновления записи с предварительной проверкой прав
      *
      * TODO: добавить сохранение предварительно проверенных записей
      * @param param
      */
-    update(param: iBXRestParamUpdateElapseditem): import("rxjs").Observable<null | undefined>;
+    update(param: iBXRestParamUpdateElapseditem): Observable<null | undefined>;
     /**
      * Проверяет право на изменение записи о затраченном времени.
      */
-    isAllowedModify(idTask: number, idItem: number): import("rxjs").Observable<boolean | undefined>;
+    isAllowedModify(idTask: number, idItem: number): Observable<boolean | undefined>;
     /**
      * isActionAllowed с фиксом на проверку возможности чтения задачи записи
      * (без проверки даёт ошибку)
@@ -65,13 +70,13 @@ export declare class BXRestNavvyOperationElapsedItem {
      * 3 - ACTION_ELAPSED_TIME_REMOVE
      * @param param
      */
-    isActionAllowed(param: iIsActionAllowedParam): import("rxjs").Observable<boolean | undefined>;
+    isActionAllowed(param: iIsActionAllowedParam): Observable<boolean | undefined>;
     /**
      * Полноценный метод удаления
      *
      * @param param
      */
-    del(param: iBXRestParamDelElapseditem): import("rxjs").Observable<null | undefined>;
+    del(param: iBXRestParamDelElapseditem): Observable<null | undefined>;
     /**
      * Проверяет право на удаление записи о затраченном времени.
      */

package/request-navvy/userfieldtype.d.ts

@@ -12,7 +12,7 @@ export declare class BXRestNavvyUserFieldType {
     /**
      * Возвращает список типов пользовательских полей, зарегистрированных приложением.
      */
-    list(param?: iBXRestGenericParams): import("../services/navvy").NavvySimple<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams | undefined>;
+    list(param?: iBXRestGenericParams): import("../services/navvy").NavvyPag<iBXRestGenericObject, iBXRestGenericObject, iBXRestGenericParams>;
     /**
      * Изменяет настройки зарегистрированного приложением типа пользовательских полей.
      */

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,17 @@ 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`, `logRequests`, затем `middleware`; последним идёт транспорт
+     * клиента — axios или `fetch` (`transport`). Настройки читаются при
+     * подписке. Отписка отменяет 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/fetch.d.ts

@@ -0,0 +1,22 @@
+import { BXRestRequestConfig } from './transport';
+/**
+ * Ответ не 2xx при `transport: 'fetch'`. Поле `response` такое же, как у
+ * `AxiosError`: по нему библиотека узнаёт ошибки Bitrix и ошибки авторизации.
+ * В `.resVanilla()` приходит сама эта ошибка, в `.res()` — в `cause`.
+ */
+export declare class BXRestHttpError extends Error {
+    readonly response: {
+        status: number;
+        data: unknown;
+    };
+    constructor(response: {
+        status: number;
+        data: unknown;
+    });
+}
+/**
+ * Транспорт `transport: 'fetch'`: глобальный `fetch` браузера или Node 18+.
+ * Тело ответа разбирается как JSON, а если это не JSON (например, HTML от
+ * прокси) — отдаётся строкой, как это делает axios.
+ */
+export declare function fetchSend(config: BXRestRequestConfig): Promise<unknown>;

package/services/http/http.d.ts

@@ -1,12 +1,23 @@
-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';
+import { iBXRestSettings } from '../../typification/settings';
+/**
+ * Общая часть 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>;
+    /**
+     * @param settings свои настройки, как у `new BXRestNavvy(settings)`: запросы
+     *   идут на этот портал с этим токеном, а `BXRestSettings` на них не влияют.
+     *   Без них — настройки клиента, внутри которого создан объект, или
+     *   глобальные `BXRestSettings`.
+     */
+    constructor(settings?: iBXRestSettings);
+    /**
+     * Экземпляр axios клиента. Один на контекст (клиента со своими настройками
+     * или глобальные настройки) и создаётся при первом запросе — раньше каждый
+     * объект запроса создавал свой.
+     */
+    protected get axiosInstance(): AxiosInstance;
 }

package/services/http/middleware.d.ts

@@ -0,0 +1,32 @@
+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/navvy-pag-nav-keyed.d.ts

@@ -0,0 +1,18 @@
+import { Observable } from 'rxjs';
+import { iBXRestPagination } from '../../typification/rest/base/api-pagination-bx';
+import { ReturnTypeNavvy } from './navvy-support';
+import { NavvyPagBase } from './extends/navvy-pag-base';
+/**
+ * Пагинация для методов, у которых `result` — объект, а список лежит в нём под ключом:
+ * `{ products: [...] }`, `{ orders: [...] }`.
+ *
+ * В отличие от {@link NavvyPagNavResultKey}, `.res()` отдаёт объект как есть, а `.resAll()` —
+ * такой же объект, где под ключом собраны записи всех страниц. Так `.resAll()` можно добавить
+ * методу, который раньше создавался через `simple`, не меняя результат его `.res()`.
+ */
+export declare class NavvyPagNavKeyed<T extends object, R, P extends iBXRestPagination> extends NavvyPagBase<T, R, P> {
+    private readonly key;
+    constructor(url: string[], param: P, key: string, map?: (param: T | undefined) => R | undefined, restApi?: boolean);
+    resAll(): Observable<ReturnTypeNavvy<T, R>>;
+    private listIn;
+}

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

@@ -6,6 +6,8 @@ import { NavvyPagNavTasks } from './navvy/navvy-pag-nav-tasks';
 import { NavvyPag } from './navvy/navvy-pag';
 import { NavvyPagNavResultKey } from './navvy/navvy-pag-nav-result-key';
 import { NavvyPagNavResultKeyObject } from './navvy/navvy-pag-nav-result-key-object';
+import { NavvyPagNavKeyed } from './navvy/navvy-pag-nav-keyed';
+import { iBXRestSettings } from '../typification/settings';
 export * from './navvy/navvy-simple';
 export * from './navvy/navvy-alternative-pagination-navigation';
 export * from './navvy/navvy-pag-nav-with-useless-key';
@@ -13,8 +15,17 @@ export * from './navvy/navvy-pag-nav-tasks';
 export * from './navvy/navvy-pag-nav-result-key';
 export * from './navvy/navvy-pag';
 export * from './navvy/navvy-pag-nav-result-key-object';
+export * from './navvy/navvy-pag-nav-keyed';
 export * from './navvy/navvy-support';
 export declare class Navvy {
+    private readonly ctx;
+    /**
+     * @param settings свои настройки, как у `new BXRestNavvy(settings)`: запросы
+     *   идут на этот портал с этим токеном, а `BXRestSettings` на них не влияют.
+     *   Без них — настройки клиента, внутри которого создан объект, или
+     *   глобальные `BXRestSettings`.
+     */
+    constructor(settings?: iBXRestSettings);
     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>;
     /**
@@ -31,6 +42,12 @@ export declare class Navvy {
     } | undefined) => R[] | undefined): NavvyPagNavTasks<T, R, A>;
     pagNavResultKey<T, R, A extends iBXRestPagination, K extends string>(url: string[], arg: A, key: K, map?: (param: Record<K, T[] | undefined> | undefined) => R[] | undefined): NavvyPagNavResultKey<T, R, A, K>;
     pagNavResultKeyObject<T, R, A extends iBXRestPagination, K extends string>(url: string[], arg: A, key: K, map?: (param: Record<K, Record<string, T> | undefined> | undefined) => R[] | undefined): NavvyPagNavResultKeyObject<T, R, A, K>;
+    /**
+     * Для методов, у которых `result` — объект со списком под ключом `key`, например
+     * `{ products: [...] }`. `.res()` отдаёт объект как есть, `.resAll()` — такой же объект
+     * с записями всех страниц под ключом.
+     */
+    pagNavKeyed<T extends object, R, A extends iBXRestPagination>(url: string[], arg: A, key: string, map?: (param: T | undefined) => R | undefined): NavvyPagNavKeyed<T, R, A>;
     pagNavWithUselessKey<T, R, A extends iBXRestPagination>(url: string[], arg: A, map?: (param: Record<string, T> | undefined) => R[] | undefined): NavvyPagNavWithUselessKey<T, R, A>;
     alterPagNav<T, R, A extends iBXRestAlternativePagination>(url: string[], arg: A, map?: (param: T[] | undefined) => R[] | undefined): NavvyAlterPagNav<T, R, A>;
 }

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/crm/requisite.d.ts

@@ -289,7 +289,7 @@ export interface iBXRestParamCrmRequisiteLinkGet {
     entityId: iBXRestCrmRequisiteId;
 }
 export type iBXRestParamCrmRequisiteLinkUnregister = iBXRestParamCrmRequisiteLinkGet;
-export interface iBXRestParamCrmRequisiteLinkList {
+export interface iBXRestParamCrmRequisiteLinkList extends iBXRestPagination {
     filter?: Record<string, any>;
     order?: Record<string, iBXRestCrmRequisiteSortDirection>;
 }

package/typification/rest/crm/timeline/bindings.d.ts

@@ -1,4 +1,5 @@
 import { iBXRestCrmFieldDescription } from '../enum';
+import { iBXRestPagination } from '../../base/api-pagination-bx';
 /** Связь записи таймлайна с элементом CRM. */
 export interface iBXRestCrmTimelineBinding {
     /** Идентификатор записи таймлайна. */
@@ -23,7 +24,7 @@ export interface iBXRestParamCrmTimelineBindingChange {
     fields: iBXRestCrmTimelineBindingFields;
 }
 /** Параметры получения связей записи таймлайна. */
-export interface iBXRestParamCrmTimelineBindingList {
+export interface iBXRestParamCrmTimelineBindingList extends iBXRestPagination {
     /** Фильтр с обязательным идентификатором записи таймлайна. */
     filter: {
         OWNER_ID: number;

package/typification/rest/pull/application/config/get.d.ts

@@ -1,3 +1,3 @@
 import { iBXRestPullConfigGetBase, iBXRestPullConfigGetChannelsPrivate, iBXRestPullConfigGetChannelsPrivateHttp, iBXRestPullConfigGetChannelsShared, iBXRestPullConfigGetChannelsSharedHttp, iBXRestPullConfigPublicChannelsGet, iBXRestPullConfigPublicChannelsGetHttp } from '../../config/get';
 export type iBXRestPullApplicationConfigGet = iBXRestPullConfigGetBase<iBXRestPullConfigGetChannelsShared, iBXRestPullConfigGetChannelsPrivate, iBXRestPullConfigPublicChannelsGet>;
-export type iBXRestPullApplicationConfigGetHttp = iBXRestPullConfigGetBase<iBXRestPullConfigGetChannelsSharedHttp, iBXRestPullConfigGetChannelsPrivateHttp, iBXRestPullConfigPublicChannelsGetHttp>;
+export type iBXRestPullApplicationConfigGetHttp = iBXRestPullConfigGetBase<iBXRestPullConfigGetChannelsSharedHttp, iBXRestPullConfigGetChannelsPrivateHttp, iBXRestPullConfigPublicChannelsGetHttp, false>;