@bitrix24/b24jssdk 1.2.0 → 1.3.0

package/dist/esm/core/version-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version-manager.mjs","sources":["../../../src/core/version-manager.ts"],"sourcesContent":["import { ApiVersion } from '../types/b24'\nimport type {\n  BatchCommandsArrayUniversal,\n  BatchCommandsObjectUniversal,\n  BatchNamedCommandsUniversal\n} from '../types/http'\nimport { ParseRow } from './interaction/batch/parse-row'\nimport { SdkError } from './sdk-error'\n\n/**\n * @todo add docs ??\n */\nclass VersionManager {\n  #supportMethods: string[]\n\n  constructor() {\n    /**\n     * get from https://{portal}/rest/api/{user_id}/{webhook}/documentation\n     * @see https://apidocs.bitrix24.com/api-reference/rest-v3/index.html#openapi\n     */\n    this.#supportMethods = [\n      '/batch', // done\n      '/scopes', // done\n      '/rest.scope.list', // done\n      '/rest.documentation.openapi',\n      '/documentation',\n      /** @see /settings/configs/event_log.php */\n      '/main.eventlog.list', // done\n      '/main.eventlog.get', // done\n      '/main.eventlog.tail', // done\n      '/tasks.task.chat.message.send',\n      '/tasks.task.access.get',\n      '/tasks.task.file.attach',\n      '/tasks.task.update', // done\n      '/tasks.task.delete',\n      '/tasks.task.add',\n      '/tasks.task.get' // done\n      // @todo When API.v3 arrives - change in AuthOAuthManager.initIsAdmin()\n      // '/profile' // waite\n      // '/main.message.get' // waite\n      // '/main.chat.update' // waite\n      // '/main.chat.list' // waite\n      // '/main.user.list' // waite\n    ]\n  }\n\n  static create(): VersionManager {\n    return new VersionManager()\n  }\n\n  /**\n   * List of supported API versions\n   * The highest version must be first\n   */\n  public getAllApiVersions(): ApiVersion[] {\n    return [ApiVersion.v3, ApiVersion.v2]\n  }\n\n  public isSupport(version: ApiVersion, method: string): boolean {\n    switch (version) {\n      case ApiVersion.v3:\n        return this.#v3Support(method)\n      case ApiVersion.v2:\n        return true\n    }\n\n    return false\n  }\n\n  #v3Support(method: string): boolean {\n    return this.#supportMethods.includes(`/${method}`)\n  }\n\n  /**\n   * Automatically obtain the API version\n   */\n  public automaticallyObtainApiVersion(method: string): ApiVersion {\n    const version = this.getAllApiVersions().find(version => versionManager.isSupport(version, method))\n    if (!version) {\n      throw new SdkError({\n        code: 'JSSDK_VERSION_MANAGER_NOT_DETECT_FOR_METHOD',\n        description: `No API version found that supports method ${method}.`,\n        status: 500\n      })\n    }\n\n    return version\n  }\n\n  /**\n   * Automatically obtain the API version for Batch\n   *\n   * @todo test methods\n   *   `[['crm.item.get', { entityTypeId: 3, id: 1 }]]`\n   *   `[{ method: 'crm.item.get', params: { entityTypeId: 3, id: 1 } }]`\n   *   `{ cmd1: { method: 'crm.item.get', params: { entityTypeId: 3, id: 1 } }, cmd2: ['crm.item.get', { entityTypeId: 2, id: 2 }] }`\n   */\n  public automaticallyObtainApiVersionForBatch(\n    calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal\n  ): ApiVersion {\n    const commands = ParseRow.getMethodsFromCommands(calls)\n\n    let isAllSupportV3 = true\n    for (const [_, method] of commands.entries()) {\n      if (!this.isSupport(ApiVersion.v3, method)) {\n        isAllSupportV3 = false\n        break\n      }\n    }\n\n    if (isAllSupportV3) {\n      return ApiVersion.v3\n    }\n    return ApiVersion.v2\n  }\n}\n\nexport const versionManager = VersionManager.create()\n"],"names":["version"],"mappings":";;;;;;;;;;;;;;AAYA,MAAM,cAAA,CAAe;AAAA,EAZrB;AAYqB,IAAA,MAAA,CAAA,IAAA,EAAA,gBAAA,CAAA;AAAA;AAAA,EACnB,eAAA;AAAA,EAEA,WAAA,GAAc;AAKZ,IAAA,IAAA,CAAK,eAAA,GAAkB;AAAA,MACrB,QAAA;AAAA;AAAA,MACA,SAAA;AAAA;AAAA,MACA,kBAAA;AAAA;AAAA,MACA,6BAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MAEA,qBAAA;AAAA;AAAA,MACA,oBAAA;AAAA;AAAA,MACA,qBAAA;AAAA;AAAA,MACA,+BAAA;AAAA,MACA,wBAAA;AAAA,MACA,yBAAA;AAAA,MACA,oBAAA;AAAA;AAAA,MACA,oBAAA;AAAA,MACA,iBAAA;AAAA,MACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAOF;AAAA,EACF;AAAA,EAEA,OAAO,MAAA,GAAyB;AAC9B,IAAA,OAAO,IAAI,cAAA,EAAe;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,iBAAA,GAAkC;AACvC,IAAA,OAAO,CAAC,UAAA,CAAW,EAAA,EAAI,UAAA,CAAW,EAAE,CAAA;AAAA,EACtC;AAAA,EAEO,SAAA,CAAU,SAAqB,MAAA,EAAyB;AAC7D,IAAA,QAAQ,OAAA;AAAS,MACf,KAAK,UAAA,CAAW,EAAA;AACd,QAAA,OAAO,IAAA,CAAK,WAAW,MAAM,CAAA;AAAA,MAC/B,KAAK,UAAA,CAAW,EAAA;AACd,QAAA,OAAO,IAAA;AAAA;AAGX,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,WAAW,MAAA,EAAyB;AAClC,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,QAAA,CAAS,CAAA,CAAA,EAAI,MAAM,CAAA,CAAE,CAAA;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKO,8BAA8B,MAAA,EAA4B;AAC/D,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,iBAAA,EAAkB,CAAE,IAAA,CAAK,CAAAA,QAAAA,KAAW,cAAA,CAAe,SAAA,CAAUA,QAAAA,EAAS,MAAM,CAAC,CAAA;AAClG,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,QAAA,CAAS;AAAA,QACjB,IAAA,EAAM,6CAAA;AAAA,QACN,WAAA,EAAa,6CAA6C,MAAM,CAAA,CAAA,CAAA;AAAA,QAChE,MAAA,EAAQ;AAAA,OACT,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUO,sCACL,KAAA,EACY;AACZ,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,sBAAA,CAAuB,KAAK,CAAA;AAEtD,IAAA,IAAI,cAAA,GAAiB,IAAA;AACrB,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,MAAM,CAAA,IAAK,QAAA,CAAS,SAAQ,EAAG;AAC5C,MAAA,IAAI,CAAC,IAAA,CAAK,SAAA,CAAU,UAAA,CAAW,EAAA,EAAI,MAAM,CAAA,EAAG;AAC1C,QAAA,cAAA,GAAiB,KAAA;AACjB,QAAA;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI,cAAA,EAAgB;AAClB,MAAA,OAAO,UAAA,CAAW,EAAA;AAAA,IACpB;AACA,IAAA,OAAO,UAAA,CAAW,EAAA;AAAA,EACpB;AACF;AAEO,MAAM,cAAA,GAAiB,eAAe,MAAA;;;;"}
+{"version":3,"file":"version-manager.mjs","sources":["../../../src/core/version-manager.ts"],"sourcesContent":["import { ApiVersion } from '../types/b24'\nimport type {\n  BatchCommandsArrayUniversal,\n  BatchCommandsObjectUniversal,\n  BatchNamedCommandsUniversal\n} from '../types/http'\nimport { ParseRow } from './interaction/batch/parse-row'\nimport { SdkError } from './sdk-error'\n\n/**\n * Decides which REST API version (v2 or v3) a method is routed through:\n * v3 only for methods on the published allowlist (`#supportMethods`); everything\n * else falls back to v2.\n */\nclass VersionManager {\n  #supportMethods: string[]\n\n  constructor() {\n    /**\n     * Mirrors the methods published under Bitrix24 REST v3 (per the module pages\n     * of apidocs rest-v3). Absences are intentional — a module exposes only what\n     * is published (e.g. `timeman` is read-only in v3: no `record.get` / `add` /\n     * `update`). Entries WITHOUT a `// done` marker are routed but not yet verified\n     * end-to-end against a live portal in this SDK.\n     *\n     * Source of truth: https://{portal}/rest/api/{user_id}/{webhook}/documentation\n     * @see https://apidocs.bitrix24.com/api-reference/rest-v3/index.html#openapi\n     */\n    this.#supportMethods = [\n      // --- infrastructure ---\n      '/batch', // done\n      '/scopes', // done\n      '/rest.scope.list', // done\n      '/rest.documentation.openapi',\n      '/documentation',\n\n      // --- main ---\n      /** @see /settings/configs/event_log.php */\n      '/main.eventlog.list', // done\n      '/main.eventlog.get', // done\n      '/main.eventlog.tail', // done\n      '/main.eventlog.field.list',\n      '/main.eventlog.field.get',\n\n      // --- mail (rest-v3) ---\n      '/mail.mailbox.list',\n      '/mail.mailbox.get',\n      '/mail.mailbox.senders',\n      '/mail.mailbox.field.list',\n      '/mail.mailbox.field.get',\n      '/mail.message.list',\n      '/mail.message.get',\n      '/mail.message.thread',\n      '/mail.message.send',\n      '/mail.message.reply',\n      '/mail.message.forward',\n      '/mail.message.movetofolder',\n      '/mail.message.createcrmactivity',\n      '/mail.message.removecrmactivity',\n      '/mail.message.createtask',\n      '/mail.message.createcalendarevent',\n      '/mail.message.createchat',\n      '/mail.message.createfeedpost',\n      '/mail.message.field.list',\n      '/mail.message.field.get',\n      '/mail.recipient.listcontacts',\n      '/mail.recipient.listemployees',\n      '/mail.recipient.field.list',\n      '/mail.recipient.field.get',\n\n      // --- humanresources (rest-v3) ---\n      '/humanresources.node.add',\n      '/humanresources.node.edit',\n      '/humanresources.node.get',\n      '/humanresources.node.list',\n      '/humanresources.node.search',\n      '/humanresources.node.children',\n      '/humanresources.node.count',\n      '/humanresources.node.move',\n      '/humanresources.node.field.list',\n      '/humanresources.node.field.get',\n      '/humanresources.node.member.add',\n      '/humanresources.node.member.set',\n      '/humanresources.node.member.move',\n      '/humanresources.node.member.remove',\n      '/humanresources.node.communication.edit',\n      '/humanresources.node.communication.list',\n      '/humanresources.employee.search',\n      '/humanresources.employee.subordinates',\n      '/humanresources.employee.count',\n      '/humanresources.employee.multidepartment',\n      '/humanresources.employee.field.list',\n      '/humanresources.employee.field.get',\n\n      // --- tasks (rest-v3) ---\n      '/tasks.task.add',\n      '/tasks.task.get', // done\n      '/tasks.task.update', // done\n      '/tasks.task.delete',\n      '/tasks.task.access.get',\n      '/tasks.task.file.attach',\n      '/tasks.task.chat.message.send',\n      '/tasks.task.result.add',\n      '/tasks.task.result.addfromchatmessage',\n      '/tasks.task.result.update',\n      '/tasks.task.result.list',\n      '/tasks.task.result.delete',\n      '/tasks.task.field.list',\n      '/tasks.task.field.get',\n      '/tasks.task.access.field.list',\n      '/tasks.task.access.field.get',\n      '/tasks.task.file.field.list',\n      '/tasks.task.file.field.get',\n      '/tasks.task.chat.message.field.list',\n      '/tasks.task.chat.message.field.get',\n\n      // --- timeman (rest-v3) — read-only in v3 (no record.get / add / update / delete) ---\n      '/timeman.record.list',\n      '/timeman.record.field.list',\n      '/timeman.record.field.get'\n\n      // Cross-module methods are cross-referenced from the rest-v3 pages above but\n      // belong to modules not actualized here — add them when those modules land:\n      //   user.get                                          — user module (seen on humanresources + timeman)\n      //   im.message.update / im.message.delete / im.dialog.messages.get  — im module (seen on tasks)\n      //   disk.storage.uploadfile / disk.folder.uploadfile /\n      //   disk.storage.getchildren / disk.folder.getchildren            — disk module (seen on tasks)\n      //\n      // @todo When API.v3 arrives - change in AuthOAuthManager.initIsAdmin()\n      // '/profile' // wait\n      // '/main.message.get' // wait\n      // '/main.chat.update' // wait\n      // '/main.chat.list' // wait\n      // '/main.user.list' // wait\n    ]\n  }\n\n  static create(): VersionManager {\n    return new VersionManager()\n  }\n\n  /**\n   * List of supported API versions\n   * The highest version must be first\n   */\n  public getAllApiVersions(): ApiVersion[] {\n    return [ApiVersion.v3, ApiVersion.v2]\n  }\n\n  public isSupport(version: ApiVersion, method: string): boolean {\n    switch (version) {\n      case ApiVersion.v3:\n        return this.#v3Support(method)\n      case ApiVersion.v2:\n        return true\n    }\n\n    return false\n  }\n\n  #v3Support(method: string): boolean {\n    return this.#supportMethods.includes(`/${method}`)\n  }\n\n  /**\n   * Automatically obtain the API version\n   */\n  public automaticallyObtainApiVersion(method: string): ApiVersion {\n    const version = this.getAllApiVersions().find(version => versionManager.isSupport(version, method))\n    if (!version) {\n      throw new SdkError({\n        code: 'JSSDK_VERSION_MANAGER_NOT_DETECT_FOR_METHOD',\n        description: `No API version found that supports method ${method}.`,\n        status: 500\n      })\n    }\n\n    return version\n  }\n\n  /**\n   * Automatically obtain the API version for Batch\n   *\n   * @todo test methods\n   *   `[['crm.item.get', { entityTypeId: 3, id: 1 }]]`\n   *   `[{ method: 'crm.item.get', params: { entityTypeId: 3, id: 1 } }]`\n   *   `{ cmd1: { method: 'crm.item.get', params: { entityTypeId: 3, id: 1 } }, cmd2: ['crm.item.get', { entityTypeId: 2, id: 2 }] }`\n   */\n  public automaticallyObtainApiVersionForBatch(\n    calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal\n  ): ApiVersion {\n    const commands = ParseRow.getMethodsFromCommands(calls)\n\n    let isAllSupportV3 = true\n    for (const [_, method] of commands.entries()) {\n      if (!this.isSupport(ApiVersion.v3, method)) {\n        isAllSupportV3 = false\n        break\n      }\n    }\n\n    if (isAllSupportV3) {\n      return ApiVersion.v3\n    }\n    return ApiVersion.v2\n  }\n}\n\nexport const versionManager = VersionManager.create()\n"],"names":["version"],"mappings":"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"}

package/dist/esm/frame/auth.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/frame/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/frame/dialog.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/frame/frame.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/frame/message/commands.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/frame/message/controller.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/frame/options.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/frame/parent.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
@@ -159,7 +159,11 @@ class ParentManager {
     });
   }
   /**
-   * 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
    *

package/dist/esm/frame/parent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parent.mjs","sources":["../../../src/frame/parent.ts"],"sourcesContent":["import type { MessageManager } from './message'\nimport { MessageCommands } from './message'\nimport useScrollSize from '../tools/scroll-size'\n\n/**\n * Parent window manager\n *\n * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/\n */\nexport class ParentManager {\n  #messageManager: MessageManager\n\n  constructor(messageManager: MessageManager) {\n    this.#messageManager = messageManager\n  }\n\n  get message(): MessageManager {\n    return this.#messageManager\n  }\n\n  /**\n   * The method closes the open modal window with the application\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-close-application.html\n   */\n  async closeApplication(): Promise<void> {\n    return this.#messageManager.send(MessageCommands.closeApplication, {\n      /**\n       * @memo There is no point - everything will be closed, and timeout will not be able to do anything\n       */\n      isSafely: false\n    })\n  }\n\n  /**\n   * Sets the size of the frame containing the application to the size of the frame's content.\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-fit-window.html\n   *\n   * @memo in certain situations it may not be executed (placement of the main window after installing the application), in this case isSafely mode will work\n   */\n  async fitWindow(): Promise<any> {\n    const width = '100%'\n    const height = this.getScrollSize().scrollHeight\n\n    return this.#messageManager.send(MessageCommands.resizeWindow, {\n      width,\n      height,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Sets the size of the frame containing the application to the size of the frame's content.\n   *\n   * @param {number} width\n   * @param {number} height\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-resize-window.html\n   *\n   * @memo in certain situations it may not be executed, in this case isSafely mode will be triggered\n   */\n  async resizeWindow(width: number, height: number): Promise<void> {\n    if (width > 0 && height > 0) {\n      return this.#messageManager.send(MessageCommands.resizeWindow, {\n        width,\n        height,\n        isSafely: true\n      })\n    }\n\n    return Promise.reject(\n      new Error(`Wrong width:number = ${width} or height:number = ${height}`)\n    )\n  }\n\n  /**\n   * Automatically resize `document.body` of frame with application according to frame content dimensions\n   * If you pass appNode, the height will be calculated relative to it\n   *\n   * @param {HTMLElement|null} appNode\n   * @param {number} minHeight\n   * @param {number} minWidth\n   *\n   * @return {Promise<void>}\n   */\n  async resizeWindowAuto(\n    appNode: null | HTMLElement = null,\n    minHeight: number = 0,\n    minWidth: number = 0\n  ): Promise<void> {\n    const body = document.body\n    // const html = document.documentElement\n\n    let width = Math.max(\n      body.scrollWidth,\n      body.offsetWidth\n\n      // html.clientWidth,\n      // html.scrollWidth,\n      // html.offsetWidth\n    )\n\n    if (minWidth > 0) {\n      width = Math.max(minWidth, width)\n    }\n\n    let height = Math.max(\n      body.scrollHeight,\n      body.offsetHeight\n\n      // html.clientHeight,\n      // html.scrollHeight,\n      // html.offsetHeight\n    )\n\n    if (appNode) {\n      height = Math.max(appNode.scrollHeight, appNode.offsetHeight)\n    }\n\n    if (minHeight > 0) {\n      height = Math.max(minHeight, height)\n    }\n\n    return this.resizeWindow(width, height)\n  }\n\n  /**\n   * This function returns the inner dimensions of the application frame\n   *\n   * @return {Promise<{scrollWidth: number; scrollHeight: number}>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-get-scroll-size.html\n   */\n  getScrollSize(): {\n    scrollWidth: number\n    scrollHeight: number\n  } {\n    return useScrollSize()\n  }\n\n  /**\n   * Scrolls the parent window\n   *\n   * @param {number} scroll should specify the vertical scrollbar position (0 - scroll to the very top)\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-scroll-parent-window.html\n   */\n  async scrollParentWindow(scroll: number): Promise<void> {\n    if (!Number.isInteger(scroll)) {\n      return Promise.reject(new Error('Wrong scroll number'))\n    }\n\n    if (scroll < 0) {\n      scroll = 0\n    }\n\n    return this.#messageManager.send(MessageCommands.setScroll, {\n      scroll,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Reload the page with the application (the whole page, not just the frame).\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-reload-window.html\n   */\n  async reloadWindow(): Promise<void> {\n    return this.#messageManager.send(MessageCommands.reloadWindow, {\n      isSafely: true\n    })\n  }\n\n  /**\n   * Set Page Title\n   *\n   * @param {string} title\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-set-title.html\n   */\n  async setTitle(title: string): Promise<void> {\n    return this.#messageManager.send(MessageCommands.setTitle, {\n      title: title.toString(),\n      isSafely: true\n    })\n  }\n\n  /**\n   * Initiates a call via internal communication\n   *\n   * @param {number} userId The identifier of the account user\n   * @param {boolean} isVideo true - video call, false - audio call. Optional parameter.\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-call-to.html\n   */\n  async imCallTo(userId: number, isVideo: boolean = true): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imCallTo, {\n      userId,\n      video: isVideo,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Makes a call to the phone number\n   *\n   * @param {string} phone Phone number. The number can be in the format: `+44 20 1234 5678` or `x (xxx) xxx-xx-xx`\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-phone-to.html\n   */\n  async imPhoneTo(phone: string): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imPhoneTo, {\n      phone,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Opens the messenger window\n   * userId or chatXXX - chat, where XXX is the chat identifier, which can simply be a number.\n   * sgXXX - group chat, where XXX is the social network group number (the chat must be enabled in this group).\n   *\n   * XXXX** - open line, where XXX is the code obtained via the Rest method imopenlines.network.join.\n   *\n   * If nothing is passed, the chat interface will open with the last opened dialog.\n   *\n   * @param {number|`chat${number}`|`sg${number}`|`imol|${number}`|undefined} dialogId\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-open-messenger.html\n   * @link https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=93&LESSON_ID=20152&LESSON_PATH=7657.7883.8025.20150.20152\n   *\n   */\n  async imOpenMessenger(\n    dialogId:\n      | number\n      | `chat${number}`\n      | `sg${number}`\n      | `imol|${number}`\n      | undefined\n  ): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imOpenMessenger, {\n      dialogId: dialogId,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Opens the history window\n   * Identifier of the dialog:\n   *\n   * userId or chatXXX - chat, where XXX is the chat identifier, which can simply be a number.\n   * imol|XXXX - open line, where XXX is the session number of the open line.\n   *\n   * @param {number|`chat${number}`|`imol|${number}`} dialogId\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-open-history.html\n   */\n  async imOpenHistory(\n    dialogId: number | `chat${number}` | `imol|${number}`\n  ): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imOpenHistory, {\n      dialogId: dialogId,\n      isSafely: true\n    })\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"parent.mjs","sources":["../../../src/frame/parent.ts"],"sourcesContent":["import type { MessageManager } from './message'\nimport { MessageCommands } from './message'\nimport useScrollSize from '../tools/scroll-size'\n\n/**\n * Parent window manager\n *\n * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/\n */\nexport class ParentManager {\n  #messageManager: MessageManager\n\n  constructor(messageManager: MessageManager) {\n    this.#messageManager = messageManager\n  }\n\n  get message(): MessageManager {\n    return this.#messageManager\n  }\n\n  /**\n   * The method closes the open modal window with the application\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-close-application.html\n   */\n  async closeApplication(): Promise<void> {\n    return this.#messageManager.send(MessageCommands.closeApplication, {\n      /**\n       * @memo There is no point - everything will be closed, and timeout will not be able to do anything\n       */\n      isSafely: false\n    })\n  }\n\n  /**\n   * Sets the size of the frame containing the application to the size of the frame's content.\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-fit-window.html\n   *\n   * @memo in certain situations it may not be executed (placement of the main window after installing the application), in this case isSafely mode will work\n   */\n  async fitWindow(): Promise<any> {\n    const width = '100%'\n    const height = this.getScrollSize().scrollHeight\n\n    return this.#messageManager.send(MessageCommands.resizeWindow, {\n      width,\n      height,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Sets the size of the frame containing the application to the size of the frame's content.\n   *\n   * @param {number} width\n   * @param {number} height\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-resize-window.html\n   *\n   * @memo in certain situations it may not be executed, in this case isSafely mode will be triggered\n   */\n  async resizeWindow(width: number, height: number): Promise<void> {\n    if (width > 0 && height > 0) {\n      return this.#messageManager.send(MessageCommands.resizeWindow, {\n        width,\n        height,\n        isSafely: true\n      })\n    }\n\n    return Promise.reject(\n      new Error(`Wrong width:number = ${width} or height:number = ${height}`)\n    )\n  }\n\n  /**\n   * Automatically resize `document.body` of frame with application according to frame content dimensions\n   * If you pass appNode, the height will be calculated relative to it\n   *\n   * @param {HTMLElement|null} appNode\n   * @param {number} minHeight\n   * @param {number} minWidth\n   *\n   * @return {Promise<void>}\n   */\n  async resizeWindowAuto(\n    appNode: null | HTMLElement = null,\n    minHeight: number = 0,\n    minWidth: number = 0\n  ): Promise<void> {\n    const body = document.body\n    // const html = document.documentElement\n\n    let width = Math.max(\n      body.scrollWidth,\n      body.offsetWidth\n\n      // html.clientWidth,\n      // html.scrollWidth,\n      // html.offsetWidth\n    )\n\n    if (minWidth > 0) {\n      width = Math.max(minWidth, width)\n    }\n\n    let height = Math.max(\n      body.scrollHeight,\n      body.offsetHeight\n\n      // html.clientHeight,\n      // html.scrollHeight,\n      // html.offsetHeight\n    )\n\n    if (appNode) {\n      height = Math.max(appNode.scrollHeight, appNode.offsetHeight)\n    }\n\n    if (minHeight > 0) {\n      height = Math.max(minHeight, height)\n    }\n\n    return this.resizeWindow(width, height)\n  }\n\n  /**\n   * This function returns the inner dimensions of the application frame\n   *\n   * @return {Promise<{scrollWidth: number; scrollHeight: number}>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-get-scroll-size.html\n   */\n  getScrollSize(): {\n    scrollWidth: number\n    scrollHeight: number\n  } {\n    return useScrollSize()\n  }\n\n  /**\n   * Scrolls the parent window\n   *\n   * @param {number} scroll should specify the vertical scrollbar position (0 - scroll to the very top)\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-scroll-parent-window.html\n   */\n  async scrollParentWindow(scroll: number): Promise<void> {\n    if (!Number.isInteger(scroll)) {\n      return Promise.reject(new Error('Wrong scroll number'))\n    }\n\n    if (scroll < 0) {\n      scroll = 0\n    }\n\n    return this.#messageManager.send(MessageCommands.setScroll, {\n      scroll,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Reload the page with the application (the whole page, not just the frame).\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-reload-window.html\n   */\n  async reloadWindow(): Promise<void> {\n    return this.#messageManager.send(MessageCommands.reloadWindow, {\n      isSafely: true\n    })\n  }\n\n  /**\n   * Sets the in-layout page title (the `#pagetitle` element the portal renders around the app).\n   *\n   * Does NOT change the browser tab title (`document.title`): the portal applies this command to\n   * `#pagetitle`, never to the tab. To set the browser tab title, open the view as a slider via\n   * `SliderManager.openSliderAppPage` with a `bx24_title` option.\n   *\n   * @param {string} title\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-set-title.html\n   */\n  async setTitle(title: string): Promise<void> {\n    return this.#messageManager.send(MessageCommands.setTitle, {\n      title: title.toString(),\n      isSafely: true\n    })\n  }\n\n  /**\n   * Initiates a call via internal communication\n   *\n   * @param {number} userId The identifier of the account user\n   * @param {boolean} isVideo true - video call, false - audio call. Optional parameter.\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-call-to.html\n   */\n  async imCallTo(userId: number, isVideo: boolean = true): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imCallTo, {\n      userId,\n      video: isVideo,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Makes a call to the phone number\n   *\n   * @param {string} phone Phone number. The number can be in the format: `+44 20 1234 5678` or `x (xxx) xxx-xx-xx`\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-phone-to.html\n   */\n  async imPhoneTo(phone: string): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imPhoneTo, {\n      phone,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Opens the messenger window\n   * userId or chatXXX - chat, where XXX is the chat identifier, which can simply be a number.\n   * sgXXX - group chat, where XXX is the social network group number (the chat must be enabled in this group).\n   *\n   * XXXX** - open line, where XXX is the code obtained via the Rest method imopenlines.network.join.\n   *\n   * If nothing is passed, the chat interface will open with the last opened dialog.\n   *\n   * @param {number|`chat${number}`|`sg${number}`|`imol|${number}`|undefined} dialogId\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-open-messenger.html\n   * @link https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=93&LESSON_ID=20152&LESSON_PATH=7657.7883.8025.20150.20152\n   *\n   */\n  async imOpenMessenger(\n    dialogId:\n      | number\n      | `chat${number}`\n      | `sg${number}`\n      | `imol|${number}`\n      | undefined\n  ): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imOpenMessenger, {\n      dialogId: dialogId,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Opens the history window\n   * Identifier of the dialog:\n   *\n   * userId or chatXXX - chat, where XXX is the chat identifier, which can simply be a number.\n   * imol|XXXX - open line, where XXX is the session number of the open line.\n   *\n   * @param {number|`chat${number}`|`imol|${number}`} dialogId\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-open-history.html\n   */\n  async imOpenHistory(\n    dialogId: number | `chat${number}` | `imol|${number}`\n  ): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imOpenHistory, {\n      dialogId: dialogId,\n      isSafely: true\n    })\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/frame/placement.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/frame/slider.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
@@ -35,6 +35,10 @@ class SliderManager {
   /**
    * 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 = {}) {

package/dist/esm/frame/slider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"slider.mjs","sources":["../../../src/frame/slider.ts"],"sourcesContent":["import type { AppFrame } from './frame'\nimport type { MessageManager } from './message'\nimport { MessageCommands } from './message'\nimport type { StatusClose } from '../types/slider'\n\n/**\n * Sliders Manager\n */\nexport class SliderManager {\n  #appFrame: AppFrame\n  #messageManager: MessageManager\n\n  constructor(appFrame: AppFrame, messageManager: MessageManager) {\n    this.#appFrame = appFrame\n    this.#messageManager = messageManager\n  }\n\n  /**\n   * Returns the URL relative to the domain name and path\n   */\n  getUrl(path: string = '/'): URL {\n    return new URL(path, this.#appFrame.getTargetOrigin())\n  }\n\n  /**\n   * Get the account address BX24\n   */\n  getTargetOrigin(): string {\n    return this.#appFrame.getTargetOrigin()\n  }\n\n  /**\n   * When the method is called, a pop-up window with the application frame will be opened.\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-open-application.html\n   */\n  async openSliderAppPage(params: any = {}): Promise<any> {\n    return this.#messageManager.send(MessageCommands.openApplication, params)\n  }\n\n  /**\n   * The method closes the open modal window with the application\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-close-application.html\n   */\n  async closeSliderAppPage(): Promise<void> {\n    return this.#messageManager.send(MessageCommands.closeApplication, {\n      /**\n       * @memo There is no point - everything will be closed, and timeout will not be able to do anything\n       */\n      isSafely: false\n    })\n  }\n\n  /**\n   * Defines the base path for width sampling.\n   *\n   * @param width\n   * @private\n   */\n  #getBaseUrlByWidth(width: number = 1640): string {\n    if (width > 0) {\n      // region Init baseUrl by Width ////\n      if (width > 1200 && width <= 1640) {\n        return '/crm/type/0/details/0/../../../../..'\n      } else if (width > 950 && width <= 1200) {\n        return '/company/personal/user/0/groups/create/../../../../../..'\n      } else if (width > 900 && width <= 950) {\n        return '/crm/company/requisite/0/../../../..'\n      } else if (width <= 900) {\n        return '/workgroups/group/0/card/../../../..'\n      } else {\n        // 1640 /////\n        return '/crm/deal/../..'\n      }\n      // endregion ////\n    } else {\n      return '/crm/deal/../..'\n    }\n  }\n\n  /**\n   * Opens the specified path inside the portal in the slider.\n   * @param {URL} url\n   * @param {number} width - Number in the range from 1640 to 1200, from 1200 to 950, from 950 to 900, from 900 ...\n   * @return {Promise<StatusClose>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-open-path.html\n   * @memo /^\\/(crm\\/(deal|lead|contact|company|type)|marketplace|company\\/personal\\/user\\/[0-9]+|workgroups\\/group\\/[0-9]+)\\//\n   */\n  async openPath(url: URL, width: number = 1640): Promise<StatusClose> {\n    const openSliderUrl = new URL(url)\n    openSliderUrl.searchParams.set('IFRAME', 'Y')\n    openSliderUrl.searchParams.set('IFRAME_TYPE', 'SIDE_SLIDER')\n\n    /**\n     * We are trying to open the slider\n     */\n    return this.#messageManager\n      .send(MessageCommands.openPath, {\n        path: [\n          this.#getBaseUrlByWidth(width),\n          openSliderUrl.pathname,\n          openSliderUrl.search\n        ].join('')\n      })\n      .then((response) => {\n        /**\n         * Error handling\n         */\n        if (response?.result === 'error') {\n          /**\n           * If the error is related to using a mobile device, we will open it in a new tab\n           * Let's wait 5 minutes - and return the promise to open and not close\n           */\n          if (response?.errorCode === 'METHOD_NOT_SUPPORTED_ON_DEVICE') {\n            return new Promise((resolve, reject) => {\n              const windowObjectReference = window.open(url, '_blank')\n              if (!windowObjectReference) {\n                reject(new Error('Error open window'))\n                return\n              }\n\n              let iterator = 0\n              // 5 min ////\n              const iteratorMax = 1_000 * 60 * 5\n              const waitCloseWindow = window.setInterval(() => {\n                iterator = iterator + 1\n\n                if (windowObjectReference.closed) {\n                  clearInterval(waitCloseWindow)\n                  resolve({\n                    isOpenAtNewWindow: true,\n                    isClose: true\n                  })\n                } else if (iterator > iteratorMax) {\n                  clearInterval(waitCloseWindow)\n                  resolve({\n                    isOpenAtNewWindow: true,\n                    isClose: false\n                  })\n                }\n              }, 1_000)\n            })\n          } else {\n            /**\n             * If the error is different, we will return it.\n             */\n            return Promise.reject(new Error(response?.errorCode))\n          }\n        } else if (response?.result === 'close') {\n          /**\n           * Processing a successful close\n           */\n          return Promise.resolve({\n            isOpenAtNewWindow: false,\n            isClose: true\n          })\n        }\n\n        return Promise.resolve({\n          isOpenAtNewWindow: false,\n          isClose: false\n        })\n      })\n  }\n\n  /**\n   * @todo test this and remove\n   */\n  // async showAppForm(params: any): Promise<void> {\n  //   console.warn(`deprecated showAppForm`)\n  //   return this.#messageManager.send(MessageCommands.showAppForm, {\n  //     params: params,\n  //     isSafely: true\n  //   })\n  // }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"slider.mjs","sources":["../../../src/frame/slider.ts"],"sourcesContent":["import type { AppFrame } from './frame'\nimport type { MessageManager } from './message'\nimport { MessageCommands } from './message'\nimport type { StatusClose } from '../types/slider'\n\n/**\n * Sliders Manager\n */\nexport class SliderManager {\n  #appFrame: AppFrame\n  #messageManager: MessageManager\n\n  constructor(appFrame: AppFrame, messageManager: MessageManager) {\n    this.#appFrame = appFrame\n    this.#messageManager = messageManager\n  }\n\n  /**\n   * Returns the URL relative to the domain name and path\n   */\n  getUrl(path: string = '/'): URL {\n    return new URL(path, this.#appFrame.getTargetOrigin())\n  }\n\n  /**\n   * Get the account address BX24\n   */\n  getTargetOrigin(): string {\n    return this.#appFrame.getTargetOrigin()\n  }\n\n  /**\n   * When the method is called, a pop-up window with the application frame will be opened.\n   *\n   * Settings are passed via `bx24_`-prefixed keys (e.g. `bx24_title`, `bx24_width`).\n   * `bx24_title` sets the slider title; the portal also reflects it to the browser tab title\n   * (`document.title`) — unlike `ParentManager.setTitle`, which only updates the in-layout `#pagetitle`.\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-open-application.html\n   */\n  async openSliderAppPage(params: any = {}): Promise<any> {\n    return this.#messageManager.send(MessageCommands.openApplication, params)\n  }\n\n  /**\n   * The method closes the open modal window with the application\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-close-application.html\n   */\n  async closeSliderAppPage(): Promise<void> {\n    return this.#messageManager.send(MessageCommands.closeApplication, {\n      /**\n       * @memo There is no point - everything will be closed, and timeout will not be able to do anything\n       */\n      isSafely: false\n    })\n  }\n\n  /**\n   * Defines the base path for width sampling.\n   *\n   * @param width\n   * @private\n   */\n  #getBaseUrlByWidth(width: number = 1640): string {\n    if (width > 0) {\n      // region Init baseUrl by Width ////\n      if (width > 1200 && width <= 1640) {\n        return '/crm/type/0/details/0/../../../../..'\n      } else if (width > 950 && width <= 1200) {\n        return '/company/personal/user/0/groups/create/../../../../../..'\n      } else if (width > 900 && width <= 950) {\n        return '/crm/company/requisite/0/../../../..'\n      } else if (width <= 900) {\n        return '/workgroups/group/0/card/../../../..'\n      } else {\n        // 1640 /////\n        return '/crm/deal/../..'\n      }\n      // endregion ////\n    } else {\n      return '/crm/deal/../..'\n    }\n  }\n\n  /**\n   * Opens the specified path inside the portal in the slider.\n   * @param {URL} url\n   * @param {number} width - Number in the range from 1640 to 1200, from 1200 to 950, from 950 to 900, from 900 ...\n   * @return {Promise<StatusClose>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-open-path.html\n   * @memo /^\\/(crm\\/(deal|lead|contact|company|type)|marketplace|company\\/personal\\/user\\/[0-9]+|workgroups\\/group\\/[0-9]+)\\//\n   */\n  async openPath(url: URL, width: number = 1640): Promise<StatusClose> {\n    const openSliderUrl = new URL(url)\n    openSliderUrl.searchParams.set('IFRAME', 'Y')\n    openSliderUrl.searchParams.set('IFRAME_TYPE', 'SIDE_SLIDER')\n\n    /**\n     * We are trying to open the slider\n     */\n    return this.#messageManager\n      .send(MessageCommands.openPath, {\n        path: [\n          this.#getBaseUrlByWidth(width),\n          openSliderUrl.pathname,\n          openSliderUrl.search\n        ].join('')\n      })\n      .then((response) => {\n        /**\n         * Error handling\n         */\n        if (response?.result === 'error') {\n          /**\n           * If the error is related to using a mobile device, we will open it in a new tab\n           * Let's wait 5 minutes - and return the promise to open and not close\n           */\n          if (response?.errorCode === 'METHOD_NOT_SUPPORTED_ON_DEVICE') {\n            return new Promise((resolve, reject) => {\n              const windowObjectReference = window.open(url, '_blank')\n              if (!windowObjectReference) {\n                reject(new Error('Error open window'))\n                return\n              }\n\n              let iterator = 0\n              // 5 min ////\n              const iteratorMax = 1_000 * 60 * 5\n              const waitCloseWindow = window.setInterval(() => {\n                iterator = iterator + 1\n\n                if (windowObjectReference.closed) {\n                  clearInterval(waitCloseWindow)\n                  resolve({\n                    isOpenAtNewWindow: true,\n                    isClose: true\n                  })\n                } else if (iterator > iteratorMax) {\n                  clearInterval(waitCloseWindow)\n                  resolve({\n                    isOpenAtNewWindow: true,\n                    isClose: false\n                  })\n                }\n              }, 1_000)\n            })\n          } else {\n            /**\n             * If the error is different, we will return it.\n             */\n            return Promise.reject(new Error(response?.errorCode))\n          }\n        } else if (response?.result === 'close') {\n          /**\n           * Processing a successful close\n           */\n          return Promise.resolve({\n            isOpenAtNewWindow: false,\n            isClose: true\n          })\n        }\n\n        return Promise.resolve({\n          isOpenAtNewWindow: false,\n          isClose: false\n        })\n      })\n  }\n\n  /**\n   * @todo test this and remove\n   */\n  // async showAppForm(params: any): Promise<void> {\n  //   console.warn(`deprecated showAppForm`)\n  //   return this.#messageManager.send(MessageCommands.showAppForm, {\n  //     params: params,\n  //     isSafely: true\n  //   })\n  // }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/helper/abstract-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/helper/app-manager.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/helper/currency-manager.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/helper/helper-manager.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/helper/license-manager.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/helper/options-manager.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/helper/payment-manager.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/helper/profile-manager.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/helper/use-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/hook/auth.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/hook/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/index.d.mts

@@ -1006,6 +1006,7 @@ interface IResult<T = any> {
      * Retrieves an iterator for the errors collected in the result.
      *
      * @returns {IterableIterator<Error>} An iterator over the stored Error objects.
+     * @see {@link IResult.getErrorsByKey} — keeps the request keys.
      */
     getErrors: () => IterableIterator<Error>;
     /**
@@ -1014,6 +1015,21 @@ interface IResult<T = any> {
      * @returns {string[]} An array of strings representing the error messages.
      */
     getErrorMessages: () => string[];
+    /**
+     * Retrieves all errors keyed by their identifier (e.g. the batch request key),
+     * preserving which request produced each error. Unlike {@link getErrors}, the
+     * keys are not discarded — useful for batch calls with `isHaltOnError: false`.
+     *
+     * @returns {Record<string, Error>} A map of error key to Error object.
+     */
+    getErrorsByKey: () => Record<string, Error>;
+    /**
+     * Retrieves all error messages keyed by their identifier (e.g. the batch
+     * request key). Unlike {@link getErrorMessages}, the keys are preserved.
+     *
+     * @returns {Record<string, string>} A map of error key to error message.
+     */
+    getErrorMessagesByKey: () => Record<string, string>;
     /**
      * Checks for an error in a collection by key
      * @param key - Error key
@@ -1050,6 +1066,27 @@ declare class Result<T = any> implements IResult<T> {
      *          contains the message of a corresponding error object.
      */
     getErrorMessages(): string[];
+    /**
+     * 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(): Record<string, Error>;
+    /**
+     * 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(): Record<string, string>;
     /**
      * Converts the Result object to a string.
      *
@@ -1465,6 +1502,7 @@ type ActionCallListV2 = ActionOptions & {
     method: string;
     params?: Omit<TypeCallParams, 'start' | 'order'>;
     idKey?: string;
+    cursorIdKey?: string;
     customKeyForResult?: string;
     requestId?: string;
 };
@@ -1481,12 +1519,16 @@ declare class CallListV2 extends AbstractAction {
      *
      * @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.
@@ -1528,6 +1570,7 @@ type ActionFetchListV2 = ActionOptions & {
     method: string;
     params?: Omit<TypeCallParams, 'start' | 'order'>;
     idKey?: string;
+    cursorIdKey?: string;
     customKeyForResult?: string;
     requestId?: string;
 };
@@ -1545,12 +1588,16 @@ declare class FetchListV2 extends AbstractAction {
      *
      * @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.
@@ -1833,6 +1880,7 @@ type ActionCallListV3 = ActionOptions & {
     method: string;
     params?: Omit<TypeCallParams, 'pagination' | 'order'>;
     idKey?: string;
+    cursorIdKey?: string;
     customKeyForResult: string;
     requestId?: string;
     limit?: number;
@@ -1850,11 +1898,15 @@ declare class CallListV3 extends AbstractAction {
      *
      * @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.
@@ -1896,6 +1948,7 @@ type ActionFetchListV3 = ActionOptions & {
     method: string;
     params?: Omit<TypeCallParams, 'pagination' | 'order'>;
     idKey?: string;
+    cursorIdKey?: string;
     customKeyForResult: string;
     requestId?: string;
     limit?: number;
@@ -1914,11 +1967,15 @@ declare class FetchListV3 extends AbstractAction {
      *
      * @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.
@@ -4053,7 +4110,9 @@ declare class RestrictionManager {
 }
 
 /**
- * @todo add docs ??
+ * Decides which REST API version (v2 or v3) a method is routed through:
+ * v3 only for methods on the published allowlist (`#supportMethods`); everything
+ * else falls back to v2.
  */
 declare class VersionManager {
     #private;
@@ -4226,6 +4285,12 @@ declare abstract class AbstractHttp implements TypeHttp {
     protected _authActions: AuthActions;
     protected _requestIdGenerator: RequestIdGenerator;
     protected _restrictionManager: 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)
+     */
+    protected _pendingRefresh: Promise<AuthData> | null;
     protected _logger: LoggerInterface;
     protected _isClientSideWarning: boolean;
     protected _clientSideWarningMessage: string;
@@ -4298,6 +4363,12 @@ declare abstract class AbstractHttp implements TypeHttp {
      */
     protected _executeSingleCall<T = unknown>(requestId: string, method: string, params: TypeCallParams): Promise<AjaxResult<T>>;
     protected _ensureAuth(requestId: string): Promise<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)
+     */
+    protected _refreshAuth(): Promise<AuthData>;
     protected _makeRequestWithAuthRetry<T>(requestId: string, method: string, params: TypeCallParams, authData: AuthData): Promise<AjaxResponse<T>>;
     protected _makeAxiosRequest<T>(requestId: string, method: string, params: TypeCallParams, authData: AuthData): Promise<AjaxResponse<T>>;
     protected _isAuthError(error: unknown): boolean;
@@ -4785,7 +4856,11 @@ declare class ParentManager {
      */
     reloadWindow(): Promise<void>;
     /**
-     * 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
      *
@@ -5060,6 +5135,10 @@ declare class SliderManager {
     /**
      * 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
      */
     openSliderAppPage(params?: any): Promise<any>;