@bitrix24/b24jssdk 1.2.0 → 1.3.0

package/dist/esm/tools/uuidv7.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/types/b24-helper.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/types/b24.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/types/bizproc/index.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/types/catalog/index.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/types/common.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/types/crm/entity-type.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/types/crm/productrow.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/types/logger.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/types/pull.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/umd/index.js

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -10407,6 +10407,33 @@ If you need to send logs from browser, use a proxy server.`;
     getErrorMessages() {
       return Array.from(this._errors.values(), (e) => e.message);
     }
+    /**
+     * Retrieves all errors as a plain object (a snapshot copy) keyed by their
+     * identifier, preserving which request produced each error. Unlike
+     * {@link Result.getErrors}, the keys are not discarded — useful for batch
+     * calls with `isHaltOnError: false`.
+     *
+     * Keys are meaningful only when the error was added with an explicit key
+     * (e.g. an object / named-command batch). Array-mode batches and
+     * {@link Result.addErrors} fall back to generated UUID keys.
+     *
+     * @returns {Record<string, Error>} A map of error key to Error object.
+     */
+    getErrorsByKey() {
+      return Object.fromEntries(this._errors);
+    }
+    /**
+     * Retrieves all error messages as a plain object (a snapshot copy) keyed by
+     * their identifier. Unlike {@link Result.getErrorMessages}, the keys are
+     * preserved. See {@link Result.getErrorsByKey} for when keys are meaningful.
+     *
+     * @returns {Record<string, string>} A map of error key to error message.
+     */
+    getErrorMessagesByKey() {
+      return Object.fromEntries(
+        Array.from(this._errors, ([key, error]) => [key, error.message])
+      );
+    }
     /**
      * Converts the Result object to a string.
      *
@@ -11817,6 +11844,7 @@ ${this.stack}`;
       "INVALID_REQUEST",
       "OVERLOAD_LIMIT",
       "expired_token",
+      "invalid_token",
       "ACCESS_DENIED",
       "INVALID_CREDENTIALS",
       "user_access_error",
@@ -12059,6 +12087,7 @@ ${JSON.stringify({
     #supportMethods;
     constructor() {
       this.#supportMethods = [
+        // --- infrastructure ---
         "/batch",
         // done
         "/scopes",
@@ -12067,6 +12096,7 @@ ${JSON.stringify({
         // done
         "/rest.documentation.openapi",
         "/documentation",
+        // --- main ---
         /** @see /settings/configs/event_log.php */
         "/main.eventlog.list",
         // done
@@ -12074,21 +12104,96 @@ ${JSON.stringify({
         // done
         "/main.eventlog.tail",
         // done
-        "/tasks.task.chat.message.send",
-        "/tasks.task.access.get",
-        "/tasks.task.file.attach",
+        "/main.eventlog.field.list",
+        "/main.eventlog.field.get",
+        // --- mail (rest-v3) ---
+        "/mail.mailbox.list",
+        "/mail.mailbox.get",
+        "/mail.mailbox.senders",
+        "/mail.mailbox.field.list",
+        "/mail.mailbox.field.get",
+        "/mail.message.list",
+        "/mail.message.get",
+        "/mail.message.thread",
+        "/mail.message.send",
+        "/mail.message.reply",
+        "/mail.message.forward",
+        "/mail.message.movetofolder",
+        "/mail.message.createcrmactivity",
+        "/mail.message.removecrmactivity",
+        "/mail.message.createtask",
+        "/mail.message.createcalendarevent",
+        "/mail.message.createchat",
+        "/mail.message.createfeedpost",
+        "/mail.message.field.list",
+        "/mail.message.field.get",
+        "/mail.recipient.listcontacts",
+        "/mail.recipient.listemployees",
+        "/mail.recipient.field.list",
+        "/mail.recipient.field.get",
+        // --- humanresources (rest-v3) ---
+        "/humanresources.node.add",
+        "/humanresources.node.edit",
+        "/humanresources.node.get",
+        "/humanresources.node.list",
+        "/humanresources.node.search",
+        "/humanresources.node.children",
+        "/humanresources.node.count",
+        "/humanresources.node.move",
+        "/humanresources.node.field.list",
+        "/humanresources.node.field.get",
+        "/humanresources.node.member.add",
+        "/humanresources.node.member.set",
+        "/humanresources.node.member.move",
+        "/humanresources.node.member.remove",
+        "/humanresources.node.communication.edit",
+        "/humanresources.node.communication.list",
+        "/humanresources.employee.search",
+        "/humanresources.employee.subordinates",
+        "/humanresources.employee.count",
+        "/humanresources.employee.multidepartment",
+        "/humanresources.employee.field.list",
+        "/humanresources.employee.field.get",
+        // --- tasks (rest-v3) ---
+        "/tasks.task.add",
+        "/tasks.task.get",
+        // done
         "/tasks.task.update",
         // done
         "/tasks.task.delete",
-        "/tasks.task.add",
-        "/tasks.task.get"
-        // done
+        "/tasks.task.access.get",
+        "/tasks.task.file.attach",
+        "/tasks.task.chat.message.send",
+        "/tasks.task.result.add",
+        "/tasks.task.result.addfromchatmessage",
+        "/tasks.task.result.update",
+        "/tasks.task.result.list",
+        "/tasks.task.result.delete",
+        "/tasks.task.field.list",
+        "/tasks.task.field.get",
+        "/tasks.task.access.field.list",
+        "/tasks.task.access.field.get",
+        "/tasks.task.file.field.list",
+        "/tasks.task.file.field.get",
+        "/tasks.task.chat.message.field.list",
+        "/tasks.task.chat.message.field.get",
+        // --- timeman (rest-v3) — read-only in v3 (no record.get / add / update / delete) ---
+        "/timeman.record.list",
+        "/timeman.record.field.list",
+        "/timeman.record.field.get"
+        // Cross-module methods are cross-referenced from the rest-v3 pages above but
+        // belong to modules not actualized here — add them when those modules land:
+        //   user.get                                          — user module (seen on humanresources + timeman)
+        //   im.message.update / im.message.delete / im.dialog.messages.get  — im module (seen on tasks)
+        //   disk.storage.uploadfile / disk.folder.uploadfile /
+        //   disk.storage.getchildren / disk.folder.getchildren            — disk module (seen on tasks)
+        //
         // @todo When API.v3 arrives - change in AuthOAuthManager.initIsAdmin()
-        // '/profile' // waite
-        // '/main.message.get' // waite
-        // '/main.chat.update' // waite
-        // '/main.chat.list' // waite
-        // '/main.user.list' // waite
+        // '/profile' // wait
+        // '/main.message.get' // wait
+        // '/main.chat.update' // wait
+        // '/main.chat.list' // wait
+        // '/main.user.list' // wait
       ];
     }
     static create() {
@@ -12232,12 +12337,16 @@ ${JSON.stringify({
      *
      * @param {ActionCallListV2} options - parameters for executing the request.
      *     - `method: string` - The name of the REST API method that returns a list of data (for example: `crm.item.list`, `tasks.task.list`)
-     *     - `params?: Omit<TypeCallParams, 'start'>` - Request parameters, excluding the `start` parameter,
+     *     - `params?: Omit<TypeCallParams, 'start' | 'order'>` - Request parameters, excluding the `start` and `order` parameters,
      *         since the method is designed to obtain all data in one call.
      *         Note: Use `filter`, `order`, and `select` to control the selection.
-     *     - `idKey?: string` - The name of the field containing the unique identifier of the element.
-     *         Default is 'ID' (uppercase). Alternatively, it can be 'id' (lowercase).
-     *         or another field, depending on the REST API data structure.
+     *     - `idKey?: string` - The name of the id field as it appears in each RESPONSE item; its value
+     *         drives the cursor. Default is 'ID' (uppercase). For methods that return a lowercase /
+     *         camelCase id (for example `tasks.task.list` returns `id`), set `idKey: 'id'`.
+     *     - `cursorIdKey?: string` - The field name used in the REQUEST for `order` and the `>` page
+     *         filter. Defaults to `idKey`. Set it only when the sortable / filterable field name differs
+     *         from the response field name — e.g. `tasks.task.list` sorts and filters by `ID` (uppercase)
+     *         but returns `id` (lowercase): pass `idKey: 'id', cursorIdKey: 'ID'`.
      *     - `customKeyForResult?: string` - A custom key indicating that the response REST API will be
      *        grouped by this field.
      *        Example: `items` to group a list of CRM items.
@@ -12276,16 +12385,17 @@ ${JSON.stringify({
       const batchSize = 50;
       const result = new Result();
       const idKey = options?.idKey ?? "ID";
+      const cursorIdKey = options?.cursorIdKey ?? idKey;
       const customKeyForResult = options?.customKeyForResult ?? null;
       const params = options?.params ?? {};
       if ("order" in params && params["order"]) {
-        this._logger.warning("callList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by idKey. Use `filter` to narrow results instead.");
+        this._logger.warning("callList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by cursorIdKey. Use `filter` to narrow results instead.");
       }
-      const moreIdKey = `>${idKey}`;
+      const moreIdKey = `>${cursorIdKey}`;
       const { order: _ignoredOrder, ...restParams } = params;
       const requestParams = {
         ...restParams,
-        order: { [idKey]: "ASC" },
+        order: { [cursorIdKey]: "ASC" },
         filter: { ...params["filter"] || {}, [moreIdKey]: 0 },
         start: -1
       };
@@ -12330,9 +12440,11 @@ ${JSON.stringify({
           break;
         }
         const lastItem = resultData[resultData.length - 1];
-        if (lastItem && typeof lastItem[idKey] !== "undefined") {
-          requestParams.filter[moreIdKey] = Number.parseInt(lastItem[idKey]);
+        const cursorValue = lastItem ? Number.parseInt(lastItem[idKey], 10) : Number.NaN;
+        if (Number.isFinite(cursorValue)) {
+          requestParams.filter[moreIdKey] = cursorValue;
         } else {
+          this._logger.warning(`callList.make: pagination stops here \u2014 no numeric id could be read from the returned items via idKey "${idKey}". Make sure idKey matches the id field in the response; if the sortable field name differs from it, also set cursorIdKey (e.g. idKey: 'id', cursorIdKey: 'ID').`);
           isContinue = false;
           break;
         }
@@ -12355,12 +12467,16 @@ ${JSON.stringify({
      *
      * @param {ActionFetchListV2} options - parameters for executing the request.
      *     - `method: string` - The name of the REST API method that returns a list of data (for example: `crm.item.list`, `tasks.task.list`)
-     *     - `params?: Omit<TypeCallParams, 'start'>` - Request parameters, excluding the `start` parameter,
+     *     - `params?: Omit<TypeCallParams, 'start' | 'order'>` - Request parameters, excluding the `start` and `order` parameters,
      *         since the method is designed to obtain all data in one call.
      *         Note: Use `filter`, `order`, and `select` to control the selection.
-     *     - `idKey?: string` - The name of the field containing the unique identifier of the element.
-     *         Default is 'ID' (uppercase). Alternatively, it can be 'id' (lowercase).
-     *         or another field, depending on the REST API data structure.
+     *     - `idKey?: string` - The name of the id field as it appears in each RESPONSE item; its value
+     *         drives the cursor. Default is 'ID' (uppercase). For methods that return a lowercase /
+     *         camelCase id (for example `tasks.task.list` returns `id`), set `idKey: 'id'`.
+     *     - `cursorIdKey?: string` - The field name used in the REQUEST for `order` and the `>` page
+     *         filter. Defaults to `idKey`. Set it only when the sortable / filterable field name differs
+     *         from the response field name — e.g. `tasks.task.list` sorts and filters by `ID` (uppercase)
+     *         but returns `id` (lowercase): pass `idKey: 'id', cursorIdKey: 'ID'`.
      *     - `customKeyForResult?: string` - A custom key indicating that the response REST API will be
      *        grouped by this field.
      *        Example: `items` to group a list of CRM items.
@@ -12401,16 +12517,17 @@ ${JSON.stringify({
     async *make(options) {
       const batchSize = 50;
       const idKey = options?.idKey ?? "ID";
+      const cursorIdKey = options?.cursorIdKey ?? idKey;
       const customKeyForResult = options?.customKeyForResult ?? null;
       const params = options?.params ?? {};
       if ("order" in params && params["order"]) {
-        this._logger.warning("fetchList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by idKey. Use `filter` to narrow results instead.");
+        this._logger.warning("fetchList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by cursorIdKey. Use `filter` to narrow results instead.");
       }
-      const moreIdKey = `>${idKey}`;
+      const moreIdKey = `>${cursorIdKey}`;
       const { order: _ignoredOrder, ...restParams } = params;
       const requestParams = {
         ...restParams,
-        order: { [idKey]: "ASC" },
+        order: { [cursorIdKey]: "ASC" },
         filter: { ...params["filter"] || {}, [moreIdKey]: 0 },
         start: -1
       };
@@ -12454,9 +12571,11 @@ ${JSON.stringify({
           break;
         }
         const lastItem = resultData[resultData.length - 1];
-        if (lastItem && typeof lastItem[idKey] !== "undefined") {
-          requestParams.filter[moreIdKey] = Number.parseInt(lastItem[idKey]);
+        const cursorValue = lastItem ? Number.parseInt(lastItem[idKey], 10) : Number.NaN;
+        if (Number.isFinite(cursorValue)) {
+          requestParams.filter[moreIdKey] = cursorValue;
         } else {
+          this._logger.warning(`fetchList.make: pagination stops here \u2014 no numeric id could be read from the returned items via idKey "${idKey}". Make sure idKey matches the id field in the response; if the sortable field name differs from it, also set cursorIdKey (e.g. idKey: 'id', cursorIdKey: 'ID').`);
           isContinue = false;
           break;
         }
@@ -12740,11 +12859,11 @@ ${JSON.stringify({
 
   var __defProp$10 = Object.defineProperty;
   var __name$10 = (target, value) => __defProp$10(target, "name", { value, configurable: true });
-  const callName$1 = Symbol("call_V2");
-  const callListName$1 = Symbol("callList_V2");
-  const fetchListName$1 = Symbol("fetchList_V2");
-  const batchName$1 = Symbol("batch_V2");
-  const batchByChunkName$1 = Symbol("batchByChunk_V2");
+  const callName$1 = /* @__PURE__ */ Symbol("call_V2");
+  const callListName$1 = /* @__PURE__ */ Symbol("callList_V2");
+  const fetchListName$1 = /* @__PURE__ */ Symbol("fetchList_V2");
+  const batchName$1 = /* @__PURE__ */ Symbol("batch_V2");
+  const batchByChunkName$1 = /* @__PURE__ */ Symbol("batchByChunk_V2");
   class ActionsManagerV2 {
     static {
       __name$10(this, "ActionsManagerV2");
@@ -12851,11 +12970,15 @@ ${JSON.stringify({
      *
      * @param {ActionCallListV3} options - parameters for executing the request.
      *     - `method: string` - The name of the REST API method that returns a list of data (for example: `crm.item.list`, `tasks.task.list`)
-     *     - `params?: Omit<TypeCallParams, 'pagination'>` - Request parameters, excluding the `pagination` parameter,
+     *     - `params?: Omit<TypeCallParams, 'pagination' | 'order'>` - Request parameters, excluding the `pagination` and `order` parameters,
      *         since the method is designed to obtain all data in one call.
      *         Note: Use `filter`, `order`, and `select` to control the selection.
-     *     - `idKey?: string` - The name of the field containing the unique identifier of the element.
-     *         Default is 'id'. Alternatively, it can be another field, depending on the REST API data structure.
+     *     - `idKey?: string` - The name of the id field as it appears in each RESPONSE item; its value
+     *         drives the cursor. Default is 'id'. Set it to match the id field the method returns.
+     *     - `cursorIdKey?: string` - The field name used in the REQUEST for `order` and the
+     *         `[field, '>', n]` page filter. Defaults to `idKey`. Set it only when the sortable /
+     *         filterable field name differs from the response field name (e.g. an uppercase request
+     *         field but a lowercase response id): pass `idKey: 'id', cursorIdKey: 'ID'`.
      *     - `customKeyForResult: string` - A custom key indicating that the response REST API will be
      *        grouped by this field.
      *        Example: `items` to group a list of CRM items.
@@ -12894,15 +13017,16 @@ ${JSON.stringify({
       const batchSize = options?.limit ?? 50;
       const result = new Result();
       const idKey = options?.idKey ?? "id";
+      const cursorIdKey = options?.cursorIdKey ?? idKey;
       const customKeyForResult = options?.customKeyForResult ?? null;
       const params = options?.params ?? {};
       if ("order" in params && params["order"]) {
-        this._logger.warning("callList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by idKey. Use `filter` to narrow results instead.");
+        this._logger.warning("callList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by cursorIdKey. Use `filter` to narrow results instead.");
       }
       const { order: _ignoredOrder, ...restParams } = params;
       const requestParams = {
         ...restParams,
-        order: { [idKey]: "ASC" },
+        order: { [cursorIdKey]: "ASC" },
         filter: [...params["filter"] || []],
         pagination: { page: 0, limit: batchSize }
       };
@@ -12911,7 +13035,7 @@ ${JSON.stringify({
       let nextId = 0;
       do {
         const sendParams = { ...requestParams, filter: [...requestParams.filter] };
-        sendParams.filter.push([idKey, ">", nextId]);
+        sendParams.filter.push([cursorIdKey, ">", nextId]);
         const response = await this._b24.actions.v3.call.make({
           method: options.method,
           params: sendParams,
@@ -12945,9 +13069,11 @@ ${JSON.stringify({
           break;
         }
         const lastItem = resultData[resultData.length - 1];
-        if (lastItem && typeof lastItem[idKey] !== "undefined") {
-          nextId = Number.parseInt(lastItem[idKey]);
+        const cursorValue = lastItem ? Number.parseInt(lastItem[idKey], 10) : Number.NaN;
+        if (Number.isFinite(cursorValue)) {
+          nextId = cursorValue;
         } else {
+          this._logger.warning(`callList.make: pagination stops here \u2014 no numeric id could be read from the returned items via idKey "${idKey}". Make sure idKey matches the id field in the response; if the sortable field name differs from it, also set cursorIdKey (e.g. idKey: 'id', cursorIdKey: 'ID').`);
           isContinue = false;
           break;
         }
@@ -12970,11 +13096,15 @@ ${JSON.stringify({
      *
      * @param {ActionFetchListV3} options - parameters for executing the request.
      *     - `method: string` - The name of the REST API method that returns a list of data (for example: `crm.item.list`, `tasks.task.list`)
-     *     - `params?: Omit<TypeCallParams, 'pagination'>` - Request parameters, excluding the `pagination` parameter,
+     *     - `params?: Omit<TypeCallParams, 'pagination' | 'order'>` - Request parameters, excluding the `pagination` and `order` parameters,
      *         since the method is designed to obtain all data in one call.
      *         Note: Use `filter`, `order`, and `select` to control the selection.
-     *     - `idKey?: string` - The name of the field containing the unique identifier of the element.
-     *         Default is 'id'. Alternatively, it can be another field, depending on the REST API data structure.
+     *     - `idKey?: string` - The name of the id field as it appears in each RESPONSE item; its value
+     *         drives the cursor. Default is 'id'. Set it to match the id field the method returns.
+     *     - `cursorIdKey?: string` - The field name used in the REQUEST for `order` and the
+     *         `[field, '>', n]` page filter. Defaults to `idKey`. Set it only when the sortable /
+     *         filterable field name differs from the response field name (e.g. an uppercase request
+     *         field but a lowercase response id): pass `idKey: 'id', cursorIdKey: 'ID'`.
      *     - `customKeyForResult: string` - A custom key indicating that the response REST API will be
      *        grouped by this field.
      *        Example: `items` to group a list of CRM items.
@@ -13013,15 +13143,16 @@ ${JSON.stringify({
     async *make(options) {
       const batchSize = options?.limit ?? 50;
       const idKey = options?.idKey ?? "id";
+      const cursorIdKey = options?.cursorIdKey ?? idKey;
       const customKeyForResult = options?.customKeyForResult ?? null;
       const params = options?.params ?? {};
       if ("order" in params && params["order"]) {
-        this._logger.warning("fetchList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by idKey. Use `filter` to narrow results instead.");
+        this._logger.warning("fetchList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by cursorIdKey. Use `filter` to narrow results instead.");
       }
       const { order: _ignoredOrder, ...restParams } = params;
       const requestParams = {
         ...restParams,
-        order: { [idKey]: "ASC" },
+        order: { [cursorIdKey]: "ASC" },
         filter: [...params["filter"] || []],
         pagination: { page: 0, limit: batchSize }
       };
@@ -13029,7 +13160,7 @@ ${JSON.stringify({
       let nextId = 0;
       do {
         const sendParams = { ...requestParams, filter: [...requestParams.filter] };
-        sendParams.filter.push([idKey, ">", nextId]);
+        sendParams.filter.push([cursorIdKey, ">", nextId]);
         const response = await this._b24.actions.v3.call.make({
           method: options.method,
           params: sendParams,
@@ -13063,9 +13194,11 @@ ${JSON.stringify({
           break;
         }
         const lastItem = resultData[resultData.length - 1];
-        if (lastItem && typeof lastItem[idKey] !== "undefined") {
-          nextId = Number.parseInt(lastItem[idKey]);
+        const cursorValue = lastItem ? Number.parseInt(lastItem[idKey], 10) : Number.NaN;
+        if (Number.isFinite(cursorValue)) {
+          nextId = cursorValue;
         } else {
+          this._logger.warning(`fetchList.make: pagination stops here \u2014 no numeric id could be read from the returned items via idKey "${idKey}". Make sure idKey matches the id field in the response; if the sortable field name differs from it, also set cursorIdKey (e.g. idKey: 'id', cursorIdKey: 'ID').`);
           isContinue = false;
           break;
         }
@@ -13266,11 +13399,11 @@ ${JSON.stringify({
 
   var __defProp$W = Object.defineProperty;
   var __name$W = (target, value) => __defProp$W(target, "name", { value, configurable: true });
-  const callName = Symbol("call_V3");
-  const callListName = Symbol("callList_V3");
-  const fetchListName = Symbol("fetchList_V3");
-  const batchName = Symbol("batch_V3");
-  const batchByChunkName = Symbol("batchByChunk_V3");
+  const callName = /* @__PURE__ */ Symbol("call_V3");
+  const callListName = /* @__PURE__ */ Symbol("callList_V3");
+  const fetchListName = /* @__PURE__ */ Symbol("fetchList_V3");
+  const batchName = /* @__PURE__ */ Symbol("batch_V3");
+  const batchByChunkName = /* @__PURE__ */ Symbol("batchByChunk_V3");
   class ActionsManagerV3 {
     static {
       __name$W(this, "ActionsManagerV3");
@@ -13455,8 +13588,8 @@ ${JSON.stringify({
 
   var __defProp$R = Object.defineProperty;
   var __name$R = (target, value) => __defProp$R(target, "name", { value, configurable: true });
-  const pingName = Symbol("ping");
-  const healthCheckName = Symbol("healthCheck");
+  const pingName = /* @__PURE__ */ Symbol("ping");
+  const healthCheckName = /* @__PURE__ */ Symbol("healthCheck");
   class ToolsManager {
     static {
       __name$R(this, "ToolsManager");
@@ -18616,6 +18749,12 @@ ${JSON.stringify({
     _authActions;
     _requestIdGenerator;
     _restrictionManager;
+    /**
+     * In-flight token refresh, shared so concurrent 401s coalesce into a single
+     * `refreshAuth()` round-trip — avoids OAuth refresh-token reuse errors when a
+     * burst of requests expires together. (#182)
+     */
+    _pendingRefresh = null;
     _logger;
     _isClientSideWarning = false;
     _clientSideWarningMessage = "";
@@ -18633,7 +18772,7 @@ ${JSON.stringify({
       this._logger = LoggerFactory.createNullLogger();
       const defaultHeaders = {};
       if (this.isServerSide()) {
-        defaultHeaders["User-Agent"] = "b24-js-sdk/1.2.0";
+        defaultHeaders["User-Agent"] = "b24-js-sdk/1.3.0";
       }
       this._authActions = authActions;
       this._requestIdGenerator = new RequestIdGenerator();
@@ -18884,10 +19023,27 @@ ${JSON.stringify({
       let authData = this._authActions.getAuthData();
       if (authData === false) {
         this._logRefreshingAuthToken(requestId);
-        authData = await this._authActions.refreshAuth();
+        authData = await this._refreshAuth();
       }
       return authData;
     }
+    /**
+     * Refresh the auth token, coalescing concurrent callers onto a single
+     * in-flight `refreshAuth()` so a burst of 401s triggers exactly one refresh
+     * round-trip. The slot clears once the refresh settles. (#182)
+     */
+    _refreshAuth() {
+      if (this._pendingRefresh) {
+        return this._pendingRefresh;
+      }
+      const refresh = this._authActions.refreshAuth();
+      this._pendingRefresh = refresh;
+      refresh.finally(() => {
+        this._pendingRefresh = null;
+      }).catch(() => {
+      });
+      return refresh;
+    }
     // Execute the request with 401 error handling
     async _makeRequestWithAuthRetry(requestId, method, params, authData) {
       try {
@@ -18906,14 +19062,15 @@ ${JSON.stringify({
             }
           );
         }
-        if (this._isAuthError(error)) {
+        const ajaxError = this._convertToAjaxError(requestId, error, method, params);
+        if (this._isAuthError(ajaxError)) {
           this._logAuthErrorDetected(requestId);
           this._logRefreshingAuthToken(requestId);
-          const refreshedAuthData = await this._authActions.refreshAuth();
+          const refreshedAuthData = await this._refreshAuth();
           await this._restrictionManager.checkRateLimit(requestId, method);
           return await this._makeAxiosRequest(requestId, method, params, refreshedAuthData);
         }
-        throw error;
+        throw ajaxError;
       }
     }
     async _makeAxiosRequest(requestId, method, params, authData) {
@@ -19881,7 +20038,7 @@ ${JSON.stringify({
       }
       const queryParams = new URLSearchParams({
         [this._requestIdGenerator.getQueryStringParameterName()]: requestId,
-        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.2.0",
+        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.3.0",
         [this._requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
       });
       return `${baseUrl}${methodUrl}?${queryParams.toString()}`;
@@ -20135,7 +20292,7 @@ ${JSON.stringify({
       const methodUrl = `/${encodeURIComponent(method)}`;
       const queryParams = new URLSearchParams({
         [this._requestIdGenerator.getQueryStringParameterName()]: requestId,
-        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.2.0",
+        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.3.0",
         [this._requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
       });
       return `${baseUrl}${methodUrl}?${queryParams.toString()}`;
@@ -21627,7 +21784,11 @@ ${JSON.stringify({
       });
     }
     /**
-     * Set Page Title
+     * Sets the in-layout page title (the `#pagetitle` element the portal renders around the app).
+     *
+     * Does NOT change the browser tab title (`document.title`): the portal applies this command to
+     * `#pagetitle`, never to the tab. To set the browser tab title, open the view as a slider via
+     * `SliderManager.openSliderAppPage` with a `bx24_title` option.
      *
      * @param {string} title
      *
@@ -21944,6 +22105,10 @@ ${JSON.stringify({
     /**
      * When the method is called, a pop-up window with the application frame will be opened.
      *
+     * Settings are passed via `bx24_`-prefixed keys (e.g. `bx24_title`, `bx24_width`).
+     * `bx24_title` sets the slider title; the portal also reflects it to the browser tab title
+     * (`document.title`) — unlike `ParentManager.setTitle`, which only updates the in-layout `#pagetitle`.
+     *
      * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-open-application.html
      */
     async openSliderAppPage(params = {}) {