@bitrix24/b24jssdk 1.0.5 → 1.1.0

package/dist/esm/frame/placement.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.0.5
+ * @version 1.1.0
  * @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":"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"}

package/dist/esm/frame/slider.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.0.5
+ * @version 1.1.0
  * @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.5
+ * @version 1.1.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.0.5
+ * @version 1.1.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.0.5
+ * @version 1.1.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.0.5
+ * @version 1.1.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -14,8 +14,8 @@ import { CurrencyManager } from './currency-manager.mjs';
 import { OptionsManager } from './options-manager.mjs';
 import { Text } from '../tools/text.mjs';
 import { LoadDataType, TypeSpecificUrl } from '../types/b24-helper.mjs';
-import { PullClient } from '../pullClient/client.mjs';
 import { LoggerFactory } from '../logger/logger-factory.mjs';
+import { PullClient } from '../pullClient/client.mjs';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });

package/dist/esm/helper/license-manager.mjs

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

package/dist/esm/index.d.mts

@@ -1418,7 +1418,7 @@ declare class CallV2 extends AbstractAction {
 
 type ActionCallListV2 = ActionOptions & {
     method: string;
-    params?: Omit<TypeCallParams, 'start'>;
+    params?: Omit<TypeCallParams, 'start' | 'order'>;
     idKey?: string;
     customKeyForResult?: string;
     requestId?: string;
@@ -1481,7 +1481,7 @@ declare class CallListV2 extends AbstractAction {
 
 type ActionFetchListV2 = ActionOptions & {
     method: string;
-    params?: Omit<TypeCallParams, 'start'>;
+    params?: Omit<TypeCallParams, 'start' | 'order'>;
     idKey?: string;
     customKeyForResult?: string;
     requestId?: string;
@@ -1786,7 +1786,7 @@ declare class CallV3 extends AbstractAction {
 
 type ActionCallListV3 = ActionOptions & {
     method: string;
-    params?: Omit<TypeCallParams, 'pagination'>;
+    params?: Omit<TypeCallParams, 'pagination' | 'order'>;
     idKey?: string;
     customKeyForResult: string;
     requestId?: string;
@@ -1849,7 +1849,7 @@ declare class CallListV3 extends AbstractAction {
 
 type ActionFetchListV3 = ActionOptions & {
     method: string;
-    params?: Omit<TypeCallParams, 'pagination'>;
+    params?: Omit<TypeCallParams, 'pagination' | 'order'>;
     idKey?: string;
     customKeyForResult: string;
     requestId?: string;
@@ -2534,7 +2534,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 +2575,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 +2611,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;
 }
@@ -4898,10 +4954,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).
      *
-     * @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
      */
@@ -4989,14 +5061,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

package/dist/esm/index.d.ts

@@ -1418,7 +1418,7 @@ declare class CallV2 extends AbstractAction {
 
 type ActionCallListV2 = ActionOptions & {
     method: string;
-    params?: Omit<TypeCallParams, 'start'>;
+    params?: Omit<TypeCallParams, 'start' | 'order'>;
     idKey?: string;
     customKeyForResult?: string;
     requestId?: string;
@@ -1481,7 +1481,7 @@ declare class CallListV2 extends AbstractAction {
 
 type ActionFetchListV2 = ActionOptions & {
     method: string;
-    params?: Omit<TypeCallParams, 'start'>;
+    params?: Omit<TypeCallParams, 'start' | 'order'>;
     idKey?: string;
     customKeyForResult?: string;
     requestId?: string;
@@ -1786,7 +1786,7 @@ declare class CallV3 extends AbstractAction {
 
 type ActionCallListV3 = ActionOptions & {
     method: string;
-    params?: Omit<TypeCallParams, 'pagination'>;
+    params?: Omit<TypeCallParams, 'pagination' | 'order'>;
     idKey?: string;
     customKeyForResult: string;
     requestId?: string;
@@ -1849,7 +1849,7 @@ declare class CallListV3 extends AbstractAction {
 
 type ActionFetchListV3 = ActionOptions & {
     method: string;
-    params?: Omit<TypeCallParams, 'pagination'>;
+    params?: Omit<TypeCallParams, 'pagination' | 'order'>;
     idKey?: string;
     customKeyForResult: string;
     requestId?: string;
@@ -2534,7 +2534,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 +2575,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 +2611,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;
 }
@@ -4898,10 +4954,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).
      *
-     * @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
      */
@@ -4989,14 +5061,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

package/dist/esm/index.mjs

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

package/dist/esm/loader-b24frame.mjs

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

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

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

package/dist/esm/logger/browser.mjs

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

package/dist/esm/logger/formatter/abstract-formatter.mjs

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

package/dist/esm/logger/formatter/json-formatter.mjs

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