@bitrix24/b24jssdk 1.3.0 → 2.0.0

package/dist/esm/_virtual/protobuf2.mjs

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

package/dist/esm/core/actions/v2/call.mjs

@@ -1,15 +1,13 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.3.0
+ * @version 2.0.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
  * @see https://bitrix24.github.io/b24jssdk/
  */
 import { AbstractAction } from '../abstract-action.mjs';
-import { versionManager } from '../../version-manager.mjs';
 import { ApiVersion } from '../../../types/b24.mjs';
-import { LoggerFactory } from '../../../logger/logger-factory.mjs';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -47,18 +45,6 @@ class CallV2 extends AbstractAction {
    * console.log(response.getData().result.item.name)
    */
   async make(options) {
-    if (versionManager.isSupport(ApiVersion.v3, options.method)) {
-      LoggerFactory.forcedLog(
-        this._logger,
-        "warning",
-        `The method ${options.method} is available in restApi:v3. It's worth migrating to the new API.`,
-        {
-          method: options.method,
-          requestId: options.requestId,
-          code: "JSSDK_CORE_METHOD_AVAILABLE_IN_API_V3"
-        }
-      );
-    }
     const params = options.params || {};
     return this._b24.getHttpClient(ApiVersion.v2).call(options.method, params, options.requestId);
   }

package/dist/esm/core/actions/v2/call.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"call.mjs","sources":["../../../../../src/core/actions/v2/call.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { TypeCallParams } from '../../../types/http'\nimport type { AjaxResult } from '../../http/ajax-result'\nimport { AbstractAction } from '../abstract-action'\nimport { versionManager } from '../../version-manager'\nimport { ApiVersion } from '../../../types/b24'\nimport { LoggerFactory } from '../../../logger'\n\nexport type ActionCallV2 = ActionOptions & {\n  method: string\n  params?: TypeCallParams\n  requestId?: string\n}\n\n/**\n * Calls the Bitrix24 REST API method `restApi:v2`\n *\n * @todo add docs\n */\nexport class CallV2 extends AbstractAction {\n  /**\n   * Calls the Bitrix24 REST API method.\n   *\n   * @template T - The expected data type in the response (default is `unknown`).\n   *\n   * @param {ActionCallV2} options - parameters for executing the request.\n   *     - `method: string` - REST API method name (eg: `crm.item.get`)\n   *     - `params?: TypeCallParams` - Parameters for calling the method.\n   *     - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging.\n   *\n   * @returns {Promise<AjaxResult<T>>} A promise that resolves to the result of an REST API call.\n   *\n   * @example\n   * import { EnumCrmEntityTypeId } from '@bitrix24/b24jssdk'\n   *\n   * interface CrmItem { id: number, name: string, lastName: string }\n   * const response = await b24.actions.v2.call.make<{ item: CrmItem }>({\n   *   method: 'crm.item.get',\n   *   params: {\n   *     entityTypeId: EnumCrmEntityTypeId.contact,\n   *     id: 123\n   *   },\n   *   requestId: 'item-123'\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   * console.log(response.getData().result.item.name)\n   */\n  public override async make<T = unknown>(options: ActionCallV2): Promise<AjaxResult<T>> {\n    if (versionManager.isSupport(ApiVersion.v3, options.method)) {\n      LoggerFactory.forcedLog(\n        this._logger,\n        'warning',\n        `The method ${options.method} is available in restApi:v3. It's worth migrating to the new API.`,\n        {\n          method: options.method,\n          requestId: options.requestId,\n          code: 'JSSDK_CORE_METHOD_AVAILABLE_IN_API_V3'\n        }\n      )\n    }\n\n    const params = options.params || {}\n    return this._b24.getHttpClient(ApiVersion.v2).call<T>(options.method, params, options.requestId)\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAmBO,MAAM,eAAe,cAAA,CAAe;AAAA,EAnB3C;AAmB2C,IAAA,MAAA,CAAA,IAAA,EAAA,QAAA,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BzC,MAAsB,KAAkB,OAAA,EAA+C;AACrF,IAAA,IAAI,eAAe,SAAA,CAAU,UAAA,CAAW,EAAA,EAAI,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC3D,MAAA,aAAA,CAAc,SAAA;AAAA,QACZ,IAAA,CAAK,OAAA;AAAA,QACL,SAAA;AAAA,QACA,CAAA,WAAA,EAAc,QAAQ,MAAM,CAAA,iEAAA,CAAA;AAAA,QAC5B;AAAA,UACE,QAAQ,OAAA,CAAQ,MAAA;AAAA,UAChB,WAAW,OAAA,CAAQ,SAAA;AAAA,UACnB,IAAA,EAAM;AAAA;AACR,OACF;AAAA,IACF;AAEA,IAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAClC,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,aAAA,CAAc,UAAA,CAAW,EAAE,CAAA,CAAE,IAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ,MAAA,EAAQ,OAAA,CAAQ,SAAS,CAAA;AAAA,EACjG;AACF;;;;"}
+{"version":3,"file":"call.mjs","sources":["../../../../../src/core/actions/v2/call.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { TypeCallParams } from '../../../types/http'\nimport type { AjaxResult } from '../../http/ajax-result'\nimport { AbstractAction } from '../abstract-action'\nimport { ApiVersion } from '../../../types/b24'\n\nexport type ActionCallV2 = ActionOptions & {\n  method: string\n  params?: TypeCallParams\n  requestId?: string\n}\n\n/**\n * Calls the Bitrix24 REST API method `restApi:v2`\n *\n * @todo add docs\n */\nexport class CallV2 extends AbstractAction {\n  /**\n   * Calls the Bitrix24 REST API method.\n   *\n   * @template T - The expected data type in the response (default is `unknown`).\n   *\n   * @param {ActionCallV2} options - parameters for executing the request.\n   *     - `method: string` - REST API method name (eg: `crm.item.get`)\n   *     - `params?: TypeCallParams` - Parameters for calling the method.\n   *     - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging.\n   *\n   * @returns {Promise<AjaxResult<T>>} A promise that resolves to the result of an REST API call.\n   *\n   * @example\n   * import { EnumCrmEntityTypeId } from '@bitrix24/b24jssdk'\n   *\n   * interface CrmItem { id: number, name: string, lastName: string }\n   * const response = await b24.actions.v2.call.make<{ item: CrmItem }>({\n   *   method: 'crm.item.get',\n   *   params: {\n   *     entityTypeId: EnumCrmEntityTypeId.contact,\n   *     id: 123\n   *   },\n   *   requestId: 'item-123'\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   * console.log(response.getData().result.item.name)\n   */\n  public override async make<T = unknown>(options: ActionCallV2): Promise<AjaxResult<T>> {\n    const params = options.params || {}\n    return this._b24.getHttpClient(ApiVersion.v2).call<T>(options.method, params, options.requestId)\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;AAiBO,MAAM,eAAe,cAAA,CAAe;AAAA,EAjB3C;AAiB2C,IAAA,MAAA,CAAA,IAAA,EAAA,QAAA,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BzC,MAAsB,KAAkB,OAAA,EAA+C;AACrF,IAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAClC,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,aAAA,CAAc,UAAA,CAAW,EAAE,CAAA,CAAE,IAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ,MAAA,EAAQ,OAAA,CAAQ,SAAS,CAAA;AAAA,EACjG;AACF;;;;"}

package/dist/esm/core/actions/v2/fetch-list.mjs

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

package/dist/esm/core/actions/v3/_keyset-paginate.mjs

@@ -0,0 +1,66 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class KeysetPaginationError extends Error {
+  static {
+    __name(this, "KeysetPaginationError");
+  }
+  errors;
+  messages;
+  constructor(errors, messages) {
+    super(messages.join("; "));
+    this.name = "KeysetPaginationError";
+    this.errors = errors;
+    this.messages = messages;
+  }
+}
+async function* keysetPaginate(b24, logger, strategy) {
+  let cursor = strategy.initialCursor;
+  let maxPageSize = 0;
+  while (true) {
+    const response = await b24.actions.v3.call.make({
+      method: strategy.method,
+      params: strategy.buildParams(cursor),
+      requestId: strategy.requestId
+    });
+    if (!response.isSuccess) {
+      logger.error(strategy.errorLabel, {
+        method: strategy.method,
+        requestId: strategy.requestId,
+        messages: response.getErrorMessages()
+      });
+      throw new KeysetPaginationError(response.errors, response.getErrorMessages());
+    }
+    const responseData = response.getData();
+    if (!responseData) {
+      break;
+    }
+    const resultData = responseData.result[strategy.customKeyForResult];
+    if (!Array.isArray(resultData) || resultData.length === 0) {
+      break;
+    }
+    yield resultData;
+    maxPageSize = Math.max(maxPageSize, resultData.length);
+    if (resultData.length < maxPageSize) {
+      break;
+    }
+    const lastItem = resultData[resultData.length - 1];
+    const next = lastItem ? strategy.readNextCursor(lastItem) : null;
+    if (next === null || next === void 0) {
+      logger.warning(strategy.noCursorWarning);
+      break;
+    }
+    cursor = next;
+  }
+}
+__name(keysetPaginate, "keysetPaginate");
+
+export { KeysetPaginationError, keysetPaginate };
+//# sourceMappingURL=_keyset-paginate.mjs.map

package/dist/esm/core/actions/v3/_keyset-paginate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_keyset-paginate.mjs","sources":["../../../../../src/core/actions/v3/_keyset-paginate.ts"],"sourcesContent":["import type { TypeB24 } from '../../../types/b24'\nimport type { LoggerInterface } from '../../../types/logger'\nimport type { TypeCallParams } from '../../../types/http'\nimport type { AjaxResult } from '../../http/ajax-result'\n\n/**\n * Thrown by {@link keysetPaginate} when the underlying v3 `call` reports a soft\n * error part-way through a walk. It carries both the raw `[key, Error]` entries\n * (so the eager `call*` helpers can fold them into a `Result` via `addError`)\n * and the flat messages (so the streaming `fetch*` helpers can rethrow as their\n * own action-specific `SdkError`).\n */\nexport class KeysetPaginationError extends Error {\n  public readonly errors: Iterable<[string, Error]>\n  public readonly messages: string[]\n\n  constructor(errors: Iterable<[string, Error]>, messages: string[]) {\n    super(messages.join('; '))\n    this.name = 'KeysetPaginationError'\n    this.errors = errors\n    this.messages = messages\n  }\n}\n\n/**\n * Per-helper plug-ins that adapt the shared keyset loop to either the emulated\n * `list` cursor (a `[field, '>', n]` filter) or the native `tail` cursor.\n */\nexport type KeysetPaginateStrategy = {\n  /** REST API method name (e.g. `tasks.task.list`, `main.eventlog.tail`). */\n  method: string\n  /** Optional request id forwarded to `call`. */\n  requestId?: string\n  /** Key under `result` that holds the row array (e.g. `items`). */\n  customKeyForResult: string | null\n  /** Cursor value used for the very first page. */\n  initialCursor: number | string\n  /** Build the per-page request params for a given cursor value. */\n  buildParams: (cursor: number | string) => TypeCallParams\n  /**\n   * Read the next cursor value from the last item of a full page. Return `null`\n   * to stop pagination — used when the cursor field cannot be read from the\n   * response (the loop logs {@link KeysetPaginateStrategy.noCursorWarning}).\n   */\n  readNextCursor: (lastItem: Record<string, any>) => number | string | null\n  /** Logged at `warning` level when `readNextCursor` returns `null`. */\n  noCursorWarning: string\n  /** Label logged at `error` level when the underlying `call` fails. */\n  errorLabel: string\n}\n\n/**\n * Shared keyset-pagination driver for the v3 list/tail helpers\n * (`callList`/`fetchList` and `callTail`/`fetchTail`).\n *\n * It repeatedly calls `actions.v3.call`, yields each page, and advances the\n * cursor until the data runs out. End-of-data is detected by the size of the\n * page the **server actually returns**, not the requested `limit`: the loop\n * tracks the largest page seen so far (`maxPageSize`) and stops only when a page\n * is shorter than that (or empty). This matters because some v3 methods (e.g.\n * `tasks.task.list`) silently cap the page below the requested `limit`; keying\n * the stop on `limit` would end the walk right after the first capped page.\n *\n * On a soft error it throws {@link KeysetPaginationError}; the calling helper\n * decides whether to fold it into a `Result` (eager) or rethrow as an\n * `SdkError` (streaming).\n */\nexport async function* keysetPaginate<T = unknown>(\n  b24: TypeB24,\n  logger: LoggerInterface,\n  strategy: KeysetPaginateStrategy\n): AsyncGenerator<T[]> {\n  let cursor = strategy.initialCursor\n  let maxPageSize = 0\n\n  while (true) {\n    const response: AjaxResult<T> = await b24.actions.v3.call.make<T>({\n      method: strategy.method,\n      params: strategy.buildParams(cursor),\n      requestId: strategy.requestId\n    })\n\n    if (!response.isSuccess) {\n      logger.error(strategy.errorLabel, {\n        method: strategy.method,\n        requestId: strategy.requestId,\n        messages: response.getErrorMessages()\n      })\n      throw new KeysetPaginationError(response.errors, response.getErrorMessages())\n    }\n\n    const responseData = response.getData()\n    if (!responseData) {\n      break\n    }\n\n    const resultData: T[] = (responseData.result as any)[strategy.customKeyForResult as any] as T[]\n    // Guard against a wrong `customKeyForResult` (key absent → undefined): treat\n    // a missing/non-array bucket as \"no data\" instead of throwing on `.length`.\n    if (!Array.isArray(resultData) || resultData.length === 0) {\n      break\n    }\n\n    yield resultData\n\n    maxPageSize = Math.max(maxPageSize, resultData.length)\n    if (resultData.length < maxPageSize) {\n      break\n    }\n\n    const lastItem = resultData[resultData.length - 1] as Record<string, any>\n    const next = lastItem ? strategy.readNextCursor(lastItem) : null\n    if (next === null || next === undefined) {\n      logger.warning(strategy.noCursorWarning)\n      break\n    }\n    cursor = next\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;AAYO,MAAM,8BAA8B,KAAA,CAAM;AAAA,EAZjD;AAYiD,IAAA,MAAA,CAAA,IAAA,EAAA,uBAAA,CAAA;AAAA;AAAA,EAC/B,MAAA;AAAA,EACA,QAAA;AAAA,EAEhB,WAAA,CAAY,QAAmC,QAAA,EAAoB;AACjE,IAAA,KAAA,CAAM,QAAA,CAAS,IAAA,CAAK,IAAI,CAAC,CAAA;AACzB,IAAA,IAAA,CAAK,IAAA,GAAO,uBAAA;AACZ,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,QAAA,GAAW,QAAA;AAAA,EAClB;AACF;AA6CA,gBAAuB,cAAA,CACrB,GAAA,EACA,MAAA,EACA,QAAA,EACqB;AACrB,EAAA,IAAI,SAAS,QAAA,CAAS,aAAA;AACtB,EAAA,IAAI,WAAA,GAAc,CAAA;AAElB,EAAA,OAAO,IAAA,EAAM;AACX,IAAA,MAAM,WAA0B,MAAM,GAAA,CAAI,OAAA,CAAQ,EAAA,CAAG,KAAK,IAAA,CAAQ;AAAA,MAChE,QAAQ,QAAA,CAAS,MAAA;AAAA,MACjB,MAAA,EAAQ,QAAA,CAAS,WAAA,CAAY,MAAM,CAAA;AAAA,MACnC,WAAW,QAAA,CAAS;AAAA,KACrB,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,SAAA,EAAW;AACvB,MAAA,MAAA,CAAO,KAAA,CAAM,SAAS,UAAA,EAAY;AAAA,QAChC,QAAQ,QAAA,CAAS,MAAA;AAAA,QACjB,WAAW,QAAA,CAAS,SAAA;AAAA,QACpB,QAAA,EAAU,SAAS,gBAAA;AAAiB,OACrC,CAAA;AACD,MAAA,MAAM,IAAI,qBAAA,CAAsB,QAAA,CAAS,MAAA,EAAQ,QAAA,CAAS,kBAAkB,CAAA;AAAA,IAC9E;AAEA,IAAA,MAAM,YAAA,GAAe,SAAS,OAAA,EAAQ;AACtC,IAAA,IAAI,CAAC,YAAA,EAAc;AACjB,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,UAAA,GAAmB,YAAA,CAAa,MAAA,CAAe,QAAA,CAAS,kBAAyB,CAAA;AAGvF,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,UAAU,CAAA,IAAK,UAAA,CAAW,WAAW,CAAA,EAAG;AACzD,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,UAAA;AAEN,IAAA,WAAA,GAAc,IAAA,CAAK,GAAA,CAAI,WAAA,EAAa,UAAA,CAAW,MAAM,CAAA;AACrD,IAAA,IAAI,UAAA,CAAW,SAAS,WAAA,EAAa;AACnC,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,UAAA,CAAW,UAAA,CAAW,MAAA,GAAS,CAAC,CAAA;AACjD,IAAA,MAAM,IAAA,GAAO,QAAA,GAAW,QAAA,CAAS,cAAA,CAAe,QAAQ,CAAA,GAAI,IAAA;AAC5D,IAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,IAAA,KAAS,MAAA,EAAW;AACvC,MAAA,MAAA,CAAO,OAAA,CAAQ,SAAS,eAAe,CAAA;AACvC,MAAA;AAAA,IACF;AACA,IAAA,MAAA,GAAS,IAAA;AAAA,EACX;AACF;AAnDuB,MAAA,CAAA,cAAA,EAAA,gBAAA,CAAA;;;;"}

package/dist/esm/core/actions/v3/aggregate.mjs

@@ -0,0 +1,94 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+import { AbstractAction } from '../abstract-action.mjs';
+import { Result } from '../../result.mjs';
+import { SdkError } from '../../sdk-error.mjs';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const AGGREGATE_FUNCTIONS = ["sum", "avg", "min", "max", "count", "countDistinct"];
+class AggregateV3 extends AbstractAction {
+  static {
+    __name(this, "AggregateV3");
+  }
+  /**
+   * @param {ActionAggregateV3} options
+   *     - `method: string` - an `*.aggregate` method name.
+   *     - `select: AggregateSelectV3` - per-function field selection (`sum`/`avg`/`min`/`max`/`count`/`countDistinct`).
+   *     - `params?: { filter }` - optional v3 filter (array-of-triples; use `FilterV3` to build it).
+   *     - `requestId?: string` - tracking id.
+   *
+   * @returns {Promise<Result<AggregateResultV3>>} buckets keyed by function then field name.
+   *
+   * @example
+   * const response = await b24.actions.v3.aggregate.make({
+   *   method: 'some.entity.aggregate',
+   *   select: { sum: { amount: 'totalAmount' }, count: ['id'] },
+   *   params: { filter: FilterV3.build(FilterV3.eq('status', 'NEW')) }
+   * })
+   * if (response.isSuccess) {
+   *   const total = response.getData()?.sum?.amount
+   * }
+   */
+  async make(options) {
+    const result = new Result();
+    const select = options?.select ?? {};
+    for (const fn of Object.keys(select)) {
+      if (!AGGREGATE_FUNCTIONS.includes(fn)) {
+        throw new SdkError({
+          code: "JSSDK_AGGREGATE_V3_INVALID_FUNCTION",
+          description: `AggregateV3: "${fn}" is not an aggregate function \u2014 use one of ${AGGREGATE_FUNCTIONS.join(" ")}.`,
+          status: 400
+        });
+      }
+      const fields = select[fn];
+      if (!Array.isArray(fields) && (typeof fields !== "object" || fields === null)) {
+        throw new SdkError({
+          code: "JSSDK_AGGREGATE_V3_INVALID_SELECT",
+          description: `AggregateV3: select.${fn} must be a string[] (default alias) or a { field: alias } map.`,
+          status: 400
+        });
+      }
+    }
+    const params = { select };
+    if (options?.params?.filter) {
+      params.filter = options.params.filter;
+    }
+    const response = await this._b24.actions.v3.call.make({
+      method: options.method,
+      params,
+      requestId: options.requestId
+    });
+    if (!response.isSuccess) {
+      this._logger.error("aggregateMethod", {
+        method: options.method,
+        requestId: options.requestId,
+        messages: response.getErrorMessages()
+      });
+      for (const [index, error] of response.errors) {
+        result.addError(error, index);
+      }
+      return result;
+    }
+    const payload = response.getData()?.result;
+    let buckets;
+    if (payload && typeof payload === "object" && "result" in payload) {
+      buckets = payload.result ?? {};
+    } else if (payload && typeof payload === "object") {
+      this._logger.warning(`aggregate.make: response has no nested 'result.result' envelope (the v3 reference \xA77 specifies double nesting); falling back to the top-level 'result'. method=${options.method}`);
+      buckets = payload;
+    } else {
+      buckets = {};
+    }
+    return result.setData(buckets);
+  }
+}
+
+export { AggregateV3 };
+//# sourceMappingURL=aggregate.mjs.map

package/dist/esm/core/actions/v3/aggregate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.mjs","sources":["../../../../../src/core/actions/v3/aggregate.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { TypeCallParams } from '../../../types/http'\nimport type { AjaxResult } from '../../http/ajax-result'\nimport { AbstractAction } from '../abstract-action'\nimport { Result } from '../../result'\nimport { SdkError } from '../../sdk-error'\n\n/**\n * The six aggregate functions the v3 `aggregate` action accepts (reference §7).\n * Anything else is rejected server-side with `UNKNOWNAGGREGATEFUNCTIONEXCEPTION`.\n */\nexport type AggregateFunctionV3 = 'sum' | 'avg' | 'min' | 'max' | 'count' | 'countDistinct'\n\nconst AGGREGATE_FUNCTIONS: readonly AggregateFunctionV3[] = ['sum', 'avg', 'min', 'max', 'count', 'countDistinct']\n\n/**\n * Per-function field selection. Two forms (reference §7):\n *   - list: `['amount', 'qty']` — default alias `<func>_<field>`;\n *   - map:  `{ amount: 'totalAmount' }` — custom alias.\n * Note: the response keys buckets by the **field name**, not the alias.\n */\nexport type AggregateSelectV3 = Partial<Record<AggregateFunctionV3, string[] | Record<string, string>>>\n\n/**\n * Aggregate response buckets: `{ sum: { amount: 12345 }, count: { id: 87 } }`.\n * Keyed by function, then by field name.\n */\nexport type AggregateResultV3 = Partial<Record<AggregateFunctionV3, Record<string, number>>>\n\n/** @experimental options for the v3 `aggregate` action — unverified live (see {@link AggregateV3}). */\nexport type ActionAggregateV3 = ActionOptions & {\n  method: string\n  select: AggregateSelectV3\n  params?: Pick<TypeCallParams, 'filter'>\n  requestId?: string\n}\n\n/**\n * Runs the v3 `aggregate` action for modules that support it (reference §7).\n * `restApi:v3`\n *\n * @experimental NOT verified against a live portal — no module on the SDK's\n * reference test portal currently exposes an `*.aggregate` endpoint. The\n * request/response shapes follow the published v3 reference and may change once\n * verified live; pin to a version if you depend on the exact shape.\n */\nexport class AggregateV3 extends AbstractAction {\n  /**\n   * @param {ActionAggregateV3} options\n   *     - `method: string` - an `*.aggregate` method name.\n   *     - `select: AggregateSelectV3` - per-function field selection (`sum`/`avg`/`min`/`max`/`count`/`countDistinct`).\n   *     - `params?: { filter }` - optional v3 filter (array-of-triples; use `FilterV3` to build it).\n   *     - `requestId?: string` - tracking id.\n   *\n   * @returns {Promise<Result<AggregateResultV3>>} buckets keyed by function then field name.\n   *\n   * @example\n   * const response = await b24.actions.v3.aggregate.make({\n   *   method: 'some.entity.aggregate',\n   *   select: { sum: { amount: 'totalAmount' }, count: ['id'] },\n   *   params: { filter: FilterV3.build(FilterV3.eq('status', 'NEW')) }\n   * })\n   * if (response.isSuccess) {\n   *   const total = response.getData()?.sum?.amount\n   * }\n   */\n  public override async make(options: ActionAggregateV3): Promise<Result<AggregateResultV3>> {\n    const result: Result<AggregateResultV3> = new Result()\n\n    const select = options?.select ?? {}\n    for (const fn of Object.keys(select)) {\n      if (!AGGREGATE_FUNCTIONS.includes(fn as AggregateFunctionV3)) {\n        throw new SdkError({\n          code: 'JSSDK_AGGREGATE_V3_INVALID_FUNCTION',\n          description: `AggregateV3: \"${fn}\" is not an aggregate function — use one of ${AGGREGATE_FUNCTIONS.join(' ')}.`,\n          status: 400\n        })\n      }\n      const fields = (select as Record<string, unknown>)[fn]\n      if (!Array.isArray(fields) && (typeof fields !== 'object' || fields === null)) {\n        throw new SdkError({\n          code: 'JSSDK_AGGREGATE_V3_INVALID_SELECT',\n          description: `AggregateV3: select.${fn} must be a string[] (default alias) or a { field: alias } map.`,\n          status: 400\n        })\n      }\n    }\n\n    // `TypeCallParams.select` is typed `string[]` for the `list` methods, but the\n    // v3 `aggregate` action takes an object select (`{ sum: { field: alias } }`);\n    // the server accepts it, hence the cast.\n    const params: TypeCallParams = { select: select as unknown as TypeCallParams['select'] }\n    if (options?.params?.filter) {\n      params.filter = options.params.filter\n    }\n\n    const response: AjaxResult<unknown> = await this._b24.actions.v3.call.make<unknown>({\n      method: options.method,\n      params,\n      requestId: options.requestId\n    })\n\n    if (!response.isSuccess) {\n      this._logger.error('aggregateMethod', {\n        method: options.method,\n        requestId: options.requestId,\n        messages: response.getErrorMessages()\n      })\n      for (const [index, error] of response.errors) {\n        result.addError(error, index)\n      }\n      return result\n    }\n\n    // The reference (§7) nests one extra level: { result: { result: { <func>: {...} } } }.\n    // `getData()` unwraps the outer `result`, so the buckets are at `payload.result`.\n    // This shape is unverified against a live portal — be defensive: if a portal\n    // returns the buckets at a single level instead, fall back to the payload and\n    // warn rather than silently returning empty data.\n    const payload = response.getData()?.result as any\n    let buckets: AggregateResultV3\n    if (payload && typeof payload === 'object' && 'result' in payload) {\n      buckets = (payload.result ?? {}) as AggregateResultV3\n    } else if (payload && typeof payload === 'object') {\n      this._logger.warning(`aggregate.make: response has no nested 'result.result' envelope (the v3 reference §7 specifies double nesting); falling back to the top-level 'result'. method=${options.method}`)\n      buckets = payload as AggregateResultV3\n    } else {\n      buckets = {}\n    }\n    return result.setData(buckets)\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/core/actions/v3/batch-by-chunk.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.3.0
+ * @version 2.0.0
  * @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.3.0
+ * @version 2.0.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -8,8 +8,6 @@
  */
 import { AbstractBatch } from '../abstract-batch.mjs';
 import { ApiVersion } from '../../../types/b24.mjs';
-import { versionManager } from '../../version-manager.mjs';
-import { SdkError } from '../../sdk-error.mjs';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -113,13 +111,6 @@ class BatchV3 extends AbstractBatch {
       ...options.options,
       apiVersion: ApiVersion.v3
     };
-    if (versionManager.automaticallyObtainApiVersionForBatch(options.calls) !== opts.apiVersion) {
-      throw new SdkError({
-        code: "JSSDK_CORE_METHOD_NOT_SUPPORT_IN_API_V3",
-        description: `restApi:v3 not support some methods in calls: ${JSON.stringify(options.calls)}`,
-        status: 500
-      });
-    }
     const response = await this._b24.getHttpClient(ApiVersion.v3).batch(options.calls, opts);
     return this._processBatchResponse(response, options.calls, opts);
   }

package/dist/esm/core/actions/v3/batch.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"batch.mjs","sources":["../../../../../src/core/actions/v3/batch.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { CallBatchResult, IB24BatchOptions } from '../../../types/b24'\nimport type {\n  BatchCommandsArrayUniversal,\n  BatchCommandsObjectUniversal,\n  BatchNamedCommandsUniversal\n} from '../../../types/http'\nimport { AbstractBatch } from '../abstract-batch'\nimport { ApiVersion } from '../../../types/b24'\nimport { versionManager } from '../../version-manager'\nimport { SdkError } from '../../sdk-error'\n\nexport type ActionBatchV3 = ActionOptions & {\n  calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal\n  options?: IB24BatchOptions\n}\n\n/**\n * Executes a batch request to the Bitrix24 REST API with a maximum number of commands of no more than 50. `restApi:v3`\n * Allows you to execute multiple requests in a single API call, significantly improving performance.\n *\n * @todo add docs\n */\nexport class BatchV3 extends AbstractBatch {\n  /**\n   * Executes a batch request to the Bitrix24 REST API with a maximum number of commands of no more than 50.\n   * Allows you to execute multiple requests in a single API call, significantly improving performance.\n   *\n   * @template T - The data type returned by batch query commands (default is `unknown`)\n   *\n   * @param {ActionBatchV3} options - parameters for executing the request.\n   *     - `calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal` - Commands to execute in a batch.\n   *        Supports several formats:\n   *        1. Array of tuples: `[['method1', params1], ['method2', params2], ...]`\n   *        2. Array of objects: `[{ method: 'method1', params: params1 }, { method: 'method2', params: params2 }, ...]`\n   *        3. An object with named commands: `{ cmd1: { method: 'method1', params: params1 }, cmd2: ['method2', params2], ...}`\n   *     - `options?: IB24BatchOptions` - Additional options for executing a batch request.\n   *        - `isHaltOnError?: boolean` - Whether to stop execution on the first error (default: true)\n   *        - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging (default: undefined)\n   *        - `returnAjaxResult?: boolean` - Whether to return an AjaxResult object instead of data (default: false)\n   *\n   * @returns {Promise<CallBatchResult<T>>} A promise that is resolved by the result of executing a batch request:\n   *     - On success: a `Result` object with the command execution results\n   *     - The structure of the results depends on the format of the `calls` input data:\n   *          - For an array of commands, an array of results in the same order\n   *          - For named commands, an object with keys corresponding to the command names\n   *\n   * @example\n   * interface TaskItem { id: number, title: string }\n   * const response = await b24.actions.v3.batch.make<{ item: TaskItem }>({\n   *   calls: [\n   *     ['tasks.task.get', { id: 1, select: ['id', 'title'] }],\n   *     ['tasks.task.get', { id: 2, select: ['id', 'title'] }],\n   *     ['tasks.task.get', { id: 3, select: ['id', 'title'] }]\n   *   ],\n   *   options: {\n   *     isHaltOnError: true,\n   *     returnAjaxResult: true,\n   *     requestId: 'batch-123'\n   *   }\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   *\n   * const resultData = (response as Result<AjaxResult<{ item: TaskItem }>[]>).getData()\n   * resultData.forEach((resultRow, index) => {\n   *   if (resultRow.isSuccess) {\n   *    console.log(`Item ${index + 1}:`, resultRow.getData()!.result.item)\n   *   }\n   * })\n   *\n   * @example\n   * const response = await b24.actions.v3.batch.make({\n   *   calls: [\n   *     { method: 'tasks.task.get', params: { id: 1, select: ['id', 'title'] } },\n   *     { method: 'tasks.task.get', params: { id: 2, select: ['id', 'title'] } }\n   *   ],\n   *   options: {\n   *     isHaltOnError: true,\n   *     returnAjaxResult: true,\n   *     requestId: 'batch-123'\n   *   }\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   *\n   * @example\n   * interface TaskItem { id: number, title: string }\n   * interface MainEventLogItem { id: number, userId: number }\n   * const response = await b24.actions.v3.batch.make<{ item: TaskItem } | { items: MainEventLogItem[] }>({\n   *   calls: {\n   *     Task: { method: 'tasks.task.get', params: { id: 1, select: ['id', 'title'] } },\n   *     MainEventLog: ['main.eventlog.list', { select: ['id', 'userId'], pagination: { limit: 5 } }]\n   *   },\n   *   options: {\n   *     isHaltOnError: true,\n   *     returnAjaxResult: true,\n   *     requestId: 'batch-123'\n   *   }\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   *\n   * const results = response.getData() as Record<string, AjaxResult<{ item: TaskItem } | { items: MainEventLogItem[] }>>\n   * console.log('Task:', results.Task.getData()?.result.item as TaskItem)\n   * console.log('MainEventLog:', results.MainEventLog.getData()?.result.items as MainEventLogItem[])\n   *\n   * @warning The maximum number of commands in one batch request is 50.\n   * @note A batch request executes faster than sequential single calls,\n   *     but if one command fails, the entire batch may fail\n   *     (depending on API settings and options).\n   */\n  public override async make<T = unknown>(options: ActionBatchV3): Promise<CallBatchResult<T>> {\n    const opts = {\n      ...options.options,\n      apiVersion: ApiVersion.v3\n    }\n\n    if (versionManager.automaticallyObtainApiVersionForBatch(options.calls) !== opts.apiVersion) {\n      throw new SdkError({\n        code: 'JSSDK_CORE_METHOD_NOT_SUPPORT_IN_API_V3',\n        description: `restApi:v3 not support some methods in calls: ${JSON.stringify(options.calls)}`,\n        status: 500\n      })\n    }\n\n    const response = await this._b24.getHttpClient(ApiVersion.v3).batch<T>(options.calls, opts)\n\n    return this._processBatchResponse<T>(response, options.calls, opts)\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAuBO,MAAM,gBAAgB,aAAA,CAAc;AAAA,EAvB3C;AAuB2C,IAAA,MAAA,CAAA,IAAA,EAAA,SAAA,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4FzC,MAAsB,KAAkB,OAAA,EAAqD;AAC3F,IAAA,MAAM,IAAA,GAAO;AAAA,MACX,GAAG,OAAA,CAAQ,OAAA;AAAA,MACX,YAAY,UAAA,CAAW;AAAA,KACzB;AAEA,IAAA,IAAI,eAAe,qCAAA,CAAsC,OAAA,CAAQ,KAAK,CAAA,KAAM,KAAK,UAAA,EAAY;AAC3F,MAAA,MAAM,IAAI,QAAA,CAAS;AAAA,QACjB,IAAA,EAAM,yCAAA;AAAA,QACN,aAAa,CAAA,8CAAA,EAAiD,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ,KAAK,CAAC,CAAA,CAAA;AAAA,QAC3F,MAAA,EAAQ;AAAA,OACT,CAAA;AAAA,IACH;AAEA,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,aAAA,CAAc,UAAA,CAAW,EAAE,CAAA,CAAE,KAAA,CAAS,OAAA,CAAQ,KAAA,EAAO,IAAI,CAAA;AAE1F,IAAA,OAAO,IAAA,CAAK,qBAAA,CAAyB,QAAA,EAAU,OAAA,CAAQ,OAAO,IAAI,CAAA;AAAA,EACpE;AACF;;;;"}
+{"version":3,"file":"batch.mjs","sources":["../../../../../src/core/actions/v3/batch.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { CallBatchResult, IB24BatchOptions } from '../../../types/b24'\nimport type {\n  BatchCommandsArrayUniversal,\n  BatchCommandsObjectUniversal,\n  BatchNamedCommandsUniversal\n} from '../../../types/http'\nimport { AbstractBatch } from '../abstract-batch'\nimport { ApiVersion } from '../../../types/b24'\n\nexport type ActionBatchV3 = ActionOptions & {\n  calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal\n  options?: IB24BatchOptions\n}\n\n/**\n * Executes a batch request to the Bitrix24 REST API with a maximum number of commands of no more than 50. `restApi:v3`\n * Allows you to execute multiple requests in a single API call, significantly improving performance.\n *\n * @todo add docs\n */\nexport class BatchV3 extends AbstractBatch {\n  /**\n   * Executes a batch request to the Bitrix24 REST API with a maximum number of commands of no more than 50.\n   * Allows you to execute multiple requests in a single API call, significantly improving performance.\n   *\n   * @template T - The data type returned by batch query commands (default is `unknown`)\n   *\n   * @param {ActionBatchV3} options - parameters for executing the request.\n   *     - `calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal` - Commands to execute in a batch.\n   *        Supports several formats:\n   *        1. Array of tuples: `[['method1', params1], ['method2', params2], ...]`\n   *        2. Array of objects: `[{ method: 'method1', params: params1 }, { method: 'method2', params: params2 }, ...]`\n   *        3. An object with named commands: `{ cmd1: { method: 'method1', params: params1 }, cmd2: ['method2', params2], ...}`\n   *     - `options?: IB24BatchOptions` - Additional options for executing a batch request.\n   *        - `isHaltOnError?: boolean` - Whether to stop execution on the first error (default: true)\n   *        - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging (default: undefined)\n   *        - `returnAjaxResult?: boolean` - Whether to return an AjaxResult object instead of data (default: false)\n   *\n   * @returns {Promise<CallBatchResult<T>>} A promise that is resolved by the result of executing a batch request:\n   *     - On success: a `Result` object with the command execution results\n   *     - The structure of the results depends on the format of the `calls` input data:\n   *          - For an array of commands, an array of results in the same order\n   *          - For named commands, an object with keys corresponding to the command names\n   *\n   * @example\n   * interface TaskItem { id: number, title: string }\n   * const response = await b24.actions.v3.batch.make<{ item: TaskItem }>({\n   *   calls: [\n   *     ['tasks.task.get', { id: 1, select: ['id', 'title'] }],\n   *     ['tasks.task.get', { id: 2, select: ['id', 'title'] }],\n   *     ['tasks.task.get', { id: 3, select: ['id', 'title'] }]\n   *   ],\n   *   options: {\n   *     isHaltOnError: true,\n   *     returnAjaxResult: true,\n   *     requestId: 'batch-123'\n   *   }\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   *\n   * const resultData = (response as Result<AjaxResult<{ item: TaskItem }>[]>).getData()\n   * resultData.forEach((resultRow, index) => {\n   *   if (resultRow.isSuccess) {\n   *    console.log(`Item ${index + 1}:`, resultRow.getData()!.result.item)\n   *   }\n   * })\n   *\n   * @example\n   * const response = await b24.actions.v3.batch.make({\n   *   calls: [\n   *     { method: 'tasks.task.get', params: { id: 1, select: ['id', 'title'] } },\n   *     { method: 'tasks.task.get', params: { id: 2, select: ['id', 'title'] } }\n   *   ],\n   *   options: {\n   *     isHaltOnError: true,\n   *     returnAjaxResult: true,\n   *     requestId: 'batch-123'\n   *   }\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   *\n   * @example\n   * interface TaskItem { id: number, title: string }\n   * interface MainEventLogItem { id: number, userId: number }\n   * const response = await b24.actions.v3.batch.make<{ item: TaskItem } | { items: MainEventLogItem[] }>({\n   *   calls: {\n   *     Task: { method: 'tasks.task.get', params: { id: 1, select: ['id', 'title'] } },\n   *     MainEventLog: ['main.eventlog.list', { select: ['id', 'userId'], pagination: { limit: 5 } }]\n   *   },\n   *   options: {\n   *     isHaltOnError: true,\n   *     returnAjaxResult: true,\n   *     requestId: 'batch-123'\n   *   }\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   *\n   * const results = response.getData() as Record<string, AjaxResult<{ item: TaskItem } | { items: MainEventLogItem[] }>>\n   * console.log('Task:', results.Task.getData()?.result.item as TaskItem)\n   * console.log('MainEventLog:', results.MainEventLog.getData()?.result.items as MainEventLogItem[])\n   *\n   * @warning The maximum number of commands in one batch request is 50.\n   * @note A batch request executes faster than sequential single calls,\n   *     but if one command fails, the entire batch may fail\n   *     (depending on API settings and options).\n   */\n  public override async make<T = unknown>(options: ActionBatchV3): Promise<CallBatchResult<T>> {\n    const opts = {\n      ...options.options,\n      apiVersion: ApiVersion.v3\n    }\n\n    // No client-side allowlist: every command is sent to the v3 batch endpoint\n    // and the server validates each method (unknown ones come back as errors).\n    const response = await this._b24.getHttpClient(ApiVersion.v3).batch<T>(options.calls, opts)\n\n    return this._processBatchResponse<T>(response, options.calls, opts)\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;AAqBO,MAAM,gBAAgB,aAAA,CAAc;AAAA,EArB3C;AAqB2C,IAAA,MAAA,CAAA,IAAA,EAAA,SAAA,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4FzC,MAAsB,KAAkB,OAAA,EAAqD;AAC3F,IAAA,MAAM,IAAA,GAAO;AAAA,MACX,GAAG,OAAA,CAAQ,OAAA;AAAA,MACX,YAAY,UAAA,CAAW;AAAA,KACzB;AAIA,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,aAAA,CAAc,UAAA,CAAW,EAAE,CAAA,CAAE,KAAA,CAAS,OAAA,CAAQ,KAAA,EAAO,IAAI,CAAA;AAE1F,IAAA,OAAO,IAAA,CAAK,qBAAA,CAAyB,QAAA,EAAU,OAAA,CAAQ,OAAO,IAAI,CAAA;AAAA,EACpE;AACF;;;;"}

package/dist/esm/core/actions/v3/call-list.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.3.0
+ * @version 2.0.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -8,6 +8,7 @@
  */
 import { AbstractAction } from '../abstract-action.mjs';
 import { Result } from '../../result.mjs';
+import { keysetPaginate, KeysetPaginationError } from './_keyset-paginate.mjs';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -82,54 +83,39 @@ class CallListV3 extends AbstractAction {
       filter: [...params["filter"] || []],
       pagination: { page: 0, limit: batchSize }
     };
-    let allItems = [];
-    let isContinue = true;
-    let nextId = 0;
-    do {
-      const sendParams = { ...requestParams, filter: [...requestParams.filter] };
-      sendParams.filter.push([cursorIdKey, ">", nextId]);
-      const response = await this._b24.actions.v3.call.make({
+    const allItems = [];
+    try {
+      for await (const page of keysetPaginate(this._b24, this._logger, {
         method: options.method,
-        params: sendParams,
-        requestId: options.requestId
-      });
-      if (!response.isSuccess) {
-        this._logger.error("callFastListMethod", {
-          method: options.method,
-          requestId: options.requestId,
-          messages: response.getErrorMessages()
-        });
-        for (const [index, error] of response.errors) {
-          result.addError(error, index);
+        requestId: options.requestId,
+        customKeyForResult,
+        initialCursor: 0,
+        // Emulated keyset: append the `[cursorIdKey, '>', cursor]` page filter.
+        buildParams: /* @__PURE__ */ __name((cursor) => ({ ...requestParams, filter: [...requestParams.filter, [cursorIdKey, ">", cursor]] }), "buildParams"),
+        // Advance by the numeric id read from the last item via `idKey`. A
+        // non-numeric value (almost always an `idKey` that doesn't match the
+        // response field — e.g. sorting by `ID` while the response carries a
+        // lowercase `id`) stops the walk instead of silently truncating.
+        readNextCursor: /* @__PURE__ */ __name((lastItem) => {
+          const value = Number.parseInt(lastItem[idKey], 10);
+          return Number.isFinite(value) ? value : null;
+        }, "readNextCursor"),
+        noCursorWarning: `callList.make: pagination stops here \u2014 no numeric id could be read from the returned items via idKey "${idKey}". Make sure idKey matches the id field in the response; if the sortable field name differs from it, also set cursorIdKey (e.g. idKey: 'id', cursorIdKey: 'ID').`,
+        errorLabel: "callFastListMethod"
+      })) {
+        for (const item of page) {
+          allItems.push(item);
         }
-        isContinue = false;
-        break;
       }
-      const responseData = response.getData();
-      if (!responseData) {
-        isContinue = false;
-        break;
-      }
-      const resultData = responseData.result[customKeyForResult];
-      if (resultData.length === 0) {
-        isContinue = false;
-        break;
-      }
-      allItems = [...allItems, ...resultData];
-      if (resultData.length < batchSize) {
-        isContinue = false;
-        break;
-      }
-      const lastItem = resultData[resultData.length - 1];
-      const cursorValue = lastItem ? Number.parseInt(lastItem[idKey], 10) : Number.NaN;
-      if (Number.isFinite(cursorValue)) {
-        nextId = cursorValue;
+    } catch (error) {
+      if (error instanceof KeysetPaginationError) {
+        for (const [index, err] of error.errors) {
+          result.addError(err, index);
+        }
       } else {
-        this._logger.warning(`callList.make: pagination stops here \u2014 no numeric id could be read from the returned items via idKey "${idKey}". Make sure idKey matches the id field in the response; if the sortable field name differs from it, also set cursorIdKey (e.g. idKey: 'id', cursorIdKey: 'ID').`);
-        isContinue = false;
-        break;
+        throw error;
       }
-    } while (isContinue);
+    }
     return result.setData(allItems);
   }
 }

package/dist/esm/core/actions/v3/call-list.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"call-list.mjs","sources":["../../../../../src/core/actions/v3/call-list.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { TypeCallParams } from '../../../types/http'\nimport type { AjaxResult } from '../../http/ajax-result'\nimport { AbstractAction } from '../abstract-action'\nimport { Result } from '../../result'\n\nexport type ActionCallListV3 = ActionOptions & {\n  method: string\n  params?: Omit<TypeCallParams, 'pagination' | 'order'>\n  idKey?: string\n  cursorIdKey?: string\n  customKeyForResult: string\n  requestId?: string\n  limit?: number\n}\n\n/**\n * Fast data retrieval without counting the total number of records. `restApi:v3`\n *\n * @todo add docs\n */\nexport class CallListV3 extends AbstractAction {\n  /**\n   * Fast data retrieval without counting the total number of records.\n   *\n   * @template T - The type of the elements of the returned array (default is `unknown`).\n   *\n   * @param {ActionCallListV3} options - parameters for executing the request.\n   *     - `method: string` - The name of the REST API method that returns a list of data (for example: `crm.item.list`, `tasks.task.list`)\n   *     - `params?: Omit<TypeCallParams, 'pagination' | 'order'>` - Request parameters, excluding the `pagination` and `order` parameters,\n   *         since the method is designed to obtain all data in one call.\n   *         Note: Use `filter`, `order`, and `select` to control the selection.\n   *     - `idKey?: string` - The name of the id field as it appears in each RESPONSE item; its value\n   *         drives the cursor. Default is 'id'. Set it to match the id field the method returns.\n   *     - `cursorIdKey?: string` - The field name used in the REQUEST for `order` and the\n   *         `[field, '>', n]` page filter. Defaults to `idKey`. Set it only when the sortable /\n   *         filterable field name differs from the response field name (e.g. an uppercase request\n   *         field but a lowercase response id): pass `idKey: 'id', cursorIdKey: 'ID'`.\n   *     - `customKeyForResult: string` - A custom key indicating that the response REST API will be\n   *        grouped by this field.\n   *        Example: `items` to group a list of CRM items.\n   *    - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging.\n   *    - `limit?: number` - How many records to retrieve at a time. Default is `50`. Maximum is `1000`.\n   *\n   * @returns {Promise<Result<T[]>>} A promise that resolves to the result of an REST API call.\n   *\n   * @example\n   * import { Text } from '@bitrix24/b24jssdk'\n   *\n   * interface MainEventLogItem { id: number, userId: number }\n   * const sixMonthAgo = new Date()\n   * sixMonthAgo.setMonth((new Date()).getMonth() - 6)\n   * sixMonthAgo.setHours(0, 0, 0)\n   * const response = await b24.actions.v3.callList.make<MainEventLogItem>({\n   *   method: 'main.eventlog.list',\n   *   params: {\n   *     filter: [\n   *       ['timestampX', '>=', Text.toB24Format(sixMonthAgo)] // created at least 6 months ago\n   *     ],\n   *     select: ['id', 'userId']\n   *   },\n   *   idKey: 'id',\n   *   customKeyForResult: 'items',\n   *   requestId: 'eventlog-123',\n   *   limit: 60\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   * const list = response.getData()\n   * console.log(`Result: ${list?.length}`) // Number of items received\n   */\n  public override async make<T = unknown>(options: ActionCallListV3): Promise<Result<T[]>> {\n    const batchSize = options?.limit ?? 50\n    const result: Result<T[]> = new Result()\n\n    const idKey = options?.idKey ?? 'id'\n    const cursorIdKey = options?.cursorIdKey ?? idKey\n    const customKeyForResult = options?.customKeyForResult ?? null\n    const params = options?.params ?? {}\n\n    // Warn and strip user-provided `order` — cursor pagination requires ordering by cursorIdKey only\n    if ('order' in params && params['order']) {\n      this._logger.warning('callList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by cursorIdKey. Use `filter` to narrow results instead.')\n    }\n\n    const { order: _ignoredOrder, ...restParams } = params as TypeCallParams\n    const requestParams: TypeCallParams = {\n      ...restParams,\n      order: { [cursorIdKey]: 'ASC' },\n      filter: [...(params['filter'] || [])],\n      pagination: { page: 0, limit: batchSize }\n    }\n\n    let allItems: T[] = []\n    let isContinue = true\n    let nextId = 0\n    do {\n      const sendParams = { ...requestParams, filter: [...requestParams.filter] }\n      sendParams.filter.push([cursorIdKey, '>', nextId])\n      const response: AjaxResult<T> = await this._b24.actions.v3.call.make<T>({\n        method: options.method,\n        params: sendParams,\n        requestId: options.requestId\n      })\n\n      if (!response.isSuccess) {\n        this._logger.error('callFastListMethod', {\n          method: options.method,\n          requestId: options.requestId,\n          messages: response.getErrorMessages()\n        })\n        for (const [index, error] of response.errors) {\n          result.addError(error, index)\n        }\n        isContinue = false\n        break\n      }\n      const responseData = response.getData()\n      if (!responseData) {\n        isContinue = false\n        break\n      }\n\n      const resultData = (responseData.result as any)[customKeyForResult] as T[]\n      if (resultData.length === 0) {\n        isContinue = false\n        break\n      }\n\n      allItems = [...allItems, ...resultData]\n\n      if (resultData.length < batchSize) {\n        isContinue = false\n        break\n      }\n\n      // Update the filter for the next iteration\n      const lastItem = resultData[resultData.length - 1] as Record<string, any>\n      const cursorValue = lastItem ? Number.parseInt(lastItem[idKey], 10) : Number.NaN\n      if (Number.isFinite(cursorValue)) {\n        nextId = cursorValue\n      } else {\n        // A full page came back, yet no usable numeric cursor id could be read from\n        // its items via `idKey` — almost always an `idKey` that doesn't match the\n        // response field (e.g. a request that sorts by `ID` while the response\n        // carries a lowercase `id`). Without a cursor we can't advance, so stop and\n        // tell the caller how to fix it instead of silently truncating.\n        this._logger.warning(`callList.make: pagination stops here — no numeric id could be read from the returned items via idKey \"${idKey}\". Make sure idKey matches the id field in the response; if the sortable field name differs from it, also set cursorIdKey (e.g. idKey: 'id', cursorIdKey: 'ID').`)\n        isContinue = false\n        break\n      }\n    } while (isContinue)\n\n    return result.setData(allItems)\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"call-list.mjs","sources":["../../../../../src/core/actions/v3/call-list.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { TypeCallParams } from '../../../types/http'\nimport { AbstractAction } from '../abstract-action'\nimport { Result } from '../../result'\nimport { keysetPaginate, KeysetPaginationError } from './_keyset-paginate'\n\nexport type ActionCallListV3 = ActionOptions & {\n  method: string\n  params?: Omit<TypeCallParams, 'pagination' | 'order'>\n  idKey?: string\n  cursorIdKey?: string\n  customKeyForResult: string\n  requestId?: string\n  limit?: number\n}\n\n/**\n * Fast data retrieval without counting the total number of records. `restApi:v3`\n *\n * @todo add docs\n */\nexport class CallListV3 extends AbstractAction {\n  /**\n   * Fast data retrieval without counting the total number of records.\n   *\n   * @template T - The type of the elements of the returned array (default is `unknown`).\n   *\n   * @param {ActionCallListV3} options - parameters for executing the request.\n   *     - `method: string` - The name of the REST API method that returns a list of data (for example: `crm.item.list`, `tasks.task.list`)\n   *     - `params?: Omit<TypeCallParams, 'pagination' | 'order'>` - Request parameters, excluding the `pagination` and `order` parameters,\n   *         since the method is designed to obtain all data in one call.\n   *         Note: Use `filter`, `order`, and `select` to control the selection.\n   *     - `idKey?: string` - The name of the id field as it appears in each RESPONSE item; its value\n   *         drives the cursor. Default is 'id'. Set it to match the id field the method returns.\n   *     - `cursorIdKey?: string` - The field name used in the REQUEST for `order` and the\n   *         `[field, '>', n]` page filter. Defaults to `idKey`. Set it only when the sortable /\n   *         filterable field name differs from the response field name (e.g. an uppercase request\n   *         field but a lowercase response id): pass `idKey: 'id', cursorIdKey: 'ID'`.\n   *     - `customKeyForResult: string` - A custom key indicating that the response REST API will be\n   *        grouped by this field.\n   *        Example: `items` to group a list of CRM items.\n   *    - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging.\n   *    - `limit?: number` - How many records to retrieve at a time. Default is `50`. Maximum is `1000`.\n   *\n   * @returns {Promise<Result<T[]>>} A promise that resolves to the result of an REST API call.\n   *\n   * @example\n   * import { Text } from '@bitrix24/b24jssdk'\n   *\n   * interface MainEventLogItem { id: number, userId: number }\n   * const sixMonthAgo = new Date()\n   * sixMonthAgo.setMonth((new Date()).getMonth() - 6)\n   * sixMonthAgo.setHours(0, 0, 0)\n   * const response = await b24.actions.v3.callList.make<MainEventLogItem>({\n   *   method: 'main.eventlog.list',\n   *   params: {\n   *     filter: [\n   *       ['timestampX', '>=', Text.toB24Format(sixMonthAgo)] // created at least 6 months ago\n   *     ],\n   *     select: ['id', 'userId']\n   *   },\n   *   idKey: 'id',\n   *   customKeyForResult: 'items',\n   *   requestId: 'eventlog-123',\n   *   limit: 60\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   * const list = response.getData()\n   * console.log(`Result: ${list?.length}`) // Number of items received\n   */\n  public override async make<T = unknown>(options: ActionCallListV3): Promise<Result<T[]>> {\n    const batchSize = options?.limit ?? 50\n    const result: Result<T[]> = new Result()\n\n    const idKey = options?.idKey ?? 'id'\n    const cursorIdKey = options?.cursorIdKey ?? idKey\n    const customKeyForResult = options?.customKeyForResult ?? null\n    const params = options?.params ?? {}\n\n    // Warn and strip user-provided `order` — cursor pagination requires ordering by cursorIdKey only\n    if ('order' in params && params['order']) {\n      this._logger.warning('callList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by cursorIdKey. Use `filter` to narrow results instead.')\n    }\n\n    const { order: _ignoredOrder, ...restParams } = params as TypeCallParams\n    const requestParams: TypeCallParams = {\n      ...restParams,\n      order: { [cursorIdKey]: 'ASC' },\n      filter: [...(params['filter'] || [])],\n      pagination: { page: 0, limit: batchSize }\n    }\n\n    const allItems: T[] = []\n    try {\n      for await (const page of keysetPaginate<T>(this._b24, this._logger, {\n        method: options.method,\n        requestId: options.requestId,\n        customKeyForResult,\n        initialCursor: 0,\n        // Emulated keyset: append the `[cursorIdKey, '>', cursor]` page filter.\n        buildParams: cursor => ({ ...requestParams, filter: [...requestParams.filter, [cursorIdKey, '>', cursor]] }),\n        // Advance by the numeric id read from the last item via `idKey`. A\n        // non-numeric value (almost always an `idKey` that doesn't match the\n        // response field — e.g. sorting by `ID` while the response carries a\n        // lowercase `id`) stops the walk instead of silently truncating.\n        readNextCursor: (lastItem) => {\n          const value = Number.parseInt(lastItem[idKey], 10)\n          return Number.isFinite(value) ? value : null\n        },\n        noCursorWarning: `callList.make: pagination stops here — no numeric id could be read from the returned items via idKey \"${idKey}\". Make sure idKey matches the id field in the response; if the sortable field name differs from it, also set cursorIdKey (e.g. idKey: 'id', cursorIdKey: 'ID').`,\n        errorLabel: 'callFastListMethod'\n      })) {\n        for (const item of page) {\n          allItems.push(item)\n        }\n      }\n    } catch (error) {\n      if (error instanceof KeysetPaginationError) {\n        for (const [index, err] of error.errors) {\n          result.addError(err, index)\n        }\n      } else {\n        throw error\n      }\n    }\n\n    return result.setData(allItems)\n  }\n}\n"],"names":[],"mappings":"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"}