@bitrix24/b24jssdk 1.2.0 → 2.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"fetch-list.mjs","sources":["../../../../../src/core/actions/v3/fetch-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 { SdkError } from '../../sdk-error'\n\nexport type ActionFetchListV3 = 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 * Calls a REST API list method and returns an async generator for efficient large data retrieval. `restApi:v3`\n *\n * @todo add docs\n */\nexport class FetchListV3 extends AbstractAction {\n  /**\n   * Calls a REST API list method and returns an async generator for efficient large data retrieval.\n   * Implements the fast algorithm for iterating over large datasets without loading all data into memory at once.\n   *\n   * @template T - The type of items in the returned arrays (default is `unknown`).\n   *\n   * @param {ActionFetchListV3} 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 {AsyncGenerator<T[]>} An async generator that yields chunks of data as arrays of type `T`.\n   *     Each iteration returns the next page/batch of results until all data is fetched.\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 generator = b24.actions.v3.fetchList.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   *\n   * for await (const chunk of generator) {\n   *   // Process chunk (e.g., save to database, analyze, etc.)\n   *   console.log(`Processing ${chunk.length} items`)\n   * }\n   */\n  public override async* make<T = unknown>(options: ActionFetchListV3): AsyncGenerator<T[]> {\n    const batchSize = options?.limit ?? 50\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('fetchList.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 isContinue = true\n    let nextId = 0\n    do {\n      const sendParams = { ...requestParams, filter: [...requestParams.filter] }\n      sendParams.filter.push([idKey, '>', nextId])\n\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('fetchListMethod', {\n          method: options.method,\n          requestId: options.requestId,\n          messages: response.getErrorMessages()\n        })\n        throw new SdkError({\n          code: 'JSSDK_CORE_B24_FETCH_LIST_METHOD_API_V3',\n          description: `API Error: ${response.getErrorMessages().join('; ')}`,\n          status: 500\n        })\n      }\n      const responseData = response.getData()\n      if (!responseData) {\n        isContinue = false\n        break\n      }\n\n      const resultData: T[] = (responseData.result as any)[customKeyForResult] as T[]\n      if (resultData.length === 0) {\n        isContinue = false\n        break\n      }\n\n      yield 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 (\n        lastItem\n        && typeof lastItem[idKey] !== 'undefined'\n      ) {\n        nextId = Number.parseInt(lastItem[idKey] as string)\n      } else {\n        isContinue = false\n        break\n      }\n    } while (isContinue)\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch-list.mjs","sources":["../../../../../src/core/actions/v3/fetch-list.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { TypeCallParams } from '../../../types/http'\nimport { AbstractAction } from '../abstract-action'\nimport { SdkError } from '../../sdk-error'\nimport { keysetPaginate, KeysetPaginationError } from './_keyset-paginate'\n\nexport type ActionFetchListV3 = 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 * Calls a REST API list method and returns an async generator for efficient large data retrieval. `restApi:v3`\n *\n * @todo add docs\n */\nexport class FetchListV3 extends AbstractAction {\n  /**\n   * Calls a REST API list method and returns an async generator for efficient large data retrieval.\n   * Implements the fast algorithm for iterating over large datasets without loading all data into memory at once.\n   *\n   * @template T - The type of items in the returned arrays (default is `unknown`).\n   *\n   * @param {ActionFetchListV3} 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 {AsyncGenerator<T[]>} An async generator that yields chunks of data as arrays of type `T`.\n   *     Each iteration returns the next page/batch of results until all data is fetched.\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 generator = b24.actions.v3.fetchList.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   *\n   * for await (const chunk of generator) {\n   *   // Process chunk (e.g., save to database, analyze, etc.)\n   *   console.log(`Processing ${chunk.length} items`)\n   * }\n   */\n  public override async* make<T = unknown>(options: ActionFetchListV3): AsyncGenerator<T[]> {\n    const batchSize = options?.limit ?? 50\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('fetchList.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    try {\n      yield* 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: `fetchList.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: 'fetchListMethod'\n      })\n    } catch (error) {\n      if (error instanceof KeysetPaginationError) {\n        throw new SdkError({\n          code: 'JSSDK_CORE_B24_FETCH_LIST_METHOD_API_V3',\n          description: `API Error: ${error.messages.join('; ')}`,\n          status: 500\n        })\n      }\n      throw error\n    }\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;AAqBO,MAAM,oBAAoB,cAAA,CAAe;AAAA,EArBhD;AAqBgD,IAAA,MAAA,CAAA,IAAA,EAAA,aAAA,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,EAqD9C,OAAuB,KAAkB,OAAA,EAAiD;AACxF,IAAA,MAAM,SAAA,GAAY,SAAS,KAAA,IAAS,EAAA;AAEpC,IAAA,MAAM,KAAA,GAAQ,SAAS,KAAA,IAAS,IAAA;AAChC,IAAA,MAAM,WAAA,GAAc,SAAS,WAAA,IAAe,KAAA;AAC5C,IAAA,MAAM,kBAAA,GAAqB,SAAS,kBAAA,IAAsB,IAAA;AAC1D,IAAA,MAAM,MAAA,GAAS,OAAA,EAAS,MAAA,IAAU,EAAC;AAGnC,IAAA,IAAI,OAAA,IAAW,MAAA,IAAU,MAAA,CAAO,OAAO,CAAA,EAAG;AACxC,MAAA,IAAA,CAAK,OAAA,CAAQ,QAAQ,sKAAsK,CAAA;AAAA,IAC7L;AAEA,IAAA,MAAM,EAAE,KAAA,EAAO,aAAA,EAAe,GAAG,YAAW,GAAI,MAAA;AAChD,IAAA,MAAM,aAAA,GAAgC;AAAA,MACpC,GAAG,UAAA;AAAA,MACH,KAAA,EAAO,EAAE,CAAC,WAAW,GAAG,KAAA,EAAM;AAAA,MAC9B,QAAQ,CAAC,GAAI,OAAO,QAAQ,CAAA,IAAK,EAAG,CAAA;AAAA,MACpC,UAAA,EAAY,EAAE,IAAA,EAAM,CAAA,EAAG,OAAO,SAAA;AAAU,KAC1C;AAEA,IAAA,IAAI;AACF,MAAA,OAAO,cAAA,CAAkB,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAA,EAAS;AAAA,QAChD,QAAQ,OAAA,CAAQ,MAAA;AAAA,QAChB,WAAW,OAAA,CAAQ,SAAA;AAAA,QACnB,kBAAA;AAAA,QACA,aAAA,EAAe,CAAA;AAAA;AAAA,QAEf,6BAAa,MAAA,CAAA,CAAA,MAAA,MAAW,EAAE,GAAG,aAAA,EAAe,QAAQ,CAAC,GAAG,aAAA,CAAc,MAAA,EAAQ,CAAC,WAAA,EAAa,GAAA,EAAK,MAAM,CAAC,GAAE,CAAA,EAA7F,aAAA,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAKb,cAAA,0BAAiB,QAAA,KAAa;AAC5B,UAAA,MAAM,QAAQ,MAAA,CAAO,QAAA,CAAS,QAAA,CAAS,KAAK,GAAG,EAAE,CAAA;AACjD,UAAA,OAAO,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,GAAI,KAAA,GAAQ,IAAA;AAAA,QAC1C,CAAA,EAHgB,gBAAA,CAAA;AAAA,QAIhB,eAAA,EAAiB,+GAA0G,KAAK,CAAA,gKAAA,CAAA;AAAA,QAChI,UAAA,EAAY;AAAA,OACb,CAAA;AAAA,IACH,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,iBAAiB,qBAAA,EAAuB;AAC1C,QAAA,MAAM,IAAI,QAAA,CAAS;AAAA,UACjB,IAAA,EAAM,yCAAA;AAAA,UACN,aAAa,CAAA,WAAA,EAAc,KAAA,CAAM,QAAA,CAAS,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA;AAAA,UACpD,MAAA,EAAQ;AAAA,SACT,CAAA;AAAA,MACH;AACA,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AACF;;;;"}

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

@@ -0,0 +1,110 @@
+/**
+ * @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 { 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 FetchTailV3 extends AbstractAction {
+  static {
+    __name(this, "FetchTailV3");
+  }
+  /**
+   * Streams every record of a `tail` method as chunks, advancing the keyset
+   * cursor between requests.
+   *
+   * @template T - The type of items in the returned arrays (default is `unknown`).
+   *
+   * @param {ActionFetchTailV3} 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.
+   *         Use `filter` and `select` to control the selection. `pagination`, `order` and `cursor`
+   *         are managed by this helper and must not be passed. The cursor field must NOT be used in `filter`.
+   *     - `cursorField?: string` - The DTO field that drives the cursor. Must be monotonic and
+   *         preferably unique, and present in `select`. 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 {AsyncGenerator<T[]>} An async generator that yields chunks of data as arrays of type `T`.
+   *
+   * @example
+   * const generator = b24.actions.v3.fetchTail.make<{ id: string }>({
+   *   method: 'main.eventlog.tail',
+   *   params: { select: ['id', 'auditType'] },
+   *   cursorField: 'id',
+   *   customKeyForResult: 'items'
+   * })
+   * for await (const chunk of generator) {
+   *   console.log(`Processing ${chunk.length} items`)
+   * }
+   */
+  async *make(options) {
+    const batchSize = options?.limit ?? 50;
+    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_FETCH_TAIL_DESC_REQUIRES_INITIAL_VALUE",
+        description: 'fetchTail.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(`fetchTail.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(`fetchTail.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;
+    try {
+      yield* 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: `fetchTail.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: "fetchTailMethod"
+      });
+    } catch (error) {
+      if (error instanceof KeysetPaginationError) {
+        throw new SdkError({
+          code: "JSSDK_CORE_B24_FETCH_TAIL_METHOD_API_V3",
+          description: `API Error: ${error.messages.join("; ")}`,
+          status: 500
+        });
+      }
+      throw error;
+    }
+  }
+}
+
+export { FetchTailV3 };
+//# sourceMappingURL=fetch-tail.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-tail.mjs","sources":["../../../../../src/core/actions/v3/fetch-tail.ts"],"sourcesContent":["import type { ActionOptions } from '../abstract-action'\nimport type { TypeCallParams } from '../../../types/http'\nimport { AbstractAction } from '../abstract-action'\nimport { SdkError } from '../../sdk-error'\nimport { keysetPaginate, KeysetPaginationError } from './_keyset-paginate'\n\nexport type ActionFetchTailV3 = 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 * Calls a REST API `tail` method (native keyset cursor) and returns an async\n * generator for efficient large data retrieval. `restApi:v3`\n *\n * Unlike `fetchList`, which emulates keyset pagination on top of the `list`\n * action by injecting a `[field, '>', n]` filter, this helper drives the server\n * `tail` action with its native `cursor: { field, value, order, limit }`\n * parameter (see the v3 reference §6.2). The server itself adds `field > value`\n * (asc) / `field < value` (desc) and sorts by `field`, so the cursor field\n * MUST NOT appear in `filter` (the server rejects it with\n * `INVALIDFILTEREXCEPTION`).\n */\nexport class FetchTailV3 extends AbstractAction {\n  /**\n   * Streams every record of a `tail` method as chunks, advancing the keyset\n   * cursor between requests.\n   *\n   * @template T - The type of items in the returned arrays (default is `unknown`).\n   *\n   * @param {ActionFetchTailV3} 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   *         Use `filter` and `select` to control the selection. `pagination`, `order` and `cursor`\n   *         are managed by this helper and must not be passed. The cursor field must NOT be used in `filter`.\n   *     - `cursorField?: string` - The DTO field that drives the cursor. Must be monotonic and\n   *         preferably unique, and present in `select`. 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 {AsyncGenerator<T[]>} An async generator that yields chunks of data as arrays of type `T`.\n   *\n   * @example\n   * const generator = b24.actions.v3.fetchTail.make<{ id: string }>({\n   *   method: 'main.eventlog.tail',\n   *   params: { select: ['id', 'auditType'] },\n   *   cursorField: 'id',\n   *   customKeyForResult: 'items'\n   * })\n   * for await (const chunk of generator) {\n   *   console.log(`Processing ${chunk.length} items`)\n   * }\n   */\n  public override async* make<T = unknown>(options: ActionFetchTailV3): AsyncGenerator<T[]> {\n    const batchSize = options?.limit ?? 50\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_FETCH_TAIL_DESC_REQUIRES_INITIAL_VALUE',\n        description: 'fetchTail.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    // The cursor field cannot also live in `filter` — the server forces ordering\n    // and the `> value` condition on it and rejects a duplicate with\n    // INVALIDFILTEREXCEPTION. Warn instead of letting the server 400. (Detection\n    // covers only the short-form `[field, op, value]` triples the SDK emits.)\n    if (Array.isArray(params['filter']) && params['filter'].some((c: any) => Array.isArray(c) && c[0] === cursorField)) {\n      this._logger.warning(`fetchTail.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    // The cursor field must be readable in the response to advance. Append it to\n    // an explicit `select`; when `select` is omitted we rely on the server's\n    // default field set — warn for a non-default cursorField, which may not be\n    // in those defaults (the per-page guard below would otherwise stop silently).\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(`fetchTail.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    try {\n      yield* 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: `fetchTail.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: 'fetchTailMethod'\n      })\n    } catch (error) {\n      if (error instanceof KeysetPaginationError) {\n        throw new SdkError({\n          code: 'JSSDK_CORE_B24_FETCH_TAIL_METHOD_API_V3',\n          description: `API Error: ${error.messages.join('; ')}`,\n          status: 500\n        })\n      }\n      throw error\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/core/actions/v3/manager-v3.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
@@ -9,17 +9,23 @@
 import { CallV3 } from './call.mjs';
 import { CallListV3 } from './call-list.mjs';
 import { FetchListV3 } from './fetch-list.mjs';
+import { CallTailV3 } from './call-tail.mjs';
+import { FetchTailV3 } from './fetch-tail.mjs';
+import { AggregateV3 } from './aggregate.mjs';
 import { BatchV3 } from './batch.mjs';
 import { BatchByChunkV3 } from './batch-by-chunk.mjs';
 import { LoggerFactory } from '../../../logger/logger-factory.mjs';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-const callName = Symbol("call_V3");
-const callListName = Symbol("callList_V3");
-const fetchListName = Symbol("fetchList_V3");
-const batchName = Symbol("batch_V3");
-const batchByChunkName = Symbol("batchByChunk_V3");
+const callName = /* @__PURE__ */ Symbol("call_V3");
+const callListName = /* @__PURE__ */ Symbol("callList_V3");
+const fetchListName = /* @__PURE__ */ Symbol("fetchList_V3");
+const callTailName = /* @__PURE__ */ Symbol("callTail_V3");
+const fetchTailName = /* @__PURE__ */ Symbol("fetchTail_V3");
+const aggregateName = /* @__PURE__ */ Symbol("aggregate_V3");
+const batchName = /* @__PURE__ */ Symbol("batch_V3");
+const batchByChunkName = /* @__PURE__ */ Symbol("batchByChunk_V3");
 class ActionsManagerV3 {
   static {
     __name(this, "ActionsManagerV3");
@@ -56,6 +62,24 @@ class ActionsManagerV3 {
     }
     return this._mapActions.get(fetchListName);
   }
+  get callTail() {
+    if (!this._mapActions.has(callTailName)) {
+      this._mapActions.set(callTailName, new CallTailV3(this._b24, this._logger));
+    }
+    return this._mapActions.get(callTailName);
+  }
+  get fetchTail() {
+    if (!this._mapActions.has(fetchTailName)) {
+      this._mapActions.set(fetchTailName, new FetchTailV3(this._b24, this._logger));
+    }
+    return this._mapActions.get(fetchTailName);
+  }
+  get aggregate() {
+    if (!this._mapActions.has(aggregateName)) {
+      this._mapActions.set(aggregateName, new AggregateV3(this._b24, this._logger));
+    }
+    return this._mapActions.get(aggregateName);
+  }
   get batch() {
     if (!this._mapActions.has(batchName)) {
       this._mapActions.set(batchName, new BatchV3(this._b24, this._logger));

package/dist/esm/core/actions/v3/manager-v3.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"manager-v3.mjs","sources":["../../../../../src/core/actions/v3/manager-v3.ts"],"sourcesContent":["import type { TypeB24 } from '../../../types/b24'\nimport type { LoggerInterface } from '../../../types/logger'\nimport type { AbstractAction } from '../abstract-action'\nimport { LoggerFactory } from '../../../logger'\nimport { CallV3 } from './call'\nimport { CallListV3 } from './call-list'\nimport { FetchListV3 } from './fetch-list'\nimport { BatchV3 } from './batch'\nimport { BatchByChunkV3 } from './batch-by-chunk'\n\nconst callName = Symbol('call_V3')\nconst callListName = Symbol('callList_V3')\nconst fetchListName = Symbol('fetchList_V3')\nconst batchName = Symbol('batch_V3')\nconst batchByChunkName = Symbol('batchByChunk_V3')\n/**\n * Some actions for TypeB24 by Api:v3\n */\nexport class ActionsManagerV3 {\n  protected _b24: TypeB24\n  protected _logger: LoggerInterface\n\n  protected _mapActions: Map<symbol, AbstractAction>\n\n  constructor(b24: TypeB24) {\n    this._b24 = b24\n    this._logger = LoggerFactory.createNullLogger()\n\n    this._mapActions = new Map()\n  }\n\n  public setLogger(logger: LoggerInterface): void {\n    this._logger = logger\n  }\n\n  public getLogger(): LoggerInterface {\n    return this._logger\n  }\n\n  get call(): CallV3 {\n    if (!this._mapActions.has(callName)) {\n      this._mapActions.set(callName, new CallV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(callName)! as CallV3\n  }\n\n  get callList(): CallListV3 {\n    if (!this._mapActions.has(callListName)) {\n      this._mapActions.set(callListName, new CallListV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(callListName)! as CallListV3\n  }\n\n  get fetchList(): FetchListV3 {\n    if (!this._mapActions.has(fetchListName)) {\n      this._mapActions.set(fetchListName, new FetchListV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(fetchListName)! as FetchListV3\n  }\n\n  get batch(): BatchV3 {\n    if (!this._mapActions.has(batchName)) {\n      this._mapActions.set(batchName, new BatchV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(batchName)! as BatchV3\n  }\n\n  get batchByChunk(): BatchByChunkV3 {\n    if (!this._mapActions.has(batchByChunkName)) {\n      this._mapActions.set(batchByChunkName, new BatchByChunkV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(batchByChunkName)! as BatchByChunkV3\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAUA,MAAM,QAAA,GAAW,OAAO,SAAS,CAAA;AACjC,MAAM,YAAA,GAAe,OAAO,aAAa,CAAA;AACzC,MAAM,aAAA,GAAgB,OAAO,cAAc,CAAA;AAC3C,MAAM,SAAA,GAAY,OAAO,UAAU,CAAA;AACnC,MAAM,gBAAA,GAAmB,OAAO,iBAAiB,CAAA;AAI1C,MAAM,gBAAA,CAAiB;AAAA,EAlB9B;AAkB8B,IAAA,MAAA,CAAA,IAAA,EAAA,kBAAA,CAAA;AAAA;AAAA,EAClB,IAAA;AAAA,EACA,OAAA;AAAA,EAEA,WAAA;AAAA,EAEV,YAAY,GAAA,EAAc;AACxB,IAAA,IAAA,CAAK,IAAA,GAAO,GAAA;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,cAAc,gBAAA,EAAiB;AAE9C,IAAA,IAAA,CAAK,WAAA,uBAAkB,GAAA,EAAI;AAAA,EAC7B;AAAA,EAEO,UAAU,MAAA,EAA+B;AAC9C,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,EACjB;AAAA,EAEO,SAAA,GAA6B;AAClC,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,IAAI,IAAA,GAAe;AACjB,IAAA,IAAI,CAAC,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,QAAQ,CAAA,EAAG;AACnC,MAAA,IAAA,CAAK,WAAA,CAAY,IAAI,QAAA,EAAU,IAAI,OAAO,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IACpE;AACA,IAAA,OAAO,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,QAAQ,CAAA;AAAA,EACtC;AAAA,EAEA,IAAI,QAAA,GAAuB;AACzB,IAAA,IAAI,CAAC,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,YAAY,CAAA,EAAG;AACvC,MAAA,IAAA,CAAK,WAAA,CAAY,IAAI,YAAA,EAAc,IAAI,WAAW,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IAC5E;AACA,IAAA,OAAO,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,YAAY,CAAA;AAAA,EAC1C;AAAA,EAEA,IAAI,SAAA,GAAyB;AAC3B,IAAA,IAAI,CAAC,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,aAAa,CAAA,EAAG;AACxC,MAAA,IAAA,CAAK,WAAA,CAAY,IAAI,aAAA,EAAe,IAAI,YAAY,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IAC9E;AACA,IAAA,OAAO,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,aAAa,CAAA;AAAA,EAC3C;AAAA,EAEA,IAAI,KAAA,GAAiB;AACnB,IAAA,IAAI,CAAC,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,SAAS,CAAA,EAAG;AACpC,MAAA,IAAA,CAAK,WAAA,CAAY,IAAI,SAAA,EAAW,IAAI,QAAQ,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IACtE;AACA,IAAA,OAAO,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,SAAS,CAAA;AAAA,EACvC;AAAA,EAEA,IAAI,YAAA,GAA+B;AACjC,IAAA,IAAI,CAAC,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,gBAAgB,CAAA,EAAG;AAC3C,MAAA,IAAA,CAAK,WAAA,CAAY,IAAI,gBAAA,EAAkB,IAAI,eAAe,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IACpF;AACA,IAAA,OAAO,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,gBAAgB,CAAA;AAAA,EAC9C;AACF;;;;"}
+{"version":3,"file":"manager-v3.mjs","sources":["../../../../../src/core/actions/v3/manager-v3.ts"],"sourcesContent":["import type { TypeB24 } from '../../../types/b24'\nimport type { LoggerInterface } from '../../../types/logger'\nimport type { AbstractAction } from '../abstract-action'\nimport { LoggerFactory } from '../../../logger'\nimport { CallV3 } from './call'\nimport { CallListV3 } from './call-list'\nimport { FetchListV3 } from './fetch-list'\nimport { CallTailV3 } from './call-tail'\nimport { FetchTailV3 } from './fetch-tail'\nimport { AggregateV3 } from './aggregate'\nimport { BatchV3 } from './batch'\nimport { BatchByChunkV3 } from './batch-by-chunk'\n\nconst callName = Symbol('call_V3')\nconst callListName = Symbol('callList_V3')\nconst fetchListName = Symbol('fetchList_V3')\nconst callTailName = Symbol('callTail_V3')\nconst fetchTailName = Symbol('fetchTail_V3')\nconst aggregateName = Symbol('aggregate_V3')\nconst batchName = Symbol('batch_V3')\nconst batchByChunkName = Symbol('batchByChunk_V3')\n/**\n * Some actions for TypeB24 by Api:v3\n */\nexport class ActionsManagerV3 {\n  protected _b24: TypeB24\n  protected _logger: LoggerInterface\n\n  protected _mapActions: Map<symbol, AbstractAction>\n\n  constructor(b24: TypeB24) {\n    this._b24 = b24\n    this._logger = LoggerFactory.createNullLogger()\n\n    this._mapActions = new Map()\n  }\n\n  public setLogger(logger: LoggerInterface): void {\n    this._logger = logger\n  }\n\n  public getLogger(): LoggerInterface {\n    return this._logger\n  }\n\n  get call(): CallV3 {\n    if (!this._mapActions.has(callName)) {\n      this._mapActions.set(callName, new CallV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(callName)! as CallV3\n  }\n\n  get callList(): CallListV3 {\n    if (!this._mapActions.has(callListName)) {\n      this._mapActions.set(callListName, new CallListV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(callListName)! as CallListV3\n  }\n\n  get fetchList(): FetchListV3 {\n    if (!this._mapActions.has(fetchListName)) {\n      this._mapActions.set(fetchListName, new FetchListV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(fetchListName)! as FetchListV3\n  }\n\n  get callTail(): CallTailV3 {\n    if (!this._mapActions.has(callTailName)) {\n      this._mapActions.set(callTailName, new CallTailV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(callTailName)! as CallTailV3\n  }\n\n  get fetchTail(): FetchTailV3 {\n    if (!this._mapActions.has(fetchTailName)) {\n      this._mapActions.set(fetchTailName, new FetchTailV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(fetchTailName)! as FetchTailV3\n  }\n\n  get aggregate(): AggregateV3 {\n    if (!this._mapActions.has(aggregateName)) {\n      this._mapActions.set(aggregateName, new AggregateV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(aggregateName)! as AggregateV3\n  }\n\n  get batch(): BatchV3 {\n    if (!this._mapActions.has(batchName)) {\n      this._mapActions.set(batchName, new BatchV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(batchName)! as BatchV3\n  }\n\n  get batchByChunk(): BatchByChunkV3 {\n    if (!this._mapActions.has(batchByChunkName)) {\n      this._mapActions.set(batchByChunkName, new BatchByChunkV3(this._b24, this._logger))\n    }\n    return this._mapActions.get(batchByChunkName)! as BatchByChunkV3\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/core/http/abstract-http.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
@@ -20,6 +20,12 @@ import { LoggerFactory } from '../../logger/logger-factory.mjs';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const LOG_MAX_LENGTH = 300;
+const LOG_SLICE_LENGTH = 100;
+function truncateForLog(value) {
+  return value.length > LOG_MAX_LENGTH ? value.slice(0, LOG_SLICE_LENGTH) + "..." : value;
+}
+__name(truncateForLog, "truncateForLog");
 class AbstractHttp {
   static {
     __name(this, "AbstractHttp");
@@ -28,6 +34,12 @@ class AbstractHttp {
   _authActions;
   _requestIdGenerator;
   _restrictionManager;
+  /**
+   * In-flight token refresh, shared so concurrent 401s coalesce into a single
+   * `refreshAuth()` round-trip — avoids OAuth refresh-token reuse errors when a
+   * burst of requests expires together. (#182)
+   */
+  _pendingRefresh = null;
   _logger;
   _isClientSideWarning = false;
   _clientSideWarningMessage = "";
@@ -45,18 +57,20 @@ class AbstractHttp {
     this._logger = LoggerFactory.createNullLogger();
     const defaultHeaders = {};
     if (this.isServerSide()) {
-      defaultHeaders["User-Agent"] = "b24-js-sdk/1.2.0";
+      defaultHeaders["User-Agent"] = "b24-js-sdk/2.0.0";
     }
     this._authActions = authActions;
     this._requestIdGenerator = new RequestIdGenerator();
     this._clientAxios = axios.create({
-      headers: {
-        ...defaultHeaders,
-        ...options ? options.headers : {}
-      },
       timeout: 3e4,
       timeoutErrorMessage: "Request timeout exceeded",
-      ...options && { ...options, headers: void 0 }
+      ...options ?? {},
+      // headers last so the merged default + caller headers aren't wiped by an
+      // `options.headers` (or the previous `headers: undefined`) spread (#144).
+      headers: {
+        ...defaultHeaders,
+        ...options?.headers ?? {}
+      }
     });
     const params = {
       ...ParamsFactory.getDefault(),
@@ -92,7 +106,7 @@ class AbstractHttp {
   getStats() {
     return {
       ...this._restrictionManager.getStats(),
-      totalRequests: this._metrics.totalDuration,
+      totalRequests: this._metrics.totalRequests,
       successfulRequests: this._metrics.successfulRequests,
       failedRequests: this._metrics.failedRequests,
       totalDuration: this._metrics.totalDuration,
@@ -104,7 +118,7 @@ class AbstractHttp {
    * @inheritDoc
    */
   async reset() {
-    this._metrics.totalDuration = 0;
+    this._metrics.totalRequests = 0;
     this._metrics.successfulRequests = 0;
     this._metrics.failedRequests = 0;
     this._metrics.totalDuration = 0;
@@ -182,7 +196,7 @@ class AbstractHttp {
         this._restrictionManager.incrementError(method);
         this._updateMetrics(method, false, duration, lastError);
         this._logFailedRequest(requestId, method, attempt + 1, maxRetries, lastError);
-        if (attempt < maxRetries) {
+        if (attempt + 1 < maxRetries) {
           const waitTime = await this._restrictionManager.handleError(requestId, method, params, lastError, attempt);
           if (waitTime > 0) {
             this._restrictionManager.incrementStats("limitHits");
@@ -296,10 +310,27 @@ class AbstractHttp {
     let authData = this._authActions.getAuthData();
     if (authData === false) {
       this._logRefreshingAuthToken(requestId);
-      authData = await this._authActions.refreshAuth();
+      authData = await this._refreshAuth();
     }
     return authData;
   }
+  /**
+   * Refresh the auth token, coalescing concurrent callers onto a single
+   * in-flight `refreshAuth()` so a burst of 401s triggers exactly one refresh
+   * round-trip. The slot clears once the refresh settles. (#182)
+   */
+  _refreshAuth() {
+    if (this._pendingRefresh) {
+      return this._pendingRefresh;
+    }
+    const refresh = this._authActions.refreshAuth();
+    this._pendingRefresh = refresh;
+    refresh.finally(() => {
+      this._pendingRefresh = null;
+    }).catch(() => {
+    });
+    return refresh;
+  }
   // Execute the request with 401 error handling
   async _makeRequestWithAuthRetry(requestId, method, params, authData) {
     try {
@@ -313,33 +344,33 @@ class AbstractHttp {
             requestId,
             status: error.status,
             // Redact in case a future portal response embeds credentials in
-            // the error body (today it doesn't, but the channel is open). (#39)
-            responseData: JSON.stringify(redactSensitiveParams(error?.response?.data), null, 0)
+            // the error body (today it doesn't, but the channel is open) (#39),
+            // and cap the length so a large error body can't flood the sink (#236).
+            responseData: truncateForLog(JSON.stringify(redactSensitiveParams(error?.response?.data), null, 0))
           }
         );
       }
-      if (this._isAuthError(error)) {
+      const ajaxError = this._convertToAjaxError(requestId, error, method, params);
+      if (this._isAuthError(ajaxError)) {
         this._logAuthErrorDetected(requestId);
         this._logRefreshingAuthToken(requestId);
-        const refreshedAuthData = await this._authActions.refreshAuth();
+        const refreshedAuthData = await this._refreshAuth();
         await this._restrictionManager.checkRateLimit(requestId, method);
         return await this._makeAxiosRequest(requestId, method, params, refreshedAuthData);
       }
-      throw error;
+      throw ajaxError;
     }
   }
   async _makeAxiosRequest(requestId, method, params, authData) {
     const methodFormatted = this._prepareMethod(requestId, method, this.getBaseUrl());
     const paramsFormatted = this._prepareParams(authData, params);
     const paramsFormattedForLog = JSON.stringify(redactSensitiveParams(paramsFormatted), null, 0);
-    const maxLogLength = 300;
-    const sliceLogLength = 100;
     this.getLogger().info(
       `post/send`,
       {
         requestId,
         method,
-        params: paramsFormattedForLog.length > maxLogLength ? paramsFormattedForLog.slice(0, sliceLogLength) + "..." : paramsFormattedForLog
+        params: truncateForLog(paramsFormattedForLog)
       }
     );
     const response = await this._clientAxios.post(methodFormatted, paramsFormatted);
@@ -349,7 +380,7 @@ class AbstractHttp {
       {
         requestId,
         // responseFull: JSON.stringify(response.data, null, 2),
-        result: resultFormattedForLog.length > maxLogLength ? resultFormattedForLog.slice(0, sliceLogLength) + "..." : resultFormattedForLog,
+        result: truncateForLog(resultFormattedForLog),
         time: JSON.stringify(response.data.time, null, 0)
       }
     );
@@ -391,6 +422,50 @@ class AbstractHttp {
       status: ajaxError.status
     });
   }
+  // endregion ////
+  // endregion ////
+  // region Prepare ////
+  /**
+   * Builds the request URL: the method path plus the SDK telemetry query params
+   * (`bx24_request_id` / `bx24_sdk_ver` / `bx24_sdk_type` — request tracing and
+   * SDK identification, not auth material).
+   *
+   * Carve-out for the legacy positional `task.*` methods (`task.commentitem.*`,
+   * `task.checklistitem.*`, `task.elapseditem.*`, …): these read the request
+   * **query string positionally**, so appending the telemetry params shifts
+   * `Param #0` and the server rejects the call —
+   * `WRONG_ARGUMENTS: Param #0 (taskId) ... expected integer, but given
+   * something else`. Verified live against a portal: the same
+   * `task.commentitem.getlist` / `task.checklistitem.getlist` call succeeds
+   * without the telemetry params and fails with them; modern `tasks.task.*`
+   * (named params) is unaffected. So telemetry is omitted for any method whose
+   * name contains `task.`.
+   *
+   * Shared by v2 and v3 (rather than per-transport): once the v3 method
+   * allowlist was dropped (#259) a positional `task.*` method can be routed via
+   * `actions.v3.*` too, so v3 needs the same suppression — keeping the rule in
+   * one place stops the two transports drifting apart again (#207).
+   *
+   * `includes('task.')` is a deliberate over-approximation: it also drops the
+   * (optional, telemetry-safe) params for modern `tasks.task.*` / `bizproc.task.*`.
+   * Narrowing to an anchored `^task\.` is possible but unverified across the
+   * whole task surface, so the broad, safe match is kept. Bitrix24 method names
+   * are lowercase by convention, so the case-sensitive match is sufficient.
+   *
+   * @see https://apidocs.bitrix24.com/settings/how-to-call-rest-api/data-encoding.html#order-of-parameters
+   */
+  _prepareMethod(requestId, method, baseUrl) {
+    const methodUrl = `/${encodeURIComponent(method)}`;
+    if (method.includes("task.")) {
+      return `${baseUrl}${methodUrl}`;
+    }
+    const queryParams = new URLSearchParams({
+      [this._requestIdGenerator.getQueryStringParameterName()]: requestId,
+      [this._requestIdGenerator.getQueryStringSdkParameterName()]: "2.0.0",
+      [this._requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
+    });
+    return `${baseUrl}${methodUrl}?${queryParams.toString()}`;
+  }
   /**
    * Processes function parameters and adds authorization
    */
@@ -555,5 +630,5 @@ class AbstractHttp {
   // endregion ////
 }
 
-export { AbstractHttp };
+export { AbstractHttp, truncateForLog };
 //# sourceMappingURL=abstract-http.mjs.map