@bitrix24/b24jssdk 1.0.6 → 1.1.1

package/README-AI.md

@@ -17,6 +17,24 @@ Core building blocks:
 
 Note: since v0.4.0 the package ships ESM and UMD only (no CommonJS).
 
+## Deprecation notice — read before generating code
+
+The following surface is `@deprecated` and **scheduled for removal in `2.0.0`**.
+Many examples in this document still reference it because it remains the most
+widely-used path today, but new code should target the `actions.v{2,3}.*` API.
+
+| Deprecated | Replacement |
+|---|---|
+| `b24.callMethod(method, params, start?)` | `b24.actions.v2.call.make({ method, params })` / `b24.actions.v3.call.make({ method, params })` |
+| `b24.callBatch(calls, isHaltOnError?, returnAjaxResult?)` | `b24.actions.v2.batch.make({ calls, options })` / `b24.actions.v3.batch.make(...)` |
+| `b24.callBatchByChunk(calls, isHaltOnError)` | `b24.actions.v2.batchByChunk.make({ calls, options })` / `b24.actions.v3.batchByChunk.make(...)` |
+| `b24.callListMethod(method, params, progress?, customKey?)` | `b24.actions.v2.callList.make({ method, params, customKeyForResult })` / `b24.actions.v3.callList.make(...)` |
+| `b24.fetchListMethod(method, params, idKey?, customKey?)` | `b24.actions.v2.fetchList.make({ method, params, idKey, customKeyForResult })` / `b24.actions.v3.fetchList.make(...)` |
+| `AjaxResult#isMore()`, `#hasMore()`, `#getNext()`, `#fetchNext()`, `#getTotal()` | The `next`/`total` envelope fields are `restApi:v2`-only (no `restApi:v3` counterpart). Do not iterate manually — let `actions.v{2,3}.{callList,fetchList}` handle pagination. For element counts in `restApi:v3` use the `aggregate` action with `count` / `countDistinct`. |
+
+`AjaxResult.getData()` returns exactly `{ result: T, time: PayloadTime }` — the
+v2-only `next` and `total` fields are no longer surfaced through the public type.
+
 
 ## Frontend in Bitrix24 (TypeScript, ESM)
 
@@ -96,6 +114,8 @@ Patterns
 - Destroy on page/component unmount with $b24.destroy().
 - For large result sets prefer callListMethod or fetchListMethod.
 - For big batches use callBatchByChunk to respect limits.
+- A per-command `result` inside a batch can be `null` when the underlying REST method legitimately returns `null` (e.g. `im.chat.get` with non-matching params). Declare the generic as `T | null` and handle the `null` branch — the SDK no longer coerces it to `{}` (see issue #23).
+- `restApi:v3` batch is all-or-nothing: per-command errors are not returned. If any call fails, the whole batch fails and `response.getErrorMessages()` carries the error.
 
 
 ## Frontend via UMD (CDN)
@@ -405,6 +425,11 @@ async function loadAllDealsStreaming($b24: any) {
 
 #### C) Manual pagination: callMethod + next pages
 
+> **`@deprecated` — slated for removal in `2.0.0`.** `callMethod`, `isMore()`,
+> and `getNext()` rely on the `restApi:v2` envelope field `next`, which
+> `restApi:v3` does not return. Prefer `b24.actions.v{2,3}.fetchList.make` for
+> custom-throttled iteration; that helper hides pagination for both API versions.
+
 Use when you need to control page sizes, pauses, or add custom throttling. Iterate until `isMore()` returns false, using `getNext($b24.getHttpClient())`.
 
 ```ts
@@ -446,9 +471,9 @@ import { AjaxError } from '@bitrix24/b24jssdk'
 
 try {
   const res = await $b24.callMethod('crm.item.get', { entityTypeId: 1, id: 10 })
-  const payload = res.getData()                  // raw REST payload
+  const payload = res.getData()                  // { result, time } — see Deprecation notice
   const ok = res.isSuccess                       // boolean
-  const total = res.getTotal()                   // for list calls
+  // const total = res.getTotal()                // @deprecated, removed in 2.0.0; v3 has no `total`
 } catch (e) {
   if (e instanceof AjaxError) {
     console.error(e.code, e.description, e.status, e.requestInfo)
@@ -557,7 +582,7 @@ This document is based on the SDK source in packages/jssdk/src and the docs unde
   ```
  
 - Unique ID Generator: request IDs are appended automatically via Http
-- Result / AjaxResult: uniform result objects, error aggregation, paging helpers (isMore, getNext, getTotal)
+- Result / AjaxResult: uniform result objects, error aggregation. (Legacy paging helpers `isMore`/`getNext`/`getTotal` are `@deprecated` for `2.0.0` — see Deprecation notice.)
 - Language List and LoggerBrowser
 
 ### Tools

package/dist/esm/_virtual/_commonjsHelpers.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/_virtual/protobuf.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/_virtual/protobuf2.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/core/abstract-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/core/actions/abstract-action.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/core/actions/abstract-batch.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/core/actions/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/core/actions/v2/batch-by-chunk.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/core/actions/v2/batch.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/core/actions/v2/call-list.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/core/actions/v2/call.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/core/actions/v2/fetch-list.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/core/actions/v2/manager-v2.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/core/actions/v3/batch-by-chunk.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/core/actions/v3/batch.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/core/actions/v3/call-list.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/core/actions/v3/call.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/core/actions/v3/fetch-list.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/core/actions/v3/manager-v3.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/core/http/abstract-http.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
@@ -44,7 +44,7 @@ class AbstractHttp {
     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();

package/dist/esm/core/http/ajax-error.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/core/http/ajax-result.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
@@ -45,8 +45,6 @@ class AjaxResult extends Result {
     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
     });
   }
@@ -103,10 +101,27 @@ class AjaxResult extends Result {
   }
   /**
    * 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;
@@ -115,6 +130,15 @@ class AjaxResult extends Result {
     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;
@@ -133,7 +157,13 @@ class AjaxResult extends Result {
    * 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);
@@ -142,6 +172,16 @@ class AjaxResult extends Result {
     }
     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({

package/dist/esm/core/http/ajax-result.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ajax-result.mjs","sources":["../../../../src/core/http/ajax-result.ts"],"sourcesContent":["import type { IResult } from '../result'\nimport type { Payload, SuccessPayload } from '../../types/payloads'\nimport type { TypeCallParams, TypeHttp } from '../../types/http'\nimport type { TypeDescriptionError, TypeDescriptionErrorV3 } from '../../types/auth'\nimport { Type } from '../../tools/type'\nimport { Text } from '../../tools/text'\nimport { Result } from '../result'\nimport { AjaxError } from './ajax-error'\nimport { ApiVersion } from '../../types/b24'\nimport { SdkError } from '../sdk-error'\n\nexport type AjaxQuery = Readonly<{\n  method: string\n  params: TypeCallParams\n  requestId: string\n}>\n\ntype AjaxResultOptions<T> = Readonly<{\n  answer: Payload<T>\n  query: AjaxQuery\n  status: number\n}>\n\ntype ErrorData = {\n  code: string\n  description: string\n  status: number\n}\n\n/**\n * Result of request to Rest Api\n *\n * @todo docs\n */\nexport class AjaxResult<T = unknown> extends Result<Payload<T>> implements IResult<Payload<T>> {\n  private readonly _status: number\n  private readonly _query: AjaxQuery\n  protected override _data: Payload<T> | null | undefined\n\n  constructor(options: AjaxResultOptions<T>) {\n    super()\n\n    this._data = options.answer ? Object.freeze(options.answer) : undefined\n    this._query = Object.freeze(structuredClone(options.query))\n    this._status = options.status\n\n    this.#processErrors()\n  }\n\n  override get isSuccess(): boolean {\n    return this.#getIsSuccess()\n  }\n\n  /**\n   * @todo test this predicate\n   */\n  #getIsSuccess(): this is { getData: () => SuccessPayload<T> } {\n    return this._errors.size === 0\n  }\n\n  override getData(): undefined | SuccessPayload<T> {\n    if (!this.isSuccess) {\n      return undefined\n    }\n\n    const payload = this._data as SuccessPayload<T>\n\n    return Object.freeze({\n      result: payload.result,\n      next: 'next' in payload ? payload.next : undefined,\n      total: 'total' in payload ? payload.total : undefined,\n      time: payload.time\n    }) as SuccessPayload<T>\n  }\n\n  /**\n   * If the response contains error data, we'll restore it to an error.\n   *\n   * @todo make single function\n   * @see AbstractHttp._convertAxiosErrorToAjaxError()\n   */\n  #processErrors(): void {\n    if (this._data && typeof this._data === 'object' && 'error' in this._data) {\n      const responseData = this._data as TypeDescriptionError | TypeDescriptionErrorV3\n\n      if (\n        responseData.error\n        && typeof responseData.error === 'object'\n        && 'code' in responseData.error\n      ) {\n        const errorCode = responseData.error.code\n        let errorDescription = responseData.error.message.trimEnd()\n        if (responseData.error.validation) {\n          if (errorDescription.length > 0) {\n            if (!errorDescription.endsWith('.')) {\n              errorDescription += `.`\n            }\n            errorDescription += ` `\n          }\n          responseData.error.validation.forEach((row) => {\n            errorDescription += `${row?.message || JSON.stringify(row)}`\n          })\n        }\n\n        this.addError(this.#createAjaxError({\n          code: errorCode,\n          description: errorDescription,\n          status: this._status\n        }), 'base-error')\n      } else if (responseData.error && typeof responseData.error === 'string') {\n        const errorCode = responseData.error !== '0' ? responseData.error : 'JSSDK_RESPONSE_ERROR'\n        const errorDescription = (responseData as TypeDescriptionError)?.error_description ?? 'Some error in response'\n\n        this.addError(this.#createAjaxError({\n          code: errorCode,\n          description: errorDescription,\n          status: this._status\n        }), 'base-error')\n      }\n    }\n  }\n\n  #createAjaxError(errorData: ErrorData): AjaxError {\n    return new AjaxError({\n      code: errorData.code,\n      description: errorData.description,\n      status: errorData.status,\n      requestInfo: {\n        method: this._query.method,\n        params: this._query.params,\n        requestId: this._query.requestId\n      }\n    })\n  }\n\n  /**\n   * Alias for isMore\n   */\n  hasMore(): boolean {\n    return this.isMore()\n  }\n\n  isMore(): boolean {\n    if (!this.isSuccess) {\n      return false\n    }\n    const payload = this._data as SuccessPayload<T>\n    const nextValue = 'next' in payload ? payload.next : undefined\n\n    return Type.isNumber(nextValue)\n  }\n\n  getTotal(): number {\n    if (!this.isSuccess) {\n      return 0\n    }\n    const payload = this._data as SuccessPayload<T>\n    const totalValue = 'total' in payload ? payload.total : undefined\n\n    return Text.toInteger(totalValue)\n  }\n\n  getStatus(): number {\n    return this._status\n  }\n\n  getQuery(): Readonly<AjaxQuery> {\n    return this._query\n  }\n\n  /**\n   * Alias for getNext\n   * @param http\n   *\n   * @todo !fix api version\n   */\n  async fetchNext(http: TypeHttp): Promise<AjaxResult<T> | null> {\n    const data = await this.getNext(http)\n    if (data === false) {\n      return null\n    }\n\n    return data\n  }\n\n  async getNext(http: TypeHttp): Promise<AjaxResult<T> | false> {\n    // @todo ! Correction -> we can use pagination to navigate to the next page\n    if (http.apiVersion === ApiVersion.v3) {\n      throw new SdkError({\n        code: 'JSSDK_CORE_METHOD_NOT_SUPPORT_IN_API_V3',\n        description: `restApi:v3 not support method getNext`,\n        status: 500\n      })\n    }\n    if (\n      !this.isSuccess\n      || !this.isMore()\n    ) {\n      return false\n    }\n\n    const nextPageQuery = this.#buildNextPageQuery()\n    return http.call(\n      nextPageQuery.method,\n      nextPageQuery.params\n    ) as Promise<AjaxResult<T>>\n  }\n\n  #buildNextPageQuery(): AjaxQuery {\n    const result = { ...this._query }\n\n    const payload = this._data as SuccessPayload<T>\n    const nextValue = 'next' in payload ? payload.next : undefined\n\n    result.params.start = Text.toInteger(Text.toInteger(nextValue))\n\n    return result\n  }\n\n  // Immutable API\n  override setData(): never {\n    throw new ReferenceError('AjaxResult does not allow data modification')\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ajax-result.mjs","sources":["../../../../src/core/http/ajax-result.ts"],"sourcesContent":["import type { IResult } from '../result'\nimport type { Payload, SuccessPayload } from '../../types/payloads'\nimport type { TypeCallParams, TypeHttp } from '../../types/http'\nimport type { TypeDescriptionError, TypeDescriptionErrorV3 } from '../../types/auth'\nimport { Type } from '../../tools/type'\nimport { Text } from '../../tools/text'\nimport { Result } from '../result'\nimport { AjaxError } from './ajax-error'\nimport { ApiVersion } from '../../types/b24'\nimport { SdkError } from '../sdk-error'\n\nexport type AjaxQuery = Readonly<{\n  method: string\n  params: TypeCallParams\n  requestId: string\n}>\n\ntype AjaxResultOptions<T> = Readonly<{\n  answer: Payload<T>\n  query: AjaxQuery\n  status: number\n}>\n\ntype ErrorData = {\n  code: string\n  description: string\n  status: number\n}\n\n/**\n * Result of request to Rest Api\n *\n * @todo docs\n */\nexport class AjaxResult<T = unknown> extends Result<Payload<T>> implements IResult<Payload<T>> {\n  private readonly _status: number\n  private readonly _query: AjaxQuery\n  protected override _data: Payload<T> | null | undefined\n\n  constructor(options: AjaxResultOptions<T>) {\n    super()\n\n    this._data = options.answer ? Object.freeze(options.answer) : undefined\n    this._query = Object.freeze(structuredClone(options.query))\n    this._status = options.status\n\n    this.#processErrors()\n  }\n\n  override get isSuccess(): boolean {\n    return this.#getIsSuccess()\n  }\n\n  /**\n   * @todo test this predicate\n   */\n  #getIsSuccess(): this is { getData: () => SuccessPayload<T> } {\n    return this._errors.size === 0\n  }\n\n  override getData(): undefined | SuccessPayload<T> {\n    if (!this.isSuccess) {\n      return undefined\n    }\n\n    const payload = this._data as SuccessPayload<T>\n\n    return Object.freeze({\n      result: payload.result,\n      time: payload.time\n    }) as SuccessPayload<T>\n  }\n\n  /**\n   * If the response contains error data, we'll restore it to an error.\n   *\n   * @todo make single function\n   * @see AbstractHttp._convertAxiosErrorToAjaxError()\n   */\n  #processErrors(): void {\n    if (this._data && typeof this._data === 'object' && 'error' in this._data) {\n      const responseData = this._data as TypeDescriptionError | TypeDescriptionErrorV3\n\n      if (\n        responseData.error\n        && typeof responseData.error === 'object'\n        && 'code' in responseData.error\n      ) {\n        const errorCode = responseData.error.code\n        let errorDescription = responseData.error.message.trimEnd()\n        if (responseData.error.validation) {\n          if (errorDescription.length > 0) {\n            if (!errorDescription.endsWith('.')) {\n              errorDescription += `.`\n            }\n            errorDescription += ` `\n          }\n          responseData.error.validation.forEach((row) => {\n            errorDescription += `${row?.message || JSON.stringify(row)}`\n          })\n        }\n\n        this.addError(this.#createAjaxError({\n          code: errorCode,\n          description: errorDescription,\n          status: this._status\n        }), 'base-error')\n      } else if (responseData.error && typeof responseData.error === 'string') {\n        const errorCode = responseData.error !== '0' ? responseData.error : 'JSSDK_RESPONSE_ERROR'\n        const errorDescription = (responseData as TypeDescriptionError)?.error_description ?? 'Some error in response'\n\n        this.addError(this.#createAjaxError({\n          code: errorCode,\n          description: errorDescription,\n          status: this._status\n        }), 'base-error')\n      }\n    }\n  }\n\n  #createAjaxError(errorData: ErrorData): AjaxError {\n    return new AjaxError({\n      code: errorData.code,\n      description: errorData.description,\n      status: errorData.status,\n      requestInfo: {\n        method: this._query.method,\n        params: this._query.params,\n        requestId: this._query.requestId\n      }\n    })\n  }\n\n  /**\n   * Alias for isMore\n   *\n   * @deprecated Will be removed in `2.0.0`. Tied to the `restApi:v2` envelope\n   *   field `next`, which `restApi:v3` does not return. Use the SDK's list\n   *   helpers — they hide pagination entirely:\n   *   - `restApi:v2`: {@link CallListV2.make `b24.actions.v2.callList.make`} or {@link FetchListV2.make `b24.actions.v2.fetchList.make`}\n   *   - `restApi:v3`: {@link CallListV3.make `b24.actions.v3.callList.make`} or {@link FetchListV3.make `b24.actions.v3.fetchList.make`}\n   *\n   * @removed 2.0.0\n   */\n  hasMore(): boolean {\n    return this.isMore()\n  }\n\n  /**\n   * @deprecated Will be removed in `2.0.0`. Tied to the `restApi:v2` envelope\n   *   field `next`, which `restApi:v3` does not return. Use the SDK's list\n   *   helpers — they hide pagination entirely:\n   *   - `restApi:v2`: {@link CallListV2.make `b24.actions.v2.callList.make`} or {@link FetchListV2.make `b24.actions.v2.fetchList.make`}\n   *   - `restApi:v3`: {@link CallListV3.make `b24.actions.v3.callList.make`} or {@link FetchListV3.make `b24.actions.v3.fetchList.make`}\n   *\n   * @removed 2.0.0\n   */\n  isMore(): boolean {\n    if (!this.isSuccess) {\n      return false\n    }\n    const payload = this._data as { next?: number }\n    const nextValue = 'next' in payload ? payload.next : undefined\n\n    return Type.isNumber(nextValue)\n  }\n\n  /**\n   * @deprecated Will be removed in `2.0.0`. Tied to the `restApi:v2` envelope\n   *   field `total`, which `restApi:v3` does not return. For `restApi:v3` the\n   *   SDK exposes element counts via the `aggregate` action (`count` /\n   *   `countDistinct`); for `restApi:v2` use the list helpers, which iterate\n   *   without exposing `total`.\n   *\n   * @removed 2.0.0\n   */\n  getTotal(): number {\n    if (!this.isSuccess) {\n      return 0\n    }\n    const payload = this._data as { total?: number }\n    const totalValue = 'total' in payload ? payload.total : undefined\n\n    return Text.toInteger(totalValue)\n  }\n\n  getStatus(): number {\n    return this._status\n  }\n\n  getQuery(): Readonly<AjaxQuery> {\n    return this._query\n  }\n\n  /**\n   * Alias for getNext\n   * @param http\n   *\n   * @deprecated Will be removed in `2.0.0`. `restApi:v3` does not support\n   *   `getNext()` (the v2 envelope field `next` does not exist). Use the SDK's\n   *   list helpers instead — they hide pagination entirely:\n   *   - `restApi:v2`: {@link CallListV2.make `b24.actions.v2.callList.make`} or {@link FetchListV2.make `b24.actions.v2.fetchList.make`}\n   *   - `restApi:v3`: {@link CallListV3.make `b24.actions.v3.callList.make`} or {@link FetchListV3.make `b24.actions.v3.fetchList.make`}\n   *\n   * @removed 2.0.0\n   */\n  async fetchNext(http: TypeHttp): Promise<AjaxResult<T> | null> {\n    const data = await this.getNext(http)\n    if (data === false) {\n      return null\n    }\n\n    return data\n  }\n\n  /**\n   * @deprecated Will be removed in `2.0.0`. Throws on `restApi:v3` because the\n   *   v2 envelope field `next` is not part of the v3 protocol. Use the SDK's\n   *   list helpers instead — they hide pagination entirely:\n   *   - `restApi:v2`: {@link CallListV2.make `b24.actions.v2.callList.make`} or {@link FetchListV2.make `b24.actions.v2.fetchList.make`}\n   *   - `restApi:v3`: {@link CallListV3.make `b24.actions.v3.callList.make`} or {@link FetchListV3.make `b24.actions.v3.fetchList.make`}\n   *\n   * @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`.\n   * @removed 2.0.0\n   */\n  async getNext(http: TypeHttp): Promise<AjaxResult<T> | false> {\n    // @todo ! Correction -> we can use pagination to navigate to the next page\n    if (http.apiVersion === ApiVersion.v3) {\n      throw new SdkError({\n        code: 'JSSDK_CORE_METHOD_NOT_SUPPORT_IN_API_V3',\n        description: `restApi:v3 not support method getNext`,\n        status: 500\n      })\n    }\n    if (\n      !this.isSuccess\n      || !this.isMore()\n    ) {\n      return false\n    }\n\n    const nextPageQuery = this.#buildNextPageQuery()\n    return http.call(\n      nextPageQuery.method,\n      nextPageQuery.params\n    ) as Promise<AjaxResult<T>>\n  }\n\n  #buildNextPageQuery(): AjaxQuery {\n    const result = { ...this._query }\n\n    const payload = this._data as { next?: number }\n    const nextValue = 'next' in payload ? payload.next : undefined\n\n    result.params.start = Text.toInteger(Text.toInteger(nextValue))\n\n    return result\n  }\n\n  // Immutable API\n  override setData(): never {\n    throw new ReferenceError('AjaxResult does not allow data modification')\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/core/http/limiters/adaptive-delayer.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/core/http/limiters/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
@@ -152,49 +152,81 @@ class RestrictionManager {
     ].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