bx-rest 1.6.0 → 1.7.0

package/fesm2022/bx-rest.mjs

@@ -833,8 +833,16 @@ class SessionKeyServices {
  * Сами запросы отправляет `HttpBXServices` (`BXRestRequest`).
  */
 class HttpServices {
-    constructor() {
-        this.session = new SessionKeyServices();
+    /**
+     * @param settings свои настройки, как у `new BXRestNavvy(settings)`: запросы
+     *   идут на этот портал с этим токеном, а `BXRestSettings` на них не влияют.
+     *   Без них — настройки клиента, внутри которого создан объект, или
+     *   глобальные `BXRestSettings`.
+     */
+    constructor(settings) {
+        this.session = settings
+            ? runInContext(new BXRestContext(settings), () => new SessionKeyServices())
+            : new SessionKeyServices();
     }
     /**
      * Экземпляр axios клиента. Один на контекст (клиента со своими настройками
@@ -1081,9 +1089,10 @@ class BXRestTimeoutError extends Error {
     }
 }
 /**
- * Встроенные шаги из настроек, в этом порядке: повтор, очередь, таймаут.
+ * Встроенные шаги из настроек, в этом порядке: повтор, очередь, таймаут, журнал.
  * Повтор — снаружи: каждая попытка заново встаёт в очередь и получает свой
  * таймаут. Таймаут — внутри очереди: ожидание своей очереди его не тратит.
+ * Журнал — внутри всех: каждая попытка — своя запись, без времени в очереди.
  */
 function builtInMiddleware(settings, state) {
     const steps = [];
@@ -1115,6 +1124,15 @@ function builtInMiddleware(settings, state) {
         }
         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) {
@@ -1185,6 +1203,50 @@ function throttle(perSecond, state) {
         });
     };
 }
+/** Код ошибки 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) => {
@@ -1211,6 +1273,51 @@ function timeout(ms) {
     };
 }
 
+/**
+ * Ответ не 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.
@@ -1358,16 +1465,18 @@ class HttpBXServices extends HttpServices {
     }
     /**
      * Отправка через шаги из настроек: `retryOnQueryLimit`, `throttle`,
-     * `timeout`, затем `middleware`; последним идёт axios клиента. Настройки
-     * читаются при подписке. Отписка отменяет HTTP-запрос (AbortSignal).
-     * Ошибка транспорта уходит дальше как есть: у axios в ней весь запрос,
-     * вместе с токеном и секретом вебхука (см. README, «Обработка ошибок»).
+     * `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 send = composeMiddleware([...builtInMiddleware(ctx.settings, ctx), ...this.session.getMiddleware()], request => this.axiosSend(request));
+            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();
@@ -1635,11 +1744,43 @@ class NavvyPagNavResultKeyObject extends NavvyPagBase {
     }
 }
 
+/**
+ * Пагинация для методов, у которых `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;
+    }
+    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 {
-    constructor() {
-        // Контекст, в котором создан Navvy. Запросы создаются позже, при вызове
-        // метода, поэтому их HTTP-объекты получают этот контекст явно, а не текущий.
-        this.ctx = currentContext();
+    /**
+     * @param settings свои настройки, как у `new BXRestNavvy(settings)`: запросы
+     *   идут на этот портал с этим токеном, а `BXRestSettings` на них не влияют.
+     *   Без них — настройки клиента, внутри которого создан объект, или
+     *   глобальные `BXRestSettings`.
+     */
+    constructor(settings) {
+        this.ctx = settings ? new BXRestContext(settings) : currentContext();
     }
     simple(url, arg, map) {
         return runInContext(this.ctx, () => new NavvySimple(url, arg !== undefined ? arg : undefined, map));
@@ -1667,6 +1808,14 @@ class Navvy {
     pagNavResultKeyObject(url, arg, key, map) {
         return runInContext(this.ctx, () => new NavvyPagNavResultKeyObject(url, arg, key, 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));
     }
@@ -1782,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';
@@ -2583,6 +2733,7 @@ var partNameMethods$1 = /*#__PURE__*/Object.freeze({
     $publication: $publication,
     $publicationFolder: $publicationFolder,
     $pull: $pull,
+    $push: $push,
     $quick: $quick,
     $quote: $quote,
     $ratio: $ratio,
@@ -4130,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;
@@ -4158,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);
         }));
     }
     /**
@@ -8118,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) } : {}),
+        };
     }
 }
 
@@ -8179,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);
     }
 }
 
@@ -8201,7 +8369,7 @@ class BXRestMapPullChannelPublic {
 class BXRestNavvyPullChannelPublic {
     constructor() {
         this.url = {
-            get: [$log, $blogpost, $add]
+            get: [$pull, $channel, $public, $get]
         };
         this.Navvy = new Navvy();
     }
@@ -8209,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);
     }
 }
 
@@ -8218,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(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
      */
-    get() {
-        return this.Navvy.simple([$pull, $application, $config, $get], undefined, BXRestMapPullApplicationConfig.get);
+    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() {
         /**
@@ -8235,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(),
         };
     }
 }
@@ -9032,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); }
     /**
      * Изменяет настройки шаблона регулярной сделки.
      */
@@ -10891,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);
     }
     /**
      * Удаляет связь реквизитов с объектом, не удаляя сами реквизиты.
@@ -11239,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.
@@ -11904,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.
@@ -12380,7 +12605,7 @@ class BXRestNavvyCrmActivity {
      * Возвращает список дел всех типов по фильтру.
      */
     list(param = {}) {
-        return this.Navvy.simple([$crm, $activity, $list], param);
+        return this.Navvy.pagNav([$crm, $activity, $list], param);
     }
     /**
      * Обновляет дело.
@@ -12416,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');
     }
 }
 
@@ -12428,7 +12653,7 @@ class BXRestNavvyCrmStageHistory {
      * Возвращает историю движения элемента по стадиям.
      */
     list(param = {}) {
-        return this.Navvy.simple([$crm, $stagehistory, $list], param);
+        return this.Navvy.pagNavKeyed([$crm, $stagehistory, $list], param, 'items');
     }
 }
 
@@ -14272,7 +14497,7 @@ class BXRestNavvyDocumentGeneratorDocument {
      * Возвращает список документов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$documentgenerator, $document, $list], param);
+        return this.Navvy.pagNavKeyed([$documentgenerator, $document, $list], param, 'documents');
     }
     /**
      * Изменяет существующий документ.
@@ -14308,7 +14533,7 @@ class BXRestNavvyDocumentGeneratorNumerator {
      * Возвращает список нумераторов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$documentgenerator, $numerator, $list], param);
+        return this.Navvy.pagNavKeyed([$documentgenerator, $numerator, $list], param, 'numerators');
     }
     /**
      * Изменяет нумератор.
@@ -14386,7 +14611,7 @@ class BXRestNavvyDocumentGeneratorRole {
      * Возвращает список ролей без детального состава прав.
      */
     list(param = {}) {
-        return this.Navvy.simple([$documentgenerator, $role, $list], param);
+        return this.Navvy.pagNavKeyed([$documentgenerator, $role, $list], param, 'roles');
     }
     /**
      * Обновляет роль и возвращает актуальные данные.
@@ -14428,7 +14653,7 @@ class BXRestNavvyDocumentGeneratorTemplate {
      * Возвращает список шаблонов документов по фильтру.
      */
     list(param = {}) {
-        return this.Navvy.simple([$documentgenerator, $template, $list], param);
+        return this.Navvy.pagNavKeyed([$documentgenerator, $template, $list], param, 'templates');
     }
     /**
      * Обновляет существующий шаблон документа.
@@ -14965,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');
     }
     /**
      * Обновляет ресурс.
@@ -15001,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');
     }
     /**
      * Обновляет тип ресурса.
@@ -16382,7 +16607,7 @@ class BXRestNavvyCatalogCatalog {
      * Возвращает список торговых каталогов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $catalog, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $catalog, $list], param, 'catalogs');
     }
     /**
      * Обновляет параметры торгового каталога.
@@ -16418,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');
     }
     /**
      * Обновляет товарную позицию документа складского учёта.
@@ -16504,7 +16729,7 @@ class BXRestNavvyCatalogDocument {
      * Возвращает список документов складского учёта.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $document, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $document, $list], param, 'documents');
     }
     /**
      * Обновляет документ складского учёта.
@@ -16540,7 +16765,7 @@ class BXRestNavvyCatalogDocumentContractor {
      * Возвращает список поставщиков документов складского учёта.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $documentcontractor, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $documentcontractor, $list], param, 'documentContractor');
     }
 }
 
@@ -16584,7 +16809,7 @@ class BXRestNavvyCatalogExtra {
      * Возвращает список наценок.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $extra, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $extra, $list], param, 'extras');
     }
 }
 
@@ -16620,7 +16845,7 @@ class BXRestNavvyCatalogMeasure {
      * Возвращает список единиц измерения.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $measure, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $measure, $list], param, 'measures');
     }
     /**
      * Обновляет единицу измерения.
@@ -16662,7 +16887,7 @@ class BXRestNavvyCatalogPrice {
      * Возвращает список цен.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $price, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $price, $list], param, 'prices');
     }
     /**
      * Устанавливает или изменяет цену товара, создавая запись при её отсутствии.
@@ -16710,7 +16935,7 @@ class BXRestNavvyCatalogPriceType {
      * Возвращает список типов цен.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $priceType, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $priceType, $list], param, 'priceTypes');
     }
     /**
      * Обновляет тип цены.
@@ -16746,7 +16971,7 @@ class BXRestNavvyCatalogPriceTypeGroup {
      * Возвращает список привязок типов цен к группам покупателей.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $priceTypeGroup, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $priceTypeGroup, $list], param, 'priceTypeGroups');
     }
 }
 
@@ -16788,7 +17013,7 @@ class BXRestNavvyCatalogPriceTypeLang {
      * Возвращает список переводов названий типов цен.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $priceTypeLang, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $priceTypeLang, $list], param, 'priceTypeLangs');
     }
     /**
      * Обновляет перевод названия типа цены.
@@ -16838,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');
     }
     /**
      * Обновляет товар-вариацию.
@@ -16888,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');
     }
     /**
      * Обновляет услугу.
@@ -16938,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');
     }
     /**
      * Обновляет товар с вариациями.
@@ -16998,7 +17223,7 @@ class BXRestNavvyCatalogProduct {
      * Возвращает список товаров.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $product, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $product, $list], param, 'products');
     }
     /**
      * Обновляет товар.
@@ -17076,7 +17301,7 @@ class BXRestNavvyCatalogProductProperty {
      * Возвращает список свойств товаров.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $productProperty, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $productProperty, $list], param, 'productProperties');
     }
     /**
      * Обновляет свойство товара.
@@ -17118,7 +17343,7 @@ class BXRestNavvyCatalogProductPropertyEnum {
      * Возвращает список значений списочного свойства.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $productPropertyEnum, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $productPropertyEnum, $list], param, 'productPropertyEnums');
     }
     /**
      * Обновляет значение списочного свойства товара.
@@ -17162,7 +17387,7 @@ class BXRestNavvyCatalogProductPropertyFeature {
      * Возвращает список параметров свойств товаров.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $productPropertyFeature, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $productPropertyFeature, $list], param, 'productPropertyFeatures');
     }
     /**
      * Обновляет параметр свойства товара.
@@ -17186,7 +17411,7 @@ class BXRestNavvyCatalogProductPropertySection {
      * Возвращает список секционных настроек свойств.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $productPropertySection, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $productPropertySection, $list], param, 'productPropertySections');
     }
     /**
      * Устанавливает секционные настройки свойства.
@@ -17216,7 +17441,7 @@ class BXRestNavvyCatalogRatio {
      * Возвращает список коэффициентов единиц измерения.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $ratio, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $ratio, $list], param, 'ratios');
     }
 }
 
@@ -17252,7 +17477,7 @@ class BXRestNavvyCatalogRoundingRule {
      * Возвращает список правил округления цен.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $roundingRule, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $roundingRule, $list], param, 'roundingRules');
     }
     /**
      * Обновляет правило округления цен.
@@ -17294,7 +17519,7 @@ class BXRestNavvyCatalogSection {
      * Возвращает список разделов каталога.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $section, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $section, $list], param, 'sections');
     }
     /**
      * Обновляет раздел каталога.
@@ -17336,7 +17561,7 @@ class BXRestNavvyCatalogStore {
      * Возвращает список складов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $store, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $store, $list], param, 'stores');
     }
     /**
      * Обновляет склад.
@@ -17366,7 +17591,7 @@ class BXRestNavvyCatalogStoreProduct {
      * Возвращает список остатков товаров на складах.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $storeProduct, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $storeProduct, $list], param, 'storeProducts');
     }
 }
 
@@ -17378,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');
     }
     /**
      * Обновляет пользовательское поле документа складского учёта.
@@ -17429,7 +17654,7 @@ class BXRestNavvyCatalogVat {
      * Возвращает список ставок НДС.
      */
     list(param = {}) {
-        return this.Navvy.simple([$catalog, $vat, $list], param);
+        return this.Navvy.pagNavKeyed([$catalog, $vat, $list], param, 'vats');
     }
     /**
      * Обновляет ставку НДС.
@@ -17582,7 +17807,7 @@ class BXRestNavvySaleBasketItem {
      * Возвращает список элементов корзины.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $basketItem, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $basketItem, $list], param, 'basketItems');
     }
     /**
      * Обновляет элемент корзины.
@@ -17632,7 +17857,7 @@ class BXRestNavvySaleBasketProperties {
      * Возвращает список свойств элементов корзины.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $basketProperties, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $basketProperties, $list], param, 'basketProperties');
     }
     /**
      * Обновляет свойство элемента корзины.
@@ -17670,7 +17895,7 @@ class BXRestNavvySaleBusinessValuePersonDomain {
      * Возвращает список соответствий типов плательщиков.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $businessValuePersonDomain, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $businessValuePersonDomain, $list], param, 'businessValuePersonDomains');
     }
 }
 
@@ -17943,7 +18168,7 @@ class BXRestNavvySaleOrder {
      * Возвращает список заказов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $order, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $order, $list], param, 'orders');
     }
     /**
      * Обновляет заказ.
@@ -17985,7 +18210,7 @@ class BXRestNavvySalePayment {
      * Возвращает список оплат.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $payment, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $payment, $list], param, 'payments');
     }
     /**
      * Обновляет оплату.
@@ -18027,7 +18252,7 @@ class BXRestNavvySalePaymentItemBasket {
      * Возвращает список привязок элементов корзины к оплатам.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $paymentItemBasket, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $paymentItemBasket, $list], param, 'paymentItemsBasket');
     }
     /**
      * Обновляет привязку элемента корзины к оплате.
@@ -18069,7 +18294,7 @@ class BXRestNavvySalePaymentItemShipment {
      * Возвращает список привязок оплат к отгрузкам.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $paymentItemShipment, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $paymentItemShipment, $list], param, 'paymentItemsShipment');
     }
     /**
      * Обновляет привязку оплаты к отгрузке.
@@ -18229,7 +18454,7 @@ class BXRestNavvySalePersonType {
      * Возвращает список типов плательщиков.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $personType, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $personType, $list], param, 'personTypes');
     }
     /**
      * Обновляет тип плательщика.
@@ -18271,7 +18496,7 @@ class BXRestNavvySaleProperty {
      * Возвращает список свойств заказа.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $property, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $property, $list], param, 'properties');
     }
     /**
      * Обновляет свойство заказа.
@@ -18349,7 +18574,7 @@ class BXRestNavvySalePropertyRelation {
      * Возвращает список привязок свойств заказа.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $propertyRelation, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $propertyRelation, $list], param, 'propertyRelations');
     }
 }
 
@@ -18379,7 +18604,7 @@ class BXRestNavvySalePropertyValue {
      * Возвращает список значений свойств заказа.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $propertyValue, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $propertyValue, $list], param, 'propertyValues');
     }
     /**
      * Устанавливает или изменяет значение свойства заказа.
@@ -18421,7 +18646,7 @@ class BXRestNavvySalePropertyVariant {
      * Возвращает список значений списочного свойства заказа.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $propertyVariant, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $propertyVariant, $list], param, 'propertyVariants');
     }
     /**
      * Обновляет значение списочного свойства заказа.
@@ -18463,7 +18688,7 @@ class BXRestNavvySaleShipment {
      * Возвращает список отгрузок.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $shipment, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $shipment, $list], param, 'shipments');
     }
     /**
      * Обновляет отгрузку.
@@ -18505,7 +18730,7 @@ class BXRestNavvySaleShipmentItem {
      * Возвращает список товарных позиций отгрузки.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $shipmentItem, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $shipmentItem, $list], param, 'shipmentItems');
     }
     /**
      * Обновляет товарную позицию отгрузки.
@@ -18547,7 +18772,7 @@ class BXRestNavvySaleShipmentProperty {
      * Возвращает список свойств отгрузки.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $shipmentProperty, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $shipmentProperty, $list], param, 'properties');
     }
     /**
      * Обновляет свойство отгрузки.
@@ -18583,7 +18808,7 @@ class BXRestNavvySaleShipmentPropertyValue {
      * Возвращает список значений свойств отгрузки.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $shipmentPropertyValue, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $shipmentPropertyValue, $list], param, 'propertyValues');
     }
     /**
      * Устанавливает или изменяет значение свойства отгрузки.
@@ -18625,7 +18850,7 @@ class BXRestNavvySaleStatus {
      * Возвращает список статусов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $status, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $status, $list], param, 'statuses');
     }
     /**
      * Обновляет статус.
@@ -18667,7 +18892,7 @@ class BXRestNavvySaleStatusLang {
      * Возвращает список локализаций статусов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $statusLang, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $statusLang, $list], param, 'statusLangs');
     }
 }
 
@@ -18685,7 +18910,7 @@ class BXRestNavvySaleTradeBinding {
      * Возвращает список привязок источников заказов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $tradeBinding, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $tradeBinding, $list], param, 'tradeBindings');
     }
 }
 
@@ -18703,7 +18928,7 @@ class BXRestNavvySaleTradePlatform {
      * Возвращает список источников заказов.
      */
     list(param = {}) {
-        return this.Navvy.simple([$sale, $tradePlatform, $list], param);
+        return this.Navvy.pagNavKeyed([$sale, $tradePlatform, $list], param, 'tradePlatforms');
     }
 }
 
@@ -18997,7 +19222,7 @@ class BXRestNavvyUserFieldType {
      * Возвращает список типов пользовательских полей, зарегистрированных приложением.
      */
     list(param = {}) {
-        return this.Navvy.simple([$userfieldtype, $list], param);
+        return this.Navvy.pagNav([$userfieldtype, $list], param);
     }
     /**
      * Изменяет настройки зарегистрированного приложением типа пользовательских полей.
@@ -19765,5 +19990,5 @@ function toRecord(value) {
  * Generated bundle index. Do not edit.
  */
 
-export { base as BXBaseServices, BXRestApiError, BXRestFrame, BXRestFrameError, BXRestMap, BXRestMapResult, BXRestNavvy, HttpBXServices as BXRestRequest, BXRestSettings, BXRestTimeoutError, 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