@bitrix24/b24jssdk 1.0.6 → 1.1.1

package/dist/esm/tools/index.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/tools/scroll-size.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/tools/text.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/tools/type.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/tools/use-formatters.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/tools/uuidv7.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/types/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/types/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/types/bizproc/index.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/types/catalog/index.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/types/common.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/types/crm/entity-type.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/types/crm/productrow.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/types/logger.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/types/pull.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/umd/index.js

@@ -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
@@ -10644,8 +10644,6 @@ ${this.stack}`;
       const payload = this._data;
       return Object.freeze({
         result: payload.result,
-        next: "next" in payload ? payload.next : void 0,
-        total: "total" in payload ? payload.total : void 0,
         time: payload.time
       });
     }
@@ -10702,10 +10700,27 @@ ${this.stack}`;
     }
     /**
      * 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() {
       return this.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
+     */
     isMore() {
       if (!this.isSuccess) {
         return false;
@@ -10714,6 +10729,15 @@ ${this.stack}`;
       const nextValue = "next" in payload ? payload.next : void 0;
       return Type.isNumber(nextValue);
     }
+    /**
+     * @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() {
       if (!this.isSuccess) {
         return 0;
@@ -10732,7 +10756,13 @@ ${this.stack}`;
      * 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
      */
     async fetchNext(http) {
       const data = await this.getNext(http);
@@ -10741,6 +10771,16 @@ ${this.stack}`;
       }
       return data;
     }
+    /**
+     * @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
+     */
     async getNext(http) {
       if (http.apiVersion === ApiVersion.v3) {
         throw new SdkError({
@@ -10803,7 +10843,8 @@ ${this.stack}`;
           maxDelay: 7e3
         },
         maxRetries: 3,
-        retryDelay: 1e3
+        retryDelay: 1e3,
+        retryOnNetworkError: true
       };
     }
     /**
@@ -11695,49 +11736,81 @@ ${this.stack}`;
       ].includes(answerError.code) || (answerError.description ?? "").includes("Could not find value for parameter");
     }
     /**
-     * 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 BUILT_IN_HARD_ERROR_CODES = [
+      "ERR_BAD_REQUEST",
+      "JSSDK_UNKNOWN_ERROR",
+      "100",
+      "INTERNAL_SERVER_ERROR",
+      "ERROR_UNEXPECTED_ANSWER",
+      "PORTAL_DELETED",
+      "ERROR_BATCH_METHOD_NOT_ALLOWED",
+      "ERROR_BATCH_LENGTH_EXCEEDED",
+      "NO_AUTH_FOUND",
+      "INVALID_REQUEST",
+      "OVERLOAD_LIMIT",
+      "expired_token",
+      "ACCESS_DENIED",
+      "INVALID_CREDENTIALS",
+      "user_access_error",
+      "insufficient_scope",
+      "ERROR_MANIFEST_IS_NOT_AVAILABLE",
+      "allowed_only_intranet_user",
+      "NOT_FOUND",
+      "INVALID_ARG_VALUE"
+    ];
+    /**
+     * Built-in soft error codes (returned as `AjaxResult` with error, never thrown).
+     *
+     * Use `RestrictionParams.softErrorCodes` to extend this list with custom codes.
+     */
+    static BUILT_IN_SOFT_ERROR_CODES = [
+      "ERROR_ENTITY_NOT_FOUND",
+      "BITRIX_REST_V3_EXCEPTION_ACCESSDENIEDEXCEPTION",
+      "BITRIX_REST_V3_EXCEPTION_INVALIDJSONEXCEPTION",
+      "BITRIX_REST_V3_EXCEPTION_INVALIDFILTEREXCEPTION",
+      "BITRIX_REST_V3_EXCEPTION_INVALIDSELECTEXCEPTION",
+      "BITRIX_REST_V3_EXCEPTION_ENTITYNOTFOUNDEXCEPTION",
+      "BITRIX_REST_V3_EXCEPTION_METHODNOTFOUNDEXCEPTION",
+      "BITRIX_REST_V3_EXCEPTION_UNKNOWNDTOPROPERTYEXCEPTION",
+      "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
+      "BITRIX_REST_V3_EXCEPTION_VALIDATION_DTOVALIDATIONEXCEPTION"
+    ];
+    /**
+     * 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() {
-      return [
-        "ERR_BAD_REQUEST",
-        "JSSDK_UNKNOWN_ERROR",
-        // 'REQUEST_TIMEOUT', 'NETWORK_ERROR',
-        "100",
-        "INTERNAL_SERVER_ERROR",
-        "ERROR_UNEXPECTED_ANSWER",
-        "PORTAL_DELETED",
-        "ERROR_BATCH_METHOD_NOT_ALLOWED",
-        "ERROR_BATCH_LENGTH_EXCEEDED",
-        "NO_AUTH_FOUND",
-        "INVALID_REQUEST",
-        "OVERLOAD_LIMIT",
-        "expired_token",
-        "ACCESS_DENIED",
-        "INVALID_CREDENTIALS",
-        "user_access_error",
-        "insufficient_scope",
-        "ERROR_MANIFEST_IS_NOT_AVAILABLE",
-        "allowed_only_intranet_user",
-        "NOT_FOUND",
-        "INVALID_ARG_VALUE"
-      ];
+      const codes = [...RestrictionManager.BUILT_IN_HARD_ERROR_CODES];
+      if (this.#config.retryOnNetworkError === false) {
+        codes.push("NETWORK_ERROR", "REQUEST_TIMEOUT");
+      }
+      if (this.#config.hardErrorCodes && this.#config.hardErrorCodes.length > 0) {
+        codes.push(...this.#config.hardErrorCodes);
+      }
+      return codes;
     }
     /**
-     * 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() {
-      return [
-        "ERROR_ENTITY_NOT_FOUND",
-        "BITRIX_REST_V3_EXCEPTION_ACCESSDENIEDEXCEPTION",
-        "BITRIX_REST_V3_EXCEPTION_INVALIDJSONEXCEPTION",
-        "BITRIX_REST_V3_EXCEPTION_INVALIDFILTEREXCEPTION",
-        "BITRIX_REST_V3_EXCEPTION_INVALIDSELECTEXCEPTION",
-        "BITRIX_REST_V3_EXCEPTION_ENTITYNOTFOUNDEXCEPTION",
-        "BITRIX_REST_V3_EXCEPTION_METHODNOTFOUNDEXCEPTION",
-        "BITRIX_REST_V3_EXCEPTION_UNKNOWNDTOPROPERTYEXCEPTION",
-        "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
-        "BITRIX_REST_V3_EXCEPTION_VALIDATION_DTOVALIDATIONEXCEPTION"
-      ];
+      const codes = [...RestrictionManager.BUILT_IN_SOFT_ERROR_CODES];
+      if (this.#config.softErrorCodes && this.#config.softErrorCodes.length > 0) {
+        codes.push(...this.#config.softErrorCodes);
+      }
+      return codes;
     }
     /**
      * Delay due to unknown errors
@@ -18090,7 +18163,7 @@ ${JSON.stringify({
       this._logger = LoggerFactory.createNullLogger();
       const defaultHeaders = {};
       if (this.isServerSide()) {
-        defaultHeaders["User-Agent"] = "b24-js-sdk/1.0.6";
+        defaultHeaders["User-Agent"] = "b24-js-sdk/1.1.1";
       }
       this._authActions = authActions;
       this._requestIdGenerator = new RequestIdGenerator();
@@ -19185,7 +19258,7 @@ ${JSON.stringify({
           answer: {
             error: resultError ? typeof resultError === "string" ? resultError : resultError.error : void 0,
             error_description: resultError ? typeof resultError === "string" ? void 0 : resultError.error_description : void 0,
-            result: resultData ?? {},
+            result: resultData,
             total: Number.parseInt(this._getBatchResultByIndex(responseResult.result_total, index) || "0"),
             next: Number.parseInt(this._getBatchResultByIndex(responseResult.result_next, index) || "0"),
             time: resultTime
@@ -19343,7 +19416,7 @@ ${JSON.stringify({
       }
       const queryParams = new URLSearchParams({
         [this._requestIdGenerator.getQueryStringParameterName()]: requestId,
-        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.0.6",
+        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.1.1",
         [this._requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
       });
       return `${baseUrl}${methodUrl}?${queryParams.toString()}`;
@@ -19414,21 +19487,28 @@ ${JSON.stringify({
       return results;
     }
     /**
-     * @todo ! api ver3 waite docs
+     * In `restApi:v3`, `response.getData().result` is the array/record of per-command
+     * results directly (no `result_error`/`result_time`/`result_total`/`result_next`
+     * split as in v2). Per-command errors do not exist in this format.
+     *
+     * The per-command `result` value is forwarded as-is, including `null` when the
+     * underlying REST method returns `null` (see issue #23).
      */
     async _processResponseItem(command, index, responseHelper, results) {
       const responseResult = responseHelper.response.getData().result;
       const resultData = this._getBatchResultByIndex(responseResult, index);
-      const methodName = command.method;
-      const resultError = void 0;
-      const resultTime = responseHelper.response.getData().time;
-      if (typeof resultTime !== "undefined") {
-        await responseHelper.restrictionManager.updateStats(responseHelper.requestId, `batch::${methodName}`, resultTime);
+      if (typeof resultData === "undefined") {
+        throw new SdkError({
+          code: "JSSDK_INTERACTION_BATCH_STRATEGY_V3_EMPTY_COMMAND_RESPONSE",
+          description: `There were difficulties parsing the response for batch { index: ${index}, method: ${command.method} }`,
+          status: 500
+        });
       }
+      const resultTime = responseHelper.response.getData().time;
       const result = new AjaxResult({
         answer: {
-          result: resultData ?? {},
-          error: resultError,
+          result: resultData,
+          error: void 0,
           time: resultTime
         },
         query: {
@@ -19590,7 +19670,7 @@ ${JSON.stringify({
       const methodUrl = `/${encodeURIComponent(method)}`;
       const queryParams = new URLSearchParams({
         [this._requestIdGenerator.getQueryStringParameterName()]: requestId,
-        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.0.6",
+        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.1.1",
         [this._requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
       });
       return `${baseUrl}${methodUrl}?${queryParams.toString()}`;
@@ -21316,19 +21396,59 @@ ${JSON.stringify({
       });
     }
     /**
-     * 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.
+     *
+     * 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
-     * @return {Promise<SelectedCRM>}
+     * @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$q((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;
     }
   }
 
@@ -21549,22 +21669,45 @@ ${JSON.stringify({
         }
       );
     }
+    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
         }
       );
     }