@bitrix24/b24jssdk 1.2.0 → 2.0.0

package/dist/cjs/core/http/redact.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.cjs","sources":["../../../../src/core/http/redact.ts"],"sourcesContent":["/**\n * Bounded-depth redact for params that may contain credentials before they\n * enter any logger or error-rendering surface.\n *\n * Callers: `Http._sanitizeParams` (logger context), `_makeAxiosRequest`\n * (`post/send` and `post/catchError` info logs), `AjaxError` constructor\n * (stores `requestInfo.params` exposed by `toJSON()` / `toString()`).\n * Keeping a single source of truth means the redaction list stays\n * consistent across all of them.\n *\n * Two complementary passes run over each value:\n *   1. Key match — a property whose (lower-cased) name is in\n *      {@link SENSITIVE_PARAM_KEYS} has its whole value replaced, so a nested\n *      credential object (e.g. `auth: { application_token }`) is masked\n *      wholesale (#151).\n *   2. Query-string scrub — a *string* value is scanned for\n *      `<sensitive-key>=<value>` pairs and the value is masked. This catches the\n *      batch `cmd[i]` shape (`method?auth=<token>&...`) where `_prepareParams`\n *      has already serialised the credential into text the key walk can't see\n *      (#229).\n *\n * The object walk descends two levels into nested objects and arrays — the\n * minimum that covers batch payloads (`{ cmd: [{ method, params:\n * { ...credentials... } }, ...] }`) and flat one-level-nested payloads like\n * `{ data: { token } }`.\n *\n * Residual risk (documented, accepted):\n *   - credential keys nested deeper than two object levels are NOT masked —\n *     redact at the callsite for those;\n *   - the query-string scrub only masks a `key=value` pair whose key is itself\n *     a sensitive key; a bracketed/encoded query key (`auth[application_token]=`)\n *     is not matched by the string pass (its `auth` prefix object form is,\n *     though, via pass 1).\n *   - `key` is deliberately broad: any property literally named `key` (and any\n *     `?key=…` query pair) is masked. In Bitrix24 REST `key` is a credential\n *     parameter (e.g. the Pull shared config), so this is a conservative,\n *     accepted trade-off — it can over-redact a non-credential field that\n *     happens to be named `key`.\n *   - `signature` is broad in the same way (added in #43 for the Pull channel\n *     HMAC, `TypeChanel.signature`): any property named `signature` and any\n *     `?signature=…` query pair is masked. In the Bitrix24 push/pull domain\n *     `signature` is the channel HMAC, so the breadth is accepted — at the cost\n *     of over-redacting a non-credential field that happens to be named so.\n *   - empty / nullish values are still treated as sensitive — an empty\n *     `access_token` is unusual but not safe to leave un-redacted.\n */\n\nexport const SENSITIVE_PARAM_KEYS: readonly string[] = [\n  'auth',\n  'password',\n  'token',\n  'secret',\n  'access_token',\n  'refresh_token',\n  'client_secret',\n  'application_token',\n  'sessid',\n  'key',\n  'signature'\n]\n\nexport const REDACTED_PLACEHOLDER = '***REDACTED***'\n\n// Matches `<sep><sensitive-key>=<value>` inside a string, case-insensitively,\n// and masks the value. The `([?&]|^)` prefix anchors to a real query-param\n// boundary so a credential name appearing inside a value (`foo=token=x`) or as\n// the tail of a longer key (`access_token` vs `token`) is not mis-matched. The\n// value runs to the next `&`, `#`, or `;`, so a `;`-separated adjacent param is\n// not swallowed into the redacted span. An embedded `?token=…` inside a nested\n// URL value IS masked (intended — still a credential). Single-line: `^` carries\n// no `m` flag, so a credential after a newline in a multi-line string value is\n// not caught (accepted residual risk, same class as encoded/bracketed keys).\nconst QS_SENSITIVE_RE = new RegExp(\n  `([?&]|^)(${SENSITIVE_PARAM_KEYS.join('|')})=[^&#;]*`,\n  'gi'\n)\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n}\n\nfunction redactQueryString(value: string): string {\n  if (!value.includes('=')) return value\n  return value.replace(\n    QS_SENSITIVE_RE,\n    (_match, sep: string, key: string) => `${sep}${key}=${REDACTED_PLACEHOLDER}`\n  )\n}\n\n// String scrubbing runs before the `depth <= 0` guard on purpose: scanning a\n// string is cheap and bounded, so a serialised credential is masked even at a\n// level the object walk would stop descending into. Arrays do not consume a\n// depth slot (only object descent decrements `depth`), so an array nested in an\n// array is still walked.\nfunction redactValue(value: unknown, depth: number): unknown {\n  if (typeof value === 'string') return redactQueryString(value)\n  if (depth <= 0) return value\n  if (isPlainObject(value)) return redactObject(value, depth - 1)\n  if (Array.isArray(value)) return value.map(item => redactValue(item, depth))\n  return value\n}\n\nfunction redactObject(\n  source: Record<string, unknown>,\n  depth: number\n): Record<string, unknown> {\n  const sanitized: Record<string, unknown> = { ...source }\n  for (const key of Object.keys(sanitized)) {\n    if (SENSITIVE_PARAM_KEYS.includes(key.toLowerCase())) {\n      sanitized[key] = REDACTED_PLACEHOLDER\n      continue\n    }\n    sanitized[key] = redactValue(sanitized[key], depth)\n  }\n  return sanitized\n}\n\nconst DEFAULT_REDACT_DEPTH = 2\n\n/**\n * Returns a copy of `params` with any known credential-bearing key replaced by\n * `REDACTED_PLACEHOLDER`, and any credential value embedded in a query-string\n * value masked in place. Walks up to two levels into nested objects/arrays so\n * batch-shaped payloads (`cmd[i].params.<key>` and `cmd[i]` query strings) are\n * covered. Non-object inputs are returned as-is so callers don't have to\n * pre-check.\n */\nexport function redactSensitiveParams(\n  params: Record<string, unknown>\n): Record<string, unknown>\nexport function redactSensitiveParams<T>(params: T): T\nexport function redactSensitiveParams(params: unknown): unknown {\n  if (!isPlainObject(params)) return params\n  return redactObject(params, DEFAULT_REDACT_DEPTH)\n}\n\n/**\n * Redact credential query-string values in a URL string — e.g. a Pull\n * `connectionPath` surfaced by `getDebugInfo()`. Masks every\n * {@link SENSITIVE_PARAM_KEYS} value plus any caller-supplied `extraKeys`\n * (e.g. Pull's `CHANNEL_ID`, a private identifier that is not a global\n * credential key). `extraKeys` are regex-escaped, so any literal key name is\n * safe to pass. Anchored and bounded exactly like the in-object scrub, so a\n * value-position `=` and non-query strings are left intact. Non-string input is\n * returned unchanged (a defensive guard for untyped JS callers).\n */\nexport function redactSensitiveUrl(url: string, extraKeys: readonly string[] = []): string {\n  if (typeof url !== 'string' || !url.includes('=')) return url\n  if (extraKeys.length === 0) return redactQueryString(url)\n  const escaped = extraKeys.map(key => key.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'))\n  const re = new RegExp(\n    `([?&]|^)(${[...SENSITIVE_PARAM_KEYS, ...escaped].join('|')})=[^&#;]*`,\n    'gi'\n  )\n  return url.replace(re, (_match, sep: string, key: string) => `${sep}${key}=${REDACTED_PLACEHOLDER}`)\n}\n"],"names":[],"mappings":"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"}

package/dist/cjs/core/http/v2.cjs

@@ -0,0 +1,85 @@
+/**
+ * @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/
+ */
+'use strict';
+
+const abstractHttp = require('./abstract-http.cjs');
+const b24 = require('../../types/b24.cjs');
+const v2 = require('../interaction/batch/v2.cjs');
+const asArray = require('../interaction/batch/processing/v2/as-array.cjs');
+const asObject = require('../interaction/batch/processing/v2/as-object.cjs');
+const ajaxError = require('./ajax-error.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class HttpV2 extends abstractHttp.AbstractHttp {
+  static {
+    __name(this, "HttpV2");
+  }
+  constructor(authActions, options, restrictionParams) {
+    super(authActions, options, restrictionParams);
+    this._version = b24.ApiVersion.v2;
+  }
+  // region batch ////
+  async batch(calls, options) {
+    const opts = {
+      isHaltOnError: true,
+      ...options
+    };
+    const requestId = opts.requestId ?? this._requestIdGenerator.getRequestId();
+    this._logBatchStart(requestId, calls, opts);
+    const interactionBatch = new v2.InteractionBatchV2({
+      requestId,
+      parallelDefaultValue: !opts.isHaltOnError,
+      restrictionManager: this._restrictionManager
+    });
+    if (Array.isArray(calls)) {
+      interactionBatch.setProcessingStrategy(new asArray.ProcessingAsArrayV2());
+    } else {
+      interactionBatch.setProcessingStrategy(new asObject.ProcessingAsObjectV2());
+    }
+    interactionBatch.addCommands(calls);
+    if (interactionBatch.size > interactionBatch.maxSize) {
+      throw new ajaxError.AjaxError({
+        code: "JSSDK_BATCH_TOO_LARGE",
+        description: `Batch too large: ${interactionBatch.size} commands (max: ${interactionBatch.maxSize})`,
+        status: 400,
+        requestInfo: { method: "batch", params: { cmd: calls }, requestId },
+        originalError: null
+      });
+    }
+    if (interactionBatch.size === 0) {
+      throw new ajaxError.AjaxError({
+        code: "JSSDK_BATCH_EMPTY",
+        description: "Batch must contain at least one command",
+        status: 400,
+        requestInfo: { method: "batch", params: { cmd: calls }, requestId },
+        originalError: null
+      });
+    }
+    const responseBatch = await this.call(
+      "batch",
+      {
+        halt: opts.isHaltOnError ? 1 : 0,
+        cmd: interactionBatch.getCommandsForCall()
+      },
+      requestId
+    );
+    const response = await interactionBatch.prepareResponse(responseBatch);
+    this._logBatchCompletion(
+      requestId,
+      response.getData()?.result?.size ?? 0,
+      response.getErrorMessages().length
+    );
+    return response;
+  }
+  // endregion ////
+}
+
+exports.HttpV2 = HttpV2;
+//# sourceMappingURL=v2.cjs.map

package/dist/cjs/core/http/v2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.cjs","sources":["../../../../src/core/http/v2.ts"],"sourcesContent":["import type {\n  BatchCommandsArrayUniversal,\n  BatchCommandsObjectUniversal,\n  BatchNamedCommandsUniversal, ICallBatchOptions, ICallBatchResult,\n  TypeHttp\n} from '../../types/http'\nimport type { AuthActions } from '../../types/auth'\nimport type { RestrictionParams } from '../../types/limiters'\nimport type { Result } from '../result'\nimport type { BatchPayload } from '../../types/payloads'\nimport { AbstractHttp } from './abstract-http'\nimport { ApiVersion } from '../../types/b24'\nimport { InteractionBatchV2 } from '../interaction/batch/v2'\nimport { ProcessingAsArrayV2 } from '../interaction/batch/processing/v2/as-array'\nimport { ProcessingAsObjectV2 } from '../interaction/batch/processing/v2/as-object'\nimport { AjaxError } from './ajax-error'\n\n/**\n * Class for working with RestApi v2 requests via http\n *\n * @link https://bitrix24.github.io/b24jssdk/\n *\n * @todo docs\n */\nexport class HttpV2 extends AbstractHttp implements TypeHttp {\n  constructor(\n    authActions: AuthActions,\n    options?: null | object,\n    restrictionParams?: Partial<RestrictionParams>\n  ) {\n    super(authActions, options, restrictionParams)\n    this._version = ApiVersion.v2\n  }\n\n  // region batch ////\n  public async batch<T = unknown>(\n    calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal,\n    options?: ICallBatchOptions\n  ): Promise<Result<ICallBatchResult<T>>> {\n    const opts = {\n      isHaltOnError: true,\n      ...options\n    }\n\n    const requestId = opts.requestId ?? this._requestIdGenerator.getRequestId()\n\n    this._logBatchStart(requestId, calls, opts)\n\n    const interactionBatch = new InteractionBatchV2({\n      requestId,\n      parallelDefaultValue: !(opts.isHaltOnError),\n      restrictionManager: this._restrictionManager\n    })\n\n    if (Array.isArray(calls)) {\n      interactionBatch.setProcessingStrategy(new ProcessingAsArrayV2())\n    } else {\n      interactionBatch.setProcessingStrategy(new ProcessingAsObjectV2())\n    }\n\n    interactionBatch.addCommands(calls)\n\n    if (interactionBatch.size > interactionBatch.maxSize) {\n      throw new AjaxError({\n        code: 'JSSDK_BATCH_TOO_LARGE',\n        description: `Batch too large: ${interactionBatch.size} commands (max: ${interactionBatch.maxSize})`,\n        status: 400,\n        requestInfo: { method: 'batch', params: { cmd: calls }, requestId },\n        originalError: null\n      })\n    }\n\n    if (interactionBatch.size === 0) {\n      throw new AjaxError({\n        code: 'JSSDK_BATCH_EMPTY',\n        description: 'Batch must contain at least one command',\n        status: 400,\n        requestInfo: { method: 'batch', params: { cmd: calls }, requestId },\n        originalError: null\n      })\n    }\n\n    const responseBatch = await this.call<BatchPayload<T>>(\n      'batch',\n      {\n        halt: opts.isHaltOnError ? 1 : 0,\n        cmd: interactionBatch.getCommandsForCall()\n      },\n      requestId\n    )\n\n    const response = await interactionBatch.prepareResponse<T>(responseBatch)\n\n    // Log the results\n    this._logBatchCompletion(\n      requestId,\n      response.getData()?.result?.size ?? 0,\n      response.getErrorMessages().length\n    )\n\n    return response\n  }\n  // endregion ////\n}\n"],"names":["AbstractHttp","ApiVersion","InteractionBatchV2","ProcessingAsArrayV2","ProcessingAsObjectV2","AjaxError"],"mappings":"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"}

package/dist/cjs/core/http/v3.cjs

@@ -0,0 +1,82 @@
+/**
+ * @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/
+ */
+'use strict';
+
+const abstractHttp = require('./abstract-http.cjs');
+const b24 = require('../../types/b24.cjs');
+const ajaxError = require('./ajax-error.cjs');
+const v3 = require('../interaction/batch/v3.cjs');
+const asArray = require('../interaction/batch/processing/v3/as-array.cjs');
+const asObject = require('../interaction/batch/processing/v3/as-object.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class HttpV3 extends abstractHttp.AbstractHttp {
+  static {
+    __name(this, "HttpV3");
+  }
+  constructor(authActions, options, restrictionParams) {
+    super(authActions, options, restrictionParams);
+    this._version = b24.ApiVersion.v3;
+  }
+  // region batch ////
+  async batch(calls, options) {
+    const opts = {
+      isHaltOnError: true,
+      ...options
+    };
+    const requestId = opts.requestId ?? this._requestIdGenerator.getRequestId();
+    this._logBatchStart(requestId, calls, opts);
+    const interactionBatch = new v3.InteractionBatchV3({
+      requestId,
+      parallelDefaultValue: !opts.isHaltOnError,
+      restrictionManager: this._restrictionManager
+    });
+    if (Array.isArray(calls)) {
+      interactionBatch.setProcessingStrategy(new asArray.ProcessingAsArrayV3());
+    } else {
+      interactionBatch.setProcessingStrategy(new asObject.ProcessingAsObjectV3());
+    }
+    interactionBatch.addCommands(calls);
+    if (interactionBatch.size > interactionBatch.maxSize) {
+      throw new ajaxError.AjaxError({
+        code: "JSSDK_BATCH_TOO_LARGE",
+        description: `Batch too large: ${interactionBatch.size} commands (max: ${interactionBatch.maxSize})`,
+        status: 400,
+        requestInfo: { method: "batch", params: { cmd: calls }, requestId },
+        originalError: null
+      });
+    }
+    if (interactionBatch.size === 0) {
+      throw new ajaxError.AjaxError({
+        code: "JSSDK_BATCH_EMPTY",
+        description: "Batch must contain at least one command",
+        status: 400,
+        requestInfo: { method: "batch", params: { cmd: calls }, requestId },
+        originalError: null
+      });
+    }
+    const responseBatch = await this.call(
+      "batch",
+      interactionBatch.getCommandsForCall(),
+      requestId
+    );
+    const response = await interactionBatch.prepareResponse(responseBatch);
+    this._logBatchCompletion(
+      requestId,
+      response.getData()?.result?.size ?? 0,
+      response.getErrorMessages().length
+    );
+    return response;
+  }
+  // endregion ////
+}
+
+exports.HttpV3 = HttpV3;
+//# sourceMappingURL=v3.cjs.map

package/dist/cjs/core/http/v3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3.cjs","sources":["../../../../src/core/http/v3.ts"],"sourcesContent":["import type {\n  BatchCommandsArrayUniversal, BatchCommandsObjectUniversal,\n  BatchNamedCommandsUniversal,\n  ICallBatchOptions,\n  ICallBatchResult, TypeCallParams,\n  TypeHttp\n} from '../../types/http'\nimport type { AuthActions } from '../../types/auth'\nimport type { RestrictionParams } from '../../types/limiters'\nimport type { BatchPayload } from '../../types/payloads'\nimport type { Result } from '../result'\nimport { AbstractHttp } from './abstract-http'\nimport { ApiVersion } from '../../types/b24'\nimport { AjaxError } from './ajax-error'\nimport { InteractionBatchV3 } from '../interaction/batch/v3'\nimport { ProcessingAsArrayV3 } from '../interaction/batch/processing/v3/as-array'\nimport { ProcessingAsObjectV3 } from '../interaction/batch/processing/v3/as-object'\n\n/**\n * Class for working with RestApi v3 requests via http\n *\n * @link https://bitrix24.github.io/b24jssdk/\n * @link https://apidocs.bitrix24.com/api-reference/rest-v3/index.html\n *\n * @todo docs\n */\nexport class HttpV3 extends AbstractHttp implements TypeHttp {\n  constructor(\n    authActions: AuthActions,\n    options?: null | object,\n    restrictionParams?: Partial<RestrictionParams>\n  ) {\n    super(authActions, options, restrictionParams)\n    this._version = ApiVersion.v3\n  }\n\n  // region batch ////\n  public async batch<T = unknown>(\n    calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal,\n    options?: ICallBatchOptions\n  ): Promise<Result<ICallBatchResult<T>>> {\n    const opts = {\n      isHaltOnError: true,\n      ...options\n    }\n\n    const requestId = opts.requestId ?? this._requestIdGenerator.getRequestId()\n\n    this._logBatchStart(requestId, calls, opts)\n\n    const interactionBatch = new InteractionBatchV3({\n      requestId,\n      parallelDefaultValue: !(opts.isHaltOnError),\n      restrictionManager: this._restrictionManager\n    })\n\n    if (Array.isArray(calls)) {\n      interactionBatch.setProcessingStrategy(new ProcessingAsArrayV3())\n    } else {\n      interactionBatch.setProcessingStrategy(new ProcessingAsObjectV3())\n    }\n\n    interactionBatch.addCommands(calls)\n\n    if (interactionBatch.size > interactionBatch.maxSize) {\n      throw new AjaxError({\n        code: 'JSSDK_BATCH_TOO_LARGE',\n        description: `Batch too large: ${interactionBatch.size} commands (max: ${interactionBatch.maxSize})`,\n        status: 400,\n        requestInfo: { method: 'batch', params: { cmd: calls }, requestId },\n        originalError: null\n      })\n    }\n\n    if (interactionBatch.size === 0) {\n      throw new AjaxError({\n        code: 'JSSDK_BATCH_EMPTY',\n        description: 'Batch must contain at least one command',\n        status: 400,\n        requestInfo: { method: 'batch', params: { cmd: calls }, requestId },\n        originalError: null\n      })\n    }\n\n    const responseBatch = await this.call<BatchPayload<T>>(\n      'batch',\n      interactionBatch.getCommandsForCall() as TypeCallParams,\n      requestId\n    )\n\n    const response = await interactionBatch.prepareResponse<T>(responseBatch)\n\n    // Log the results\n    this._logBatchCompletion(\n      requestId,\n      response.getData()?.result?.size ?? 0,\n      response.getErrorMessages().length\n    )\n\n    return response\n  }\n  // endregion ////\n}\n"],"names":["AbstractHttp","ApiVersion","InteractionBatchV3","ProcessingAsArrayV3","ProcessingAsObjectV3","AjaxError"],"mappings":";;;;;;;;;;;;;;;;;;;AA0BO,MAAM,eAAeA,yBAAA,CAAiC;AAAA,EA1B7D;AA0B6D,IAAA,MAAA,CAAA,IAAA,EAAA,QAAA,CAAA;AAAA;AAAA,EAC3D,WAAA,CACE,WAAA,EACA,OAAA,EACA,iBAAA,EACA;AACA,IAAA,KAAA,CAAM,WAAA,EAAa,SAAS,iBAAiB,CAAA;AAC7C,IAAA,IAAA,CAAK,WAAWC,cAAA,CAAW,EAAA;AAAA,EAC7B;AAAA;AAAA,EAGA,MAAa,KAAA,CACX,KAAA,EACA,OAAA,EACsC;AACtC,IAAA,MAAM,IAAA,GAAO;AAAA,MACX,aAAA,EAAe,IAAA;AAAA,MACf,GAAG;AAAA,KACL;AAEA,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,SAAA,IAAa,IAAA,CAAK,oBAAoB,YAAA,EAAa;AAE1E,IAAA,IAAA,CAAK,cAAA,CAAe,SAAA,EAAW,KAAA,EAAO,IAAI,CAAA;AAE1C,IAAA,MAAM,gBAAA,GAAmB,IAAIC,qBAAA,CAAmB;AAAA,MAC9C,SAAA;AAAA,MACA,oBAAA,EAAsB,CAAE,IAAA,CAAK,aAAA;AAAA,MAC7B,oBAAoB,IAAA,CAAK;AAAA,KAC1B,CAAA;AAED,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,MAAA,gBAAA,CAAiB,qBAAA,CAAsB,IAAIC,2BAAA,EAAqB,CAAA;AAAA,IAClE,CAAA,MAAO;AACL,MAAA,gBAAA,CAAiB,qBAAA,CAAsB,IAAIC,6BAAA,EAAsB,CAAA;AAAA,IACnE;AAEA,IAAA,gBAAA,CAAiB,YAAY,KAAK,CAAA;AAElC,IAAA,IAAI,gBAAA,CAAiB,IAAA,GAAO,gBAAA,CAAiB,OAAA,EAAS;AACpD,MAAA,MAAM,IAAIC,mBAAA,CAAU;AAAA,QAClB,IAAA,EAAM,uBAAA;AAAA,QACN,aAAa,CAAA,iBAAA,EAAoB,gBAAA,CAAiB,IAAI,CAAA,gBAAA,EAAmB,iBAAiB,OAAO,CAAA,CAAA,CAAA;AAAA,QACjG,MAAA,EAAQ,GAAA;AAAA,QACR,WAAA,EAAa,EAAE,MAAA,EAAQ,OAAA,EAAS,QAAQ,EAAE,GAAA,EAAK,KAAA,EAAM,EAAG,SAAA,EAAU;AAAA,QAClE,aAAA,EAAe;AAAA,OAChB,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,gBAAA,CAAiB,SAAS,CAAA,EAAG;AAC/B,MAAA,MAAM,IAAIA,mBAAA,CAAU;AAAA,QAClB,IAAA,EAAM,mBAAA;AAAA,QACN,WAAA,EAAa,yCAAA;AAAA,QACb,MAAA,EAAQ,GAAA;AAAA,QACR,WAAA,EAAa,EAAE,MAAA,EAAQ,OAAA,EAAS,QAAQ,EAAE,GAAA,EAAK,KAAA,EAAM,EAAG,SAAA,EAAU;AAAA,QAClE,aAAA,EAAe;AAAA,OAChB,CAAA;AAAA,IACH;AAEA,IAAA,MAAM,aAAA,GAAgB,MAAM,IAAA,CAAK,IAAA;AAAA,MAC/B,OAAA;AAAA,MACA,iBAAiB,kBAAA,EAAmB;AAAA,MACpC;AAAA,KACF;AAEA,IAAA,MAAM,QAAA,GAAW,MAAM,gBAAA,CAAiB,eAAA,CAAmB,aAAa,CAAA;AAGxE,IAAA,IAAA,CAAK,mBAAA;AAAA,MACH,SAAA;AAAA,MACA,QAAA,CAAS,OAAA,EAAQ,EAAG,MAAA,EAAQ,IAAA,IAAQ,CAAA;AAAA,MACpC,QAAA,CAAS,kBAAiB,CAAE;AAAA,KAC9B;AAEA,IAAA,OAAO,QAAA;AAAA,EACT;AAAA;AAEF;;;;"}

package/dist/cjs/core/interaction/batch/abstract-interaction-batch.cjs

@@ -0,0 +1,71 @@
+/**
+ * @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/
+ */
+'use strict';
+
+const sdkError = require('../../sdk-error.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class AbstractInteractionBatch {
+  static {
+    __name(this, "AbstractInteractionBatch");
+  }
+  parallelDefaultValue;
+  requestId;
+  restrictionManager;
+  // @memo this regeneration -> isObjectMode
+  processingStrategy;
+  _commands = [];
+  constructor(options) {
+    this.parallelDefaultValue = options.parallelDefaultValue;
+    this.requestId = options.requestId;
+    this.restrictionManager = options.restrictionManager;
+    this.processingStrategy = options.processingStrategy;
+  }
+  // region Setter Strategy ////
+  setProcessingStrategy(processingStrategy) {
+    this.processingStrategy = processingStrategy;
+  }
+  // endregion ////
+  // region Getter ////
+  get size() {
+    return this._commands.length;
+  }
+  get maxSize() {
+    return 0;
+  }
+  // endregion ////
+  // region Request ////
+  addCommands(calls) {
+    if (!this.processingStrategy) {
+      throw new sdkError.SdkError({
+        code: "JSSDK_INTERACTION_BATCH_EMPTY_PROCESSING_STRATEGY",
+        description: "ProcessingStrategy not set",
+        status: 500
+      });
+    }
+    this._commands = this.processingStrategy.prepareCommands(calls, {
+      parallelDefaultValue: this.parallelDefaultValue
+    });
+  }
+  getCommandsForCall() {
+    if (!this.processingStrategy) {
+      throw new sdkError.SdkError({
+        code: "JSSDK_INTERACTION_BATCH_EMPTY_PROCESSING_STRATEGY",
+        description: "ProcessingStrategy not set",
+        status: 500
+      });
+    }
+    return this.processingStrategy.buildCommands(this._commands);
+  }
+  // endregion ////
+}
+
+exports.AbstractInteractionBatch = AbstractInteractionBatch;
+//# sourceMappingURL=abstract-interaction-batch.cjs.map

package/dist/cjs/core/interaction/batch/abstract-interaction-batch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-interaction-batch.cjs","sources":["../../../../../src/core/interaction/batch/abstract-interaction-batch.ts"],"sourcesContent":["import type { IProcessingStrategy } from './processing/interface-strategy'\nimport type {\n  BatchCommandsArrayUniversal,\n  BatchCommandsObjectUniversal,\n  BatchCommandV3, BatchNamedCommandsUniversal,\n  ICallBatchOptions, ICallBatchResult\n} from '../../../types/http'\nimport type { RestrictionManager } from '../../http/limiters/manager'\nimport type { BatchPayload, PayloadTime } from '../../../types/payloads'\nimport type { Result } from '../../result'\nimport type { AjaxResult } from '../../http/ajax-result'\nimport type { NumberString } from '../../../types/common'\nimport type { TypeDescriptionError } from '../../../types/auth'\nimport { SdkError } from '../../sdk-error'\n\nexport interface BatchResponseData<T = unknown> {\n  readonly result?: T[] | Record<string | number, T>\n  readonly result_error?: (string | TypeDescriptionError)[] | Record<string | number, string | TypeDescriptionError>\n  readonly result_total?: NumberString[] | Record<string | number, NumberString>\n  readonly result_next?: NumberString[] | Record<string | number, NumberString>\n  readonly result_time?: PayloadTime[] | Record<string | number, PayloadTime>\n}\n\nexport type InteractionBatchOptions = Required<Omit<ICallBatchOptions, 'isHaltOnError' | 'isObjectMode'>> & {\n  /**\n   * @memo this regeneration is `isHaltOnError` and it is currently `!isHaltOnError`\n   */\n  parallelDefaultValue: boolean\n  restrictionManager: RestrictionManager\n  processingStrategy?: IProcessingStrategy\n}\n\nexport type ResponseHelper = {\n  requestId: string\n  status: number\n  time: PayloadTime\n  restrictionManager: RestrictionManager\n}\n\n/**\n * Working with batch requests\n */\nexport abstract class AbstractInteractionBatch {\n  protected parallelDefaultValue: boolean\n  protected requestId: string\n  protected restrictionManager: RestrictionManager\n  // @memo this regeneration -> isObjectMode\n  protected processingStrategy?: IProcessingStrategy\n\n  protected _commands: BatchCommandV3[] = []\n\n  constructor(options: InteractionBatchOptions) {\n    this.parallelDefaultValue = options.parallelDefaultValue\n    this.requestId = options.requestId\n    this.restrictionManager = options.restrictionManager\n    this.processingStrategy = options.processingStrategy\n  }\n\n  // region Setter Strategy ////\n  public setProcessingStrategy(processingStrategy: IProcessingStrategy) {\n    this.processingStrategy = processingStrategy\n  }\n  // endregion ////\n\n  // region Getter ////\n  get size(): number {\n    return this._commands.length\n  }\n\n  get maxSize(): number {\n    return 0\n  }\n  // endregion ////\n\n  // region Request ////\n  public addCommands(\n    calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal\n  ): void {\n    if (!this.processingStrategy) {\n      throw new SdkError({\n        code: 'JSSDK_INTERACTION_BATCH_EMPTY_PROCESSING_STRATEGY',\n        description: 'ProcessingStrategy not set',\n        status: 500\n      })\n    }\n\n    this._commands = this.processingStrategy.prepareCommands(calls, {\n      parallelDefaultValue: this.parallelDefaultValue\n    })\n  }\n\n  public getCommandsForCall(): unknown {\n    if (!this.processingStrategy) {\n      throw new SdkError({\n        code: 'JSSDK_INTERACTION_BATCH_EMPTY_PROCESSING_STRATEGY',\n        description: 'ProcessingStrategy not set',\n        status: 500\n      })\n    }\n\n    return this.processingStrategy.buildCommands(this._commands)\n  }\n  // endregion ////\n\n  // region Response ////\n  public abstract prepareResponse<T>(response: AjaxResult<BatchPayload<T>>): Promise<Result<ICallBatchResult<T>>>\n  // endregion ////\n}\n"],"names":["SdkError"],"mappings":";;;;;;;;;;;;;;AA0CO,MAAe,wBAAA,CAAyB;AAAA,EA1C/C;AA0C+C,IAAA,MAAA,CAAA,IAAA,EAAA,0BAAA,CAAA;AAAA;AAAA,EACnC,oBAAA;AAAA,EACA,SAAA;AAAA,EACA,kBAAA;AAAA;AAAA,EAEA,kBAAA;AAAA,EAEA,YAA8B,EAAC;AAAA,EAEzC,YAAY,OAAA,EAAkC;AAC5C,IAAA,IAAA,CAAK,uBAAuB,OAAA,CAAQ,oBAAA;AACpC,IAAA,IAAA,CAAK,YAAY,OAAA,CAAQ,SAAA;AACzB,IAAA,IAAA,CAAK,qBAAqB,OAAA,CAAQ,kBAAA;AAClC,IAAA,IAAA,CAAK,qBAAqB,OAAA,CAAQ,kBAAA;AAAA,EACpC;AAAA;AAAA,EAGO,sBAAsB,kBAAA,EAAyC;AACpE,IAAA,IAAA,CAAK,kBAAA,GAAqB,kBAAA;AAAA,EAC5B;AAAA;AAAA;AAAA,EAIA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,KAAK,SAAA,CAAU,MAAA;AAAA,EACxB;AAAA,EAEA,IAAI,OAAA,GAAkB;AACpB,IAAA,OAAO,CAAA;AAAA,EACT;AAAA;AAAA;AAAA,EAIO,YACL,KAAA,EACM;AACN,IAAA,IAAI,CAAC,KAAK,kBAAA,EAAoB;AAC5B,MAAA,MAAM,IAAIA,iBAAA,CAAS;AAAA,QACjB,IAAA,EAAM,mDAAA;AAAA,QACN,WAAA,EAAa,4BAAA;AAAA,QACb,MAAA,EAAQ;AAAA,OACT,CAAA;AAAA,IACH;AAEA,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA,CAAK,kBAAA,CAAmB,eAAA,CAAgB,KAAA,EAAO;AAAA,MAC9D,sBAAsB,IAAA,CAAK;AAAA,KAC5B,CAAA;AAAA,EACH;AAAA,EAEO,kBAAA,GAA8B;AACnC,IAAA,IAAI,CAAC,KAAK,kBAAA,EAAoB;AAC5B,MAAA,MAAM,IAAIA,iBAAA,CAAS;AAAA,QACjB,IAAA,EAAM,mDAAA;AAAA,QACN,WAAA,EAAa,4BAAA;AAAA,QACb,MAAA,EAAQ;AAAA,OACT,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,IAAA,CAAK,kBAAA,CAAmB,aAAA,CAAc,IAAA,CAAK,SAAS,CAAA;AAAA,EAC7D;AAAA;AAMF;;;;"}

package/dist/cjs/core/interaction/batch/parse-row.cjs

@@ -0,0 +1,69 @@
+/**
+ * @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/
+ */
+'use strict';
+
+const sdkError = require('../../sdk-error.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class ParseRow {
+  static {
+    __name(this, "ParseRow");
+  }
+  static getBatchCommand(row, options) {
+    if (row) {
+      if (typeof row === "object" && "method" in row && typeof row.method === "string") {
+        return {
+          method: row.method,
+          query: row.params,
+          as: row.as ?? options.asDefaultValue,
+          parallel: row.parallel ?? options.parallelDefaultValue
+        };
+      }
+      if (Array.isArray(row) && row.length > 0 && typeof row[0] === "string") {
+        return {
+          method: row[0],
+          query: row[1],
+          as: options.asDefaultValue,
+          parallel: options.parallelDefaultValue
+        };
+      }
+    }
+    throw new sdkError.SdkError({
+      code: "JSSDK_INTERACTION_BATCH_ROW_FAIL",
+      description: `There were difficulties parsing the command for batch.
+${JSON.stringify({
+        row,
+        options
+      })}`,
+      status: 500
+    });
+  }
+  static getMethodsFromCommands(calls) {
+    const result = [];
+    const optsFake = {
+      parallelDefaultValue: false
+    };
+    if (Array.isArray(calls)) {
+      calls.forEach((row) => {
+        const command = ParseRow.getBatchCommand(row, optsFake);
+        result.push(command.method);
+      });
+    } else {
+      Object.entries(calls).forEach(([index, row]) => {
+        const command = ParseRow.getBatchCommand(row, { ...optsFake, asDefaultValue: index });
+        result.push(command.method);
+      });
+    }
+    return result;
+  }
+}
+
+exports.ParseRow = ParseRow;
+//# sourceMappingURL=parse-row.cjs.map

package/dist/cjs/core/interaction/batch/parse-row.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-row.cjs","sources":["../../../../../src/core/interaction/batch/parse-row.ts"],"sourcesContent":["import type {\n  BatchCommandsArrayUniversal,\n  BatchCommandsObjectUniversal,\n  BatchCommandV3, BatchNamedCommandsUniversal,\n  CommandObject,\n  CommandTuple\n} from '../../../types/http'\nimport { SdkError } from '../../sdk-error'\n\n/**\n * Class for formatting/parsing a set of Batch commands\n */\n// eslint-disable-next-line @typescript-eslint/no-extraneous-class\nexport class ParseRow {\n  public static getBatchCommand(\n    row: CommandObject | CommandTuple,\n    options: {\n      parallelDefaultValue: boolean\n      asDefaultValue?: string\n    }\n  ): BatchCommandV3 {\n    if (row) {\n      if (typeof row === 'object' && 'method' in row && typeof row.method === 'string') {\n        return {\n          method: row.method,\n          query: row.params,\n          as: row.as ?? options.asDefaultValue,\n          parallel: row.parallel ?? options.parallelDefaultValue\n        }\n      }\n\n      if (Array.isArray(row) && row.length > 0 && typeof row[0] === 'string') {\n        return {\n          method: row[0],\n          query: row[1],\n          as: options.asDefaultValue,\n          parallel: options.parallelDefaultValue\n        }\n      }\n    }\n\n    throw new SdkError({\n      code: 'JSSDK_INTERACTION_BATCH_ROW_FAIL',\n      description: `There were difficulties parsing the command for batch.\\n${JSON.stringify({\n        row, options\n      })}`,\n      status: 500\n    })\n  }\n\n  public static getMethodsFromCommands(\n    calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal\n  ): string[] {\n    const result: string[] = []\n    const optsFake = {\n      parallelDefaultValue: false\n    }\n\n    if (Array.isArray(calls)) {\n      calls.forEach((row) => {\n        const command = ParseRow.getBatchCommand(row, optsFake)\n        result.push(command.method)\n      })\n    } else {\n      Object.entries(calls).forEach(([index, row]) => {\n        const command = ParseRow.getBatchCommand(row, { ...optsFake, asDefaultValue: index })\n        result.push(command.method)\n      })\n    }\n\n    return result\n  }\n}\n"],"names":["SdkError"],"mappings":";;;;;;;;;;;;;;AAaO,MAAM,QAAA,CAAS;AAAA,EAbtB;AAasB,IAAA,MAAA,CAAA,IAAA,EAAA,UAAA,CAAA;AAAA;AAAA,EACpB,OAAc,eAAA,CACZ,GAAA,EACA,OAAA,EAIgB;AAChB,IAAA,IAAI,GAAA,EAAK;AACP,MAAA,IAAI,OAAO,QAAQ,QAAA,IAAY,QAAA,IAAY,OAAO,OAAO,GAAA,CAAI,WAAW,QAAA,EAAU;AAChF,QAAA,OAAO;AAAA,UACL,QAAQ,GAAA,CAAI,MAAA;AAAA,UACZ,OAAO,GAAA,CAAI,MAAA;AAAA,UACX,EAAA,EAAI,GAAA,CAAI,EAAA,IAAM,OAAA,CAAQ,cAAA;AAAA,UACtB,QAAA,EAAU,GAAA,CAAI,QAAA,IAAY,OAAA,CAAQ;AAAA,SACpC;AAAA,MACF;AAEA,MAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,IAAK,GAAA,CAAI,MAAA,GAAS,CAAA,IAAK,OAAO,GAAA,CAAI,CAAC,CAAA,KAAM,QAAA,EAAU;AACtE,QAAA,OAAO;AAAA,UACL,MAAA,EAAQ,IAAI,CAAC,CAAA;AAAA,UACb,KAAA,EAAO,IAAI,CAAC,CAAA;AAAA,UACZ,IAAI,OAAA,CAAQ,cAAA;AAAA,UACZ,UAAU,OAAA,CAAQ;AAAA,SACpB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAM,IAAIA,iBAAA,CAAS;AAAA,MACjB,IAAA,EAAM,kCAAA;AAAA,MACN,WAAA,EAAa,CAAA;AAAA,EAA2D,KAAK,SAAA,CAAU;AAAA,QACrF,GAAA;AAAA,QAAK;AAAA,OACN,CAAC,CAAA,CAAA;AAAA,MACF,MAAA,EAAQ;AAAA,KACT,CAAA;AAAA,EACH;AAAA,EAEA,OAAc,uBACZ,KAAA,EACU;AACV,IAAA,MAAM,SAAmB,EAAC;AAC1B,IAAA,MAAM,QAAA,GAAW;AAAA,MACf,oBAAA,EAAsB;AAAA,KACxB;AAEA,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,MAAA,KAAA,CAAM,OAAA,CAAQ,CAAC,GAAA,KAAQ;AACrB,QAAA,MAAM,OAAA,GAAU,QAAA,CAAS,eAAA,CAAgB,GAAA,EAAK,QAAQ,CAAA;AACtD,QAAA,MAAA,CAAO,IAAA,CAAK,QAAQ,MAAM,CAAA;AAAA,MAC5B,CAAC,CAAA;AAAA,IACH,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,KAAA,EAAO,GAAG,CAAA,KAAM;AAC9C,QAAA,MAAM,OAAA,GAAU,SAAS,eAAA,CAAgB,GAAA,EAAK,EAAE,GAAG,QAAA,EAAU,cAAA,EAAgB,KAAA,EAAO,CAAA;AACpF,QAAA,MAAA,CAAO,IAAA,CAAK,QAAQ,MAAM,CAAA;AAAA,MAC5B,CAAC,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AACF;;;;"}

package/dist/cjs/core/interaction/batch/processing/interface-strategy.cjs

@@ -0,0 +1,87 @@
+/**
+ * @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/
+ */
+'use strict';
+
+const result = require('../../../result.cjs');
+const ajaxError = require('../../../http/ajax-error.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class AbstractProcessing {
+  static {
+    __name(this, "AbstractProcessing");
+  }
+  // region prepareItems ////
+  /**
+   * Template method. The soft-error envelope guard lives here ONCE so v2 and v3
+   * can't drift on it (#228 — hoisted from the duplicated #145 fix).
+   *
+   * When the batch CALL itself soft-errors (a top-level code in the restriction
+   * manager's `exceptionCodeForSoft` set, surfaced as a soft `Result` instead of
+   * a throw), the envelope carries `{ error }` and no `result`, so
+   * `response.getData()` is `undefined`. Skip per-row parsing — it would
+   * dereference `getData()!.result` — and let {@link handleResults} surface the
+   * top-level errors. The version-specific success path is {@link _prepareItemsSuccess}.
+   */
+  async prepareItems(commands, responseHelper) {
+    const results = /* @__PURE__ */ new Map();
+    if (!responseHelper.response.isSuccess) {
+      return results;
+    }
+    return this._prepareItemsSuccess(commands, responseHelper, results);
+  }
+  // endregion ////
+  // region handleResults ////
+  /**
+   * Template method. Same single soft-error guard as {@link prepareItems} (#228):
+   * there is no per-row data and `getData()` is `undefined`, so surface the
+   * envelope's top-level errors and return an empty data map instead of
+   * dereferencing `getData()!.time`. The version-specific success path is
+   * {@link _handleResultsSuccess}.
+   */
+  async handleResults(commands, results, responseHelper) {
+    const result$1 = new result.Result();
+    if (!responseHelper.response.isSuccess) {
+      for (const [index, error] of responseHelper.response.errors) {
+        result$1.addError(error, index);
+      }
+      result$1.setData({
+        result: /* @__PURE__ */ new Map(),
+        time: void 0
+      });
+      return result$1;
+    }
+    return this._handleResultsSuccess(commands, results, responseHelper, result$1);
+  }
+  // endregion ////
+  // region Tools ////
+  _getBatchResultByIndex(data, index) {
+    if (!data) return void 0;
+    if (Array.isArray(data)) {
+      return data[index];
+    }
+    return data[index];
+  }
+  _createErrorFromAjaxResult(ajaxResult) {
+    if (ajaxResult.hasError("base-error")) {
+      return ajaxResult.errors.get("base-error");
+    }
+    return new ajaxError.AjaxError({
+      code: "JSSDK_BATCH_SUB_ERROR",
+      description: ajaxResult.getErrorMessages().join("; "),
+      status: ajaxResult.getStatus(),
+      requestInfo: { ...ajaxResult.getQuery() },
+      originalError: ajaxResult.getErrors().next().value
+    });
+  }
+  // endregion ////
+}
+
+exports.AbstractProcessing = AbstractProcessing;
+//# sourceMappingURL=interface-strategy.cjs.map

package/dist/cjs/core/interaction/batch/processing/interface-strategy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-strategy.cjs","sources":["../../../../../../src/core/interaction/batch/processing/interface-strategy.ts"],"sourcesContent":["import type { BatchCommandV3, ICallBatchResult } from '../../../../types/http'\nimport type { BatchPayload } from '../../../../types/payloads'\nimport type { AjaxResult } from '../../../http/ajax-result'\nimport type { RestrictionManager } from '../../../http/limiters/manager'\nimport { Result } from '../../../result'\nimport { AjaxError } from '../../../http/ajax-error'\n\nexport type GetCommandsOptions = {\n  // @memo this regeneration `isHaltOnError` -> !isHaltOnError\n  parallelDefaultValue: boolean\n}\n\nexport type ResponseHelper<T> = {\n  requestId: string\n  parallelDefaultValue: boolean\n  response: AjaxResult<BatchPayload<T>>\n  // status: number\n  // data: BatchPayloadResult<T>\n  // time: PayloadTime\n  restrictionManager: RestrictionManager\n}\n\nexport type ResultItems<T> = Map<string | number, AjaxResult<T>>\n\nexport interface IProcessingStrategy {\n  prepareCommands(calls: unknown, options: GetCommandsOptions): BatchCommandV3[]\n  buildCommands(commands: BatchCommandV3[]): unknown\n  prepareItems<T>(commands: BatchCommandV3[], responseHelper: ResponseHelper<T>): Promise<ResultItems<T>>\n  handleResults<T>(commands: BatchCommandV3[], results: ResultItems<T>, responseHelper: ResponseHelper<T>): Promise<Result<ICallBatchResult<T>>>\n}\n\nexport abstract class AbstractProcessing implements IProcessingStrategy {\n  public abstract prepareCommands(calls: unknown, options: GetCommandsOptions): BatchCommandV3[]\n  public abstract buildCommands(commands: BatchCommandV3[]): unknown\n\n  // region prepareItems ////\n  /**\n   * Template method. The soft-error envelope guard lives here ONCE so v2 and v3\n   * can't drift on it (#228 — hoisted from the duplicated #145 fix).\n   *\n   * When the batch CALL itself soft-errors (a top-level code in the restriction\n   * manager's `exceptionCodeForSoft` set, surfaced as a soft `Result` instead of\n   * a throw), the envelope carries `{ error }` and no `result`, so\n   * `response.getData()` is `undefined`. Skip per-row parsing — it would\n   * dereference `getData()!.result` — and let {@link handleResults} surface the\n   * top-level errors. The version-specific success path is {@link _prepareItemsSuccess}.\n   */\n  public async prepareItems<T>(\n    commands: BatchCommandV3[],\n    responseHelper: ResponseHelper<T>\n  ): Promise<ResultItems<T>> {\n    const results: ResultItems<T> = new Map()\n\n    if (!responseHelper.response.isSuccess) {\n      return results\n    }\n\n    return this._prepareItemsSuccess<T>(commands, responseHelper, results)\n  }\n\n  /** Per-version success path: parse the response payload into `results` (the empty accumulator created by {@link prepareItems}). */\n  protected abstract _prepareItemsSuccess<T>(\n    commands: BatchCommandV3[],\n    responseHelper: ResponseHelper<T>,\n    results: ResultItems<T>\n  ): Promise<ResultItems<T>>\n\n  protected abstract _processResponseItem<T>(\n    command: BatchCommandV3,\n    index: string | number,\n    responseHelper: ResponseHelper<T>,\n    results: Map<string | number, AjaxResult<T>>\n  ): Promise<void>\n  // endregion ////\n\n  // region handleResults ////\n  /**\n   * Template method. Same single soft-error guard as {@link prepareItems} (#228):\n   * there is no per-row data and `getData()` is `undefined`, so surface the\n   * envelope's top-level errors and return an empty data map instead of\n   * dereferencing `getData()!.time`. The version-specific success path is\n   * {@link _handleResultsSuccess}.\n   */\n  public async handleResults<T>(\n    commands: BatchCommandV3[],\n    results: ResultItems<T>,\n    responseHelper: ResponseHelper<T>\n  ): Promise<Result<ICallBatchResult<T>>> {\n    const result = new Result<ICallBatchResult<T>>()\n\n    if (!responseHelper.response.isSuccess) {\n      for (const [index, error] of responseHelper.response.errors) {\n        result.addError(error, index)\n      }\n      result.setData({\n        result: new Map() as ResultItems<T>,\n        time: undefined\n      })\n      return result\n    }\n\n    return this._handleResultsSuccess<T>(commands, results, responseHelper, result)\n  }\n\n  /**\n   * Per-version success path: fold per-command `results` into `result` — the\n   * empty accumulator created by {@link handleResults}. Mutate and RETURN that\n   * same `result`; do not construct a new one (the base relies on the instance\n   * it passed in).\n   */\n  protected abstract _handleResultsSuccess<T>(\n    commands: BatchCommandV3[],\n    results: ResultItems<T>,\n    responseHelper: ResponseHelper<T>,\n    result: Result<ICallBatchResult<T>>\n  ): Promise<Result<ICallBatchResult<T>>>\n\n  protected abstract _processResponseError<T>(result: Result<ICallBatchResult<T>>, ajaxError: AjaxError, index: string): void\n  // endregion ////\n\n  // region Tools ////\n  protected _getBatchResultByIndex<T>(\n    data: T[] | Record<string | number, T> | undefined,\n    index: string | number\n  ): T | undefined {\n    if (!data) return undefined\n\n    if (Array.isArray(data)) {\n      return data[index as number]\n    }\n\n    return (data as Record<string | number, T>)[index]\n  }\n\n  protected _createErrorFromAjaxResult(ajaxResult: AjaxResult): AjaxError {\n    if (ajaxResult.hasError('base-error')) {\n      return ajaxResult.errors.get('base-error') as AjaxError\n    }\n\n    return new AjaxError({\n      code: 'JSSDK_BATCH_SUB_ERROR',\n      description: ajaxResult.getErrorMessages().join('; '),\n      status: ajaxResult.getStatus(),\n      requestInfo: { ...ajaxResult.getQuery() },\n      originalError: ajaxResult.getErrors().next().value\n    })\n  }\n  // endregion ////\n}\n"],"names":["result","Result","AjaxError"],"mappings":";;;;;;;;;;;;;;;AA+BO,MAAe,kBAAA,CAAkD;AAAA,EA/BxE;AA+BwE,IAAA,MAAA,CAAA,IAAA,EAAA,oBAAA,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBtE,MAAa,YAAA,CACX,QAAA,EACA,cAAA,EACyB;AACzB,IAAA,MAAM,OAAA,uBAA8B,GAAA,EAAI;AAExC,IAAA,IAAI,CAAC,cAAA,CAAe,QAAA,CAAS,SAAA,EAAW;AACtC,MAAA,OAAO,OAAA;AAAA,IACT;AAEA,IAAA,OAAO,IAAA,CAAK,oBAAA,CAAwB,QAAA,EAAU,cAAA,EAAgB,OAAO,CAAA;AAAA,EACvE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,MAAa,aAAA,CACX,QAAA,EACA,OAAA,EACA,cAAA,EACsC;AACtC,IAAA,MAAMA,QAAA,GAAS,IAAIC,aAAA,EAA4B;AAE/C,IAAA,IAAI,CAAC,cAAA,CAAe,QAAA,CAAS,SAAA,EAAW;AACtC,MAAA,KAAA,MAAW,CAAC,KAAA,EAAO,KAAK,CAAA,IAAK,cAAA,CAAe,SAAS,MAAA,EAAQ;AAC3D,QAAAD,QAAA,CAAO,QAAA,CAAS,OAAO,KAAK,CAAA;AAAA,MAC9B;AACA,MAAAA,QAAA,CAAO,OAAA,CAAQ;AAAA,QACb,MAAA,sBAAY,GAAA,EAAI;AAAA,QAChB,IAAA,EAAM;AAAA,OACP,CAAA;AACD,MAAA,OAAOA,QAAA;AAAA,IACT;AAEA,IAAA,OAAO,IAAA,CAAK,qBAAA,CAAyB,QAAA,EAAU,OAAA,EAAS,gBAAgBA,QAAM,CAAA;AAAA,EAChF;AAAA;AAAA;AAAA,EAmBU,sBAAA,CACR,MACA,KAAA,EACe;AACf,IAAA,IAAI,CAAC,MAAM,OAAO,MAAA;AAElB,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,EAAG;AACvB,MAAA,OAAO,KAAK,KAAe,CAAA;AAAA,IAC7B;AAEA,IAAA,OAAQ,KAAoC,KAAK,CAAA;AAAA,EACnD;AAAA,EAEU,2BAA2B,UAAA,EAAmC;AACtE,IAAA,IAAI,UAAA,CAAW,QAAA,CAAS,YAAY,CAAA,EAAG;AACrC,MAAA,OAAO,UAAA,CAAW,MAAA,CAAO,GAAA,CAAI,YAAY,CAAA;AAAA,IAC3C;AAEA,IAAA,OAAO,IAAIE,mBAAA,CAAU;AAAA,MACnB,IAAA,EAAM,uBAAA;AAAA,MACN,WAAA,EAAa,UAAA,CAAW,gBAAA,EAAiB,CAAE,KAAK,IAAI,CAAA;AAAA,MACpD,MAAA,EAAQ,WAAW,SAAA,EAAU;AAAA,MAC7B,WAAA,EAAa,EAAE,GAAG,UAAA,CAAW,UAAS,EAAE;AAAA,MACxC,aAAA,EAAe,UAAA,CAAW,SAAA,EAAU,CAAE,MAAK,CAAE;AAAA,KAC9C,CAAA;AAAA,EACH;AAAA;AAEF;;;;"}

package/dist/cjs/core/interaction/batch/processing/v2/abstract-processing.cjs

@@ -0,0 +1,138 @@
+/**
+ * @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/
+ */
+'use strict';
+
+const qs = require('qs-esm');
+const interfaceStrategy = require('../interface-strategy.cjs');
+const sdkError = require('../../../../sdk-error.cjs');
+const ajaxResult = require('../../../../http/ajax-result.cjs');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  const n = Object.create(null);
+  if (e) {
+    for (const k in e) {
+      n[k] = e[k];
+    }
+  }
+  n.default = e;
+  return n;
+}
+
+const qs__namespace = /*#__PURE__*/_interopNamespace(qs);
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class AbstractProcessingV2 extends interfaceStrategy.AbstractProcessing {
+  static {
+    __name(this, "AbstractProcessingV2");
+  }
+  _buildRow(command) {
+    return `${command.method}?${qs__namespace.stringify(command.query || {})}`;
+  }
+  buildCommands(commands) {
+    if (commands.length < 1) {
+      throw new sdkError.SdkError({
+        code: "JSSDK_INTERACTION_BATCH_STRATEGY_V2_EMPTY_COMMANDS",
+        description: "commands not set",
+        status: 500
+      });
+    }
+    const firstCommand = commands[0];
+    const asObject = typeof firstCommand.as === "string" && firstCommand.as.length > 0;
+    if (asObject) {
+      const result2 = {};
+      for (const command of commands) {
+        result2[command.as] = this._buildRow(command);
+      }
+      return result2;
+    }
+    const result = [];
+    for (const command of commands) {
+      result.push(this._buildRow(command));
+    }
+    return result;
+  }
+  // region prepareItems ////
+  // Soft-error guard lives in AbstractProcessing.prepareItems (#228); this is the
+  // success-only path for apiVer2.
+  async _prepareItemsSuccess(commands, responseHelper, results) {
+    for (const [index, command] of commands.entries()) {
+      await this._processResponseItem(
+        command,
+        // @memo for apiVer2 in this pace we get objectIndex from `command.as` OR array `index` from `commands[]`
+        command.as ?? index,
+        responseHelper,
+        results
+      );
+    }
+    return results;
+  }
+  async _processResponseItem(command, index, responseHelper, results) {
+    const responseResult = responseHelper.response.getData().result;
+    const resultData = this._getBatchResultByIndex(responseResult.result, index);
+    const resultError = this._getBatchResultByIndex(responseResult.result_error, index);
+    if (typeof resultData !== "undefined" || typeof resultError !== "undefined") {
+      const methodName = command.method;
+      const resultTime = this._getBatchResultByIndex(responseResult.result_time, index);
+      if (typeof resultTime !== "undefined") {
+        await responseHelper.restrictionManager.updateStats(responseHelper.requestId, `batch::${methodName}`, resultTime);
+      }
+      const result = new ajaxResult.AjaxResult({
+        answer: {
+          error: resultError ? typeof resultError === "string" ? resultError : resultError.error : void 0,
+          error_description: resultError ? typeof resultError === "string" ? void 0 : resultError.error_description : void 0,
+          result: resultData,
+          total: Number.parseInt(this._getBatchResultByIndex(responseResult.result_total, index) || "0"),
+          next: Number.parseInt(this._getBatchResultByIndex(responseResult.result_next, index) || "0"),
+          time: resultTime
+        },
+        query: {
+          method: methodName,
+          params: command.query || {},
+          requestId: responseHelper.requestId
+        },
+        status: responseHelper.response.getStatus()
+      });
+      results.set(index, result);
+      return;
+    }
+    if (responseHelper.parallelDefaultValue) {
+      throw new sdkError.SdkError({
+        code: "JSSDK_INTERACTION_BATCH_STRATEGY_V2_EMPTY_COMMAND_RESPONSE",
+        description: `There were difficulties parsing the response for batch { index: ${index}, method: ${command.method} }`,
+        status: 500
+      });
+    }
+  }
+  // endregion ////
+  // region handleResults ////
+  // Soft-error guard lives in AbstractProcessing.handleResults (#228); this is the
+  // success-only path for apiVer2.
+  async _handleResultsSuccess(_commands, results, responseHelper, result) {
+    const dataResult = /* @__PURE__ */ new Map();
+    for (const [index, data] of results) {
+      if (data.getStatus() !== 200 || !data.isSuccess) {
+        const ajaxError = this._createErrorFromAjaxResult(data);
+        this._processResponseError(result, ajaxError, `${index}`);
+        dataResult.set(index, data);
+      }
+      dataResult.set(index, data);
+    }
+    result.setData({
+      result: dataResult,
+      time: responseHelper.response.getData().time
+    });
+    return result;
+  }
+  // endregion ////
+}
+
+exports.AbstractProcessingV2 = AbstractProcessingV2;
+//# sourceMappingURL=abstract-processing.cjs.map