bx-rest 1.6.0 → 1.7.0

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/services/http/HttpBX.d.ts

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

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,11 +1,19 @@
 import { AxiosInstance } from 'axios';
 import { SessionKeyServices } from './sessionKey';
+import { iBXRestSettings } from '../../typification/settings';
 /**
  * Общая часть HTTP-клиента: экземпляр axios и источник токена и адреса.
  * Сами запросы отправляет `HttpBXServices` (`BXRestRequest`).
  */
 export declare class HttpServices {
     readonly session: SessionKeyServices;
+    /**
+     * @param settings свои настройки, как у `new BXRestNavvy(settings)`: запросы
+     *   идут на этот портал с этим токеном, а `BXRestSettings` на них не влияют.
+     *   Без них — настройки клиента, внутри которого создан объект, или
+     *   глобальные `BXRestSettings`.
+     */
+    constructor(settings?: iBXRestSettings);
     /**
      * Экземпляр axios клиента. Один на контекст (клиента со своими настройками
      * или глобальные настройки) и создаётся при первом запросе — раньше каждый

package/services/http/middleware.d.ts

@@ -24,8 +24,9 @@ export interface ThrottleState {
     throttleNextSlot: number;
 }
 /**
- * Встроенные шаги из настроек, в этом порядке: повтор, очередь, таймаут.
+ * Встроенные шаги из настроек, в этом порядке: повтор, очередь, таймаут, журнал.
  * Повтор — снаружи: каждая попытка заново встаёт в очередь и получает свой
  * таймаут. Таймаут — внутри очереди: ожидание своей очереди его не тратит.
+ * Журнал — внутри всех: каждая попытка — своя запись, без времени в очереди.
  */
 export declare function builtInMiddleware(settings: iBXRestSettings, state: ThrottleState): BXRestMiddleware[];

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.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,9 +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>;
     /**
@@ -32,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/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>;

package/typification/rest/pull/application/event/add.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Параметры `pull.application.event.add`.
+ *
+ * @see https://apidocs.bitrix24.com/settings/interactivity/pull-application-event-add.html
+ */
+export interface iBXRestParamPullApplicationEventAdd {
+    /**
+     * Команда события, по ней клиент различает события. Допустимы символы
+     * `A-Z`, `a-z`, `0-9`, `_`, `:`, `|`, `.`, `-`.
+     */
+    COMMAND: string;
+    /** Параметры события, поля задаёте сами. Без них клиент получит пустой `params`. */
+    PARAMS?: Record<string, unknown>;
+    /** Модуль события, по умолчанию `application`. Допустимы символы `a-z`, `0-9`, `.`, `_`. */
+    MODULE_ID?: string;
+    /**
+     * Получатели. Без параметра событие уходит в общий канал `shared`, с ним — в личные каналы
+     * `private` указанных пользователей.
+     *
+     * Администратор может указать любых пользователей. Остальные — только себя и только строкой,
+     * например `'577'`: число или массив портал отклонит с ошибкой `USER_ID_ACCESS_ERROR`.
+     */
+    USER_ID?: number | string | number[];
+}

package/typification/rest/pull/application/push/add.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Параметры `pull.application.push.add`.
+ *
+ * @see https://apidocs.bitrix24.com/settings/interactivity/pull-application-push-add.html
+ */
+export interface iBXRestParamPullApplicationPushAdd {
+    /**
+     * Получатели. По документации портал не проверяет параметр: без него метод ответит успехом,
+     * но уведомление никуда не уйдёт. Поэтому в типе он обязательный.
+     */
+    USER_ID: number | string | number[];
+    /** Текст уведомления, до 4 КБ. Пустой текст или `0` портал отклонит с ошибкой `TEXT_ERROR`. */
+    TEXT: string;
+    /** Абсолютный адрес картинки для уведомления. */
+    AVATAR?: string;
+}

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

@@ -1,10 +1,26 @@
 export interface iBXRestPullConfigGet extends iBXRestPullConfigGetBase<iBXRestPullConfigGetChannelsShared, iBXRestPullConfigGetChannelsPrivate, iBXRestPullConfigPublicChannelsGet> {
     serverTime: Date;
 }
-export interface iBXRestPullConfigGetHttp extends iBXRestPullConfigGetBase<iBXRestPullConfigGetChannelsSharedHttp, iBXRestPullConfigGetChannelsPrivateHttp, iBXRestPullConfigPublicChannelsGetHttp> {
+export interface iBXRestPullConfigGetHttp extends iBXRestPullConfigGetBase<iBXRestPullConfigGetChannelsSharedHttp, iBXRestPullConfigGetChannelsPrivateHttp, iBXRestPullConfigPublicChannelsGetHttp, false> {
     serverTime: string;
 }
-export interface iBXRestPullConfigGetBase<channelsShared = iBXRestPullConfigGetChannelsSharedBase, channelsPrivate = iBXRestPullConfigGetChannelsPrivateBase, publicChannels = iBXRestPullConfigPublicChannelsGetBase> {
+/**
+ * Параметры `pull.config.get` и `pull.application.config.get`.
+ */
+export interface iBXRestParamPullConfigGet {
+    /** `N` — не брать настройки из кэша. По документации сейчас ни на что не влияет. */
+    CACHE?: string;
+    /** `N` — не выдавать новый канал вместо истёкшего. По документации сейчас ни на что не влияет. */
+    REOPEN?: string;
+}
+/**
+ * Настройки подключения к серверу Push & Pull.
+ *
+ * @see https://apidocs.bitrix24.com/settings/interactivity/pull-application-config-get.html
+ */
+export interface iBXRestPullConfigGetBase<channelsShared = iBXRestPullConfigGetChannelsSharedBase, channelsPrivate = iBXRestPullConfigGetChannelsPrivateBase, publicChannels = iBXRestPullConfigPublicChannelsGetBase, 
+/** Что приходит в `publicChannels`, если каналов нет: портал отдаёт `false` при версии сервера ниже 4. */
+noPublicChannels = never> {
     server: {
         version: number;
         server_enabled: boolean;
@@ -28,7 +44,16 @@ export interface iBXRestPullConfigGetBase<channelsShared = iBXRestPullConfigGetC
         shared: channelsShared;
         private: channelsPrivate;
     };
-    publicChannels: Record<string, publicChannels>;
+    publicChannels: Record<string, publicChannels> | noPublicChannels;
+    /**
+     * До какого времени действуют настройки, Unix timestamp в секундах. Приходит не всегда:
+     * если поля нет, ориентируйтесь на `end` каналов.
+     */
+    exp?: number;
+    /** Идентификатор портала на общем сервере Push & Pull. Приходит, когда `server.mode` равен `shared`. */
+    clientId?: string;
+    /** JWT для подключения к серверу. Приходит при `server.version` 5 и выше. */
+    jwt?: string;
 }
 export interface iBXRestPullConfigGetChannelsShared extends iBXRestPullConfigGetChannelsSharedBase {
     start: Date;

package/typification/rest/pull.d.ts

@@ -1,3 +1,5 @@
 export * from './pull/config/get';
 export * from './pull/channel/get';
 export * from './pull/application/config/get';
+export * from './pull/application/event/add';
+export * from './pull/application/push/add';

package/typification/settings.d.ts

@@ -69,10 +69,44 @@ export interface iBXRestSettings {
     throttle?: boolean | {
         perSecond?: number;
     };
+    /**
+     * Журнал запросов: функция получает запись о каждом HTTP-запросе после
+     * его завершения — метод, адрес, длительность, статус и код ошибки. Повтор
+     * из `retryOnQueryLimit` — отдельная запись, ожидание очереди `throttle`
+     * в длительность не входит. Тела запроса в записи нет, но адрес — как есть:
+     * у вебхука в нём секрет, у GET-запроса — токен. Исключение из функции на
+     * запрос не влияет. Если не задано — журнала нет.
+     */
+    logRequests?: (entry: BXRestRequestLogEntry) => void;
+    /**
+     * Чем отправлять запросы: `'axios'` (по умолчанию) или `'fetch'` — через
+     * глобальный `fetch` браузера или Node 18+. Результат и ошибки те же: ответ
+     * не 2xx приходит ошибкой `BXRestHttpError` с полем `response: { status, data }`,
+     * как у `AxiosError`. Свой транспорт задаётся через `middleware`.
+     */
+    transport?: 'axios' | 'fetch';
     /**
      * Свои шаги перед отправкой каждого запроса: логирование, подмена
      * заголовков, свой транспорт вместо axios. Первый в списке — внешний.
-     * Идут после `retryOnQueryLimit`, `throttle` и `timeout`, перед axios.
+     * Идут после `retryOnQueryLimit`, `throttle`, `timeout` и `logRequests`,
+     * перед транспортом.
      */
     middleware?: BXRestMiddleware[];
 }
+/** Запись журнала `logRequests` об одном HTTP-запросе. */
+export interface BXRestRequestLogEntry {
+    method: 'GET' | 'POST';
+    /** Полный адрес запроса, как есть: у вебхука в нём секрет, у GET-запроса — токен. */
+    url: string;
+    /** Время от отправки до ответа или ошибки, мс. */
+    duration: number;
+    /** Запрос завершился ошибкой: ответ не 2xx, сбой сети, таймаут или отмена. */
+    failed: boolean;
+    /** HTTP-статус ответа с ошибкой. У успешного ответа транспорт статус не сообщает. */
+    status?: number;
+    /**
+     * Код ошибки Bitrix из тела ответа, например `QUERY_LIMIT_EXCEEDED`, в том числе
+     * из ответа 2xx. Если портал кода не прислал — текст ошибки запроса.
+     */
+    error?: string;
+}