@bitrix24/b24jssdk 1.1.0 → 1.1.1

package/dist/umd/index.js

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.1.0
+ * @version 1.1.1
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -10843,7 +10843,8 @@ ${this.stack}`;
           maxDelay: 7e3
         },
         maxRetries: 3,
-        retryDelay: 1e3
+        retryDelay: 1e3,
+        retryOnNetworkError: true
       };
     }
     /**
@@ -11735,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
@@ -18130,7 +18163,7 @@ ${JSON.stringify({
       this._logger = LoggerFactory.createNullLogger();
       const defaultHeaders = {};
       if (this.isServerSide()) {
-        defaultHeaders["User-Agent"] = "b24-js-sdk/1.1.0";
+        defaultHeaders["User-Agent"] = "b24-js-sdk/1.1.1";
       }
       this._authActions = authActions;
       this._requestIdGenerator = new RequestIdGenerator();
@@ -19225,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
@@ -19383,7 +19416,7 @@ ${JSON.stringify({
       }
       const queryParams = new URLSearchParams({
         [this._requestIdGenerator.getQueryStringParameterName()]: requestId,
-        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.1.0",
+        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.1.1",
         [this._requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
       });
       return `${baseUrl}${methodUrl}?${queryParams.toString()}`;
@@ -19454,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: {
@@ -19630,7 +19670,7 @@ ${JSON.stringify({
       const methodUrl = `/${encodeURIComponent(method)}`;
       const queryParams = new URLSearchParams({
         [this._requestIdGenerator.getQueryStringParameterName()]: requestId,
-        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.1.0",
+        [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.1.1",
         [this._requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
       });
       return `${baseUrl}${methodUrl}?${queryParams.toString()}`;