@bitrix24/b24jssdk 1.0.6 → 1.1.1

package/dist/esm/frame/dialog.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.0.6
+ * @version 1.1.1
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -58,19 +58,59 @@ class DialogManager {
     });
   }
   /**
-   * Method invokes the system dialog for selecting a CRM entity
+   * Invokes the system dialog for selecting CRM entities
+   * (leads, contacts, companies, deals, quotes).
    *
-   * @param {SelectCRMParams} params
-   * @return {Promise<SelectedCRM>}
+   * The resolved `SelectedCRM` object contains a separate bucket per
+   * entity type. Each present bucket is a real `Array`, so consumers can
+   * use `.length`, `.map()`, `for..of`, etc. directly. Buckets for entity
+   * types that were not selected (or not requested via `entityType`) are
+   * left `undefined` rather than being set to an empty array.
+   *
+   * Note: the parent window historically returned each bucket as a
+   * `Record<string, SelectedCRMEntity>` (e.g. `{ 0: {...}, 1: {...} }`).
+   * The SDK normalizes that response to a real array before returning it.
+   *
+   * @param {SelectCRMParams} [params] - Filter and behavior options.
+   *   - `entityType`: which entity types are shown in the dialog.
+   *   - `multiple`: allow multiple selection (default `false`).
+   *   - `value`: pre-selected entities (only applied when `multiple` is `true`).
+   * @return {Promise<SelectedCRM>} Resolves to an object whose properties
+   *   (`lead`, `contact`, `company`, `deal`, `quote`) are arrays of
+   *   {@link SelectedCRMEntity} objects.
    *
    * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-crm.html
    */
   async selectCRM(params) {
-    return this.#messageManager.send(MessageCommands.selectCRM, {
+    const response = await this.#messageManager.send(MessageCommands.selectCRM, {
       entityType: params?.entityType,
       multiple: params?.multiple,
       value: params?.value
     });
+    const result = {};
+    if (!response) {
+      return result;
+    }
+    const toArray = /* @__PURE__ */ __name((bucket) => {
+      if (bucket === void 0 || bucket === null) {
+        return void 0;
+      }
+      if (Array.isArray(bucket)) {
+        return bucket;
+      }
+      return Object.values(bucket);
+    }, "toArray");
+    const lead = toArray(response.lead);
+    if (lead) result.lead = lead;
+    const contact = toArray(response.contact);
+    if (contact) result.contact = contact;
+    const company = toArray(response.company);
+    if (company) result.company = company;
+    const deal = toArray(response.deal);
+    if (deal) result.deal = deal;
+    const quote = toArray(response.quote);
+    if (quote) result.quote = quote;
+    return result;
   }
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"dialog.mjs","sources":["../../../src/frame/dialog.ts"],"sourcesContent":["import type { MessageManager } from './message'\nimport { MessageCommands } from './message'\nimport type { NumberString } from '../types/common'\n\nexport type SelectedUser = {\n  /**\n   * user identifier\n   */\n  id: NumberString\n\n  /**\n   * formatted username\n   */\n  name: string\n\n  photo: string\n\n  position: string\n\n  url: string\n\n  /**\n   * The flag indicates that the selected user is a subordinate of the current user\n   */\n  sub: boolean\n\n  /**\n   * The flag indicates that the selected user is the manager of the current user\n   */\n  sup: boolean\n}\n\nexport type SelectedAccess = {\n  /**\n   * access permission identifier. Examples of identifiers:\n   * - U1 — user with identifier 1\n   * - IU1 — employees with identifier 1\n   * - DR2 — all department and subdepartment employees with identifier 2\n   * - D6 — all department employees with identifier 6\n   * - G2 — group with identifier 2 (all visitors)\n   * - SG4 — social network group with identifier 4\n   * - AU — all authorized users\n   * - CR — current user\n   */\n  id:\n    | `AU`\n    | `CR`\n    | `U${number}`\n    | `IU${number}`\n    | `DR${number}`\n    | `D${number}`\n    | `G${number}`\n    | `SG${number}`\n\n  /**\n   * name of the access permission\n   */\n  name: string\n}\n\nexport type SelectCRMParamsEntityType\n  = | 'lead'\n    | 'contact'\n    | 'company'\n    | 'deal'\n    | 'quote'\n\nexport type SelectCRMParamsValue = {\n  lead?: number[]\n  contact?: number[]\n  company?: number[]\n  deal?: number[]\n  quote?: number[]\n}\n\nexport type SelectCRMParams = {\n  /**\n   * Which types of objects to display in the dialog. Possible values:\n   * - lead — Leads\n   * - contact — Contacts\n   * - company — Companies\n   * - deal — Deals\n   * - quote — Estimates\n   */\n  entityType: SelectCRMParamsEntityType[]\n\n  /**\n   * Whether multiple objects can be selected. Default is `false`\n   */\n  multiple: boolean\n\n  /**\n   * Which objects to initially add to the selected in the dialog. Works only if `multiple = true`\n   */\n  value?: SelectCRMParamsValue\n}\n\nexport type SelectedCRMEntity = {\n  id: string\n  type: SelectCRMParamsEntityType\n  place: string\n  title: string\n  desc: string\n  url: string\n}\n\nexport type SelectedCRM = {\n  lead?: (SelectedCRMEntity & { id: `L_${number}` })[]\n  contact?: (SelectedCRMEntity & { id: `C_${number}`, image: string })[]\n  company?: (SelectedCRMEntity & { id: `CO_${number}`, image: string })[]\n  deal?: (SelectedCRMEntity & { id: `D_${number}` })[]\n  quote?: (SelectedCRMEntity & { id: `Q_${number}` })[]\n}\n\n/**\n * Select dialog manager\n *\n * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/index.html\n */\nexport class DialogManager {\n  #messageManager: MessageManager\n\n  constructor(messageManager: MessageManager) {\n    this.#messageManager = messageManager\n  }\n\n  /**\n   * Method displays the standard single user selection dialog\n   * It only shows company employees\n   *\n   * @return {Promise<null|SelectedUser>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-user.html\n   */\n  async selectUser(): Promise<null | SelectedUser> {\n    return this.#messageManager.send(MessageCommands.selectUser, {\n      mult: false\n    })\n  }\n\n  /**\n   * Method displays the standard multiple user selection dialog\n   * It only shows company employees\n   *\n   * @return {Promise<SelectedUser[]>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-users.html\n   */\n  async selectUsers(): Promise<SelectedUser[]> {\n    return this.#messageManager.send(MessageCommands.selectUser, {\n      mult: true\n    })\n  }\n\n  /**\n   * Method displays a standard access permission selection dialog\n   *\n   * @param {string[]} blockedAccessPermissions\n   * @return {Promise<SelectedAccess[]>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-access.html\n   */\n  async selectAccess(\n    blockedAccessPermissions: string[] = []\n  ): Promise<SelectedAccess[]> {\n    return this.#messageManager.send(MessageCommands.selectAccess, {\n      value: blockedAccessPermissions\n    })\n  }\n\n  /**\n   * Method invokes the system dialog for selecting a CRM entity\n   *\n   * @param {SelectCRMParams} params\n   * @return {Promise<SelectedCRM>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-crm.html\n   */\n  async selectCRM(params?: SelectCRMParams): Promise<SelectedCRM> {\n    return this.#messageManager.send(MessageCommands.selectCRM, {\n      entityType: params?.entityType,\n      multiple: params?.multiple,\n      value: params?.value\n    })\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAuHO,MAAM,aAAA,CAAc;AAAA,EAvH3B;AAuH2B,IAAA,MAAA,CAAA,IAAA,EAAA,eAAA,CAAA;AAAA;AAAA,EACzB,eAAA;AAAA,EAEA,YAAY,cAAA,EAAgC;AAC1C,IAAA,IAAA,CAAK,eAAA,GAAkB,cAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,UAAA,GAA2C;AAC/C,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,UAAA,EAAY;AAAA,MAC3D,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,WAAA,GAAuC;AAC3C,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,UAAA,EAAY;AAAA,MAC3D,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,YAAA,CACJ,wBAAA,GAAqC,EAAC,EACX;AAC3B,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,YAAA,EAAc;AAAA,MAC7D,KAAA,EAAO;AAAA,KACR,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,UAAU,MAAA,EAAgD;AAC9D,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,SAAA,EAAW;AAAA,MAC1D,YAAY,MAAA,EAAQ,UAAA;AAAA,MACpB,UAAU,MAAA,EAAQ,QAAA;AAAA,MAClB,OAAO,MAAA,EAAQ;AAAA,KAChB,CAAA;AAAA,EACH;AACF;;;;"}
+{"version":3,"file":"dialog.mjs","sources":["../../../src/frame/dialog.ts"],"sourcesContent":["import type { MessageManager } from './message'\nimport { MessageCommands } from './message'\nimport type { NumberString } from '../types/common'\n\nexport type SelectedUser = {\n  /**\n   * user identifier\n   */\n  id: NumberString\n\n  /**\n   * formatted username\n   */\n  name: string\n\n  photo: string\n\n  position: string\n\n  url: string\n\n  /**\n   * The flag indicates that the selected user is a subordinate of the current user\n   */\n  sub: boolean\n\n  /**\n   * The flag indicates that the selected user is the manager of the current user\n   */\n  sup: boolean\n}\n\nexport type SelectedAccess = {\n  /**\n   * access permission identifier. Examples of identifiers:\n   * - U1 — user with identifier 1\n   * - IU1 — employees with identifier 1\n   * - DR2 — all department and subdepartment employees with identifier 2\n   * - D6 — all department employees with identifier 6\n   * - G2 — group with identifier 2 (all visitors)\n   * - SG4 — social network group with identifier 4\n   * - AU — all authorized users\n   * - CR — current user\n   */\n  id:\n    | `AU`\n    | `CR`\n    | `U${number}`\n    | `IU${number}`\n    | `DR${number}`\n    | `D${number}`\n    | `G${number}`\n    | `SG${number}`\n\n  /**\n   * name of the access permission\n   */\n  name: string\n}\n\nexport type SelectCRMParamsEntityType\n  = | 'lead'\n    | 'contact'\n    | 'company'\n    | 'deal'\n    | 'quote'\n\nexport type SelectCRMParamsValue = {\n  lead?: number[]\n  contact?: number[]\n  company?: number[]\n  deal?: number[]\n  quote?: number[]\n}\n\nexport type SelectCRMParams = {\n  /**\n   * Which types of objects to display in the dialog. Possible values:\n   * - lead — Leads\n   * - contact — Contacts\n   * - company — Companies\n   * - deal — Deals\n   * - quote — Estimates\n   */\n  entityType: SelectCRMParamsEntityType[]\n\n  /**\n   * Whether multiple objects can be selected. Default is `false`\n   */\n  multiple: boolean\n\n  /**\n   * Which objects to initially add to the selected in the dialog. Works only if `multiple = true`\n   */\n  value?: SelectCRMParamsValue\n}\n\nexport type SelectedCRMEntity = {\n  id: string\n  type: SelectCRMParamsEntityType\n  place: string\n  title: string\n  desc: string\n  url: string\n}\n\nexport type SelectedCRM = {\n  lead?: (SelectedCRMEntity & { id: `L_${number}` })[]\n  contact?: (SelectedCRMEntity & { id: `C_${number}`, image: string })[]\n  company?: (SelectedCRMEntity & { id: `CO_${number}`, image: string })[]\n  deal?: (SelectedCRMEntity & { id: `D_${number}` })[]\n  quote?: (SelectedCRMEntity & { id: `Q_${number}` })[]\n}\n\n/**\n * Select dialog manager\n *\n * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/index.html\n */\nexport class DialogManager {\n  #messageManager: MessageManager\n\n  constructor(messageManager: MessageManager) {\n    this.#messageManager = messageManager\n  }\n\n  /**\n   * Method displays the standard single user selection dialog\n   * It only shows company employees\n   *\n   * @return {Promise<null|SelectedUser>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-user.html\n   */\n  async selectUser(): Promise<null | SelectedUser> {\n    return this.#messageManager.send(MessageCommands.selectUser, {\n      mult: false\n    })\n  }\n\n  /**\n   * Method displays the standard multiple user selection dialog\n   * It only shows company employees\n   *\n   * @return {Promise<SelectedUser[]>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-users.html\n   */\n  async selectUsers(): Promise<SelectedUser[]> {\n    return this.#messageManager.send(MessageCommands.selectUser, {\n      mult: true\n    })\n  }\n\n  /**\n   * Method displays a standard access permission selection dialog\n   *\n   * @param {string[]} blockedAccessPermissions\n   * @return {Promise<SelectedAccess[]>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-access.html\n   */\n  async selectAccess(\n    blockedAccessPermissions: string[] = []\n  ): Promise<SelectedAccess[]> {\n    return this.#messageManager.send(MessageCommands.selectAccess, {\n      value: blockedAccessPermissions\n    })\n  }\n\n  /**\n   * Invokes the system dialog for selecting CRM entities\n   * (leads, contacts, companies, deals, quotes).\n   *\n   * The resolved `SelectedCRM` object contains a separate bucket per\n   * entity type. Each present bucket is a real `Array`, so consumers can\n   * use `.length`, `.map()`, `for..of`, etc. directly. Buckets for entity\n   * types that were not selected (or not requested via `entityType`) are\n   * left `undefined` rather than being set to an empty array.\n   *\n   * Note: the parent window historically returned each bucket as a\n   * `Record<string, SelectedCRMEntity>` (e.g. `{ 0: {...}, 1: {...} }`).\n   * The SDK normalizes that response to a real array before returning it.\n   *\n   * @param {SelectCRMParams} [params] - Filter and behavior options.\n   *   - `entityType`: which entity types are shown in the dialog.\n   *   - `multiple`: allow multiple selection (default `false`).\n   *   - `value`: pre-selected entities (only applied when `multiple` is `true`).\n   * @return {Promise<SelectedCRM>} Resolves to an object whose properties\n   *   (`lead`, `contact`, `company`, `deal`, `quote`) are arrays of\n   *   {@link SelectedCRMEntity} objects.\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-crm.html\n   */\n  async selectCRM(params?: SelectCRMParams): Promise<SelectedCRM> {\n    const response = await this.#messageManager.send(MessageCommands.selectCRM, {\n      entityType: params?.entityType,\n      multiple: params?.multiple,\n      value: params?.value\n    }) as Partial<Record<SelectCRMParamsEntityType, unknown>> | null | undefined\n\n    // The parent window returns each entity bucket as a Record<string, SelectedCRMEntity>\n    // (e.g. { 0: {...}, 1: {...} }) rather than a real array. Normalize to arrays so\n    // the runtime shape matches the documented `SelectedCRM` types.\n    const result: SelectedCRM = {}\n    if (!response) {\n      return result\n    }\n\n    const toArray = <T>(bucket: unknown): T[] | undefined => {\n      if (bucket === undefined || bucket === null) {\n        return undefined\n      }\n      if (Array.isArray(bucket)) {\n        return bucket as T[]\n      }\n      return Object.values(bucket as Record<string, T>)\n    }\n\n    const lead = toArray<SelectedCRMEntity & { id: `L_${number}` }>(response.lead)\n    if (lead) result.lead = lead\n\n    const contact = toArray<SelectedCRMEntity & { id: `C_${number}`, image: string }>(response.contact)\n    if (contact) result.contact = contact\n\n    const company = toArray<SelectedCRMEntity & { id: `CO_${number}`, image: string }>(response.company)\n    if (company) result.company = company\n\n    const deal = toArray<SelectedCRMEntity & { id: `D_${number}` }>(response.deal)\n    if (deal) result.deal = deal\n\n    const quote = toArray<SelectedCRMEntity & { id: `Q_${number}` }>(response.quote)\n    if (quote) result.quote = quote\n\n    return result\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAuHO,MAAM,aAAA,CAAc;AAAA,EAvH3B;AAuH2B,IAAA,MAAA,CAAA,IAAA,EAAA,eAAA,CAAA;AAAA;AAAA,EACzB,eAAA;AAAA,EAEA,YAAY,cAAA,EAAgC;AAC1C,IAAA,IAAA,CAAK,eAAA,GAAkB,cAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,UAAA,GAA2C;AAC/C,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,UAAA,EAAY;AAAA,MAC3D,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,WAAA,GAAuC;AAC3C,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,UAAA,EAAY;AAAA,MAC3D,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,YAAA,CACJ,wBAAA,GAAqC,EAAC,EACX;AAC3B,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,YAAA,EAAc;AAAA,MAC7D,KAAA,EAAO;AAAA,KACR,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BA,MAAM,UAAU,MAAA,EAAgD;AAC9D,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,gBAAgB,SAAA,EAAW;AAAA,MAC1E,YAAY,MAAA,EAAQ,UAAA;AAAA,MACpB,UAAU,MAAA,EAAQ,QAAA;AAAA,MAClB,OAAO,MAAA,EAAQ;AAAA,KAChB,CAAA;AAKD,IAAA,MAAM,SAAsB,EAAC;AAC7B,IAAA,IAAI,CAAC,QAAA,EAAU;AACb,MAAA,OAAO,MAAA;AAAA,IACT;AAEA,IAAA,MAAM,OAAA,2BAAc,MAAA,KAAqC;AACvD,MAAA,IAAI,MAAA,KAAW,MAAA,IAAa,MAAA,KAAW,IAAA,EAAM;AAC3C,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG;AACzB,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,OAAO,MAAA,CAAO,OAAO,MAA2B,CAAA;AAAA,IAClD,CAAA,EARgB,SAAA,CAAA;AAUhB,IAAA,MAAM,IAAA,GAAO,OAAA,CAAmD,QAAA,CAAS,IAAI,CAAA;AAC7E,IAAA,IAAI,IAAA,SAAa,IAAA,GAAO,IAAA;AAExB,IAAA,MAAM,OAAA,GAAU,OAAA,CAAkE,QAAA,CAAS,OAAO,CAAA;AAClG,IAAA,IAAI,OAAA,SAAgB,OAAA,GAAU,OAAA;AAE9B,IAAA,MAAM,OAAA,GAAU,OAAA,CAAmE,QAAA,CAAS,OAAO,CAAA;AACnG,IAAA,IAAI,OAAA,SAAgB,OAAA,GAAU,OAAA;AAE9B,IAAA,MAAM,IAAA,GAAO,OAAA,CAAmD,QAAA,CAAS,IAAI,CAAA;AAC7E,IAAA,IAAI,IAAA,SAAa,IAAA,GAAO,IAAA;AAExB,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAmD,QAAA,CAAS,KAAK,CAAA;AAC/E,IAAA,IAAI,KAAA,SAAc,KAAA,GAAQ,KAAA;AAE1B,IAAA,OAAO,MAAA;AAAA,EACT;AACF;;;;"}

package/dist/esm/frame/frame.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/frame/placement.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.0.6
+ * @version 1.1.1
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -82,22 +82,45 @@ class PlacementManager {
       }
     );
   }
+  async call(command, parameters = {}) {
+    if (command === "setValue" && !Type.isString(parameters?.["value"])) {
+      throw new TypeError(
+        "placement.call('setValue', { value }) expects `value` to be a JSON-serialized string. Use placement.setValue(value) to serialize automatically, or call JSON.stringify yourself."
+      );
+    }
+    return this.#messageManager.send(
+      command,
+      {
+        ...parameters,
+        isSafely: true,
+        isRawValue: ["setValue"].includes(command)
+      }
+    );
+  }
   /**
-   * Call the Registered Interface Command
-   * @param { string } command
-   * @param { Record<string, any> } parameters
+   * Set Value for the Current Embedding Location
+   *
+   * Convenience wrapper around `placement.call('setValue', ...)` that handles
+   * JSON serialization. Pass any value (string, number, boolean, object, array)
+   * — it will be serialized via `JSON.stringify` before being sent to the
+   * parent window, which performs `JSON.parse` on receipt.
+   *
+   * @param { unknown } value Any JSON-serializable value
    * @return { Promise<any> }
    *
    * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html
-   * @memo For the `setValue` command, use the following parameters { value: string }
+   *
+   * @example
+   * await b24.placement.setValue('test')
+   * await b24.placement.setValue({ id: 1, title: 'demo' })
    */
-  async call(command, parameters = {}) {
+  async setValue(value) {
     return this.#messageManager.send(
-      command,
+      "setValue",
       {
-        ...parameters,
+        value: JSON.stringify(value),
         isSafely: true,
-        isRawValue: ["setValue"].includes(command)
+        isRawValue: true
       }
     );
   }

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

@@ -1 +1 @@
-{"version":3,"file":"placement.mjs","sources":["../../../src/frame/placement.ts"],"sourcesContent":["import type { MessageManager } from './message'\nimport type { MessageInitData } from '../types/auth'\nimport { MessageCommands } from './message'\nimport { Type } from '../tools/type'\n\n/**\n * Placement Manager\n *\n * @see https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/index.html\n */\nexport class PlacementManager {\n  #messageManager: MessageManager\n  #placement: string = ''\n  #options: object = {}\n\n  constructor(messageManager: MessageManager) {\n    this.#messageManager = messageManager\n  }\n\n  /**\n   * Initializes the data received from the parent window message.\n   * @param data\n   */\n  initData(data: MessageInitData): PlacementManager {\n    this.#placement = data.PLACEMENT || 'DEFAULT'\n    this.#options = Object.freeze(data.PLACEMENT_OPTIONS)\n\n    return this\n  }\n\n  /**\n   * Symlink on `placement`\n   * For backward compatibility\n   */\n  get title(): string {\n    return this.#placement\n  }\n\n  get placement(): string {\n    return this.#placement\n  }\n\n  get isDefault(): boolean {\n    return this.placement === 'DEFAULT'\n  }\n\n  get options(): any {\n    return this.#options\n  }\n\n  get isSliderMode(): boolean {\n    return this.options?.IFRAME === 'Y'\n  }\n\n  /**\n   * Get Information About the JS Interface of the Current Embedding Location\n   *\n   * @return {Promise<any>}\n   *\n   * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-get-interface.html\n   */\n  async getInterface(): Promise<any> {\n    return this.#messageManager.send(\n      MessageCommands.getInterface,\n      {\n        isSafely: true\n      }\n    )\n  }\n\n  /**\n   * Set Up the Interface Event Handler\n   * @param {string} eventName\n   * @param {(...args: any[]) => void} callBack\n   * @return {Promise<any>}\n   *\n   * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-bind-event.html\n   */\n  async bindEvent(\n    eventName: string,\n    callBack: (...args: any[]) => void\n  ): Promise<any> {\n    return this.#messageManager.send(\n      MessageCommands.placementBindEvent,\n      {\n        event: eventName,\n        callBack,\n        isSafely: true\n      }\n    )\n  }\n\n  /**\n   * Call the Registered Interface Command\n   * @param { string } command\n   * @param { Record<string, any> } parameters\n   * @return { Promise<any> }\n   *\n   * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html\n   * @memo For the `setValue` command, use the following parameters { value: string }\n   */\n  async call(command: string, parameters: Record<string, any> = {}): Promise<any> {\n    return this.#messageManager.send(\n      command,\n      {\n        ...parameters,\n        isSafely: true,\n        isRawValue: ['setValue'].includes(command)\n      }\n    )\n  }\n\n  /**\n   * Set Up the Interface Event Handler\n   * @param {string} command\n   * @param {null | string | Record<string, any>} parameters\n   * @param {(...args: any[]) => void} callBack\n   *\n   * @return {Promise<any>}\n   */\n  async callCustomBind(\n    command: string,\n    parameters: null | string | Record<string, any> = null,\n    callBack: (...args: any[]) => void\n  ): Promise<any> {\n    let options: Record<string, any> = {}\n    if (Type.isString(parameters)) {\n      options['singleOption'] = parameters\n    } else if (Type.isObjectLike(parameters)) {\n      options = { ...(parameters as object) }\n    }\n\n    return this.#messageManager.send(\n      command,\n      {\n        ...options,\n        callBack,\n        isSafely: true\n      }\n    )\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"placement.mjs","sources":["../../../src/frame/placement.ts"],"sourcesContent":["import type { MessageManager } from './message'\nimport type { MessageInitData } from '../types/auth'\nimport { MessageCommands } from './message'\nimport { Type } from '../tools/type'\n\n/**\n * Placement Manager\n *\n * @see https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/index.html\n */\nexport class PlacementManager {\n  #messageManager: MessageManager\n  #placement: string = ''\n  #options: object = {}\n\n  constructor(messageManager: MessageManager) {\n    this.#messageManager = messageManager\n  }\n\n  /**\n   * Initializes the data received from the parent window message.\n   * @param data\n   */\n  initData(data: MessageInitData): PlacementManager {\n    this.#placement = data.PLACEMENT || 'DEFAULT'\n    this.#options = Object.freeze(data.PLACEMENT_OPTIONS)\n\n    return this\n  }\n\n  /**\n   * Symlink on `placement`\n   * For backward compatibility\n   */\n  get title(): string {\n    return this.#placement\n  }\n\n  get placement(): string {\n    return this.#placement\n  }\n\n  get isDefault(): boolean {\n    return this.placement === 'DEFAULT'\n  }\n\n  get options(): any {\n    return this.#options\n  }\n\n  get isSliderMode(): boolean {\n    return this.options?.IFRAME === 'Y'\n  }\n\n  /**\n   * Get Information About the JS Interface of the Current Embedding Location\n   *\n   * @return {Promise<any>}\n   *\n   * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-get-interface.html\n   */\n  async getInterface(): Promise<any> {\n    return this.#messageManager.send(\n      MessageCommands.getInterface,\n      {\n        isSafely: true\n      }\n    )\n  }\n\n  /**\n   * Set Up the Interface Event Handler\n   * @param {string} eventName\n   * @param {(...args: any[]) => void} callBack\n   * @return {Promise<any>}\n   *\n   * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-bind-event.html\n   */\n  async bindEvent(\n    eventName: string,\n    callBack: (...args: any[]) => void\n  ): Promise<any> {\n    return this.#messageManager.send(\n      MessageCommands.placementBindEvent,\n      {\n        event: eventName,\n        callBack,\n        isSafely: true\n      }\n    )\n  }\n\n  /**\n   * Call the Registered Interface Command\n   *\n   * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html\n   *\n   * @memo The `setValue` command is special: the parent window calls `JSON.parse(value)`\n   *       on the received payload, so `value` MUST be a JSON-serialized string\n   *       (e.g. `JSON.stringify('test')` or `JSON.stringify({ a: 1 })`).\n   *       Prefer {@link PlacementManager.setValue} which serializes for you.\n   *\n   * @throws {TypeError} when `command === 'setValue'` and `parameters.value` is not a string.\n   */\n  async call(command: 'setValue', parameters: { value: string }): Promise<any>\n  async call(command: string, parameters?: Record<string, any>): Promise<any>\n  async call(command: string, parameters: Record<string, any> = {}): Promise<any> {\n    if (command === 'setValue' && !Type.isString(parameters?.['value'])) {\n      throw new TypeError(\n        'placement.call(\\'setValue\\', { value }) expects `value` to be a JSON-serialized string. '\n        + 'Use placement.setValue(value) to serialize automatically, or call JSON.stringify yourself.'\n      )\n    }\n\n    return this.#messageManager.send(\n      command,\n      {\n        ...parameters,\n        isSafely: true,\n        isRawValue: ['setValue'].includes(command)\n      }\n    )\n  }\n\n  /**\n   * Set Value for the Current Embedding Location\n   *\n   * Convenience wrapper around `placement.call('setValue', ...)` that handles\n   * JSON serialization. Pass any value (string, number, boolean, object, array)\n   * — it will be serialized via `JSON.stringify` before being sent to the\n   * parent window, which performs `JSON.parse` on receipt.\n   *\n   * @param { unknown } value Any JSON-serializable value\n   * @return { Promise<any> }\n   *\n   * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html\n   *\n   * @example\n   * await b24.placement.setValue('test')\n   * await b24.placement.setValue({ id: 1, title: 'demo' })\n   */\n  async setValue(value: unknown): Promise<any> {\n    return this.#messageManager.send(\n      'setValue',\n      {\n        value: JSON.stringify(value),\n        isSafely: true,\n        isRawValue: true\n      }\n    )\n  }\n\n  /**\n   * Set Up the Interface Event Handler\n   * @param {string} command\n   * @param {null | string | Record<string, any>} parameters\n   * @param {(...args: any[]) => void} callBack\n   *\n   * @return {Promise<any>}\n   */\n  async callCustomBind(\n    command: string,\n    parameters: null | string | Record<string, any> = null,\n    callBack: (...args: any[]) => void\n  ): Promise<any> {\n    let options: Record<string, any> = {}\n    if (Type.isString(parameters)) {\n      options['singleOption'] = parameters\n    } else if (Type.isObjectLike(parameters)) {\n      options = { ...(parameters as object) }\n    }\n\n    return this.#messageManager.send(\n      command,\n      {\n        ...options,\n        callBack,\n        isSafely: true\n      }\n    )\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;AAUO,MAAM,gBAAA,CAAiB;AAAA,EAV9B;AAU8B,IAAA,MAAA,CAAA,IAAA,EAAA,kBAAA,CAAA;AAAA;AAAA,EAC5B,eAAA;AAAA,EACA,UAAA,GAAqB,EAAA;AAAA,EACrB,WAAmB,EAAC;AAAA,EAEpB,YAAY,cAAA,EAAgC;AAC1C,IAAA,IAAA,CAAK,eAAA,GAAkB,cAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAS,IAAA,EAAyC;AAChD,IAAA,IAAA,CAAK,UAAA,GAAa,KAAK,SAAA,IAAa,SAAA;AACpC,IAAA,IAAA,CAAK,QAAA,GAAW,MAAA,CAAO,MAAA,CAAO,IAAA,CAAK,iBAAiB,CAAA;AAEpD,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,KAAA,GAAgB;AAClB,IAAA,OAAO,IAAA,CAAK,UAAA;AAAA,EACd;AAAA,EAEA,IAAI,SAAA,GAAoB;AACtB,IAAA,OAAO,IAAA,CAAK,UAAA;AAAA,EACd;AAAA,EAEA,IAAI,SAAA,GAAqB;AACvB,IAAA,OAAO,KAAK,SAAA,KAAc,SAAA;AAAA,EAC5B;AAAA,EAEA,IAAI,OAAA,GAAe;AACjB,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEA,IAAI,YAAA,GAAwB;AAC1B,IAAA,OAAO,IAAA,CAAK,SAAS,MAAA,KAAW,GAAA;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,YAAA,GAA6B;AACjC,IAAA,OAAO,KAAK,eAAA,CAAgB,IAAA;AAAA,MAC1B,eAAA,CAAgB,YAAA;AAAA,MAChB;AAAA,QACE,QAAA,EAAU;AAAA;AACZ,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,SAAA,CACJ,SAAA,EACA,QAAA,EACc;AACd,IAAA,OAAO,KAAK,eAAA,CAAgB,IAAA;AAAA,MAC1B,eAAA,CAAgB,kBAAA;AAAA,MAChB;AAAA,QACE,KAAA,EAAO,SAAA;AAAA,QACP,QAAA;AAAA,QACA,QAAA,EAAU;AAAA;AACZ,KACF;AAAA,EACF;AAAA,EAgBA,MAAM,IAAA,CAAK,OAAA,EAAiB,UAAA,GAAkC,EAAC,EAAiB;AAC9E,IAAA,IAAI,OAAA,KAAY,cAAc,CAAC,IAAA,CAAK,SAAS,UAAA,GAAa,OAAO,CAAC,CAAA,EAAG;AACnE,MAAA,MAAM,IAAI,SAAA;AAAA,QACR;AAAA,OAEF;AAAA,IACF;AAEA,IAAA,OAAO,KAAK,eAAA,CAAgB,IAAA;AAAA,MAC1B,OAAA;AAAA,MACA;AAAA,QACE,GAAG,UAAA;AAAA,QACH,QAAA,EAAU,IAAA;AAAA,QACV,UAAA,EAAY,CAAC,UAAU,CAAA,CAAE,SAAS,OAAO;AAAA;AAC3C,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,MAAM,SAAS,KAAA,EAA8B;AAC3C,IAAA,OAAO,KAAK,eAAA,CAAgB,IAAA;AAAA,MAC1B,UAAA;AAAA,MACA;AAAA,QACE,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA;AAAA,QAC3B,QAAA,EAAU,IAAA;AAAA,QACV,UAAA,EAAY;AAAA;AACd,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,cAAA,CACJ,OAAA,EACA,UAAA,GAAkD,MAClD,QAAA,EACc;AACd,IAAA,IAAI,UAA+B,EAAC;AACpC,IAAA,IAAI,IAAA,CAAK,QAAA,CAAS,UAAU,CAAA,EAAG;AAC7B,MAAA,OAAA,CAAQ,cAAc,CAAA,GAAI,UAAA;AAAA,IAC5B,CAAA,MAAA,IAAW,IAAA,CAAK,YAAA,CAAa,UAAU,CAAA,EAAG;AACxC,MAAA,OAAA,GAAU,EAAE,GAAI,UAAA,EAAsB;AAAA,IACxC;AAEA,IAAA,OAAO,KAAK,eAAA,CAAgB,IAAA;AAAA,MAC1B,OAAA;AAAA,MACA;AAAA,QACE,GAAG,OAAA;AAAA,QACH,QAAA;AAAA,QACA,QAAA,EAAU;AAAA;AACZ,KACF;AAAA,EACF;AACF;;;;"}

package/dist/esm/frame/slider.mjs

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

package/dist/esm/helper/abstract-helper.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @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.0.6
+ * @version 1.1.1
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/index.d.mts

@@ -1324,6 +1324,51 @@ interface RestrictionParams {
      * Default: 1_000
      */
     retryDelay?: number;
+    /**
+     * Whether to retry on transport-level errors (`NETWORK_ERROR`, `REQUEST_TIMEOUT`).
+     *
+     * Default: `true` — preserves the historical retry behaviour.
+     *
+     * Set to `false` for **non-idempotent** calls (e.g. `crm.documentgenerator.document.add`,
+     * any `*.add` that creates an entity, file uploads). When the request times out
+     * client-side, the server may still have processed it successfully — retrying then
+     * creates duplicates. With `retryOnNetworkError: false` the SDK immediately throws
+     * `NETWORK_ERROR` / `REQUEST_TIMEOUT` instead of retrying.
+     *
+     * For long-running heavy operations also raise the axios timeout:
+     * ```ts
+     * const clientAxios = $b24.getHttpClient(ApiVersion.v2).ajaxClient
+     * clientAxios.defaults.timeout = 120_000
+     * ```
+     */
+    retryOnNetworkError?: boolean;
+    /**
+     * Additional error codes that must be thrown as exceptions immediately,
+     * without any retry. Merged with the SDK's built-in hard list — you can
+     * only **add** codes, not remove built-ins (auth / fatal codes are always hard).
+     *
+     * Use this for business-specific or custom REST methods whose error codes
+     * the SDK doesn't know about (otherwise the SDK treats unknown codes as
+     * transient and retries them with backoff).
+     *
+     * @example
+     * ```ts
+     * await $b24.setRestrictionManagerParams({
+     *   ...ParamsFactory.getDefault(),
+     *   hardErrorCodes: ['DOCUMENT_GENERATOR_ALREADY_IN_QUEUE', 'MY_APP_BAD_PAYLOAD']
+     * })
+     * ```
+     */
+    hardErrorCodes?: string[];
+    /**
+     * Additional error codes that should be returned inside `AjaxResult` as a
+     * soft error instead of thrown. Merged with the SDK's built-in soft list.
+     *
+     * Use this when your application expects to inspect a specific REST error
+     * code as part of normal control flow (e.g. validation errors from a
+     * custom v3 endpoint).
+     */
+    softErrorCodes?: string[];
 }
 /**
  * Limiter operation statistics
@@ -2534,7 +2579,21 @@ type BatchPayload<C> = {
     readonly time: PayloadTime;
 };
 type Payload<P> = TypeDescriptionErrorV3 | TypeDescriptionError | GetPayload<P> | ListPayload<P> | BatchPayload<P>;
-type SuccessPayload<P> = Exclude<Payload<P>, TypeDescriptionErrorV3 | TypeDescriptionError>;
+/**
+ * Public shape of a successful REST response, as exposed by `AjaxResult.getData()`.
+ *
+ * The Bitrix24 REST API always wraps a success response in `{ result, time }` —
+ * this is true for both `restApi:v2` and `restApi:v3`. Any v2-only envelope
+ * fields (`next`, `total`) are intentionally NOT part of this type: they have
+ * no `restApi:v3` counterpart, and the SDK's `actions.v{2,3}.{callList,fetchList}`
+ * helpers handle pagination internally so consumers never need to read them.
+ *
+ * @see GetPayload
+ */
+type SuccessPayload<P> = {
+    readonly result: P;
+    readonly time: PayloadTime;
+};
 
 type AjaxQuery = Readonly<{
     method: string;
@@ -2561,9 +2620,35 @@ declare class AjaxResult<T = unknown> extends Result<Payload<T>> implements IRes
     getData(): undefined | SuccessPayload<T>;
     /**
      * Alias for isMore
+     *
+     * @deprecated Will be removed in `2.0.0`. Tied to the `restApi:v2` envelope
+     *   field `next`, which `restApi:v3` does not return. Use the SDK's list
+     *   helpers — they hide pagination entirely:
+     *   - `restApi:v2`: {@link CallListV2.make `b24.actions.v2.callList.make`} or {@link FetchListV2.make `b24.actions.v2.fetchList.make`}
+     *   - `restApi:v3`: {@link CallListV3.make `b24.actions.v3.callList.make`} or {@link FetchListV3.make `b24.actions.v3.fetchList.make`}
+     *
+     * @removed 2.0.0
      */
     hasMore(): boolean;
+    /**
+     * @deprecated Will be removed in `2.0.0`. Tied to the `restApi:v2` envelope
+     *   field `next`, which `restApi:v3` does not return. Use the SDK's list
+     *   helpers — they hide pagination entirely:
+     *   - `restApi:v2`: {@link CallListV2.make `b24.actions.v2.callList.make`} or {@link FetchListV2.make `b24.actions.v2.fetchList.make`}
+     *   - `restApi:v3`: {@link CallListV3.make `b24.actions.v3.callList.make`} or {@link FetchListV3.make `b24.actions.v3.fetchList.make`}
+     *
+     * @removed 2.0.0
+     */
     isMore(): boolean;
+    /**
+     * @deprecated Will be removed in `2.0.0`. Tied to the `restApi:v2` envelope
+     *   field `total`, which `restApi:v3` does not return. For `restApi:v3` the
+     *   SDK exposes element counts via the `aggregate` action (`count` /
+     *   `countDistinct`); for `restApi:v2` use the list helpers, which iterate
+     *   without exposing `total`.
+     *
+     * @removed 2.0.0
+     */
     getTotal(): number;
     getStatus(): number;
     getQuery(): Readonly<AjaxQuery>;
@@ -2571,9 +2656,25 @@ declare class AjaxResult<T = unknown> extends Result<Payload<T>> implements IRes
      * Alias for getNext
      * @param http
      *
-     * @todo !fix api version
+     * @deprecated Will be removed in `2.0.0`. `restApi:v3` does not support
+     *   `getNext()` (the v2 envelope field `next` does not exist). Use the SDK's
+     *   list helpers instead — they hide pagination entirely:
+     *   - `restApi:v2`: {@link CallListV2.make `b24.actions.v2.callList.make`} or {@link FetchListV2.make `b24.actions.v2.fetchList.make`}
+     *   - `restApi:v3`: {@link CallListV3.make `b24.actions.v3.callList.make`} or {@link FetchListV3.make `b24.actions.v3.fetchList.make`}
+     *
+     * @removed 2.0.0
      */
     fetchNext(http: TypeHttp): Promise<AjaxResult<T> | null>;
+    /**
+     * @deprecated Will be removed in `2.0.0`. Throws on `restApi:v3` because the
+     *   v2 envelope field `next` is not part of the v3 protocol. Use the SDK's
+     *   list helpers instead — they hide pagination entirely:
+     *   - `restApi:v2`: {@link CallListV2.make `b24.actions.v2.callList.make`} or {@link FetchListV2.make `b24.actions.v2.fetchList.make`}
+     *   - `restApi:v3`: {@link CallListV3.make `b24.actions.v3.callList.make`} or {@link FetchListV3.make `b24.actions.v3.fetchList.make`}
+     *
+     * @throws {SdkError} `JSSDK_CORE_METHOD_NOT_SUPPORT_IN_API_V3` when called against a `restApi:v3` HTTP client. This throw is preserved until `2.0.0`.
+     * @removed 2.0.0
+     */
     getNext(http: TypeHttp): Promise<AjaxResult<T> | false>;
     setData(): never;
 }
@@ -3904,11 +4005,33 @@ declare class RestrictionManager {
     updateStats(requestId: string, method: string, timeData: any): Promise<void>;
     handleError(requestId: string, method: string, params: any, error: any, attempt: number): Promise<number>;
     /**
-     * These exceptions will be thrown
+     * Built-in hard error codes (always throw, never retry).
+     *
+     * Includes authorization and fatal codes that must never be silently retried.
+     * Use `RestrictionParams.hardErrorCodes` to extend this list with custom codes.
+     */
+    static readonly BUILT_IN_HARD_ERROR_CODES: readonly string[];
+    /**
+     * Built-in soft error codes (returned as `AjaxResult` with error, never thrown).
+     *
+     * Use `RestrictionParams.softErrorCodes` to extend this list with custom codes.
+     */
+    static readonly BUILT_IN_SOFT_ERROR_CODES: readonly string[];
+    /**
+     * Codes that cause the SDK to throw immediately.
+     *
+     * Composed of:
+     * - `BUILT_IN_HARD_ERROR_CODES` (always included)
+     * - `NETWORK_ERROR` and `REQUEST_TIMEOUT` when `retryOnNetworkError === false`
+     * - `RestrictionParams.hardErrorCodes` (user-provided extensions)
      */
     get exceptionCodeForHard(): string[];
     /**
-     * These exceptions will be thrown into `AjaxResult` as `AjaxError`
+     * Codes returned as `AjaxResult` with an `AjaxError` payload instead of thrown.
+     *
+     * Composed of:
+     * - `BUILT_IN_SOFT_ERROR_CODES` (always included)
+     * - `RestrictionParams.softErrorCodes` (user-provided extensions)
      */
     get exceptionCodeForSoft(): string[];
     incrementError(method: string): void;
@@ -4898,10 +5021,26 @@ declare class DialogManager {
      */
     selectAccess(blockedAccessPermissions?: string[]): Promise<SelectedAccess[]>;
     /**
-     * Method invokes the system dialog for selecting a CRM entity
+     * Invokes the system dialog for selecting CRM entities
+     * (leads, contacts, companies, deals, quotes).
+     *
+     * The resolved `SelectedCRM` object contains a separate bucket per
+     * entity type. Each present bucket is a real `Array`, so consumers can
+     * use `.length`, `.map()`, `for..of`, etc. directly. Buckets for entity
+     * types that were not selected (or not requested via `entityType`) are
+     * left `undefined` rather than being set to an empty array.
      *
-     * @param {SelectCRMParams} params
-     * @return {Promise<SelectedCRM>}
+     * Note: the parent window historically returned each bucket as a
+     * `Record<string, SelectedCRMEntity>` (e.g. `{ 0: {...}, 1: {...} }`).
+     * The SDK normalizes that response to a real array before returning it.
+     *
+     * @param {SelectCRMParams} [params] - Filter and behavior options.
+     *   - `entityType`: which entity types are shown in the dialog.
+     *   - `multiple`: allow multiple selection (default `false`).
+     *   - `value`: pre-selected entities (only applied when `multiple` is `true`).
+     * @return {Promise<SelectedCRM>} Resolves to an object whose properties
+     *   (`lead`, `contact`, `company`, `deal`, `quote`) are arrays of
+     *   {@link SelectedCRMEntity} objects.
      *
      * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-crm.html
      */
@@ -4989,14 +5128,38 @@ declare class PlacementManager {
     bindEvent(eventName: string, callBack: (...args: any[]) => void): Promise<any>;
     /**
      * Call the Registered Interface Command
-     * @param { string } command
-     * @param { Record<string, any> } parameters
-     * @return { Promise<any> }
      *
      * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html
-     * @memo For the `setValue` command, use the following parameters { value: string }
+     *
+     * @memo The `setValue` command is special: the parent window calls `JSON.parse(value)`
+     *       on the received payload, so `value` MUST be a JSON-serialized string
+     *       (e.g. `JSON.stringify('test')` or `JSON.stringify({ a: 1 })`).
+     *       Prefer {@link PlacementManager.setValue} which serializes for you.
+     *
+     * @throws {TypeError} when `command === 'setValue'` and `parameters.value` is not a string.
      */
+    call(command: 'setValue', parameters: {
+        value: string;
+    }): Promise<any>;
     call(command: string, parameters?: Record<string, any>): Promise<any>;
+    /**
+     * Set Value for the Current Embedding Location
+     *
+     * Convenience wrapper around `placement.call('setValue', ...)` that handles
+     * JSON serialization. Pass any value (string, number, boolean, object, array)
+     * — it will be serialized via `JSON.stringify` before being sent to the
+     * parent window, which performs `JSON.parse` on receipt.
+     *
+     * @param { unknown } value Any JSON-serializable value
+     * @return { Promise<any> }
+     *
+     * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html
+     *
+     * @example
+     * await b24.placement.setValue('test')
+     * await b24.placement.setValue({ id: 1, title: 'demo' })
+     */
+    setValue(value: unknown): Promise<any>;
     /**
      * Set Up the Interface Event Handler
      * @param {string} command