bx-rest 1.5.1 → 1.7.0

package/fesm2022/bx-rest.mjs

@@ -1,5 +1,5 @@
-import { Subscription, of, throwError, from, defer, forkJoin, concatMap, toArray, mergeMap, shareReplay, tap } from 'rxjs';
-import { switchMap, catchError, map, take, mergeMap as mergeMap$1 } from 'rxjs/operators';
+import { Subscription, of, defer, throwError, from, forkJoin, Observable, concatMap, toArray, mergeMap, shareReplay, tap, catchError as catchError$1 } from 'rxjs';
+import { catchError, switchMap, map, take, mergeMap as mergeMap$1 } from 'rxjs/operators';
 import clone from 'just-clone';
 import axios from 'axios';
 import flatten from 'just-flatten-it';
@@ -414,9 +414,6 @@ async function getBase64FileLikeStr(file) {
     return undefined;
 }
 function prepareBaseAddress(url, add = '') {
-    // if (url.search('https://') !== 0 && url.search('http://')) {
-    //   url = 'https://' + url
-    // }
     if (add && add.length > 0) {
         if (url.lastIndexOf('/') !== (url.length - 1)) {
             url = url + '/';
@@ -523,6 +520,64 @@ class SessionStorage {
     }
 }
 
+/**
+ * Контекст клиента: его настройки, экземпляр axios и общее состояние
+ * продления авторизации и очереди `throttle`.
+ *
+ * Объекты библиотеки запоминают контекст в момент создания
+ * (`currentContext()`), поэтому все запросы клиента `new BXRestNavvy(settings)`
+ * идут с его настройками, а не с глобальными. Внутренняя деталь библиотеки.
+ */
+class BXRestContext {
+    constructor(own) {
+        this.own = own;
+        /** Сколько продлений уже завершилось успешно. */
+        this.refreshCount = 0;
+        /** Очередь `throttle`: когда можно отправить следующий запрос клиента (мс, Date.now()). */
+        this.throttleNextSlot = 0;
+    }
+    /**
+     * Свои настройки клиента, а без них — глобальные `BXRestSettings.value`,
+     * прочитанные в момент обращения: `BXRestSettings.update()` заменяет объект.
+     */
+    get settings() {
+        return this.own ?? BXRestSettings.value;
+    }
+}
+/**
+ * Контекст глобальных настроек. С ним работают `new BXRestNavvy()` без
+ * аргумента и объекты, созданные приложением напрямую (`new Navvy()`,
+ * `new BXRestRequest()`).
+ */
+const globalContext = /* @__PURE__ */ new BXRestContext();
+let current = globalContext;
+function currentContext() {
+    return current;
+}
+/**
+ * Делает `ctx` текущим и возвращает прежний контекст. Вызывающий обязан
+ * вернуть его через `restoreContext()` в `finally`: иначе после исключения
+ * чужие настройки достанутся объектам, созданным позже.
+ */
+function enterContext(ctx) {
+    const previous = current;
+    current = ctx;
+    return previous;
+}
+function restoreContext(previous) {
+    current = previous;
+}
+/** Создаёт объекты в контексте `ctx` и возвращает прежний контекст, даже при исключении. */
+function runInContext(ctx, build) {
+    const previous = enterContext(ctx);
+    try {
+        return build();
+    }
+    finally {
+        restoreContext(previous);
+    }
+}
+
 class SessionKeyError extends Error {
     constructor(message) {
         super(message);
@@ -534,12 +589,18 @@ class SessionKeyServices {
     // НОВЫЙ объект (this.value = {...this.value, ...}), а не мутирует старый —
     // поэтому `= BXRestSettings.value` в виде обычного поля навсегда
     // "заморозил" бы то, что было на момент создания SessionKeyServices.
-    // Геттер вместо этого читает актуальный BXRestSettings.value при каждом
-    // обращении.
+    // Геттер вместо этого читает актуальные настройки при каждом обращении:
+    // свои настройки клиента или глобальные BXRestSettings.value.
     get BX_REST_SETTINGS() {
-        return BXRestSettings.value;
+        return this.ctx.settings;
     }
     constructor() {
+        /**
+         * Контекст клиента, в котором создан объект: внутри `new BXRestNavvy(settings)`
+         * — контекст этого клиента, в остальных случаях — глобальные настройки.
+         * Объявлен первым: конструктор ниже уже читает настройки.
+         */
+        this.ctx = currentContext();
         this.authHave = false;
         this.subscribe = {
             authData: new Subscription()
@@ -598,6 +659,10 @@ class SessionKeyServices {
     getHeaders() {
         return { ...this.BX_REST_SETTINGS.headers };
     }
+    /** Свои middleware из настроек (`middleware`), читаются при каждом запросе — как и остальные настройки. */
+    getMiddleware() {
+        return this.BX_REST_SETTINGS.middleware ?? [];
+    }
     getSessid() {
         const check = this.getSearchParam('sessid');
         if (check) {
@@ -763,151 +828,29 @@ class SessionKeyServices {
     }
 }
 
-class HttpData {
-    constructor() {
-        this.defSettings = {
-            timeZone: {
-                calc: true,
-                levelOut: false
-            }
-        };
-    }
-    getHttpParamsPost(obj, sendHttpParams = new FormData(), nesting = [], settings = this.defSettings) {
-        if (obj instanceof Blob) {
-            let first = nesting[0];
-            let setKey = (nesting.length > 1)
-                ? first + '[' + nesting.slice(1).join('][') + ']'
-                : first;
-            sendHttpParams.set(setKey, obj);
-            return sendHttpParams;
-        }
-        else if (obj instanceof Date) {
-            let first = nesting[0];
-            let tzoffset = (settings.timeZone.calc) ? obj.getTimezoneOffset() * 60000 : 0; // вычисляем влияние часового пояса
-            let levelOut = (settings.timeZone.levelOut) ? obj.getTimezoneOffset() * 60000 : 0; // вычисляем влияние часового пояса
-            let setKey = (nesting.length > 1)
-                ? first + '[' + nesting.slice(1).join('][') + ']'
-                : first;
-            sendHttpParams.set(setKey, (new Date(obj.valueOf() + tzoffset - levelOut)).toISOString());
-            return sendHttpParams;
-        }
-        else {
-            for (const key in obj) {
-                let setKey = '';
-                if (nesting.length) {
-                    let first = nesting[0];
-                    setKey = (nesting.length > 1)
-                        ? first + '[' + nesting.slice(1).join('][') + '][' + key + ']'
-                        : first + '[' + key + ']';
-                }
-                else {
-                    setKey = key;
-                }
-                switch (typeof obj[key]) {
-                    case 'string':
-                        sendHttpParams.set(setKey, obj[key]);
-                        break;
-                    case 'symbol':
-                    case 'number':
-                    case 'bigint':
-                    case 'boolean':
-                        sendHttpParams.set(setKey, String(obj[key]));
-                        break;
-                    case 'object':
-                        nesting.push(key);
-                        sendHttpParams = this.getHttpParamsPost(obj[key], sendHttpParams, nesting, settings);
-                        nesting.pop();
-                        break;
-                    case 'function':
-                    case 'undefined':
-                    default:
-                        console.error('You sent something wrong', obj[key], typeof obj[key], typeof obj);
-                }
-            }
-        }
-        return sendHttpParams;
-    }
-    sliceArrayIntoChunks(arr, chunkSize) {
-        const res = [];
-        for (let i = 0; i < arr.length; i += chunkSize) {
-            const chunk = arr.slice(i, i + chunkSize);
-            res.push(chunk);
-        }
-        return res;
-    }
-    removingMultipleSlashes(str) {
-        return str.replace(/\/{2,}/g, '/');
-    }
-}
-
-class BaseHttp extends HttpData {
-}
-
-class HttpServices extends BaseHttp {
-    constructor() {
-        super();
-        this.session = new SessionKeyServices();
-        this.axiosInstance = axios.create();
-    }
-    httpPost(url, params = {}, settings = this.defSettings) {
-        const auth = this.session.getAuthParams();
-        const checkIsOn = this.session.getCheckAuthParamsIsOn();
-        const paramsClone = clone(params);
-        if (checkIsOn) {
-            if (!auth) {
-                return throwError(() => this.session.getAuthError('post'));
-            }
-            paramsClone[this.session.getKeyAuth()] = auth;
-        }
-        return this.session.getBaseUrl().pipe(switchMap((baseUrl) => {
-            if (!baseUrl) {
-                return throwError(() => this.session.getBaseUrlError('post'));
-            }
-            const fullUrl = prepareBaseAddress(baseUrl) + url;
-            if (this.session.getKeyAuth() === 'sessid') {
-                const urlEncodedBody = new URLSearchParams();
-                Object.keys(paramsClone).forEach((key) => {
-                    const value = paramsClone[key];
-                    if (typeof value === 'object' && value !== null) {
-                        for (const subKey in value) {
-                            if (Object.prototype.hasOwnProperty.call(value, subKey)) {
-                                urlEncodedBody.append(`${key}[${subKey}]`, value[subKey]);
-                            }
-                        }
-                    }
-                    else {
-                        urlEncodedBody.append(key, value);
-                    }
-                });
-                return from(this.axiosInstance.post(fullUrl, urlEncodedBody.toString(), {
-                    headers: {
-                        'Content-Type': 'application/x-www-form-urlencoded',
-                    },
-                }).then((response) => response.data));
-            }
-            const body = this.getHttpParamsPost(paramsClone, new FormData(), [], settings);
-            return from(this.axiosInstance.post(fullUrl, body).then((response) => response.data));
-        }));
+/**
+ * Общая часть HTTP-клиента: экземпляр axios и источник токена и адреса.
+ * Сами запросы отправляет `HttpBXServices` (`BXRestRequest`).
+ */
+class HttpServices {
+    /**
+     * @param settings свои настройки, как у `new BXRestNavvy(settings)`: запросы
+     *   идут на этот портал с этим токеном, а `BXRestSettings` на них не влияют.
+     *   Без них — настройки клиента, внутри которого создан объект, или
+     *   глобальные `BXRestSettings`.
+     */
+    constructor(settings) {
+        this.session = settings
+            ? runInContext(new BXRestContext(settings), () => new SessionKeyServices())
+            : new SessionKeyServices();
     }
-    httpGet(url, params = {}) {
-        const auth = this.session.getAuthParams();
-        const checkIsOn = this.session.getCheckAuthParamsIsOn();
-        const paramsClone = clone(params);
-        if (checkIsOn) {
-            if (!auth) {
-                return throwError(() => this.session.getAuthError('get'));
-            }
-            paramsClone[this.session.getKeyAuth()] = auth;
-        }
-        return this.session.getBaseUrl().pipe(switchMap((baseUrl) => {
-            if (!baseUrl) {
-                return throwError(() => this.session.getBaseUrlError('get'));
-            }
-            const fullUrl = prepareBaseAddress(baseUrl) + url;
-            const queryString = new URLSearchParams(paramsClone).toString();
-            const finalUrl = `${fullUrl}?${queryString}`;
-            return from(this.axiosInstance.get(finalUrl).then((response) => response.data));
-        }));
+    /**
+     * Экземпляр axios клиента. Один на контекст (клиента со своими настройками
+     * или глобальные настройки) и создаётся при первом запросе — раньше каждый
+     * объект запроса создавал свой.
+     */
+    get axiosInstance() {
+        return this.session.ctx.axios ??= axios.create();
     }
 }
 
@@ -1008,20 +951,33 @@ function parseBXRestErrorBody(body) {
  * Bitrix error body, so the caller can keep its own handling for them.
  */
 function bxRestApiErrorFromHttp(err, method) {
-    if (!axios.isAxiosError(err) || !err.response) {
+    const response = httpErrorResponse(err);
+    if (!response) {
         return undefined;
     }
-    const parsed = parseBXRestErrorBody(err.response.data);
+    const parsed = parseBXRestErrorBody(response.data);
     if (!parsed) {
         return undefined;
     }
     return new BXRestApiError(parsed.error, parsed.error_description, {
-        status: err.response.status,
+        status: response.status,
         method,
         cause: err,
         authRefreshError: getAuthRefreshError(err)
     });
 }
+/**
+ * HTTP-ответ из ошибки транспорта: `response: { status, data }`. Так устроен
+ * `AxiosError`, и так же должны отклоняться свои транспорты (middleware).
+ * Для сетевых ошибок, отмены и прочих ошибок — `undefined`.
+ */
+function httpErrorResponse(error) {
+    const response = (error && typeof error === 'object') ? error.response : undefined;
+    if (!response || typeof response !== 'object' || typeof response.status !== 'number') {
+        return undefined;
+    }
+    return response;
+}
 
 /**
  * Коды ошибок Bitrix, которые лечатся продлением токена. `expired_token` —
@@ -1044,34 +1000,34 @@ const AUTH_ERROR_CODES = ['expired_token', 'invalid_token'];
  * Ответ 401 с другим кодом Bitrix ошибкой авторизации не считается.
  */
 function isBXRestAuthError(error) {
-    if (!axios.isAxiosError(error) || !error.response) {
+    const response = httpErrorResponse(error);
+    if (!response) {
         return false;
     }
-    const parsed = parseBXRestErrorBody(error.response.data);
+    const parsed = parseBXRestErrorBody(response.data);
     if (parsed) {
         return AUTH_ERROR_CODES.includes(parsed.error);
     }
-    return error.response.status === 401;
+    return response.status === 401;
 }
-// Общее на всю библиотеку состояние продления — как и сами BXRestSettings.
-// pendingRefresh — идущее сейчас продление, его ждут все упавшие запросы;
-// refreshCount — сколько продлений уже завершилось успешно.
-let pendingRefresh;
-let refreshCount = 0;
-function sharedRefresh(refresh) {
-    if (!pendingRefresh) {
-        pendingRefresh = Promise.resolve()
+// Состояние продления живёт в контексте клиента (BXRestContext): у глобальных
+// настроек оно одно на всю библиотеку, у каждого new BXRestNavvy(settings) —
+// своё. pendingRefresh — идущее сейчас продление, его ждут все упавшие
+// запросы клиента; refreshCount — сколько продлений уже завершилось успешно.
+function sharedRefresh(refresh, ctx) {
+    if (!ctx.pendingRefresh) {
+        ctx.pendingRefresh = Promise.resolve()
             // Через then, чтобы синхронное исключение в refresh() тоже стало
             // отклонённым промисом, а не вылетело из catchError
             .then(() => refresh())
             .then(() => {
-            refreshCount++;
+            ctx.refreshCount++;
         })
             .finally(() => {
-            pendingRefresh = undefined;
+            ctx.pendingRefresh = undefined;
         });
     }
-    return pendingRefresh;
+    return ctx.pendingRefresh;
 }
 /**
  * Повтор запроса после продления авторизации (`BXRestSettings.auth.refresh`).
@@ -1080,23 +1036,26 @@ function sharedRefresh(refresh) {
  * `defer()` в HttpBXServices): повтор — это повторная подписка, поэтому
  * токен, адрес и заголовки берутся уже новые. На второй попытке ошибка не
  * перехватывается — запрос повторяется не больше одного раза.
+ *
+ * `ctx` — контекст клиента, из которого берутся `refresh`, `isAuthError` и
+ * общее состояние продления.
  */
-function withAuthRefresh(request$) {
+function withAuthRefresh(request$, ctx = globalContext) {
     return defer(() => {
-        const { refresh, isAuthError = isBXRestAuthError } = BXRestSettings.value.auth;
+        const { refresh, isAuthError = isBXRestAuthError } = ctx.settings.auth;
         if (!refresh) {
             return request$;
         }
-        const refreshCountAtStart = refreshCount;
+        const refreshCountAtStart = ctx.refreshCount;
         return request$.pipe(catchError((error) => {
             if (!isAuthError(error)) {
                 return throwError(() => error);
             }
             // Пока этот запрос был в пути, токен уже продлили по ошибке другого
             // запроса — повторяем без нового продления
-            const refreshed = (refreshCount !== refreshCountAtStart)
+            const refreshed = (ctx.refreshCount !== refreshCountAtStart)
                 ? Promise.resolve()
-                : sharedRefresh(refresh);
+                : sharedRefresh(refresh, ctx);
             return from(refreshed).pipe(catchError((refreshError) => {
                 if (error && typeof error === 'object') {
                     error.authRefreshError = refreshError;
@@ -1107,6 +1066,258 @@ function withAuthRefresh(request$) {
     });
 }
 
+/** Первый middleware в списке — внешний: он первым видит запрос и последним — ответ. */
+function composeMiddleware(middleware, terminal) {
+    return middleware.reduceRight((next, step) => config => step(config, next), terminal);
+}
+
+/** `retryOnQueryLimit: true`: всего 3 попытки, пауза перед второй — 1000 мс, дальше вдвое больше. */
+const DEFAULT_RETRY_ON_QUERY_LIMIT = { attempts: 3, delay: 1000 };
+/** `timeout: true`: 60 000 мс на один HTTP-запрос. */
+const DEFAULT_TIMEOUT$1 = 60_000;
+/** `throttle: true`: 2 запроса в секунду — лимит Bitrix24 на обычных тарифах. */
+const DEFAULT_THROTTLE = { perSecond: 2 };
+/**
+ * Запрос не завершился за время из `timeout` в настройках. В `.resVanilla()`
+ * приходит сама эта ошибка, в `.res()` — в `cause`.
+ */
+class BXRestTimeoutError extends Error {
+    constructor(timeout) {
+        super(`The request did not finish in ${timeout} ms`);
+        this.timeout = timeout;
+        this.name = 'BXRestTimeoutError';
+    }
+}
+/**
+ * Встроенные шаги из настроек, в этом порядке: повтор, очередь, таймаут, журнал.
+ * Повтор — снаружи: каждая попытка заново встаёт в очередь и получает свой
+ * таймаут. Таймаут — внутри очереди: ожидание своей очереди его не тратит.
+ * Журнал — внутри всех: каждая попытка — своя запись, без времени в очереди.
+ */
+function builtInMiddleware(settings, state) {
+    const steps = [];
+    if (settings.retryOnQueryLimit) {
+        const own = (settings.retryOnQueryLimit === true) ? {} : settings.retryOnQueryLimit;
+        const attempts = own.attempts ?? DEFAULT_RETRY_ON_QUERY_LIMIT.attempts;
+        const delay = own.delay ?? DEFAULT_RETRY_ON_QUERY_LIMIT.delay;
+        if (!Number.isInteger(attempts) || attempts < 1) {
+            throw invalid('retryOnQueryLimit.attempts', attempts, 'a whole number from 1');
+        }
+        if (!Number.isFinite(delay) || delay < 0) {
+            throw invalid('retryOnQueryLimit.delay', delay, 'a number of milliseconds from 0');
+        }
+        steps.push(retryOnQueryLimit(attempts, delay));
+    }
+    if (settings.throttle) {
+        const own = (settings.throttle === true) ? {} : settings.throttle;
+        const perSecond = own.perSecond ?? DEFAULT_THROTTLE.perSecond;
+        if (!Number.isFinite(perSecond) || perSecond <= 0) {
+            throw invalid('throttle.perSecond', perSecond, 'a number above 0');
+        }
+        steps.push(throttle(perSecond, state));
+    }
+    if (settings.timeout) {
+        const ms = (settings.timeout === true) ? DEFAULT_TIMEOUT$1 : settings.timeout;
+        // setTimeout считает больше 2^31 − 1 мс за 0 и сработал бы сразу
+        if (!Number.isFinite(ms) || ms <= 0 || ms > 2_147_483_647) {
+            throw invalid('timeout', ms, 'a number of milliseconds from 1 to 2147483647');
+        }
+        steps.push(timeout(ms));
+    }
+    if (settings.logRequests !== undefined) {
+        if (typeof settings.logRequests !== 'function') {
+            throw invalid('logRequests', settings.logRequests, 'a function');
+        }
+        steps.push(logRequests(settings.logRequests));
+    }
+    if (settings.transport !== undefined && settings.transport !== 'axios' && settings.transport !== 'fetch') {
+        throw invalid('transport', settings.transport, "'axios' or 'fetch'");
+    }
+    return steps;
+}
+function invalid(name, value, expected) {
+    return new TypeError(`bx-rest settings: ${name} must be ${expected}, got ${String(value)}`);
+}
+function abortReason(signal) {
+    return signal.reason ?? new Error('The request was aborted');
+}
+/** Пауза, которую прерывает отмена запроса. */
+function wait(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(abortReason(signal));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortReason(signal));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Повтор при `QUERY_LIMIT_EXCEEDED`: портал отвечает так (HTTP 503), когда
+ * превышен лимит частоты запросов. Пауза растёт вдвое: `delay`, `2 × delay`, ...
+ * `attempts` — сколько всего попыток, вместе с первой.
+ */
+function retryOnQueryLimit(attempts, delay) {
+    return async (config, next) => {
+        for (let attempt = 1;; attempt++) {
+            try {
+                return await next(config);
+            }
+            catch (error) {
+                const code = parseBXRestErrorBody(httpErrorResponse(error)?.data)?.error;
+                if (attempt >= attempts || code !== 'QUERY_LIMIT_EXCEEDED') {
+                    throw error;
+                }
+                await wait(delay * 2 ** (attempt - 1), config.signal);
+            }
+        }
+    };
+}
+/**
+ * Не больше `perSecond` запросов в секунду: лишние ждут своей очереди.
+ * Очередь общая для всех запросов клиента (`state` — его контекст).
+ */
+function throttle(perSecond, state) {
+    const interval = 1000 / perSecond;
+    return (config, next) => {
+        const now = Date.now();
+        const start = Math.max(now, state.throttleNextSlot);
+        const reserved = start + interval;
+        state.throttleNextSlot = reserved;
+        if (start <= now) {
+            return next(config);
+        }
+        return wait(start - now, config.signal).then(() => next(config), (error) => {
+            // Отменённый запрос освобождает своё место, если за ним никто не встал
+            if (state.throttleNextSlot === reserved) {
+                state.throttleNextSlot = start;
+            }
+            throw error;
+        });
+    };
+}
+/** Код ошибки Bitrix из тела ответа или, если его нет, текст ошибки запроса. */
+function errorText(body, error) {
+    const code = parseBXRestErrorBody(body)?.error;
+    if (code) {
+        return code;
+    }
+    return (error instanceof Error) ? error.message : undefined;
+}
+/**
+ * Пишет в журнал запись о каждом HTTP-запросе. Исключение из `log` проглатывается:
+ * журнал не должен ломать запрос.
+ */
+function logRequests(log) {
+    const write = (entry) => {
+        try {
+            log(entry);
+        }
+        catch {
+            // Сбой журнала — не ошибка запроса
+        }
+    };
+    return async (config, next) => {
+        const started = Date.now();
+        try {
+            const data = await next(config);
+            const error = errorText(data);
+            write({ method: config.method, url: config.url, duration: Date.now() - started, failed: false, ...(error ? { error } : {}) });
+            return data;
+        }
+        catch (cause) {
+            const response = httpErrorResponse(cause);
+            const error = errorText(response?.data, cause);
+            write({
+                method: config.method,
+                url: config.url,
+                duration: Date.now() - started,
+                failed: true,
+                ...(response ? { status: response.status } : {}),
+                ...(error ? { error } : {}),
+            });
+            throw cause;
+        }
+    };
+}
+/** Отменяет запрос, если он не завершился за `ms` миллисекунд. */
+function timeout(ms) {
+    return (config, next) => {
+        const controller = new AbortController();
+        const onAbort = () => controller.abort(abortReason(config.signal));
+        if (config.signal?.aborted) {
+            onAbort();
+        }
+        else {
+            config.signal?.addEventListener('abort', onAbort, { once: true });
+        }
+        let timer;
+        const timedOut = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                const error = new BXRestTimeoutError(ms);
+                controller.abort(error);
+                reject(error);
+            }, ms);
+        });
+        return Promise.race([next({ ...config, signal: controller.signal }), timedOut]).finally(() => {
+            clearTimeout(timer);
+            config.signal?.removeEventListener('abort', onAbort);
+        });
+    };
+}
+
+/**
+ * Ответ не 2xx при `transport: 'fetch'`. Поле `response` такое же, как у
+ * `AxiosError`: по нему библиотека узнаёт ошибки Bitrix и ошибки авторизации.
+ * В `.resVanilla()` приходит сама эта ошибка, в `.res()` — в `cause`.
+ */
+class BXRestHttpError extends Error {
+    constructor(response) {
+        super(`Request failed with status code ${response.status}`);
+        this.response = response;
+        this.name = 'BXRestHttpError';
+    }
+}
+/**
+ * Транспорт `transport: 'fetch'`: глобальный `fetch` браузера или Node 18+.
+ * Тело ответа разбирается как JSON, а если это не JSON (например, HTML от
+ * прокси) — отдаётся строкой, как это делает axios.
+ */
+async function fetchSend(config) {
+    let body;
+    if (config.method === 'POST') {
+        body = (typeof config.data === 'string') ? config.data : JSON.stringify(config.data ?? {});
+    }
+    const response = await fetch(config.url, {
+        method: config.method,
+        headers: config.headers,
+        body,
+        credentials: config.withCredentials ? 'include' : 'same-origin',
+        signal: config.signal,
+    });
+    const text = await response.text();
+    let data = text;
+    if (text) {
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            // Не JSON — отдаём текстом
+        }
+    }
+    if (!response.ok) {
+        throw new BXRestHttpError({ status: response.status, data });
+    }
+    return data;
+}
+
 class HttpBXServices extends HttpServices {
     /**
      * Не считайте этот метод образцом/финальным API.
@@ -1171,8 +1382,8 @@ class HttpBXServices extends HttpServices {
     get(name, params = {}, headers) {
         return this.httpGet(this.getNameMethod(name), params, undefined, headers);
     }
-    // settings — только для совместимости сигнатуры с HttpServices: здесь тело
-    // уходит JSON-ом/urlencoded, и пересчёт дат из iHttpParamSettings не нужен.
+    // settings не используется и оставлен ради прежней сигнатуры: headers
+    // остаётся четвёртым параметром у httpPost и httpGet.
     httpPost(url, params = {}, settings, headers) {
         // defer() откладывает всё содержимое (в том числе чтение BXRestSettings
         // через this.session.*) до реальной подписки — иначе даже с "живым"
@@ -1203,20 +1414,19 @@ class HttpBXServices extends HttpServices {
                     return throwError(() => this.session.getBaseUrlError('post'));
                 }
                 const fullUrl = prepareBaseAddress(baseUrl) + url;
-                if (key === 'sessid') {
-                    // Преобразуем параметры в формат x-www-form-urlencoded
-                    const bodyString = this.serializeBitrixParams(paramsClone);
-                    return from(this.axiosInstance.post(fullUrl, bodyString, {
-                        withCredentials: this.session.getWithCredentials(),
-                        headers: this.buildHeaders(headers, { 'Content-Type': 'application/x-www-form-urlencoded' }),
-                    }).then((response) => response.data));
-                }
-                return from(this.axiosInstance.post(fullUrl, paramsClone, {
+                // sessid — тело x-www-form-urlencoded, остальные ключи — JSON
+                const urlencoded = key === 'sessid';
+                return this.send({
+                    method: 'POST',
+                    url: fullUrl,
+                    data: urlencoded ? this.serializeBitrixParams(paramsClone) : paramsClone,
                     withCredentials: this.session.getWithCredentials(),
-                    headers: this.buildHeaders(headers, { 'Content-Type': 'application/json' }),
-                }).then((response) => response.data));
+                    headers: this.buildHeaders(headers, {
+                        'Content-Type': urlencoded ? 'application/x-www-form-urlencoded' : 'application/json'
+                    }),
+                });
             }));
-        }));
+        }), this.session.ctx);
     }
     httpGet(url, params = {}, settings, headers) {
         // Та же причина, что и у httpPost выше: откладываем чтение BXRestSettings
@@ -1244,12 +1454,43 @@ class HttpBXServices extends HttpServices {
                 const fullUrl = prepareBaseAddress(baseUrl) + url;
                 const queryString = this.serializeBitrixParams(paramsClone);
                 const finalUrl = `${fullUrl}?${queryString}`;
-                return from(this.axiosInstance.get(finalUrl, {
+                return this.send({
+                    method: 'GET',
+                    url: finalUrl,
                     withCredentials: this.session.getWithCredentials(),
                     headers: this.buildHeaders(headers),
-                }).then((response) => response.data));
+                });
             }));
-        }));
+        }), this.session.ctx);
+    }
+    /**
+     * Отправка через шаги из настроек: `retryOnQueryLimit`, `throttle`,
+     * `timeout`, `logRequests`, затем `middleware`; последним идёт транспорт
+     * клиента — axios или `fetch` (`transport`). Настройки читаются при
+     * подписке. Отписка отменяет HTTP-запрос (AbortSignal). Ошибка транспорта
+     * уходит дальше как есть: у axios в ней весь запрос, вместе с токеном и
+     * секретом вебхука (см. README, «Обработка ошибок»).
+     */
+    send(config) {
+        return new Observable(subscriber => {
+            const controller = new AbortController();
+            const ctx = this.session.ctx;
+            const settings = ctx.settings;
+            const send = composeMiddleware([...builtInMiddleware(settings, ctx), ...this.session.getMiddleware()], (settings.transport === 'fetch') ? fetchSend : request => this.axiosSend(request));
+            send({ ...config, signal: controller.signal }).then(data => {
+                subscriber.next(data);
+                subscriber.complete();
+            }, (error) => subscriber.error(error));
+            return () => controller.abort();
+        });
+    }
+    /** Транспорт по умолчанию: axios клиента, как и раньше через post()/get(). */
+    axiosSend(config) {
+        const options = { headers: config.headers, withCredentials: config.withCredentials, signal: config.signal };
+        const request = (config.method === 'GET')
+            ? this.axiosInstance.get(config.url, options)
+            : this.axiosInstance.post(config.url, config.data, options);
+        return request.then(response => response.data);
     }
     /**
      * Заголовки запроса: `BXRestSettings.headers`, поверх них — заголовки
@@ -1503,25 +1744,49 @@ class NavvyPagNavResultKeyObject extends NavvyPagBase {
     }
 }
 
-class NavvySupport {
-    constructor(requestClass) {
-        this.requestClass = requestClass;
-        this.pageSize = 50; // стандартный размер страницы
+/**
+ * Пагинация для методов, у которых `result` — объект, а список лежит в нём под ключом:
+ * `{ products: [...] }`, `{ orders: [...] }`.
+ *
+ * В отличие от {@link NavvyPagNavResultKey}, `.res()` отдаёт объект как есть, а `.resAll()` —
+ * такой же объект, где под ключом собраны записи всех страниц. Так `.resAll()` можно добавить
+ * методу, который раньше создавался через `simple`, не меняя результат его `.res()`.
+ */
+class NavvyPagNavKeyed extends NavvyPagBase {
+    constructor(url, param, key, map, restApi) {
+        super(url, param, map, restApi);
+        this.key = key;
     }
-    mapAndError(request) {
-        return request.pipe(map(v => BXRestMapResult(v)), catchError((err) => {
-            console.error(err);
-            throw new Error((err.error) ? err.error : err);
-        }));
+    resAll() {
+        return this.resFirstPage().pipe(mergeMap(first => this.resPages(offsetPageParams(this.param, first.total, this.pageSize)).pipe(map(pages => {
+            const items = [first.result, ...pages].flatMap(page => this.listIn(page));
+            const joined = { ...first.result, [this.key]: items };
+            return (this.map ? this.map(joined) : joined);
+        }))), 
+        // refCount: без подписчиков оставшиеся страницы запрашивать незачем
+        shareReplay({ bufferSize: 1, refCount: true }));
+    }
+    listIn(page) {
+        const list = page?.[this.key];
+        return Array.isArray(list) ? list : [];
     }
 }
 
 class Navvy {
+    /**
+     * @param settings свои настройки, как у `new BXRestNavvy(settings)`: запросы
+     *   идут на этот портал с этим токеном, а `BXRestSettings` на них не влияют.
+     *   Без них — настройки клиента, внутри которого создан объект, или
+     *   глобальные `BXRestSettings`.
+     */
+    constructor(settings) {
+        this.ctx = settings ? new BXRestContext(settings) : currentContext();
+    }
     simple(url, arg, map) {
-        return new NavvySimple(url, arg !== undefined ? arg : undefined, map);
+        return runInContext(this.ctx, () => new NavvySimple(url, arg !== undefined ? arg : undefined, map));
     }
     simpleV3(url, arg, map) {
-        return new NavvySimple(url, arg !== undefined ? arg : undefined, map, true);
+        return runInContext(this.ctx, () => new NavvySimple(url, arg !== undefined ? arg : undefined, map, true));
     }
     /**
      * Новый, пока тестируемый метод для api методов с пагинацией
@@ -1532,41 +1797,30 @@ class Navvy {
      * @constructor
      */
     pagNav(url, arg, map) {
-        return new NavvyPag(url, arg, map);
-    }
-    // old PagNav
-    // PagNav<T, R, A extends iBXRestPagination>(
-    //   func: (param: A) => Observable<iBXRestAnswer<T[]> | undefined>,
-    //   arg: A,
-    //   map: ((param: T[] | undefined) => R[] | undefined) | undefined) {
-    //   return new NavvyPagNav(this.requestClass, this.mapClass, func, arg, map)
-    // }
-    // Batch<T, R, A extends iBXRestPagination>(
-    //   func: (param: A) => Observable<iBXRestAnswer<T[]> | undefined>,
-    //   arg: A,
-    //   map: ((param: T[] | undefined) => R[] | undefined) | undefined) {
-    //   return new NavvyBatch(this.requestClass, this.mapClass, func, arg, map)
-    // }
-    pagNavTasks(url, 
-    // func: (param: A) => Observable<iBXRestAnswer<{tasks: T[] | undefined}> | undefined>,
-    arg, map) {
-        return new NavvyPagNavTasks(url, arg, map);
+        return runInContext(this.ctx, () => new NavvyPag(url, arg, map));
+    }
+    pagNavTasks(url, arg, map) {
+        return runInContext(this.ctx, () => new NavvyPagNavTasks(url, arg, map));
     }
     pagNavResultKey(url, arg, key, map) {
-        return new NavvyPagNavResultKey(url, arg, key, map);
+        return runInContext(this.ctx, () => new NavvyPagNavResultKey(url, arg, key, map));
     }
     pagNavResultKeyObject(url, arg, key, map) {
-        return new NavvyPagNavResultKeyObject(url, arg, key, map);
+        return runInContext(this.ctx, () => new NavvyPagNavResultKeyObject(url, arg, key, map));
     }
-    pagNavWithUselessKey(url, 
-    // func: (param: A) => Observable<iBXRestAnswer<{ [key: string]: T }> | undefined>,
-    arg, map) {
-        return new NavvyPagNavWithUselessKey(url, arg, map);
+    /**
+     * Для методов, у которых `result` — объект со списком под ключом `key`, например
+     * `{ products: [...] }`. `.res()` отдаёт объект как есть, `.resAll()` — такой же объект
+     * с записями всех страниц под ключом.
+     */
+    pagNavKeyed(url, arg, key, map) {
+        return runInContext(this.ctx, () => new NavvyPagNavKeyed(url, arg, key, map));
+    }
+    pagNavWithUselessKey(url, arg, map) {
+        return runInContext(this.ctx, () => new NavvyPagNavWithUselessKey(url, arg, map));
     }
-    alterPagNav(url, 
-    // func: (param: A) => Observable<iBXRestAnswer<T[]> | undefined>,
-    arg, map) {
-        return new NavvyAlterPagNav(url, arg, map);
+    alterPagNav(url, arg, map) {
+        return runInContext(this.ctx, () => new NavvyAlterPagNav(url, arg, map));
     }
 }
 
@@ -1677,6 +1931,7 @@ const $pull = 'pull';
 const $channel = 'channel';
 const $public = 'public';
 const $application = 'application';
+const $push = 'push';
 const $dialog = 'dialog';
 const $users = 'users';
 const $messages = 'messages';
@@ -2478,6 +2733,7 @@ var partNameMethods$1 = /*#__PURE__*/Object.freeze({
     $publication: $publication,
     $publicationFolder: $publicationFolder,
     $pull: $pull,
+    $push: $push,
     $quick: $quick,
     $quote: $quote,
     $ratio: $ratio,
@@ -3600,12 +3856,6 @@ class BXRestNavvyTasksTask {
              * Переводит задачу в статус «завершена»
              */
             complete: [$tasks, $task, $complete],
-            // counters: {
-            //   /**
-            //    * Получает счетчики пользователя
-            //    */
-            //   get: [$tasks, $task, $counters, $get],
-            // },
             /**
              * Переводит задачу в статус «отложена»
              */
@@ -3618,30 +3868,6 @@ class BXRestNavvyTasksTask {
              * Возвращает информацию о конкретной задаче
              */
             get: [$tasks, $task, $get],
-            // /**
-            //  * Удаляет задачу
-            //  */
-            // delete: [$tasks, $task, $delete],
-            // /**
-            //  * Позволяет отклонить задачу
-            //  */
-            // disapprove: [$tasks, $task, $disapprove],
-            // favorite: {
-            //   /**
-            //    * Добавляет задачи в "Избранное"
-            //    */
-            //   add: [$tasks, $task, $favorite, $add],
-            //   /**
-            //    * Удаляет задачи из "Избранного"
-            //    */
-            //   delete: [$tasks, $task, $favorite, $delete],
-            // },
-            // files: {
-            //   /**
-            //    * Прикрепляет загруженный на диск файл к задаче
-            //    */
-            //   attach: [$tasks, $task, $files, $attach],
-            // },
             /**
              * Возвращает все доступные поля
              */
@@ -3650,36 +3876,10 @@ class BXRestNavvyTasksTask {
              * Метод для проверки доступа к задаче
              */
             getAccess: [$tasks, $task, $getaccess],
-            // history: {
-            //   /**
-            //    * Получает историю задачи
-            //    */
-            //   list: [$tasks, $task, $history, $list],
-            // },
             /**
              * Возвращает массив задач, каждая из которых содержит массив полей
              */
             list: [$tasks, $task, $list],
-            // /**
-            //  * Останавливает выполнение задачи, переводя ее в статус "ждет выполнения"
-            //  */
-            // pause: [$tasks, $task, $pause],
-            // /**
-            //  * Возобновляет задачу после ее завершения
-            //  */
-            // renew: [$tasks, $task, $renew],
-            // /**
-            //  * Переводит задачу в статус «выполняется»
-            //  */
-            // start: [$tasks, $task, $start],
-            // /**
-            //  * Позволяет наблюдать за задачей
-            //  */
-            // startWatch: [$tasks, $task, 'startwatch'],
-            // /**
-            //  * Останавливает наблюдение за задачей
-            //  */
-            // stopwatch: [$tasks, $task, 'stopwatch'],
             /**
              * Обновляет задачу
              */
@@ -3784,68 +3984,6 @@ class BXRestNavvyTasksTask {
     list(param = {}) {
         return this.Navvy.pagNavTasks(this.url.list, param, (BXRestMapTasksTask.list));
     }
-    /*
-    listArray(requestArray: RequestApiTaskListBX = {}) {
-      return this.list(requestArray).pipe(
-        map(v => this.http.mapResult(v)),
-        map(v => (v && v.tasks) ? v.tasks : [])
-      )
-    }
-  
-    listAll(requestArray: RequestApiTaskListBX = {}, cache = false): Observable<TaskBX[]> {
-      if (!requestArray.select) {
-        requestArray.select = this.def.select
-        if (cache) {
-          return this.storeTask$.pipe(
-            take(1),
-            mergeMap(tasks => {
-              if (tasks && tasks.data.http.list && requestArray.filter && requestArray.filter.ID) {
-                const ids = (typeof requestArray.filter.ID === 'number') ? [requestArray.filter.ID] : requestArray.filter.ID
-                let filter = tasks.data.http.list.filter(i => (i.id) ? ids.includes(i.id) : false)
-                if (filter.length === ids.length) {
-                  return of(filter)
-                }
-              }
-              return this.getEndListArray(requestArray)
-            })
-          )
-        }
-        return this.getEndListArray(requestArray)
-      }
-      return this.getEndListArray(requestArray)
-    }
-  
-    getEndListArray(requestArray: RequestApiTaskListBX): Observable<TaskBX[]> {
-      return this.list(requestArray).pipe(
-        mergeMap((items: AnswerApiTaskBX | undefined): ObservableInput<any> | Observable<AnswerApiTaskBX[]> => {
-          if (items && items.result && typeof items.result.tasks === 'object') {
-            const items$ = of(items.result.tasks)
-            if (items.next) {
-              this.nowLoad$.next({
-                total: (items.total) ? items.total : 0,
-                next: items.next
-              })
-              requestArray.start = items.next
-              return this.getEndListArray(requestArray).pipe(
-                map(vEnd => {
-                  if (vEnd && items.result.tasks) {
-                    return [...items.result.tasks, ...vEnd]
-                  }
-                  return (items.result.tasks) ? items.result.tasks : []
-                }))
-            }
-            this.nowLoad$.next({
-              total: 0,
-              next: 0
-            })
-            return items$
-          } else {
-            return of([])
-          }
-        })
-      )
-    }
-    */
     /**
      * Возвращает список полей задачи.
      */
@@ -4143,6 +4281,18 @@ class BXRestNavvyDelegateElapsedItem {
     }
 }
 
+/** Результаты и `total` команд из ответов batch по ключам команд. Команды с ошибкой пропускаются. */
+function batchValues(answers) {
+    const values = { result: {}, total: {} };
+    for (const answer of answers ?? []) {
+        if (instanceOfiBXRestAnswerSuccess(answer) && answer.result && typeof answer.result === 'object') {
+            const batch = answer.result;
+            Object.assign(values.result, batch.result);
+            Object.assign(values.total, batch.result_total);
+        }
+    }
+    return values;
+}
 class BXRestNavvyOperationElapsedItem {
     constructor(BXRestNavvyElapsedItem) {
         this.BXRestNavvyElapsedItem = BXRestNavvyElapsedItem;
@@ -4171,35 +4321,45 @@ class BXRestNavvyOperationElapsedItem {
         };
         return this.delegate.getList(param);
     }
-    // TODO: Сделать нормально
     /**
-     * Возвращает список записей о затраченном времени по задаче.
+     * Возвращает все записи о затраченном времени по задачам `ids`: сначала записи первой задачи,
+     * затем второй и так далее.
+     *
+     * Портал отдаёт не больше 50 записей на страницу. Первые страницы всех задач уходят одним
+     * batch, остальные страницы запрашиваются только у задач, где записей больше 50.
      */
     getListByIDTask(ids) {
         // Пустой batch завершается без значения, и вызывающий код получил бы EmptyError
         if (!ids.length) {
             return of([]);
         }
-        // Работает только потому что "nPageSize: 99999"
-        return this.http.branch(ids.map(i => {
-            return {
+        const pageSize = 50;
+        const key = (index, page) => `${index}_${page}`;
+        const commands = (pages) => Object.fromEntries(pages.map(({ index, page }) => [
+            key(index, page),
+            {
                 name: this.http.getNameMethod([$task, $elapseditem, $getlist]),
-                param: {
-                    TASKID: i,
-                    PARAMS: {
-                        NAV_PARAMS: {
-                            nPageSize: 99999,
-                            iNumPage: 1
-                        }
-                    }
-                }
-            };
-        })).pipe(map(v => {
-            if (v && v.length) {
-                const res = this.http.mapBranchResultWithoutKey(v);
-                return BXRestMapTaskElapsedItem.getList(res);
+                param: { TASKID: ids[index], PARAMS: { NAV_PARAMS: { nPageSize: pageSize, iNumPage: page } } }
             }
-            return undefined;
+        ]));
+        const load = (pages) => pages.length
+            ? this.http.branch(commands(pages)).pipe(map(v => batchValues(v)))
+            : of({ result: {}, total: {} });
+        return load(ids.map((_, index) => ({ index, page: 1 }))).pipe(mergeMap(first => {
+            const rest = ids.flatMap((_, index) => {
+                const pages = Math.ceil((Number(first.total[key(index, 1)]) || 0) / pageSize);
+                return Array.from({ length: Math.max(pages - 1, 0) }, (_, i) => ({ index, page: i + 2 }));
+            });
+            return load(rest).pipe(map(more => ({ ...first.result, ...more.result })));
+        }), map(result => {
+            const items = ids.flatMap((_, index) => {
+                const list = [];
+                for (let page = 1; result[key(index, page)]; page++) {
+                    list.push(...result[key(index, page)]);
+                }
+                return list;
+            });
+            return BXRestMapTaskElapsedItem.getList(items);
         }));
     }
     /**
@@ -4327,12 +4487,12 @@ class BXRestNavvyOperationElapsedItem {
                         return this.BXRestNavvyElapsedItem.add(param).res();
                     }
                     else {
-                        return throwError(() => new Error('Отсутствуют права на добавление записи затраченного времени'));
+                        return throwError(() => new Error('No permission to add an elapsed time record to the task'));
                     }
                 }));
             }
             else {
-                return throwError(() => new Error('Отсутствуют права на чтение задачи'));
+                return throwError(() => new Error('No permission to read the task'));
             }
         }));
     }
@@ -4349,10 +4509,10 @@ class BXRestNavvyOperationElapsedItem {
                     if (allowed) {
                         return this.BXRestNavvyElapsedItem.update(param).res();
                     }
-                    return throwError(() => new Error('Отсутствуют права на изменение записи затраченного времени'));
+                    return throwError(() => new Error('No permission to update the elapsed time record'));
                 }));
             }
-            return throwError(() => new Error('Отсутствуют права на чтение задачи'));
+            return throwError(() => new Error('No permission to read the task'));
         }));
     }
     /**
@@ -4380,7 +4540,7 @@ class BXRestNavvyOperationElapsedItem {
             if (canRead) {
                 return this.BXRestNavvyElapsedItem.isActionAllowed(param).res();
             }
-            return throwError(() => new Error('Отсутствуют права на чтение задачи'));
+            return throwError(() => new Error('No permission to read the task'));
         }));
     }
     /**
@@ -4396,12 +4556,12 @@ class BXRestNavvyOperationElapsedItem {
                         return this.BXRestNavvyElapsedItem.delete(param).res();
                     }
                     else {
-                        return throwError(() => new Error('Отсутствуют права на удаление записи затраченного времени'));
+                        return throwError(() => new Error('No permission to delete the elapsed time record'));
                     }
                 }));
             }
             else {
-                return throwError(() => new Error('Отсутствуют права на чтение задачи'));
+                return throwError(() => new Error('No permission to read the task'));
             }
         }));
     }
@@ -5414,7 +5574,7 @@ class BXRestNavvyDiskOperation {
                     generateUniqueName: true
                 }).res();
             }
-            return throwError(() => new Error('Отсутствует общее хранилище для приложения'));
+            return throwError(() => new Error('Could not get the app storage'));
         }));
     }
     /**
@@ -5432,13 +5592,6 @@ class BXRestNavvyDiskOperation {
      * Возвращает список папок и файлов в общем хранилище приложения.
      */
     getRootFoldersApp() {
-        // return this.BXDiskFolder$.pipe(
-        //   take(1),
-        //   mergeMap(
-        //     saveData => {
-        //       if (saveData.content.root.app) {
-        //         return of(saveData.content.root.app)
-        //       }
         return this.storage.getForApp().res().pipe(mergeMap$1(v => {
             if (v && v.ID) {
                 return this.storage.getChildren({ id: v.ID }).res();
@@ -5464,7 +5617,7 @@ class BXRestNavvyDiskOperation {
                 if (v && v.ID) {
                     return this.storage.addFolder({ id: v.ID, data: { NAME: folderName } }).res();
                 }
-                return throwError(() => new Error('Отсутствуют права добавление записи затраченного времени'));
+                return throwError(() => new Error('Could not get the app storage'));
             }));
         }));
     }
@@ -5835,6 +5988,32 @@ class BXRestNavvyBizProcRobot {
     }
 }
 
+/**
+ * Символьный код нового элемента списка: `bx_rest_` и 128 случайных бит в hex.
+ * Только латиница, цифры и `_`: допустимые символы документация Bitrix24 не
+ * описывает.
+ *
+ * Случайные байты дают `crypto.getRandomValues` (в отличие от
+ * `crypto.randomUUID`, он есть и на страницах по http). Глобального `crypto`
+ * нет только в Node 18: там байты берутся из `Math.random`. Это не
+ * криптостойко, но код нужен лишь уникальный, а совпадение с уже занятым кодом
+ * ловит повтор в вызывающем методе.
+ */
+function uniqueElementCode() {
+    const bytes = new Uint8Array(16);
+    if (typeof globalThis.crypto?.getRandomValues === 'function') {
+        globalThis.crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    return 'bx_rest_' + Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
+}
+
+/** Сколько раз пробуем новый `ELEMENT_CODE`, если такой код в списке уже занят. */
+const ELEMENT_CODE_ATTEMPTS = 3;
 /** Бизнес-процессы, задания, действия и роботы (`bizproc.*`). */
 class BXRestNavvyBizProc {
     constructor() {
@@ -5867,18 +6046,23 @@ class BXRestNavvyBizProc {
         if (value === null || value === undefined || (typeof value === 'string' && value.trim() === '')) {
             parametersElement['DATE_CREATE'] = new Date();
         }
-        return this.BXRestNavvyLists.element.add({
+        // ELEMENT_CODE обязателен и должен быть уникальным в списке. Занятые коды
+        // знает только портал, поэтому на совпадение создаём новый код и повторяем.
+        // throwOnApiError: иначе ошибка в ответе 2xx пришла бы как undefined.
+        const addElement = (attempt) => this.BXRestNavvyLists.element.add({
             IBLOCK_TYPE_ID: 'bitrix_processes',
             IBLOCK_ID: id,
-            ELEMENT_CODE: 'trace_studio_' + Date.now() + '_' + Math.random(),
-            // тут должно быть уникально значение (генерация уникальных значений на фронте лол),
-            // как ещё уникальнее сделать я просто не знаю
-            // это поле обязательно без него не работает
+            ELEMENT_CODE: uniqueElementCode(),
             FIELDS: {
                 NAME: String(parametersElement['NAME']),
                 ...parametersElement
             }
-        }).res().pipe(mergeMap(v => {
+        }).res({ throwOnApiError: true }).pipe(catchError$1((error) => (attempt < ELEMENT_CODE_ATTEMPTS
+            && error instanceof BXRestApiError
+            && error.error === 'ERROR_ELEMENT_ALREADY_EXISTS')
+            ? addElement(attempt + 1)
+            : throwError(() => error)));
+        return addElement(1).pipe(mergeMap(v => {
             if (v) {
                 if (Object.keys(parametersBizProc).length && templateIDs.length) {
                     let request = [];
@@ -5895,7 +6079,7 @@ class BXRestNavvyBizProc {
                     return of(true);
                 }
             }
-            return throwError(() => new Error('Не удалось запустить бизнес процесс'));
+            return throwError(() => new Error('Could not start the business process: the list element was not created'));
         }));
     }
 }
@@ -6165,14 +6349,6 @@ class BXRestNavvyRestCalendarEvent {
             update: [$calendar, $event, $update],
         };
         this.Navvy = new Navvy();
-        // /** Возвращает список событий календаря, всегда весь список, паганации в методе нет да и не нужна */
-        // get(param: iBXRestCalendarEventGetParam) {
-        //   return this.Navvy.simple(
-        //     this.url.get,
-        //     param,
-        //     BXRestMapCalendarEvent.get
-        //   )
-        // }
         this.get = Object.assign(
         /**
          * Возвращает список событий календаря, всегда весь список, паганации в методе нет да и не нужна.
@@ -8070,12 +8246,8 @@ class BXRestNavvySocialNetWorkApiLiveFeedBlogPost {
     }
 }
 
-// import { Navvy } from '../../../services/navvy'
-// import { BXRestSocialNetWorkApiLiveFeed } from '../../../request/socialnetwork/api/livefeed'
 class BXRestNavvySocialNetWorkApiLiveFeed {
     constructor() {
-        // private readonly contentView = new BXRestSocialNetWorkApiLiveFeed)
-        // private readonly Navvy = new Navvy(this.contentView, null)
         /**
          * Сообщения Ленты новостей в социальной сети (`socialnetwork.api.liveFeed.blogPost.*`).
          */
@@ -8119,53 +8291,44 @@ class BXRestNavvySocialNetWork {
     }
 }
 
+/** Поля `start` и `end` канала — в `Date`. Канал, которого нет в ответе, так и остаётся пустым. */
+function withDates(channel) {
+    return channel
+        ? { ...channel, start: toDate(channel.start), end: toDate(channel.end) }
+        : undefined;
+}
 class BXRestMapPullApplicationConfig {
+    /**
+     * Даты каналов — в `Date`. `publicChannels: false` (сервер версии ниже 4) становится пустым объектом.
+     */
     static get(value) {
-        return value ?
-            {
-                ...value,
-                ...{
-                    channels: {
-                        shared: {
-                            ...value.channels.shared, ...{
-                                start: toDate(value.channels.shared.start),
-                                end: toDate(value.channels.shared.end),
-                            }
-                        },
-                        private: {
-                            ...value.channels.private, ...{
-                                start: toDate(value.channels.private.start),
-                                end: toDate(value.channels.private.end),
-                            }
-                        }
-                    },
-                    publicChannels: Object.fromEntries(Object.entries(value.publicChannels).map(([key, val]) => ([key,
-                        {
-                            ...val,
-                            start: toDate(val.start),
-                            end: toDate(val.end)
-                        }
-                    ]))),
-                }
-            }
-            : undefined;
+        if (!value) {
+            return undefined;
+        }
+        const publicChannels = value.publicChannels && typeof value.publicChannels === 'object'
+            ? value.publicChannels
+            : {};
+        return {
+            ...value,
+            channels: {
+                ...value.channels,
+                shared: withDates(value.channels?.shared),
+                private: withDates(value.channels?.private),
+            },
+            publicChannels: Object.fromEntries(Object.entries(publicChannels).map(([key, channel]) => [key, withDates(channel)])),
+        };
     }
 }
 
 class BXRestMapPull {
     static get(value) {
-        // console.log('Object.entries(value.publicChannels)', value)
-        //if(value?.publicChannels) {
-        // console.log('Object.entries(value.publicChannels)',
-        //   value.publicChannels, Object.entries(value.publicChannels), Object.fromEntries(Object.entries(value.publicChannels).map(([key, val]) => (
-        //   [key,
-        //     {
-        //       ...val,
-        //       start: toDate(val.start), end: toDate(val.end)
-        //     } as iBXRestPullConfigPublicChannelsGet
-        //   ]))) as Record<string, iBXRestPullConfigPublicChannelsGet>,)
-        //}
-        return value ? { ...BXRestMapPullApplicationConfig.get(value), ...{ serverTime: toDate(value.serverTime) } } : undefined;
+        if (!value) {
+            return undefined;
+        }
+        return {
+            ...BXRestMapPullApplicationConfig.get(value),
+            ...(value.serverTime ? { serverTime: toDate(value.serverTime) } : {}),
+        };
     }
 }
 
@@ -8180,11 +8343,15 @@ class BXRestNavvyPullConfig {
         this.Navvy = new Navvy();
     }
     /**
+     * Возвращает настройки подключения к серверам Push & Pull для пользователя.
+     * Приложению нужен `pull.application.config.get`: `bx.pull.application.config.get()`.
+     *
      * @experimental
-     * Этот метод находится в процессе тестирования и может измениться.
+     * Метода нет в документации Bitrix24, ответ сверен только с официальным JS SDK.
+     * Типы могут измениться.
      */
-    get() {
-        return this.Navvy.simple(this.url.get, undefined, BXRestMapPull.get);
+    get(param) {
+        return this.Navvy.simple(this.url.get, param, BXRestMapPull.get);
     }
 }
 
@@ -8202,7 +8369,7 @@ class BXRestMapPullChannelPublic {
 class BXRestNavvyPullChannelPublic {
     constructor() {
         this.url = {
-            get: [$log, $blogpost, $add]
+            get: [$pull, $channel, $public, $get]
         };
         this.Navvy = new Navvy();
     }
@@ -8210,7 +8377,7 @@ class BXRestNavvyPullChannelPublic {
      * Возвращает публичный канал Push & Pull (public_id и подпись) с ограниченным сроком действия для приёма событий без авторизации пользователя.
      */
     get() {
-        return this.Navvy.simple([$pull, $channel, $public, $get], undefined, BXRestMapPullChannelPublic.get);
+        return this.Navvy.simple(this.url.get, undefined, BXRestMapPullChannelPublic.get);
     }
 }
 
@@ -8219,13 +8386,65 @@ class BXRestNavvyPullApplicationConfig {
         this.Navvy = new Navvy();
     }
     /**
-     * Возвращает конфигурацию подключения приложения к серверам Push & Pull.
+     * Возвращает настройки подключения приложения к серверам Push & Pull: адреса сервера и каналы.
+     * Настройки личные: канал `private` принадлежит пользователю, с чьим токеном идёт запрос.
+     * Запрашивайте их заново, когда истекут `exp` или `end` каналов.
+     *
+     * Работает только в контексте приложения: через вебхук портал ответит `WRONG_AUTH_TYPE`.
+     *
+     * @see https://apidocs.bitrix24.com/settings/interactivity/pull-application-config-get.html
      */
-    get() {
-        return this.Navvy.simple([$pull, $application, $config, $get], undefined, BXRestMapPullApplicationConfig.get);
+    get(param) {
+        return this.Navvy.simple([$pull, $application, $config, $get], param, BXRestMapPullApplicationConfig.get);
     }
 }
 
+class BXRestNavvyPullApplicationEvent {
+    constructor() {
+        this.url = {
+            add: [$pull, $application, $event, $add]
+        };
+        this.Navvy = new Navvy();
+    }
+    /**
+     * Отправляет событие в канал приложения: в общий `shared` или, с `USER_ID`, в личные каналы
+     * пользователей. Событие получает клиент Push & Pull, подписанный на эти `MODULE_ID` и `COMMAND`.
+     *
+     * Работает только в контексте приложения: через вебхук портал ответит `WRONG_AUTH_TYPE`.
+     * `true` в ответе значит, что событие принято к отправке, а не что оно дошло до клиента.
+     *
+     * @see https://apidocs.bitrix24.com/settings/interactivity/pull-application-event-add.html
+     */
+    add(param) {
+        return this.Navvy.simple(this.url.add, param);
+    }
+}
+
+class BXRestNavvyPullApplicationPush {
+    constructor() {
+        this.url = {
+            add: [$pull, $application, $push, $add]
+        };
+        this.Navvy = new Navvy();
+    }
+    /**
+     * Отправляет push-уведомление пользователям в мобильное приложение Bitrix24 от имени приложения.
+     * У приложения должно быть заполнено название на текущем языке, иначе портал ответит `EMPTY_APP_NAME`.
+     *
+     * Работает только в контексте приложения и только у администратора портала.
+     * `true` в ответе значит, что уведомление принято к отправке, а не что оно дошло.
+     *
+     * @see https://apidocs.bitrix24.com/settings/interactivity/pull-application-push-add.html
+     */
+    add(param) {
+        return this.Navvy.simple(this.url.add, param);
+    }
+}
+
+/**
+ * Push & Pull: настройки подключения к серверу и отправка событий приложения.
+ * Клиента веб-сокета в библиотеке нет, подключаться к серверу нужно своим клиентом.
+ */
 class BXRestNavvyPull {
     constructor() {
         /**
@@ -8236,7 +8455,12 @@ class BXRestNavvyPull {
             public: new BXRestNavvyPullChannelPublic()
         };
         this.application = {
+            /** Настройки подключения для приложения (`pull.application.config.*`). */
             config: new BXRestNavvyPullApplicationConfig(),
+            /** События в канал приложения (`pull.application.event.*`). */
+            event: new BXRestNavvyPullApplicationEvent(),
+            /** Push-уведомления в мобильное приложение (`pull.application.push.*`). */
+            push: new BXRestNavvyPullApplicationPush(),
         };
     }
 }
@@ -9033,7 +9257,7 @@ class BXRestNavvyCrmDealRecurring {
     /**
      * Возвращает список шаблонов регулярных сделок.
      */
-    list(param = {}) { return this.Navvy.simple([$crm, $deal, $recurring, $list], param); }
+    list(param = {}) { return this.Navvy.pagNav([$crm, $deal, $recurring, $list], param); }
     /**
      * Изменяет настройки шаблона регулярной сделки.
      */
@@ -10892,7 +11116,7 @@ class BXRestNavvyCrmRequisiteLink {
      * @see https://apidocs.bitrix24.ru/api-reference/crm/requisites/links/crm-requisite-link-list.html
      */
     list(param = {}) {
-        return this.Navvy.simple(this.url.list, param);
+        return this.Navvy.pagNav(this.url.list, param);
     }
     /**
      * Удаляет связь реквизитов с объектом, не удаляя сами реквизиты.
@@ -11240,7 +11464,7 @@ class BXRestNavvyCrmTimelineBindings {
      * @see https://apidocs.bitrix24.ru/api-reference/crm/timeline/bindings/crm-timeline-bindings-list.html
      */
     list(param) {
-        return this.Navvy.simple(this.url.list, param);
+        return this.Navvy.pagNav(this.url.list, param);
     }
     /**
      * Удаляет связь записи таймлайна с указанным элементом CRM.
@@ -11905,7 +12129,7 @@ class BXRestNavvyCrmItemProductRow {
      * Возвращает список товарных позиций.
      */
     list(param) {
-        return this.Navvy.simple([$crm, $item, $productrow, $list], param);
+        return this.Navvy.pagNavKeyed([$crm, $item, $productrow, $list], param, 'productRows');
     }
     /**
      * Сохраняет набор товарных позиций объекта CRM.
@@ -12381,7 +12605,7 @@ class BXRestNavvyCrmActivity {
      * Возвращает список дел всех типов по фильтру.
      */
     list(param = {}) {
-        return this.Navvy.simple([$crm, $activity, $list], param);
+        return this.Navvy.pagNav([$crm, $activity, $list], param);
     }
     /**
      * Обновляет дело.
@@ -12417,7 +12641,7 @@ class BXRestNavvyCrmOrderEntity {
      * Возвращает список привязок заказов к объектам CRM.
      */
     list(param = {}) {
-        return this.Navvy.simple([$crm, $orderentity, $list], param);
+        return this.Navvy.pagNavKeyed([$crm, $orderentity, $list], param, 'orderEntity');
     }
 }
 
@@ -12429,7 +12653,7 @@ class BXRestNavvyCrmStageHistory {
      * Возвращает историю движения элемента по стадиям.
      */
     list(param = {}) {
-        return this.Navvy.simple([$crm, $stagehistory, $list], param);
+        return this.Navvy.pagNavKeyed([$crm, $stagehistory, $list], param, 'items');
     }
 }
 
@@ -14273,7 +14497,7 @@ class BXRestNavvyDocumentGeneratorDocument {
      * Возвращает список документов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$documentgenerator, $document, $list], param);
+        return this.Navvy.pagNavKeyed([$documentgenerator, $document, $list], param, 'documents');
     }
     /**
      * Изменяет существующий документ.
@@ -14309,7 +14533,7 @@ class BXRestNavvyDocumentGeneratorNumerator {
      * Возвращает список нумераторов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$documentgenerator, $numerator, $list], param);
+        return this.Navvy.pagNavKeyed([$documentgenerator, $numerator, $list], param, 'numerators');
     }
     /**
      * Изменяет нумератор.
@@ -14387,7 +14611,7 @@ class BXRestNavvyDocumentGeneratorRole {
      * Возвращает список ролей без детального состава прав.
      */
     list(param = {}) {
-        return this.Navvy.simple([$documentgenerator, $role, $list], param);
+        return this.Navvy.pagNavKeyed([$documentgenerator, $role, $list], param, 'roles');
     }
     /**
      * Обновляет роль и возвращает актуальные данные.
@@ -14429,7 +14653,7 @@ class BXRestNavvyDocumentGeneratorTemplate {
      * Возвращает список шаблонов документов по фильтру.
      */
     list(param = {}) {
-        return this.Navvy.simple([$documentgenerator, $template, $list], param);
+        return this.Navvy.pagNavKeyed([$documentgenerator, $template, $list], param, 'templates');
     }
     /**
      * Обновляет существующий шаблон документа.
@@ -14966,7 +15190,7 @@ class BXRestNavvyBookingV1Resource {
      * Возвращает список ресурсов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$booking, $v1, $resource, $list], param);
+        return this.Navvy.pagNavKeyed([$booking, $v1, $resource, $list], param, 'resource');
     }
     /**
      * Обновляет ресурс.
@@ -15002,7 +15226,7 @@ class BXRestNavvyBookingV1ResourceType {
      * Возвращает список типов ресурсов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$booking, $v1, $resourcetype, $list], param);
+        return this.Navvy.pagNavKeyed([$booking, $v1, $resourcetype, $list], param, 'resourceType');
     }
     /**
      * Обновляет тип ресурса.
@@ -16383,7 +16607,7 @@ class BXRestNavvyCatalogCatalog {
      * Возвращает список торговых каталогов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $catalog, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $catalog, $list], param, 'catalogs');
     }
     /**
      * Обновляет параметры торгового каталога.
@@ -16419,7 +16643,7 @@ class BXRestNavvyCatalogDocumentElement {
      * Возвращает список товарных позиций документа складского учёта.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $document, $element, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $document, $element, $list], param, 'documentElements');
     }
     /**
      * Обновляет товарную позицию документа складского учёта.
@@ -16505,7 +16729,7 @@ class BXRestNavvyCatalogDocument {
      * Возвращает список документов складского учёта.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $document, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $document, $list], param, 'documents');
     }
     /**
      * Обновляет документ складского учёта.
@@ -16541,7 +16765,7 @@ class BXRestNavvyCatalogDocumentContractor {
      * Возвращает список поставщиков документов складского учёта.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $documentcontractor, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $documentcontractor, $list], param, 'documentContractor');
     }
 }
 
@@ -16585,7 +16809,7 @@ class BXRestNavvyCatalogExtra {
      * Возвращает список наценок.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $extra, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $extra, $list], param, 'extras');
     }
 }
 
@@ -16621,7 +16845,7 @@ class BXRestNavvyCatalogMeasure {
      * Возвращает список единиц измерения.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $measure, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $measure, $list], param, 'measures');
     }
     /**
      * Обновляет единицу измерения.
@@ -16663,7 +16887,7 @@ class BXRestNavvyCatalogPrice {
      * Возвращает список цен.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $price, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $price, $list], param, 'prices');
     }
     /**
      * Устанавливает или изменяет цену товара, создавая запись при её отсутствии.
@@ -16711,7 +16935,7 @@ class BXRestNavvyCatalogPriceType {
      * Возвращает список типов цен.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $priceType, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $priceType, $list], param, 'priceTypes');
     }
     /**
      * Обновляет тип цены.
@@ -16747,7 +16971,7 @@ class BXRestNavvyCatalogPriceTypeGroup {
      * Возвращает список привязок типов цен к группам покупателей.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $priceTypeGroup, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $priceTypeGroup, $list], param, 'priceTypeGroups');
     }
 }
 
@@ -16789,7 +17013,7 @@ class BXRestNavvyCatalogPriceTypeLang {
      * Возвращает список переводов названий типов цен.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $priceTypeLang, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $priceTypeLang, $list], param, 'priceTypeLangs');
     }
     /**
      * Обновляет перевод названия типа цены.
@@ -16839,7 +17063,7 @@ class BXRestNavvyCatalogProductOffer {
      * Возвращает список товаров-вариаций.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $product, $offer, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $product, $offer, $list], param, 'offers');
     }
     /**
      * Обновляет товар-вариацию.
@@ -16889,7 +17113,7 @@ class BXRestNavvyCatalogProductService {
      * Возвращает список услуг.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $product, $service, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $product, $service, $list], param, 'services');
     }
     /**
      * Обновляет услугу.
@@ -16939,7 +17163,7 @@ class BXRestNavvyCatalogProductSku {
      * Возвращает список товаров с вариациями.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $product, $sku, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $product, $sku, $list], param, 'units');
     }
     /**
      * Обновляет товар с вариациями.
@@ -16999,7 +17223,7 @@ class BXRestNavvyCatalogProduct {
      * Возвращает список товаров.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $product, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $product, $list], param, 'products');
     }
     /**
      * Обновляет товар.
@@ -17077,7 +17301,7 @@ class BXRestNavvyCatalogProductProperty {
      * Возвращает список свойств товаров.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $productProperty, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $productProperty, $list], param, 'productProperties');
     }
     /**
      * Обновляет свойство товара.
@@ -17119,7 +17343,7 @@ class BXRestNavvyCatalogProductPropertyEnum {
      * Возвращает список значений списочного свойства.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $productPropertyEnum, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $productPropertyEnum, $list], param, 'productPropertyEnums');
     }
     /**
      * Обновляет значение списочного свойства товара.
@@ -17163,7 +17387,7 @@ class BXRestNavvyCatalogProductPropertyFeature {
      * Возвращает список параметров свойств товаров.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $productPropertyFeature, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $productPropertyFeature, $list], param, 'productPropertyFeatures');
     }
     /**
      * Обновляет параметр свойства товара.
@@ -17187,7 +17411,7 @@ class BXRestNavvyCatalogProductPropertySection {
      * Возвращает список секционных настроек свойств.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $productPropertySection, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $productPropertySection, $list], param, 'productPropertySections');
     }
     /**
      * Устанавливает секционные настройки свойства.
@@ -17217,7 +17441,7 @@ class BXRestNavvyCatalogRatio {
      * Возвращает список коэффициентов единиц измерения.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $ratio, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $ratio, $list], param, 'ratios');
     }
 }
 
@@ -17253,7 +17477,7 @@ class BXRestNavvyCatalogRoundingRule {
      * Возвращает список правил округления цен.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $roundingRule, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $roundingRule, $list], param, 'roundingRules');
     }
     /**
      * Обновляет правило округления цен.
@@ -17295,7 +17519,7 @@ class BXRestNavvyCatalogSection {
      * Возвращает список разделов каталога.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $section, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $section, $list], param, 'sections');
     }
     /**
      * Обновляет раздел каталога.
@@ -17337,7 +17561,7 @@ class BXRestNavvyCatalogStore {
      * Возвращает список складов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $store, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $store, $list], param, 'stores');
     }
     /**
      * Обновляет склад.
@@ -17367,7 +17591,7 @@ class BXRestNavvyCatalogStoreProduct {
      * Возвращает список остатков товаров на складах.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $storeProduct, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $storeProduct, $list], param, 'storeProducts');
     }
 }
 
@@ -17379,7 +17603,7 @@ class BXRestNavvyCatalogUserfieldDocument {
      * Возвращает список пользовательских полей документов складского учёта.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $userfield, $document, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $userfield, $document, $list], param, 'documents');
     }
     /**
      * Обновляет пользовательское поле документа складского учёта.
@@ -17430,7 +17654,7 @@ class BXRestNavvyCatalogVat {
      * Возвращает список ставок НДС.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $vat, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $vat, $list], param, 'vats');
     }
     /**
      * Обновляет ставку НДС.
@@ -17583,7 +17807,7 @@ class BXRestNavvySaleBasketItem {
      * Возвращает список элементов корзины.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $basketItem, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $basketItem, $list], param, 'basketItems');
     }
     /**
      * Обновляет элемент корзины.
@@ -17633,7 +17857,7 @@ class BXRestNavvySaleBasketProperties {
      * Возвращает список свойств элементов корзины.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $basketProperties, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $basketProperties, $list], param, 'basketProperties');
     }
     /**
      * Обновляет свойство элемента корзины.
@@ -17671,7 +17895,7 @@ class BXRestNavvySaleBusinessValuePersonDomain {
      * Возвращает список соответствий типов плательщиков.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $businessValuePersonDomain, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $businessValuePersonDomain, $list], param, 'businessValuePersonDomains');
     }
 }
 
@@ -17944,7 +18168,7 @@ class BXRestNavvySaleOrder {
      * Возвращает список заказов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $order, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $order, $list], param, 'orders');
     }
     /**
      * Обновляет заказ.
@@ -17986,7 +18210,7 @@ class BXRestNavvySalePayment {
      * Возвращает список оплат.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $payment, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $payment, $list], param, 'payments');
     }
     /**
      * Обновляет оплату.
@@ -18028,7 +18252,7 @@ class BXRestNavvySalePaymentItemBasket {
      * Возвращает список привязок элементов корзины к оплатам.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $paymentItemBasket, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $paymentItemBasket, $list], param, 'paymentItemsBasket');
     }
     /**
      * Обновляет привязку элемента корзины к оплате.
@@ -18070,7 +18294,7 @@ class BXRestNavvySalePaymentItemShipment {
      * Возвращает список привязок оплат к отгрузкам.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $paymentItemShipment, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $paymentItemShipment, $list], param, 'paymentItemsShipment');
     }
     /**
      * Обновляет привязку оплаты к отгрузке.
@@ -18230,7 +18454,7 @@ class BXRestNavvySalePersonType {
      * Возвращает список типов плательщиков.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $personType, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $personType, $list], param, 'personTypes');
     }
     /**
      * Обновляет тип плательщика.
@@ -18272,7 +18496,7 @@ class BXRestNavvySaleProperty {
      * Возвращает список свойств заказа.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $property, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $property, $list], param, 'properties');
     }
     /**
      * Обновляет свойство заказа.
@@ -18350,7 +18574,7 @@ class BXRestNavvySalePropertyRelation {
      * Возвращает список привязок свойств заказа.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $propertyRelation, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $propertyRelation, $list], param, 'propertyRelations');
     }
 }
 
@@ -18380,7 +18604,7 @@ class BXRestNavvySalePropertyValue {
      * Возвращает список значений свойств заказа.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $propertyValue, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $propertyValue, $list], param, 'propertyValues');
     }
     /**
      * Устанавливает или изменяет значение свойства заказа.
@@ -18422,7 +18646,7 @@ class BXRestNavvySalePropertyVariant {
      * Возвращает список значений списочного свойства заказа.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $propertyVariant, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $propertyVariant, $list], param, 'propertyVariants');
     }
     /**
      * Обновляет значение списочного свойства заказа.
@@ -18464,7 +18688,7 @@ class BXRestNavvySaleShipment {
      * Возвращает список отгрузок.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $shipment, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $shipment, $list], param, 'shipments');
     }
     /**
      * Обновляет отгрузку.
@@ -18506,7 +18730,7 @@ class BXRestNavvySaleShipmentItem {
      * Возвращает список товарных позиций отгрузки.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $shipmentItem, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $shipmentItem, $list], param, 'shipmentItems');
     }
     /**
      * Обновляет товарную позицию отгрузки.
@@ -18548,7 +18772,7 @@ class BXRestNavvySaleShipmentProperty {
      * Возвращает список свойств отгрузки.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $shipmentProperty, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $shipmentProperty, $list], param, 'properties');
     }
     /**
      * Обновляет свойство отгрузки.
@@ -18584,7 +18808,7 @@ class BXRestNavvySaleShipmentPropertyValue {
      * Возвращает список значений свойств отгрузки.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $shipmentPropertyValue, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $shipmentPropertyValue, $list], param, 'propertyValues');
     }
     /**
      * Устанавливает или изменяет значение свойства отгрузки.
@@ -18626,7 +18850,7 @@ class BXRestNavvySaleStatus {
      * Возвращает список статусов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $status, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $status, $list], param, 'statuses');
     }
     /**
      * Обновляет статус.
@@ -18668,7 +18892,7 @@ class BXRestNavvySaleStatusLang {
      * Возвращает список локализаций статусов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $statusLang, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $statusLang, $list], param, 'statusLangs');
     }
 }
 
@@ -18686,7 +18910,7 @@ class BXRestNavvySaleTradeBinding {
      * Возвращает список привязок источников заказов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $tradeBinding, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $tradeBinding, $list], param, 'tradeBindings');
     }
 }
 
@@ -18704,7 +18928,7 @@ class BXRestNavvySaleTradePlatform {
      * Возвращает список источников заказов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $tradePlatform, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $tradePlatform, $list], param, 'tradePlatforms');
     }
 }
 
@@ -18998,7 +19222,7 @@ class BXRestNavvyUserFieldType {
      * Возвращает список типов пользовательских полей, зарегистрированных приложением.
      */
     list(param = {}) {
-        return this.Navvy.simple([$userfieldtype, $list], param);
+        return this.Navvy.pagNav([$userfieldtype, $list], param);
     }
     /**
      * Изменяет настройки зарегистрированного приложением типа пользовательских полей.
@@ -19009,69 +19233,70 @@ class BXRestNavvyUserFieldType {
 }
 
 class BXRestNavvy {
-    constructor() {
-        this.ai = new BXRestNavvyAi();
-        this.mailService = new BXRestNavvyMailService();
-        this.messageService = new BXRestNavvyMessageService();
-        this.userConsent = new BXRestNavvyUserConsent();
-        this.telephony = new BXRestNavvyTelephony();
-        this.vote = new BXRestNavvyVote();
-        this.imConnector = new BXRestNavvyImConnector();
-        this.entity = new BXRestNavvyEntity();
-        this.biConnector = new BXRestNavvyBiConnector();
-        this.voxImplant = new BXRestNavvyVoxImplant();
-        this.mail = new BXRestNavvyMail();
-        this.note = new BXRestNavvyNote();
-        this.documentGenerator = new BXRestNavvyDocumentGenerator();
-        this.imBot = new BXRestNavvyImBot();
-        this.booking = new BXRestNavvyBooking();
-        this.imOpenLines = new BXRestNavvyImOpenLines();
-        this.landing = new BXRestNavvyLanding();
-        this.catalog = new BXRestNavvyCatalog();
-        this.sale = new BXRestNavvySale();
-        this.sign = new BXRestNavvySign();
-        this.eventLog = new BXRestNavvyEventLog();
-        this.placement = new BXRestNavvyPlacement();
-        this.userFieldType = new BXRestNavvyUserFieldType();
-        this.user = new BXRestNavvyUser();
-        this.lists = new BXRestNavvyLists();
-        this.task = new BXRestNavvyTask();
-        this.tasks = new BXRestNavvyTasks();
-        this.disk = new BXRestNavvyDisk();
-        this.bizProc = new BXRestNavvyBizProc();
-        this.log = new BXRestNavvyLog();
-        this.calendar = new BXRestNavvyCalendar();
-        this.sonet_group = new BXRestNavvySonetGroup();
-        this.server = new BXRestNavvyServer();
-        this.department = new BXRestNavvyDepartment();
-        this.im = new BXRestNavvyIm();
-        this.app = new BXRestNavvyApp();
-        this.timeMan = new BXRestNavvyTimeMan();
-        this.socialNetWork = new BXRestNavvySocialNetWork();
-        this.pull = new BXRestNavvyPull();
-        this.crm = new BXRestNavvyCrm();
-        /** Регистрация обработчиков и работа с онлайн- и офлайн-событиями. */
-        this.event = new BXRestNavvyEvent();
-        /** Проверка существования и доступности REST-методов. */
-        this.method = new BXRestNavvyMethod();
-        /** Получение описаний кодов доступа. */
-        this.access = new BXRestNavvyAccess();
-        /** Проверка доступности возможностей портала. */
-        this.feature = new BXRestNavvyFeature();
-        this.Navvy = new Navvy();
-        // public batch<T, C, M>(param: iBXRestNavvyParamBatch<T, C, M>) {
-        //   const modifiedObject = Object.fromEntries(
-        //     Object.entries(param.cmd).map(([key, value]) => {
-        //       let modifiedValue = value.resultVanilla.arguments
-        //       return [key, modifiedValue]
-        //     })
-        //   )
-        //
-        //   return this.BXRest.batch({
-        //     halt: param.halt,
-        //     cmd: modifiedObject
-        //   })
-        // }
+    /**
+     * @param settings Свои настройки клиента: адрес портала, способ авторизации,
+     *   заголовки. Все запросы этого клиента идут с ними, даже если глобальные
+     *   `BXRestSettings` позже изменятся. Так в одном процессе можно работать
+     *   с несколькими порталами. Без аргумента клиент работает с глобальными
+     *   `BXRestSettings`, как раньше.
+     */
+    constructor(settings) {
+        // Каждый HTTP-объект запоминает контекст в момент создания, поэтому все
+        // разделы создаются, пока включён контекст клиента. Создание идёт в теле
+        // конструктора, а не в инициализаторах полей: только так finally вернёт
+        // прежний контекст, даже если какой-то раздел бросит исключение. Иначе
+        // объекты, созданные приложением позже, ушли бы на портал этого клиента.
+        const previous = enterContext(settings ? new BXRestContext(settings) : globalContext);
+        try {
+            this.ai = new BXRestNavvyAi();
+            this.mailService = new BXRestNavvyMailService();
+            this.messageService = new BXRestNavvyMessageService();
+            this.userConsent = new BXRestNavvyUserConsent();
+            this.telephony = new BXRestNavvyTelephony();
+            this.vote = new BXRestNavvyVote();
+            this.imConnector = new BXRestNavvyImConnector();
+            this.entity = new BXRestNavvyEntity();
+            this.biConnector = new BXRestNavvyBiConnector();
+            this.voxImplant = new BXRestNavvyVoxImplant();
+            this.mail = new BXRestNavvyMail();
+            this.note = new BXRestNavvyNote();
+            this.documentGenerator = new BXRestNavvyDocumentGenerator();
+            this.imBot = new BXRestNavvyImBot();
+            this.booking = new BXRestNavvyBooking();
+            this.imOpenLines = new BXRestNavvyImOpenLines();
+            this.landing = new BXRestNavvyLanding();
+            this.catalog = new BXRestNavvyCatalog();
+            this.sale = new BXRestNavvySale();
+            this.sign = new BXRestNavvySign();
+            this.eventLog = new BXRestNavvyEventLog();
+            this.placement = new BXRestNavvyPlacement();
+            this.userFieldType = new BXRestNavvyUserFieldType();
+            this.user = new BXRestNavvyUser();
+            this.lists = new BXRestNavvyLists();
+            this.task = new BXRestNavvyTask();
+            this.tasks = new BXRestNavvyTasks();
+            this.disk = new BXRestNavvyDisk();
+            this.bizProc = new BXRestNavvyBizProc();
+            this.log = new BXRestNavvyLog();
+            this.calendar = new BXRestNavvyCalendar();
+            this.sonet_group = new BXRestNavvySonetGroup();
+            this.server = new BXRestNavvyServer();
+            this.department = new BXRestNavvyDepartment();
+            this.im = new BXRestNavvyIm();
+            this.app = new BXRestNavvyApp();
+            this.timeMan = new BXRestNavvyTimeMan();
+            this.socialNetWork = new BXRestNavvySocialNetWork();
+            this.pull = new BXRestNavvyPull();
+            this.crm = new BXRestNavvyCrm();
+            this.event = new BXRestNavvyEvent();
+            this.method = new BXRestNavvyMethod();
+            this.access = new BXRestNavvyAccess();
+            this.feature = new BXRestNavvyFeature();
+            this.Navvy = new Navvy();
+        }
+        finally {
+            restoreContext(previous);
+        }
     }
     /**
      * Возвращает базовую информацию о текущем пользователе без scope `user`.
@@ -19757,19 +19982,6 @@ function toRecord(value) {
         : {};
 }
 
-class HttpNavvyServices {
-    constructor() {
-        this.httpServices = new HttpBXServices();
-    }
-    // Реализация метода
-    post(url, params) {
-        if (params === undefined) {
-            params = {};
-        }
-        return this.httpServices.post(url, params);
-    }
-}
-
 /**
  * Public API Surface of bx-rest
  */
@@ -19778,5 +19990,5 @@ class HttpNavvyServices {
  * Generated bundle index. Do not edit.
  */
 
-export { base as BXBaseServices, BXRestApiError, BXRestFrame, BXRestFrameError, BXRestMap, BXRestMapResult, BXRestNavvy, HttpBXServices as BXRestRequest, BXRestSettings, HttpNavvyServices, Navvy, SessionKeyError, SessionKeyServices, getAuthRefreshError, instanceOfiBXRestAnswerSuccess as isBXRestAnswerSuccess, isBXRestAuthError, partNameMethods$1 as partNameMethods };
+export { base as BXBaseServices, BXRestApiError, BXRestFrame, BXRestFrameError, BXRestHttpError, BXRestMap, BXRestMapResult, BXRestNavvy, HttpBXServices as BXRestRequest, BXRestSettings, BXRestTimeoutError, Navvy, SessionKeyError, SessionKeyServices, getAuthRefreshError, instanceOfiBXRestAnswerSuccess as isBXRestAnswerSuccess, isBXRestAuthError, partNameMethods$1 as partNameMethods };
 //# sourceMappingURL=bx-rest.mjs.map