@bitrix24/b24jssdk 1.2.0 → 2.0.0

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

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.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.2.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 });
@@ -22,11 +23,15 @@ class CallListV3 extends AbstractAction {
    *
    * @param {ActionCallListV3} options - parameters for executing the request.
    *     - `method: string` - The name of the REST API method that returns a list of data (for example: `crm.item.list`, `tasks.task.list`)
-   *     - `params?: Omit<TypeCallParams, 'pagination'>` - Request parameters, excluding the `pagination` parameter,
+   *     - `params?: Omit<TypeCallParams, 'pagination' | 'order'>` - Request parameters, excluding the `pagination` and `order` parameters,
    *         since the method is designed to obtain all data in one call.
    *         Note: Use `filter`, `order`, and `select` to control the selection.
-   *     - `idKey?: string` - The name of the field containing the unique identifier of the element.
-   *         Default is 'id'. Alternatively, it can be another field, depending on the REST API data structure.
+   *     - `idKey?: string` - The name of the id field as it appears in each RESPONSE item; its value
+   *         drives the cursor. Default is 'id'. Set it to match the id field the method returns.
+   *     - `cursorIdKey?: string` - The field name used in the REQUEST for `order` and the
+   *         `[field, '>', n]` page filter. Defaults to `idKey`. Set it only when the sortable /
+   *         filterable field name differs from the response field name (e.g. an uppercase request
+   *         field but a lowercase response id): pass `idKey: 'id', cursorIdKey: 'ID'`.
    *     - `customKeyForResult: string` - A custom key indicating that the response REST API will be
    *        grouped by this field.
    *        Example: `items` to group a list of CRM items.
@@ -65,64 +70,52 @@ class CallListV3 extends AbstractAction {
     const batchSize = options?.limit ?? 50;
     const result = new Result();
     const idKey = options?.idKey ?? "id";
+    const cursorIdKey = options?.cursorIdKey ?? idKey;
     const customKeyForResult = options?.customKeyForResult ?? null;
     const params = options?.params ?? {};
     if ("order" in params && params["order"]) {
-      this._logger.warning("callList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by idKey. Use `filter` to narrow results instead.");
+      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.");
     }
     const { order: _ignoredOrder, ...restParams } = params;
     const requestParams = {
       ...restParams,
-      order: { [idKey]: "ASC" },
+      order: { [cursorIdKey]: "ASC" },
       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([idKey, ">", 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];
-      if (lastItem && typeof lastItem[idKey] !== "undefined") {
-        nextId = Number.parseInt(lastItem[idKey]);
+    } catch (error) {
+      if (error instanceof KeysetPaginationError) {
+        for (const [index, err] of error.errors) {
+          result.addError(err, index);
+        }
       } else {
-        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  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'>` - Request parameters, excluding the `pagination` parameter,\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 field containing the unique identifier of the element.\n   *         Default is 'id'. Alternatively, it can be another field, depending on the REST API data structure.\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 customKeyForResult = options?.customKeyForResult ?? null\n    const params = options?.params ?? {}\n\n    // Warn and strip user-provided `order` — cursor pagination requires ordering by idKey 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 idKey. Use `filter` to narrow results instead.')\n    }\n\n    const { order: _ignoredOrder, ...restParams } = params as TypeCallParams\n    const requestParams: TypeCallParams = {\n      ...restParams,\n      order: { [idKey]: '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([idKey, '>', 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      if (lastItem && typeof lastItem[idKey] !== 'undefined') {\n        nextId = Number.parseInt(lastItem[idKey] as string)\n      } else {\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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"}

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

@@ -0,0 +1,116 @@
+/**
+ * @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';
+import { keysetPaginate, KeysetPaginationError } from './_keyset-paginate.mjs';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class CallTailV3 extends AbstractAction {
+  static {
+    __name(this, "CallTailV3");
+  }
+  /**
+   * Returns every record of a `tail` method as one array.
+   *
+   * @template T - The type of the elements of the returned array (default is `unknown`).
+   *
+   * @param {ActionCallTailV3} options - parameters for executing the request.
+   *     - `method: string` - A REST API `tail` method name (for example: `main.eventlog.tail`).
+   *     - `params?: Omit<TypeCallParams, 'pagination' | 'order' | 'cursor'>` - Request parameters
+   *         (`filter`, `select`). `pagination`, `order` and `cursor` are managed by this helper.
+   *         The cursor field must NOT be used in `filter`.
+   *     - `cursorField?: string` - The DTO field that drives the cursor. Default is `id`.
+   *     - `order?: 'ASC' | 'DESC'` - Cursor direction. Default is `ASC`. For `DESC` you MUST pass
+   *         `initialValue` (the server pages by `field < value`, so the default `0` returns nothing).
+   *     - `customKeyForResult?: string` - The key the response groups rows under. Default is `items`.
+   *     - `requestId?: string` - Unique request identifier for tracking.
+   *     - `limit?: number` - How many records to retrieve at a time. Default is `50`. Maximum is `1000`.
+   *     - `initialValue?: number | string` - Cursor start value for the first page. Default is `0`
+   *         (valid for ascending numeric fields); required for `DESC` and for non-numeric fields.
+   *
+   * @returns {Promise<Result<T[]>>} A promise that resolves to the result of an REST API call.
+   *
+   * @example
+   * const response = await b24.actions.v3.callTail.make<{ id: string }>({
+   *   method: 'main.eventlog.tail',
+   *   params: { select: ['id', 'auditType'] },
+   *   cursorField: 'id',
+   *   customKeyForResult: 'items'
+   * })
+   * if (!response.isSuccess) {
+   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)
+   * }
+   * console.log(`Result: ${response.getData()?.length}`)
+   */
+  async make(options) {
+    const batchSize = options?.limit ?? 50;
+    const result = new Result();
+    const cursorField = options?.cursorField ?? "id";
+    const order = options?.order ?? "ASC";
+    const customKeyForResult = options?.customKeyForResult ?? "items";
+    const params = options?.params ?? {};
+    if (/desc/i.test(order) && options?.initialValue === void 0) {
+      throw new SdkError({
+        code: "JSSDK_CORE_B24_CALL_TAIL_DESC_REQUIRES_INITIAL_VALUE",
+        description: 'callTail.make: order "DESC" requires an explicit `initialValue` (the server pages by `field < value`, so the default 0 returns nothing). Pass `initialValue` set to the type maximum / newest value.',
+        status: 500
+      });
+    }
+    if (Array.isArray(params["filter"]) && params["filter"].some((c) => Array.isArray(c) && c[0] === cursorField)) {
+      this._logger.warning(`callTail.make: the cursor field "${cursorField}" must not appear in \`filter\` \u2014 the server orders and pages by it and will reject a filter on the same field (INVALIDFILTEREXCEPTION). Remove it from \`filter\`.`);
+    }
+    let select = params["select"];
+    if (Array.isArray(select)) {
+      if (!select.includes(cursorField)) {
+        select = [...select, cursorField];
+      }
+    } else if (cursorField !== "id") {
+      this._logger.warning(`callTail.make: no \`select\` provided with a non-default cursorField "${cursorField}" \u2014 make sure it is in the server's default field set, otherwise pass \`select\` including "${cursorField}" so the cursor can advance.`);
+    }
+    const { select: _ignoredSelect, ...restParams } = params;
+    const allItems = [];
+    try {
+      for await (const page of keysetPaginate(this._b24, this._logger, {
+        method: options.method,
+        requestId: options.requestId,
+        customKeyForResult,
+        initialCursor: options?.initialValue ?? 0,
+        // Native keyset: drive the server's `cursor: { field, value, order, limit }`.
+        buildParams: /* @__PURE__ */ __name((cursor) => ({
+          ...restParams,
+          ...select ? { select } : {},
+          cursor: { field: cursorField, value: cursor, order, limit: batchSize }
+        }), "buildParams"),
+        // Advance by the raw cursor-field value from the last item; a missing
+        // value (cursorField not selected / wrong name) stops the walk.
+        readNextCursor: /* @__PURE__ */ __name((lastItem) => lastItem[cursorField] ?? null, "readNextCursor"),
+        noCursorWarning: `callTail.make: pagination stops here \u2014 no value could be read from the returned items via cursorField "${cursorField}". Make sure cursorField matches a field present in the response (and in \`select\`).`,
+        errorLabel: "callTailMethod"
+      })) {
+        for (const item of page) {
+          allItems.push(item);
+        }
+      }
+    } catch (error) {
+      if (error instanceof KeysetPaginationError) {
+        for (const [index, err] of error.errors) {
+          result.addError(err, index);
+        }
+      } else {
+        throw error;
+      }
+    }
+    return result.setData(allItems);
+  }
+}
+
+export { CallTailV3 };
+//# sourceMappingURL=call-tail.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"call-tail.mjs","sources":["../../../../../src/core/actions/v3/call-tail.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { TypeCallParams } from '../../../types/http'\nimport { AbstractAction } from '../abstract-action'\nimport { Result } from '../../result'\nimport { SdkError } from '../../sdk-error'\nimport { keysetPaginate, KeysetPaginationError } from './_keyset-paginate'\n\nexport type ActionCallTailV3 = ActionOptions & {\n  method: string\n  params?: Omit<TypeCallParams, 'pagination' | 'order' | 'cursor'>\n  cursorField?: string\n  order?: 'ASC' | 'DESC' | 'asc' | 'desc' | string\n  customKeyForResult?: string\n  requestId?: string\n  limit?: number\n  initialValue?: number | string\n}\n\n/**\n * Fast data retrieval via the native `tail` (keyset cursor) action, without\n * counting the total number of records. `restApi:v3`\n *\n * The eager counterpart of `fetchTail`: it walks the same native\n * `cursor: { field, value, order, limit }` pagination and returns every record\n * as a single array. See the v3 reference §6.2. The cursor field MUST NOT appear\n * in `filter`.\n */\nexport class CallTailV3 extends AbstractAction {\n  /**\n   * Returns every record of a `tail` method as one array.\n   *\n   * @template T - The type of the elements of the returned array (default is `unknown`).\n   *\n   * @param {ActionCallTailV3} options - parameters for executing the request.\n   *     - `method: string` - A REST API `tail` method name (for example: `main.eventlog.tail`).\n   *     - `params?: Omit<TypeCallParams, 'pagination' | 'order' | 'cursor'>` - Request parameters\n   *         (`filter`, `select`). `pagination`, `order` and `cursor` are managed by this helper.\n   *         The cursor field must NOT be used in `filter`.\n   *     - `cursorField?: string` - The DTO field that drives the cursor. Default is `id`.\n   *     - `order?: 'ASC' | 'DESC'` - Cursor direction. Default is `ASC`. For `DESC` you MUST pass\n   *         `initialValue` (the server pages by `field < value`, so the default `0` returns nothing).\n   *     - `customKeyForResult?: string` - The key the response groups rows under. Default is `items`.\n   *     - `requestId?: string` - Unique request identifier for tracking.\n   *     - `limit?: number` - How many records to retrieve at a time. Default is `50`. Maximum is `1000`.\n   *     - `initialValue?: number | string` - Cursor start value for the first page. Default is `0`\n   *         (valid for ascending numeric fields); required for `DESC` and for non-numeric fields.\n   *\n   * @returns {Promise<Result<T[]>>} A promise that resolves to the result of an REST API call.\n   *\n   * @example\n   * const response = await b24.actions.v3.callTail.make<{ id: string }>({\n   *   method: 'main.eventlog.tail',\n   *   params: { select: ['id', 'auditType'] },\n   *   cursorField: 'id',\n   *   customKeyForResult: 'items'\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   * console.log(`Result: ${response.getData()?.length}`)\n   */\n  public override async make<T = unknown>(options: ActionCallTailV3): Promise<Result<T[]>> {\n    const batchSize = options?.limit ?? 50\n    const result: Result<T[]> = new Result()\n\n    const cursorField = options?.cursorField ?? 'id'\n    const order = options?.order ?? 'ASC'\n    const customKeyForResult = options?.customKeyForResult ?? 'items'\n    const params = options?.params ?? {}\n\n    // DESC keyset needs an explicit start: the server pages by `field < value`,\n    // so the default first-page value 0 would match nothing for a non-negative\n    // field. Require `initialValue` (the type maximum / newest value) for DESC.\n    if (/desc/i.test(order) && options?.initialValue === undefined) {\n      throw new SdkError({\n        code: 'JSSDK_CORE_B24_CALL_TAIL_DESC_REQUIRES_INITIAL_VALUE',\n        description: 'callTail.make: order \"DESC\" requires an explicit `initialValue` (the server pages by `field < value`, so the default 0 returns nothing). Pass `initialValue` set to the type maximum / newest value.',\n        status: 500\n      })\n    }\n\n    // Cursor field must not also live in `filter` (server rejects with\n    // INVALIDFILTEREXCEPTION). Detection covers only the short-form triples.\n    if (Array.isArray(params['filter']) && params['filter'].some((c: any) => Array.isArray(c) && c[0] === cursorField)) {\n      this._logger.warning(`callTail.make: the cursor field \"${cursorField}\" must not appear in \\`filter\\` — the server orders and pages by it and will reject a filter on the same field (INVALIDFILTEREXCEPTION). Remove it from \\`filter\\`.`)\n    }\n\n    // Cursor field must be readable to advance. Append it to an explicit\n    // `select`; warn for a non-default cursorField when `select` is omitted.\n    let select = params['select'] as string[] | undefined\n    if (Array.isArray(select)) {\n      if (!select.includes(cursorField)) {\n        select = [...select, cursorField]\n      }\n    } else if (cursorField !== 'id') {\n      this._logger.warning(`callTail.make: no \\`select\\` provided with a non-default cursorField \"${cursorField}\" — make sure it is in the server's default field set, otherwise pass \\`select\\` including \"${cursorField}\" so the cursor can advance.`)\n    }\n\n    const { select: _ignoredSelect, ...restParams } = params as TypeCallParams\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: options?.initialValue ?? 0,\n        // Native keyset: drive the server's `cursor: { field, value, order, limit }`.\n        buildParams: cursor => ({\n          ...restParams,\n          ...(select ? { select } : {}),\n          cursor: { field: cursorField, value: cursor, order, limit: batchSize }\n        }),\n        // Advance by the raw cursor-field value from the last item; a missing\n        // value (cursorField not selected / wrong name) stops the walk.\n        readNextCursor: lastItem => lastItem[cursorField] ?? null,\n        noCursorWarning: `callTail.make: pagination stops here — no value could be read from the returned items via cursorField \"${cursorField}\". Make sure cursorField matches a field present in the response (and in \\`select\\`).`,\n        errorLabel: 'callTailMethod'\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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"}

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

@@ -1,15 +1,13 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.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 { SdkError } from '../../sdk-error.mjs';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -42,13 +40,6 @@ class CallV3 extends AbstractAction {
    * console.log(response.getData().result.item.title)
    */
   async make(options) {
-    if (!versionManager.isSupport(ApiVersion.v3, options.method)) {
-      throw new SdkError({
-        code: "JSSDK_CORE_METHOD_NOT_SUPPORT_IN_API_V3",
-        description: `restApi:v3 not support method ${options.method}`,
-        status: 500
-      });
-    }
     const params = options.params || {};
     return this._b24.getHttpClient(ApiVersion.v3).call(options.method, params, options.requestId);
   }

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

@@ -1 +1 @@
-{"version":3,"file":"call.mjs","sources":["../../../../../src/core/actions/v3/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 { SdkError } from '../../sdk-error'\n\nexport type ActionCallV3 = ActionOptions & {\n  method: string\n  params?: TypeCallParams\n  requestId?: string\n}\n\n/**\n * Calls the Bitrix24 REST API method `restApi:v3`\n *\n * @todo add docs\n */\nexport class CallV3 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 {ActionCallV3} 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   * interface TaskItem { id: number, title: string }\n   * const response = await b24.actions.v3.call.make<{ item: TaskItem }>({\n   *   method: 'tasks.task.get',\n   *   params: { id: 123, select: ['id', 'title'] },\n   *   requestId: 'task-123'\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   * console.log(response.getData().result.item.title)\n   */\n  public override async make<T = unknown>(options: ActionCallV3): Promise<AjaxResult<T>> {\n    if (!versionManager.isSupport(ApiVersion.v3, options.method)) {\n      throw new SdkError({\n        code: 'JSSDK_CORE_METHOD_NOT_SUPPORT_IN_API_V3',\n        description: `restApi:v3 not support method ${options.method}`,\n        status: 500\n      })\n    }\n    const params = options.params || {}\n    return this._b24.getHttpClient(ApiVersion.v3).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,EAyBzC,MAAsB,KAAkB,OAAA,EAA+C;AACrF,IAAA,IAAI,CAAC,cAAA,CAAe,SAAA,CAAU,WAAW,EAAA,EAAI,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC5D,MAAA,MAAM,IAAI,QAAA,CAAS;AAAA,QACjB,IAAA,EAAM,yCAAA;AAAA,QACN,WAAA,EAAa,CAAA,8BAAA,EAAiC,OAAA,CAAQ,MAAM,CAAA,CAAA;AAAA,QAC5D,MAAA,EAAQ;AAAA,OACT,CAAA;AAAA,IACH;AACA,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/v3/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 ActionCallV3 = ActionOptions & {\n  method: string\n  params?: TypeCallParams\n  requestId?: string\n}\n\n/**\n * Calls the Bitrix24 REST API method `restApi:v3`\n *\n * @todo add docs\n */\nexport class CallV3 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 {ActionCallV3} 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   * interface TaskItem { id: number, title: string }\n   * const response = await b24.actions.v3.call.make<{ item: TaskItem }>({\n   *   method: 'tasks.task.get',\n   *   params: { id: 123, select: ['id', 'title'] },\n   *   requestId: 'task-123'\n   * })\n   * if (!response.isSuccess) {\n   *   throw new Error(`Problem: ${response.getErrorMessages().join('; ')}`)\n   * }\n   * console.log(response.getData().result.item.title)\n   */\n  public override async make<T = unknown>(options: ActionCallV3): Promise<AjaxResult<T>> {\n    // No client-side allowlist: the method is sent straight to the v3 endpoint\n    // and the server decides (an unknown method returns METHODNOTFOUNDEXCEPTION).\n    const params = options.params || {}\n    return this._b24.getHttpClient(ApiVersion.v3).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,EAyBzC,MAAsB,KAAkB,OAAA,EAA+C;AAGrF,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/v3/fetch-list.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.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 { SdkError } from '../../sdk-error.mjs';
+import { keysetPaginate, KeysetPaginationError } from './_keyset-paginate.mjs';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -23,11 +24,15 @@ class FetchListV3 extends AbstractAction {
    *
    * @param {ActionFetchListV3} options - parameters for executing the request.
    *     - `method: string` - The name of the REST API method that returns a list of data (for example: `crm.item.list`, `tasks.task.list`)
-   *     - `params?: Omit<TypeCallParams, 'pagination'>` - Request parameters, excluding the `pagination` parameter,
+   *     - `params?: Omit<TypeCallParams, 'pagination' | 'order'>` - Request parameters, excluding the `pagination` and `order` parameters,
    *         since the method is designed to obtain all data in one call.
    *         Note: Use `filter`, `order`, and `select` to control the selection.
-   *     - `idKey?: string` - The name of the field containing the unique identifier of the element.
-   *         Default is 'id'. Alternatively, it can be another field, depending on the REST API data structure.
+   *     - `idKey?: string` - The name of the id field as it appears in each RESPONSE item; its value
+   *         drives the cursor. Default is 'id'. Set it to match the id field the method returns.
+   *     - `cursorIdKey?: string` - The field name used in the REQUEST for `order` and the
+   *         `[field, '>', n]` page filter. Defaults to `idKey`. Set it only when the sortable /
+   *         filterable field name differs from the response field name (e.g. an uppercase request
+   *         field but a lowercase response id): pass `idKey: 'id', cursorIdKey: 'ID'`.
    *     - `customKeyForResult: string` - A custom key indicating that the response REST API will be
    *        grouped by this field.
    *        Example: `items` to group a list of CRM items.
@@ -66,63 +71,48 @@ class FetchListV3 extends AbstractAction {
   async *make(options) {
     const batchSize = options?.limit ?? 50;
     const idKey = options?.idKey ?? "id";
+    const cursorIdKey = options?.cursorIdKey ?? idKey;
     const customKeyForResult = options?.customKeyForResult ?? null;
     const params = options?.params ?? {};
     if ("order" in params && params["order"]) {
-      this._logger.warning("fetchList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by idKey. Use `filter` to narrow results instead.");
+      this._logger.warning("fetchList.make: user-provided `order` parameter is ignored because cursor-based pagination requires ordering by cursorIdKey. Use `filter` to narrow results instead.");
     }
     const { order: _ignoredOrder, ...restParams } = params;
     const requestParams = {
       ...restParams,
-      order: { [idKey]: "ASC" },
+      order: { [cursorIdKey]: "ASC" },
       filter: [...params["filter"] || []],
       pagination: { page: 0, limit: batchSize }
     };
-    let isContinue = true;
-    let nextId = 0;
-    do {
-      const sendParams = { ...requestParams, filter: [...requestParams.filter] };
-      sendParams.filter.push([idKey, ">", nextId]);
-      const response = await this._b24.actions.v3.call.make({
+    try {
+      yield* keysetPaginate(this._b24, this._logger, {
         method: options.method,
-        params: sendParams,
-        requestId: options.requestId
+        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: `fetchList.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: "fetchListMethod"
       });
-      if (!response.isSuccess) {
-        this._logger.error("fetchListMethod", {
-          method: options.method,
-          requestId: options.requestId,
-          messages: response.getErrorMessages()
-        });
+    } catch (error) {
+      if (error instanceof KeysetPaginationError) {
         throw new SdkError({
           code: "JSSDK_CORE_B24_FETCH_LIST_METHOD_API_V3",
-          description: `API Error: ${response.getErrorMessages().join("; ")}`,
+          description: `API Error: ${error.messages.join("; ")}`,
           status: 500
         });
       }
-      const responseData = response.getData();
-      if (!responseData) {
-        isContinue = false;
-        break;
-      }
-      const resultData = responseData.result[customKeyForResult];
-      if (resultData.length === 0) {
-        isContinue = false;
-        break;
-      }
-      yield resultData;
-      if (resultData.length < batchSize) {
-        isContinue = false;
-        break;
-      }
-      const lastItem = resultData[resultData.length - 1];
-      if (lastItem && typeof lastItem[idKey] !== "undefined") {
-        nextId = Number.parseInt(lastItem[idKey]);
-      } else {
-        isContinue = false;
-        break;
-      }
-    } while (isContinue);
+      throw error;
+    }
   }
 }